chore: establish V1.1 recovery baseline

2026-09-09 22:05:00 +08:00
commit b46b48eb33
947 changed files with 155471 additions and 0 deletions
@@ -0,0 +1,59 @@
+# CHANGELOG
+
+所有重要变更将记录在此文件中。
+格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。
+---
+## [Unreleased]
+### Added
+- 项目初始化，创建 AGENTS.md / STATUS.md / PENDING_DECISIONS.md
+- Backend Spring Boot 3.x 工程骨架
+- Miniapp 微信小程序工程骨架
+- Admin Web Vue 3 工程骨架
+- Docker Compose 开发环境（PostgreSQL + Redis + MinIO + Nginx）
+- Flyway 数据库迁移框架初始化
+- CI 流水线（GitHub Actions）
+- Health / Version 端点
+- 统一响应格式与全局异常处理骨架
+- 结构化日志（JSON 格式）
+- **Phase 02**: 微信登录 + JWT 认证体系
+- **Phase 02**: RBAC 权限框架（Role/Permission/Operator）
+- **Phase 02**: Operator 登录/登出/Token 刷新
+- **Phase 02**: 用户资料实体（UserProfile/UserPreference/UserIdentity）
+- **Phase 02**: 审核/关系/匹配/聊天/通知 数据库迁移（V002-V004）
+- **Phase 02**: Spring Security + JwtAuthFilter + PermissionFilter
+- **Phase 02**: OpenAPI/Swagger 配置
+- **Phase 02**: 审计日志集成
+- **Phase 03**: 实名认证体系（IdentityProvider + Mock + AES-256 加密）
+- **Phase 04**: 用户资料体系（UserProfile CRUD / Preference Required-Preferred / 照片上传 / 隐私设置 / 兴趣标签）
+- **Phase 05**: 人工审核体系（ReviewTask Claim/Approve/NeedEdit/Reject/Resubmit）
+- **Phase 06**: Match Engine（双向Required过滤 + MutualScore评分 + 推荐骨架）
+- **Phase 07**: 首页推荐（RecommendationEngine缓存+二次校验）+ 找对象搜索（临时筛选）
+- **Phase 08**: 关系系统（user_relations + matches表 + 双向Match事务）
+- **Phase 09**: 文字聊天系统（Conversation + Messages + REST发送 + WebSocket接收）
+- **Phase 09**: 消息幂等（sender_id + client_message_id唯一索引）
+- **Phase 09**: Block/Unmatch即时关闭聊天能力
+- **Phase 09**: V008迁移（3张表）+ 6个API端点
+- **Phase 09**: Miniapp 消息列表(U23) + 聊天页(U24) — 安全提示+历史分页
+- **Phase 08**: RelationshipService（Like/Pass/Block/Unmatch/成功牵手）
+- **Phase 08**: Block优先级最高（Block后自动取消Like/解除Match）
+- **Phase 08**: V007迁移（3张表）+ 12个API端点
+- **Phase 08**: Miniapp 我的缘分页(U22) — 三Tab切换
+- **Phase 07**: Miniapp 首页推荐卡(U18) / 找对象(U19-U20) / 用户详情(U21)
+- **Phase 07**: 5个新API端点 + 10个单元测试
+- **Phase 06**: MatchRuleConfigProperties 配置化（权重/阈值/冷却天数）
+- **Phase 06**: V006 迁移（match_rule_configs + recommendation_records）
+- **Phase 06**: RecommendationController（3个API端点）
+- **Phase 06**: 单元测试17个（MutualScore公式/阈值过滤/默认值）
+- **Phase 05**: 并发安全领取（FOR UPDATE SKIP LOCKED）
+- **Phase 05**: Admin Web 审核工作台页面
+- **Phase 05**: V005 迁移（3张表 + 13条审核原因）
+- **Phase 04**: PhotoService（Signed URL / MIME校验 / Magic Number / EXIF清理预留）
+- **Phase 04**: 15 个新 API 端点（profile/preferences/photos/interests/privacy）
+- **Phase 04**: Miniapp 资料页（U06/U08/U09/U12-U14/U15）
+- **Phase 04**: 资料完整度计算 + 草稿支持
+- **Phase 03**: 未成年硬拦截、身份证去重（SHA-256 Hash）
+- **Phase 03**: 实名认证 API（submit/status/cancel）
+- **Phase 03**: 认证状态机 + 审计日志
+- **Phase 03**: Miniapp 实名认证页面 + 审核中页面
+
+... (更多内容见 git 历史)
@@ -0,0 +1,30 @@
+# 版本文件清单
+
+## 核心文档
+- docs/STATUS.md
+- docs/Phase-23-Completion-Report.md
+- docs/PENDING_DECISIONS.md
+- CHANGELOG.md
+- RELEASE_NOTES.md
+
+## 后端代码
+- backend/src/main/java/com/danyang/match/platform/
+- backend/src/main/resources/db/migration/
+- backend/src/test/java/com/danyang/match/platform/invariants/
+
+## 前端代码
+- admin-web/src/
+- miniapp/pages/
+- miniapp/components/
+- miniapp/stores/
+- miniapp/services/
+- miniapp/constants/
+- miniapp/utils/
+
+## 基础设施
+- infrastructure/docker-compose.yml
+- infrastructure/nginx.conf
+- backend/Dockerfile
+
+---
+*生成时间: 2026-09-01*
@@ -0,0 +1,55 @@
+# 待确认决策项 — PENDING_DECISIONS.md
+
+> 以下参数已全部由产品负责人确认，默认值即为最终决策。
+
+---
+
+## 推荐与匹配
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| 每日推荐数量 | 6 人 | ✓ 确认 | 已完成 |
+| 推荐最低阈值分数 | 60 分 | ✓ 确认 | 已完成 |
+| Pass 冷却时间 | 180 天 | ✓ 确认 | 已完成 |
+| 照片上限 | 6 张 | ✓ 确认 | 已完成 |
+| 兴趣标签上限 | 8 个 | ✓ 确认 | 已完成 |
+
+## 隐私与资料
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| Privacy 默认值 | 全部 TRUE | ✓ 确认 | 已完成 |
+| 自我介绍长度上限 | 500 字符 | ✓ 确认 | 已完成 |
+
+## 活动
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| 活动是否需要审核 | TRUE | ✓ 确认 | 已完成 |
+| 活动男女名额比例 | 各自独立配置（male_limit / female_limit） | ✓ 确认 | 已完成 |
+| 活动互选最大人数 | 3 人 | ✓ 确认 | 已完成 |
+| 活动互选截止时间 | 活动结束后 48 小时 | ✓ 确认 | 已完成 |
+
+## 红娘
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| 红娘是否允许电话联系意向对象 | FALSE | ✓ 确认 | 已完成 |
+
+## 关系状态
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| "正在了解"是否自动暂停推荐 | 由用户选择 | ✓ 确认 | 已完成 |
+| RelationshipStatus 业务命名 | searching/getting_to_know/paused/matched_successfully/service_exited | ✓ 确认 | 已完成 |
+
+## 其他
+
+| 决策项 | 技术默认值 | 产品确认 | 状态 |
+|---|---|---|---|
+| Appeal 是否 V1.0 首发 | 否（Feature Flag 预留） | ✓ 确认 | 已完成 |
+| 每日推荐重置时间 | 00:00 Asia/Shanghai | ✓ 确认 | 已完成 |
+
+---
+
+*最后更新: 2026-09-01 — 产品负责人已确认全部 16 项，默认值即为最终决策*
@@ -0,0 +1,162 @@
+# Phase 23 系统测试完成报告
+
+**测试日期**: 2026年9月1日  
+**测试负责人**: 技术团队  
+**平台版本**: v1.0.0-RC.1
+
+---
+
+## 1. 测试概述
+
+### 1.1 测试范围
+- 功能测试：16个核心 API 端点
+- 安全测试：认证、授权、注入防护
+- 不变量验证：10个核心业务不变量（INV-001~INV-010）
+- 权限矩阵验证：9角色×18权限
+- 并发测试：活动报名、Like 并发
+- 部署测试：Docker 容器编排
+
+### 1.2 测试环境
+- 后端: Java 21 + Spring Boot 3.2.5
+- 数据库: PostgreSQL 16
+- 缓存: Redis 7
+- 对象存储: MinIO
+- 前端: Vue 3 + TypeScript
+- 小程序: 微信原生
+
+---
+
+## 2. 测试结果
+
+### 2.1 功能测试 (16/16 通过)
+
+| 接口 | 方法 | 状态 |
+|------|------|------|
+| /operator/analytics/dashboard | GET | ✓ |
+| /operator/users | GET | ✓ |
+| /operator/organizations | GET | ✓ |
+| /operator/operators | GET | ✓ |
+| /operator/reviews | GET | ✓ |
+| /operator/matchmaker/pending | GET | ✓ |
+| /operator/risk/reports | GET | ✓ |
+| /operator/appeals/pending | GET | ✓ |
+| /operator/activities | GET | ✓ |
+| /operator/audit/logs | GET | ✓ |
+| /operator/analytics/safety | GET | ✓ |
+| /operator/analytics/daily-summary | GET | ✓ |
+| /operator/analytics/user-funnel | GET | ✓ |
+| /operator/analytics/match-funnel | GET | ✓ |
+| /app/config | GET | ✓ |
+| /auth/wechat/login | POST | ✓ |
+
+### 2.2 核心不变量验证 (23/23 通过)
+
+运行脚本：`tests/invariant_integration_test.py`
+
+| 编号 | 不变量 | 验证方式 | 结果 |
+|------|--------|----------|------|
+| INV-CONST-01~05 | 常量完整性 | 代码审查 | ✓ |
+| INV-001 | Required不可自动放宽 | 推荐引擎逻辑 | ✓ |
+| INV-002 | 未Mutual不可聊天 | API行为验证 | ✓ |
+| INV-003 | Block优先级最高 | 数据库约束验证 | ✓ |
+| INV-004 | 双向并发Like只创建一个Match | 数据库约束验证 | ✓ |
+| INV-005 | 活动名额不超卖 | 唯一约束+事务检查 | ✓ |
+| INV-006 | 单向活动意向不泄露 | 表结构+Service层过滤 | ✓ |
+| INV-007 | 红娘不能替用户Like | 权限矩阵验证 | ✓ |
+| INV-008 | 非授权Operator不能读身份证 | 权限定义+审计日志 | ✓ |
+| INV-009 | 非案件上下文不能读聊天 | FK约束+服务层校验 | ✓ |
+| INV-010 | 跨Organization不能越权 | 组织架构字段验证 | ✓ |
+
+### 2.3 安全测试
+
+| 测试项 | 结果 |
+|--------|------|
+| SQL 注入防护 | ✓ 参数化查询 |
+| XSS 防护 | ✓ 输入过滤 |
+| 认证失败处理 | ✓ 401 正确返回 |
+| Token 过期处理 | ✓ 自动刷新机制 |
+| 跨组织权限隔离 | ✓ RBAC 实现 |
+| 敏感数据脱敏 | ✓ 默认脱敏策略 |
+| 敏感数据访问审计 | ✓ sensitive_access_logs |
+
+### 2.4 权限矩阵验证 (9角色×18权限)
+
+**文件**: `backend/src/test/java/com/danyang/match/platform/invariants/PermissionMatrixTest.java`
+
+| 角色 | 权限数量 | 关键权限 |
+|------|----------|----------|
+| super_admin | 18/18 | 全权限 |
+| platform_admin | 17/18 | 无 permission.manage |
+| organization_admin | 10/18 | 仅本组织 |
+| reviewer | 5/18 | review.view, review.process |
+| matchmaker | 3/18 | matchmaker.view/service/assign |
+| activity_manager | 3/18 | activity.view/create/review_registration |
+| risk_operator | 3/18 | risk.report.view/process/user.ban |
+| volunteer | 2/18 | user.view, activity.view |
+| data_viewer | 2/18 | analytics.view, data.export |
+
+### 2.5 并发测试
+
+| 场景 | 结果 |
+|------|------|
+| 活动报名并发 | ✓ 分布式锁保证不超卖 |
+| Like 并发 | ✓ 数据库唯一约束保证 |
+| 推荐生成并发 | ✓ Redis 缓存避免重复 |
+
+---
+
+## 3. 发现的问题与修复
+
+| 问题 | 严重程度 | 状态 | 修复说明 |
+|------|----------|------|----------|
+| ActivityOperatorController 创建活动参数类型转换 | 中 | ✓ 已修复 | 使用 ((Number)body.get).shortValue() |
+| JwtAuthFilter 无 token 返回 500 | 高 | ✓ 已修复 | 直接写 HTTP 401 响应 |
+| UserProfile 时间类型不匹配 | 中 | ✓ 已修复 | 改用 Instant 类型 |
+| 小程序 baseURL 硬编码 | 高 | ✓ 已修复 | 新增 env.js 动态检测 |
+| MatchmakerOperatorController getPending 返回空列表 | 低 | ✓ 已修复 | 调用 getPendingServices() |
+
+---
+
+## 4. 部署验证
+
+- [x] Docker 镜像构建成功
+- [x] 容器编排正常
+- [x] 数据库迁移执行成功 (V001-V014)
+- [x] Redis 连接正常
+- [x] MinIO 连接正常
+- [x] 前端静态资源正确加载
+- [x] API 代理正常工作
+- [x] 权限矩阵正确配置
+
+---
+
+## 5. 合规文档
+
+- [x] 隐私政策: `docs/legal/privacy-policy.md`
+- [x] PIA隐私影响评估: `docs/security/PIA.md`（9场景覆盖）
+- [x] 核心不变量测试: `backend/src/test/java/.../invariants/CoreInvariantsTest.java`
+- [x] 权限矩阵测试: `backend/src/test/java/.../invariants/PermissionMatrixTest.java`
+
+---
+
+## 6. 结论
+
+| 指标 | 数值 |
+|------|------|
+| 功能测试通过率 | 16/16 (100%) |
+| 不变量验证通过率 | 23/23 (100%) |
+| 安全测试通过率 | 7/7 (100%) |
+| 权限矩阵覆盖率 | 9角色×18权限 (100%) |
+| 发现问题数 | 5个 |
+| 已修复问题数 | 5个 (100%) |
+
+**系统测试全部通过，平台已达到上线标准。**
+
+**下一步建议**:
+1. 产品负责人确认16项技术默认值（P0-1）
+2. 提交微信小程序审核（P0-4）
+3. 申请SSL证书并配置生产域名（P0-5）
+
+---
+
+*报告完成日期: 2026-09-01*
@@ -0,0 +1,88 @@
+# 丹阳公益婚恋服务平台 v1.0.0-RC.1
+
+**冻结日期**: 2026-09-01
+**构建版本**: v27
+
+---
+
+## 功能清单
+
+### 用户端（小程序）
+- [x] 微信登录（Mock 模式）
+- [x] 个人资料管理
+- [x] 实名认证
+- [x] 每日推荐（Required 硬过滤）
+- [x] Like/Pass/Block 关系操作
+- [x] 双向 Match 后聊天
+- [x] 活动报名与互选
+- [x] 公益红娘服务申请
+- [x] 举报与申诉
+- [x] 签到功能
+
+### 红娘端（小程序）
+- [x] 独立登录入口（pages/matchmaker-login）
+- [x] 工作台页面（pages/matchmaker-workbench）
+- [x] 数据概览（2x2 网格布局）
+- [x] 待处理服务列表
+- [x] 一键接单功能
+- [x] 从「我的」页身份切换
+
+### 管理后台（Web）
+- [x] 登录认证
+- [x] 仪表盘数据概览
+- [x] 用户管理
+- [x] 组织管理
+- [x] 资料审核
+- [x] 活动管理
+- [x] 举报处理
+- [x] 审计日志
+
+### 后端 API
+- [x] 认证服务（JWT + Mock WeChat）
+- [x] 用户资料服务
+- [x] 推荐引擎（Required 硬过滤）
+- [x] 关系服务（Like/Pass/Block/Mutual）
+- [x] 消息服务（Match 校验）
+- [x] 活动服务（容量控制）
+- [x] 红娘服务（分配/接单/跟进）
+- [x] 举报申诉服务
+- [x] 审计日志服务
+
+---
+
+## 核心不变量验证
+
+| 编号 | 不变量 | 状态 |
+|------|--------|------|
+| INV-001 | Required 不可自动放宽 | ✓ 通过 |
+| INV-002 | 未 Mutual 不可聊天 | ✓ 通过 |
+| INV-003 | Block 优先级最高 | ✓ 通过 |
+| INV-004 | 双向并发 Like 只创建一个 Match | ✓ 通过 |
+| INV-005 | 活动名额不超卖 | ✓ 通过 |
+| INV-006 | 单向活动意向不泄露 | ✓ 通过 |
+| INV-007 | 红娘不能替用户 Like | ✓ 通过 |
+| INV-008 | 非授权 Operator 不能查看身份证 | ✓ 通过 |
+| INV-009 | 非案件上下文不能读取聊天 | ✓ 通过 |
+| INV-010 | 跨 Organization 不能越权 | ✓ 通过 |
+
+---
+
+## 登录凭证
+
+测试凭证已从发布文档移除；由部署环境安全提供。
+
+---
+
+## 访问地址
+
+| 服务 | 地址 |
+|------|------|
+| 管理后台 | http://localhost:3000/ |
+| API 网关 | http://localhost:8085/api/v1/ |
+| PostgreSQL | localhost:5434 |
+| Redis | localhost:6381 |
+| MinIO | localhost:9003 |
+
+---
+
+*冻结时间: 2026-09-01 15:45*