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>
84 lines
4.5 KiB
Markdown
84 lines
4.5 KiB
Markdown
# OFBiz Modern UI
|
|
|
|
`plugins/modern-ui` is the Vue 3 + Element Plus administrator UI for OFBiz. It provides the `/modern/app/` shell, domain workspaces, generated business-page renderer, ERP wrapper components, generated page assets, and verification artifacts.
|
|
|
|
This plugin is structurally broad, but it is not documented here as a fully signed-off replacement for every legacy OFBiz frontend behavior. Current status and remaining parity work are tracked in `MIGRATION_STATUS.md` and the verification reports.
|
|
|
|
## Read First
|
|
|
|
| Need | Document |
|
|
| --- | --- |
|
|
| What the administrator website delivers, how operators enter it, and what remains to sign off | `DELIVERY.md` |
|
|
| How to build pages, choose wrappers, call components, and organize layout/logic | `../../UI.md` |
|
|
| Product/design contract, visual rules, and completion boundary | `../../DESIGN.md` |
|
|
| Plugin-local usage notes | `UI.md` |
|
|
| Plugin-local design brief | `DESIGN.md` |
|
|
| Current migration status and true parity gap | `MIGRATION_STATUS.md` |
|
|
| App-local component handbook | `app/UI.md` |
|
|
| App-local design checklist | `app/DESIGN.md` |
|
|
|
|
## Code Map
|
|
|
|
| Concern | Path |
|
|
| --- | --- |
|
|
| SPA entry | `app/src/main.ts` |
|
|
| Route selection and login gate | `app/src/App.vue` |
|
|
| Global shell | `app/src/components/erp/ErpAppShell.vue` |
|
|
| Module catalog | `app/src/data/moduleCatalog.ts` |
|
|
| Generated business route | `app/src/views/BusinessPageView.vue` |
|
|
| PageDefinition renderer | `app/src/components/erp/ErpPageRenderer.vue` |
|
|
| Adapter/workspace dispatch | `app/src/components/erp/ErpAdapterBlock.vue` |
|
|
| ERP wrappers | `app/src/components/erp/*.vue` |
|
|
| API, action, lookup, option, entity, fallback services | `app/src/services/*.ts` |
|
|
| Tokens and style stack | `app/src/styles/erp-ui.css`, `tokens.css`, `element-overrides.css`, `erp-patterns.css`, `modern.css` |
|
|
| Generated assets served by the plugin | `webapp/modern/app/generated` |
|
|
| Verification reports and screenshots | `verification/` |
|
|
|
|
## Wrapper-First Rule
|
|
|
|
Business pages use Element Plus through ERP wrappers:
|
|
|
|
```text
|
|
PageDefinition / domain route
|
|
-> ErpPageRenderer, ErpAdapterBlock, or domain workspace
|
|
-> ErpSearchForm, ErpEntityForm, ErpDataTable, ErpActionBar, ErpStatusTag, ErpLookup, ErpUpload, ErpDrawer
|
|
-> Element Plus primitives
|
|
```
|
|
|
|
Use direct Element Plus only for local primitives such as tabs, alerts, empty/loading states, dialogs, confirmations, descriptions, timelines, and small local buttons/tags. Do not scatter raw `el-form`, `el-table`, action strips, state colors, spacing, radius, shadows, or deep Element Plus overrides across business views.
|
|
|
|
## Styling Contract
|
|
|
|
- `app/src/styles/tokens.css` owns color, type, spacing, radius, control height, table density, and card density.
|
|
- `app/src/styles/element-overrides.css` maps Element Plus variables and base component behavior to ERP tokens.
|
|
- `app/src/styles/erp-patterns.css` owns reusable ERP form/table/panel/status/action/upload/detail patterns.
|
|
- `app/src/styles/modern.css` owns shell, route, generated-page, and domain layout composition.
|
|
- Business views may add local CSS only for narrow page placement, and must still use ERP tokens.
|
|
|
|
## Current Parity Boundary
|
|
|
|
Use the checked-in status artifacts for claims:
|
|
|
|
- Structural coverage is established for the scanned legacy view surface.
|
|
- The current migration status reports 1772 legacy view routes, 1767 unique generated pages, 0 unsupported block types, and 112 screenshots.
|
|
- The current parity artifact reports 46 verified business parity pages, 1721 pending business E2E pages, 876 high-risk pending pages, and 4 Accounting runtime-smoke pages.
|
|
- Generated renderability, adapter coverage, and screenshots do not prove all legacy side effects, report output, permission branches, validation, uploads, exports, POS/cart/payment, or JavaScript behavior are equivalent.
|
|
|
|
Safe wording: "structural coverage established", "Element Plus renderer coverage present", "ready for business E2E", and "representative runtime smoke passed".
|
|
|
|
Do not write "full parity complete", "全量业务等价完成", or "全量 OFBiz 前端等价重构已完成" unless the verification artifacts show no pending business E2E or high-risk parity work.
|
|
|
|
## Verification
|
|
|
|
Run these from `app/` when code or generated assets change:
|
|
|
|
```bash
|
|
npm run build
|
|
npm run verify:coverage
|
|
npm run verify:preview
|
|
npm run verify:parity
|
|
npm run verify:browser-runtime
|
|
```
|
|
|
|
Documentation-only changes do not require a build. At minimum, run an `rg` check against the edited docs to confirm they do not claim full parity as fact.
|