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