docs: add import template download task
This commit is contained in:
+20
@@ -1542,3 +1542,23 @@
|
||||
- `git diff --check`:通过,仅 Windows CRLF 提示。
|
||||
- 已知测试环境现象:一次 API 目标测试与 portal 目标测试并行启动时,API 测试在连接远程 MySQL `43.128.3.240` 建测试库阶段超时;随后 `Test-NetConnection 43.128.3.240 -Port 3306` 显示 `TcpTestSucceeded=True`,单独重跑 API 目标测试通过。测试期仍保留 allauth `account.EmailAddress` 条件唯一约束在 MySQL 上不可创建的既有 `models.W036` 警告。
|
||||
- 下一步:当前看板无编号 TODO;建议按业务优先级拆真实支付回调到账闭环、配置并发布客户端下载包、真实图片耗时验证,或从 Backlog 创建新任务。
|
||||
|
||||
## 2026-07-08 需求+决策:T-610 首页导入模板下载入口
|
||||
|
||||
- 状态:DONE(文档决策与任务拆分,未改代码)。
|
||||
- 背景:公开首页已有“下载客户端”入口,但桌面端导入商品数据需要 Excel 模板。产品要求在“下载客户端”右侧增加“下载导入模板”链接,并允许运营在后台更新模板文件。
|
||||
- 全栈分析:
|
||||
- 前端:该入口属于公开首页下载区的一部分,应与“下载客户端”并列但保持次级样式;移动端需要换行不重叠。
|
||||
- 后端:不应硬编码静态文件路径;模板需要后台可维护,因此应新增独立 `ImportTemplate` 配置模型,而不是复用 `DownloadRelease`。
|
||||
- 存储:本地上传模板放 `MEDIA_ROOT/import_templates/`,生产继续由 Nginx 直接服务 `/media/`,避免文件下载占用 Gunicorn worker;保留 `external_url` 以便后续切 CDN / 对象存储。
|
||||
- 安全:该资源公开匿名下载,不需要 API Key、不读取用户、不扣点;页面不得暴露 `MEDIA_ROOT` 或服务器本地路径;当前模板互斥用应用层事务处理,不使用 MySQL 不支持的条件唯一约束。
|
||||
- 接口:不新增对外 JSON API,首页 SSR 直接渲染当前模板下载链接即可。
|
||||
- 文档变更:
|
||||
- `docs/06-tasks.md`:新增 T-610「首页导入模板下载入口」,状态 TODO,并增加 M9 里程碑。
|
||||
- `docs/02-requirements.md`:新增 P1「导入模板下载」功能行,游客权限加入公开模板下载入口。
|
||||
- `docs/04-architecture.md`:新增 `ImportTemplate` 目标 schema 和首页 / admin / media 托管口径。
|
||||
- `docs/routes.md`:更新 `/` 首页职责与 admin 管理项。
|
||||
- `docs/api.md`:明确导入模板下载不新增对外 JSON API。
|
||||
- `docs/00-ai-start-here.md`、`docs/current-state.md`:记录 T-610 为下一个可领取任务。
|
||||
- 验证:纯文档修改;`git diff --check` 通过。
|
||||
- 下一步:领取 T-610,先实现 `ImportTemplate` 模型/admin/迁移,再更新 `HomeView` 与首页模板,补目标测试并验证迁移、check、portal 首页测试。
|
||||
|
||||
Reference in New Issue
Block a user