外观
UmiUDI 开发日志 (DEVLOG)
所有代码变更必须在本文档中记录在案。每条记录包含:日期、变更类型、涉及文件、变更说明。
🚨 生产环境更新日志 (CHANGELOG.md) 编写铁律与红线规范(全体人员强制遵守)
- 严禁出现与实际业务变动无关的内容:坚决禁止将纯内部重构、中间件封装、排查调试过程等无实际业务价值的内容写入面向用户的更新日志。
- 严禁出现任何代码或数据库变动相关内容:坚决禁止出现任何代码文件名(如
.cs、.vue)、类名、方法/函数名、异常类名、数据库表名(如di_devicepackage、udi_scd、ck_inout等)、字段名、SQL 语句或底层技术实现术语。- 只允许显示真正影响用户操作的更新日志:
- 生产环境更新日志面向药械企业客户、质检员与一线仓管操作员,必须纯粹以“用户实际操作方式改变了什么、流程带来了什么便利、增加了什么防呆提示”为唯一标准编写;
- 仅保留直接改变用户操作方式、界面交互、声光防呆警示、合规拦截卡点或新增业务功能的精练条目(每个版本通常 1~4 条,语言通俗庄重);
- 凡不直接影响用户日常操作的底层稳定性优化与内部机制调整,一律不得向用户展示。
- 原详尽日志保留于开发技术归档区:对于详尽的技术排查、开发全量清单与历史细节,统一收录在
### 开发环境(完整原日志与技术变更详情)节中,供研发人员回溯,绝不允许被前端升级弹窗读取展示给最终用户。
2026-11-17 ~ 2026-11-18
[perf/modal-async-cutover] 软件内模态宿主统一、打印回显防覆盖、全链路公网异步提速与 60→117 迁库收口 (v1.3.0.0-r9)
- 涉及模块与核心文件:
- 模态宿主与顶栏修复:
Core/InAppModalHelper.cs[NEW]、Login.cs、Forms/Report_Save.cs、Forms/DI_Gen.cs、Forms/DI_Select.cs、Forms/DTC_DY_Select.cs、Forms/DTC_SCD_Select.cs、Forms/DTC_XSD_Detail_Select.cs、Forms/DY_Select.cs、Forms/NumForm.cs、Forms/Payment.cs、Forms/SCD_Select.cs、Forms/SyncProgressForm.cs、Forms/UDI_View.cs、Forms/XSD_Detail_Select.cs、Forms/XSD_Select.cs、Pages/* - 打印配置防覆盖:
Pages/UDI_DY.cs、Pages/DTC_DY.cs、Pages/UDI_BQSJ.cs、Pages/DTC_BQSJ.cs - 代理绕过、连接池与异步秒开:
Core/NetworkProxyBypass.cs[NEW]、Program.cs、Mian.cs、Core/DbFactory.cs、Core/DbMigrator.cs、Core/CheckTable.cs、Core/DataHelper.cs、Core/ChangYongFangFa.cs、Core/PackageLevelHelper.cs、Pages/UDI_SCD_List.cs、Pages/UDI_DY_List.cs、Pages/UDI_XSD_List.cs、Pages/CK_IN_List.cs、Pages/CK_OUT_List.cs、Pages/CK_IN.cs、Pages/CK_OUT.cs、Pages/UDI_SCD.cs、Pages/DTC_SCD.cs、Pages/UDI_GLCX2.cs - 帮助中心与迁移配置:
docs/guide/03,05,06,07,08*.md、docs/sop/gmp-sop.md、docs/sop/assets/sop_screenshots/*、docs/public/videos/v05~v10.mp4、UmiPDA - API/appsettings*.json、UmiUDI - API/appsettings.Development.json
- 模态宿主与顶栏修复:
- 关键变更说明:
- 软件内模态弹窗宿主统一与崩溃/拖拽修复:
- 新增 [InAppModalHelper.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/InAppModalHelper.cs) 统一托管全部业务弹窗,消除任务栏多开窗口图标、非模态误触穿透与多屏坐标偏移;
- 修复遮罩窗体
maskForm.Enabled = false调用Show(ownerForm)引发InvalidOperationException的崩溃缺陷; - 修复
UDI_BQSJ/DTC_BQSJ调用 [Report_Save.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Forms/Report_Save.cs) 硬编码showHeader = false导致AntdUI.PageHeader顶部拖拽条丢失与上方留白错位问题。
- 打印单编辑回显准确化:
- 修复 [UDI_DY.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Pages/UDI_DY.cs) 与 [DTC_DY.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Pages/DTC_DY.cs) 在编辑打开已有打印任务单时强行读取上游生产单勾选状态覆盖当前持久化数据的逻辑错误;
- 模板下拉列表改为仅查询
Select(it => it.name)(消除同步拉取数十 MB 模板二进制导致的 UI 阻塞),并临时解绑select_bz.SelectedIndexChanged防止回显重入查库。
- 公网性能重构与系统代理绕过:
- 新增 [NetworkProxyBypass.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/NetworkProxyBypass.cs) 并在 [Program.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Program.cs) 启动注册,强制 HTTP/HTTPS 绕过本机系统代理(如
127.0.0.1:10808),防止 ERP/DTC/网关链路被劫持超时; - [Login.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Login.cs) 移除人为
Thread.Sleep,将 AI 初始化与 [CheckTable.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/CheckTable.cs)(含EnsureGencodeRulesBatch批量编码规则同步)后置到主窗体后台异步执行,实现零阻塞进主页;[DbFactory.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/DbFactory.cs) 增加连接串连接池调优与异步预热;[DataHelper.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/DataHelper.cs) 为企业客户列表增加 30 秒 TTL 缓存; - [PackageLevelHelper.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/PackageLevelHelper.cs) 与 [ChangYongFangFa.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/ChangYongFangFa.cs) 全面切换为迭代 BFS 按层批量
IN查询并新增PackagingHierarchyCache.GetShared(60 秒 TTL 全局拓扑缓存 +PreloadUdiDyLevels兜底预加载),淘汰全表拉取与树节点N+1查库; UDI_SCD_List、UDI_DY_List、UDI_XSD_List、CK_IN_List、CK_OUT_List及DI_Select/SCD_Select/XSD_Select/UDI_View全面改为Task.Run+ 异步刷新,侧边栏切页秒开不卡顿。
- 新增 [NetworkProxyBypass.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Core/NetworkProxyBypass.cs) 并在 [Program.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug/Program.cs) 启动注册,强制 HTTP/HTTPS 绕过本机系统代理(如
- 帮助中心 SOP 视频资产更新与
60→117生产配置割接:- 同步更新 SOP 指南第 3/5/6/7/8 章截图与 5 部操作演示视频(
v05~v08, v10)并构建发布 VitePress; - 将
UmiPDA - API与UmiUDI - API配置文件连接串统一切换至117.72.33.1,配合 117 生产环境umiappapi与 60 停库端口转发核查,确认 API 外部零依赖,仅余 4 个未升级老 PC 客户端 IP 经60:3306转发过渡。
- 同步更新 SOP 指南第 3/5/6/7/8 章截图与 5 部操作演示视频(
- 软件内模态弹窗宿主统一与崩溃/拖拽修复:
- 验证结果:
dotnet build UmiUDI.csproj -c Release --no-restore通过(0 个错误);UmiUDI.Gateway.Tests24/24全部通过。
[feat/gateway-pda-proxy] 网关 /app/* HTTPS 反向代理与 PDA 全链路加速闭环 (2026-11-17)
- 涉及模块与提交:
- 网关与单测:
13fca5e(UmiUDI.Gateway/Endpoints/PdaProxyEndpoints.cs[NEW]、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/Program.cs、UmiUDI.Gateway/appsettings.json、UmiUDI.Gateway.Tests/PdaProxyEndpointTests.cs[NEW]) - 协同项目:
UmiPDA(v1.3.42~v1.3.48,已记录于 UmiPDA/docs/DEVLOG.md)、UmiPDA - API(bab891f~0a4e907)
- 网关与单测:
- 关键变更说明:
- 在
UmiUDI.Gateway落地/app/{**path}透明反向代理,使 PDA 业务请求与热更新检测统一收口于https://api.umiudi.cn,完成与117本地umiappapi(127.0.0.1:1032)的 HTTPS 闭环并上线生产。 - 协助排查解决 PDA 端停服与 7~15 秒卡顿:
117租户库补齐is_deleted、udidata.di_download_devicepackage在线补充idx_di_download_devicepackage_bzcpbs索引,UmiPDA - API增加 Introspect 60 秒缓存、NMPA DI 10 分钟缓存与perf_diag.log毫秒诊断,线上实测质检 412 ms / 追溯 200 ms。
- 在
[feat/glcx2-bzgl-print] 批量连扫装箱改造、TreeView 多选防漏与打印防跳号 (2026-11-17, v1.3.0.0-r6 ~ r8)
- 涉及提交:
e3444aa(v1.3.0.0-r6)、0274fa3(v1.3.0.0-r7)、ed7e578(v1.3.0.0-r8) - 关键变更说明:
v1.3.0.0-r6(Pages/UDI_DY.cs,Pages/DTC_DY.cs):消除从生产单下推初始化打印草稿时提前递增消耗流水号(每次+2/+3)的问题,改为预览态展示、仅在正式保存时严格按事务递增分配一次。v1.3.0.0-r7(Utils/AntdTreeHelper.cs[NEW],Pages/UDI_BZGL.cs,Pages/DTC_BZGL.cs,Pages/UDI_SMGL.cs,Pages/DTC_SMGL.cs):修复 AntdUI TreeView 多选删除跳项漏删、清空/封箱未同步清理Temp/udis缓存的问题,支持高亮行兜底删除并将label_count置顶防遮挡。v1.3.0.0-r8(Forms/UDI_GLCX_Add.cs,Forms/UDI_GLCX_Exchange.cs,Pages/UDI_GLCX2.cs):UDI_GLCX_Add支持大包装一箱多件连续扫码,每枪实时校验与容量累加提示、单事务整批提交;同步加固UDI_GLCX_Exchange弹窗回车焦点与宿主关联。
2026-11-16
[fix/soft-delete-ci-scanner] 企业库软删除统一过滤、混淆/启动防错与串口扫码热重载 (v1.3.0.0 ~ v1.3.0.0-r5)
- 涉及提交:
80f7223(v1.3.0.0)、3588108(v1.3.0.0-r2)、0b3dbca(v1.3.0.0-r3)、dec4b91、248e899(v1.3.0.0-r4)、bf250ee(v1.3.0.0-r5) - 关键变更说明:
- 软删除与销售链路对齐 (
80f7223):统一DbFactory全局软删除QueryFilter,修复XSD追溯、同步与删单状态联动。 - Obfuscar 混淆与 CI 门禁加固 (
3588108,dec4b91):保留 C# 匿名类型防 SqlSugarCreateBuilder运行期报错;增加混淆后自动化冒烟门禁,优化 Gitee Release 大文件分片发布与旧包清理。 - UI 调度安全与启动清理 (
0b3dbca,248e899):引入TourGuideHelper安全调度避免未创建句柄BeginInvoke异常;启动自清理覆盖libs/的历史根目录残留 DLL 修复串口PlatformNotSupportedException。 - 串口扫码器热重载加固 (
bf250ee):保存设置即刻热重载ScannerManager、测试连接防自锁、强拉DTR/RTS并完善分帧缓冲。
- 软删除与销售链路对齐 (
[feat/sms-live] 阿里云短信 (Dysmsapi) 生产安全加固、三网报备跟踪与 117 网关全链路验收闭环 (2026-11-14 ~ 2026-11-16)
- 涉及模块与文件:
- 网关直连与防线:
UmiUDI.Gateway/Infrastructure/SmsGatewayService.cs、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/Endpoints/AuthEndpoints.cs、UmiUDI.Gateway/Program.cs、UmiUDI.Gateway/appsettings.json - 部署与无明文配置:
bin/step4-stage/Deploy-Gateway-Hotpatch-On-117.ps1、bin/step4-stage/Configure-AliyunSms-On-117.ps1[NEW] - 工具链与 Skill:
.agent/skills/alibabacloud-sms-send-short-message/(SKILL.md/references/manifest.jsonv0.0.3)、本机aliyunCLI3.5.3+aliyun-cli-dysmsapi0.9.6
- 网关直连与防线:
- 关键变更说明:
- 生产环境 Fail-Closed 防线加固:在
SmsGatewayService注入IHostEnvironment,限定IsSimulationMode()仅在Development环境生效,非开发环境强制返回false;禁止Production漏配 AK/SK 或配置SmsProvider=mock时静默退回仿真模式向前端明文回显验证码;同步修正IsAliyunSmsConfigured()显式校验SmsAccessKeyId/SmsAccessKeySecret,并在SendAliyunSmsAsync发起外呼前阻断占位符凭证。 - 健康探针与部署拨测可观测性补强:
/api/health(UmiUDI.Gateway/Program.cs)新增输出HasAliyunSmsConfigured、SmsSimulationMode与HasSmtpEmailConfigured非涉密状态位,并在未配齐短信通道时写入Warnings(SmsSimulationModeActive/AliyunSmsNotConfigured);Deploy-Gateway-Hotpatch-On-117.ps1同步输出上述状态组与告警。同时核实Forms/UserRegisterForm.cs与AuthEndpoints.HandleRegisterTrial强绑定手机验证码,网关channel="email"仅覆盖登录与找回密码接口。 - 最小权限 RAM 隔离与安全配置合并:规避
PowerUserAccess过宽授权风险,新建短信专用 RAM 子账号umiudi-sms-gateway(仅授短信权限,生产稳定后可收敛至仅dysms:SendSms);新增Configure-AliyunSms-On-117.ps1,先自动备份生产配置文件,再以Read-Host -AsSecureString掩码注入Gateway.OutboundSecrets,仓库内保持零明文密钥。 - 三网报备排障与两阶段上线(
PORT_NOT_REGISTERED→DELIVERED):2026-11-14:核实企业资质(南通南联软件有限公司)、签名(南通南联软件)与模板(SMS_339850641,变量${code})阿里云侧过审,但实测移动号15794395009报SendStatus: 2 / PORT_NOT_REGISTERED(三网处于REGISTERING/已报备待验证)。先行部署117热更并保持短信参数留空,验证生产防线生效(HasAliyunSmsConfigured=False, SmsSimulationMode=False, HasSmtpEmailConfigured=True),阻断“网关返200但手机收不到”的假成功黑洞。2026-11-14 ~ 11-16:通过aliyun dysmsapi get-sms-sign跟踪三网进度,联通(11-14 19:47)、电信(11-15 08:33)、移动(11-16 10:03)依次进入RegisterStatus: 1 / DETECTING;11-16 20:06移动通道完成实测送达后,在117执行Configure-AliyunSms-On-117.ps1(留存备份appsettings.Production.json.bak_20261116_200813)并重启umiudi-gateway应用池开闸。
- 生产环境 Fail-Closed 防线加固:在
- 验证与线上验收结果:
- 本地编译与测试:
UmiUDI.GatewayDebug与Release编译均0 个警告 / 0 个错误;5 项自动化测试(涵盖Production缺参阻断与禁用mock、Development仿真保留、排除@邮件记录、本地HttpListener签名下发与失败不扣配额/日限熔断)全部PASS。 - 公网与
117生产接口实测:GET https://api.umiudi.cn/api/health与本机http://127.0.0.1:5180/api/health均返回Healthy / Production、hasAliyunSmsConfigured: true、smsSimulationMode: false、hasSmtpEmailConfigured: true、warnings: [];外网未带CaptchaToken调用POST /api/auth/send-code返回400滑块门禁拦截;117本机调用POST /api/auth/send-code返回200(短信验证码已发送,5分钟内有效,请注意查收。),query-send-details核验该笔下发(SendDate: 2026-11-16 20:13:37→ReceiveDate: 2026-11-16 20:13:41,耗时 4 秒)真实送达SendStatus: 3 / DELIVERED。
- 本地编译与测试:
2026-11-14
会话完整决策与排障实录:参见专题归档 DEVLOG_20261113_20261114_fe571233.md(覆盖
2026-11-13 11:05 ~ 2026-11-14 15:59+08:00全 74 轮交互;以下 2026-11-14 全量变更及 2026-11-13 15:00 后视觉升级均为基线提交1105a2d7/v1.3.0.1之上的工作区未提交变更)。
[docs/security] B 端升级弹窗纯业务化与开发日志物理隔离 (2026-11-14 17:01 ~ 17:09)
- 涉及文件:
Resources/ReleaseNotes.md[NEW]、docs/CHANGELOG.md、UmiUDI.csproj、Utils/ChangelogHelper.cs、Mian.cs - 关键变更说明:
- 构建产物物理隔离:新增内嵌纯业务说明资源
Resources/ReleaseNotes.md(LogicalName="UmiUDI.Resources.ReleaseNotes.md");UmiUDI.csproj限制docs/CHANGELOG.md仅在OpsAdminBuild=true时复制至输出目录,B 端客户构建不再下发含开发环境细节的日志原文。 - 按角色分级读取与解析:
ChangelogHelper.GetChangelog/GetReleaseNotesForVersion与ParseChangelog新增includeFullDetails/includeDevSection控制参数;Mian.CheckAndShowUpgradeLog()中普通 B 端客户仅从内嵌纯业务资源读取精简业务变动项(Width = 540),仅当GlobalConfig.IsSuperAdmin()且存在本地CHANGELOG.md时展示含【开发与技术变更详情】的完整版(Width = 680)。 - 业务文案清洗:重写
v1.3.0.1(覆盖在线试用、支付宝续费升级与开票、试用到期只读保护)并同步清理v1.3.0.0中的研发/安全术语,彻底移除“防刷”“滑块”“高分屏/DPI”等开发侧条目。
- 构建产物物理隔离:新增内嵌纯业务说明资源
- 验证结果:
Release与Release -p:OpsAdminBuild=true编译均0 个错误;确认bin\Release\net9.0-windows\docs\CHANGELOG.md为False、bin\Release-Ops\net9.0-windows\docs\CHANGELOG.md为True;反射调用验证 B 端与超管返回文本符合预期。
[feat/billing-guard] 禁止退款策略落地、企微运维二维码全链路覆盖与 20 位 Base32 订单编码重设计 (2026-11-14 13:40 ~ 15:59)
- 涉及模块与核心文件:
- 订单编码与支付网关:
UmiUDI.Gateway/Endpoints/ProxyEndpoints.cs、UmiUDI.Contracts/ProxyContracts.cs、UmiUDI.Gateway/Endpoints/AuthEndpoints.cs、sql/01_schema_migration_phase1.sql - 禁止退款与企微二维码:
UmiUDI.csproj、icons/二维码.png[NEW]、icons/二维码(1).png、Forms/Payment.cs/.Designer.cs、Forms/UserRegisterForm.cs、Pages/Ops_BillingInvoices.cs、UmiUDI.Gateway/Endpoints/OpsAdminEndpoints.cs、UmiUDI.Contracts/OpsAdminContracts.cs
- 订单编码与支付网关:
- 关键变更说明:
- 20 位 Crockford Base32 订单编码:在
ProxyEndpoints.cs实现BillingOrderNoCodec与GenerateUniquePaymentOrderNo([U/T][S/C][N/A/M/Y/P/V][yyMMddHHmmss][3位可逆 cid%32768][2位后缀]),剔除I/L/O/U;独立脚本OrderNoVerify验证通过BIJECTION_OK=32768 SAMPLES_OK=11 CONCURRENT_UNIQUE=32/32。 - 并发 TOCTOU 与超时加固:支付宝下单增加
TimeoutExpress = "15m"与客户端对账reconcile_pay;cer_sms_code校验改为原子抢占used='1'并支持建库异常回滚释放;补齐username/phone/email跨字段碰撞拦截及max_accounts ?? 1。 - 彻底移除所有退款入口并切换企微二维码:按用户拍板物理删除短生命周期实现的运维退款 API(
POST /api/ops/billing/orders/{orderNo}/refund/RefundOpsOrder)、数据库refunded_*列及 OpsAdmin 退款标签/按钮/Excel 列;将 icons/二维码.png 以UmiUDI.Resources.WeComOpsQr.png内嵌客户端;在Payment.cs增加NoRefundConfirmDialog阻断确认、二维码页常驻不可退款警示条、460x496WeComOpsQrDialog,并在UserRegisterForm.cs短信触顶时复用该二维码弹窗替代原硬编码电话展示(注:GatewayOptions.cs#L139仍留有未调用的SalesCustomerServiceContact = "188-0000-0000(微信同号)"默认属性)。
- 20 位 Crockford Base32 订单编码:在
- 验证与部署边界:
- Client (
Release) 与 OpsAdmin (Release -p:BuildOpsAdmin=true) 均通过编译0 个错误;PaymentInspect离屏渲染返回RENDER_CLIENT_VIEWS_OK并截图实检通过;robocopy同步至本机D:\UmiUDI(859文件,退出码3、0失败)。 - 网关补丁已重打包为本地待传制品 UmiUDI-Gateway-Hotpatch.zip(
223,645字节,MD5:9687D1BF63F1D799045F2CD861121A47),尚未上传重启 117 生产 IIS。
- Client (
[feat/billing-ops] 发票两阶段审批、EPPlus 18 列财务导出及 OpsAdmin 本机回环 403 排障 (2026-11-14 12:01 ~ 13:35)
- 涉及模块与核心文件:
- 客户端订单与支付锁:
Forms/OrderHistoryForm.cs[NEW]、Forms/Payment.cs/.Designer.cs、Core/GatewayClient.cs、Core/GlobalConfig.cs - 运维开票台账与后端:
Pages/Ops_BillingInvoices.cs[NEW]、UmiUDI.Gateway/Endpoints/OpsAdminEndpoints.cs、UmiUDI.Gateway/Endpoints/ProxyEndpoints.cs、UmiUDI.Contracts/OpsAdminContracts.cs、UmiUDI.Contracts/ProxyContracts.cs、sql/01_schema_migration_phase1.sql
- 客户端订单与支付锁:
- 关键变更说明:
- 续期并发与越权锁定:支付回调/核销启用事务行锁
SELECT ... FOR UPDATE与previous_expire_time记录;去除“个人”单选与微信图标(强制BuyerType = "enterprise"),自动填充并只读锁定抬头/税号,默认取消勾选开票;禁止tenant_operator子账号跨套餐升级(返回403)。 - 开票审批与 Excel 导出(拒绝自动开票方案):因支付宝当面付无法直开数电票且不希望三方代账处理票据,实现
none / pending_approval / approved / issued / rejected二阶段审批、发票号防重与 SMTP 邮件通知,并在Ops_BillingInvoices.cs提供 EPPlus 18 列财务手工开票导出(发票号/税号/订单号强制@文本格式);EXCEL_VERIFY离线实测rows=6 cols=18 inv=26322000000881239901 fmt=@ amt1=4188。 - OpsAdmin 403 排障:定位服务器运行
Release-Ops/UmiUDI-Ops.dll.config继承公网https://api.umiudi.cn导致请求经网卡117.72.33.1回环撞上OpsAllowedIps = ["127.0.0.1", "::1"]拦截,指导运维端改为http://127.0.0.1:5180后恢复。
- 续期并发与越权锁定:支付回调/核销启用事务行锁
[feat/alipay-live] 支付宝原生支付(QR_CODE_OFFLINE)打通、字体锯齿实验回滚与首次 ¥0.01 实测 (2026-11-14 01:44 ~ 11:58)
- 涉及模块与核心文件:
UmiUDI.Gateway/Endpoints/ProxyEndpoints.cs、UmiUDI.Gateway/Program.cs、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/appsettings.json、Forms/Payment.cs/.Designer.cs、Mian.cs、Pages/Base_Person.cs
- 关键变更说明:
- 原生支付宝接入与测试白名单:拒绝三方聚合方案,对接支付宝订单码
QR_CODE_OFFLINE,配置 Fail-Closed 门控的AlipayTestPriceEnabled+AlipayTestUsernames;修复Payment.Designer.cs隐藏价格标签截断,打通Mian.cs顶部_panelSubscriptionUpgrade与Base_Person.cs入口。 - 实验撤回与异常透传:为
ProxyEndpoints.cs与UmiUDI.Gateway/Program.cs补齐try/catch解决 HTTP500空响应;针对用户反馈试改Program.cs与UmiUDI.csproj(PerMonitorV2+AntiAliasGridFit),未达预期于02:52完整撤回。 - 线上扫码实测与回执优化:连续排查解决
isv.missing-signature-config(公钥证书未加签)与isv.self-invoke-forbidden(AppID 错配三方应用2021006104668489),切换自研应用后完成首次实机扫码¥0.01成单(UMI202611141142140051552,激活标准版至2028-04-24);随后将OnPaymentSuccess由直接关闭窗口改为tabPage3电子回执卡,有效付费租户自动隐藏顶部升级按钮。
- 原生支付宝接入与测试白名单:拒绝三方聚合方案,对接支付宝订单码
[fix/tenant-isolation] 多租户同名隔离、首次注册 near 'NULL' 修复与一企一账原位转正 (2026-11-14 00:13 ~ 01:44)
- 涉及模块与核心文件:
UmiUDI.Gateway/Endpoints/AuthEndpoints.cs、UmiUDI.Gateway/Endpoints/OpsAdminEndpoints.cs、UmiUDI.Gateway/Endpoints/TenantAdminEndpoints.cs、UmiUDI.Gateway/Infrastructure/PlanConversionHelper.cs[NEW]、UmiUDI.Gateway/Infrastructure/TrialTenantLifecycleService.cs、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/Data/CenterDbFactory.cs、Pages/Base_Company.cs、Pages/Base_User.cs、bin/step4-stage/Deploy-Gateway-Hotpatch-On-117.ps1
- 关键变更说明:
- 跨租户账号隔离与建库回滚:移除
username跨企业全局查重,保留超管账户保护与登录/重置密码Take(2)歧义拦截;定位修复首次线上试用注册(南通联迈智能科技有限公司)因OpsAdminEndpoints.cs引用可空dbPassword而非finalDbPassword造成的 SQL 报错near 'NULL' at line 1,并新增RollbackPartialTrialProvision自动回滚孤儿记录。 - 一企一账号与原位转正式版:
TrialMaxAccounts收敛为1并锁定SaveUser及Base_User.cs;通过PlanConversionHelper.cs与/api/ops/tenants/{companyId}/convert-formal(配套Base_Company.cs【转正式】)保留umi_trial_{companyId}直接转正式版(5/5或10/10配额不降配)且保护formal库免遭清理。 - IIS 热更锁优化与自测:
Deploy-Gateway-Hotpatch-On-117.ps1改为app_offline.htm+ AppPool 停止轮询等待句柄释放;本地 SQLite 模拟 + 本地网关 HTTP 冒烟测试GrayVerify先后通过20/20 [PASS]与26/26 [PASS]。
- 跨租户账号隔离与建库回滚:移除
2026-11-13
[ui/captcha-polish] 注册与滑块弹窗 BorderlessForm 视觉重构与 8 主题混淆升级 (2026-11-13 14:24 ~ 16:45)
- 涉及模块与核心文件:
UmiUDI.Gateway/Security/SliderCaptchaService.cs、Forms/SliderCaptchaModal.cs/.Designer.cs、Forms/UserRegisterForm.cs/.Designer.cs、Core/SecurityGuard.cs、Core/GatewayClient.cs(注:其中 DPI 缩放坐标对齐已包含在89a53972,豆腐块字符初版清理与1.3.0.1升级位于1105a2d7,BorderlessForm/ 8 主题 / 3 态 SVG 圆标改造为后续未提交状态)。
- 关键变更与排障记录:
- 117 网关首轮实测与滑块边缘/DPI 修复:用户覆盖 117 网关后实测
/api/health(200)、/api/auth/captcha/slider(200)、快滑拦截 (400) 与/api/auth/send-code(200,仿真验证码318325);扩展PiecePadding = 10px解决64x64拼图直角白边,重写pic_bg.Paint双缓冲消除pic_piece伪透明底框并按scaleX/scaleY对齐 125% DPI;排查并结束占锁旧进程D:\UmiUDI\UmiUDI.exe(PID39404/5444)。 - AntdUI 全面重塑:滑块服务端升级至 8 套程序化生成底图 +
Captchas/扩展;注册与滑块窗体接入AntdUI.BorderlessForm+PageHeader(修复\r\n漏匹配透明底黑块与 560 高度底部裁切),用SvgSuccessCircle/SvgWarnCircle/SvgErrorCircle(IconRatioRight = 1.05f)与TooltipComponent替代受SuffixText抑制的旧校验提示,SVG 替换刷新图标豆腐块。
- 117 网关首轮实测与滑块边缘/DPI 修复:用户覆盖 117 网关后实测
[feat/trial] 用户自助注册、行为滑块防刷与试用租户生命周期闭环落地 (2026-11-13 13:55 ~ 14:35)
- 涉及模块与核心文件:
- 契约与标准校验:
UmiUDI.Contracts/AuthContracts.cs、UmiUDI.Contracts/ChinaCreditCodeValidator.cs[NEW] - 网关安全与生命周期:
UmiUDI.Gateway/Security/SliderCaptchaService.cs[NEW]、UmiUDI.Gateway/Infrastructure/SmsGatewayService.cs[NEW]、UmiUDI.Gateway/Infrastructure/SalesNotificationService.cs[NEW]、UmiUDI.Gateway/Infrastructure/TrialTenantLifecycleService.cs[NEW]、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/Endpoints/AuthEndpoints.cs、UmiUDI.Gateway/Endpoints/OpsAdminEndpoints.cs、UmiUDI.Gateway/Program.cs、UmiUDI.Gateway/UmiUDI.Gateway.csproj - 客户端交互与只读守卫:
Core/GatewayClient.cs、Core/GlobalConfig.cs、Core/ReadOnlyModeGuard.cs[NEW]、Forms/SliderCaptchaModal.cs[NEW]、Forms/SliderCaptchaModal.Designer.cs[NEW]、Forms/UserRegisterForm.cs、Forms/UserRegisterForm.Designer.cs、Login.cs、Mian.cs、Pages/HomePage.cs、UmiUDI.csproj
- 契约与标准校验:
- 新增与优化的代码功能:
- GB 32100-2015 统一社会信用代码硬核校验与漏洞修正 (
ChinaCreditCodeValidator.cs):- 实现国家标准 18 位代码加权模 31-2 严格校验算法,并排除乱填纯数字防刷;
- 修复原正则逻辑漏洞:揪出原
^[0-9A-HJ-NP-RT-UW-YA-Z]{18}$尾部A-Z导致非法字符I, O, S, V, Z被放行的缺陷,纠偏为^[0-9A-HJ-NP-RT-UW-Y]{18}$,14 项格式及真实税号测试 100% 通过。
- 轻量级原生行为滑块拼图防刷服务 (
SliderCaptchaService.cs,SliderCaptchaModal.cs):- 纯 .NET GDI+ 动态生成科技感背景与拼图凹凸耳切片,彻底摆脱第三方 SaaS 付费依赖;
- 引入 PiecePadding 安全内边距与双缓冲重绘,消除控件层叠闪烁与白边硬裁切;
- 毫秒级拖动耗时 (<200ms) 机器判定拦截、位置误差 (>5px) 拦截,签发一次性
CAP_令牌并严格单次消费即焚防重放。
- 试用租户生命周期守护与只读保全模式 (
TrialTenantLifecycleService.cs,ReadOnlyModeGuard.cs):- 网关后台每 6 小时自动巡检:14 天试用期满后自动进入 60 天“只读保全模式”,超过 60 天未转正由后台标记停用并支持超管物理销毁数据库;
- 客户端实现动态只读卫士:试用到期后,自动禁用所有新增、保存、修改、打印、导出与扫码出入库写操作,保留查询浏览与导出功能,并亮起“立即升级转正”引导商业转化。
- 全套自动化测试验收:
- 编写自动化验证套件,31 项测试用例全量通过(PASS: 31, FAIL: 0),网关与客户端双端编译 0 警告 0 错误。
- GB 32100-2015 统一社会信用代码硬核校验与漏洞修正 (
[ops/audit] 60 老主库 3306 端口转发流量审计与生产双轨共存基线确立 (2026-11-13 13:25 ~ 13:55)
- 涉及资产与分析范围:
- 老主库服务器(60)、新主库服务器(117)、Windows
portproxy转发桥
- 老主库服务器(60)、新主库服务器(117)、Windows
- 排查经过与关键技术结论:
- 架构认知对齐与系统双轨运行模型实证:
- 澄清现场认知:客户端并非仅登录注册走 API,而是中心库(
umi_basic_cer)及全部第三方敏感能力(NMPA/DTC/OCR/支付/AI)100% 走 API 网关并零直连中心库; - 110+ 单据页面直连租户分库(117:3306),其连接串由网关认证后动态解密下发至内存。
- 澄清现场认知:客户端并非仅登录注册走 API,而是中心库(
- 60 端口转发桥流量审计与 DNS 反查破案:
- 针对 60 抓取到外部 Established 连接但 117 初始查询为 0 的现场矛盾展开逆向追踪;
- 查明 117 MySQL 未开启
skip_name_resolve,华为云反查 PTR 将 60 IP 解析为ecs-60-204-225-116.compute.hwclouds-dns.com,对齐源端口65402形成完整证据闭环;
- 60 端口转发桥长期保留决策固化:
- 鉴于全网 30 家企业中目前仅演示企业升级到 v1.3.0.0,其余 29 家存量老端(
<= v1.2.1.41)配置文件中依然写死 60 端口连中心库; - 确立 60 端口转发桥作为“隐形防空洞”长期保留运行,严禁盲目退役下线,保障存量老企业生产零中断。
- 鉴于全网 30 家企业中目前仅演示企业升级到 v1.3.0.0,其余 29 家存量老端(
- 架构认知对齐与系统双轨运行模型实证:
[ops/cutover] 生产环境 MySQL 数据库全量迁库(Stage 3B)圆满闭环与全链路终验 (2026-11-12 23:30 ~ 2026-11-13 02:20)
- 涉及资产与部署范围:
- 核心服务器:老主库(60)与目标新服务器(117)
- 自动化工具集:
01_on_117_B1_stop_iis.ps1、02_on_60_B1_freeze_mysql.ps1、03_on_117_B2_B3_migrate_and_switch.ps1、04_on_117_B4_start_iis_and_verify.ps1、05_on_60_B4_disable_mysql_and_portproxy.ps1 - 凭证保险库归档:
UmiUDI_Vault_Server_LAVM-MM2M100Y3X_20261113_014108.umivault(切库后全景)
- 核心割接指标与验证结果(已严格脱敏):
- 老主库安全停写与业务会话排空(B1):
- 在 60 成功下发
SET GLOBAL super_read_only = ON; SET GLOBAL read_only = ON;; - 循环终止活跃连接,实测
active_client_threads = 0,全库写入彻底锁定。
- 在 60 成功下发
- 117 IIS 业务池静默下线(B1):
- 自动化停止
umiudi-gateway、umiapi、umiappapi应用池,杜绝并发竞争。
- 自动化停止
- 自动化全量迁库与多租户权限恢复(B2):
- 从 60 导出 28 个租户/服务账号权限脚本并在 117 完整重放;特别保留 117
root@localhost高强口令供本机 API 专用,同时留存root@%兼容存量过渡链接; - 导出并成功导入 29 个核心业务及中心数据库(38.07 MB 压缩流),彻底排除自动重建的
udidata库; - 幂等复跑 Phase 1 架构升级脚本
01_schema_migration_phase1.sql,表与字段结构对齐; - 完整还原超级管理员
zzx的双因子 TOTP 密钥(mfa_len=32)、93 位安全哈希及全量系统审计日志。
- 从 60 导出 28 个租户/服务账号权限脚本并在 117 完整重放;特别保留 117
- 全量企业连接串就地重写与 IIS 回环切换(B3):
- 批量重写
umi_basic_cer.cer_company的sqlconnection字段,实测统计:total_co=30、left_legacy_ip=0、ok_new_ip=30,全部企业明文连接串精准指向 117; - 递归更新
umiapi与umiappapi全部appsettings*.json,将中心库与租户库连接串统一指向127.0.0.1本机回环,并对齐 12 位高强本地 root 口令。
- 批量重写
- 老主库服务退役与 3306 端口转发桥建立(B4-2):
- 停止并彻底禁用 60 本地 Windows
mysql服务; - 配置 Windows 原生网络端口转发:
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=3306 connectaddress=117.72.33.1 connectport=3306,确保尚未更新配置的存量老端通过 60 仍然能平滑直通 117。
- 停止并彻底禁用 60 本地 Windows
- 117 服务拉起与健康端点终验(B4-1):
- 启动 117 全部应用池;调用
https://api.umiudi.cn/api/health,实测返回 HTTP 200,状态Healthy,14 项内部核心检查(中心库、模板库、Phase 1 架构、公网宿主、JWT 签名密钥、内网自省密钥、旧版解密密钥、超管 MFA 与离线离合器公钥匹配)全部true,warnings: []零报警; - 采集并封存切库后全景离线 AES-256 加密凭证保险库及脱敏体检单。
- 启动 117 全部应用池;调用
- 老主库安全停写与业务会话排空(B1):
[ops/canary] 演示企业(id=22)v1.3.0.0 灰度验证通过与跨代升级策略固化 (2026-11-13 10:50 ~ 11:20)
- 涉及业务与分析范围:
- 演示租户:
id=22(演示账号) - 核心排查:老客户端增量更新弹窗失败根因剖析与企业更新策略治理
- 演示租户:
- 验证成果与跨代升级策略规范:
- v1.3.0.0 客户端端到端功能验证成功:
- 本地通过完整独立安装包
UmiUDI-Setup-1.3.0.0.exe安装最新版客户端; - 成功登录演示企业(id=22),安全网关 JWT 会话颁发、动态租户库多级包装与工单读写、Semantic Kernel + DeepSeek 智能助手全流程实测畅通无阻。
- 本地通过完整独立安装包
- 存量老端(<= v1.2.1.41)增量更新弹窗报错根因彻底闭环:
- 深入排查老端点击更新时弹出
“下载失败 [Resources/AiCopilot/index.html]: 所有更新源均无法获取该文件”故障; - 经比对验证,云端
v13/Resources/AiCopilot/index.html资源真实存在且 MD5 严格匹配;根本原因系老端内置 8 线程并发打满 Gitee 免费 Raw 接口防爬频控导致主源请求超时丢弃,同时老端硬编码回退到无v13/前缀的根目录旧文件触发哈希不匹配,且 Gitee 对超过 1MB 的大二进制文件(如 SDK、算法库)存在强制登录 403 阻断;
- 深入排查老端点击更新时弹出
- 跨代版本升级铁律固化:
- 大版本架构重构统一交付基准:凡包含网关迁移、架构重组或大体积运行时的跨代大版本(1.2.x -> 1.3.0.0),严禁尝试通过 Gitee Raw 微增量通道分发,一律以官方独立安装包(
UmiUDI-Setup-1.3.0.0.exe)为唯一合规交付载体; - 存量老端静默防骚扰策略:在主库
umi_basic_cer.cer_company中,对暂未整体安排升级迁移的老企业,严格将其updatepath保持为空或彻底置空,使其彻底静默不弹任何更新提示,杜绝引起客户现场操作困扰与客诉。
- 大版本架构重构统一交付基准:凡包含网关迁移、架构重组或大体积运行时的跨代大版本(1.2.x -> 1.3.0.0),严禁尝试通过 Gitee Raw 微增量通道分发,一律以官方独立安装包(
- v1.3.0.0 客户端端到端功能验证成功:
[ci] GitHub Actions 发布流水线超时调整 (2026-11-13 11:25)
- 涉及文件:
.github/workflows/release.yml - 变更说明:将 Build and Release 任务超时上限从 20 分钟提升至 45 分钟(
timeout-minutes: 45),保障自托管 Runner 在执行大型多目标编译、代码混淆、安装包压缩制作及多镜像仓库推送时的充裕稳定耗时。
2026-11-12
[ops/verify] OutboundSecrets 落盘验收、现网站点拓扑侦察与切库防坑修正 (2026-11-12 10:32 ~ 11:22)
- 涉及文件与调整范围:
docs/DEVLOG.md(补充上午目标机收尾实测与切库门禁纠偏;仅与sql/01_schema_migration_phase1.sql精准提交,12 项未追踪文档/SOP 不入库)
- 实测排查与门禁修正要点(已脱敏):
- 目标机账户与
zzx哈希终验:核实目标机umi_basic_cer.cer_user中zzx的password_hash(hash_len=93)、mfa_enabled=1、mfa_secret(secret_len=32)全部就绪;确认目标机MySQL80已启用mysql_native_password插件,但当前mysql.user仅含root@localhost与umi_gateway_svc——明确切库夜须单独用SHOW CREATE USER/SHOW GRANTS迁移原主库 27 个租户 MySQL 账号及权限。 - 既有 IIS 站点拓扑与漏库预警:递归排查
SiteId=2 (umiapi :1031)与SiteId=3 (umiappapi :1032)的appsettings.json/appsettings.Development.json确认均直连原主库(实证目标机确系零污染沙盒),且umiappapi额外依赖udidata库;明确切库夜停写原主库时须同步将udidata纳入全量迁移,并把两站点连接串改指127.0.0.1(切库前保持原样不动)。 - 临时包清理与
win-acme计划任务实测:清理目标机桌面遗留的umi_basic_cer.sql敏感快照与废弃nginx-1.26.3.zip(保留其他既有项目及下载文件);手工唤醒win-acme renew计划任务实测返回LastTaskResult=0,日志确认api.umiudi.cn与umiudi.cn状态健康(Exiting with status code 0)。 OutboundSecrets原地补齐与 163 SMTP 端口实测纠偏:公网握手探测实证网易 163 未开放587STARTTLS,而25端口支持STARTTLS且目标机出站25TCP 放行;原地将 DeepSeekDefaultLlmApiKey与smtp.163.com:25专用授权码写入目标机appsettings.Production.json(已备份原件至站点外隔离目录)并重启umiudi-gateway应用池使单例IOptions<GatewayOptions>生效,实测/api/health返回Healthy、/api/auth/send-code验证码邮件真实送达、UmiUDI-Ops.exe企业管理列表加载与 AI 设置连通测试全通。- 切库夜
cer_company.sqlconnection共存底线纠偏:对照416111e:Login.cs(L984)确认存量老端无连接串解密逻辑,修正切库夜操作规程为仅批量替换原主库 IP 为目标机 IP 并保持明文以兼容v1.2.1.41老端(严禁在 Stage C 全员升完前批量加密)。
- 目标机账户与
[ops/deploy] Phase 1 生产库预检、迁移脚本汉化、新服务器 IIS 网关与 win-acme 永久 HTTPS 落地 (2026-11-11 21:15 ~ 2026-11-12 03:15)
- 涉及文件与阶段产物:
sql/01_schema_migration_phase1.sql(表级与列级COMMENT全量中文化;暂留工作区未提交)docs/DEVLOG.md(补充本次跨夜部署运维完整日志;暂留工作区未提交)- 关联基线/排障参照文件(仅只读排查未改动):
sql/02_privilege_shrink_legacy_compat.sql、UmiUDI.Gateway/Program.cs、UmiUDI.Gateway/Endpoints/AuthEndpoints.cs、UmiUDI.Gateway/Endpoints/ProxyEndpoints.cs、UmiUDI.Gateway/Endpoints/OpsAdminEndpoints.cs、UmiUDI.Gateway/Security/PasswordHasher.cs、UmiUDI.Gateway/Security/LegacyCryptoCompat.cs、UmiUDI.Gateway/Infrastructure/GatewayOptions.cs、UmiUDI.Gateway/Deploy/nginx-api.umiudi.cn.conf、Core/GatewayClient.cs、Core/OfflineLicenseVerifier.cs、Core/CheckTable.cs、Login.cs、App.config - 本地隔离构建产物(均受
.gitignore拦截,绝不入库):UmiUDI.Gateway/Config/offline-signing.pkcs8、bin/step4-stage/UmiUDI-Gateway-stage.zip、bin/step4-stage/UmiUDI-Ops-stage.zip、bin/step4-stage/win-acme.v2.4.1.2444.x64.pluggable.zip
- 完整执行工作与关键排障细节(说明:本文档已严格脱敏,不含任何真实密码、私钥、TOTP 密钥、公网 IP、个人邮箱、ACME 账户 ID 或完整本地个人目录):
- Step 0 原生产主库预检与脏数据治理(
11-11 21:15 ~ 21:35):- 在现网主库执行 11 项只读 SQL 预检,实证:
cer_user中超管zzx仅唯一 1 条(id=1,company_id=1,active=1);mysql.user为root@%与 27 个分库租户账号(全部mysql_native_password),与共存方案“绝不触碰root”吻合;同名公司与同企业重名/重号/尾空格脏数据均为 0;cer_company.sqlconnection最大 105 字符、sql_safe_updates=0;全库仅id=1与id=22(演示账号)配有旧根目录updatepath,其余全空,v13/放量隔离边界清晰;服务器数据库时钟与本地误差在数秒内,满足 TOTP ±30 秒容差; - 揪出并治理重号风险:预检第 3 项检出
cer_company.TYSHXYDM存在 2 组重复信用代码(涉及 5 条测试/试用/过期/企业记录);因AuthEndpoints.HandleLogin按信用代码.First()精确命中企业,不清理将导致后续企业升级后登录串库;现场手动清重并复检确认归零; - 备份策略纠偏:识别早期 Navicat 专有
.nb3备份存在“无法由mysqlCLI 直接恢复”且早于手动清重的顺序倒挂隐患,明确补充导出纯文本.sql基线备份。
- 在现网主库执行 11 项只读 SQL 预检,实证:
- 迁移脚本中文注释化与原主库 Step 1~3 落库(
11-11 21:36 ~ 22:07):- 修订
sql/01_schema_migration_phase1.sql:将全部表级与列级COMMENT统一改为中文并补齐缺失字段注释,自动化校验剥离COMMENT=后表结构 DDL 与基线 100% 等价,维持 UTF-8 无 BOM + CRLF; - 在现网主库
umi_basic_cer执行 Step 1:新建 7 张安全/计费/AI配额与验证码支撑表(同既有的cer_company_device33 行与sys_ai_question_feedback16 行共 9 张表全部完好零损),扩展cer_user的 4 个安全列(password_hash/mfa_secret/mfa_enabled/password_updated_at),并将cer_company.sqlconnection与cer_regcode.Regcode扩宽至TEXT;通过SHOW FULL COLUMNS复检确认用到DELIMITER $$临时存储过程的两段 DDL 全部生效且中文注释无乱码; - 执行 Step 2:依据
sql/02_privilege_shrink_legacy_compat.sql创建回环专用账号umi_gateway_svc(32 位强密码),严格不触碰root及老端授权; - 执行 Step 3:本机 CSPRNG 生成 20 字节 Base32
mfa_secret写入zzx(secret_len=32、mfa_enabled=1),使用手机 Google Authenticator 完成动态口令绑定(剔除冗余第三方密码管理器依赖)。
- 修订
- 域名 DNS、TLS 证书与目标迁移机架构侦察转向 IIS 原生部署(
11-11 22:34 ~ 11-12 00:26):- 依据
App.config与GatewayClient.cs强制公网https://api.umiudi.cn严格证书链校验(拒绝自签及PartialChain),核实公网 DNS 原无api.umiudi.cn、umiudi.cn、www.umiudi.cn的A记录,在京东云解析新增api的A记录指向迁移目标机; - 完成京东云 TrustAsia 免费单域名 DV SSL 证书申请与
_dnsauth.apiTXT DNS 校验(规避证书名禁含.规则),下载含 3 段完整链的 Nginx 证书与 IIS.pfx; - 推翻 Nginx 方案改走 IIS 原生路线:尝试启动 Nginx 时触发
bind() 0.0.0.0:80 failed (10013)冲突,经Get-NetTCPConnection与Get-Website侦察确认目标迁移机并非裸机,而是 IIS (W3SVC) 已运行 4 个现网站点(SiteId=1 umiudi :1030、SiteId=2 umiapi :1031、SiteId=3 umiappapi :1032、SiteId=4 umiweb *:80且正有入站流量)及MySQL80;决定**放弃 Nginx,改走路线 A(IIS 原生托管UmiUDI.Gateway)**对现有 4 站零干扰,在目标机安装.NET 9.0 Hosting Bundle (9.0.23)/AspNetCoreModuleV2; - 双库快照裁决与两阶段割接路线:排查目标机
MySQL80发现已存在上周全量同步快照(含umi_basic、umi_basic_cer及 28 个租户库),确认现网本周仍在唯一读写原主库(无双写裂脑)后,拍板**“目标机网关先行单机回环连本机快照沙盒跑通 Step 4 验收,现网保持原主库运行,待正式夜间停写维护窗口再全量覆写迁移、批改cer_company.sqlconnection并配合旧机 3306 转发过渡存量老端”**。
- 依据
- 本地隔离分发包构建与目标机网关上线排障全绿
Healthy(11-12 00:26 ~ 01:13):- 通过 Python
cryptography与本地 Kestrel 生产态启动交叉验证,实证UmiUDI.Gateway/Config/offline-signing.pkcs8与客户端OfflineLicenseVerifier内置 SPKI 公钥 100% 匹配(offlineLicenseReady=true); - 不修改源码打包发布两份 Staging 包至
.gitignore隔离目录:UmiUDI-Gateway-stage.zip(约 17.7 MB,内含ASPNETCORE_ENVIRONMENT=Production与关闭动态压缩防 AI SSE 缓冲的web.config、随机 64 位 JWTSigningKey、48 位InternalIntrospectSecret、TenantPublicDbHost及兼容解密密钥与.pkcs8)与UmiUDI-Ops-stage.zip(约 157 MB,基于/p:OpsAdminBuild=true构建并附带 CameraWorker/Halcon 依赖,UmiUDI-Ops.dll.config配置GatewayBaseUrl=http://127.0.0.1:5180); - 现场逐项排除 5 个 IIS 生产落地问题:
- 杜绝聊天输出明文密码:在目标机通过 PowerShell CSPRNG 原地生成 24 位纯字母数字强密码写入
appsettings.Production.json,并排查补建之前未落库的本地umi_gateway_svcMySQL 账号; - 补建因
Compress-Archive忽略空目录导致的缺失logs\目录; - 用
icacls为IIS AppPool\umiudi-gateway赋予站点及Config目录RX权限,并开启应用池processModel.loadUserProfile = $true,彻底解决OfflineLicensePrivateKeyMissing; - 重新以
-Exportable导入 TrustAsia.pfx证书(缩略指纹A495...7823,消除 Schannel0x80070520私钥访问错误),建站SiteId=5 (umiudi-gateway)绑定http://127.0.0.1:5180与https://*:443:api.umiudi.cn (SslFlags=1 SNI),应用池设为无托管代码、AlwaysRunning与idleTimeout=0; - 从原主库同步最新
umi_basic_cer导入目标机(排查早先导库未入库导致的Unknown column mfa_enabled与Degraded),外网直连https://api.umiudi.cn/api/health实测返回HTTP 200、"status": "Healthy"(14/14 检查全绿、warnings: [])。
- 杜绝聊天输出明文密码:在目标机通过 PowerShell CSPRNG 原地生成 24 位纯字母数字强密码写入
- 通过 Python
UmiUDI-Ops.exe超管双因素与 Fail-Closed 审计验收(11-12 01:16 ~ 01:38):- 审计
AuthEndpoints.cs、PasswordHasher.cs、Login.cs与CheckTable.cs澄清zzx登录口令沿用原库同步的cer_user.password(并非部署期新建),同时明确Login.cs云端模式要求非空企业名输入规则; - 在目标机完成
UmiUDI-Ops.exe登录验收;查询umi_basic_cer.sys_ops_audit_log实证记录OPS_SUPERADMIN_LOGIN(127.0.0.1 SUCCESS)与MFA_FAILED(127.0.0.1 DENIED)审计条目(证明 TOTP 失败拦截 fail-closed 生效);登记待补验小项:zzx.password_hashhash_len > 0核对及运维端企业管理列表加载确认。
- 审计
win-acme (v2.4.1.2444)永久 HTTPS 自动续签部署(网关 + 官网双域名闭环,11-12 01:40 ~ 03:09):- 本地预先下载拆解官方
win-acme.v2.4.1.2444.x64.pluggable.zip,实测识别其默认DefaultBaseUri指向 ZeroSSL(需 EAB)的陷阱,锁定显式参数--baseuri "https://acme-v02.api.letsencrypt.org/"、--csr rsa(RSA-3072 兼顾第三方回调兼容性)、--validation selfhosting(HTTP.sys 内核旁路接管/.well-known/acme-challenge/校验,免停umiweb且避免filesystem模式被官网站点吞没)、--installation iis与预建SslFlags=1SNI 绑定策略; - 排查 Windows 控制台 QuickEdit 误选中导致
wacs.exe卡停在Manual input的阻塞;为SiteId=5 (umiudi-gateway)签发api.umiudi.cn(Let's EncryptYR1,缩略指纹D3F3...A8A0,下次续签2027/1/5,保留原 TrustAsia 作备胎),注册 ACME 账户<ACME_ACCOUNT_ID>(通知邮箱<OPS_ADMIN_EMAIL>)与每日09:00(+4h 随机延迟)计划任务win-acme renew; - 排查 Edge 访问宣传页
umiudi.cn报“此网站不支持安全连接”问题,公网实测确认www.umiudi.cn暂无 DNS 记录且umiweb (SiteId=4)仅绑定http *:80:缺:443;按“双协议并存、暂不 301 强跳、严格SslFlags=1SNI 防抢占”原则预建https *:443:umiudi.cn并通过win-acme签发umiudi.cn(Let's EncryptYR2,缩略指纹360D...14DD),与api.umiudi.cn共管自动续签;外网严格校验证书链双域名均返回HTTP 200(官网 HTML 含 0 处硬编码http://混合内容)。
- 本地预先下载拆解官方
OutboundSecrets现状盘点、Git 资产安全审计与切库前置门禁梳理(11-12 03:09 ~ 03:15):- 核查目标机
umi_basic_cer.sys_ai_config为 0 行空表,并核对ProxyEndpoints.cs、GatewayOptions.cs、LegacyCryptoCompat.cs与AuthEndpoints.HandleSendVerificationCode:确认 NMPA / 码上放心 DTC 依赖库内租户字段已随库就绪;DeepSeek (DefaultLlmApiKey)、SMTP 邮箱(实锤.NET System.Net.Mail.SmtpClient开启EnableSsl=true仅支持显式 STARTTLS——如 QQ/企业邮587或网易163的25端口,禁用 465 隐式 SSL;详见上方10:32 ~ 11:22实测纠偏)、百度 OCR 与支付宝当面付留空待下轮原地写入appsettings.Production.json; - 完成仓库资产安全审计:确认仅
sql/01_schema_migration_phase1.sql与本日志为工作区已追踪修改(12 项未追踪文档/SOP 不纳入),416111e..HEAD6 个本地提交零密钥/私钥泄露(.pkcs8、appsettings.Production.json、bin/step4-stage/严格处于.gitignore);依收尾决策暂不执行commit/push/ 打v1.3.0.0Tag; - 明确下阶段遗留待办与防坑红线:(a) 原地补齐目标机
appsettings.Production.jsonOutboundSecrets(DeepSeek + 显式 STARTTLS SMTP 等;已于10:32 ~ 11:27按smtp.163.com:25落盘并实测送达);(b) 清理目标机 IIS 目录下残留临时.sql/.zip中转包(已完成)并离线异地备份.pkcs8私钥;(c) 择停机维护夜从原主库全量迁库覆盖目标机时,务必保留目标机zzx的mfa_enabled/mfa_secret/升级后password_hash(并已核实两库zzx原口令与 MFA 指纹一致)、避免依赖易被覆写的sys_ai_config库行,并按上方[ops/verify]第 5 条纠偏规则保持cer_company.sqlconnection明文仅替 IP 指向新库,随后按精准提交顺序推进v1.3.0.0(8b8865d) 与v13/灰度切流。
- 核查目标机
- Step 0 原生产主库预检与脏数据治理(
2026-11-11
[ops/compat] umi_basic_cer 共存授权脚本对齐、配置模板修正与 v13/ 分批放量通道隔离
- 涉及文件:
sql/02_privilege_shrink_legacy_compat.sql(新建)UmiUDI.Gateway/appsettings.json.github/workflows/release.ymldocs/DEVLOG.md
- 新增与调整原因:
- 对照
416111e:App.config与Pages/Base_Config.cs实锤:存量老版本(<= v1.2.1.41)的OnlineCerConnection均以root直连中心库umi_basic_cer,且继续直接读写cer_user/cer_permission/cer_department/cer_customer/cer_company/cer_regcode/cer_sms_code/sys_ai_*。因此重写sql/02_privilege_shrink_legacy_compat.sql:明确只新建本机回环专用的'umi_gateway_svc'并授予umi_basic_cer、umi_basic与一键建库权限,在老端全部迁移前绝不触碰root,去掉原假想<LEGACY_CER_USER>与 Part 2REVOKE分支,并将v13/灰度切流及全员迁完后收紧root的巡检 SQL 收录为注释参考。 - 同步将
UmiUDI.Gateway/appsettings.json的CenterConnectionString模板库名从umi_cer对齐为生产实际库名umi_basic_cer(其余OutboundSecrets留空不影响/api/health就绪判定)。 - 更新
.github/workflows/release.yml:版本号>= 1.3.0.0时自动将增量更新清单及客户端分发目录隔离发布至UmiUDI-Update的v13/子目录(raw/master/v13/update.json),彻底保护根目录既有的v1.2.1.41update.json与文件不被覆盖;经git diff 416111e HEAD全量比对确认,DI 库、生产单、打印单与仓库库存全部生产数据模型及 SQL 逻辑均保持向后兼容,云端老客户可按企业updatepath安全可控升级。
- 对照
[fix/gateway] NMPA 令牌缓存并发防击穿加固 & 飞检 1.2/6.1 非 PII 聚合查询修复 (v1.3.0.0 补丁)
- 涉及文件:
UmiUDI.Gateway/Endpoints/ProxyEndpoints.csCore/YaoJianJu.csUmiUDI.Contracts/TenantAdminContracts.csUmiUDI.Gateway/Endpoints/TenantAdminEndpoints.csCore/GatewayClient.csPages/FlyInspection.csdocs/DEVLOG.md
- 新增与优化的代码功能:
- 药监局 NMPA 令牌复用缓存、凭证指纹隔离与并发防击穿 (
ProxyEndpoints.cs,YaoJianJu.cs):- 将
ProxyEndpoints.GetNmpaAccessToken改为支持可选参数bool? forceRefresh(默认false),与ForwardNmpaRequest共享网关按companyId隔离的内存缓存NmpaTokenCache,彻底消除每次调用YaoJianJu.getToken()强刷 NMPA/token/get的限流风控隐患,同时保留?forceRefresh=true显式强刷能力; - 在
CachedTokenEntry增加基于AppId/AppSecret/TYSHXYDM/NmpaBaseUrl的 SHA-256CredFingerprint(ComputeNmpaCredFingerprint),企业修改药监局凭证后旧缓存自动失效; - 引入按租户隔离的并发互斥锁
NmpaTokenLocks(ConcurrentDictionary<int, SemaphoreSlim>)及failedToken协同去重(释放 DB 上下文后再发起 HTTP 请求),防止多工位并发遇到令牌过期时惊群击穿/token/get; - 新增
IsNmpaTokenExpiredResponse精准解析returnCode != 1且returnMsg含token/令牌(或 HTTP 非 2xx)后触发带failedToken的自动重试; - 移除
YaoJianJu.getToken()云端分支向客户端本地App.config明文回写URLAccessToken/URLCurrentTime/LastUsedAppId的冗余落盘行为(离线分支保持不变)。
- 将
- 飞检 1.2 与 6.1 组织及权限隔离开销统计接口修复误报 (
TenantAdminContracts.cs,TenantAdminEndpoints.cs,GatewayClient.cs,FlyInspection.cs):- 保持
TenantAdminEndpoints.GetTenantUsers对非“用户管理”权限账号仅返回本人信息的最小权限隐私保护不变; - 新增非 PII 聚合契约
FlyInspectionOrgSummaryDto与网关端点GET /api/tenant/fly-inspection/org-summary(TenantAdminEndpoints.GetFlyInspectionOrgSummary),仅统计当前租户部门数(DepartmentCount)、活跃账号数(UserCount,排除active == "0")与具备有效启用菜单权限的活跃账号数(AuthorizedUserCount),零同事姓名/手机号/账户明细泄漏; - 新增客户端封装
GatewayClient.GetFlyInspectionOrgSummary,将Pages/FlyInspection.cs的case "1.2"与case "6.1"在云端模式下切换至该聚合端点,网关调用异常时标为Warning并附带诊断信息,消除一线无管理权限账号自检时6.1恒报“高风险!系统仅存在单一主账号”及1.2漏检仅看个人数据的误报问题。
- 保持
- 药监局 NMPA 令牌复用缓存、凭证指纹隔离与并发防击穿 (
[feat/security] Phase 1 云端 API 安全网关架构迁移与全链路安全加固 A1~A4 (v1.3.0.0)
- 涉及模块与核心文件:
- 共享契约与后端网关:
UmiUDI.Contracts/*[NEW]、UmiUDI.Gateway/*[NEW]、sql/01_schema_migration_phase1.sql、sql/02_privilege_shrink_buffer.sql、sql/03_post_buffer_cleanup.sql[NEW] - 客户端安全底座与高敏代理收口:
Core/GatewayClient.cs[NEW]、Core/OfflineLicenseVerifier.cs[NEW]、Core/DataHelper.cs、Core/SecurityGuard.cs、Core/GlobalConfig.cs、Core/ConfigManager.cs、Core/RegisterHelper.cs、Core/PaymentConfig.cs、Core/YaoJianJu.cs、Core/Alibaba/TopClient.cs、Core/Jindie.cs、Core/AiAgent/*、Services/DtcApiService.cs、Forms/Payment.cs、Forms/RegForm.cs、Forms/UserRegisterForm.cs、Forms/EnvironmentCheck.cs、Login.cs、Mian.cs、App.config - 租户管理与全量页面连接串内存化:
Pages/Base_Company.cs、Pages/Base_Config.cs、Pages/Base_Customer.cs、Pages/Base_Department.cs、Pages/Base_Person.cs、Pages/Base_Register.cs、Pages/Base_User.cs、Forms/Auth_Select.cs、Pages/DTC_Config.cs及全量Pages/*.cs、Forms/*.cs、Services/*.cs、Utils/*.cs - 双端隔离构建、代码混淆与版本统一:
.github/workflows/release.yml、UmiUDI.csproj、Scripts/Invoke-Obfuscation.ps1[NEW]、.gitignore、Properties/AssemblyInfo.cs、UmiUDI.iss、docs/CHANGELOG.md、docs/DEVLOG.md
- 共享契约与后端网关:
- 新增与优化的代码功能:
- 云端 API 安全网关与中心库零直连迁移 (
UmiUDI.Gateway,UmiUDI.Contracts,Core/GatewayClient.cs):- 新增 ASP.NET Core
UmiUDI.Gateway独立网关服务,统一承载登录、Token 刷新/内省、心跳、租户管理、平台运维管理、支付宝、百度 OCR、药监局 NMPA、码上放心 DTC 与 DeepSeek AI 代理出站; - 客户端
App.config清空OnlineCerConnection、CompanyConnectionString等高敏直连串,默认指向https://api.umiudi.cn,登录后由网关下发RuntimeTenantConnectionString注入DataHelper内存态,并全量替换 110+ 个页面/表单对ConfigurationManager.AppSettings["CompanyConnectionString"]的直接读取为DataHelper.GetCompanyConn()。
- 新增 ASP.NET Core
- A1~A4 全链路安全加固 (
AuthEndpoints.cs,GatewayAuthMiddleware.cs,TotpService.cs,MfaChallengeGuard.cs,OfflineLicenseIssuer.cs,Core/OfflineLicenseVerifier.cs,Program.cs):- A1 密码哈希与缓冲期双轨迁移:引入 PBKDF2-SHA256 (
PasswordHasher),支持存量明文首次登录静默升级,缓冲期可通过DualWritePlaintextPasswordInBuffer控制兼容旧端,Day 14 执行03_post_buffer_cleanup.sql清理; - A2 超管 TOTP MFA 严格 Fail-Closed 与防暴力破解:强制超管
zzx仅允许从OPS_ADMIN客户端且在OpsAllowedIps(支持真 IPv4/IPv6 CIDR 掩码)白名单内登录,未配置有效mfa_secret直接拦截返回 403,封堵免密短信/邮箱登录,结合MfaChallengeGuard防重放与 5 次锁定; - A3 ECDSA P-256 离线硬件授权与 DPAPI 单调高水位时钟:全新生成生产 ECDSA P-256 密钥对(私钥
.pkcs8严格纳入.gitignore不入库),客户端内置 SPKI 公钥与单调时钟高水位防回拨校验; - A4 健康检查与防降级校验:
/api/health实连中心库与模板库、检查占位符、Phase 1 迁移结构、zzxMFA 配置、IP 白名单、密钥一致性及网关版本;AuthEndpoints.HandleSendVerificationCode封堵非 Email 假成功通道。
- A1 密码哈希与缓冲期双轨迁移:引入 PBKDF2-SHA256 (
- CI/CD 双端物理隔离与版本统一至
1.3.0.0(.github/workflows/release.yml,UmiUDI.csproj,Scripts/Invoke-Obfuscation.ps1):- 同一套源码按
OpsAdminBuild=false/true编译产出公开客户端UmiUDI.exe与内部超管运维端UmiUDI-Ops.exe,引入Obfuscar混淆并在流水线强制校验公开仓库隐私与防泄露断言,严禁Ops/*.pkcs8/appsettings.Production.*混入公开更新源; - 同步统一
Properties/AssemblyInfo.cs、UmiUDI.iss、UmiUDI.Gateway.csproj、UmiUDI.Contracts.csproj版本号至1.3.0.0,网关MinRequiredClientVersion模板维持1.0.0.0以保障 7~14 天平滑缓冲期过渡。
- 同一套源码按
- 云端 API 安全网关与中心库零直连迁移 (
2026-11-10
[feat/fix/pc] 多租户企业消歧登录、公司所属行业硬隔离与超级管理员双行业切换 (v1.2.1.41)
- 涉及文件:
Properties/AssemblyInfo.csUmiUDI.issApp.configCore/IndustryHelper.cs[NEW]Core/GlobalConfig.csCore/SecurityGuard.csCore/YaoJianJu.csCore/AiAgent/AiKernelManager.csCore/AiAgent/Knowledge/KnowledgeBaseEngine.csCore/AiAgent/Plugins/ComplianceInspectionPlugin.csCore/AiAgent/Plugins/MedicalDeviceExpertPlugin.csCore/AiAgent/Security/AiPermissionService.csCore/AiAgent/Security/AiSecurityInvocationFilter.csModels/cer_company.csModels/umi_basic_cerContext.csLogin.Designer.csLogin.csMian.Designer.csMian.csForms/Auth_Select.Designer.csForms/Auth_Select.csForms/AiCopilotControl.csForms/DataBase.csForms/UserRegisterForm.csPages/Base_Company.Designer.csPages/Base_Company.csPages/Base_Config.csPages/Base_Customer.csPages/Base_Department.csPages/Base_Register.csPages/Base_User.csPages/DTC_Config.csPages/DTC_XSD.csPages/HomePage.csPages/UDI_XSD.csResources/AiCopilot/index.htmldocs/CHANGELOG.mddocs/DEVLOG.md
- 新增与优化的代码功能:
- 多企业账号精准消歧登录与本地 3 家历史记忆 (
Login.Designer.cs,Login.cs,App.config):- 调整登录面板排序,将
input_company置于第 1 行并改名为“公司名称 / 统一信用代码”,通过EnsureLoginWindowVerticalSpacing()按 DPI 自适应增加窗体底部留白,解决底部按钮贴边拥挤问题; - 引入
CompanyHistoryStore与%LocalAppData%\UmiUDI\company_history.json,实现本地与云端账套共用的 FIFO 3 家企业历史记录循环覆盖(MaxCount = 3、CloseIcon = true、ClosedItem下拉删除并同步清理App.config残留); - 账套切换采用
LocalCompany/LocalUsername/LocalPassword与OnlineCompany/OnlineUsername/OnlinePassword分键值隔离持久化; - 登录解析
ResolveTargetCompany支持公司名称或TYSHXYDM精准匹配;当同一公司下存在多条重名cer_user记录时,弹出ShowDuplicateUserPickerModal展示使用人姓名、部门名称与账号 ID 供操作员明确选择,从根源消除跨企业或同企业同名账号误登问题;并修复明暗码眼睛状态切换图标; - 在
UserRegisterForm.cs禁止自助注册直接挂靠既有企业,仅允许开通新企业(默认industry = 0医疗器械),防止恶意抢注与账号配额侵占。
- 调整登录面板排序,将
- 企业所属行业字段与旧版客户端零侵入平滑兼容 (
Core/IndustryHelper.cs,Models/cer_company.cs,Models/umi_basic_cerContext.cs,Pages/Base_Company.cs,Pages/Base_Config.cs):- 新建
IndustryHelper.cs定义IndustryDevice (0 = 医疗器械)与IndustryDrug (1 = 医药);EnsureCompanyIndustryColumn通过INFORMATION_SCHEMA安全探测表与列存在性后自动执行ALTER TABLE cer_company ADD COLUMN industry TINYINT(1) NOT NULL DEFAULT 0,若无 DDL 权限则自动切换至无列降级兼容模式,全库历史未配置企业一律默认为0(医疗器械); - 将
cer_company.industry标记[SugarColumn(IsIgnore = true)],读写由IndustryHelper独立 SQL 接管,并在SecurityGuard.cs、YaoJianJu.cs、DataBase.cs、Base_Register.cs、DTC_Config.cs访问cer_company前确保列探测就绪,彻底保障未升级旧版本客户端(<= v1.2.1.40)共享同一认证库时不崩溃、零感知运行; - 公司管理
Base_Company.cs/Base_Company.Designer.cs新增“所属行业”表格列及筛选维度,弹窗置顶展示所属行业选择框,新建/复制强制必选(工具栏新增“复制”),编辑当前登录企业变更行业后明确提示重登生效,并新增同名/同统一信用代码防重校验。
- 新建
- 企业行业全链路硬隔离与 AI Copilot 协同 (
Mian.cs,Pages/HomePage.cs,Core/AiAgent/*,Forms/AiCopilotControl.cs,Resources/AiCopilot/index.html,Pages/Base_Config.cs):- 菜单与功能隔离:
Mian.cs在一级/二三级加载及IsMenuAllowedForCurrentIndustry、segmented1_ItemClick、btn_fly_inspect_Click、HasPermission中按企业所属行业强制隔离跨行业菜单,防止医疗器械与医药模块交叉越权进入;Base_Config.cs同步在权限树加载与本地库初始化迁移中按目标企业所属行业过滤菜单与权限记录; - AI 助手行业隔离:
AiPermissionService增加(CompanyId, Industry, UserId)缓存与IsQueryForbiddenDynamic前置拦截;AiKernelManager按BoundIndustry动态注入医药/器械系统提示词并同步刷新会话状态;KnowledgeBaseEngine为知识切片赋予ExclusiveIndustry并补全医药 GSP/20 位追溯码内置切片;ComplianceInspectionPlugin/MedicalDeviceExpertPlugin/AiCopilotControl/index.html实现快捷指令、欢迎语、知识卡片与插件工具随行业隔离联动。
- 菜单与功能隔离:
- 授权窗口正名、历史跨行业权限保护与仅平台超级管理员
zzx双行业切换 (Forms/Auth_Select.Designer.cs,Forms/Auth_Select.cs,Pages/Base_User.cs,Core/GlobalConfig.cs,Login.cs,Mian.Designer.cs,Mian.cs,Pages/HomePage.cs):- 将
Forms/Auth_Select.Designer.cs(pageHeader.Text、Text)与Pages/Base_User.cs弹窗标题统一修正为“账号授权”; Pages/Base_User.cs支持编辑模式下修改用户密码、增加小眼睛明密文切换,并将跨企业查询/增删改统一收敛至GlobalConfig.IsSuperAdmin()鉴权;Core/GlobalConfig.cs新增IsSuperAdminUser(int userId, int companyId, string? userName)(严格限定userId == 1或companyId == 1 && username == "zzx"),同步替换Base_Customer.cs、Base_Department.cs、Base_User.cs、DTC_XSD.cs、UDI_XSD.cs中原仅比对UserName == "zzx"的逻辑,堵住跨租户同名提权漏洞;Login.cs保留登录页行业下拉框,仅放行平台超级管理员自由选行业,其他所有账号若所选行业与所属企业配置不一致则弹窗拦截、自动切回企业授权行业并要求二次确认点击登录;Mian.Designer.cs&Mian.cs在顶部标题栏右侧新增panel_super_industry/segmented_super_industry(医疗器械 | 医药)分段切换器(仅GlobalConfig.IsSuperAdmin()可见);setMenuLevel1()在超管模式下直接加载全量启用cer_menu(绕过个人cer_permission缺失限制)并带_menuLevel23Seq异步防串台守卫;切换行业支持确认关停非首页 Tab 并清理控件及扫码串口、更新App.config与术语标题、并联动调用HomePage.ReloadForIndustry()与AiCopilotControl.RefreshForIndustryChange();Auth_Select.cs对普通企业仅展示所属行业菜单树,并在保存时完整留存_preservedCrossIndustryMenuIds历史跨行业权限(附带友好提示),保证未升级老客户不丢权;对zzx超级管理员显示“(超级管理员·全行业)”全量树且不误弹窗提示。
- 将
- 发布版本号与安装包脚本同步 (
Properties/AssemblyInfo.cs,UmiUDI.iss):- 更新
AssemblyVersion/AssemblyFileVersion至1.2.1.41,对齐UmiUDI.iss安装包默认版本号及 CI/CD 版本提取规则。
- 更新
- 多企业账号精准消歧登录与本地 3 家历史记忆 (
2026-09-07
[feat/pc] 首页隐藏版本更新记录看板组件 (v1.2.1.35)
- 涉及文件:
UmiUDI&Drug/Properties/AssemblyInfo.csUmiUDI&Drug/Pages/HomePage.csUmiUDI&Drug/Pages/HomePage.Designer.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增与优化的代码功能:
- 隐藏版本更新记录看板组件 (HomePage.Designer.cs, HomePage.cs):
- 将
label_ver_title、label_current_ver、divider_ver、panel_changelog与竖向分割线divider_v设为不可见(Visible = false); - 注释首页构造函数中的
LoadChangelog()调用并清空其实现,避免无谓的文件解析与性能开销。
- 将
- 自适应布局调整与全宽注意事项面板 (HomePage.cs):
- 在
AdjustResponsiveLayout()中保持更新记录相关控件隐藏; - 将注意事项水平分割线
divider16与各条注意事项标签自适应扩展至面板全宽,使首页下半部分排版更宽敞大气、视觉干扰降至最低。
- 在
- 隐藏版本更新记录看板组件 (HomePage.Designer.cs, HomePage.cs):
[fix/pc] 包装关联与层级拆解全流程优化及多级条码智能对齐 (v1.2.1.34)
- 涉及文件:
UmiUDI&Drug/Properties/AssemblyInfo.csUmiUDI&Drug/Core/PackageLevelHelper.csUmiUDI&Drug/Pages/UDI_BZGL.csUmiUDI&Drug/Pages/UDI_SMGL.csUmiUDI&Drug/Pages/UDI_GLCX2.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增与优化的代码功能:
- 全链路严密保留 GS 分隔符与前置权威规范化 (PackageLevelHelper.cs):
NormalizeUdi仅清洗首尾空白与换行符,严禁剥离\u001d(ASCII 29);ResolveCanonicalUdi实现了对扫码枪 USB 键盘模式丢失控制符的智能对齐,通过精确匹配及无 GS 串前缀检索自动还原并补齐赋码明细中的带\u001d标准原串。
- 端到端装箱幂等复用与孤立行清理 (UDI_BZGL.cs, UDI_SMGL.cs):
- 重构组包关联插入逻辑,通过
udi检索历史记录:存在则更新最新有效记录的parent、root、createperson和updatetime,并清理多余历史重复行,不存在则执行插入; - 装箱事务中同步更新库存流转表
ck_inout_record.udi_parent,保持与 PDA 移动端出入库追溯一致。
- 重构组包关联插入逻辑,通过
- 拆解生命周期与空箱清理 (UDI_GLCX2.cs):
- 优化向下拆解与向上脱离逻辑:当被拆解对象为叶子单品(无下级包装)时,直接出表删除(
Deleteable<udi_package>),操作行为在udi_package_review日志中完整留痕; - 母箱被拆空后同步清理空箱记录,彻底杜绝
parent = NULL孤立幽灵行对后续组包与寻根的干扰。
- 优化向下拆解与向上脱离逻辑:当被拆解对象为叶子单品(无下级包装)时,直接出表删除(
- 数据库索引全面优化与性能提升:
- 在
udi_package上建立idx_udi_pkg_root、idx_udi_pkg_parent_udi; - 在
udi_package_review上建立idx_udi_rev_udi、idx_udi_rev_root、idx_udi_rev_createtime; - 在
dtc_package/dtc_package_review上建立追溯与层级索引,全表扫描降低为覆盖索引常数级查找。
- 在
- 全链路严密保留 GS 分隔符与前置权威规范化 (PackageLevelHelper.cs):
[fix/pc] UDI追溯全景图谱包装链路双向穿透与出库单客户信息加载 (v1.2.1.33)
- 涉及文件:
UmiUDI&Drug/Properties/AssemblyInfo.csUmiUDI&Drug/Pages/UDI_ZS.csUmiUDI&Drug/Resources/TraceGraph/trace-graph.jsUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增与优化的代码功能:
- 全拓扑双向递归包装树检索 (UDI_ZS.cs):
LoadTraceabilityData中实现了基于队列的双向广度优先搜索(BFS):- 向上递归查询
udi_package、udi_package_review、udi_dy_detail的parent直至最顶层外箱,解决高阶母包装丢失问题; - 向下递归穿透查询所有子包装、孙包装及最小单元单品明细,突破了原本只查直接父子关系的局限,单品明细完整入箱;
- 包装关系表、追溯明细表与全景图谱数据源全面闭环。
- 出库单客户名称精准提取与展示 (UDI_ZS.cs):
- 构建了完整的客户信息解析链:优先从出入库主表
ck_inout.customer提取,其次从 ERP 出库单erp_xsckd.FCustomerID提取,再次关联销售单udi_xsd.xsd_khmc提取; - 出库明细表
table8新增“客户名称”列,原“出库去向”规范为“出库仓库”; - 图谱出库单节点副标题准确赋值为
subtext = "出库给: " + customer,并在节点详情抽屉中展示收货客户。
- 构建了完整的客户信息解析链:优先从出入库主表
- 全景图谱任意深度层级自适应布局 (trace-graph.js):
- 仓储出入库节点所属层级动态计算为
Math.Max(6, maxChildLevel + 1),始终置于包装树右侧; applyLayout()自适应动态提取各层级深度计算横向 X 坐标与纵向 Y 坐标,支持任意深度包装树流畅排布。
- 仓储出入库节点所属层级动态计算为
- 全拓扑双向递归包装树检索 (UDI_ZS.cs):
[fix/pc] 彻底关闭未配置更新地址企业的更新检测与首次运行提示优化 (v1.2.1.32)
- 涉及文件:
UmiUDI&Drug/Properties/AssemblyInfo.csUmiUDI&Drug/Mian.csUmiUDI&Drug/Login.csUmiUDI&Drug/App.configUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增的代码功能:
- 更新检测企业配置强校验 (
Mian.cs):GetEffectiveUpdatePath()严格以后台企业配置的GlobalConfig.UpdatePath为唯一合法源;未配置时直接返回空;CheckUpdates()后台更新检查增加前置校验,若未配置更新地址则直接终止,不发出任何网络请求;- 手动点击更新按钮时,若未配置更新地址,给出友好警示:“当前企业未配置更新地址,已关闭更新检测。如需升级,请联系系统管理员在企业管理中配置更新地址”;
CheckAndShowUpgradeLog()区分首次在新机运行与真实升级:首次安装或解压运行仅在本地静默记录版本,不再误触发“升级成功”弹窗。
- 更新检测企业配置强校验 (
- 删减与重构的代码功能:
- 彻底删减官方更新源兜底回退(Fallback)机制 (
Mian.cs):- 彻底移除了企业未配置
UpdatePath时自动降级为官方 Gitee 默认公开源 (https://gitee.com/.../update.json) 的逻辑; - 在
DownloadAndInstall中彻底删减无条件追加官方 Gitee 地址并发拉取的逻辑,仅拉取企业明确指定的更新清单;
- 彻底移除了企业未配置
- 清理本地配置文件默认 GitHub 地址 (
App.config):- 将
App.config中的<add key="updatepath" ... />清空为默认空值,杜绝本地配置文件遗留默认官方地址影响更新判断。
- 将
- 彻底删减官方更新源兜底回退(Fallback)机制 (
[feat/pda] 出入库单据“单单合一”聚合卡片重构与真实单据分页 (UmiPDA v1.3.23)
- 涉及文件:
UmiPDA - API/Services/Implementations/InboundService.csUmiPDA - API/Services/Implementations/OutboundService.csUmiPDA/pages/querybound/index.vueUmiPDA/manifest.jsonUmiPDA/package.jsonUmiPDA/docs/DEVLOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增的代码功能:
- 服务端单据聚合与真实单据去重分页 (
InboundService.cs&OutboundService.cs):- 重构
GetInbounds与GetOutbounds接口; - 检索范围扩展:单号关键词同时模糊匹配
crkdh(单号)、scdh(工单号/订单号) 与cpmc(产品名称); - 单据去重分页:基于
crkdh进行 Distinct 分组分页,返回的total精准反映真实的单据总张数(如“共 5 单”),杜绝跨页切断单据问题; - 单据明细聚合:将单据项下的多行产品打包为
items子清单与整单sl合计数量返回。
- 重构
- 出入库单据查询前端“单单合一”聚合卡片重构 (
pages/querybound/index.vue):- 构建
processBillList聚合管道,严格保障一张出入库单仅生成唯一一张卡片; - 右侧高亮展示整单总数量(
+30件或-30件),若为多品则标注“共 N 品 合计”; - 新增紧凑型产品清单展示区域:单品直接显示品规批号;多品优雅紧凑罗列各子条目(最多显示前 3 种);超过 3 种产品时自动显示“...等共 N 种产品 (点击查看全部)”;
- 优化关键词搜索逻辑:支持模糊搜索主单号、工单号、主品名以及任意子明细的品名、规格与批号;
- 底部分页统计单位明确为“单”(如
1/1页 (共 5 单))。
- 构建
- 服务端单据聚合与真实单据去重分页 (
- 删减与重构的代码功能:
- 删减同一单据多条目分拆独立卡片的旧逻辑 (
pages/querybound/index.vue):- 废弃了对后端明细行一对一渲染卡片的平铺逻辑,彻底根除同张单据重复展示单号与多组审核/删除按钮的认知误区;
- 收拢多产品操作按钮为唯一整单操作 (
pages/querybound/index.vue):- 消除多张卡片中重复的
[明细]、[审核/反审核]、[删除]按钮组,统一为单据维度的单一操作入口。
- 消除多张卡片中重复的
- 删减同一单据多条目分拆独立卡片的旧逻辑 (
[feat/pda] UDI质检页面现代化重构与UDI抽检新模块设计实现 (UmiPDA v1.3.22)
- 涉及文件:
UmiPDA - API/Controllers/InspectionController.cs[NEW]UmiPDA - API/Services/Interfaces/IInspectionService.cs[NEW]UmiPDA - API/Services/Implementations/InspectionService.cs[NEW]UmiPDA - API/Program.csUmiPDA/api/inspection.js[NEW]UmiPDA/pages/inspection/index.vue[NEW]UmiPDA/pages/inspection/list.vue[NEW]UmiPDA/pages/quality/index.vueUmiPDA/pages/quality/list.vueUmiPDA/pages/home/index.vueUmiPDA/pages.jsonUmiPDA/manifest.jsonUmiPDA/package.jsonUmiPDA/docs/DEVLOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增的代码功能:
- UDI 抽检服务端全套服务与接口 (
InspectionController.cs/InspectionService.cs):GET /app/Inspection/tasks: 分页与模糊搜索待抽检任务单,聚合返回工单量与已抽检总件数;GET /app/Inspection/task-details: 查询任务单基准要素(DI、批号、效期、规格、序列号标记),智能推荐抽检目标量;POST /app/Inspection/verify: 单条码即时防错核验,比对任务单明细(严防混批)、校验此前是否已抽检(严防重复扫码),并与标准工单要素比对;POST /app/Inspection/submit: 批量抽检提交,使用数据库事务双表同步写入udi_cj与udi_cj_review两张数据表;GET /app/Inspection/list: 分页查询抽检历史批次汇总,聚合输出合格率、抽样数、异常数及检验员。
- PDA 前端抽检 API 封装 (
api/inspection.js):- 提供
getInspectionTasks、getInspectionTaskDetails、verifyInspectionBarcode、submitInspection、getInspectionList5 项全功能接口。
- 提供
- 全新 UDI 抽检核心作业页面 (
pages/inspection/index.vue):- 顶部接入统一
PdaPageHeader,右侧挂载抽检历史记录入口; - 吸顶工单胶囊与检索抽屉:展示当前选定工单,支持多关键词搜索切换工单,自动提取品名、规格、批号、效期、DI;
- 目标抽样量设定与进度仪表:提供 5/10/20/50 快捷目标胶囊与实时合格率进度条;
- 连续扫码与强防呆混批阻断:集成
pdaScanner与pdaAudio,非本工单或混批条码直接长鸣报警、震动并弹出阻断性警示窗;重复扫码友好弹窗; - 抽样扫码流水卡片:倒序呈现已验条码,支持单项合格/异常状态现场切换及误扫移除;
- 底部固定汇总操作栏:展示合格/异常/总数统计,支持清空重置与一键批量提交。
- 顶部接入统一
- 全新 UDI 抽检记录历史列表页面 (
pages/inspection/list.vue):- 接入统一
PdaPageHeader; - 多条件实时搜索(任务单/工单/品名/批号);
- 高密度历史卡片:包含合格率彩色标签、抽检三色统计胶囊、检验人员与时间,支持点击弹窗查看完整概况。
- 接入统一
- 工作台入口扩充与路由注册 (
pages/home/index.vue,pages.json):- 在
pages.json中配置并注册pages/inspection/index与pages/inspection/list沉浸式路由; - 在工作台模块九宫格中加入「UDI 抽检」独立入口与图标。
- 在
- UDI 质检作业页面现代化重构 (
pages/quality/index.vue):- 接入统一
PdaPageHeader,右侧插槽挂载质检历史入口; - 紧凑扫码栏与扫码枪广播接收;
- 视觉判定大横幅:合格/异常状态大卡片,配合声光反馈;
- GS1与药监四维合规矩阵:全景评估编码合规、DI匹配、PI动态要素、药监局注册,输出综合评级(A/B/C/D);
- 扫码后自动异步保存记录至
udi_zj,无需繁琐人工点击保存。
- 接入统一
- UDI 抽检服务端全套服务与接口 (
- 删减与重构的代码功能:
- 删减旧版质检页面的冗余 DOM 与手写 Header (
pages/quality/index.vue):- 删减手写的私有 Header 结构与冗余样式,全面收拢至
PdaPageHeader; - 废弃过时无效的扫码判定逻辑,精简排版密度。
- 删减手写的私有 Header 结构与冗余样式,全面收拢至
- 重构条码判定与音效反馈链路:
- 统一采用
pdaAudio成功音与失败音标准接口,消除各模块自定义提示音混乱问题。
- 统一采用
- 删减旧版质检页面的冗余 DOM 与手写 Header (
[feat/pda] 全局页面Header统一设计收拢、恢复自定义数量步进弹窗与双轨兜底体系 (UmiPDA v1.3.21)
- 涉及文件:
UmiPDA/components/pda/PdaPageHeader.vue[NEW]UmiPDA/pages.jsonUmiPDA/pages/home/index.vueUmiPDA/pages/inbound/index.vueUmiPDA/pages/outbound/index.vueUmiPDA/pages/querybound/index.vueUmiPDA/pages/allbound/index.vueUmiPDA/pages/leftbound/index.vueUmiPDA/pages/searchpackage/index.vueUmiPDA/pages/quality/index.vueUmiPDA/pages/quality/list.vueUmiPDA/pages/package/index.vueUmiPDA/manifest.jsonUmiPDA/package.jsonUmiPDA - API/appsettings.jsonUmiPDA/docs/DEVLOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增的代码功能:
- 全局统一顶部导航栏组件 (
components/pda/PdaPageHeader.vue):- 深度适配 PDA 沉浸式状态栏安全区域
calc(var(--status-bar-height, 0px) + 8px); - 统一标题视觉排版(17px / 600字重 /
#1e293b),单行居中且超长自动省略; - 集成全局返回动作与 450ms 路由防抖,支持栈底自动回退工作台;
- 开放左右侧多态扩展插槽与
:custom-back自定义拦截控制;
- 深度适配 PDA 沉浸式状态栏安全区域
- Easycom 组件规范自动化装配 (
pages.json):- 配置
"^Pda(.*)": "@/components/pda/Pda$1.vue"规则,实现 PDA 系列组件全局免显式导入即可引用;
- 配置
- 恢复自定义数量步进弹窗与双轨降级兜底 (
pages/inbound/index.vue):showQuantityInput恢复优先调用quantityDialogRef.value.open(options),自动唤起PdaQuantityDialog专用纯数字大键盘,支持-1/+1/+5/+10/+50/最大/重置快捷录入;- 保留原生
uni.showModal作为安全降级兜底,异常时平滑降级,杜绝任何意外卡死;
- 全端 10 个业务页面 Header 统一收拢改造:
- 首页(工作台)、入库管理、出库管理、出入库单据查询、库存查询、剩余库存、包装关联管理、UDI质检、质检历史、包装关联作业等全部 10 个业务页面统一接入
PdaPageHeader。
- 首页(工作台)、入库管理、出库管理、出入库单据查询、库存查询、剩余库存、包装关联管理、UDI质检、质检历史、包装关联作业等全部 10 个业务页面统一接入
- 全局统一顶部导航栏组件 (
- 删减与重构的代码功能:
- 彻底删减各页面手写的单兵
<view class="header">模板:- 严格落实全局 Header 统一管控设计,禁止任何业务页面私自手写头部与返回按钮结构;
- 批量清理各业务页面下属数百行重复冗余样式:
- 删除各业务页面中手写的
.header、.back-btn、.back-icon-img、.page-title、.placeholder及零碎媒体查询样式(共清理 300+ 行冗余 CSS)。
- 删除各业务页面中手写的
- 彻底删减各页面手写的单兵
[fix/pda] PDA入库原生弹窗交互恢复、变量作用域修复与单据扫码流水对齐 (UmiPDA v1.3.20)
- 涉及文件:
UmiPDA/pages/inbound/index.vueUmiPDA/pages/querybound/index.vueUmiPDA/api/inbound.jsUmiPDA/manifest.jsonUmiPDA/package.jsonUmiPDA - API/appsettings.jsonUmiPDA/docs/DEVLOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 新增的代码功能:
- 扫码全链路异常捕获与友好弹窗提示:在
handleScanConfirm中补充完整try...catch(error)...finally闭环,发生任何业务或代码异常时直接弹出uni.showModal提示具体错误详情,彻底消除因未捕获异常导致的扫码静默无反应现象; - 物理条码 AI(21) 序列号精准判别机制:引入
barcodeHasSerial = !!(udiDyDetail.udi_dy_detail_21)判别,只有条码物理上确实具有序列号且工单启用了序列号管控时才走一件一码;扫描无序列号的纯批次码一律进入批次流程; - 单据查询抽屉对齐 PC 端扫码流水:抽屉由原先错误调用
GetInoutDetails(拆解明细表)全面切换为调用GetInoutRecordsByCrkdh(ck_inout_record扫码流水表),现场扫什么条码即显示什么条码,DI 与数量 1:1 对齐 PC 端。
- 扫码全链路异常捕获与友好弹窗提示:在
- 删减与重构的代码功能:
- 移除对自定义组件
PdaQuantityDialog的强依赖:删减了showQuantityInput对quantityDialogRef.value.open()的组件引用依赖,彻底恢复为旧版本稳定可靠的 Uni-App 原生弹窗uni.showModal({ title: '输入数量', editable: true, ... }),零生命周期依赖、零层级遮挡风险、100% 稳定弹出; - 修复变量作用域越界致命缺陷:删除了在
if (formData.scdh)代码块内以const局部声明变量的方式,提升let udiDetailFromCurrentScd = null;与let childItemsFromCurrentScd = [];至函数顶层作用域,彻底根除行 1427 访问时抛出ReferenceError: childItemsFromCurrentScd is not defined导致 JS 线程崩溃中断入库的严重缺陷; - 删减错误的工单全局序列号覆盖判定:移除了原先只要工单带序列号就强行将所有扫码劫持至
handleSerialNumberUdi的逻辑,杜绝批次码被跳过弹窗直接当成一件录入的错误行为。
- 移除对自定义组件
2026-09-06
[feat/ux] 销售出库数量双轨核算机制、实时联动与订单全生命周期闭环流转 (Pages/CK_OUT.cs & Pages/CK_OUT_List.cs & Pages/UDI_XSD_List.cs & Forms/XSD_Select.cs)
- 涉及文件:
UmiUDI&Drug/Pages/CK_OUT.csUmiUDI&Drug/Pages/CK_OUT_List.csUmiUDI&Drug/Pages/UDI_XSD_List.csUmiUDI&Drug/Forms/XSD_Select.csUmiUDI&Drug/docs/DEVLOG.md说明文档/UmiUDI&Drug系统业务标准操作规程(SOP)全集.md
- 需求与优化说明:
- 业务双轨核算与行级精准绑定机制:
- 全面对标入库标准,确立出库“在途占用额度”与“正式出库登账”双轨机制。
- 出库保存时将对应销售订单明细行 ID 存储于
ck_inout.scd_id,实现行级精准追溯;历史已出库/占用穿透统计优先按明细 ID 聚合,兼容“单号 + DI/最小单元DI”兜底。
- 销售出库录入界面(
CK_OUT.cs)明细表格动态联动:- 上方销售单明细表格
table2扩充【已出库数量】(历史已审+未审在途)与【本次已扫】动态列; - 引入
udi_xsd_detail_temp : NotifyProperty数据模型,实现UpdateXsdItemsScannedQuantities()联动; - 扫码入库与行删码时实时汇总各明细当前扫码件数,平滑驱动 UI 动态跳变,操作员无需刷新即可清晰获知订单履约进程。
- 上方销售单明细表格
- 双重防超发强拦截体系:
- 扫码即时声光拦截:在 4 大扫码执行分支中统一接入
CheckXsdOvershipment,当ycksl + current_scanned + incomingQty > 订单数量时立即触发系统错误音并弹出红框拦截通知,阻断超额扫码; - 保存事务级强复核:点击【保存】时在事务开始前执行二次全单聚合复核,严防多端或高频录入超发。
- 扫码即时声光拦截:在 4 大扫码执行分支中统一接入
- 销售订单全生命周期状态闭环自动流转:
- 在出库单审核(
CK_OUT_List.cs)成功后,自动穿透核算关联合同/销售单履约进度;若所有销售明细均足额出库,自动将销售单业务状态流转为【已完成】; - 在出库单反审核后,若导致销售单出现未足额出库行,自动将业务状态回退为【已下推】。
- 在出库单审核(
- 销售订单看板与选单弹窗出库进度升级:
- 销售订单列表(
UDI_XSD_List.cs)与销售单选择弹窗(XSD_Select.cs)新增【出库进度】列,格式化为"{已出库} / {订单数量}"; - 在
table1_CellPaint绘制智能角标:满额出库渲染绿色角标(Color.FromArgb(82, 196, 26)),部分出库渲染蓝色角标(Color.FromArgb(24, 144, 255))。
- 销售订单列表(
- 业务双轨核算与行级精准绑定机制:
[feat/ux] 生产入库数量双轨核算机制与录入/列表多维进度实时联动 (Pages/CK_IN.cs & Pages/UDI_SCD_List.cs & Forms/SCD_Select.cs)
- 涉及文件:
UmiUDI&Drug/Pages/CK_IN.csUmiUDI&Drug/Pages/UDI_SCD_List.csUmiUDI&Drug/Forms/SCD_Select.csUmiUDI&Drug/docs/DEVLOG.md说明文档/UmiUDI&Drug系统业务标准操作规程(SOP)全集.md
- 需求与优化说明:
- 业务双轨核算机制确立:
- 明确区分“在途占用额度”与“正式入库登账”:点击【保存】时生成未审核入库单并即时锁定工单配额(防止其他终端重复开单造成超额);在列表点击【审核】后正式登账计入库存,并流转工单状态为已完成/已下推。
- 生产入库录入界面(
CK_IN.cs)新增【本次已扫】动态列:- 上方工单表格新增
本次已扫列,布局调整为生产单号 | DI | 产品名称 | 规格型号 | 批号 | 生产数量 | 已入库数量(历史) | 本次已扫; - 实现
UpdateScdItemsScannedQuantities()联动机制,在扫码入库、删除条码时动态汇总更新各物料行当前扫码件数,配合OnPropertyChanged数据绑定实现无闪烁平滑跳变,彻底消除操作员在扫码过程中对“已入库数量”未实时变动的视觉困惑。
- 上方工单表格新增
- 生产工单列表(
UDI_SCD_List.cs)新增【入库进度】看板与智能角标:- 表格新增【入库进度】列,格式化为组合形式
"{已入库量} / {生产数量}"(如10 / 20); - 穿透
ck_inout流水表自动汇总已入库数量,集成PackageLevelHelper多级包装倍率智能换算; - 在
table1_CellPaint中实现智能高亮角标:满额入库显示绿色角标,部分入库显示蓝色角标。
- 表格新增【入库进度】列,格式化为组合形式
- 生产单选择弹窗(
Forms/SCD_Select.cs)同步【入库进度】:- 选单弹窗数据模型扩展
scd_yrksl与scd_progress属性,表格同步新增【入库进度】列与角标渲染; - 搜索过滤下拉选项支持按【入库进度】检索,仓管开单选单时可精准把控工单剩余余量。
- 选单弹窗数据模型扩展
- 业务双轨核算机制确立:
[feat] 飞检合规五大核心报表模板与真实单据数据源设计器 (Pages/UDI_BBSJ.cs & Services/FlyInspectionTemplateHelper.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_BBSJ.cs,UDI_BBSJ.Designer.csUmiUDI&Drug/Pages/DTC_BBSJ.csUmiUDI&Drug/Services/ReportDataService.csUmiUDI&Drug/Services/FlyInspectionTemplateHelper.csUmiUDI&Drug/Template/飞检合规模板/(五套.repx模板文件)UmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 依据国家飞检规范及 GMP/GSP 检查标准,内置 5 种权威合规报表模板:
- UDI赋码打印流转卡(包含赋码、检验、放行三级签署与批次条码明细);
- 医疗器械销售出库复核单(包含购销双方信息、同行业务单号、UDI与扫码明细);
- 产品放行单 (COA)(质量检测指标、检验结论与放行批准);
- 采购验收记录表(到货验收、外观包装、冷链温湿度与复核签名);
- 外包装层级分包装清单(多级包装母箱与子箱/内含单品树形展开关联清单)。
- 动态单据绑定与真实数据流转:
- 新增
ReportDataService.cs,支持在报表设计器中选择具体单据后自动提取真实 UDI 数据、主表信息及关联子表构建数据模型; - 新增
FlyInspectionTemplateHelper.cs,实现本地模板目录无损初始化与缺失模板自动释放创建机制; - 设计器新增模板下拉选择与一键载入,并集成设计、预览与独立保存能力。
- 新增
- 依据国家飞检规范及 GMP/GSP 检查标准,内置 5 种权威合规报表模板:
[feat/refactor] 生产工单多物料支持与生产单选择框明细级联动 (Forms/SCD_Select.cs & Pages/UDI_SCD.cs)
- 涉及文件:
UmiUDI&Drug/Forms/SCD_Select.csUmiUDI&Drug/Pages/UDI_SCD.cs,UDI_SCD_List.csUmiUDI&Drug/Pages/DTC_SCD.cs,DTC_SCD_List.csUmiUDI&Drug/Models/udi_scd.csUmiUDI&Drug/Core/BusinessLogicHelper.cs,DTCBusinessLogicHelper.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 生产工单一单多产品选择支持:
- 重构
SCD_Select.cs生产单选择窗体,支持单号和单据明细行双维精准展示,操作员可清晰查看同一生产任务单下包含的不同产品名称、规格型号、批号与待生产数量; - 解决多产品生产单在选择时仅能带出第一条物料的局限,支持按明细行精准选中并带入下游生产与入库业务流;
- 重构
- 工单状态流转精准判定:
- 统一多物料生产单状态流转逻辑,依据各明细累计入库数量与生产数量比对,精准更新“已审核”、“已下推”、“已完成”等业务状态,避免因部分物料完成导致整体状态误判。
- 生产工单一单多产品选择支持:
[feat/refactor] PC 端生产入库一单多物料录入与数据库模型扩展 (Pages/CK_IN.cs & Models/ck_inout.cs)
- 涉及文件:
UmiUDI&Drug/Pages/CK_IN.cs,CK_IN.Designer.csUmiUDI&Drug/Models/ck_inout.cs,ck_inout_review.csUmiUDI&Drug/Core/DbMigrator.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 一单多产品录入能力:
- 改造 PC 端
CK_IN.cs,由以往仅支持单一产品入库,升级为支持同一入库单号下录入和批量添加多个不同产品(DI、规格、批号、数量)的产品明细; - 生产单选择后支持自动分行展开带入多产品明细,并对各行产品数量分别进行工单余量校验与防超限控制;
- 改造 PC 端
- 数据持久化与数据库无损增量迁移:
ck_inout(出入库主表)与ck_inout_review(审计日志表)模型新增scd_id(生产单明细ID)字段;DbMigrator.cs增加自动检查并补全scd_id列结构逻辑,确保客户端启动时自动平滑升级数据库;- 入库保存时按明细行进行多产品原子事务落库,流水记录
ck_inout_record与ck_inout_detail准确关联对应物料。
- 一单多产品录入能力:
[feat] PDA 移动端多产品入库全流程与 API 服务支持 (UmiPDA & UmiPDA - API)
- 涉及文件:
UmiPDA/pages/inbound/index.vueUmiPDA/api/inbound.jsUmiPDA - API/Controllers/InboundController.cs,ScdController.csUmiPDA - API/Services/Interfaces/IInboundService.cs,IScdService.csUmiPDA - API/Services/Implementations/InboundService.cs,ScdService.csUmiPDA - API/Models/AddInboundsRequest.cs,udi_scd_item_dto.csUmiPDA - API/Models/ck_inout.cs,udi_scd.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- PDA 生产工单多明细拉取:
- 新增
GET /api/scd/itemsByDjbh接口,PDA 选单时能够完整读取同一工单名下的所有产品条目; - 在 PDA 端
inbound/index.vue中支持一键选择目标生产工单,并在扫码录入时切换不同产品标签;
- 新增
- 多产品批量入库接口:
- 新增
AddInboundsRequest数据传输模型,API 端新增POST /api/inbounds批量入库端点; - 在事务内原子写入所有产品的
ck_inout主表记录、ck_inout_record扫码记录与ck_inout_detail包装明细,同时生成审计日志,更新工单业务状态,保障手持端与桌面端业务一致性。
- 新增
- PDA 生产工单多明细拉取:
[feat/security] 出库单严格在库校验、防重与发货超限拦截 (Pages/CK_OUT.cs & OutboundService.cs)
- 涉及文件:
UmiUDI&Drug/Pages/CK_OUT.csUmiPDA - API/Services/Implementations/OutboundService.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 序列号/条码在库状态强校验:
- 出库前严格比对待出库序列号(一物一码),必须存在已审核入库记录且未在其他出库单中被出库使用,杜绝未入库条码直接出库或已出库条码二次出库;
- 发货数量超限防呆:
- 针对关联销售单(或发货通知单)的出库操作,严格核算销售单总需出数量、历史累计出库数量与当前单据数量,一旦当前出库导致累计发货量超过订单数量,立即弹窗拦截并终止审核,严防超限发货;
- 多物料出库防呆对齐:
- 销售单下包含多个物料时,按 DI 分物料进行分别核算,确保各物料发货额度互不串扰。
- 序列号/条码在库状态强校验:
[fix] PC 端列表复选框首行点击崩溃、内存残留与多产品单据删除/审核/作废全链路修复 (Pages/CK_IN_List.cs & Pages/CK_OUT_List.cs)
- 涉及文件:
UmiUDI&Drug/Pages/CK_IN_List.csUmiUDI&Drug/Pages/CK_OUT_List.csUmiPDA - API/Services/Implementations/InboundService.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户在 PC 端入库单列表中删除未审核单据(如
SCRKD2026090600008)时,界面误弹窗拦截报错:【操作拦截】该入库单中的产品已产生出库记录,无法删除;但经数据库实际查验,该入库单产品出库记录为 0。
- 用户在 PC 端入库单列表中删除未审核单据(如
- 根因深度排查:
- 首行复选框失效与空指针异常:
table1_CellClick事件中错误判断if (e.RowIndex != 0),误将第 0 行作为表头全选处理,执行e.Record as List<ck_inout_temp>返回 null 引发异常,导致用户点击第一行复选框时,当前单据根本没有加入待处理列表; - 内存勾选列表残留“僵尸单据”:
ck_Inout_Temps_Check列表在分页、刷新、日期筛选或报错中断时未完全清空,遗留了历史操作过且确实包含出库记录的其他单据(如SCRKD2026042400008),导致系统实际拿去校验出库的是历史残留单据; - 多产品单据多行联动缺失与数量卡死:一张单据包含多行产品明细时,点击复选框未能全单联动;且审核与作废中硬编码
if (ck_Inout_Temps_Check.Count != 1),多产品单据勾选两行以上时误报“请选择一条数据”,导致无法审核或作废。
- 首行复选框失效与空指针异常:
- 重构与优化内容:
- 重写复选框点击与单据联动:
- 移除
e.RowIndex != 0,以e.Record is ck_inout_temp判断行点击,支持所有数据行(包括第 0 行)正常勾选; - 实现同单号所有产品明细行自动联动:点击同一单据的任意一行复选框,该单据下所有产品行同步勾选/反勾选;
- 新增
SyncCheckedList()方法,实时从当前页表格的真实选中状态重新汇总,在分页、刷新、日/周/月过滤时彻底清空历史状态,完全消除“僵尸单据”残留;
- 移除
- 精准化出库记录防呆比对:
- 删除、反审核、作废前,根据待处理单号精准查询其所属 UDI 产品的出库记录;若真实存在出库,精确提示冲突出库单号(如:
入库单【{billNo}】中的产品已在出库单【{outDetail.crkdh}】中产生出库记录),绝不跨单误判;
- 删除、反审核、作废前,根据待处理单号精准查询其所属 UDI 产品的出库记录;若真实存在出库,精确提示冲突出库单号(如:
- 全面支持多产品单据业务流转:
- 将审核、作废按钮的单选判断重构为
distinctCrkdhs.Count != 1,同一单号包含多个产品时作为一个完整业务单据正常执行审核、反审核与作废; - 批量删除按单号去重执行,杜绝多次删除导致的异常或重复审计记录;
- 将审核、作废按钮的单选判断重构为
- PDA 端协同加固:
- PDA 端
InboundService.DeleteInbound删除入库单时,循环遍历并记录全量产品明细的审计日志;删除方式与 PC 端统一为符合合规要求的软删除(is_deleted = true),拦截信息同步优化为具体冲突出库单号。
- PDA 端
- 重写复选框点击与单据联动:
[feat/ui] 可视化标签设计器一键插入条码控件与真实数据即时预览 (Pages/UDI_BQSJ.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_BQSJ.cs,UDI_BQSJ.Designer.csUmiUDI&Drug/Template/report1.repxUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 常用设计控件一键插入与自由拖拽:
- 在标签设计器中新增常用元素快捷操作,基于
IDesignerHost事务与ISelectionService深度集成 DevExpress 报表引擎; InsertDataMatrixBarcode():一键插入标准 UDI DataMatrix 二维条码控件,自动配置 GS1 编码语法规则与紧凑布局,插入后自动高亮选中并支持鼠标自由拖拽缩放;InsertLabel():一键插入标准单行文本标签,自动适配报表 DPI 与物理度量单位(毫米/英寸/像素);Insert1DBarcode():一键插入标准 Code128 工业一维条形码控件,支持表达式绑定与文字展示;InsertPictureBox():一键插入企业 Logo / 标志占位框,预设缩放模式;
- 在标签设计器中新增常用元素快捷操作,基于
- 真实 UDI 示例数据真机即时预览:
- 新增
ShowRealDataPreview(),自动构建包含真实 UDI 条码与品规批次示例数据的内存数据集,调出标准真实预览弹窗,设计人员无需切换到打印模块即可即时直观核对真机打印排版效果。
- 新增
- 常用设计控件一键插入与自由拖拽:
[fix/perf] 全景追溯跨线程数据绑定重构与图谱异步容错 (Pages/UDI_ZS.cs & Resources/TraceGraph/index.html)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_ZS.csUmiUDI&Drug/Resources/TraceGraph/index.htmlUmiUDI&Drug/Resources/TraceGraph/test_page.htmlUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 跨线程数据绑定彻底加固:
- 追溯查询涉及产品明细、工单、打印、首检、抽检、包装拆装、入库、出库、销售等 9 张核心关联表格;原有多线程查询在后台线程直接对 UI 控件
DataSource赋值,极易在快速连续点击或网络延迟时抛出跨线程异常(Cross-thread operation not valid); - 新增
ApplyTraceabilityDataToTables(),统一使用InvokeRequired与this.Invoke安全切回 UI 主线程集中原子绑定 9 大表格,彻底消除跨线程竞争与界面卡死;
- 追溯查询涉及产品明细、工单、打印、首检、抽检、包装拆装、入库、出库、销售等 9 张核心关联表格;原有多线程查询在后台线程直接对 UI 控件
- WebView2 图谱通信健壮性与异步容错:
- 渲染脚本调用
webView_graph.ExecuteScriptAsync增加ContinueWith异常观察,防止 Task 异常未捕获导致终结器崩溃; - 增强
WebMessageReceived消息解析,双轨兼容e.WebMessageAsJson与e.TryGetWebMessageAsString(); - 规范追溯全景图谱标题为“追溯全景图谱”,前后端样式与徽章同步更新。
- 渲染脚本调用
- 跨线程数据绑定彻底加固:
[feat/ux] 页面激活与标签页切换智能脏刷新机制 (Mian.cs & Pages/CK_IN_List.cs)
- 涉及文件:
UmiUDI&Drug/Mian.csUmiUDI&Drug/Pages/CK_IN_List.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 用户在单据录入页面完成入库、出库或工单保存后,切换回列表标签页时由于表格未主动刷新,仍显示历史快照,造成“已保存单据未在列表出现”的错觉;
- 在主框架
Mian.cs标签页切换事件tabs1_SelectedIndexChanged中,增加针对激活页面的脏标记探测与智能联动刷新(AutoRefreshIfDirty()); - 当操作员在子页面完成数据提交或状态变更后,切回对应列表即刻静默重拉最新单据,无需操作员反复手动点击“刷新”按钮。
2026-09-05
[fix/ui] 生产单【包装等级】与【单位】单元格锁定禁止编辑防呆 (Pages/UDI_SCD.cs & Pages/DTC_SCD.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_SCD.csUmiUDI&Drug/Pages/DTC_SCD.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 用户反馈生产单产品明细中的【包装等级】和【单位】单元格不应开放编辑,防止操作人员误改破坏多级包装换算与生产追溯数据逻辑;
- 在
UDI_SCD.cs中将bzdj(包装等级)与dw(单位)两列的Editable均显式设为false;并在CellClick点击事件中增加强制拦截逻辑,严禁调用EnterEditMode进入编辑状态; - 同步将
DTC_SCD.cs中的pack_unit_name(包装单位)列设为Editable = false并添加点击拦截,彻底消除误操作风险。
[ui/feature] 销售单明细数量高亮与包装单位动态加载 (Pages/UDI_XSD.cs, Pages/DTC_XSD.cs, Forms/DI_Select.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_XSD.csUmiUDI&Drug/Pages/DTC_XSD.csUmiUDI&Drug/Forms/DI_Select.csUmiUDI&Drug/Pages/UDI_SCD.csUmiUDI&Drug/docs/DEVLOG.md
- 需求与优化说明:
- 单位列只读并动态加载:将销售单明细中的【单位】列设为只读(去除 Editable),实现根据
di_devicepackage或di_download_devicepackage中的包装级别(CPBZJB,如 盒、箱、支、包 等)自动动态加载;若为单品/基础单元则读取存储条件表JLDW或规范默认单位; - 选择窗体联动穿透:
DI_Select在构建多级包装层级节点时,自动读取对应包装级别并赋予unit,在产品选择返回后精准填充到销售单明细; - 数量单元格红色高亮与可编辑提示:对齐生产单样式,为数量列填充半透明红色背景(
Color.FromArgb(80, 255, 0, 0)),提示操作员该列支持点击录入;单据审核锁定后自动取消高亮,反审核后自动恢复; - 保存校验拦截:保存销售单时补充拦截小于等于 0 的非法数量。
- 单位列只读并动态加载:将销售单明细中的【单位】列设为只读(去除 Editable),实现根据
[fix] 多级包装维护内含包装下拉树选择防崩与双表联合穿透 (Forms/DI_DevicePackage.cs)
- 涉及文件:
UmiUDI&Drug/Forms/DI_DevicePackage.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户在【多级包装维护】抽屉中点击【包装内含包装产品标识】下拉框,选中某个内含包装树节点时,客户端直接抛出
System.ArgumentNullException: Value cannot be null. (Parameter 's') at System.Int32.Parse(String s) at DI_DevicePackage.cs:104并闪退。
- 用户在【多级包装维护】抽屉中点击【包装内含包装产品标识】下拉框,选中某个内含包装树节点时,客户端直接抛出
- 根因分析:
- 手动从【DI库(生成)】创建包装时,窗体构造函数中
di_Devicepackage对象的BZDJ字段未赋予初始值;若用户保存该包装时未曾触发下拉点击,该条记录入库后其BZDJ字段为 NULL; - 随后用户继续为该产品创建更高层包装时,在下拉树中点击该历史包装节点,原代码无任何判空直接执行
int.Parse(dI_DevicePackage.BZDJ),因其字段为 NULL 导致瞬间抛出ArgumentNullException; - 同时,如果选中的条码来自国家药监局下载数据,原代码单表查询返回 null 亦会引发同类崩溃;
queryBZ递归构建时也存在单表盲区。
- 手动从【DI库(生成)】创建包装时,窗体构造函数中
- 重构与优化内容:
- 构造与保存全周期赋初值防护:在
DI_DevicePackage构造函数中默认初始化BZDJ = "1";在点击保存入库前,若检测到BZDJ为空,自动根据其内含包装条码通过PackageLevelHelper自动推导并合法赋值; - 双表联合穿透查询:新增
GetPackageRecord方法,穿透查询di_devicepackage与di_download_devicepackage双表,彻底消除不同数据源之间的盲区; - 空值安全防护与等级计算:树节点点击时优先读取
TreeItem.Tag,若无则穿透查询双表并使用int.TryParse安全解析,兜底接入PackageLevelHelper.GetDiPackagingLevelRank,彻底杜绝异常抛出; - 祖先溯源与子树构建双表穿透:
queryBZ与querySubBZ全面支持双表关联,确保各类规格来源的包装层级树均能完整正确呈现。
- 构造与保存全周期赋初值防护:在
[feat] 销售单下推生产单单据备注信息一并带入 (Pages/UDI_SCD.cs & Pages/DTC_SCD.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_SCD.csUmiUDI&Drug/Pages/DTC_SCD.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户反馈在销售单执行下推生产单时,销售单录入的“备注”信息没有一并带入到生产单基本信息的“备注”输入框中,导致生产单保存后备注丢失。
- 重构与优化内容:
- 下推初始化数据绑定补全:在器械生产单
UDI_SCD.cs与药品生产单DTC_SCD.cs的setDatas()下推分支中,补全对input_bz.Text的赋值,优先提取传入模型中的备注,若为空则自动通过关联销售单号反查补齐; - 手动选单联动同步带入:在生产单界面手动点击销售单选择放大镜(
openXsdSelect)选定单据后,若当前生产单备注为空,亦自动同步带入对应销售单的备注信息; - 保存与直接下推全链路贯通:确保无论是“直接下推”静默落库,还是“下推并编辑”打开新增页,销售单备注均 100% 完整继承并持久化。
- 下推初始化数据绑定补全:在器械生产单
[docs] 生产环境版本更新日志 (CHANGELOG.md) 精炼化重构(全部条目压缩至30字以内)
- 涉及文件:
UmiUDI&Drug/docs/CHANGELOG.mdUmiUDI-Update/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 优化说明:
- 针对用户反馈更新弹窗中更新历史过长过细的问题,对全版本(v1.2.1.26、v1.2.1.25、v1.2.1.23 以及历史各版本)生产环境日志进行全量高密度精炼,彻底移除所有冗长二级展开项,将全部业务要点严格浓缩为 30 字以内的单行精炼条目,彻底解决弹窗文字拥挤问题。
[fix/feature] UDI 追溯全链路包装层级全面接入系统统一规范与历史遗留字符串彻底清除 (Pages/UDI_ZS.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_ZS.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户反馈 UDI 追溯的包装层级未完全使用系统统一规范。经全面地毯式代码审查,排查出 UDI 追溯中虽然包装关联表格接入了规范,但在产品标识明细 (
table1)、打印任务单 (table3) 及全景溯源图谱 (BuildGraphData) 节点与详情弹窗中,仍然散落残留有“最小销售单元”、“二级包装【中包】”、“三级包装【大箱】”、“一级包装”、“【单品】”等非标准历史硬编码字符串。
- 用户反馈 UDI 追溯的包装层级未完全使用系统统一规范。经全面地毯式代码审查,排查出 UDI 追溯中虽然包装关联表格接入了规范,但在产品标识明细 (
- 重构与优化内容:
- 产品标识明细 (
table1) 全面接入权威规范:search_pkg_level_desc、search_min_unit_di全面接入PackageLevelHelper.GetPackagingLevelName(db, di)、GetDiPackagingLevelRank与GetMinimalUnitDi;- 列头规整为“是否最小单元”、“最小单元DI”,包装比例规整为
1 : 1 (最小单元),彻底消除“最小销售单元”、“【中包】”等历史遗留词汇。
- 打印任务单 (
table3) 包装等级规范化:- 将
udi_dy_bzcj规整为统一规范名称(“一级”、“二级”、“三级”、“最小单元”),剔除多余“包装”后缀。
- 将
- 全景溯源图谱 (
BuildGraphData) 节点与标签规范化:- 中心目标条码节点 Tag 标明
{规范层级} (当前),属性标明“包装层级”、“是否最小单元”; - 子包装、孙包装、母包装节点标签全面统一为标准层级(“一级”、“二级”、“最小单元”),彻底剔除“【单品】”、“【大箱】”、“包装”等后缀;
- 详情弹窗中的术语同步规范为“最小单元”。
- 中心目标条码节点 Tag 标明
- 产品标识明细 (
[fix/feature] UDI 全景溯源图谱历史移出关系排除与“已拆除”虚线红字标注切换 (Pages/UDI_ZS.cs & Resources/TraceGraph)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_ZS.csUmiUDI&Drug/Resources/TraceGraph/index.htmlUmiUDI&Drug/Resources/TraceGraph/trace-graph.jsUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户在 UDI 追溯界面的【智慧全景溯源图谱】中发现异常展示的历史包装节点(例如已被移出的中包和大箱),因图谱构建原逻辑将审计流转表中的历史记录无差别纳入且未标明移出状态,造成与关联表格中真实在箱数据不一致。
- 重构与优化内容:
- 实时在箱关系基准校验与历史移出标记 (
UDI_ZS.cs):- 在构建溯源图谱数据源时,以实时在箱数据表构建当前有效在箱条码拓扑集合;
- 对子包装、孙包装及母包装逐一比对操作类型(
移出包装、整包拆解)及是否在实时在箱集合中,精准标记isRemoved = true、样式设为removed、标签标注为“已拆除”、节点 Tag 标红; - 包装层级全面统一接入系统权威规范计算。
- 图谱前端引擎智能过滤与动态切换 (
trace-graph.js&index.html):- 默认过滤:图谱默认排除所有
isRemoved节点与连线,确保全景拓扑与当前真实在箱状态 1:1 精确对齐; - 顶部交互开关:顶部工具栏自动根据是否存在历史已拆除节点,动态呈现红白相间的“显示已拆除历史 (N)”复选框;
- 虚线红字醒目标注:勾选开启后,已拆除连线渲染为红色虚线(dash 4, 4)并在连线胶囊中绘制红字“已拆除”,已拆除节点呈现浅粉背景(#fff5f5)与红色虚线外框,全面满足审计回溯诉求。
- 默认过滤:图谱默认排除所有
- 实时在箱关系基准校验与历史移出标记 (
[fix/feature] UDI 追溯包装层级统一规范重构与拆装箱全程记录接入 (Pages/UDI_ZS.cs)
- 涉及文件:
UmiUDI&Drug/Pages/UDI_ZS.csUmiUDI&Drug/docs/CHANGELOG.mdUmiUDI&Drug/docs/DEVLOG.md
- 问题反馈与背景:
- 用户反馈 UDI 追溯界面的【包装条码明细与关联记录】表格中,包装层级硬编码为“子包装 / 内含物”、“当前包装码”、“关联包装”,未遵循系统统一规范;且表格中未显示具体的拆装箱操作动作(装包、移出包装等历史流转)。
- 重构与优化内容:
- 包装层级统一规范接入:
- 彻底废除原硬编码字符串,全面接入系统权威基准
PackageLevelHelper.GetPackagingLevelName(db, di)与拓扑拓扑兜底判定; - 准确显示各级条码的规范包装层级(如“二级”、“一级”、“最小单元”、“三级”等),并针对当前被追溯条码清晰标注为“二级 (当前)”或对应级别。
- 彻底废除原硬编码字符串,全面接入系统权威基准
- 拆装箱操作全程追溯与明细呈现:
- 表格新增“拆装箱操作”(
pkg_action) 列,区域标题明确优化为“包装明细与拆装箱记录”; - 全量联合
udi_package_review追溯审计表与udi_package、udi_dy_detail,将发生过的装包、移出包装、整包拆解、调换等拆装箱历史记录完整归集并按时间倒序展示; - 解决移出包装后历史被抹除的问题,使拆箱、装箱全流程透明可追溯;点击条码或“穿透追溯”仍可无缝穿透。
- 表格新增“拆装箱操作”(
- 包装层级统一规范接入:
[docs/release] 生产环境用户日志编写规范确立、历史日志纯业务净化与 v1.2.1.26 重新发布
- 涉及文件:
UmiUDI&Drug/docs/CHANGELOG.mdUmiUDI-Update/docs/CHANGELOG.mdUmiUDI-Update/update.jsonUmiUDI&Drug/docs/DEVLOG.md
- 红线规范确立(全体人员强制遵守):
- 禁止出现与实际业务变动无关的内容:内部技术重构、排查步骤、中间件封装等无业务价值内容一律不向用户展示。
- 禁止出现代码与数据库变动相关内容:坚决禁止在面向用户的日志中出现任何文件名、类名、方法名、异常名、数据库表名(如
di_devicepackage、udi_scd等)、字段名、SQL 语句或技术术语。 - 只允许显示直接影响用户操作的精简日志:
- 必须纯立足于一线操作员、质检员与仓管员使用视角;
- 仅保留直接改变用户操作方式、交互视觉、声光防呆提醒、合规阻断卡点的核心条目(每版本精简为 1~4 条);
- 凡不直接影响用户日常操作的底层稳定性与内部机制优化,一律不得向用户展示。
- 原详尽日志保留于开发技术归档区:历史全量清单与技术排查细节统一保存在
### 开发环境(完整原日志与技术变更详情)中,供研发回溯,杜绝被前端弹窗读取展示。
- 历史版本(1.2.1.26 / 1.2.1.25 / 1.2.1.23)净化与归档落地:
- v1.2.1.26:移除了全部数据库表名
di_devicepackage与di_download_devicepackage,提炼为面向用户的【多包装规格自动识别】与【不同位数条码通用识别】。 - v1.2.1.25:将 5 条压缩保留为直接影响用户操作的 3 条核心业务:【操作提示与声光防呆全面升级】、【条码枪连续扫码体验优化】与【首检与条码打印联动优化】,非操作性内部稳定性调整归档至开发环境。
- v1.2.1.23:将原 51 条全量清单完整保留归档至开发环境技术节,生产环境仅展示直接影响用户操作与业务合规的 5 大核心项(多级包装规范与装量换算、手工组包防混装拦截、批次产品免序列号折算、工单排产与标签打印合规联动、装箱与出库防错校验)。
- v1.2.1.26:移除了全部数据库表名
- v1.2.1.26 重新发布:
- 重新编译
UmiUDI.csproj,同步最新二进制组件至UmiUDI-Update; - 重新遍历并更新
update.json中docs/CHANGELOG.md及核心文件 MD5 哈希; - 提交并推送到 Gitee 镜像仓库,完成热更新正式生效。
- 重新编译
[fix] PDA 入库“入库单保存失败”根因彻底修复、字段映射修正与条码批号双保险(v1.3.4 / API)
- 涉及文件:
UmiPDA - API/Models/udi_scd_detail.csUmiPDA - API/Models/umi_basicContext.csUmiPDA - API/Services/Implementations/InboundService.csUmiPDA/pages/inbound/index.vueUmiPDA/manifest.jsonUmiPDA/package.json
- 故障排查与根因分析(500 级联崩溃链路):
- 数据库字段与实体映射错位:
- 用户在 PDA“入库管理”选择工单
SCRWD2026082800001并扫码提交时,前端 Toast 提示“入库单保存失败”; - 调取后端日志及复现线上接口
GET /app/scd/detailByScdh?scdh=SCRWD2026082800001,抛出 HTTP 500:Unknown column 'scd_detail_bz' in 'field list'; - 经核查 MySQL 生产表
udi_scd_detail,该表包装等级字段名为scd_detail_bzdj,根本不存在scd_detail_bz(备注位于主表udi_scd的scd_bz); - 但在
UmiPDA - API/Models/udi_scd_detail.cs与 EFumi_basicContext.cs中误写为scd_detail_bz,导致 SqlSugar 在生成全字段 SQL 时直接触发 MySQL 字段不存在异常。
- 用户在 PDA“入库管理”选择工单
- 连锁级联崩溃机制:
- PDA 前端选定工单时调用
GetScdDetail获取明细失败,进入 catch 块导致表单批号formData.ph未能获取(为空); - 工人点击“提交入库”时,
_ck_Inout.ph为空,后端InboundService.AddInbound试图通过工单号从udi_scd_detail自动补全批号; - 补全反查全字段再次触发
Unknown column 'scd_detail_bz'致命崩溃,事务回滚,AddInbound返回 500; - 前端
saveInboundOrder()将真实报错静默吞没并return false,外层直接抛出笼统的throw new Error('入库单保存失败')。
- PDA 前端选定工单时调用
- 数据库字段与实体映射错位:
- 修复方案与双保险落地:
- 后端实体字段精准对齐:
- 将
udi_scd_detail.cs与umi_basicContext.cs中的scd_detail_bz全面修正为真实存在的scd_detail_bzdj; - 重构
InboundService.cs中的批号反查查询,明确使用.Select(it => it.scd_detail_ph)仅投射批号字段,并加入try-catch容错守卫,坚决杜绝因工单明细异常阻断入库单保存事务。
- 将
- 前端扫码条码 AI(10) 批号自动提取兜底:
- 在
UmiPDA/pages/inbound/index.vue的addScanItemWithSerial与addNewNonSerialItem中,当检测到表单未绑定批号时,自动将扫码解析出的 UDI 批号(udi_dy_detail_10)反向注入表单与工单上下文; - 在
saveInboundOrder提交时建立 5 级智能批号兜底机制(表单批号 -> 工单详情批号 -> 工单主表批号 -> 扫描结果批号 -> 扫码记录批号); - 重构保存流程,透传后端真实返回的
response.message,彻底消除错误吞没,让操作员与运维能秒级洞悉真实问题。
- 在
- 编译与自动化流水线交付:
- 后端 API:执行
dotnet publish umiapi.csproj -c Release -o publish成功输出最新发布包; - 前端移动端:版本递增至
1.3.4(versionCode: 134),推送 Tagv1.3.4与pda-v1.3.4,自托管 Runner 自动完成编译、WGT 打包并同步至 Gitee 热更新镜像。
- 后端 API:执行
- 后端实体字段精准对齐:
[fix] PDA 移动端包装关联层级变量名污染修复与热更新发布(v1.3.3)
- 涉及文件:
UmiPDA/pages/searchpackage/index.vueUmiPDA/manifest.jsonUmiPDA/package.json
- 变更说明:
- 消除前端树深度覆盖包装层级 Bug:
- 在
flattenTree扁平化树形数据时,原代码将树的缩进深度整数(0, 1, 2)直接塞入level属性,导致第 3 行(深度 2)的row.level变成了整数2; - 触发了
getNodeLevelName中rawLevel === '2' -> return '二级'的错误匹配,使最底层的“最小单元”单品被误判显示为【二级】; - 将缩进深度属性重命名为
treeDepth: depth,杜绝变量名遮蔽,彻底恢复末级单品真实展示为【最小单元】。
- 在
- 自动化流水线发布:
- 版本递增至
1.3.3(versionCode: 133),推送 Tagv1.3.3; - 自托管 Runner
D:\actions-runner-pda于 16:17~16:19 完成自动化打包并成功推送到 GiteeUmiUDI-Update/pda/镜像(Commit:2164da4)。
- 版本递增至
- 消除前端树深度覆盖包装层级 Bug:
[ci/docs] PDA 移动端自动化流水线架构、双轨发布机制与全流程 SOP
- 涉及文件:
UmiPDA/.github/workflows/release.yml(PDA 独立仓库构建工作流)UmiUDI&Drug/.github/workflows/pda-release.yml(主仓库 PDA 调度工作流)UmiPDA/publish.ps1(本地应急一键构建脚本)D:\actions-runner-pda(PDA 专属自托管 Runner 节点)UmiUDI-Update/pda/(Gitee 国内热更新分发镜像目录)
- 架构与实操说明:
- PDA 专属自托管 Runner 隔离保障:
- PDA 移动端构建配置了专用的自托管 Runner:
D:\actions-runner-pda(标签[self-hosted, Windows, X64, pda]),与 PC 桌面端的D:\actions-runner实行物理隔离,保障 Android WGT 编译与 PC Inno Setup 打包互不争抢资源。
- PDA 移动端构建配置了专用的自托管 Runner:
- 自动化 CI/CD 流水线完整执行链路(实测用时约 1 分 40 秒):
- 触发机制:
UmiPDA独立仓库监听push: tags: 'v*'或手动workflow_dispatch;UmiUDI&Drug主工程监听push: tags: 'pda-v*'或手动workflow_dispatch。
- 步骤 1:版本与更新日志准备(Prepare Version Info):
- 自动从 Tag 剥离提取版本号(如
v1.3.2->1.3.2),组装更新说明。
- 自动从 Tag 剥离提取版本号(如
- 步骤 2:元数据无损注入(Update Manifest and Package Versions):
- 使用无 BOM UTF-8 编码将版本号同步写入
manifest.json(versionName: 1.3.2,versionCode: 132)与package.json(version: 1.3.2),避免格式污染。
- 使用无 BOM UTF-8 编码将版本号同步写入
- 步骤 3:Uni-App 5.24 离线编译器构建(Build App Resources):
- 依托本地 Node 缓存与
@dcloudio/vite-plugin-uni/bin/uni.js build -p app-android执行极速编译,生成 Android App 前端资源包至dist/build/app/。
- 依托本地 Node 缓存与
- 步骤 4:WGT 差量打包与元数据校验(Package WGT and Generate Update Meta):
- 将构建输出压缩为
update.wgt并生成专属 AppID 包__UNI__F2B26AB.wgt; - 动态生成标准
pda_update.json元数据文件,包含版本号、代码、下载地址、发布时间戳与更新日志。
- 将构建输出压缩为
- 步骤 5:GitHub Release 资产自动归档(Create GitHub Release):
- 自动创建 GitHub Release 并上传
update.wgt、__UNI__F2B26AB.wgt及pda_update.json。
- 自动创建 GitHub Release 并上传
- 步骤 6:Gitee 国内分发镜像秒级强同步(Sync PDA WGT to Gitee Update Repository):
- 流水线克隆
UmiUDI-Update,将 WGT 与pda_update.json写入pda/目录; - 自动提交并执行
git push origin master,实现国内车间现场手持机零延迟检测并热更新。
- 流水线克隆
- 触发机制:
- 运行实证(2026-09-05 15:04~15:06 生产发布记录):
- Runner 日志:
D:\actions-runner-pda\_diag\Worker_20260905-070427-utc.log成功执行 Jobbuild-and-release(Refs:refs/tags/v1.3.2); - Gitee 提交:Commit
31a2ca4ec02ddbd92d70658d293c74991a75fc99(说明:Sync PDA v1.3.2 WGT to Gitee (Self-Hosted)),已完整交付update.wgt(601KB) 与更新清单。
- Runner 日志:
- 三端发布与职责边界明确化:
- PC 桌面客户端 (WinForms / .NET 9):代码在
UmiUDI&Drug/,推送v*(如v1.2.1.26)触发D:\actions-runner,打包 Inno Setup 安装包与增量哈希补丁,发布至 Gitee 根目录。 - PDA 移动端前端 (Vue 3 / Uni-App):代码在
UmiPDA/,推送v*(如v1.3.2)触发D:\actions-runner-pda,编译打包 WGT 热更新包,发布至 Giteepda/目录。 - PDA 服务端 API (
UmiPDA - API):代码在UmiPDA - API/(ASP.NET Core),由开发人员执行dotnet publish umiapi.csproj -c Release -o publish生成独立可执行文件与 DLL 包,发布至生产服务器 IIS/Kestrel 运行。 - 注:当仅修改 C# 后端 API 逻辑(如数据表查询策略、接口容差等)时,无需重新打包 PDA 前端,避免终端设备频繁收到无界面变更的强制重启提示。
- PC 桌面客户端 (WinForms / .NET 9):代码在
- 双轨发布 SOP(自动化流水线 + 应急本地一键脚本):
- 标准流程(全自动流水线):bash
cd e:\backup\UmiUDI&Drug\UmiPDA git add -A && git commit -m "feat: xxx" git push origin main git tag v1.3.3 && git push origin v1.3.3 # 观察 D:\actions-runner-pda 自动执行并在 2 分钟内完成 Gitee 同步 - 应急/离线兜底流程(本地一键脚本):powershell
cd e:\backup\UmiUDI&Drug\UmiPDA powershell -ExecutionPolicy Bypass -File .\publish.ps1 # 脚本自动完成 Uni-App 编译、WGT 打包并写入 e:\backup\UmiUDI&Drug\UmiUDI-Update\pda\ cd e:\backup\UmiUDI&Drug\UmiUDI-Update git add pda/ && git commit -m "update: pda v1.3.3 emergency release" && git push origin master
- 标准流程(全自动流水线):
- PDA 专属自托管 Runner 隔离保障:
[fix] 包装规格表 di_devicepackage 与 di_download_devicepackage 双表联合穿透与前导零容差(PC v1.2.1.26 / PDA API)
- 涉及文件:
UmiUDI&Drug/Core/PackageLevelHelper.csUmiPDA - API/Services/Implementations/PackageService.csUmiUDI&Drug/Properties/AssemblyInfo.csUmiUDI&Drug/UmiUDI.csproj
- 变更说明:
- 双表(自定义维护表 + 药监下载表)联合穿透:
- 包装数据在实际生产环境中可能录入在
di_devicepackage(企业自主维护包装),也可能同步在di_download_devicepackage(药监局数据库下行包装)。 - PC 端
PackageLevelHelper.cs(GetDiPackagingMultiplier、GetDiPackagingLevelRank、GetMinimalUnitDi)与 PDA 端PackageService.cs(GetTopPackage、FillNodeInfo、SearchPackageTree、ResolveBatchUdiForDiAsync)全面统一采用“先查di_devicepackage,若空则降级穿透查di_download_devicepackage”的双表互补策略,确保无论包装数据存在于哪张表均可 100% 准确定位。
- 包装数据在实际生产环境中可能录入在
- 条码前导 0 智能容差归一化(13位 / 14位 GTIN):
- 针对条码枪扫码可能带前导 0(14 位 GTIN 如
0697...)或未带前导 0(13 位如697...)的数据差异,查询包装表时自动同时匹配targetDi、带前导0版本与去除前导0版本(OR BZCPBS = @diPadded OR BZCPBS = @diTrimmed),杜绝因前导0差异导致的“未查询到包装规格”拦截。
- 针对条码枪扫码可能带前导 0(14 位 GTIN 如
- 版本发布:
- PC 客户端版本递增至
1.2.1.26,通过自动化流水线完成全量安装包与增量补丁发布并同步至 Gitee; - PDA 后端 API 完成二进制编译并输出至
publish/目录。
- PC 客户端版本递增至
- 双表(自定义维护表 + 药监下载表)联合穿透:
[feat/refactor] 全面弃用 Message,直接升级使用 AntdUI.Notification 并落地声光防呆与交互闭环(v1.2.1.24)
- 涉及文件:
Pages/UDI_DY.cs,Pages/UDI_DY_List.csPages/CK_OUT.cs,Pages/CK_OUT_List.csPages/CK_IN.cs,Pages/CK_IN_List.csPages/UDI_SMGL.csPages/UDI_SJ.cs,Pages/UDI_SJ_List.csPages/UDI_SCD.cs,Pages/UDI_SCD_List.csPages/UDI_ZJ.cs,Pages/UDI_ZJ_List.csPages/UDI_XSD.cs,Pages/UDI_XSD_List.csPages/UDI_GLCX2.csPages/UDI_CJ.cs,Pages/UDI_CJ_List.cs,Pages/UDI_CDY.cs,Pages/UDI_CDY_List.cs,Pages/UDI_BZGL.cs,Pages/UDI_JX.cs,Pages/UDI_BBSJ.cs,Pages/UDI_BQSJ.csProperties/AssemblyInfo.cs
- 变更说明:
- 去冗余封装,直接调用原生 Notification:彻底废止并删除
Utils/Notice.cs包装器,所有业务模块直接原生就地调用AntdUI.Notification,保持架构简洁透明。 - 4 状态专属差异化背景色定制:通过底层样式控制
AntdUI.Style.Set(AntdUI.Colour.BgElevated, ..., "Notification"),实现不同状态拥有高辨识度底色(警告/首检淡黄#FFFBE6、错误/拦截淡红#FFF2F0、成功淡绿#F6FFED、常规淡蓝#E6F7FF),保留Message.loading作为异步等待动画。 - 车间流水线盲扫声音防呆联动(优化 3):在首检拦截、打印拦截、过期拦截、近效期预警、散件防呆、扫码重码与越级等关键分支,全面接入
System.Media.SystemSounds.Hand.Play()与SystemSounds.Exclamation.Play(),实现声光双重防呆。 - 条码枪焦点自动回正与锁控(优化 4):在扫码包装关联、首检、质检、关联查询界面,扫码完成后与异常拦截后自动全选并强制重获焦点(
ResetUdiFocus()),确保车间工人连续扫枪作业不中断。 - 打印单首检状态联动自动刷新(优化 5):在
UDI_DY.cs中重写OnVisibleChanged,当工人从首检单保存切回打印单 Tab 时,系统静默重新拉取数据库最新合格记录,实时点亮右下角打印按钮与顶部绿标【已首检】,形成无缝业务闭环。 - 多 TabPage 切换与异步生命周期安全守卫(优化 6):增加
if (this.IsDisposed || !this.IsHandleCreated) return;守卫,窗体获取升级为四级安全降级(form ?? FindForm() ?? Mian),杜绝切换 Tab 导致的空引用崩溃。 - 版本同步升级:PC 客户端版本递增至
1.2.1.24。
- 去冗余封装,直接调用原生 Notification:彻底废止并删除
[fix] PDA移动端包装服务出库拦截、层级流水强同步与效期解析规范加固
- 涉及文件:
UmiPDA - API/Services/Implementations/PackageService.csCore/AiAgent/Manufacturing/ShelfLifeHelper.cs
- 变更说明:
- PDA 包装业务出库校验全线生效:
- 在
PackageService.cs中,将拆包(UnpackAsync)、移出(RemoveChildAsync)、整包拆解(UnpackContentsAsync)、单件装入(AddChildAsync)与条码替换(ReplacePackageAsync)5 处出库判断,由无效的type == "2"统一更正为(it.type == "-1" || it.type == "2") && it.status == "1",杜绝已出库商品被非法拆解和调换; - 在
AddChildAsync中补全目标父箱出库校验拦截;在ReplacePackageAsync中补全原条码与目标父箱出库校验拦截;在AssociatePackageBatch中补齐外箱出库校验。
- 在
- PDA 包装作业联动仓库流水强同步:
- 在拆解、移出、装入、替换、批量组包等全部操作的事务处理中,实时更新
ck_inout_record.udi_parent,确保移动端现场扫码操作与 PC 端在库台账和整箱出库明细强一致。
- 在拆解、移出、装入、替换、批量组包等全部操作的事务处理中,实时更新
- PDA 条码替换在库状态防混:
- 在
ReplacePackageAsync中增加在库状态研判:若目标外箱已在库,严禁将未办理入库手续的条码直接替换装入,杜绝“在库外箱包含未入库单品”的账实不符隐患。
- 在
- 工单效期引擎 GS1 6位日期原生支持:
- 在
ShelfLifeHelper.cs的supportedDateFormats中增加"yyMMdd"格式,原生支持 GS1 AI(17) 紧凑效期解析。
- 在
- 移动端条码拓扑树向上寻顶:
- 在
PackageService.cs的SearchPackageTree中针对序列号产品增加向上溯源根包装逻辑,扫描任意单件或中包条码均可展示完整整箱包装树,根除单节点孤岛显示缺陷。
- 在
- 批次产品总量折算修复:
- 在
GetTotalCount中支持批次管理产品通过PackageLevelHelper.GetDiPackagingMultiplierAsync换算比例,根除批次产品接口恒定返回 0 缺陷。
- 在
- 顶层包装穿透反查与多级容错:
- 在
GetTopPackage中增加批次管理产品的di_devicepackage顶层穿透,并强化序列号条码\u001d分隔符容错与打印任务明细兜底。
- 在
- 首枪扫码即时防呆与 GS1 格式兼容:
- 在
ValidatePackageScan单码校验中补充即时出库状态审核,首枪拦截已出库条码;在FillNodeInfo中采用PackageLevelHelper.ExtractDi全面支持带括号(01)格式条码解析。
- 在
- GS1 生产批号 (AI 10) 工业级解析引擎:
- 在
PackageLevelHelper.cs中新增ExtractBatchNo,接入UDIZjEvaluator.ParseUdiGS1 解析引擎并辅以标准括号与 FNC1 正则兜底; - 在
PackageService.cs的FillNodeInfo与ResolveBatchUdiForDiAsync中统一替换旧的cleanUdi.IndexOf("10")与脆弱正则,彻底根除批号截断带右括号)污染与 DI/月份含 10 引起的假阳性误判。
- 在
- 包装容器与单品判别规范化:
- 在
PackageService.cs的FillNodeInfo中重构容器判定逻辑,移出一级包装(中盒)和ditype == "1"误判为单品的逻辑,补齐“最小单元”判别,确保未维护关系时中盒能正确被识别为包装容器。
- 在
- 工单包装任务过滤层级对齐:
- 彻底重写
PackageService.cs的GetDysByScdAndLevel,修正将 0 误判为“一级”、1 误判为“二级”的 Off-By-One 错位,规范映射 0 为最小单元、1 为一级、2 为二级,解决 PDA 移动端按“最小单元”拉取任务查空的问题。
- 彻底重写
- 单件装包父级单品拦截强化:
- 在
AddPackageOrProduct中补齐parentDy.udi_dy_bzcj == "最小单元"判定,严禁将标记为最小单元的单品作为父级外箱装包。
- 在
- 扫码枪末尾回车换行符清洗:
- 在双端
UDIZjEvaluator.cs的ParseUdi入口与分段提取中增加\r\n自动清洗,解决硬件扫码枪附加换行符导致的字符集不合法判断(ASCII < 32)与解析返回 null 隐患。
- 在双端
- PC 端出入库与数据查询多级容错(FNC1/括号/平铺):
- 在
PackageLevelHelper.cs中实现FindUdiDetail智能定位引擎,在CK_OUT.cs、CK_IN.cs、UDI_SJ.cs、UDI_GLCX2.cs等核心模块中全面替换严格等于查询,彻底解决条码枪丢失\u001d或扫入带括号 HRI 格式导致的未注册假报错。
- 在
- 移动端批量组包批号一致性强校验(严禁混批):
- 在
PackageService.AssociatePackageBatch中提取所有待组包子条码的批号,增加“多子件批号一致性”与“子件外箱批号一致性”双重拦截,杜绝车间多扫混装造成混批 GSP 事故。
- 在
- 批次号产品禁止手动包装管理与拆装箱友好拦截:
- 在
PackageService.cs的ValidatePackageScan、AssociatePackageBatch、AddPackageOrProduct、UnbindPackage、SwapPackageProduct中全面拦截批次管理产品(无序列号),返回清晰专业的引导提示(批次产品由系统按生产单包装比例自动管理装量,无需手动包装,直接出入库);在 PC 端UDI_BZGL.cs中增加同向友好提示。
- 在
- GS1 月度失效期规则 (YYMM00) 安全解析:
- 在
PackageLevelHelper.cs中新增ParseGs1Date,兼容处理 GS1 AI(17) 中以00结尾表示当月最后一日的特殊规则,并在Printer.cs与UVPrinter.cs中替换DateTime.ParseExact,根除打印转换抛出FormatException异常闪退。
- 在
- 出入库条码库存查询容差增强(括号/平铺智能归一):
- 在 PC 端
CK_OUT.cs与CK_IN.cs的GetStockCount中引入括号自动剥离与键名归一化容差,解决扫入带括号条码(如(01)...)时因缓存 Key 格式差异被误判为“无库存”阻断出库的缺陷。
- 在 PC 端
- PDA 出库单保存 GS1 月末效期 (YYMM00) 容错与防崩溃:
- 在 PDA 后端服务
OutboundService.cs中全面集成PackageLevelHelper.ParseGs1Date,遇到260900等月末效期时自动解析为当月最后一天,杜绝DateTime.TryParseExact转换失败导致空引用异常(500 报错)闪退。
- 在 PDA 后端服务
- 批次管理产品跨包装层级库存折算:
- 在出库库存核验中支持批次管理产品通过
PackageLevelHelper.GetDiPackagingMultiplier进行装量倍率折算,畅通“整箱入库、散件出库”与“散件入库、整箱出库”仓储流程,避免误判无库存。
- 在出库库存核验中支持批次管理产品通过
- AI(21) 序列号 20 位上限强校验拦截:
- 在 PC 客户端序列号生成器
ChangYongFangFa.cs与扫码管理UDI_SMGL.cs中增加序列号总长度校验(前缀+流水位数+后缀 <= 20),杜绝超出 GS1 国际标准(20位)导致的标签打印后下游扫码质检解析违规。
- 在 PC 客户端序列号生成器
- MRP 智能排产失效日期算头算尾合规统一:
- 将
MrpSmartScheduler.cs中的建议失效日期推算公式统一对齐为today.AddMonths(bzq).AddDays(-1),与系统工单及药监 GMP 审计标准保持 100% 吻合。
- 将
- 批次产品打印整批标签与自动完结联动(
UDI_DY.cs):- 针对批次管理产品在
udi_dy_detail中仅存单条模板数据的特性,在button2_Click(打印所有)中自动计算待打印份数scsl - printcount并提示确认;在UpdatePrintingBusinessStatus中修正状态更新条件,确保累计打印张数达到工单计划数量后才置为“已完成”。
- 针对批次管理产品在
- 销售出库外箱扫码穿透与订单多级装量核验(
CK_OUT.cs):- 在销售出库明细匹配中引入
PackageLevelHelper.GetMinimalUnitDi反向穿透提取母品最小单元 DI,使外箱条码能够准确命中销售单明细;并将订单限量核验由单箱数量改为折算后的最小单元数量minUnitCount。
- 在销售出库明细匹配中引入
- 扫码组包车间尾箱封箱产码机制(
UDI_SMGL.cs):- 新增尾箱强制封箱处理逻辑与操作入口,当已扫件数大于0且小于整箱比例时,经操作工确认即可生成合法外箱码并写入
udi_package父子包装关系。
- 新增尾箱强制封箱处理逻辑与操作入口,当已扫件数大于0且小于整箱比例时,经操作工确认即可生成合法外箱码并写入
- 扫码组包多工位并发外箱序列号排他防重锁(
UDI_SMGL.cs):- 在外箱序列号生成(
udi_sn)中加入数据库事务排他锁机制,防止多工位并发装箱发号冲突与条码碰撞。
- 在外箱序列号生成(
- PDA 出库接口非工单 UDI 空引用防护与基础信息回填(
OutboundService.cs):- 在
OutboundService.cs的单据生成与更新循环中增加udi_Dy == null安全降级,通过PackageLevelHelper.GetMinimalUnitDi穿透获取母品最小单元 DI,从产品主档表(di/di_download)提取品名(CPMCTYMC/SPMC)与规格型号(GGXH),消除未捕获的NullReferenceException。
- 在
- 包装管理自定义比例模式批次产品安全拦截闭环(
UDI_BZGL.cs):- 将批次产品拦截统一提升至
OnScannerDataReceived顶层及工单选择事件receiveDy,彻底封堵勾选自定义比例后批次产品仍能组包的业务漏洞。
- 将批次产品拦截统一提升至
- 生产入库外箱码穿透与母品工单智能放行(
CK_IN.cs):- 引入
PackageLevelHelper.GetMinimalUnitDi双向穿透比对扫码 DI 与生产单 DI,无论工单是以最小销售单元还是包装码下达,均能智能穿透命中并放行外箱入库,彻底解决车间无法整箱入库的死锁。
- 引入
- 出库内码
entryid毫秒级精度防重加固(CK_OUT.cs):- 将 6 处出库内码生成函数由
yyMMddHHmmss统一升级为yyMMddHHmmssfff,与入库端完全对齐,彻底杜绝车间高频连续扫码同秒内主键冲突与数据覆盖。
- 将 6 处出库内码生成函数由
- 包装关联拓扑序列号判断标准规范化(
UDI_GLCX2.cs):- 全面使用
PackageLevelHelper.IsBatchUdi(udi)替换原始的!udi.Contains("\u001d"),全面兼容 GS1 带括号标准条码格式(如(01)...(21)...),准确拦截真正的批次管理产品并给出友好提示。
- 全面使用
- PDA 库存汇总外箱与非工单条码品名穿透回填(
CkInoutDetailService.cs):- 在
GetInoutDetailsGroup接口中,当udi_dy查空时,通过PackageLevelHelper.GetMinimalUnitDi穿透反查母品主档表di/di_download,自动回填品名与规格型号,解决 PDA 库存汇总列表字段空白。
- 在
- 普通/退货入库模式外箱扫码数量校验闭环(
CK_IN.cs):- 在
ValidatePendingInboundState中加入外箱包装场景研判,放行展开单品总数(detailTotal)与扫码箱数(tempTotal)的天然倍率差,仅校验扫码总行数与流水记录数一致性(tempTotal == recordTotal),畅通非生产入库扫箱流程。
- 在
- 打印预览 GS1 月末效期 (YYMM00) 异常防崩(
UDI_Preview.cs):- 在
UDI_Preview.cs的生产日期、失效日期与灭菌日期格式化中,将原DateTime.ParseExact统一升级为PackageLevelHelper.ParseGs1Date,全面支持 GS1 规则下以00结尾的月度失效期(自动解析为当月末日),根除预览界面抛出FormatException闪退崩溃缺陷。
- 在
- 出入库单据效期转换与主档关联统一(
CK_OUT.cs/CK_IN.cs):- 在 PC 客户端销售出库与生产入库保存时,将日期转换统一对齐为
PackageLevelHelper.ParseGs1Date,消除手工拼串无法解析YYMM00导致效期置空而失去主档精确匹配的隐患。
- 在 PC 客户端销售出库与生产入库保存时,将日期转换统一对齐为
- 车间扫码关联批次产品全流程防呆拦截(
UDI_SMGL.cs):- 在选生产单(
receiveScd)、选打印任务(receiveDy)以及扫码接收入口(OnScannerDataReceived)全面补齐批次管理产品(无序列号)的友好拦截与清晰指引,根除因条码相同报“该UDI码已扫描”卡死,并杜绝生成重复无序子节点的脏数据。
- 在选生产单(
- 车间扫码关联 GS1 效期转换防闪退与格式容错(
UDI_SMGL.cs):- 将
DoPackageOuterBox中 8 处直接使用Convert.ToDateTime解析效期的逻辑统一升级为PackageLevelHelper.ParseGs1Date,遇到YYMM00月末效期时自动安全解析为当月最后一天,杜绝抛出FormatException闪退;同时在条码匹配比对中增加去除\u001d的容错。
- 将
- 打印任务界面新增“月末效期 (YYMM00)”标准 GS1 标签生成(
UDI_DY.cs/UDI_DY.Designer.cs/ChangYongFangFa.cs):- 在失效日期旁新增
月末效期(00)选项开关。勾选后,系统在生成条码数据时自动将 AI(17) 格式化为 GS1 医疗器械与药品标准的yyMM00(如260900),并在任务主表保存为yyyy-MM-00,使系统不仅能解析月末效期,更能合规生成并打印月末效期标签。
- 在失效日期旁新增
- 生产入库工单计划数单位换算智能识别(
CK_IN.cs):- 在
ValidateQuantityLimit中结合工单主 DI 的包装装量倍率进行智能换算。当工单以“箱”为单位下达(如 10 箱),而扫码入库按最小单元展开(如 1000 件)时,系统自动识别换算关系,彻底解决箱单位与件单位冲突导致的“超工单计划入库”误报拦截。
- 在
- 批次整箱出库防开箱残箱作业防呆与根节点批量修复脚本(
CK_OUT.cs/PackageRootRepairHelper.cs/repair_package_root.sql):- 在销售出库扫整箱时,若检测到该批次曾发生过散件出库,即刻弹出黄色预警提示核对箱体封条完整性,杜绝现场将已拆开的零头残箱当做整箱扫码发货;同时新增
PackageRootRepairHelper.cs与 SQL 运维脚本,支持在维护窗口一键批量回填历史udi_package.root根节点。
- 在销售出库扫整箱时,若检测到该批次曾发生过散件出库,即刻弹出黄色预警提示核对箱体封条完整性,杜绝现场将已拆开的零头残箱当做整箱扫码发货;同时新增
- PDA 包装业务出库校验全线生效:
[feat] 包装层级体系与关联拓扑查询引擎重构
- 涉及文件:
Core/PackageLevelHelper.csPages/UDI_GLCX2.csPages/UDI_GLCX.cs(已彻底淘汰下线)Pages/UDI_GLCX.Designer.cs(已彻底淘汰下线)Pages/UDI_GLCX.resx(已彻底淘汰下线)Forms/UDI_GLCX_Add.csForms/UDI_GLCX_Exchange.csForms/DI_Select.cs
- 变更说明:
- PackageLevelHelper.cs 包装权威辅助类重构:
- 新增并完善
GetDiPackagingMultiplier:递归级联计算完整包装乘积(1:2:8:200); - 新增
GetDiPackagingLevelRank:基于数据库包装树结构递归识别层级深度(1:一级, 2:二级, 3:三级); - 新增
GetPackagingLevelName:统一规范包装层级名称,严格无“包装”后缀(如“一级”、“二级”),杜绝文字歧义; - 新增
IsBatchUdi:基于 GS1 规则判定无\u001d且无(21)的批次管理条码; - 新增
GetMinimalUnitDi:从任意包装 DI 反向递归穿透锁定对应的根节点最小销售单元 DI。
- 新增并完善
- 包装拓扑树与关联管理升级(UDI_GLCX2.cs):
- 彻底删除废弃的旧版
UDI_GLCX.cs及其设计器资源文件,全面迁移至UDI_GLCX2.cs; - 重构包装树生成逻辑(
BuildHierarchyMap与ResolveNodeLevel),结合拓扑结构与辅助类智能研判根节点与子节点级别; - 增加批次管理产品的自动装量展开与友好提示,修复树节点收缩展开时的死锁隐患。
- 彻底删除废弃的旧版
- 包装跨级拦截与弹窗渲染(UDI_GLCX_Add.cs / UDI_GLCX_Exchange.cs / DI_Select.cs):
- 在手工打包关联时引入跨级检测:三级外箱禁止直接装入单品/最小单元,强制要求装入二级中包装;
- 弹窗与选择框(
DI_Select.cs)全量接入PackageLevelHelper规范名称与多级装量提示。
- PackageLevelHelper.cs 包装权威辅助类重构:
[fix] 智能仓储出入库包装比例穿透与扫码防崩溃优化
- 涉及文件:
Pages/CK_IN.csPages/CK_OUT.csPages/CK_ALL.csForms/NumForm.Designer.cs
- 变更说明:
- 批次管理产品 DI 装量直接换算:
- 在入库(
CK_IN.cs)、出库(CK_OUT.cs)及库存查询(CK_ALL.cs)的GetTotalCount、GetMinUnitCount与HasParent中引入PackageLevelHelper.IsBatchUdi检测; - 批次管理产品跳过按物理序列号追溯父级包装的拦截,直接通过
di_devicepackage/di_download_devicepackage提取装量倍率进行批量折算入出库。
- 在入库(
- 扫码高并发与空子集安全防护:
- 修复
udi_Dy_Detail_Child空列表时直接访问[0]抛出IndexOutOfRangeException的致命缺陷,增加targetChild安全降级回填; - 将产品码数量录入弹窗
NumForm改为严格的跨线程安全Invoke机制,增加using资源释放与_isProcessingScan扫码防重锁。
- 修复
- 批次管理产品 DI 装量直接换算:
[fix] 生产工单主档反查与母品通用名保护
- 涉及文件:
Pages/UDI_SCD.cs - 变更说明: 修复生产工单(
UDI_SCD.cs)在绑定非最小单元包装 DI 时,由于scd_di为包装码而在di主表中查不到对应记录,导致工单列表与打印单关联中产品名称显示为空或“1”的底层缺陷。通过引入PackageLevelHelper.GetMinimalUnitDi(db, item.scd_di)反查真实母品 DI,确保finalCpmc100% 准确显示法定通用名称。
[feat] AI Agent MRP 包装树递归展开引擎
- 涉及文件:
Core/AiAgent/Manufacturing/MrpPackagingTreeEngine.cs - 变更说明: 重构多级包装递归计算引擎,支持 1:2:8:200 多级包装 BOM 树完整构建、倍率级联乘积展开与包装节点汇总;为工单自动排产提供精准的基础装量换算与原料需求分解服务。
[fix] AI 业务助手排产排程、多轮包装层级消歧与批次效期全链路加固
- 涉及文件:
Core/AiAgent/Plugins/WorkOrderPlugin.csCore/AiAgent/Cognitive/UserIntentExtractor.csCore/AiAgent/Services/ProductionOrderService.csCore/AiAgent/Services/IProductionOrderService.csCore/AiAgent/Manufacturing/ShelfLifeHelper.csCore/AiAgent/Models/ActionCardFactory.csCore/AiAgent/AiKernelManager.csForms/AiCopilotControl.cs
- 变更说明: 全面解决 AI Copilot 在医疗器械生产建单(
CreateProductionOrderAsync)全生命周期中的多轮交互死锁、上下文混淆及装量折算断层缺陷:- WorkOrderPlugin.cs 包装层级解析与序号消歧深度加固:
- 修复包装层级解析传参失真:将
_orderService.ResolvePackagingHierarchyAsync第二入参升级为融合用户最新发言的combinedSearchText。操作员在第 2 轮输入“外箱”、“二级”、“中盒”或包装 DI 时,底层引擎即刻感知并命中包装层级,彻底根治无限重复弹出包装卡片的死锁问题。 - 包装确认序号与装量严格对齐:对齐卡片表格映射,序号
0对应单品最小销售单元(ZXXSDYCPBS,装量倍率强制归一为 1),序号1, 2...严格映射一级、二级包装。支持“选0/选1/选2/序号1/外箱/单品”等丰富自然语言输入。 - 装量与层级公式联动计算:用户选定包装后,以选中的
BZCPBS再次驱动ResolvePackagingHierarchyAsync,自动调用PackageLevelHelper递归计算装量倍率(RatioMultiplier)、生产折算总量(BaseUnitsQuantity)及多级级联公式(ConversionFormula),杜绝折算量为 0 或 1。 - 移除粗暴覆盖:移除了包含“箱”字盲目将单位设为“箱”的误判逻辑;完善安全产品族判定(兼容
LastCandidates规格集),防止多轮规格选择误清空会话槽位。 - 任务链上下文同步:在工单生成与修改完成后,同步持久化单号、产品名、DI 与批号至
UserIntentExtractor,打通【工单 ➔ 打印 ➔ 入库 ➔ 追溯 ➔ 修改】连续操作。
- 修复包装层级解析传参失真:将
- UserIntentExtractor.cs 多轮意图消歧与防查空重写:
- 区分消歧上下文:新增
isPackagingContext状态识别,区分“产品规格型号初筛”与“包装层级确认”两类不同会话阶段。 - 根除品名误查空:在包装确认阶段,拦截“选第N个/选N/外箱/单品/选0”指令,提取原产品名并重写为标准格式:
我要生产 {产品名},指定包装规格码: {DI}(包装级别: {级别}),彻底根治把“一级”或“二级”当作产品品名检索导致数据库报错的致命缺陷。 - 系统单号正则升级:升级单号正则支持全类型真实系统工单(
SCRWD、DSCRW、SCD),支持指代“修改刚才工单批号/效期”。
- 区分消歧上下文:新增
- ProductionOrderService.cs 扫码穿透直查与标签防干扰:
- 外箱/中盒条码穿透直查:在第 0 步直查中新增第 0.3 步。车间操作员若直接扫描外箱或中盒包装 DI(仅存在于
di_devicepackage/di_download_devicepackage),自动反向穿透锁定所属母品主档。 - 结构化辅助标签清洗:在文本清洗中剔除
指定包装规格码、包装级别、[DI:...]等标签,防止污染品名切词与规格二次精滤。 - 候选集缓存防串批清空:在品名/规格精准匹配(
ExactMatch)成功后,即时清空AiKernelManager.Session.LastCandidates,杜绝后续轮次被旧候选集拦截。 - 多格式生产日期兼容:支持
yyyy.MM.dd、yyyy/MM/dd、yyyy-MM-dd、yyyyMMdd完整日期解析。
- 外箱/中盒条码穿透直查:在第 0 步直查中新增第 0.3 步。车间操作员若直接扫描外箱或中盒包装 DI(仅存在于
- ShelfLifeHelper.cs & AiKernelManager.cs 复合批号与效期拓展:
- 支持批号包含特殊符号
#(如LOT#2026-01)。 - 扩充效期关键词识别池(
保质期限、有效日期、有效期、有效期限、失效日期、效期),精准处理“24个月”、“2年”等周期换算。
- 支持批号包含特殊符号
- AiCopilotControl.cs 卡片交互底层对齐:
- 规格选择卡片与包装选择卡片按钮事件执行后,即刻清空候选规格集缓存并同步
UserIntentExtractor状态,确保 UI 点击与对话交互行为 100% 幂等一致。
- 规格选择卡片与包装选择卡片按钮事件执行后,即刻清空候选规格集缓存并同步
- 包装确认判定边界收紧与首轮合规卡点保障:
- 在
WorkOrderPlugin.cs中收紧hasExplicitConfirmedPkgDi判定边界,结合AllPackages验证实际外包装码,防止母品兜底 DI 误命中而静默跳过首轮包装确认卡片。
- 在
- 计划数量与单位跨轮会话记忆与无缝继承:
- 在
AiKernelManager.AgentSessionContext中增设LastQuantity与LastUnit;在WorkOrderPlugin.cs与UserIntentExtractor.cs中实现跨轮继承与精准刷新,彻底杜绝纯打字多轮交互下数量回退为 1 的隐患。
- 在
- 批次管理产品 scd_detail_isxlh 智能研判与历史继承:
- 在
ProductionOrderService.cs中建立智能判定链条(显式意图 ➔ 历史工单 ➔ IVD 默认 ➔ 序列号),解决批次产品在喷码机被拦截报错无法喷码的缺陷。
- 在
- 修改工单批号/效期增加 udi_dy 打印记录检查:
- 在
ProductionOrderService.ModifyWorkOrderBatchAndExpiryAsync中拦截已生成条码打印任务的工单,杜绝物理条码批号与工单批号脱节的严重质量事故。
- 在
- 无菌医疗器械灭菌批号与灭菌日期全周期提取与卡片呈现:
- 支持自然语言嗅探灭菌批号(
mjph)与灭菌日期(mjrq),自动配置scd_detail_ismjph/scd_detail_ismjrq开关,并在数据表与ActionCardFactory卡片中直观回显。
- 支持自然语言嗅探灭菌批号(
- 全景追溯图谱、工单打印进度、出库防错校验与飞检模型深度加固:
TraceQueryPlugin.cs全生命周期 8 节点追溯穿透:- 修复
batchNo未赋值导致质检首检(节点 4)、成品入库(节点 6)与销售出库(节点 8)批号穿透失效的断链缺陷,追溯报告与交互卡片中生产批号 100% 完整展示; - 修正打印明细关联合并:通过工单号查询
udi_dy.udi_dy_scdh获取对应udi_dy_rwdh打印单号,消除工单号直接 Contains 打印单号导致的节点 3 赋码打印漏查; - 集成
UdiZjEvaluator.ParseUdi与PackageLevelHelper.GetMinimalUnitDi(db, parsedDi),支持物理扫码枪条码(01/17/10/21)与外箱包装 DI(BZCPBS)自动解构反查最小单元 DI,实现全格式穿透。
- 修复
WorkOrderPlugin.cs工单打印进度准确聚合:- 修复已打印量统计逻辑:先由工单单号查
udi_dy.udi_dy_rwdh,再准确聚合udi_dy_detail的已打印标签数量,彻底解决工单进度恒为 0% 缺陷。
- 修复已打印量统计逻辑:先由工单单号查
UDI_GLCX_Exchange.cs&UDI_GLCX_Add.cs出库防串防漏与明细同步:- 修正出库状态校验:由错误的
type == "2"改为标准的(type == "-1" || type == "2") && status == "1",严格拦截已出库单品被调换或重新装包; - 调换或装入成功后,事务内联动同步更新
ck_inout_record.udi_parent,保持入库单明细视图与包装拓扑强一致; - 将操作人赋值从
ConfigurationManager.AppSettings["UserName"]规范迁移为GlobalConfig.UserName。
- 修正出库状态校验:由错误的
ComplianceInspectionPlugin.cs飞行检查模型假阳性/假阴性消除:- 优化防重码检测:由单字段
udi分组改为(udi, type)联合分组,排除正常“一次入库+一次出库”的合法流向,消除对全厂正常产品的重码误报; - 优化效期检测:引入
ParseExpiryDate引擎支持 GS1 6 位yyMMdd效期识别,并联动在库实物余额(balance > 0),消除假阴性漏报并杜绝历史已出库记录误报。
- 优化防重码检测:由单字段
ProductionOrderService.cs物料编码无残留治理:- 严格遵循系统无物料编码规则,彻底移除
scd_wlbm赋值中的CPHHHBH兜底残留,工单物料编码统一规范为orderDi。
- 严格遵循系统无物料编码规则,彻底移除
- WorkOrderPlugin.cs 包装层级解析与序号消歧深度加固:
2026-05-21
[feat] UmiUDI 后端业务 API 控制器与 PDA 专有 API 全面合拢与发布
- 涉及文件:
UmiUDI - API/Controllers/UdiZjController.cs、UmiUDI - API/Controllers/CkController.cs、UmiUDI - API/Controllers/ErpController.cs、UmiPDA - API/全套服务 - 变更说明: 圆满完成了 UmiUDI 后端 API 补全路线图的全部核心接口,并对 PDA 专用 API 服务进行了编译与发布验证:
- UdiZjController.cs (P1 标签打印与质量控制域 - UmiUDI):
GET /api/zj/print-jobs:获取打印任务主表记录与模糊检索。GET /api/zj/print-jobs/{rwdh}:拉取任务明细条码及审核流追踪历史。POST /api/zj/print-jobs:事务级联保存打印任务及明细条码。POST /api/zj/print-jobs/review:录入打印主管电子签名与单据授权放行审核(udi_dy_review)。GET /api/zj/quality-records&POST /api/zj/quality-records:物理质检指标上报与等级列表检索。POST /api/zj/quality-records/review:记录质检复核确认与现场缺陷拦截审计追踪(udi_cj_review)。
- CkController.cs (P1 智能仓储与出入库域 - UmiUDI):
GET /api/ck/inout&GET /api/ck/inout/{crkdh}:获取仓储出入库扫码历史与单据明细。POST /api/ck/inout:事务保护的仓储出入库扫码上报与级联写入。GET /api/ck/trace/{udi}:支持输入单品 UDI 直接正反向定位其流通出入库轨迹与物理打印生产属性。POST /api/ck/inout/review:登记仓储主管复核入账电子签名,并级联更新明细记录状态为“保存”(ck_inout_review/ck_inout_detail_review)。
- ErpController.cs (P2 ERP 业务单据双向同步域 - UmiUDI):
POST /api/erp/sync-scdd:从 ERP 同步最新生产订单(erp_scdd)。POST /api/erp/sync-sclld:同步生产原料及半成品领料单(erp_sclld)。POST /api/erp/sync-scrkd:同步成品生产入库单(erp_scrkd)。POST /api/erp/sync-xsckd:同步销售发货出库单(erp_xsckd)。POST /api/erp/sync-xsthd:同步销售客户退货单(erp_xsthd)。
- UmiPDA - API (手持扫描终端接口服务):
- 对基于 SqlSugar 构建的 PDA 微服务项目进行了全面盘点与校验,涵盖 Auth、CkInoutDetail、CkInoutRecord、Customer、Dy、Inbound、Outbound、Package、Quality、Scd 控制器及服务层。
- 验证通过,编译 0 错误。
- 双通道生产部署包就绪:
UmiUDI - API与UmiPDA - API双端 Release 发布包已分别输出到对应的publish/目录下,可直接在 IIS 生产服务器上进行部署与灰度上线。
- UdiZjController.cs (P1 标签打印与质量控制域 - UmiUDI):
[feat] UmiUDI 后端业务 API 控制器首批补全计划落地
- 涉及文件:
UmiUDI - API/Controllers/DiController.cs、UmiUDI - API/Controllers/UdiScdController.cs、docs/UmiUDI后端API补全与扩展实施方案.md - 变更说明: 为彻底将
UmiUDI - API后端从单一通道升级为完整的企业级 UDI 数据中心,首批 P0 级核心业务接口已正式开发、发布并完成编译:- DiController.cs 补全:
GET /api/di:支持按名称、型号、标识等多字段模糊查询及分页。GET /api/di/{id}:拉取主数据及对应的申报状态。POST/PUT/DELETE /api/di:实现完整的 DI 实体增删改查及关联状态清理。POST /api/di/{id}/sync-draft:支持将产品标识一键同步到药监局草稿库di_yjj_draft并更新状态。
- UdiScdController.cs 补全:
GET /api/scd&GET /api/scd/{id}:获取生产首次登记总表、条码批次明细记录与复核记录。POST /api/scd:使用关系数据库事务(Transaction),保障主表udi_scd与明细表udi_scd_detail联合级联写入的事务一致性。POST /api/scd/review:为生产首次赋码提供满足 GMP 双人复核电子签章的审计追踪写入(udi_scd_review)与单据状态联动流转。
- 项目发布就绪:双端完美编译通过(0错误),Release 生产发布包已成功输出至发布目录。
- DiController.cs 补全:
[feat] win 表单聊天气泡强显 @所属公司 与标题栏体验优化
- 涉及文件:
Forms/ChatWindow.cs - 变更说明: 为满足跨企业/平台级协同会话时的身份辨识需求,对 IM 窗口进行了多项关键界面体验升级:
- 标题栏去 ID 化:移除了顶部子文本中暴露的内部数据库自增主键
(ID: 51),当前标题仅显示干净清爽的当前登录账号: {username},符合商用软件规范。 - 双端数据模型扩展:更新了客户端
UserItem实体模型与 API 传输 DTOUserApiDTO,新增CompanyName(公司名称)字段。 - 统一强显 Username 账号名与所属公司:重构了历史消息流载入
LoadChatHistory()以及实时发送追加气泡ProcessSendMessage()逻辑。抛弃了中文姓名(name),统一使用系统内唯一的账号名(username)作为会话标识,并且自动格式化拼接所属公司为username @所属公司格式(例如testuser @我的公司和zzx @南联技术支持中心),确保用户在交互会话中对彼此账号名和企业归属一目了然。
- 标题栏去 ID 化:移除了顶部子文本中暴露的内部数据库自增主键
[feat] 平台超级管理员(1号用户)全局穿透与置顶
- 涉及文件:
UmiUDI - API/Controllers/ChatController.cs、Forms/ChatWindow.cs - 变更说明: 为建立顺畅的“企业用户一键直连平台售后客服”与“平台客服全局支持”闭环,对员工列表拉取接口进行了全局穿透与双向视角的重构:
- 系统管理员全局视图:在 API 的
GetUsers接口中引入userId入参。如果发起请求的账号是userId == 1(超级管理员zzx),接口将自动穿透公司边界,拉取数据库中所有的活跃用户,使其客服工作台能够看见、接收和响应全平台所有企业的消息通知。 - 普通用户透传与置顶:如果请求者是普通企业用户,SQL 检索逻辑保持为并集条件
(u.companyId = @companyId OR u.id = 1)且通过LEFT JOIN cer_company跨表显示每个员工对应的公司名称。此设计确保普通用户只会看到自己同公司的同事以及常驻置顶在首位的“超级管理员”客服。
- 系统管理员全局视图:在 API 的
[fix] 限制 Swagger API 接口文档在公网生产环境暴露
- 涉及文件:
UmiUDI - API/Program.cs - 变更说明: 针对在公网暴露 Swagger API 交互调试文档可能导致的数据模型与路由结构泄露隐患,进行了安全性架构加固:
- 环境权限硬隔离:将 Swagger 中间件注册
app.UseSwagger()与 UI 呈现app.UseSwaggerUI()彻底移入if (app.Environment.IsDevelopment())条件块内。 - 公网安全防护:重构后,当 API 部署到生产服务器(
ASPNETCORE_ENVIRONMENT=Production)时,Swagger 服务被安全关闭,公网访问/swagger将直接返回标准的404 Not Found,实现了业界高水准的生产环境安全合规。
- 环境权限硬隔离:将 Swagger 中间件注册
[feat] 新增敏感信息与硬编码防明码混淆加密系统
- 涉及文件:
Core/Obfuscator.cs、Forms/ChatWindow.cs、Core/PaymentConfig.cs、docs/敏感信息防明码混淆开发指南.md - 变更说明: 为彻底防止客户端编译出的 EXE/DLL 被反编译工具(如 dnSpy/ILSpy)直接以静态明文形式检索到核心 API 路由及支付回调地址,构建了高标准的安全防明文硬编码系统:
- 异或掩码去混淆器:新增 [Obfuscator.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug_1.0.0.0/Core/Obfuscator.cs),采用定制位异或字节旋转运算掩码与 Base64 对关键字符串进行转换,提供运行时瞬时内存解密机制。
- 全面消除明文硬编码:
- 重构 IM 协同客服窗口,将本地开发端口与线上生产 API 路由域名彻底混淆为 Base64 编码。
- 重构支付配置文件 [PaymentConfig.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug_1.0.0.0/Core/PaymentConfig.cs),消除了支付宝异步通知、同步返回等硬编码明文链接。
- 发布开发与混淆安全指南:编写并提交了 [敏感信息防明码混淆开发指南.md](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug_1.0.0.0/docs/敏感信息防明码混淆开发指南.md),规范了团队内部的敏感信息分级标准、密文生成及 DPAPI 配置段物理加密使用规范。
[fix] IM 客户端 API 自动切换、静默容灾与 Emoji 移除优化
- 涉及文件:
Forms/ChatWindow.cs - 变更说明: 对即时通讯客户端进行了用户体验与容灾性二次优化:
- 全自动双端寻址:客户端在启动 IM 窗口时自动并发探测本地
http://localhost:5136,若本地开发服务正在运行则秒级自动重连本地,若本地离线则 fallback 重连生产环境http://umiudi.cn:1031。 - 静默容灾与诊断引导:移除了接口离线时抛出的 Harsh 阻碍性弹窗,改由精美的“API 智能诊断助手”气泡进行交互引导,指导开发人员在本地启动
UmiUDI - API服务或在服务器部署 API。后台开启静默轮询重连,一旦检测到 API 上线即可全自动重新载入成员。 - Emoji 符号全面清除:根据代码简洁与合规规范,移除了联系人在线指示徽标、API 诊断对话气泡中的所有 Emoji 符号(如
🟢、⚪、⚙️、🔴、1️⃣、2️⃣),界面回归专业严谨。
- 全自动双端寻址:客户端在启动 IM 窗口时自动并发探测本地
[feat] 新增企业内部即时通讯 (IM) 售后与协同客服系统
- 涉及文件:
Forms/ChatWindow.cs、Forms/ChatWindow.Designer.cs、Models/cer_chat_message.cs、Mian.cs、Mian.Designer.cs、UmiUDI - API/Controllers/ChatController.cs - 变更说明: 为打通客户端内部的即时售后、客服支持以及跨部门员工的高效协同,研发并部署了全新的企业级 IM 即时通讯系统:
- 数据库层定义:在客户端定义了
cer_chat_message消息映射实体,并设计了发送人、接收人、消息内容、发送时间及已读标志。该表结构由用户在中央数据库中手动执行 SQL 建表部署。 - 高性能 API 控制器:在
UmiUDI - API支付微服务项目中新增 [ChatController.cs](file:///E:/backup/UmiUDI&Drug/UmiUDI%20-%20API/Controllers/ChatController.cs)。采用轻量、安全的原生 ADO.NET 连接池模式,提供获取同公司活跃用户列表、无延迟写入发送消息、拉取交谈历史(自动将接收到的消息标记已读)以及未读消息概览计数等高吞吐并发接口。 - 高端视觉动态圆角字符头像:客户端内置了 HSL 唯一渐变色调圆角字母头像生成核心算法。根据用户的姓名/账号哈希,自动绘制饱满、亮丽且视觉舒适的扁平化圆形头像,无需额外依赖任何本地或云端静态图片资源。
- 1.5 秒频率智能差量轮询:
- 在
ChatWindow加载时,由定时器(1500ms 频率)向 API 后台异步高频轮询最新的未读信息。 - 若当前选中的联系人发来消息,自动向
ChatList底部追加会话气泡并流畅滚动到底部,实现微信般的零感知极速打字互动。 - 若其他离线/非激活联系人发来消息,自动更新其左侧列表右侧的红色徽标数值并微动闪烁,完美保障协同顺畅。
- 在
- 右上角常驻入口集成:在主窗体
pageHeader.Controls中(更新按钮右侧)追加了高雅亮紫色(Color.FromArgb(114, 46, 209))的CommentOutlined评论气泡按钮btn_chat,并配有极佳的悬浮说明:“联系企业内部售后与技术协同工作台”,点击以非模态悬浮窗形式呈现。 - 零错误高稳定性交付:双端工程完美通过编译,0 错误,0 告警,退出码均为
0。
- 数据库层定义:在客户端定义了
[feat] 新增药监局飞行检查医疗器械 UDI 合规材料准备系统
- 涉及文件:
Pages/FlyInspection.cs、Pages/FlyInspection.Designer.cs、Mian.cs、Mian.Designer.cs - 变更说明: 根据国家药监局唯一标识实施与现场检查指南,开发了专属的「飞检准备」合规自查模块:
- 合规架构:建立涵盖“基础管理与制度要点”、“编码赋码合规性”、“UDID数据库申报”、“生产追溯体系”、“仓储与流通追溯”及“系统与数据完整性”6大分类共28项核心指标体系。
- 智能体检算法:实现 78.6% 的高自动化核查率,自动调用 SQL 映射校验厂商代码有效性、GTIN-14 主码合规性、PI 生产要素完整性、ISO-15415 历史物理印刷质量评级(一键解析 AIDC 与 HRI)、多包装多层级关联率、数字三级审批流覆盖率及用户账户权限隔离度。
- 数据上传与持久化:针对 SOP 文件、培训签到表、内审及数据库灾备方案等人工指标,提供本地 PDF/Docx 上传关联并在数据库完成持久化保存,保障历史记录随时查阅。
- 跨平台一键报告导出:实现了高保真格式化自查报告的多重导出:
- Excel:基于 EPPlus 以 HSL 现代商务配色自适应排版,细化至指标分类、合规判定和整改建议。
- Word/PDF:基于 DevExpress 文本引擎动态生成具有法律效力的正式带公章签到自查报告。
- ZIP 归档包:一键打包所有格式报告用于现场备份或打印提供。
- 自动化菜单分发:在
Mian.cs中原实现的运行时自动菜单同步机制被安全废弃,现改由紧急下线及清理逻辑接管,确保菜单仅由顶部快捷入口进入。 - 顶部快捷入口:在主窗口右上角更新按钮右侧配置了常驻的
btn_fly_inspect按钮,采用防抖与防止重复打开标签页机制,且配有极佳的ToolTip气泡悬浮说明,方便用户随时一键直达飞检准备中心。
[fix] 紧急下线飞检准备左侧菜单栏
- 涉及文件:
Mian.cs - 变更说明: 为避免「飞检准备」功能直接向所有系统用户公开(由于之前注入了所有用户的权限),进行了以下紧急下线调整:
- 废弃菜单分发:彻底移除在
setMenuLevel1中向cer_menu和cer_permission自动注入与授权「飞检准备」菜单的业务代码。 - 强力数据库回滚与清理:在程序启动初始化菜单时,自动执行一次紧急清理删除查询——若发现
cer_menu中已存在"飞检准备"项,则立即级联删除cer_permission中对应的关联授权记录以及cer_menu的项本身,从根本上在所有用户端下线该侧边栏菜单。 - 保留独立入口:用户仅可通过右上角的“盾牌/飞检”快捷常驻按钮进行操作与进入,确保权限归口单一且界面美观。
- 废弃菜单分发:彻底移除在
[fix] 飞检准备页面无法滚动
- 涉及文件:
Pages/FlyInspection.cs、Pages/FlyInspection.Designer.cs - 变更说明: 解决由于
AntdUI.Collapse控件无法继承ScrollableControl且使用Dock = DockStyle.Fill锁定尺寸,导致外部panelBody无法触发滚动条的 WinForms 经典停靠渲染缺陷:- 停靠逻辑重构:将
collapse_main.Dock由Fill改为Top,允许其高度在垂直方向无限延伸,将滚动权交由支持AutoScroll的父容器panelBody接管。 - 动态高度自适应:实现
UpdateCollapseHeight()核算函数,根据每个折叠大类(CollapseItem)的手动/自动展开(Expanded Height)和折叠状态(Collapsed Header Height)动态重算collapse_main.Height。 - 双向绑定触发:同时在
CollapseItem初始化时订阅Click手动展开事件(设置 150ms 延时确保动画完成),以及在「一键体检」自动流水线中展开新卡片后自动触发,实现极其流畅、自然的页面无缝平滑滚动效果。
- 停靠逻辑重构:将
[fix] 安装包卸载残留文件
- 涉及文件:
UmiUDI.iss - 变更说明:在 Inno Setup 打包脚本中新增
[UninstallDelete]段,配置Type: filesandordirs; Name: "{app}\*",使卸载程序递归清理安装目录下所有运行时产生的日志、缓存、相机捕获图片等残留文件和子目录,卸载后安装目录被彻底移除。
[fix] 安装包体积膨胀(82.5MB → 192MB)
- 涉及文件:
libs/halcon_runtime/(删除 30 个 DLL) - 变更说明:v1.0.0.14 引入 Halcon 机器视觉运行时后,将完整运行时包(~470MB)全部打包,其中大量为程序不需要的组件。本次精简移除了:
- Halcon XL 版本 DLL(~154MB):
halconxl.dll,halcondlxl.dll,halconcppxl.dll等,超大图像处理变体 - HDevelop 脚本引擎(~55MB):
hdevenginecpp.dll系列,C# API 调用不需要 - Qt WebEngine(~94MB):
Qt5WebEngineCoreMVTec.dll等,Halcon 可视化 IDE 组件 - AI/OpenVINO/TensorRT、Canvas、OpenGL 软渲染等非必要组件(~11MB)
- 精简后保留 13 个核心 DLL(~156MB),LZMA 压缩后安装包体积大幅缩小
- Halcon XL 版本 DLL(~154MB):
[fix] CameraWorker 质检子项目未包含在发布包中
- 涉及文件:
.github/workflows/release.yml - 变更说明:
dotnet publish输出到bin/publish/,但CopyCameraWorkerMSBuild target 将 CameraWorker 复制到$(OutputPath)(即bin/Release/net9.0-windows/CameraWorkerApp/),两个目录完全不同,导致 CameraWorkerApp 从未出现在安装包和增量更新中。修复方式:在 CI release.yml 的 Build and Publish 步骤中新增第 4 步,用 vswhere 定位 VS MSBuild → 编译 CameraWorker.csproj(.NET Framework 4.7.2)→ 将CameraWorker.exe及依赖的AntdUI.dll、MVSDK.dll、MVCAMSDK_X64.dll、MVImageProcess_X64.dll、MindVision.ds复制到bin/publish/CameraWorkerApp/。
[fix] CameraWorker 项目集成到解决方案
- 涉及文件:
UmiUDI.sln、CameraWorker/CameraWorker.csproj、UmiUDI.csproj - 变更说明:
- 将
CameraWorker.csproj加入UmiUDI.sln,使dotnet build UmiUDI.sln同时编译两个项目 - 在
CameraWorker.csproj中增加Debug|AnyCPU和Release|AnyCPU配置段(保持PlatformTarget=x64),解决在 AnyCPU 默认配置下缺少 OutputPath 导致编译失败的问题 - 在
UmiUDI.csproj的DefaultItemExcludes中加入CameraWorker\**,防止 SDK-style 项目递归编译 CameraWorker 文件夹内的.cs和obj/生成物导致的TargetFrameworkAttribute 特性重复编译错误
- 将
[fix] UmiUDI.csproj 清理不存在的排除路径
- 涉及文件:
UmiUDI.csproj - 变更说明:
DefaultItemExcludes原包含 12 个排除路径,其中 10 个(如AntdUI-main\**、ChatUI\**、Demo\**等)在当前仓库中已不存在。精简为仅保留实际存在的UmiUDI.Tests\**和CameraWorker\**,消除配置噪音。
[style] 升级成功弹窗文案面向业务用户
- 涉及文件:
Mian.cs(CheckAndShowUpgradeLog()方法) - 变更说明:将升级成功后的弹窗文本从开发侧技术描述(如"增量更新引擎 403 阻断"、"汉化附属包自动部署")调整为面向终端用户的业务功能亮点(如"条码防伪与防重码自动校验"、"支持管理员一键清空和重置授权设备")。
[fix] 出库单月末效期查询空指针消除、工单详情加载防闪退与近效期柔性预警
- 涉及文件:
Pages/CK_OUT.cs、Pages/UDI_SCD.cs - 变更说明:
- 出库单保存/编辑效期匹配与降级防护:
- 在
CK_OUT.cs中新增或编辑出库单保存时,扩充了对udi_dy打印任务的效期查询条件,全面兼容yyyy-MM-00月末效期、条码明文与标准日期匹配; - 增加了空值防护与降级回退机制:当未精确命中
udi_dy时,通过DI + 批号兜底查找,或直接从di主数据表获取产品名称和规格型号,彻底杜绝NullReferenceException导致事务回滚出库单无法保存的恶性缺陷。
- 在
- 生产工单加载月末效期兼容:
- 在
UDI_SCD.cs加载工单详情时,将Convert.ToDateTime(detail.scd_detail_sxrq)升级为PackageLevelHelper.ParseGs1Date,避免工单保存了2026-09-00等月末效期时触发FormatException异常闪退。
- 在
- 出库扫码近效期/过期高显眼度 Notice 预警卡片:
- 在
CK_OUT.cs扫码入口处引入效期研判,全面弃用容易被忽视的普通 Message 消息条,对齐打印明细页的“首检提醒”卡片视觉规范,升级为右上角悬浮的AntdUI.Notification.warn醒目卡片; - 当产品已过期时弹出
【效期过期提醒】卡片,当剩余效期 ≤ 90 天时弹出【近效期预警】卡片;散件防呆同样升级为【散件防呆提醒】通知卡片,高显眼呈现且不阻断扫码作业。
- 在
- 打印任务保存模板差异化智能校验:
- 在
UDI_DY.cs的checkDatas中引入requireTemplate差异化参数: - 当操作员在界面上手动点击【保存】按钮时,强制拦截并弹出 Notice 卡片提示
“打印模板不能为空,请选择打印模板后再保存!”; - 当生产工单后台**批量直接下推(
SilentSaveAll)**时,自动豁免放行,完美平衡了下推的高效性与手工建单的严谨性。
- 在
- 出库单保存/编辑效期匹配与降级防护:
文档规范
每条变更记录需包含:
| 字段 | 说明 |
|---|---|
| 日期 | YYYY-MM-DD 格式 |
| 类型标签 | [feat] 新功能、[fix] 修复、[refactor] 重构、[style] 样式/文案、[docs] 文档、[ci] 构建/流水线、[perf] 性能优化 |
| 标题 | 简明描述变更目的 |
| 涉及文件 | 列出所有被修改、新增、删除的文件 |
| 变更说明 | 详细描述问题根因、解决方案、技术细节 |