zkxw/openspec/changes/dict-management/proposal.md

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），无需新建表
• 依赖关系：组织管理、站点管理、角色管理等模块将依赖本模块提供的字典数据