cont/mjava-sairui/docs/架构设计.md

架构设计

前后端关系

Vue 3 移动端 / 管理端
        |
        | /api/v1
        v
Spring Boot 2.7.18
        |
        +-- MyBatis-Plus -- MySQL 8
        |
        +-- 钉钉 JS API / 服务端开放能力（后续接入）

后端分层

每个业务模块按 controller、service、mapper、entity、dto、vo 划分。Controller 仅处理 HTTP 协议，Service 承载业务规则，Mapper 只负责数据访问。跨模块能力放在 common、config、integration。

API 约定

所有 API 返回以下结构：

{
  "code": 0,
  "message": "成功",
  "data": {}
}

业务错误使用 40002，参数校验错误使用 40001，系统异常使用 50000。接口路径以 /api/v1 为前缀。

身份与权限

钉钉用户标识是系统身份主键。系统只保存用户与角色、数据范围的映射，不保存密码。真实免登和服务端签名校验完成前，模拟 Header 只可用于本地开发。