龙虾供应链配送系统
项目进度看板

已发布 /xia-pricing-data-source/、data-source.json 和 data-source.csv，并为价格、运费、试算 API 补充规则来源和计算依据。

已发布 /xia-ops-finance-data-source/、data-source.json 和 data-source.csv，并为配送、签收、账单、供应商结算接口补充 dataSource/persistence 标识。

已发布 /xia-order-data-source/、data-source.json 和 data-source.csv，并为订单 API 返回 dataSource/persistence 标识，证明订单链路不是纯静态展示。

已发布 /xia-store-mp-build/、build.json 和 build.csv，公开说明 Taro/TypeScript 构建校验、项目配置、8 个页面源码和真机发布资料阻断。

已发布 /xia-material-sla/、sla.json 和 sla.csv，明确资料提交后的首次响应、核验责任、升级规则和 MS 编号追踪。

已发布 /xia-unblock-guide/、guide.json 和 guide.csv，把剩余生产阻断转成客户可执行的提交、查询、核验、刷新门禁四步操作清单。

已清理早期“待开始”旧口径，将核心模块、联调测试、公网测试部署、验收证据包和签收单统一收口为客户可检验状态；生产上线仍以微信资料与生产 MySQL 两个 P0 门禁解除为前提。

已在 /xia-signoff/ 顶层展示客户验收证据包索引、JSON/CSV、角色权限验收结果和结果 API，签收前可直接核对 UAT/RULE/E2E/ROLE 四源证据。

已发布 /xia-acceptance-evidence/，将测试执行、角色权限、反馈闭环、报告收口、签收材料、生产化门禁、资料闭环和运维证据整合为一页式客户验收证据链，并提供 JSON/CSV。

已将 ROLE 角色权限验收作为第 4 类验收来源接入 /xia-test-report/ 与 /xia-test-closure/，测试报告运行时读取 /xia-api/role-trial-results，测试收口清单新增角色权限回收项。

已将 /xia-role-trial/ 升级为可在线提交的角色权限验收包，新增 /xia-api/role-trial-results 与 CSV 导出；不通过/阻塞自动生成反馈编号，后台角色试用导览可查看回收统计和最近记录。

已发布 /xia-role-trial/ 免登录验收包，包含 8 类演示账号、验证路径、允许/拒绝边界、guide.json 和 guide.csv，并接入发布中心、客户测试包、客户门户和 smoke。

已新增后台 /xia-admin/#/role-trial-guide 和 API /xia-api/auth/role-trial-guide，将 8 类演示账号、推荐入口、验证动作、预期允许/拒绝边界集中展示，并纳入 smoke 验证和看板置顶入口。

已发布 /xia-product-release-acceptance/，包含 8 条 PRA 商品发布治理验收用例，覆盖调价申请、平台审批、驳回修订、阻断检查、阻断解除、价目同步、异常重试、事件归档和权限隔离；后台商品发布审批页已加入验收包入口。

已发布 /xia-unblock-evidence/，将微信小程序资料、生产 MySQL、地图、对象存储、支付回款、监控备份等阻断/风险项拆成提交、查询、核验和解除条件，并输出 evidence.json/evidence.csv；入口已接入客户门户、测试包、交付索引和发布中心。

客户测试报告已新增 RULE 业务规则验收、E2E 端到端验收、三类验收来源态势和反馈来源追踪入口；report.json/report.csv 同步输出补充验收统计，已纳入 smoke。

UAT 总控台新增三类验收来源态势，聚合 UAT、业务规则验收、端到端验收的反馈总数、未闭环数和 P0 阻塞数，并提供对应验收包入口；本能力已纳入本地与公网 smoke。

反馈状态查询页新增来源类型和对应验收包入口；后台反馈工作台新增 UAT / 业务规则验收 / 端到端验收来源标签和验收包跳转，便于客户按原用例编号复测闭环。

结果回收页已扩展支持 UAT、RULE、E2E 三类编号；RULE/E2E 不通过或阻塞会生成反馈编号并进入修复队列，UAT 统计仍按 13 条正式用例保持原口径。

订单履约工作台新增 E2E 验收证据卡，覆盖 E2E-001 至 E2E-004；财务与提成工作台新增 E2E 验收证据卡，覆盖 E2E-005 至 E2E-007；公网后台资产已纳入 smoke。

已发布 /xia-e2e-acceptance/，包含 9 条订单到财务端到端验收用例、JSON/CSV 下载和后台检验入口；客户可按门店下单、分单、配送、签收、账单、供应商结算、业务员提成逐项验收 v0.1 主链路。

已发布 /xia-rule-acceptance/，包含 8 条规则验收用例、JSON/CSV 下载和后台检验入口；客户可按规则用例逐条核对成交价、运费重量、签收、供应商结算、门店账期、配料抽佣、业务员提成和主控台/UAT 总控台证据。

业务规则摘要已从独立页面扩展到项目总览和 UAT 总控台；运营人员可在主驾驶舱看到价格、运费、签收、结算、抽佣、提成高亮，在 UAT 总控台逐条核对规则 PASS 证据，公网后台资产和 API 字段均纳入 smoke。

已上线 system/rule-summary，集中返回报价 T+2 生效与下单取前天价、运费 LOBSTER_ONLY 免运门槛、整单/部分/异常签收、龙虾采购转售、配料自主定价抽佣、门店账期和业务员首笔实收回款首月起算策略；runtime 与 DB smoke 均已校验。

已在 commissions overview/statements 增加 tierPolicy 和 recognitionSummary，明确 FIRST_ACTUAL_PAYMENT_MONTH 起算口径；DB smoke 通过账单回款触发提成生成，并校验首月高提成、比例、基数和金额。

已在供应商结算详情和 payout-summary 增加 settlementPolicy 与 marginOrCommissionSummary；runtime 与 DB smoke 分别校验龙虾供应商 A_PURCHASE_RESELL 无佣金、配料供应商 SUPPLIER_DIRECT_PRICE_COMMISSION 扣佣净额。

已在 finance store bill detail 与 collection-summary 接入 signAdjustmentSummary，账单可回读关联签收单、凭证照片数、异常原因和财务复核建议；runtime 异常签收与 DB 部分签收均纳入 smoke。

已增强 buildSignRecordDraft 与 DB 签收映射：签收提交返回 orderStatusAfterSign、voucherSummary、differenceSummary、nextAction；runtime 异常签收和 DB 部分签收均纳入 smoke，并验证配送签收摘要回读同源凭证。

已增强 createDeliveryOrder、findDeliveryOrder 和 routePlan：配送单返回 consolidation、fulfillmentNos、signRequirements；本地和 DB smoke 均覆盖新提交订单创建配送、配送详情回读合流分单与签收要求。

已增强 buildOrderDraft 和 orders split-preview：订单提交返回 splitResult、freight、financeImpact；拆单预览读取真实订单履约单。本地和 DB smoke 均覆盖低于免运门槛按公里收费、高于门槛免运、龙虾/配料结算模式。

已在验收清单读取 /xia-api/uat-results、gate.json 和 closure.json 展示实时验收态势，并在签收单/signoff.json 增加 UAT、上线门禁、资料闭环和反馈状态证据入口；smoke 已覆盖。

已扩展 material-submissions 详情 API，返回 releaseState、gateDecision、gateBlockers 和 traceLinks；客户资料状态查询页新增 P0 放行状态、上线门禁结论、客户提示和追踪入口，并纳入 smoke。

已将上线门禁、生产化阻断总览和上线行动清单升级为静态兜底加实时 JSON 刷新模式，并在 smoke 中校验 liveRefreshMarker、liveGateRows、liveActionGrid、liveBlockers 等关键标记。

已在生产资料闭环报告接入实时资料核验 API 和上线门禁 gate.json，客户可直接核对当前 P0 放行状态；smoke 已增加 P0 状态、gate.json 与 closure.json 断言。

已在生产化检查工作台资料提交队列新增“门禁刷新”列，核验资料时传入 refreshPublicGate 并提示公网门禁结论/P0 阻断数量。

已将 material-submissions 核验流程接入 refresh-production-public-from-api.js，syncReadiness 成功后可自动刷新公网门禁、总览和行动清单，并返回 publicGateRefresh 结果。

已新增 refresh-production-public-from-api.js，从当前 API 读取 production-readiness 并刷新 /xia-go-live-gate/、/xia-production-summary/、/xia-action-list/，同步纳入 smoke。

已将 /xia-uat-result/ 升级为实时回收看板，自动读取 /xia-api/uat-results 展示当前判定、完成率、最新提交、问题摘要和反馈编号。

已打通反馈状态与 UAT 结果回收：UAT 异常自动生成反馈，反馈复测通过/未通过后自动写回对应 UAT 用例，并纳入后台总控台统计。

已新增 /xia-api/uat-results 与公网 UAT 结果在线提交页，不通过/阻塞自动生成反馈编号，并在后台 UAT 总控台展示结果统计和最新回传。

已新增受权限保护的 /xia-api/system/uat-operations 聚合接口和后台 /uat-operations 页面，运营人员可一屏跟踪 UAT、反馈、资料闭环、公网 API 巡检和客户检验入口。

已将客户测试报告、验收清单、report.json、report.csv 和 smoke 校验统一升级到 13 条 UAT，并显式校验 UAT-013 资料闭环用例。

已新增 API runtime 动态巡检脚本，真实检测本地 health、公网 relay、资料提交、资料查询、自愈脚本和运行手册，并生成 report.json。

已新增客户可查看的公网 API 状态页和 report.json，展示 API health、资料提交、状态查询、自愈脚本和运行手册状态。

已新增 API runtime 自愈脚本和运行手册，smoke 覆盖公网 API health、资料提交和资料详情查询，降低客户在线提交资料时遇到 502 的风险。

已新增客户免登录资料状态查询页，支持按 MS 提交编号查看资料项、核验状态、缺失字段和最新动作，并接入门户、交付索引与 smoke。

已在后台生产化检查页新增客户资料提交队列，支持查看公网提交记录、缺失字段、最新动作，并可执行审核中、需补充、已接收三类核验动作。

已新增 /xia-api/material-submissions 资料提交闭环，公网资料页可直接提交并生成编号，后台授权队列可核验状态，runtime 与 DB 模式均纳入 smoke。

已新增客户可公开查看的资料回收状态看板，区分待客户回传、待生产执行和已核验证据，并提供 receipt.json 与 receipt.csv。

已新增客户资料提交模板，覆盖微信小程序、生产 MySQL、地图、对象存储、支付回款和短信资料，支持 HTML 填写、JSON/CSV 下载与打印。

已新增微信小程序发布资料运行手册，明确客户资料、配置步骤、真机预览、上传审核、正式发布和回滚口径，并纳入公网 smoke。

已新增生产 MySQL 接入运行手册，明确客户/运维需提供资料、执行步骤、回滚口径和验收标准，并纳入公网 smoke。

已将客户测试包、验收清单、测试报告和验收签收单统一接入生产化阻断总览，并清理过时 RBAC 待加固表述。

已新增客户优先查看的一页式生产化阻断总览，聚合剩余 P0、RBAC/DB 已完成证据和下一步资料入口。

已将生产化行动清单、生产资料收集包和环境检查页统一从 production-readiness 数据源生成，客户可见的 P0 阻断稳定为微信小程序资料与真实 MySQL 参数。

已修复生产数据库演练脚本在 RBAC 收紧后无法读取受保护接口的问题，并重新生成公网 DB 演练报告；生产 MySQL 阻断已明确为等待真实连接参数。

已将真实 RBAC 与审计日志从上线 P0 阻断项调整为开发侧已完成项，并用自动生成门禁页确认 rbac-audit 为 PASS，剩余 P0 阻断收敛到微信小程序发布资料与生产 MySQL。

已发布上线阻断门禁公网页，明确当前 v0.1 真实试运行结论为 NO_GO，并把门禁页接入客户门户、交付索引、发布中心和自动巡检。

项目目标、角色边界、价格规则、运费口径、签收规则、提成起算方式和一期端口范围已经确认完成。

已确定管理后台、供应商端、微信小程序、后端服务、数据库、缓存、地图和文件存储等核心技术路线。

已完成需求确认版 PRD、角色权限矩阵和数据库表设计第一版，为后续工程初始化和模块开发提供依据。

已完成 Monorepo 项目骨架初始化，建立了运营后台、供应商端、小程序、API 和共享包的基础目录结构。

已补正式的阻断解除动作，并让同步任务历史按同一批次归并回读，供应商端商品工作台可直接查看解除阻断结果与同步重试次数。

已完成审批动作历史、阻断解除记录和多次同步任务历史的持久化回读，供应商端商品工作台可直接展示发布审计明细。

已初始化 Git 仓库，并约定后续每次代码改动默认提交，阶段性成果同步更新内部进度看板与客户公网进度页。

已完成运营后台与供应商端的正式 React 页面骨架，包含布局、侧边导航、首页模块卡片和统一视觉基调，后续可继续接入业务模块。

已将后端从占位服务升级为正式运行骨架，具备配置层、路由层、统一响应结构和健康检查入口，后续可继续拆分业务模块。

已完成门店小程序首页、订单页、我的页和底部导航骨架，并处理了 React 类型版本兼容问题，为后续模块接入打好基础。

已为运营后台与供应商端接入路由能力，并补齐各业务模块占位页，后续可以逐个模块进入真实列表、表单和详情实现阶段。

已建立 auth、stores、suppliers、orders 模块的占位接口，后续可在这些入口下继续补登录、门店、供应商和订单等业务能力。

已将模块页从单一说明页升级为统计卡、待办区和列表区域骨架，更接近真实业务系统的交互结构，后续可直接接数据和操作区。

已完成登录页、前端路由守卫、子目录部署适配和五大核心模块演示框架，可直接通过演示账号进入后台查看整体结构与导航入口。

已完成供应商端子目录部署适配，并补齐履约订单、发货状态、商品维护、对账结算四个模块的演示筛选区、指标卡和列表结构。

已补齐 products、pricing、delivery、finance、signing、commissions 六个业务域占位接口，前后端后续可围绕价格、配送、签收和财务链路继续并行推进。

已补齐门店端下单页、签收页、账单页骨架，并细化首页、订单页、我的页内容，门店主流程页面结构已完整拉开。

已补齐共享模块常量、演示数据合同类型和 API mock 数据结构，后续后台、供应商端和小程序可围绕统一口径继续对接。

已将运营后台和供应商端的首页卡片与模块演示数据收拢到统一 mock 数据源，后续接真实接口时能减少重复改动。

已输出订单、价格、配送、财务四条主链路的状态流、快照点、风险点与接口草案，后续开发会按这版设计逐步落实现。

已补订单预览、下单、列表、详情四类核心接口的 mock handler 与 DTO，后续前端可开始逐步切到更真实的接口消费层。

已补龙虾有效价、运费规则、预览价三类核心接口的 mock handler 与 DTO，价格链路已开始从文档阶段进入可调用原型阶段。

已补配送列表、详情、创建三类核心接口的 mock handler 与 DTO，配送链路已经具备第一版可调用原型。

已补门店钱包、门店账单、供应商结算三类核心接口的 mock handler 与 DTO，财务链路已经具备第一版可调用原型。

已让运营后台的订单、价格、财务模块支持接口优先 / mock 兜底的数据消费方式，开始从纯静态演示页向真实数据流过渡。

已补待签收列表、签收详情、签收提交三类核心接口的 mock handler 与 DTO，门店签收链路已具备第一版可调用原型。

已让门店小程序的下单、订单、签收三页支持接口优先 / mock 兜底的数据消费方式，开始从纯页面骨架向真实数据流过渡。

已让供应商端的商品、配送、结算三页支持接口优先 / mock 兜底的数据消费方式，开始从纯静态演示向真实数据流过渡。

已让门店小程序具备模拟提交订单与模拟提交签收的 POST mock 原型，同时供应商端的履约订单页也开始接入接口优先的数据消费方式。

已让后台订单模块和供应商配送模块支持详情弹层接口消费，开始从列表演示进一步过渡到可查看单据详情的真实交互。

已将后台订单和供应商配送详情弹层从原始 JSON 展示升级为结构化业务信息卡片，并补了加载态与动作区占位。

已让门店小程序的下单页和签收页从说明骨架升级为可录入、可切换、可重复提交的交互原型。

已补收货地址切换、商品勾选与数量调整，并让签收页支持按商品逐项录入实收数量、重量和差异说明。

已让后台订单详情和供应商配送详情中的动作按钮接入 mock 接口，并能在弹层内回显执行结果。

已补地址管理页、签收图片上传占位页，并在下单页和签收页中接入明确跳转入口。

已为地址管理页补新增地址表单原型，并为签收上传页补上传后回填演示，页面更接近真实业务录入场景。

已补商品搜索筛选联动、地址保存回填提示与签收图片列表预览，小程序演示链路更完整。

已让供应商端的履约详情支持查看履约商品、确认接单和反馈履约异常，开始进入可操作演示阶段。

已让后台门店账单详情支持查看账单构成并模拟发送催款提醒，财务模块开始具备可操作演示能力。

已补门店详情、供应商详情及对应审核动作流，后台主数据模块开始进入可操作演示阶段。

已补供应商商品详情及上下架切换动作流，供应商端商品模块开始具备更完整的可操作演示能力。

已补供应商结算详情、金额构成、结算明细与流转记录，并支持模拟确认结算、提交复核、标记到账。

已补价格规则与运费规则详情展示，并支持模拟切换规则启停状态，后台规则中心演示完整度进一步提升。

已补规则参数编辑、影响试算与模拟保存能力，客户现在可以直观看到规则修改会如何影响报价与运费试算。

已补参数校验、版本记录与发布生效动作流，规则中心现在更接近真实运营后台的配置闭环。

已补联动影响预览与批量发布队列，客户现在可以看到多条规则如何协同复核、统一发布。

已补跨规则对比、发布批次审计与版本回滚演示，规则中心进一步接近真实运营闭环。

已补发布前检查清单、批次审批与失败重试动作，规则中心开始具备真正的发布工作台形态。

已完成发布前检查、批次审批、失败重试三类动作联动验证，发布工作台演示闭环进一步完整。

已完成审批人分层、发布阻断项识别与批量撤回演示，规则发布控制从工作台动作扩展到审批与风控层。

已完成订单分单概览、履约承接方案与异常风险摘要演示，后台订单详情已更接近真实运营处理视角。

已完成配送交接点、路线节点、签收摘要与异常关注项演示，供应商端发货状态详情已更接近真实履约闭环。

已完成门店回款摘要、供应商打款摘要演示，并补齐更稳定的本地 API 前台启动方式，开发闭环进一步收紧。

已实现本地文件型持久化，支持下单写入、账单生成、签收回写和多端回读，项目开始从演示层进入真实状态闭环。

已抽出 orders、signing、bills 三条链路的 repository，并补 Prisma schema、环境示例与双模式访问入口，为数据库落表铺好切换层。

已生成 Prisma client，完成 SQLite 初始化与 DB 模式启动，订单、签收、账单三条链路现已支持 runtime / db 双模式切换。

已让配送单创建、配送交接、履约接单、门店钱包读取和催收摘要开始基于统一 repository 访问与真实状态回写，项目正从订单闭环继续向运营闭环推进。

已将订单商品、履约单、配送单、签收图片、签收明细从 JSON 结构继续下沉到正式子表，并保留旧字段兼容，后续财务和提成模块可在更稳定的数据底座上继续扩展。

已补账单明细、回款记录、供应商结算、结算明细、提成记录等数据库结构，并让账单详情、催款、催收摘要、供应商结算和提成概览开始基于数据库返回，项目开始具备更完整的财务演示能力。

已补结算周期、抽佣比例、阶梯提成规则与业务员绑定的数据底座，并完成首批规则读取链路，为后续自动提成计算提供稳定规则来源。

已实现门店回款后自动生成提成记录，并按首笔实收月份识别首月/次月/后续月提成比例，提成概览现已能看到自动新增的结果。

已补提成规则查询、业务员绑定查询、提成台账、提成复核、提成发放状态流转，提成链路现已从“自动生成”继续推进到“可管理、可回看、可流转”。

已补激活规则编辑、业务员绑定新增/修改/删除、提成台账按状态筛选，并完成数据库写回验证，提成运营配置开始具备真实可维护能力。

已在管理后台接入独立提成配置页面，支持在线编辑提成规则、维护业务员绑定、筛选提成台账，并已完成后台公网发布验证。

已在管理后台接入独立财务工作台，将门店账单回款、供应商结算推进、业务员提成复核与发放收进同一操作页面，并完成公网发布验证。

已在管理后台接入独立订单履约工作台，将订单池、分单预览、履约建议、异常摘要、配送推进和签收任务整合进同一页面，并完成公网发布验证。

已让订单列表、签收待办、签收提交和签收详情围绕同一份数据库数据回读，并修复配送单号关联、异常签收枚举和状态透传口径。

已让门店小程序账单页和账户页直接读取门店钱包与账单列表接口结果，门店财务视图开始与后台账单状态口径保持一致。

已让门店小程序账单页支持选中账单后直接回读账单详情、回款记录和回款摘要，账单同源读取从列表推进到明细层。

已让门店小程序账户首页直接展示钱包余额、账期、最新账单与催收摘要，门店财务员进入首页即可看到最新财务状态。

已修复已结清账单在详情层仍显示“待结算”的问题，后台与门店端现在会统一回读“已结清”状态解释。

已让门店小程序订单页支持直接回读订单详情、商品明细、履约承接状态和配送状态，订单视图从列表推进到详情层。

已让门店小程序签收页基于真实订单商品与配送单生成录入项，签收视图从固定草稿原型推进到订单驱动的详情录入层。

已让门店小程序首页直接回读订单、签收和账单的最新结果，首页从导航骨架推进到带业务状态的概览入口。

已让门店小程序签收上传页围绕真实配送单回读签收摘要、签收单号和已留存图片，上传入口开始具备凭证预览能力。

后续重点推进商品、价格、订单、自动分单、配送、签收、财务与提成等核心模块开发。

供应商商品工作台已新增同步异常、失败摘要与重试恢复三段闭环，商品调价发布链已具备从执行失败到恢复完成的完整演示路径。

商品模块已从动作演示推进到内存态可回读状态流，商品详情会随版本生成、审批、同步异常和重试恢复实时刷新当前发布态、同步态与归档态。

商品模块已接入仓储层与 SQLite 持久化，商品发布状态在 API 重启后仍可继续回读，状态流从内存态推进到真实持久化阶段。

商品详情已开始持久化回读归档时间线、失败摘要与执行日志，发布链从“记住当前状态”推进到“记住过程细节”。

商品详情已开始持久化回读审批链快照、阻断项快照与同步目标快照，商品页对这些信息的展示已从动作临时回显推进到详情同源回读。

客户反馈接口已新增 repairQueue 与 statusLanes，后台测试反馈页已展示自动档修复队列和状态泳道，P0/P1 可直接进入最近修复包。

已新增 /xia-roadmap/ 公网生产化路线图页，说明微信 AppID、生产数据库、真实 RBAC、地图、短信、COS、支付、日志监控等后续接入事项。

已新增 /xia-guide/ 公网客户演示导览页，按 20 分钟节奏串联验收清单、看板、后台、供应商端、门店端预览、权限矩阵和反馈闭环。

已新增 /xia-acceptance/ 公网验收清单页，并将文档验收项更新为当前真实通过状态，客户可先确认验收结论和限制边界后再进入测试包。

已新增权限矩阵 API 与运营后台页面，展示系统管理员、运营商、业务员、门店角色、龙虾供应商和配料供应商的权限边界，并补客户验收场景。

客户测试包与门店端流程预览已增加反馈登记入口，后台反馈工作台已补测试来源、反馈人、关联对象和建议责任人字段，并修复 DB 模式反馈编号递增冲突。

门店小程序构建脚本已升级为 TypeScript 静态检查，页面类型问题已修复；新增 /xia-store-preview/ 公网流程预览页，客户可先查看门店下单、签收、凭证和账单链路。

已新增 /xia-test/ 公网客户测试包页，并在运营后台首页接入客户自测交付中心；客户可直接按测试入口、运营后台验收路径、供应商端验收路径和反馈分级开始验证。

运营后台与供应商端配送详情已支持查看路线计划、路线节点、运费口径、交接要求和异常关注；自动巡检已覆盖运行中 API 与 DB 模式路线计划接口。