 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
|
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 |
|