统一 Node 22 与后端安全运行基线(07-15-production-trust-closeout-cleanup)
这个提交包含在:
+18
-24
@@ -1,12 +1,12 @@
|
||||
# hyb-oa Client Runbook (P1-5)
|
||||
|
||||
## 1. 前置条件
|
||||
- Node.js >= 20
|
||||
- Node.js `>=22 <23`
|
||||
- 后端服务可用(`http://127.0.0.1:3000`)
|
||||
|
||||
## 2. 安装与启动
|
||||
```bash
|
||||
cd /home/shunli/Projects/hyb-oa/client
|
||||
cd client
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
@@ -15,19 +15,23 @@ npm run dev
|
||||
|
||||
## 3. 本地联调建议顺序
|
||||
```bash
|
||||
cd /home/shunli/Projects/hyb-oa
|
||||
cd ..
|
||||
|
||||
export POSTGRES_PASSWORD="<local-only-db-password>"
|
||||
export JWT_SECRET="<local-only-jwt-secret>"
|
||||
docker compose up -d db
|
||||
|
||||
cd /home/shunli/Projects/hyb-oa/server
|
||||
cd server
|
||||
npm run prisma:migrate:deploy
|
||||
npm run seed:dev
|
||||
SEED_DEV_ALLOW=1 SEED_DEV_DATABASE_CONFIRM=hyb_oa npm run seed:dev
|
||||
npm run dev
|
||||
|
||||
cd /home/shunli/Projects/hyb-oa/client
|
||||
cd ../client
|
||||
npm run dev
|
||||
```
|
||||
|
||||
根级 Compose 要求显式提供本地数据库口令和 JWT 密钥;不要把真实值写入仓库,并让 `server/.env` 的 `DATABASE_URL` 使用同一数据库口令。
|
||||
|
||||
## 3.1 试运行/单域托管部署(推荐)
|
||||
试运行/上线演练建议使用仓库内置部署包(server 托管 `client/dist`,同域 cookie 更稳定):
|
||||
- `deploy/trialrun/runbook.md`
|
||||
@@ -39,19 +43,9 @@ npm run dev
|
||||
- 前端在 401 时自动调用 `/api/auth/refresh` 并重试一次请求。
|
||||
- 登录与刷新请求都会附带 `x-device-fingerprint`。
|
||||
|
||||
## 4.1 开发环境默认账号(seed:dev)
|
||||
仅用于本地联调(`cd server && npm run seed:dev`):
|
||||
## 4.1 开发账号(seed:dev)
|
||||
|
||||
| 角色 | 账号 | 密码 |
|
||||
|---|---|---|
|
||||
| employee | `[email protected]` | `EmployeePassword1234` |
|
||||
| manager | `[email protected]` | `ManagerPassword1234` |
|
||||
| finance | `[email protected]` | `FinancePassword1234` |
|
||||
| finance_mgr | `[email protected]` | `FinanceMgrPassword1234` |
|
||||
| admin | `[email protected]` | `AdminPassword1234` |
|
||||
| ceo | `[email protected]` | `CeoPassword1234` |
|
||||
|
||||
忘记密码:登录页提供邮箱验证码找回;管理员重置密码仍作为试运行/生产兜底。
|
||||
`seed:dev` 仅用于本机开发库,必须显式允许并确认数据库名;账号与口令以本地受控 `SEED_*` 配置为准,脚本不输出口令。默认不会覆盖已有账号密码;新建账号和主动设置 `SEED_DEV_RESET_PASSWORDS=1` 后轮换的账号,首次登录都必须改密。
|
||||
|
||||
## 5. 菜单与权限(当前壳层)
|
||||
- 仪表盘:登录即可访问。
|
||||
@@ -74,7 +68,7 @@ npm run dev
|
||||
- API 层保留后端错误码原文,前端仅做可读化。
|
||||
|
||||
## 6. 风格资源复用策略(锁定)
|
||||
- 视觉 Token 来源:`/home/shunli/Projects/hyb-web`。
|
||||
- 视觉 Token 来源:`<design-source-repo>`。
|
||||
- 采用“复制到 client + 单向同步”,不做跨仓软链与自动联动。
|
||||
- 如需同步风格,请记录来源 commit 并通过评审。
|
||||
|
||||
@@ -90,18 +84,18 @@ npm run test:e2e
|
||||
## 8.1 Playwright E2E(E15)
|
||||
前置:本地启动 DB + server(建议 `SERVE_CLIENT_DIST=true` 单域托管),并启用 mock OCR:
|
||||
```bash
|
||||
cd /home/shunli/Projects/hyb-oa
|
||||
cd ..
|
||||
docker compose up -d db
|
||||
|
||||
cd /home/shunli/Projects/hyb-oa/server
|
||||
cd server
|
||||
OCR_PROVIDER=mock OCR_POLL_CRON="*/5 * * * * *" npm run prisma:migrate:deploy
|
||||
OCR_PROVIDER=mock OCR_POLL_CRON="*/5 * * * * *" npm run seed:dev
|
||||
SEED_DEV_ALLOW=1 SEED_DEV_DATABASE_CONFIRM=hyb_oa OCR_PROVIDER=mock OCR_POLL_CRON="*/5 * * * * *" npm run seed:dev
|
||||
OCR_PROVIDER=mock OCR_POLL_CRON="*/5 * * * * *" SERVE_CLIENT_DIST=true npm run dev
|
||||
```
|
||||
|
||||
执行:
|
||||
```bash
|
||||
cd /home/shunli/Projects/hyb-oa/client
|
||||
cd ../client
|
||||
npm install
|
||||
npx playwright install --with-deps
|
||||
npm run test:e2e
|
||||
@@ -109,7 +103,7 @@ npm run test:e2e
|
||||
|
||||
## 9. 仓库级最小门禁
|
||||
```bash
|
||||
cd /home/shunli/Projects/hyb-oa
|
||||
cd ..
|
||||
./scripts/check-minimal.sh
|
||||
```
|
||||
|
||||
|
||||
在新工单中引用
屏蔽一个用户