You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
45 lines
3.9 KiB
45 lines
3.9 KiB
2 days ago
|
# HANDOFF — customer-frontend-handover（2026-09-11）
|
||
|
|
|
||
|
|
**一句话状态**：地图 6 票全 resolved——workspace focusFlag 代码+文档双落地、主 demo 单入口收编 12 联系人端点、A4 39 页审计零缺接口（P1×1 当轮修复）、E2E 四套件 + 主 demo 冒烟全绿复跑、Bruno 文档 85/85 零缺零余并按原型树对齐；**双仓 git 均未提交，等用户审查后进入发版**。
|
||
|
|
|
||
|
|
## 权威入口
|
||
|
|
|
||
|
|
| 主题 | 路径 |
|
||
|
|
|---|---|
|
||
|
|
| 地图（决策台账） | `.scratch/customer-frontend-handover/map.md`（Decisions 六行全） |
|
||
|
|
| 票 Answer | `.scratch/customer-frontend-handover/issues/01..06-*.md` |
|
||
|
|
| A4 审计四件套 | 同目录 `mapping-a4-pages.md` + `matrix-a4-1-a4-3/a4-4/a4-5-a4-7.md` + `gap-report.md` |
|
||
|
|
| E2E 报告（含移交增章） | `.scratch/customer-e2e/e2e-report.md` §九（复跑台账/对账/验收增量/亲手指北） |
|
||
|
|
| Bruno 文档仓 | `E:\code\crm-api-docs`（对账脚本 `bruno-audit-t05.py`，PASS 85/85） |
|
||
|
|
| 契约权威 | `.scratch/customer-module/API-SUMMARY.md`（85 端点，§2.1 focusFlag 已登记，零漂移） |
|
||
|
|
|
||
|
|
## 用户接下来做什么
|
||
|
|
|
||
|
|
1. **审查并提交 git**（两仓）：
|
||
|
|
- 后端仓：票 01 `CustomerListRowDTO/mapper` focusFlag、票 03 导入预检必填 + 测试、票 05 两行 @Tag 注释级、`.scratch/` 全部产物；
|
||
|
|
- 文档仓 `E:\code\crm-api-docs`：M×3（workspace focusFlag）+ D×11 + ??×11（结构迁移）；A5 区另有**本 effort 之前**的既有未提交变更，与本图无关。
|
||
|
|
2. **亲手验收**：e2e-report §9.4 指北（起服 → demo?api= → uid 直登 → 按 §9.3 增量步卡过）。
|
||
|
|
3. **测试环境发版**：见下节清单。
|
||
|
|
|
||
|
|
## 发版移交清单（测试环境 https://ai.itc.vip/crm-api）
|
||
|
|
|
||
|
|
0. **建议时点**：用户提交 git 后重跑 `clean package -DskipTests -s settings.xml`（IDEA 捆绑 maven + corretto-17，禁 `-pl`/`-rf`），使 jar = 提交后源码。当前 `crm-app/target/crm-app-1.0.0-SNAPSHOT.jar`（124MB，2026-09-11 0:57，票 04 构建）其后仅有 2 行 @Tag 注释级差异，无行为影响——直接用亦可。
|
||
|
|
1. **上传**：`scp crm-app/target/crm-app-1.0.0-SNAPSHOT.jar <user>@<test-host>:<服务器项目根>/`（restart.sh 约定 jar 放项目根）。
|
||
|
|
2. **重启**：服务器上 `./deploy/restart.sh`（docker compose 仅重建 crm-app，mysql/redis/minio/nginx 不动；基础镜像 `crm-runtime:latest` 缺失时自动首次构建）。
|
||
|
|
3. **复验**：
|
||
|
|
- `py -X utf8 .scratch/customer-defectfix/acceptance-probe-testenv.py`（ping 401 鉴权门 / verify debug token / mine+pool 存量与字典 / 构建新鲜度：POST edit 不带 version → 67005 = 新构建）；
|
||
|
|
- 本图新增新鲜度手验：`POST /api/customer/workspace/page`（workspace=mine）出参行含 **focusFlag** = 票 01 已上（demo 直连 `?api=https://ai.itc.vip/crm-api` 看列表关注列，或 curl）。
|
||
|
|
4. 回滚：旧 jar 留档后覆盖即可（restart.sh 重挂）。
|
||
|
|
|
||
|
|
## 余项（记档可翻案，非阻塞验收）
|
||
|
|
|
||
|
|
- P2×6（D-G1 豁免不修）/ P3×6：`gap-report.md`；战略协议 CRUD Bruno 示例值为推导值（无 E2E 覆盖，翻案需先补套件再重注入）；pool·board 白名单漂移 probe（实测 code=0，设计口径记档）。
|
||
|
|
|
||
|
|
## 环境事实（本机）
|
||
|
|
|
||
|
|
- 本地起服：verify profile + `CRM_MINIO_AK/SK`（值见 map.md「环境事实」节）；DB 默认远程共享库 8.129.84.155（凭据内置 application.yml）。
|
||
|
|
- API 套件解释器 `py -X utf8`（3.13.3，requests/pymysql/openpyxl 全备）；Playwright 冒烟专用 `.scratch/customer-e2e/.venv10`。
|
||
|
|
- 构建：IDEA 捆绑 maven 3.9.9（`D:\IntelliJ IDEA 2025.1.3\plugins\maven\lib\maven3\bin\mvn.cmd`）+ `JAVA_HOME=C:\Users\Administrator\.jdks\corretto-17.0.13`。
|
||
|
|
- 当前 8080 已停（票 04 收尾）；种子活跃 e2c-*=16 = seed 本底；heavy 复跑副作用还原口诀见 map.md。
|
||
|
|
- Bruno 同步走 `/bruno-sync` skill（config/local 双配置就绪）；对账 `bruno-audit-t05.py` 可随时重跑。
|