 zhangtao
|
a4e8727a86
|
chore(backend): 新增 basedpyright 校准配置，并修复它暴露的三处真缺陷
背景：仓库此前没有 pyright/basedpyright 配置，basedpyright 使用自身默认（≈recommended），
在 app/ 下产生 247 errors / 3799 warnings，其中 143 条是 reportMissingTypeArgument
（未参数化泛型）这类注解完整度噪音，会把真缺陷淹没（例如 OSS 的 Client.uploader 方法误用）。
配置（backend/pyrightconfig.json）
- typeCheckingMode: basic；显式把能抓真缺陷的规则保持为 error
（reportAttributeAccessIssue / reportArgumentType / reportOptionalMemberAccess /
reportIncompatibleMethodOverride / reportConstantRedefinition / reportMissingImports 等）
- 关闭注解完整度与风格类规则；tests/ 用 executionEnvironments 单独放宽（extraPaths 保证 app 可解析）
- 结果：app + main.py + tests 全量 0 errors
- 红绿验证：合成「str | None 传参」「MethodType 上取属性」「Optional 成员访问」三类
仍全部报 error，证明校准没有把真缺陷一起关掉
修复配置暴露的三处真缺陷
1) template_safety.py：_SQLALCHEMY_TYPE_WHITELIST 对全大写常量二次赋值 → 合并为一次成型
2) template_safety.py：normalize_column_type 假定 _TYPE_BASE_RE 必命中（用 # type: ignore 盖住，
None 时 .group() 会崩）→ 改为 None 安全，去掉 type-ignore
3) node/service.py ×2：CustomException(msg=reason) 中 reason 为 str | None，客户端可能收到空文案
→ 新增 SchedulerUtil.require_schedulable() 收敛「判定 + 抛异常 + 兜底文案」，调用点改为一行
验证：basedpyright 0 errors（原 247）；ruff All checks passed；pytest 97 passed；
已部署并线上复验（四端 200、Host 收窄、伪造令牌被拒、验证码过期 400 保留业务文案、
容器内 require_schedulable 与 OSS 调用修正均已生效）
|
2026-10-04 06:00:16 +08:00 |
|
|
zhangtao
|
b3882559de
|
fix(storage): 修复类型检查暴露的三处缺陷（含 OSS 上传运行时 bug）
basedpyright 报出的三处，逐条定位后发现都不是「标注问题」：
1) oss_adapter.py:70 —— 真运行时 bug
SDK 里 `Client.uploader` 是**方法**（`def uploader(self, **kwargs) -> Uploader`），
原写法 `self.client.uploader.upload_file(...)` 是在绑定方法上取属性，运行时必抛
AttributeError —— 即 OSS 上传链路从未成功过（生产未配 OSS 源，故未暴露）。
已改为 `self.client.uploader().upload_file(...)`，并按 SDK 签名核对
`upload_file(request, filepath, part_size=..., parallel_num=...)` 参数正确。
2) sftp_adapter.py:45 —— 缺主机校验
`config.host` 为 `str | None`（对象存储可不填），却直接传给 paramiko
`connect(hostname: str)`。已把 host 并入既有的用户名/密码守卫，
缺主机时返回业务异常 400「SFTP 存储源必须配置主机、用户名与密码」。
3) ftp_ftps_adapter.py:58 —— 同上
`_new_client()` 增加主机守卫（400「FTP 存储源必须配置主机地址」，并补 CustomException 导入）；
顺带修复同文件 `_ImplicitFTP_TLS.connect` 覆写签名与 ftplib.FTP 不兼容
（timeout: float、source_address: tuple[str, int] | None），消除该文件最后一条 error。
验证：basedpyright 这三个文件 0 errors（修复前 4 条）；ruff 全绿；pytest 97 passed；
运行时探针：缺主机 → 拦截为 400 业务异常；配主机 → 守卫放行并进入真实连接（ConnectionRefused 如期）。
|
2026-10-04 05:49:27 +08:00 |
|
|
zhangtao
|
a8c992cdd3
|
docs(audit): 更新修复进展——错误码收敛、异常写法统一、前端文案修复与残余项
|
2026-10-04 05:44:26 +08:00 |
|
|
zhangtao
|
c73daa7eae
|
chore(deploy): 健康检查发正确 Host、list 型配置改 JSON、Host 校验收窄
- backend 健康检查改为发送正确的 Host 头（而非放宽 ALLOWED_HOSTS）；
配合 ALLOW_LOCALHOST_HOSTS=false，Host: localhost 现在返回 400，容器自检仍 exit 0
- OAUTH_ALLOWED_HOSTS / CORS_STRICT_STARTUP / SCHEDULER_ALLOW_CODE_EXEC 接入 compose 注入
- ⚠️ OAUTH_ALLOWED_HOSTS 是 list[str]，必须写 JSON 数组：本次部署曾因写成逗号分隔字符串
导致启动期 SettingsError、容器重启、网关 502（已修复，并在 compose 默认值中固化 JSON 形态）
- DEPLOYMENT.md 新增「配置取值格式」章节记录该坑与排查方法
- AUDIT-REPORT.md 更新修复进展（含复核 t12 驳回与 t13/t14 通过、残余项）
线上验证：四端 200；Host=localhost → 400；健康检查 exit 0；公网 docs/.DS_Store → 403
|
2026-10-04 05:12:37 +08:00 |
|
|
zhangtao
|
28bf232761
|
docs(audit): 全栈审计报告（7 份分报告 + 总报告）
由 7 名成员并行审计 + 队长线上实测复核产出，合计约 3,600 行：
- backend/audit-backend.md 后端架构与代码质量（22 条）
- backend/audit-security.md 认证/授权/敏感信息（23 条）
- backend/audit-testing.md 测试与可验证性（含真实命令输出）
- backend/audit-requirements.md 需求覆盖对照（多租户规格错位）
- frontend/audit-frontend.md 前端与移动端工程（32 条）
- frontend/audit-uxui.md 交互与视觉一致性
- docker/audit-deploy.md 容器化与部署链路
- AUDIT-REPORT.md 总报告：止血项、修复路线、待决策事项、对既有结论的修正
各报告均标注级别、文件:行号、影响、建议修法，并单列未验证项与抽样边界。
|
2026-10-04 04:26:11 +08:00 |
|