Codex
60eeb8aef5
## 背景 用户指令：「先将 codex 的任务一并改为 workbuddy 的任务」。 Codex 已不再运行，当前由 WorkBuddy 承担开发执行，文档署名需同步。 ## 判定规则（用大小写精确区分） | 类别 | 写法 | 处置 | |---|---|---| | 工具署名 | 大写 Codex | → WorkBuddy | | 分支名 | codex/ui-v11-fidelity | → workbuddy-ui-v11-fidelity（去斜杠，规避本仓库 ref 清理） | | 已删除文件的历史路径 | 小写 2026-09-11-codex-baseline-cleanup* | 保持原样（记录真实曾存在的文件名，改了即失真） | 结果：26 个文件、126 处署名替换。残留小写 codex 仅 8 处，全部是历史路径。 ## 文件重命名（git mv，保留历史） - Codex开发执行总指令、项目规则与任务拆解.md → WorkBuddy 同名 - Codex首轮启动提示词 + Phase 01～Phase 26 Jira级任务清单 + 每阶段验收条件.md → WorkBuddy 同名 - docs/善缘丹阳 V1.1 Codex 开发执行计划修订版.md → docs/善缘丹阳 V1.1 WorkBuddy 开发执行计划修订版.md - docs/善缘丹阳 V1.1 Codex-Jira 最终开发任务增量清单.md → docs/善缘丹阳 V1.1 WorkBuddy-Jira 最终开发任务增量清单.md - docs/善缘丹阳 V1.1 Codex最终主启动提示词（整合版）.md → docs/善缘丹阳 V1.1 WorkBuddy最终主启动提示词（整合版）.md 引用已同步：AGENTS.md 6 处、AGENTS_SUMMARY.md、以及 4 份计划/规格文档。 ## AGENTS.md 两处特别处理 - 「git config user.name = Codex」一句改为不点名工具的表述 - 「feature/ fix/ codex/ ui/ 前缀」示例去掉 codex/ ## 有意未改动 - ui-tests/ui-document-baseline-contracts.mjs 的废弃清单仍列 codex-baseline-cleanup* 那是「必须不存在」的断言目标，改了会让哨兵失去意义 - 仓库 git config user.name 仍是 Codex —— 未擅自改动环境身份。 如需彻底交接：git config user.name WorkBuddy && git config user.email workbuddy@local 验证：UI 契约门禁 13/13；AGENTS.md 零 Codex 残留；5 个新文件名与全部引用一致
172 lines
5.0 KiB
Markdown
172 lines
5.0 KiB
Markdown
# 善缘丹阳 V1.1 技术架构基线
|
||
|
||
> 确认 V1.1 的技术栈、模块边界和架构约束。
|
||
|
||
> 2026-09-09 基线说明：V1.1 是 V1.0 的增量升级，六份客户修订文档共同约束实现。当前目录未包含 `.git` 元数据，无法验证来源分支、提交号和工作区洁净度；在原仓库恢复或用户明确授权创建新仓库前，不得伪造 Git 版本基线。
|
||
|
||
---
|
||
|
||
## 技术栈（保持不变）
|
||
|
||
```
|
||
Backend: Java 21 + Spring Boot 3.2.5 + MyBatis-Plus 3.5.5
|
||
Database: PostgreSQL 15+（Flyway管理迁移）
|
||
Cache: Redis 7+
|
||
Messaging: WebSocket（Spring WebSocket）
|
||
Storage: S3-Compatible Private Object Storage（MinIO）
|
||
Admin Web: Vue 3 + TypeScript + Vite + Pinia + Element Plus
|
||
Miniapp: 微信小程序原生 + TypeScript
|
||
Deployment: Docker + Docker Compose + Nginx
|
||
```
|
||
|
||
---
|
||
|
||
## 架构约束
|
||
|
||
### 禁止引入
|
||
- Kubernetes
|
||
- Kafka / RabbitMQ
|
||
- Elasticsearch / ClickHouse / Neo4j / Milvus
|
||
- 微服务拆分
|
||
- 复杂工作流引擎
|
||
|
||
### 保持不变
|
||
- 1个后端服务（模块化单体）
|
||
- 1个PostgreSQL
|
||
- 1个Redis
|
||
- 1个Object Storage
|
||
- 1个Admin Web
|
||
- 1个小程序
|
||
|
||
---
|
||
|
||
## 后端领域模块（V1.1扩展后）
|
||
|
||
### V1.0 原有模块（18个）
|
||
```
|
||
auth / user / verification / profile / review / match / relationship
|
||
messaging / activity / matchmaker / risk / appeal / notification
|
||
organization / permission / analytics / audit / config / photo
|
||
```
|
||
|
||
### V1.1 新增模块（8个）
|
||
```
|
||
banner — HomeBanner管理
|
||
service_location — 善缘服务站
|
||
appointment — 服务预约
|
||
counseling — 婚恋咨询与婚前辅导
|
||
content — 婚恋课堂/反诈内容管理
|
||
service_program — 专项公益服务项目
|
||
local_eligibility— 本地资格核验
|
||
home — 首页聚合API（HomeApplicationService）
|
||
```
|
||
|
||
### 模块边界规则
|
||
- 禁止跨模块直接写其他模块数据库表
|
||
- 使用 Application Service / Domain Service / 明确接口调用
|
||
- 共用基础能力：User / Notification / Audit / Risk / Object Storage
|
||
|
||
---
|
||
|
||
## 数据库 Migration 现状
|
||
|
||
| 版本 | 描述 |
|
||
|------|------|
|
||
| V001~V014 | V1.0 核心41张表 |
|
||
| V1xx（待开发） | V1.1 新增14张表 |
|
||
|
||
V1.1 建议迁移命名：
|
||
```
|
||
V100__add_home_banners
|
||
V101__add_service_locations
|
||
V102__add_service_appointments
|
||
V103__add_counseling_services
|
||
V104__add_counseling_followups
|
||
V105__add_content_categories
|
||
V106__add_content_articles
|
||
V107__add_user_local_eligibilities
|
||
V108__add_local_eligibility_evidences
|
||
V109__add_service_programs
|
||
V110__add_service_program_members
|
||
V111__add_organization_relationships
|
||
V112__add_activity_organizations
|
||
V113__add_activity_mutual_connection_consents
|
||
V114__extend_activities_v11
|
||
V115__extend_users_v11
|
||
V116__extend_operators_v11
|
||
```
|
||
|
||
---
|
||
|
||
## V1.1 新增表清单（14张）
|
||
|
||
| 表名 | 核心用途 | 敏感度 |
|
||
|------|---------|--------|
|
||
| home_banners | 首页Banner运营 | 低 |
|
||
| service_locations | 服务站信息 | 低 |
|
||
| service_appointments | 用户服务预约 | 中 |
|
||
| counseling_services | 婚恋咨询记录 | 高 |
|
||
| counseling_followups | 咨询服务摘要 | 高 |
|
||
| content_categories | 内容分类 | 低 |
|
||
| content_articles | 公益文章内容 | 低 |
|
||
| user_local_eligibilities | 本地资格主体 | 中 |
|
||
| local_eligibility_evidences | 本地资格佐证文件 | 高 |
|
||
| service_programs | 专项公益项目 | 低 |
|
||
| service_program_members | 项目成员关联 | 中 |
|
||
| organization_relationships | 组织间关系 | 低 |
|
||
| activity_organizations | 活动多组织关联 | 低 |
|
||
| activity_mutual_connection_consents | 活动互选双向确认 | 中 |
|
||
|
||
---
|
||
|
||
## 新增角色权限矩阵（V1.1）
|
||
|
||
| 角色 | 核心权限 | 数据范围 |
|
||
|------|---------|---------|
|
||
| service_station_operator | service_location.view, service_appointment.process | 仅本服务站预约 |
|
||
| counselor | counseling.service.view/process, counseling.note.create | 仅Assigned服务 |
|
||
| counseling_manager | counseling.service.assign/complete | 全部咨询（不看正文） |
|
||
| content_editor | content.view/create/edit/publish | 无用户数据权限 |
|
||
|
||
---
|
||
|
||
## 敏感访问规则
|
||
|
||
以下数据需要特殊权限 + 业务理由 + SensitiveAccessLog：
|
||
- 完整身份证
|
||
- 本地资格原始佐证文件
|
||
- 咨询敏感备注
|
||
- 私人聊天（仅案件上下文）
|
||
|
||
---
|
||
|
||
## Feature Flags（V1.1）
|
||
|
||
```
|
||
counselingEnabled — 婚恋咨询功能开关
|
||
premaritalEnabled — 婚前辅导功能开关
|
||
serviceLocationEnabled — 善缘服务站功能开关
|
||
contentEnabled — 内容中心功能开关
|
||
localEligibilityEnabled — 本地资格功能开关
|
||
imageChatEnabled — 图片聊天功能开关
|
||
matchmakerEnabled — 公益红娘功能开关
|
||
activityEnabled — 活动功能开关
|
||
livenessVerificationEnabled — 人脸核验功能开关（V1.2预留）
|
||
```
|
||
|
||
---
|
||
|
||
## 部署架构（保持不变）
|
||
|
||
```
|
||
Nginx → Backend Container
|
||
↓
|
||
PostgreSQL + Redis + MinIO
|
||
↓
|
||
Docker Compose 一键部署
|
||
```
|
||
|
||
---
|
||
|
||
*生成时间: 2026-09-08 | WorkBuddy首轮执行期间生成*
|