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图表采用统一的边框样式,左右两侧对齐,提高可读性。~
This commit is contained in:
张翔
2026-03-04 10:20:11 +08:00
parent 9f8fdd9368
commit 97c5c08513
4 changed files with 556 additions and 606 deletions
+67 -73
View File
@@ -39,28 +39,36 @@
### 1.2 模块边界
```mermaid
graph TB
subgraph Internal[签到模块内部]
C1[签到网关]
C2[签到验证]
C3[签到记录]
C4[签到统计]
end
subgraph ExternalDeps[外部依赖]
D1[会员模块<br/>查询会员信息、验证会员状态]
D2[权益模块<br/>验证权益有效性、扣减权益]
D3[预约模块<br/>查询预约信息、验证签到资格]
D4[设备模块<br/>人脸识别设备、NFC读卡器]
D5[消息模块<br/>发送签到通知]
end
subgraph Deps[被依赖]
U1[财务模块<br/>签到消费记录]
U2[数据模块<br/>签到数据分析、会员活跃度统计]
U3[考勤模块<br/>教练考勤统计]
end
```
┌─────────────────────────────────────────────────────────────────────────┐
│ 签到模块边界 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ 签到模块内部 │ │
│ ├─────────────────────────────────────────────────────────────────┤ │
│ │ • 签到网关 • 签到验证 • 签到记录 • 签到统计 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ 外部依赖 │ │
│ ├─────────────────────────────────────────────────────────────────┤ │
│ │ • 会员模块 (查询会员信息、验证会员状态) │ │
│ │ • 权益模块 (验证权益有效性、扣减权益) │ │
│ │ • 预约模块 (查询预约信息、验证签到资格) │ │
│ │ • 设备模块 (人脸识别设备、NFC读卡器) │ │
│ │ • 消息模块 (发送签到通知) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ 被依赖 │ │
│ ├─────────────────────────────────────────────────────────────────┤ │
│ │ • 财务模块 (签到消费记录) │ │
│ │ • 数据模块 (签到数据分析、会员活跃度统计) │ │
│ │ • 考勤模块 (教练考勤统计) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
### 1.3 签到类型
@@ -78,57 +86,43 @@ graph TB
### 2.1 实体关系图
```mermaid
erDiagram
member ||--o{ checkin_record : makes
booking_record ||--o{ checkin_record : for
device ||--o{ checkin_record : used
member ||--o{ member_face : has
member {
bigint id PK
varchar name
varchar phone
smallint status
}
booking_record {
bigint id PK
bigint member_id FK
bigint slot_id FK
smallint status
smallint checkin_status
}
device {
bigint id PK
varchar name
smallint type
varchar location
smallint status
}
checkin_record {
bigint id PK
bigint tenant_id FK
bigint store_id FK
bigint member_id FK
bigint booking_id FK
bigint device_id FK
smallint type
smallint method
smallint status
timestamp checkin_at
date checkin_date
}
member_face {
bigint id PK
bigint member_id FK
bytea face_feature
smallint status
}
```
┌─────────────────────────────────────────────────────────────────────────┐
│ 实体关系图 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │
│ │ member │ │ booking_record │ │ device │ │
│ │ (会员) │ │ (预约记录) │ │ (设备) │ │
│ └──────┬───────┘ └────────┬─────────┘ └──────┬───────┘ │
│ │ 1:N │ 1:N │ 1:N │
│ │ │ │ │
│ └───────────────────┴─────────────────────┘ │
│ │ 1:N │
│ ▼ │
│ ┌──────────────────┐ │
│ │ checkin_record │ │
│ │ (签到记录) │ │
│ └──────────────────┘ │
│ │
│ ┌──────────────┐ │
│ │ member │ │
│ │ (会员) │ │
│ └──────┬───────┘ │
│ │ 1:N │
│ ▼ │
│ ┌──────────────────┐ │
│ │ member_face │ │
│ │ (会员人脸) │ │
│ └──────────────────┘ │
│ │
│ 关系说明: │
│ • member (1) ─── (N) checkin_record : 一个会员有多个签到记录 │
│ • booking_record (1) ─── (N) checkin_record : 一个预约有多个签到记录 │
│ • device (1) ─── (N) checkin_record : 一个设备有多个签到记录 │
│ • member (1) ─── (N) member_face : 一个会员有多个人脸特征 │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
### 2.2 数据表设计