 WorkBuddy
|
3ff0c0641a
|
chore(admin): 生产管理端端口 3000 → 13520；守卫扩至三处并容错 CI
生产 admin 容器发布端口原为 127.0.0.1:3000 —— 3000 是本机最易被其他项目
（videoos / ai-callcenter）抢用的端口，与新定的管理端端口 13520 不一致。
已改为 127.0.0.1:13520:80（仍绑定 loopback，对外访问走 nginx 80/443 + /admin/）。
⚠️ 该实体改动无法进入本次提交：infrastructure/docker-compose.prod.yml 位于
.gitignore 的「Secrets and certificates」段，刻意不进版本控制（含按主机定制的
部署参数）。因此本次提交承载的是「决策记录 + 守卫」，端口改动只在部署机生效。
守卫 ui-tests/ui-document-baseline-contracts.mjs：
- 由「两处一致」扩为「三处一致」：admin-web/vite.config.ts（权威声明）、
docs/STATUS.md（给人照做的）、docker-compose.prod.yml（生产发布端口）。
- 生产 compose 采取「存在才断言」：CI 全新克隆上该文件不存在，硬 read() 会抛
ENOENT 让门控假红。已实测——移走文件 → 打印 skip 且 EXIT=0；放回 → 断言恢复。
- 明确排除另外两处管理端入口并写清理由：本地整套栈的管理端经 nginx 6688 暴露
（6688 是 nginx 入口，不是纯管理端端口）；staging 的 3001 是为与生产同机共存
而按「生产 + 1」错开（5433/6380/8081/3001），且被 tests/uat/run-uat.sh 的
UAT_ADMIN_URL 默认值依赖 —— 改动它们要同步消费方，不该由本守卫断言等于 vite 端口。
docs/STATUS.md：新增「管理端端口口径」表，记录四种管理端入口的端口与取舍理由，
并显式标注生产 compose 不在版本控制内（否则后人会以为改了没生效）。
验证：ui-tests 门控 14/14；负向验证 prod compose 改回 3000 → 精准报
「docker-compose.prod.yml=3000，vite.config.ts=13520」；文件缺失 → skip 且不假红；
还原后 md5 逐字节一致（71a30653…）；docker compose config 解析出
published=13520 且 host_ip=127.0.0.1（loopback 绑定未丢失）。
|
2026-09-18 19:49:50 +08:00 |
|
|
WorkBuddy
|
9c26d4b7b2
|
chore(admin-web): 开发端口 3000 → 13520，并禁止端口静默漂移
本机长期并行运行三个项目（videoos / ai-callcenter / 本项目），3000 属最易被
抢用的端口之一。按用户决定改为 13520。
- admin-web/vite.config.ts：server.port 3000 → 13520
- 同处新增 strictPort: true。vite 默认在端口被占用时静默 +1 退到下一个可用端口，
结果是「文档写 13520、实际跑在 13521」且全程不报错 —— 与本项目反复处理的
「声明与兑现失联」同族。加上后端口被占用会直接失败。
- docs/STATUS.md「当前运行状态」同步为 13520。
- ui-tests/ui-document-baseline-contracts.mjs：新增端口一致性守卫。
端口写在两处（vite.config.ts 是权威，STATUS.md 给人照做），只改一处不会让任何
测试变红，却会让照文档操作的人打不开页面。守卫断言的是「两处一致」而非写死
13520 —— 允许改端口，允许的是「一起改」，不是「只改一处」。
两处解析均用「解析失败即失败」写法，避免正则匹配不到时断言退化成与 undefined
比较而失去意义（本项目踩过的守卫静默失效坑）。
用 assert.equal 而非 assert.match：match 失败会把整份 STATUS.md（3000+ 行）
打进报错，噪声会盖掉真正的不一致信息 —— 负向验证时实测确认。
- .gitignore：忽略 admin-web/vite.config.ts.timestamp-*.mjs。
vite 在 dev server 被强杀（未优雅退出）时遗留该配置临时文件，本机已多次出现。
未改动（有意）：
- CORS 不受影响。CorsConfig 默认拒绝所有跨域是刻意设计，且注释已写明「管理端走
Vite 代理（同源）」—— dev 端口变化不产生跨域。
- infrastructure/docker-compose.prod.yml 的 127.0.0.1:3000:80 是生产 admin 容器
的发布端口，与开发服务器无关，未动。
- releases/v1.0.0-RC.* 内的 3000 为历史发布快照，属冻结记录，不改写。
验证
- UI 契约门控 14/14 全绿（含新增守卫）；vue-tsc --noEmit EXIT=0。
- 负向验证：把 STATUS.md 改回 3000 → 守卫变红并精确报出
「管理后台端口不一致：STATUS.md=3000，vite.config.ts=13520」及行号；还原后复绿。
- 真实启停：dev server 实跑 http://localhost:13520/（HTTP 200），旧端口 3000 无监听。
- strictPort 负向验证：端口被占用时第二实例立即以
「Error: Port 13520 is already in use」退出，未漂移到 13521。
- vite build EXIT=0（19.35s）。
注：vite build 直接执行会失败，栈停在 emptyDir(dist) 且全部位于本机
node-safe-delete-shim（批量删除守卫）内，与本次改动无关；改用全新 outDir 复跑即
成功，据此排除「改动导致构建失败」。该现象此前无记录，已写入技能备查。
|
2026-09-18 19:36:07 +08:00 |
|
|
Codex
|
bc4531a734
|
feat(api): 补齐 /me/* 命名空间，恢复 17 个 404 调用 + 修 /me/status 过期桩
背景：小程序 services/*.js 按 REST 规范（§16 / §22-§40 / §80 / §83-§84）统一调用
/me/*，但后端从未注册 /me 基路径，个人资料、照片、择偶条件、隐私设置、关系状态、
我的举报/申诉等约 17 个调用全部 404。
后端
- 新增 me/controller/MeController：把既有 service 能力暴露到规范路径（纯委托，不复制
业务规则，AGENTS.md #26）。旧路径（/profile/*、/photos、/relationship/*、
/account/privacy-settings、/risk/reports/my、/appeals/my）全部保留。
- 响应形状按小程序 JSDoc 适配（小程序被 86 页引用，是权威契约）：
· /me/relationship-status 返回 status（旧 /relationship/status 返回 relationshipStatus，
字段名不同，前端读的是 result.status）
· /me/profile/review-status 返回 {status, items, submittedAt, reviewedAt}，时间统一 epoch 毫秒
· /me/profile/submit-review 返回 {reviewStatus, submittedAt}
- 小程序三条历史写法一并兼容：/me/privacy-settings、/me/photos/{id}/main、/me/appeals
修复
- AuthService.getMeStatus：verified / profileStatus / reviewStatus 三项写死为
false / not_started / not_submitted，注释标注"Phase 03/04/05 填充"，但那三个 Phase
早已交付，导致 /me/status 长期返回错误的实名与审核状态。改为 capabilityService
+ userProfileMapper + reviewTaskMapper 的真实来源（与首页聚合同一判定）。
- PhotoController.deletePhoto：原用 ((Map<?,?>) p).get("id") 强转 UserPhoto 实体，
必然抛 ClassCastException，删除照片恒定 500。改用实体主键比对。
- PhotoService.setMainAvatar（新增）：数据模型以 photo_type='avatar' 标识头像（见
UserPhotoMapper#findAvatar），无 is_main 字段，故"设主图"= 换类型并保证至多一张。
注意：插入该方法时曾把 deletePhoto 原有的 @Transactional 挤到新方法上，导致
"Transactional is not a repeatable annotation" 并引发 Lombok 全面停摆（满屏
找不到 getter/setter），已修正注解归属。
验证
- 后端全量：299 tests / 0 failures / 0 errors / 3 skipped / BUILD SUCCESS（+2 为新增契约测试）
- 新增 MeRouteContractTest（2 例）：同时断言 HTTP 方法，锁定 21 条 /me/* 与 13 条旧路径
- 小程序 tsc --noEmit 通过；UI 契约门禁 13/13
文档
- STATUS.md：/me/* 从"待裁决"改为"已完成"；核心待清债务 1 项 → 0 项
- API_INVENTORY.md：顶部"待收敛"警告改为"已收敛"，补全 /me/* 端点表
|
2026-09-16 12:54:39 +08:00 |
|
|
Codex
|
93fc9b0d88
|
feat(miniapp): migrate C-group pages to TypeScript, update contracts
|
2026-09-14 10:14:05 +08:00 |
|
|
Codex
|
c66e42dd8a
|
docs: retire conflicting UI baselines
|
2026-09-13 21:12:50 +08:00 |
|