先更新1版记录下

This commit is contained in:
2026-04-16 11:30:30 +08:00
parent ead8e2edd5
commit 2f2d796e30
40 changed files with 393714 additions and 4071 deletions

View File

@@ -5,7 +5,7 @@
- [x] 根目录骨架已创建:`backend``frontend``app``init/pg`
- [x] `backend` Maven 多模块目录与基础 POM 已落地
- [x] `gateway``auth``upms``boot-dev``python-ai` 首版占位代码已创建
- [x] `init/pg` 已按模块拆分,并接入根目录 `sys_area.sql`
- [x] `init/pg` 已按模块拆分,并接入根目录 `tb_sys_area.sql`
- [x] 学校租户表命名已修正为 `tb_sys_tenant`
- [x] 跨包 DTO、Enums 已收口到对应 `api-*` 模块
- [x] Web 端已从 workspace 收敛为单一 React 项目
@@ -40,7 +40,7 @@
- `backend/apis``api-auth``api-upms``api-ai`
- `backend/gateway`统一入口、鉴权、路由、跨域、trace 透传
- `backend/auth`登录、token、当前用户
- `backend/upms`:用户、角色、权、菜单动态路由元数据、组织与区域基座
- `backend/upms`:用户、角色、菜单授权、菜单动态路由元数据、组织与区域基座
- `backend/ai-client`Java 调 Python 的适配层
- `backend/boot-dev`:本地聚合启动模块
- `backend/python-ai`:独立 Python AI 服务占位
@@ -76,9 +76,9 @@
- 区域是分库分表的核心路由维度:
- 以“省份区域”作为首要分片依据
- 业务表设计时必须显式保留区域路由字段
- `sys_area.sql` 视为区域基础数据来源约束:
- 首版必须预留 `sys_area` 基础表和初始化脚本接入位
- 区域编码、层级、父子关系以 `sys_area.sql` 为准
- `tb_sys_area.sql` 视为区域基础数据来源约束:
- 首版必须预留 `tb_sys_area` 基础表和初始化脚本接入位
- 区域编码、层级、父子关系以 `tb_sys_area.sql` 为准
- 首版数据模型明确区分两棵树:
- 区域树:省 / 市 / 区县
- 组织树:总校 / 分校 / 校区 / 部门
@@ -88,7 +88,6 @@
- `SysDept`
- `SysUser`
- `SysRole`
- `SysPermission`
- 所有租户级业务主表统一预留字段:
- `adcode`
- `tenant_id``school_id`
@@ -106,7 +105,7 @@
- 目录结构固定为类似:
- `init/pg/00_create_db.sql`
- `init/pg/01_create_schema.sql`
- `init/pg/sys/sys_area.sql`
- `init/pg/sys/tb_sys_area.sql`
- `init/pg/auth/*.sql`
- `init/pg/upms/*.sql`
- `init/pg/ai/*.sql`
@@ -114,12 +113,12 @@
- 每个模块维护自己的建表 SQL、索引 SQL、初始化数据 SQL
- 不把所有表混在一个超大 SQL 文件中
- 公共基础表单独归 `sys``common` 目录
- `sys_area.sql` 固定归属:
- `tb_sys_area.sql` 固定归属:
- 放在 `init/pg/sys/`
- 作为区域基础数据的首批初始化脚本
- 模块 SQL 的职责边界固定:
- `auth`登录、token、认证相关表
- `upms`:用户、角色、权限、菜单、学校租户、部门、区域引用关系
- `upms`:用户、角色、菜单、角色菜单授权、学校租户、部门、区域引用关系
- `ai`AI 调用记录、任务记录、模型配置占位
- 初始化脚本执行规则固定:
- 先执行库 / Schema 基础脚本
@@ -150,7 +149,7 @@
- `traceId`
- `upms` 首版接口能力必须覆盖:
- 当前用户信息
- 用户 / 角色 / 权基座
- 用户 / 角色 / 菜单授权基座
- 区域树查询
- 学校租户树查询
- 部门树查询
@@ -189,7 +188,7 @@
- PostgreSQL 与 Redis 本地联调配置可跑通
- SQL 初始化验证必须覆盖:
- `init/pg` 下脚本可按顺序执行
- `sys_area.sql` 可独立导入
- `tb_sys_area.sql` 可独立导入
- `auth``upms` 模块脚本可独立维护且组合执行无冲突
- 区域与租户模型最小验证必须覆盖:
- 区域树可查询
@@ -202,5 +201,5 @@
- 不使用 `Dubbo`
- 首版不做真实业务页面、不做学生端真实业务、不做真实 AI 推理
- `upms` 继续承担首版系统管理中心职责
- `sys_area.sql` 是必须接入的区域基础数据脚本,且归档在 `init/pg/sys/`
- `tb_sys_area.sql` 是必须接入的区域基础数据脚本,且归档在 `init/pg/sys/`
- 部门当前先按“年级、学科等组织维度”建模,不在首版细化更复杂教学组织规则