Codex
eaf8fdf195
## P0 阻断修复
- 编译：修复实体类与服务类同名导致 Lombok 注解轮次中止的问题
（MatchmakerService/CounselingService -> *Record），196 个编译错误归零
- 权限矩阵：platform_admin 按设计文档收紧为拒绝 5 项高危权限（不改测试阈值）
- 启动：修复 8 组 MyBatis-Plus 同名 bean 冲突（ConflictingBeanDefinition）
与 URL 路由歧义（Ambiguous mapping），应用可正常启动
## 模块收敛（裁决规则：以文件修改时间为准）
- messaging 包整体删除，能力迁移至 chat 包
* 会话列表/详情/未读端点、ConversationDTO、CursorPage
* 消息游标分页统一为 { items, nextCursor }
- relationship 的 Match/UserRelation entity 与 mapper 合并进 match 包
- MatchmakerUserController 合并进 MatchmakerController，删除冗余 Controller
- 补齐 INV-004：chat sendText 增加双向 Block 校验，拉黑后禁止发送
## 契约对齐
- 红娘服务提交请求兼容前端 { requirement } 字段
- 消息与会话分页契约前后端统一
## 测试
- 迁移 6 个风控用例至 ChatSafetyServiceTest
- 清理 messaging 测试包遗留：6 个真实常量断言归位 chat 包，
移除 2 个 assertTrue(true) 占位假测试（Block 真实行为已由
P0FixVerificationTest / RelationshipBlockPriorityPhase08Test 覆盖）
- schema-h2.sql 对齐 PostgreSQL 真实表结构（matches 补列、
conversation_members 改复合主键）
结果：290 tests, 0 failures, 0 errors, 3 skipped, BUILD SUCCESS
138 lines
8.4 KiB
Markdown
138 lines
8.4 KiB
Markdown
# 善缘丹阳 V1.1 代码进度实测与差距评估
|
||
|
||
日期：2026-09-15
|
||
分支：`codex/ui-v11-fidelity`（HEAD `9d73087`，工作区干净，0 未提交）
|
||
方法：**以代码与构建产物为唯一证据**，不采信任何文档中的"已完成 / ✅ / 已部署"声明（依据 AGENTS.md 执行纪律）
|
||
|
||
---
|
||
|
||
## 一、结论先行
|
||
|
||
| 项 | 结论 |
|
||
|---|---|
|
||
| 整体状态 | **NO-GO**（距可验收仍有实质差距） |
|
||
| 代码资产真实完成度 | **约 55%**（显著高于文档自评的 35%，但低于模块覆盖率给人的直觉） |
|
||
| 最致命问题 | **后端 HEAD 源码无法编译**（`HomeApplicationService` 两处硬错误，且已提交入库） |
|
||
| 最危险的合规缺口 | **V1.1 四个新角色零实现** + 唯一失败的测试正是 `PermissionMatrixTest` |
|
||
| 文档可信度 | **严重失真**，且失真方向是*低估*代码、*高估*风险，导致计划与代码脱节 |
|
||
|
||
> 一句话：代码的"宽度"已铺开（模块几乎都有），但"深度"不足（推荐算法是壳、业务闭环断裂），且当前处于**构建断裂**状态。
|
||
|
||
---
|
||
|
||
## 二、三端实测数据
|
||
|
||
### 2.1 后端（Java / Spring Boot）
|
||
|
||
| 指标 | 实测值 | 证据 |
|
||
|---|---|---|
|
||
| Java 源文件 | 约 300 个（Controller 56 / Service 53 / Mapper 56 / DTO 35） | `src/main/java` 统计 |
|
||
| 领域包 | 37 个顶层包 | `com.danyang.match.platform/*` |
|
||
| Flyway 迁移 | **V001–V035** | 文档仅登记到 V027 |
|
||
| 测试类 | 59 个 | `src/test` |
|
||
| 上次成功测试结果 | **293 tests / 1 failure / 0 errors / 3 skipped** | `target/surefire-reports`（快照 2026-09-13） |
|
||
|
||
**V1.1 八大新增模块覆盖（源码级）**
|
||
|
||
| 模块 | 状态 | 说明 |
|
||
|---|---|---|
|
||
| banner | 有 | 仅运营端接口，缺 C 端读接口（靠 home 聚合兜底） |
|
||
| service_location | 有 | 未独立成包，并入 `service_appointment/` |
|
||
| appointment | 有 | 实际包名为 `service_appointment/` |
|
||
| counseling | 有（**双实现**） | `CounselingService`(167行，线上) 与 `CounselingServiceApp`(280行，仅测试引用) 并存 |
|
||
| content | 有 | 分类 + 文章 |
|
||
| service_program | 有 | — |
|
||
| local_eligibility | 有 | — |
|
||
| home | **有但编译失败** | `HomeApplicationService` 两处硬错误 |
|
||
|
||
**Phase 14–18 真实代码量（文档称"暂停"，实际有码）**
|
||
|
||
`activity_mutual` 6 · `appeal` 8 · `risk` 14 · `analytics` 2 · `relationship` 12 · `referral` 2 · `verification` 6 · `review` 11
|
||
|
||
### 2.2 小程序端（63 页）
|
||
|
||
- 完整实现约 **50 页**，空壳 **3 页**（`bind-phone` 45B、`activity-register` 89B、`my-activities` 89B），写死假数据 **7 页**（`service-center`、`service-program`、`service-appointment`、`service-history`、`my-appointments`、`content-detail`、`anti-fraud`）
|
||
- **首页固定结构 10/10 全对**：顶部品牌 / 用户状态 / Banner / 8 核心入口（顺序与命名全对）/ 今日推荐 / 善缘公益服务 / 近期公益活动 / 善缘服务站 / 婚恋课堂 / 安全提醒，且调用真实 `GET /home`
|
||
- 服务层 13 个 + stores 9 个均为真实 HTTP，无 mock 分支
|
||
|
||
### 2.3 管理后台（Vue 3）
|
||
|
||
- 23 个 `.vue`，`src` 共 4858 行；业务模块（Banner/内容/服务站/预约/咨询/专项/审核/用户）**均存在且接真实接口**
|
||
- **架构层空心**：`src/components`、`src/pages`、`src/permissions`、`src/modules/recommendation` **均为空目录**
|
||
- UI 重构仅推广到 3/17 文件，14 个仍用旧内联样式；`theme` 变量与布局硬编码冲突（220px vs 208px）
|
||
|
||
---
|
||
|
||
## 三、与 V1.1 硬规则对账（最关键部分）
|
||
|
||
| 规则 | 要求 | 实测 | 判定 |
|
||
|---|---|---|---|
|
||
| #14/#15 #17 | 首页结构 + 8 入口顺序固定 | 小程序 10/10 符合 | ✅ 通过 |
|
||
| #26 | 入口由服务端 CapabilityService 决定 | `capability/` 包存在（Controller+Service，10 处引用） | ✅ 后端具备 |
|
||
| #16 | Banner 仅内部跳转 | 待验证 target_type 枚举约束 | ⚠️ 待测 |
|
||
| #18/#19/#20 | 活动互选二阶段同意 | `activity_mutual` 有 6 个文件 | ⚠️ 待测 |
|
||
| #22 Counselor 仅 Assigned | — | 有 `CounselingDataScopeTest` | ⚠️ 待测 |
|
||
| #23 ContentEditor 零用户数据 | — | 有 `ContentControllerPermissionContractTest` | ⚠️ 待测 |
|
||
| #24 服务站不可浏览全库 | — | 仅有 `ServiceAppointmentDataScopeTest` | ⚠️ 待测 |
|
||
| **#22–#25 四新角色** | `service_station_operator` / `counseling_manager` / `content_editor` / `counselor` | **管理端 3 个角色 0 次出现**，仅 `counselor` 存在于 `stores/auth.ts` 硬编码假数据 | ❌ **未实现** |
|
||
|
||
> **红线提示**：唯一失败的测试是 `invariants.PermissionMatrixTest`。权限矩阵不通过 + 四个角色未实现，对公益平台属合规级风险，应优先于一切 UI 工作。
|
||
|
||
---
|
||
|
||
## 四、文档 vs 代码的偏差（文档失真清单）
|
||
|
||
| # | 文档声明 | 代码事实 |
|
||
|---|---|---|
|
||
| 1 | "Phase 08 及以后仍暂停" | git 已有 `phase-08`~`phase-13A` 六个 feat 提交；Phase 14–18 相关包亦有代码 |
|
||
| 2 | "未检出独立 CapabilityService" | `capability/` 包存在（提交 `dd58ab6` 即为抽取 CapabilityService） |
|
||
| 3 | "Flyway V001–V027" | 实际 V001–**V035** |
|
||
| 4 | "工作区 55 个未提交改动" | 当前 **0 个**（已收口） |
|
||
| 5 | "277 tests → 4F / 8E / 3S" | 上次快照 **293 tests → 1F / 0E / 3S** |
|
||
| 6 | 自评完成度 35% | 代码资产约 55% |
|
||
|
||
**判断**：文档更新跟不上代码推进，且昨日的评估文档（2026-09-14）结论已有 3 条被证伪。继续执行前必须先重建文档基线，否则计划会持续建立在过期认知上。
|
||
|
||
---
|
||
|
||
## 五、差距清单（按严重度）
|
||
|
||
### P0 — 阻断（必须先修）
|
||
1. **后端编译断裂**：`HomeApplicationService.java` 第 114 行使用未声明的 `userIdentityMapper`；第 133 行使用未 import 的 `LocalEligibility`。已提交入库，`target/classes` 停留在 09-13 19:20，源码 09-14 11:34。首页聚合 API 当前不可用。
|
||
2. **权限矩阵测试失败**：`PermissionMatrixTest` 1 failure，须定位是不变量实现缺陷还是测试用例缺陷。
|
||
3. **V1.1 四个新角色未实现**：管理端角色表单无角色字段，硬规则 #22–#25 无法落地。
|
||
|
||
### P1 — 业务闭环断裂
|
||
4. **小程序服务站链路全断**：`service-center` → 预约 → 我的预约 → 服务记录，4 页全为写死数组，无后端调用。
|
||
5. **登录链路断**：`bind-phone` 为 45 字节空壳。
|
||
6. **活动报名闭环断**：`activity-register` / `my-activities` 为占位；`activity-detail` 渲染写死 `previewActivity`。
|
||
7. **推荐算法是壳**：`MatchEligibilityService` 8 处 TODO（候选池、评分、推荐理由未实现），`RecommendationEngineService` 占位。
|
||
|
||
### P2 — 架构与一致性
|
||
8. 平行重复包：`messaging/` 与 `chat/` 双套会话；`relationship/` 与 `match/` 双套匹配。
|
||
9. `counseling` 双 Service 实现，完整版未接入线上。
|
||
10. 管理端 6 个已注册路由无菜单入口（`/appeals`、`/audit`、`/banner`、`/service-appointment`、`/service-program`、`/matchmaker`）。
|
||
11. 管理端架构目录（components/permissions/recommendation）为空，无复用组件与权限指令。
|
||
12. banner / service_program / home 三个模块**零测试**。
|
||
|
||
---
|
||
|
||
## 六、建议的下一步（顺序不可颠倒）
|
||
|
||
1. **先修 P0-1**：补全 `userIdentityMapper` 声明与 `LocalEligibility` import，`mvn compile` 通过后再谈其他。
|
||
2. **修 P0-2**：定位 `PermissionMatrixTest` 失败原因并清零。
|
||
3. **重建文档基线**：将 V028–V035 迁移、Phase 08–13A 完成状态、CapabilityService 现状写回 `STATUS.md` / `JIRA_BACKLOG.md`，使文档与代码口径一致。
|
||
4. **补 P0-3 角色权限**：这是 V1.1 硬规则，也是公益平台合规底线，优先级高于 UI 打磨。
|
||
5. **再推进 UI 终验**：管理端第二批 + 小程序 C 组，按参考图逐页验收。
|
||
6. **最后补 P1 业务闭环**：服务站 / 登录 / 活动报名三条链路。
|
||
|
||
> 每步完成后暂停，输出完成报告并等待人工验收，不自动进入下一步。
|
||
|
||
---
|
||
|
||
## 附：本次核验方法说明
|
||
|
||
- 代码统计使用 `grep -rl` / Glob 工具（`find` 在本机中文路径下失效，返回 0，已排除该误判）
|
||
- 编译结论为静态分析（未声明变量 + 未 import 类型），并以 `target/classes` 与源码 mtime 差作为交叉验证
|
||
- 测试结论取自 `target/surefire-reports` 汇总，为 2026-09-13 快照，非当前源码状态
|