Files
zkxw/openspec/changes/dict-management/proposal.md
T
2026-05-17 08:36:37 +08:00

2.0 KiB
Raw Blame History

Why

系统管理模块需要统一的字典数据管理能力。字典管理是基础设施模块——组织管理(zzlbbm、bmzt)、站点管理(zdlx、zdywfw)、角色管理等多个模块依赖字典数据进行状态、分类等编码映射。必须最先开发,其他模块才能正确引用字典值。

What Changes

  • 新增字典类型(sys_dict_type)完整 CRUD:新增、修改、删除(软删除)、分页列表查询
  • 新增字典数据(sys_dict_data)完整 CRUD:按字典类型分组展示,支持新增、修改、删除(软删除)
  • 后端新增 SQLAlchemy 模型、Pydantic schemas、CRUD 函数、API 路由
  • 前端新增字典管理页面:字典类型列表 + 字典数据配置弹窗,遵循 unit/index.vue 标准列表模板
  • 前端新增 API 函数、TypeScript 类型定义、路由注册
  • 遵循租户隔离(tenant_no 过滤)、默认排序(create_time DESC)、软删除(del_flag)

Capabilities

New Capabilities

  • dict-crud: 字典类型和字典数据的完整增删改查能力,包含分页列表、详情查询、创建、更新、软删除,支持租户隔离和关键词搜索
  • dict-frontend: 字典管理前端页面,包含字典类型标准列表页和字典数据配置弹窗,遵循 Fresh Mint UI 规范和 web-admin 模板页约定

Modified Capabilities

(无已有 spec 需要修改)

Impact

  • 后端:app/models/models.py 新增 SysDictType、SysDictData 模型;app/api/admin.py 或新建路由文件新增字典 API;app/crud/ 新增字典 CRUD
  • 前端:src/api/admin.ts 新增字典 API 函数;src/types/api.d.ts 新增 Dict 类型命名空间;src/views/system/dict/index.vue 新建页面;src/router/modules/sqxp.ts 注册路由
  • 数据库:表已包含在 docs/sql/zkxw.sql(sys_dict_type、sys_dict_data),无需新建表
  • 依赖关系:组织管理、站点管理、角色管理等模块将依赖本模块提供的字典数据