feat: Phase 1 完成 — 基础设施 + 用户认证 + 管理端 + 端到端验证
Phase 1 (基础设施与用户认证) 全部 11 个 Task 开发完成: 后端 (Go): - Auth 模块: 注册/登录/JWT(有状态)/Profile/密码修改 - Admin 模块: 用户列表/详情/禁用/启用/角色分配/创建用户 - 中间件: JWT认证 + RBAC角色权限 + 请求日志 + CORS + Panic恢复 - Dockerfile 多阶段构建 + Docker Compose 全栈部署 前台 (uni-app): - 登录/注册页面 + 自定义 TabBar + 个人中心 - 请求封装 + 状态管理 (Pinia) 管理端 (Vue 3 + Element Plus): - 登录/仪表盘/用户列表/用户详情 - Axios 封装 + 路由守卫 + Pinia 状态管理 验证: - 全流程 API 端到端测试通过 - Playwright 页面自动化验证通过 - code-reviewer 代码审查通过 Made-with: Cursor
This commit is contained in:
84
README.md
84
README.md
@@ -51,17 +51,23 @@ mediasoup Worker (C++ SFU)
|
||||
|
||||
```
|
||||
EchoChat/
|
||||
├── frontend/ # 前台用户端 (uniapp)
|
||||
├── admin/ # 后台管理端 (Vue 3 + Element Plus)
|
||||
├── frontend/ # 前台用户端 (uni-app + Vue 3.4)
|
||||
├── admin/ # 后台管理端 (Vue 3.5 + Element Plus)
|
||||
├── backend/
|
||||
│ └── go-service/ # Go 后端服务
|
||||
├── media-server/ # mediasoup Node 媒体服务
|
||||
├── deploy/ # 部署配置 (Docker / Nginx / K8s)
|
||||
├── docs/ # 项目文档
|
||||
│ ├── plans/ # 设计方案与实施计划
|
||||
│ ├── api/ # API 接口文档
|
||||
│ └── architecture/ # 架构设计文档
|
||||
├── scripts/ # 脚本工具
|
||||
│ └── go-service/ # Go 后端服务 (Gin + GORM + Wire)
|
||||
│ ├── app/ # 业务模块 (auth / admin)
|
||||
│ ├── cmd/server/ # 服务入口
|
||||
│ ├── config/ # 配置文件
|
||||
│ ├── pkg/ # 公共包 (db / logs / middleware / utils)
|
||||
│ └── router/ # 路由聚合
|
||||
├── media-server/ # mediasoup Node 媒体服务 (Phase 3)
|
||||
├── deploy/ # 部署配置 (Docker Compose)
|
||||
├── design-system/ # UI 设计系统 (ui-ux-pro-max 生成)
|
||||
├── docs/ # 项目文档
|
||||
│ ├── progress/ # 开发进度
|
||||
│ ├── plans/ # 实施计划
|
||||
│ ├── api/ # API 接口文档
|
||||
│ └── architecture/ # 架构设计文档
|
||||
└── README.md
|
||||
```
|
||||
|
||||
@@ -71,20 +77,34 @@ EchoChat/
|
||||
|
||||
### 环境要求
|
||||
|
||||
- Go 1.22+
|
||||
- Go 1.23+
|
||||
- Node.js 18+
|
||||
- Docker & Docker Compose
|
||||
- PostgreSQL 17 (通过 Docker)
|
||||
- Redis 7 (通过 Docker)
|
||||
- PostgreSQL 17(通过 Docker 自动启动)
|
||||
- Redis 7(通过 Docker 自动启动)
|
||||
|
||||
### 1. 启动基础设施
|
||||
### 方式一:Docker Compose 一键启动(推荐)
|
||||
|
||||
```bash
|
||||
cd deploy
|
||||
docker compose -f docker-compose.dev.yml up -d
|
||||
```
|
||||
|
||||
### 2. 启动 Go 后端
|
||||
启动后服务地址:
|
||||
- Go 后端 API:`http://localhost:8085`
|
||||
- PostgreSQL:`localhost:5432`
|
||||
- Redis:`localhost:6379`
|
||||
|
||||
### 方式二:分步手动启动(开发调试)
|
||||
|
||||
**1. 启动基础设施(数据库 + 缓存)**
|
||||
|
||||
```bash
|
||||
cd deploy
|
||||
docker compose -f docker-compose.dev.yml up -d postgres redis
|
||||
```
|
||||
|
||||
**2. 启动 Go 后端**
|
||||
|
||||
```bash
|
||||
cd backend/go-service
|
||||
@@ -92,15 +112,19 @@ go mod tidy
|
||||
go run cmd/server/main.go
|
||||
```
|
||||
|
||||
### 3. 启动前台前端
|
||||
后端启动在 `http://localhost:8085`,健康检查:`GET /health`
|
||||
|
||||
**3. 启动前台用户端(uni-app H5)**
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
npm install --legacy-peer-deps
|
||||
npm run dev:h5
|
||||
```
|
||||
|
||||
### 4. 启动管理端
|
||||
前台 H5 启动在 `http://localhost:5173`(端口可能递增)
|
||||
|
||||
**4. 启动后台管理端(Vue 3)**
|
||||
|
||||
```bash
|
||||
cd admin
|
||||
@@ -108,17 +132,34 @@ npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
管理端启动在 `http://localhost:3100`(自动代理 `/api` 到后端 8085)
|
||||
|
||||
---
|
||||
|
||||
## MVP 功能规划(第一期)
|
||||
|
||||
### Phase 1 — 基础设施与用户认证 ✅
|
||||
|
||||
- [x] 设计方案与架构文档
|
||||
- [ ] 用户注册/登录(邮箱+密码、用户名+密码)
|
||||
- [x] Docker Compose 开发环境(PostgreSQL + Redis)
|
||||
- [x] Go 后端服务骨架(Gin + GORM + Wire + Zap)
|
||||
- [x] 用户注册/登录 API(用户名+邮箱+密码)
|
||||
- [x] JWT Token 认证(有状态 JWT + Redis)
|
||||
- [x] RBAC 角色权限(user / admin / super_admin)
|
||||
- [x] 前台 uni-app 骨架 + 登录/注册/TabBar/个人中心
|
||||
- [x] 后台 Vue 3 管理端 + 登录/布局/用户管理
|
||||
- [x] Go 服务 Dockerfile + Docker Compose 全栈部署
|
||||
|
||||
### Phase 2 — 即时通讯(待开始)
|
||||
|
||||
- [ ] 即时聊天(单聊 + 群聊,文字/图片/文件)
|
||||
- [ ] 联系人/好友管理
|
||||
- [ ] 多人音视频会议(即时会议 + 预约会议)
|
||||
- [ ] 消息通知系统
|
||||
- [ ] 后台管理端(用户管理、会议监控、系统配置)
|
||||
|
||||
### Phase 3 — 音视频会议(待开始)
|
||||
|
||||
- [ ] 多人音视频会议(即时会议 + 预约会议)
|
||||
- [ ] 后台管理端会议监控
|
||||
|
||||
## 后续规划
|
||||
|
||||
@@ -135,6 +176,7 @@ npm run dev
|
||||
|
||||
| 文档 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| 项目进度 | [docs/progress/CURRENT_STATUS.md](docs/progress/CURRENT_STATUS.md) | 当前开发进度与技术决策 |
|
||||
| 整体设计方案 | [docs/plans/2026-02-27-echochat-system-design.md](docs/plans/2026-02-27-echochat-system-design.md) | 系统完整设计方案 |
|
||||
| 第一阶段实施计划 | [docs/plans/2026-02-27-phase1-foundation-and-auth.md](docs/plans/2026-02-27-phase1-foundation-and-auth.md) | 基础设施+用户体系实施步骤 |
|
||||
| 系统架构文档 | [docs/architecture/system-architecture.md](docs/architecture/system-architecture.md) | 架构分层与技术选型 |
|
||||
|
||||
Reference in New Issue
Block a user