Skip to content

代码层地图 ​

text
请求 → Filter 链 → Spring Security → Controller → Service(事务/缓存)
      → MyBatis 拦截器(租户 → 数据权限 → 分页)→ Mapper → DB

1. 四块内容 ​

区块目录回答
架构code/architecture/分层、依赖方向、启动与请求链路
框架组件code/framework/15 个 starter 各管什么、配置前缀
横切机制code/patterns/租户、数据权限、鉴权、错误码、日志、MQ、定时任务、代码生成
生成索引code/api/、code/data/441 个控制器、2 392 个接口、388 张表的可检索清单

2. 读代码的三个切入点 ​

  1. 从接口进:/code/api/ 找到路径,拿到 Controller 类名与权限点。
  2. 从表进:/code/data/ 找到表,拿到 DO 类名与字段。
  3. 从机制进:/code/patterns/ 找到注解(如 @TenantIgnore),看它被谁消费。

3. 生成物说明 ​

docs/code/api/*、docs/code/data/* 与 docs/reference/ 下的速查页由 tools/docs/scan-knowledge.mjs 生成,禁止手改;CI 会校验是否与代码一致。