# 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` | 账号权限、运行任务、日志、缓存和系统工具。 |

## 管理员旅程

1. 登录后进入运营工作台，先看到今日运营、待办队列、最近记录和系统健康。
2. 通过左侧模块、顶部核心模块、顶部“更多”或业务办理中心进入领域工作台。
3. 在领域工作台处理高频业务，例如订单履约、库存接收、财务结算、客户维护、采购审批、POS、内容发布和报表分析。
4. 对需要原 OFBiz 细分页面承接的事项，进入业务处理页继续查询、录入、提交、输出或查看操作记录。
5. 权限不足、空记录、运行异常和未启用可选模块必须给出可理解的状态，而不是暴露实现细节。

## 模块交付矩阵

| 模块 | 主要入口 | 当前交付形态 | 下一步签收重点 |
| --- | --- | --- | --- |
| 订单 | `#/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/erp` wrapper。
- 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/打印、财务状态流转、权限分支、报表输出和复杂旧页面脚本。

## 下一批工作

1. 建立无 mock 的真实运行验证，记录 session、navigation、inventory、pages、entities、actions、uploads 的状态和 trace。
2. 增强生成器和 renderer 的业务语义识别，让 Find/Search/Edit/Admin/Import/Export 页面更稳定落到查询、编辑、动作和输出工作台。
3. 补 `ErpTabbedDataPanel`、`ErpFilterBar`、增强版 `ErpDrawer`、`ErpMetricGrid` 和 `ErpWorkQueuePanel`，降低复杂工作台的直接 Element Plus 拼装。
4. 按高风险队列逐页补业务 E2E，直到 pending 页面持续下降。