49 行
3.7 KiB
Markdown
49 行
3.7 KiB
Markdown
# Implementation Notes
|
||
|
||
## Scope Implemented
|
||
|
||
- Wave 0: wrote `research/ux-audit-matrix.md` with global findings, Wave 2 page audit and Wave 3-5 follow-up grouping.
|
||
- Wave 1: updated global shell, sidebar, topbar, page headers and shared layout classes.
|
||
- Wave 2: refined login, forgot password, portal, workflow tasks, reimbursements, reimbursement detail and notifications with clearer hierarchy and next-step language.
|
||
|
||
## UX Decisions
|
||
|
||
- Visual direction: precise, restrained OA operations console.
|
||
- Navigation groups now reflect user tasks: 工作、业务、财务、管理、更多.
|
||
- Search is presented as a command entry in the Topbar.
|
||
- Notifications now behave as an inbox and return to the workbench, not the legacy dashboard.
|
||
- Login and password reset retain the generic “如账号可用” copy to avoid account enumeration.
|
||
- Wave 3-5 stay as follow-up tasks because they require different validation surfaces.
|
||
|
||
## Validation
|
||
|
||
- `cd client && npm run typecheck` — PASS.
|
||
- `cd client && npm run build` — PASS.
|
||
- `cd client && npx playwright test tests/e2e/pc-core-workflow-visual-wave2.spec.ts tests/e2e/login-portal-ux.spec.ts --workers=1 --reporter=list` — PASS, 11 tests.
|
||
- `cd client && npx playwright test tests/e2e/r89-mobile-login-navigation.spec.ts --workers=1 --reporter=list` — PASS, 3 tests.
|
||
- `cd client && npx playwright test tests/e2e/visual-shell.spec.ts tests/e2e/r103-cross-page-ui-consistency.spec.ts --workers=1 --reporter=list` — PASS, 8 tests.
|
||
- `python3 ./.trellis/scripts/task.py validate 05-28-frontend-ux-redesign` — PASS.
|
||
- `node scripts/qa/check-trellis-governance.mjs` — PASS.
|
||
- `git diff --check` — PASS.
|
||
|
||
## Deployment And Public Verification
|
||
|
||
- 用户已批准将本轮 Wave0-2 前端体验重构部署到公网 OA。
|
||
- 部署命令：`SYNC_ENV=0 LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash deploy/trialrun/deploy.sh`
|
||
- 部署边界：未同步本地 `.env`，未改远端配置，未执行真实付款、ERP 写入或企业微信写入。
|
||
- 首次部署后 live smoke 暴露旧断言：测试仍查找旧导航文案“备用模块”。已修正 live/视觉测试基线为新导航“更多”，并提交 `1f13dd9`。
|
||
- 重新部署结果：远端前端构建通过，Prisma migration deploy/status 显示无待执行 migration，部署脚本内置 live smoke 3 passed，公网资源文案扫描 findings=0。
|
||
- 独立公网 readiness：
|
||
- `LIVE_SMOKE_READINESS_DIR=.trellis/tasks/05-28-frontend-ux-redesign/research/postdeploy-20260528-wave0-2-public/live-smoke-readiness LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh` — PASS。
|
||
- 真实 OCR 样票复核返回 `duplicate_or_same_invoice` 可解释终态，测试通过；pending OCR 扫描因本地未提供 `DATABASE_URL` 记录 `SKIP`。
|
||
- 完整只读巡检：
|
||
- `OAOPS1_REPORT_DIR=.trellis/tasks/05-28-frontend-ux-redesign/research/postdeploy-20260528-wave0-2-public/oa-real-use-daily LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-oa-real-use-daily.sh` — `PASS_OA_REAL_USE_DAILY_READY`，findingCount=0。
|
||
- 通过检查：`public-ready`、`live-smoke-env`、`live-readiness`、`oa-only-smoke-readiness`、`live-feature-flags`、`authenticated-readonly-probe`、`mobile-entry-matrix`、`wecom-rendering-matrix`、`wecom-entry`、`report-privacy-smoke`。
|
||
- 证据目录：`research/postdeploy-20260528-wave0-2-public/`。
|
||
- 非阻断提示：部署同步时远端历史 `artifacts/qa-flow/wecom-controlled-trial-evidence-20260520-205320` 目录仍无法自动删除；不影响本次部署、构建或公网检查。
|
||
|
||
## Not Done In This Task
|
||
|
||
- No backend permission, workflow, status-machine or data model changes.
|
||
- Wave 3-5 pages are recorded for follow-up tasks, not completed here.
|