feat(mini-app, docs): 新增小程序详情页,更新项目文档与规范

新增全套关联组件:DetailHero、DetailOverviewCard、DetailInfoCard、DetailMediaGallery、DetailActionBar及ConciergeContactSheet。
新增详情页数据处理工具类detailPresentation.ts,处理商品展示数据的格式化与默认值兼容。
更新项目文档:补充三个领域API补充文档引用,优化AGENTS.md中的前端代码规范与docs文档列表。
This commit is contained in:
duanshuwen committed 2026-08-17 23:28:07 +08:00
1 parent 548f91c37f
commit ca6f9397e0
17 files changed
+1351 -7

No files matched your search

+17 -5
View File
@@ -9,15 +9,21 @@
1. `backend-api-service.md`
2. `backend-plan.md`
3. `admin-api-requirements.md`
4. `module-config-api.md`
5. `public-api.md`
4. `wanfa-api.md`
5. `concierge-api.md`
6. `detail-api.md`
7. `module-config-api.md`
8. `public-api.md`
管理前端开发:
1. `integration-workflow.md`
2. `admin-api-requirements.md`
3. `module-config-api.md`
4. `development-status.md`
3. `wanfa-api.md`
4. `concierge-api.md`
5. `detail-api.md`
6. `module-config-api.md`
7. `development-status.md`
MiniAPP 前台开发:
@@ -36,12 +42,18 @@ MiniAPP 前台开发:
| `backend-plan.md` | 当前 FastAPI 后端定位、业务模块、近期优先级和安全部署原则 | 后端 |
| `admin-api-requirements.md` | Admin UI 必需的 Admin API 主契约 | 后端、管理前端 |
| `module-config-api.md` | 页面模块配置 CRUD 的唯一细节契约 | 后端、管理前端 |
| `wanfa-api.md` | 玩法分类和路线管理 API 的补充契约 | 后端、管理前端 |
| `concierge-api.md` | 管家顾问资料管理 API 的补充契约 | 后端、管理前端 |
| `detail-api.md` | 详情展示内容管理 API 的补充契约 | 后端、管理前端 |
| `public-api.md` | MiniAPP 对接后端的 Public API 契约 | 后端、MiniAPP |
## 文档边界
- `public-api.md` 是 MiniAPP 对接后端的唯一 Public API 契约。
- `admin-api-requirements.md` 是 Admin UI 对接后端的主契约。
- `wanfa-api.md` 是玩法分类和路线管理的 Admin API 补充契约。
- `concierge-api.md` 是管家顾问资料管理的 Admin API 补充契约。
- `detail-api.md` 是详情展示内容管理的 Admin API 补充契约。
- `module-config-api.md` 是页面模块 CRUD 细节的唯一权威文档。
- `integration-workflow.md` 只写联调流程,不重复接口字段。
- `development-status.md` 只记录当前状态,不替代测试结果。
@@ -51,4 +63,4 @@ MiniAPP 前台开发:
- 文档示例不得写入真实 Token、JWT secret、客服链接、企业 ID、手机号或生产环境变量值。
- `.env`、`.env.local` 和生产配置不进入文档目录。
- 涉及重置数据、发布、回滚、迁移或生产操作的文档,需要明确风险和验证方式。
- 涉及重置数据、发布、回滚、迁移或生产操作的文档,需要明确风险和验证方式。