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

1.2 KiB
Raw Blame History

系统字典说明(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:是否启用

约束:

  • 同一 typelabel 唯一。
  • 非系统管理员读取时只返回 enabled=true 的字典项。

4. 接口

  • GET /b/dictionaries:查询字典项
  • POST /b/dictionaries:创建字典项(仅系统管理员)
  • PATCH /b/dictionaries/:id:更新字典项(仅系统管理员)
  • DELETE /b/dictionaries/:id:删除字典项(仅系统管理员)

说明:

  • GET /b/dictionaries?includeDisabled=true 仅系统管理员生效。
  • 患者手术表单现在从该接口动态读取选项,不再使用前端硬编码数组。