Commit Graph

10 Commits

Author SHA1 Message Date
张翔 c1d7660aac 修复所有设计文档中ASCII图表右侧边框对齐问题
- 修复HLD-系统概要设计.md中所有ASCII图表的右侧边框对齐
- 修复LLD-签到模块详细设计.md中ASCII图表的右侧边框对齐
- 修复LLD-会员模块详细设计.md中ASCII图表的右侧边框对齐
- 修复LLD-预约模块详细设计.md中ASCII图表的右侧边框对齐
- 确保所有ASCII图表的右侧边框纵向靠右对齐
2026-03-04 11:20:36 +08:00
张翔 97c5c08513 refactor: 将设计文档中的Mermaid图表转换为ASCII格式
为提高兼容性,避免Mermaid版本兼容问题,将所有设计文档中的
Mermaid图表转换为ASCII格式。

修改文件:
- HLD-系统概要设计.md
  • 业务范围图 (mindmap → ASCII)
  • 总体架构图 (graph → ASCII)
  • 技术架构图 (graph → ASCII)
  • 部署架构图 (graph → ASCII)
  • 模块划分图 (graph → ASCII)
  • 模块交互图 (sequenceDiagram → ASCII)
  • 接口分组图 (graph → ASCII)

- LLD-会员模块详细设计.md
  • 模块边界图 (graph → ASCII)
  • 实体关系图 (erDiagram → ASCII)

- LLD-预约模块详细设计.md
  • 模块边界图 (graph → ASCII)
  • 实体关系图 (erDiagram → ASCII)

- LLD-签到模块详细设计.md
  • 模块边界图 (graph → ASCII)
  • 实体关系图 (erDiagram → ASCII)

所有ASCII图表采用统一的边框样式,左右两侧对齐,提高可读性。~
2026-03-04 10:20:11 +08:00
张翔 9f8fdd9368 fix: 修复LLD预约模块文档中的重复标题
删除LLD-预约模块详细设计.md中第71行的重复标题
'### 2.1 实体关系图',修复Markdown语法错误。

修复前:
### 2.1 实体关系图
### 2.1 实体关系图

修复后:
### 2.1 实体关系图
2026-03-03 18:00:00 +08:00
张翔 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