QiufengandClaude Opus 4.8
5e51dc3f56
恢复点(restore point)。别人改崩后可 git reset --hard 回到此提交。 == 此快照内容 == - 后端 oa-backend: 734 控制器 / 711 实体 (Spring Boot 3.2.5 + SQLite, 端口8091) - 前端 modern-ui/app: Vue3+Vite, 约700页 (构建产物已在 oa-backend/src/main/resources/static) - 数据库 oa-backend/data/oa.db: 含全部演示数据 (强制入库, 6.6MB) - 交接文档 go.md + go-code-reference/endpoints/entities/database.md - 多代理建设脚本 .claude/wf-*.js == 状态 == - 对 凯迪科技ERP_20260507.xlsx 合规 MET ~73.3% (PARTIAL 75: 34可建+6种子/bug+35外部硬天花板) - 安全: 5轮红队+5轮复检, default-deny分级鉴权, 连续零可利用 - W3~W7 累计补完436缺口; W8末轮(40缺口)为半成品(源码树可编译但未集成) - 运行: cd oa-backend; java -jar build/libs/oa-backend-0.1.0.jar --server.port=8091; admin/123456 == 排除(gitignore, 可再生) == node_modules / oa-backend/build / .jdks / *.log / Backup-ERP-* / 弃用的OFBiz核心(只保留modern-ui) 完整文件夹备份见同目录 Backup-ERP-20260615-191517/ (含上述全部, 仅缺 node_modules) 时间戳: 20260615-191517 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
6.4 KiB
6.4 KiB
OFBiz 管理员站点交付说明
modern-ui 的交付目标是一个登录后可直接工作的 ERP 管理员网站。组件、样式和生成页面能力是实现手段，不是最终产品入口。
站点入口
| 入口 | 路径 | 说明 |
|---|---|---|
| 管理员登录 | /modern/app/#/login |
确认 OFBiz 会话，登录后回到目标工作区。 |
| 运营工作台 | /modern/app/#/ |
默认首页，汇总订单、库存、财务、客户、待办、最近记录和系统状态。 |
| 业务办理中心 | /modern/app/#/business |
跨模块检索和分派，优先进入领域工作台。 |
| 领域工作台 | #/orders, #/accounting, #/facility, #/parties 等 |
面向订单、商品、客户、财务、库存、采购、生产、人事、内容、电商、POS、报表、系统等日常办理。 |
| 业务处理页 | #/pages/:pageId |
承接 OFBiz 原页面的查询、表格、表单、动作、权限和操作记录。 |
| 运行控制台 | #/system, #/system/security, #/system/operations |
账号权限、运行任务、日志、缓存和系统工具。 |
管理员旅程
- 登录后进入运营工作台，先看到今日运营、待办队列、最近记录和系统健康。
- 通过左侧模块、顶部核心模块、顶部“更多”或业务办理中心进入领域工作台。
- 在领域工作台处理高频业务，例如订单履约、库存接收、财务结算、客户维护、采购审批、POS、内容发布和报表分析。
- 对需要原 OFBiz 细分页面承接的事项，进入业务处理页继续查询、录入、提交、输出或查看操作记录。
- 权限不足、空记录、运行异常和未启用可选模块必须给出可理解的状态，而不是暴露实现细节。
模块交付矩阵
| 模块 | 主要入口 | 当前交付形态 | 下一步签收重点 |
|---|---|---|---|
| 订单 | #/orders |
订单运营、履约、退货、购物车和订单明细入口 | 支付、状态流转、退货退款、发运联动。 |
| 商品 | #/catalog/products |
商品、分类、价格、促销和库存关联维护 | 价格生效、促销条件、导入导出。 |
| 客户 | #/parties |
客户、组织、角色、联系方式和沟通记录 | 合并客户、权限分支、联系机制验证。 |
| 财务 | #/accounting |
发票、付款、凭证、总账和手工交易入口 | 过账、核销、报表、PDF/CSV 输出。 |
| 库存 | #/facility |
设施、库存、收货、发运、调拨和盘点 | 收货、拣货、库存状态变更。 |
| 采购 | #/procurement |
采购需求、审批、供应商、报价和到货接收 | 需求审批、供应商报价、到货入库。 |
| 生产 | #/manufacturing |
BOM、MRP、生产运行、工序和成本入口 | MRP 执行、生产状态、成本复核。 |
| 人事 | #/humanres |
员工、岗位、招聘、技能和绩效入口 | 入职、岗位、薪资福利权限。 |
| 内容/营销 | #/content, #/marketing |
内容资源、媒体、站点、活动、名单和追踪码 | 上传、发布、审核和活动触达。 |
| 电商/POS | #/commerce, #/pos |
电商购物车、会员订单、门店收银和支付入口 | 购物车、支付、经理授权、退货。 |
| 店铺/报表/扩展 | #/marketplace, #/analytics, #/extensions |
店铺同步、BI/BIRT、价目表、网关和 IT 资产入口 | 报表输出、网关动作、可选模块空状态。 |
| 系统 | #/system |
账号角色、运行监控、日志、任务和缓存 | 权限分支、无 mock 运行验证。 |
页面标准
| 页面类型 | 必须呈现 |
|---|---|
| 领域首页 | 页头、核心指标、处理队列、主表格、快捷动作、异常/空状态。 |
| 查询列表 | 搜索条件、表格、分页、排序、状态、主键入口、空/加载/错误状态。 |
| 新建编辑 | 分组表单、字段校验、lookup、提交反馈、禁用原因。 |
| 审批履约 | 当前状态、可执行动作、处理回执、操作记录和下一步。 |
| 报表输出 | 参数、输出格式、权限提示、下载/打印结果验证。 |
| POS/Commerce | 购物车、客户、商品、支付、授权、退货和库存提示。 |
| 系统管理 | 权限、任务、日志、缓存、运行状态和审计线索。 |
设计系统边界
- 页面代码优先使用
app/src/components/erpwrapper。 - Element Plus 是基础控件库；业务页不直接散写表格、表单、状态色、按钮层级和密度规则。
- 样式入口是
app/src/styles/erp-ui.css，其下依次管理 tokens、Element Plus 覆盖、ERP patterns 和页面布局。 app/UI.md是 wrapper 实现附录；管理员站点交付、验收和范围以本文档、DESIGN.md、UI.md和验证报告为准。
验证边界
| 验证 | 证明 | 不证明 |
|---|---|---|
npm run build |
TypeScript 和生产构建可通过 | 所有业务流程正确。 |
npm run verify:coverage |
旧页面结构映射覆盖 | 逐页业务行为等价。 |
npm run verify:preview |
mock 环境下页面和交互可渲染 | 真实后端链路全通过。 |
npm run verify:admin-runtime |
代表性管理员路由运行健康 | 1767 页全量签收。 |
npm run verify:browser-runtime |
浏览器运行、console 和会话健康 | 支付、上传、报表、权限分支全部完成。 |
npm run verify:parity |
当前业务签收统计 | 当存在 pending 时，不代表全量完成。 |
当前完成口径
- 可以说：现代管理员站点骨架、登录门、业务导航、领域工作台、通用业务页渲染、Element Plus ERP 设计系统和代表性运行验证已经建立。
- 不能说：所有 OFBiz 前端页面已经逐页功能等价完成。
- 当前已知缺口仍包括高风险页面的逐页 E2E、支付/POS、上传、导出/PDF/打印、财务状态流转、权限分支、报表输出和复杂旧页面脚本。
下一批工作
- 建立无 mock 的真实运行验证，记录 session、navigation、inventory、pages、entities、actions、uploads 的状态和 trace。
- 增强生成器和 renderer 的业务语义识别，让 Find/Search/Edit/Admin/Import/Export 页面更稳定落到查询、编辑、动作和输出工作台。
- 补
ErpTabbedDataPanel、ErpFilterBar、增强版ErpDrawer、ErpMetricGrid和ErpWorkQueuePanel，降低复杂工作台的直接 Element Plus 拼装。 - 按高风险队列逐页补业务 E2E，直到 pending 页面持续下降。