Commit Graph

7 Commits

Author SHA1 Message Date
张翔 d9192765ff docs: 为LLD会员和预约模块添加版本历史章节
为以下文档补充版本历史章节,保持文档结构一致性:

1. LLD-会员模块详细设计.md (GYM-LLD-001)
2. LLD-预约模块详细设计.md (GYM-LLD-002)

添加的章节:
- 十一、版本历史

现在所有LLD文档都具有完整的章节结构,包括:
- 参考文档
- 模块概述
- 数据模型设计
- 领域模型设计
- 业务流程设计
- 接口设计
- 核心代码设计
- 高并发处理(签到模块有)
- 缓存设计
- 定时任务(签到模块有)
- 异常处理
- 附录
- 版本历史
2026-02-28 17:30:30 +08:00
张翔 90a57ae7b6 docs: 为所有LLD和API文档添加参考文档
为以下文档补充参考文档部分,明确文档依赖关系:

1. LLD-会员模块详细设计.md (GYM-LLD-001)
2. LLD-预约模块详细设计.md (GYM-LLD-002)
3. LLD-签到模块详细设计.md (GYM-LLD-003)
4. API接口文档.md (GYM-API-001)

添加的参考文档:
- 《健身房管理系统产品设计文档》 GYM-PRD-001
- 《健身房管理系统概要设计文档》 GYM-HLD-001
- Spring Boot 3 官方文档
- R2DBC 规范文档
- PostgreSQL 官方文档
- RESTful API 设计规范
- JSON API 规范

正确的文档层级关系:
PRD(产品需求)→ HLD(概要设计)→ LLD(详细设计)→ API(接口文档)
每个文档都应该明确说明其参考的上层文档~
2026-02-28 17:19:30 +08:00
张翔 e67d1c5767 docs: 修正PRD参考文档,移除对HLD/LLD的引用
PRD是产品需求文档,不应参考技术设计文档(HLD/LLD)。
正确的文档层级关系:
- PRD(产品需求)→ HLD(概要设计)→ LLD(详细设计)
- PRD是需求源头,指导技术设计,而非被技术设计指导

修改内容:
- 移除对GYM-HLD-001的引用
- 移除对GYM-LLD-001/002/003的引用
- 移除对Spring Boot和PostgreSQL官方文档的引用
- 添加行业相关的参考文档:
  - 健身房行业数字化转型趋势报告
  - 健身房管理系统竞品分析报告
  - 用户体验设计规范
  - 移动应用设计指南
  - 数据安全与隐私保护规范
2026-02-28 17:13:31 +08:00
张翔 2f1f83ee72 docs: 添加PRD产品设计文档
- 创建GYM-PRD-001产品设计文档
- 包含产品概述、功能需求、非功能需求
- 包含用户故事、验收标准、项目里程碑
- 包含风险应对和成功标准

文档结构:
- 产品概述: 背景、目标、目标用户
- 功能需求: 9大模块详细功能描述
- 非功能需求: 性能、可用性、安全性等
- 用户故事: 会员端和管理端用户故事
- 项目里程碑: 4个阶段交付计划
- 风险与应对: 主要风险识别和应对措施
- 成功标准: 5个维度的量化指标
2026-02-28 17:07:04 +08:00
张翔 e89f5f1f7f docs: 将所有设计文档中的ASCII图转换为Mermaid格式
- HLD-系统概要设计.md: 转换业务范围、总体架构、技术架构、部署架构、模块划分、模块交互、API接口分组等图
- LLD-会员模块详细设计.md: 转换模块边界、实体关系图
- LLD-预约模块详细设计.md: 转换模块边界、实体关系图
- LLD-签到模块详细设计.md: 转换模块边界、实体关系图

Mermaid格式优势:
- 更好的可维护性和可读性
- 支持在Markdown编辑器中实时预览
- 更容易进行版本对比和修改
- 支持多种图表类型(mindmap, graph, erDiagram, sequenceDiagram)~
2026-02-28 16:49:19 +08:00
张翔 8a7936ba4e docs: 添加预约模块和签到模块详细设计文档及API接口文档
- 添加预约模块详细设计文档(LLD-预约模块详细设计.md)
- 添加签到模块详细设计文档(LLD-签到模块详细设计.md)
- 添加API接口文档(API接口文档.md)

文档包含:
- 模块概述与边界定义
- 数据模型设计(含SQL建表语句)
- 领域模型设计
- 业务流程设计
- 接口设计
- 核心代码设计
- 高并发处理方案
- 缓存设计
- 定时任务设计
- 异常处理
- 附录(枚举定义、错误码)~
2026-02-28 14:29:30 +08:00
张翔 e7c0c8a1c2 docs: 添加健身房管理系统产品设计文档
- 系统架构设计(多租户、响应式、事件驱动)
- 会员权益引擎(时长/次数/储值/等级)
- 预约服务模块(团课/私教/场地/线上)
- 签到服务模块(扫码/刷脸/NFC/教练代签)
- 计划中心模块(训练计划/课程排期/会员目标/教练排班)
- 会员端与管理后台功能设计
- 数据库设计(PostgreSQL + R2DBC + Flyway)
- 前端技术架构(uniapp + Vue3)
- 项目实施规划与里程碑~
2026-02-28 13:36:07 +08:00