外观
UmiUDI 三大方向功能规划与飞检实施方案
项目概述
三大方向均为 UmiUDI 桌面端(WinForms/.NET 9)的重大功能扩展,涉及网络通信、API 对接、法规数据库等核心能力。
方向一:内部即时通讯系统
现状分析
- AntdUI 已内置成熟的
Chat.MsgList(联系人列表)+Chat.ChatList(聊天气泡)组件 - 参考 Demo 位于
E:\AntdUI-main\example\ChatUI\,结构清晰:左侧联系人面板 + 右侧消息面板 - 组件支持:文本消息、图片消息、GPT 流式显示、未读计数徽标、右键菜单操作
- 项目已使用 AntdUI v2.1.13(NuGet 包),可直接调用 Chat 命名空间下的控件
技术方案
通信架构
| 方案 | 优点 | 缺点 | 建议 |
|---|---|---|---|
| A. WebSocket 长连接 | 实时性好、双向推送 | 需服务端支持 | ✅ 推荐 |
| B. 轮询 HTTP API | 简单易实现 | 延迟高、浪费资源 | ❌ |
| C. SignalR | .NET 原生方案、自动降级 | 服务端需 ASP.NET Core | ✅ 备选 |
IMPORTANT
关键决策:通讯后端放在哪里?
- 选项 A:扩展现有 API 项目
UmiUDI - API(umiudi.cn:1031),增加 WebSocket/SignalR Hub - 选项 B:独立部署新的即时通讯微服务
- 建议:选项 A,直接在现有 API 项目中增加
/hub/chatSignalR 端点,减少运维复杂度
功能范围(MVP)
- 联系人管理:从数据库
sys_user加载企业内部用户列表,显示在线状态 - 一对一消息:支持文本消息发送和接收
- 消息持久化:数据库存储消息历史(新建
sys_chat_message表) - 未读计数:托盘气泡 + 侧边栏徽标
- 管理员通道:用户可直接联系管理员(售后通道)
数据库设计
sql
CREATE TABLE sys_chat_message (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
sender_id INT NOT NULL, -- 发送者用户ID
receiver_id INT NOT NULL, -- 接收者用户ID
content TEXT NOT NULL, -- 消息内容
msg_type TINYINT DEFAULT 0, -- 0=文本, 1=图片, 2=文件
is_read TINYINT DEFAULT 0, -- 是否已读
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
INDEX idx_receiver (receiver_id, is_read),
INDEX idx_conversation (sender_id, receiver_id, created_at)
);客户端页面
- 新增
Pages/Chat.cs+Pages/Chat.Designer.cs - 在
Mian.cs的侧边栏菜单中增加「内部消息」入口 - 参考 AntdUI ChatUI Demo 的布局:
MsgList(DockLeft) +ChatList(DockFill)
实施步骤
| 阶段 | 内容 | 预估工期 |
|---|---|---|
| Phase 1 | API 端增加 SignalR Hub + 消息表 | 2-3 天 |
| Phase 2 | 客户端 Chat 页面 UI(参考 ChatUI Demo) | 1-2 天 |
| Phase 3 | 消息收发逻辑 + 在线状态 | 2 天 |
| Phase 4 | 未读计数、通知集成、消息历史加载 | 1-2 天 |
方向二:API 开发文档页
现状分析
- API 项目位于
E:\backup\UmiUDI&Drug\UmiUDI - API\ - 基于 ASP.NET Core,已部署在
umiudi.cn:1031 - 当前仅有 2 个 Controller:
AlipayController.cs(支付)和UdiController.cs(UDI 查询) - Models 层已有 42 个实体模型,覆盖 DI 信息、仓库管理、ERP 单据、质检等全业务域
- 已有文档:
API_URLs.md、QUICK_START.md、README_Payment_API.md、DATABASE_MIGRATION.md、DEPLOYMENT_CHECKLIST.md
需要完善的方向
API 扩展(后端)
根据已有的 42 个 Model,以下业务域需要增加 API Controller:
| 优先级 | Controller | 覆盖模型 | 用途 |
|---|---|---|---|
| P0 | DiController | di, di_status, di_gen, di_download | DI 信息增删改查、状态管理、同步 |
| P0 | UdiScdController | udi_scd, udi_scd_detail | UDI 首次登记 CRUD |
| P1 | CkController | ck_inout, ck_inout_detail | 仓库出入库 API |
| P1 | UdiZjController | (关联质检数据) | 质检记录查询、报告导出 |
| P2 | ErpController | erp_scdd, erp_sclld, erp_xsckd 等 | ERP 单据同步 |
| P2 | ChatController | sys_chat_message | 即时通讯消息 API(配合方向一) |
文档页面(客户端)
IMPORTANT
关键决策:开发文档页是放在客户端桌面软件内部,还是作为独立 Web 页面?
- 选项 A:在客户端内嵌 WebView,展示 Swagger 或自定义文档页
- 选项 B:独立 Web 站点(如
docs.umiudi.cn),使用 VitePress/Docusaurus - 建议:选项 B,API 文档天然适合 Web 形式,便于分享和搜索
方向三:药监局飞检材料自动准备
检查要点综合研究
根据国家药监局(NMPA)2024-2025 年飞行检查政策、YY/T 1942-2024 等行业标准,以及大量飞检通报案例,整理出 UDI 相关的全量检查项,共计 6 大类、28 个检查子项:
一、基础管理与制度(5 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 1.1 | 质量体系文件中是否包含 UDI 管理程序 | 医疗器械生产质量管理规范 | 手动上传 |
| 1.2 | 是否明确 UDI 负责部门和岗位人员 | GMP 附录 | 从 sys_user / sys_department 提取 |
| 1.3 | UDI 法规培训记录(含签到表、考核记录) | GMP §22 | 手动上传 |
| 1.4 | UDI 内审记录 / 管理评审涉及 UDI 的内容 | GMP §70 | 手动上传 |
| 1.5 | UDI 年度自查报告中的 UDI 章节 | 药监局年报要求 | 系统自动生成框架 |
二、编码赋码合规性(6 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 2.1 | 厂商识别代码(GS1 前缀)是否有效 | GS1 标准 | 从 di 表 tyshxydm 自动校验 |
| 2.2 | DI 编码是否符合编码机构规则 | YY/T 1942-2024 | 从 di 表自动校验格式 |
| 2.3 | PI(批号/序列号/有效期)编码格式合规 | GS1 AI 标准 | 从 udi_scd 自动提取 |
| 2.4 | 条码/二维码载体印刷质量 | ISO 15415/15416 | ✅ 已有!质检模块直接出报告 |
| 2.5 | 各包装层级 UDI 标识完整性 | 药监局第 32 号公告 | 从 di_devicepackage 自动校验 |
| 2.6 | HRI(人工可识读信息)与 AIDC 一致性 | YY/T 1942 §5.3 | 质检扫码模块自动对比 |
三、UDID 数据库申报(4 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 3.1 | 所有上市产品是否在 UDID 完成数据申报 | 药监局第 32 号公告 | di_status 表状态字段 |
| 3.2 | 数据库填报信息与注册证一致性 | UDI 规则 §8 | di vs di_download 自动对比 |
| 3.3 | 产品变更后数据库是否及时更新 | UDI 规则 §10 | di_status.update_time 时效校验 |
| 3.4 | PI 组成规则是否正确填报 | UDID 填报指南 | di 表 PI 相关字段 |
四、生产追溯(5 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 4.1 | 生产记录是否包含 UDI 信息 | GMP §85 | udi_scd 生产记录关联 |
| 4.2 | 原材料批次可追溯到 UDI 产品 | GMP §70 | udi_scd_detail + erp_sclld |
| 4.3 | 检验记录与 UDI 关联 | GMP §98 | udi_cj 质检记录 |
| 4.4 | 不合格品 UDI 可定位到受影响批次 | GMP §100 | 系统追溯链查询 |
| 4.5 | 模拟追溯测试:正向+逆向可达 | 飞检重点 | ✅ 关联查询模块已有 |
五、仓储与流通追溯(4 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 5.1 | 入库/出库扫码记录完整 | GMP 仓储管理 | ck_inout + ck_inout_detail |
| 5.2 | 销售出库记录含 UDI | 药监局追溯要求 | erp_xsckd |
| 5.3 | 退货/召回可通过 UDI 精确定位 | GMP §103 | erp_xsthd |
| 5.4 | 库存盘点与 UDI 系统数据一致 | GMP 仓储管理 | ck_inout 汇总校验 |
六、系统与数据完整性(4 项)
| # | 检查项 | 法规依据 | 数据来源 |
|---|---|---|---|
| 6.1 | 计算机化系统权限管理 | GMP 附录-计算机化系统 | sys_user 权限字段 |
| 6.2 | 审计追踪 / 操作日志 | GMP 附录 §11 | 系统日志模块 |
| 6.3 | 数据备份与恢复机制 | GMP 附录 §14 | 运维文档 |
| 6.4 | 电子签名 / 审核流程 | GMP 附录 §9 | _review 表审核记录 |
功能设计
页面结构
新增 Pages/FlyInspection.cs(飞检材料准备中心),包含:
- 飞检仪表盘:28 项检查的总体完成率,红/黄/绿三色状态指示
- 分类检查清单:6 大类可折叠面板,每项显示:检查项名称、法规依据、当前状态(通过/待检/缺失)、一键跳转到对应模块
- 一键体检:自动扫描数据库,执行所有可自动化检查(约 18 项),生成《UDI 飞检自查报告》
- 材料导出:一键导出 PDF 格式的飞检自查报告包
自动化检查能力
| 检查类型 | 可自动化项数 | 需手动项数 | 合计 |
|---|---|---|---|
| 编码赋码合规 | 6 | 0 | 6 |
| UDID 数据库 | 4 | 0 | 4 |
| 生产追溯 | 4 | 1 | 5 |
| 仓储流通 | 4 | 0 | 4 |
| 基础管理 | 1 | 4 | 5 |
| 系统完整性 | 3 | 1 | 4 |
| 合计 | 22 | 6 | 28 |
22/28 = 78.6% 自动化率,企业只需手动准备 6 项纸质/PDF 材料
实施优先级建议
IMPORTANT
建议优先级排序:方向三 > 方向一 > 方向二
| 优先级 | 方向 | 理由 |
|---|---|---|
| 🥇 P0 | 飞检材料准备 | 直接解决客户核心痛点,有巨大的商业价值和合规刚需;软件的数据库已有约 78% 检查项的数据,自动化程度高 |
| 🥈 P1 | 内部即时通讯 | 提升客户粘性和售后效率,AntdUI 已有成熟组件,开发成本相对可控 |
| 🥉 P2 | API 文档完善 | 重要但非紧急,API 扩展可随业务需求逐步推进 |