crm-backend-matt/.scratch/customer-frontend-handover/handoff-2026-09-11.md

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 可随时重跑。