跳转到正文

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/chat SignalR 端点,减少运维复杂度

功能范围(MVP) ​

  1. 联系人管理:从数据库 sys_user 加载企业内部用户列表,显示在线状态
  2. 一对一消息:支持文本消息发送和接收
  3. 消息持久化:数据库存储消息历史(新建 sys_chat_message 表)
  4. 未读计数:托盘气泡 + 侧边栏徽标
  5. 管理员通道:用户可直接联系管理员(售后通道)

数据库设计 ​

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 1API 端增加 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覆盖模型用途
P0DiControllerdi, di_status, di_gen, di_downloadDI 信息增删改查、状态管理、同步
P0UdiScdControllerudi_scd, udi_scd_detailUDI 首次登记 CRUD
P1CkControllerck_inout, ck_inout_detail仓库出入库 API
P1UdiZjController(关联质检数据)质检记录查询、报告导出
P2ErpControllererp_scdd, erp_sclld, erp_xsckd 等ERP 单据同步
P2ChatControllersys_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.3UDI 法规培训记录(含签到表、考核记录)GMP §22手动上传
1.4UDI 内审记录 / 管理评审涉及 UDI 的内容GMP §70手动上传
1.5UDI 年度自查报告中的 UDI 章节药监局年报要求系统自动生成框架

二、编码赋码合规性(6 项) ​

#检查项法规依据数据来源
2.1厂商识别代码(GS1 前缀)是否有效GS1 标准从 di 表 tyshxydm 自动校验
2.2DI 编码是否符合编码机构规则YY/T 1942-2024从 di 表自动校验格式
2.3PI(批号/序列号/有效期)编码格式合规GS1 AI 标准从 udi_scd 自动提取
2.4条码/二维码载体印刷质量ISO 15415/15416✅ 已有!质检模块直接出报告
2.5各包装层级 UDI 标识完整性药监局第 32 号公告从 di_devicepackage 自动校验
2.6HRI(人工可识读信息)与 AIDC 一致性YY/T 1942 §5.3质检扫码模块自动对比

三、UDID 数据库申报(4 项) ​

#检查项法规依据数据来源
3.1所有上市产品是否在 UDID 完成数据申报药监局第 32 号公告di_status 表状态字段
3.2数据库填报信息与注册证一致性UDI 规则 §8di vs di_download 自动对比
3.3产品变更后数据库是否及时更新UDI 规则 §10di_status.update_time 时效校验
3.4PI 组成规则是否正确填报UDID 填报指南di 表 PI 相关字段

四、生产追溯(5 项) ​

#检查项法规依据数据来源
4.1生产记录是否包含 UDI 信息GMP §85udi_scd 生产记录关联
4.2原材料批次可追溯到 UDI 产品GMP §70udi_scd_detail + erp_sclld
4.3检验记录与 UDI 关联GMP §98udi_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 §103erp_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(飞检材料准备中心),包含:

  1. 飞检仪表盘:28 项检查的总体完成率,红/黄/绿三色状态指示
  2. 分类检查清单:6 大类可折叠面板,每项显示:检查项名称、法规依据、当前状态(通过/待检/缺失)、一键跳转到对应模块
  3. 一键体检:自动扫描数据库,执行所有可自动化检查(约 18 项),生成《UDI 飞检自查报告》
  4. 材料导出:一键导出 PDF 格式的飞检自查报告包

自动化检查能力 ​

检查类型可自动化项数需手动项数合计
编码赋码合规606
UDID 数据库404
生产追溯415
仓储流通404
基础管理145
系统完整性314
合计22628

22/28 = 78.6% 自动化率,企业只需手动准备 6 项纸质/PDF 材料


实施优先级建议 ​

IMPORTANT

建议优先级排序:方向三 > 方向一 > 方向二

优先级方向理由
🥇 P0飞检材料准备直接解决客户核心痛点,有巨大的商业价值和合规刚需;软件的数据库已有约 78% 检查项的数据,自动化程度高
🥈 P1内部即时通讯提升客户粘性和售后效率,AntdUI 已有成熟组件,开发成本相对可控
🥉 P2API 文档完善重要但非紧急,API 扩展可随业务需求逐步推进

UmiUDI & Drug 医疗器械与药品唯一标识全生命周期追溯系统