tyt-api-nest/docs/dictionaries.md
EL 73082225f6 "1. 新增系统字典与全局植入目录相关表结构及迁移
2. 扩展患者手术与材料模型,更新种子数据
3. 新增字典模块,增强设备植入目录管理能力
4. 重构患者后台服务与表单链路,统一权限与参数校验
5. 管理台新增字典页面并改造患者/设备页面与路由权限
6. 补充字典及相关领域 e2e 测试并更新文档"
2026-03-19 20:42:17 +08:00

43 lines
1.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 系统字典说明(`src/dictionaries`
## 1. 目标
- 将患者手术表单中的固定选项沉淀为系统级字典。
- 仅允许 `SYSTEM_ADMIN` 做 CRUD。
- 业务角色仅可读取启用中的字典项,用于患者录入表单。
## 2. 当前字典类型
- `PRIMARY_DISEASE`:原发病
- `HYDROCEPHALUS_TYPE`:脑积水类型
- `SHUNT_MODE`:分流方式
- `PROXIMAL_PUNCTURE_AREA`:近端穿刺区域
- `VALVE_PLACEMENT_SITE`:阀门植入部位
- `DISTAL_SHUNT_DIRECTION`:远端分流方向
## 3. 数据结构
新增 `DictionaryItem`
- `type`:字典类型枚举
- `label`:字典项显示值
- `sortOrder`:排序值,越小越靠前
- `enabled`:是否启用
约束:
- 同一 `type``label` 唯一。
- 非系统管理员读取时只返回 `enabled=true` 的字典项。
## 4. 接口
- `GET /b/dictionaries`:查询字典项
- `POST /b/dictionaries`:创建字典项(仅系统管理员)
- `PATCH /b/dictionaries/:id`:更新字典项(仅系统管理员)
- `DELETE /b/dictionaries/:id`:删除字典项(仅系统管理员)
说明:
- `GET /b/dictionaries?includeDisabled=true` 仅系统管理员生效。
- 患者手术表单现在从该接口动态读取选项,不再使用前端硬编码数组。