# collab_platform

**Repository Path**: yuguoxy/collab_platform

## Basic Information

- **Project Name**: collab_platform
- **Description**: 企业智能协同平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-10
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业智能协同平台 — collab-platform（ex02 · Day1 / M0）

前后端分离脚手架：**框架搭建 + 注册/登录/JWT 认证**。

> 依据：`../四天实施计划.md` Day1、`../软件设计文档.md`、`../ui/` 原型  
> 业务模块（组织/模型/问数/IM 等）为占位，Day2+ 实现

## 目录

```text
collab-platform/
├── README.md
├── docs/auth-contract.md
├── backend/          # FastAPI · 8000
└── frontend/         # Vue3 + Element Plus · 3000
```

## 后端启动

```powershell
cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
copy .env.example .env
# 确认 MySQL 已创建库（默认 collab_platform_dev，与实训账号 collab 权限一致）
python -m app.init_db
uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
```

- 文档：http://127.0.0.1:8000/docs  
- 健康：http://127.0.0.1:8000/health  
- 账号：`admin` / `admin123`

> 说明：`sys_user` 兼容现有实训库字段（`password`/`role`）；API 对外仍返回 `role_code`。

## 前端启动

```powershell
cd frontend
copy .env.example .env
npm install
npm run dev
```

- 界面：http://localhost:3000  
- `/api` 代理到 `http://127.0.0.1:8000`

## M0 验收清单

| # | 检查项 | 标准 |
|---|--------|------|
| 1 | 后端独立启动 | `/docs`、`/health` 可访问 |
| 2 | 前端独立启动 | 无控制台致命错误 |
| 3 | 注册新用户 | 库中仅存 bcrypt 哈希 |
| 4 | 登录拿 Token | 返回 JWT；`/auth/me` 成功 |
| 5 | 无 Token | 受保护接口 401 |
| 6 | 路由守卫 | 未登录访问 `/ask` → `/login` |
| 7 | 退出 | Token 清除，需重新登录 |

认证契约详见 [docs/auth-contract.md](docs/auth-contract.md)。