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 | Codex首轮执行期间生成*
|