dd

doc/md/Arch.md

@@ -0,0 +1,260 @@
+## 子系统关系图示例
+
+### 1. 系统上下文图（System Context Diagram）
+
+```mermaid
+graph TD
+    subgraph 外部实体
+        User[用户]
+        CustomerSystem[客户系统]
+        SupplierSystem[供应商系统]
+        PaymentGateway[支付网关]
+    end
+    
+    subgraph 核心系统
+        MainSystem[主系统]
+        
+        subgraph 子系统A[子系统A - 订单管理]
+            OrderService[订单服务]
+            InventoryService[库存服务]
+            PricingService[定价服务]
+        end
+        
+        subgraph 子系统B[子系统B - 用户管理]
+            AuthService[认证服务]
+            ProfileService[用户档案服务]
+            PermissionService[权限服务]
+        end
+        
+        subgraph 子系统C[子系统C - 数据分析]
+            ReportService[报表服务]
+            AnalyticsService[分析服务]
+            DashboardService[仪表盘服务]
+        end
+        
+        subgraph 子系统D[子系统D - 通知中心]
+            EmailService[邮件服务]
+            SMSGateway[短信网关]
+            PushService[推送服务]
+        end
+    end
+    
+    subgraph 数据存储
+        DB[(数据库)]
+        Cache[(缓存)]
+        LogStorage[(日志存储)]
+    end
+    
+    %% 外部实体连接
+    User --> MainSystem
+    CustomerSystem <--> MainSystem
+    SupplierSystem <--> MainSystem
+    PaymentGateway <--> MainSystem
+    
+    %% 主系统与子系统连接
+    MainSystem --> OrderService
+    MainSystem --> AuthService
+    MainSystem --> ReportService
+    MainSystem --> EmailService
+    
+    %% 子系统内部连接
+    OrderService --> InventoryService
+    OrderService --> PricingService
+    AuthService --> ProfileService
+    AuthService --> PermissionService
+    ReportService --> AnalyticsService
+    ReportService --> DashboardService
+    EmailService --> SMSGateway
+    EmailService --> PushService
+    
+    %% 子系统与数据存储连接
+    OrderService --> DB
+    InventoryService --> DB
+    ProfileService --> DB
+    PermissionService --> DB
+    AnalyticsService --> DB
+    
+    PricingService --> Cache
+    AuthService --> Cache
+    
+    EmailService --> LogStorage
+    SMSGateway --> LogStorage
+    PushService --> LogStorage
+```
+
+### 2. 子系统交互流程图
+
+```mermaid
+sequenceDiagram
+    participant Client as 客户端
+    participant Main as 主系统
+    participant Order as 订单子系统
+    participant User as 用户子系统
+    participant Payment as 支付子系统
+    participant Notify as 通知子系统
+    participant DB as 数据库
+    
+    Client->>Main: 请求创建订单
+    Main->>User: 验证用户身份和权限
+    User->>DB: 查询用户信息
+    DB-->>User: 返回用户数据
+    User-->>Main: 验证通过
+    
+    Main->>Order: 创建订单请求
+    Order->>DB: 查询库存
+    DB-->>Order: 返回库存状态
+    
+    alt 库存充足
+        Order->>DB: 锁定库存
+        Order->>Payment: 发起支付请求
+        Payment->>DB: 创建支付记录
+        DB-->>Payment: 支付记录创建成功
+        Payment-->>Order: 支付已发起
+        Order->>DB: 更新订单状态为"等待支付"
+        Order-->>Main: 订单创建成功
+        Main->>Notify: 发送订单确认通知
+        Notify-->>Client: 推送订单确认消息
+    else 库存不足
+        Order-->>Main: 库存不足
+        Main-->>Client: 返回错误信息
+    end
+```
+
+### 3. 子系统依赖关系图
+
+```mermaid
+graph LR
+    subgraph 基础服务层
+        ConfigSvc[配置服务]
+        LogSvc[日志服务]
+        SecuritySvc[安全服务]
+        CommonLib[公共库]
+    end
+    
+    subgraph 核心业务层
+        UserMgmt[用户管理子系统]
+        ProductMgmt[产品管理子系统]
+        OrderMgmt[订单管理子系统]
+        PaymentMgmt[支付管理子系统]
+    end
+    
+    subgraph 应用服务层
+        API_Gateway[API网关]
+        MobileApp[移动应用服务]
+        WebPortal[Web门户服务]
+        ReportSvc[报表服务]
+    end
+    
+    subgraph 集成层
+        ExternalAPI[外部API集成]
+        MessageQueue[消息队列]
+        EventBus[事件总线]
+    end
+    
+    %% 依赖关系
+    UserMgmt --> ConfigSvc
+    UserMgmt --> LogSvc
+    UserMgmt --> SecuritySvc
+    UserMgmt --> CommonLib
+    
+    ProductMgmt --> ConfigSvc
+    ProductMgmt --> LogSvc
+    ProductMgmt --> CommonLib
+    
+    OrderMgmt --> UserMgmt
+    OrderMgmt --> ProductMgmt
+    OrderMgmt --> LogSvc
+    OrderMgmt --> ConfigSvc
+    OrderMgmt --> CommonLib
+    
+    PaymentMgmt --> OrderMgmt
+    PaymentMgmt --> LogSvc
+    PaymentMgmt --> SecuritySvc
+    PaymentMgmt --> ConfigSvc
+    
+    API_Gateway --> UserMgmt
+    API_Gateway --> ProductMgmt
+    API_Gateway --> OrderMgmt
+    API_Gateway --> PaymentMgmt
+    API_Gateway --> SecuritySvc
+    
+    MobileApp --> API_Gateway
+    WebPortal --> API_Gateway
+    ReportSvc --> UserMgmt
+    ReportSvc --> OrderMgmt
+    ReportSvc --> ProductMgmt
+    
+    UserMgmt --> ExternalAPI
+    PaymentMgmt --> ExternalAPI
+    OrderMgmt --> MessageQueue
+    PaymentMgmt --> MessageQueue
+    UserMgmt --> EventBus
+    OrderMgmt --> EventBus
+    ProductMgmt --> EventBus
+    PaymentMgmt --> EventBus
+```
+
+### 4. C4模型系统上下文图
+
+```mermaid
+graph TD
+    subgraph 系统边界
+        System[企业资源规划系统]
+        
+        subgraph 功能模块
+            HR[人力资源管理]
+            Finance[财务管理]
+            Inventory[库存管理]
+            Sales[销售管理]
+            Production[生产管理]
+        end
+        
+        System --> HR
+        System --> Finance
+        System --> Inventory
+        System --> Sales
+        System --> Production
+    end
+    
+    %% 系统间关系
+    HR <--> Finance: 薪资数据
+    Sales <--> Finance: 订单数据
+    Sales <--> Inventory: 库存查询
+    Production <--> Inventory: 物料需求
+    Production <--> Finance: 成本核算
+    
+    %% 外部系统
+    ExtCRM[外部CRM系统] <--> Sales: 客户数据
+    ExtSupplier[供应商系统] <--> Inventory: 采购数据
+    ExtBank[银行系统] <--> Finance: 支付结算
+    
+    %% 用户
+    HR_User[HR人员] --> HR
+    Finance_User[财务人员] --> Finance
+    Inventory_User[仓库人员] --> Inventory
+    Sales_User[销售人员] --> Sales
+    Prod_User[生产人员] --> Production
+```
+
+### 说明
+
+以上子系统关系图展示了不同类型的系统间关系表示方法：
+
+1. **系统上下文图**：展示了系统的整体架构，包括核心子系统、外部实体和数据存储之间的关系。适合高层次架构设计。
+
+2. **子系统交互流程图**：使用时序图展示子系统之间的交互过程和消息传递顺序，适合描述业务流程中的系统协作。
+
+3. **子系统依赖关系图**：展示了子系统之间的依赖关系，包括基础服务、核心业务、应用服务和集成层的层次结构。
+
+4. **C4模型系统上下文图**：遵循C4模型方法论，展示了企业级系统中的子系统边界和它们之间的关系。
+
+### Mermaid图表类型选择建议
+
+对于展示子系统之间的关系，推荐使用以下Mermaid图表类型：
+
+- **graph TD/LR**：适用于系统上下文图、依赖关系图等静态关系展示
+- **sequenceDiagram**：适用于展示子系统间的交互流程和消息传递
+- **flowchart**：适用于展示更复杂的业务流程和子系统协作
+- **classDiagram**：如果需要展示子系统的类结构和它们之间的关系
+
+选择图表类型时，应根据具体需求考虑：是需要展示静态结构关系，还是动态交互过程；是需要高层次概览，还是详细的交互细节。