2026-09-09 22:05:00 +08:00
|
|
|
# ADR-001: 技术栈决策
|
|
|
|
|
|
|
|
|
|
**状态**: 已批准
|
|
|
|
|
**日期**: 2026-08-28
|
2026-09-16 14:37:44 +08:00
|
|
|
**决策者**: WorkBuddy（依据项目总指令）
|
2026-09-09 22:05:00 +08:00
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 背景
|
|
|
|
|
|
|
|
|
|
项目需要一个稳定、成熟、易维护的技术栈来支撑 V1.0 开发，同时满足国内运营环境和长期可维护性要求。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 决策
|
|
|
|
|
|
|
|
|
|
### Backend
|
|
|
|
|
|
|
|
|
|
采用 **Java 21 + Spring Boot 3.x**。
|
|
|
|
|
|
|
|
|
|
理由：
|
|
|
|
|
- 事务管理能力强，对 Match 并发、活动名额等核心场景友好
|
|
|
|
|
- Spring Security 提供成熟的权限框架
|
|
|
|
|
- 国内团队普遍熟悉，便于长期维护
|
|
|
|
|
- 模块化单体架构天然支持
|
|
|
|
|
- MyBatis-Plus 或 Spring Data JPA 均可，V1 优先使用 MyBatis-Plus（国内生态更成熟）
|
|
|
|
|
|
|
|
|
|
### Database
|
|
|
|
|
|
|
|
|
|
采用 **PostgreSQL**。
|
|
|
|
|
|
|
|
|
|
理由：
|
|
|
|
|
- 成熟稳定，事务能力强
|
|
|
|
|
- JSONB 支持良好，适合混合结构化/半结构化数据
|
|
|
|
|
- 索引能力成熟，适合匹配查询优化
|
|
|
|
|
- 开源无授权成本
|
|
|
|
|
- 与 Spring Boot 集成完善
|
|
|
|
|
|
|
|
|
|
### Cache
|
|
|
|
|
|
|
|
|
|
采用 **Redis**。
|
|
|
|
|
|
|
|
|
|
用途：Session、Token 辅助、限流、推荐缓存、未读计数、分布式锁。
|
|
|
|
|
|
|
|
|
|
### Miniapp
|
|
|
|
|
|
|
|
|
|
采用 **微信原生小程序 + TypeScript**。
|
|
|
|
|
|
|
|
|
|
理由：
|
|
|
|
|
- 无需引入跨端框架增加维护成本
|
|
|
|
|
- 官方支持完善
|
|
|
|
|
- 与微信登录/订阅消息生态无缝对接
|
|
|
|
|
|
|
|
|
|
### Admin Web
|
|
|
|
|
|
|
|
|
|
采用 **Vue 3 + TypeScript + Vite + Pinia + Element Plus**。
|
|
|
|
|
|
|
|
|
|
理由：
|
|
|
|
|
- 国内团队生态成熟
|
|
|
|
|
- Element Plus 组件库丰富，适合后台管理系统
|
|
|
|
|
- Vite 构建快，开发体验好
|
|
|
|
|
|
|
|
|
|
### Deployment
|
|
|
|
|
|
|
|
|
|
采用 **Docker + Docker Compose + Nginx**。
|
|
|
|
|
|
|
|
|
|
暂不引入 K8s / Kafka / Elasticsearch 等复杂基础设施。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 后果
|
|
|
|
|
|
|
|
|
|
- 团队需要熟悉 Java 21 / Spring Boot 3.x 生态
|
|
|
|
|
- PostgreSQL 需要运维支持（备份、监控）
|
|
|
|
|
- Redis 需要运维支持（持久化配置、内存管理）
|
|
|
|
|
- 后期如有扩展需求，可从单体拆分为服务（Messaging → Match → Notification → Analytics 优先拆分）
|
