|
|
573ef28237
|
完善 API 文档生成规范：统一路由注册和 OpenAPI 文档自动生成
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 4m32s
主要改进：
1. 新增 docs/api-documentation-guide.md 详细文档指南
2. 在 AGENTS.md 中添加路由注册规范章节
3. 更新 README.md 文档目录结构
路由注册改进：
- 统一使用 Register() 函数注册路由并自动生成文档
- 所有接口必须指定 RouteSpec（Summary, Tags, Input, Output, Auth）
- 修复 docs.go 和 gendocs/main.go 使用 RegisterRoutesWithDoc 统一注册
DTO 规范更新：
- shop_dto.go 和 shop_account_dto.go 补充完整的 description 标签
- 所有枚举字段必须列出可能值和中文说明
文档生成优化：
- admin-openapi.yaml 自动生成更新
- 健康检查和任务管理接口加入文档
- H5 认证接口完整文档化
规范文档管理：
- 添加规范文档管理流程说明
- 详细文档放在 docs/ 目录
- AGENTS.md 只保留核心规则和引导链接
|
2026-01-21 10:20:52 +08:00 |
|
|
|
4abbf558e4
|
完善 DTO 规范：统一 description 标签并添加 AI 助手自动检查指引
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 4m28s
- 修复所有 DTO 文件的 description 标签（10 个文件）
- 枚举字段统一使用中文说明（用户类型、角色类型、权限类型等）
- 状态字段明确说明 0/1 含义
- validate 标签与 OpenAPI 标签保持一致
- 在 AGENTS.md 和 CLAUDE.md 添加 DTO 规范章节
- AI 助手必须执行的 7 项检查清单
- 常见枚举字段标准值参考
- 确保未来 AI 助手自动遵循规范
- 创建规范文档
- docs/code-review-checklist.md（Code Review 检查清单）
- docs/dto-improvement-summary.md（DTO 改进总结）
- docs/ai-dto-guidelines-update.md（AI 指引更新说明）
- 重新生成 OpenAPI 文档（375 个 description 标签）
影响：所有 API 字段现在都有清晰的中文说明，前端开发更友好
|
2026-01-20 15:10:11 +08:00 |
|
|
|
18f35f3ef4
|
feat: 完成B端认证系统和商户管理模块测试补全
主要变更：
- 新增B端认证系统（后台+H5）：登录、登出、Token刷新、密码修改
- 完善商户管理和商户账号管理功能
- 补全单元测试（ShopService: 72.5%, ShopAccountService: 79.8%）
- 新增集成测试（商户管理+商户账号管理）
- 归档OpenSpec提案（add-shop-account-management, implement-b-end-auth-system）
- 完善文档（使用指南、API文档、认证架构说明）
测试统计：
- 13个测试套件，37个测试用例，100%通过率
- 平均覆盖率76.2%，达标
OpenSpec验证：通过（strict模式）
|
2026-01-15 18:15:17 +08:00 |
|
|
|
a36e4a79c0
|
实现用户和组织模型（店铺、企业、个人客户）
核心功能：
- 实现 7 级店铺层级体系（Shop 模型 + 层级校验）
- 实现企业管理模型（Enterprise 模型）
- 实现个人客户管理模型（PersonalCustomer 模型）
- 重构 Account 模型关联关系（基于 EnterpriseID 而非 ParentID）
- 完整的 Store 层和 Service 层实现
- 递归查询下级店铺功能（含 Redis 缓存）
- 全面的单元测试覆盖（Shop/Enterprise/PersonalCustomer Store + Shop Service）
技术要点：
- 显式指定所有 GORM 模型的数据库字段名（column: 标签）
- 统一的字段命名规范（数据库用 snake_case，Go 用 PascalCase）
- 完整的中文字段注释和业务逻辑说明
- 100% 测试覆盖（20+ 测试用例全部通过）
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-01-09 18:02:46 +08:00 |
|
