# 双机同步开发指南

> 单位 4090D（主力开发机） ↔ 家里电脑，通过 Gitea 云端仓库同步。
> 仓库地址：`http://101.42.29.217:3000/simonkoson/tps-dashboard.git`

---

## 到家后第一次（克隆 + 环境搭建）

如果家里电脑还没有这个项目，先克隆：

```powershell
git clone http://101.42.29.217:3000/simonkoson/tps-dashboard.git
cd tps-dashboard
```

然后搭建环境：

```powershell
# 1. 创建 Python 虚拟环境
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# 2. 安装后端依赖
pip install fastapi uvicorn sqlmodel python-dotenv psycopg2-binary bcrypt==4.0.1 itsdangerous==2.2.0 python-multipart==0.0.9 openai python-docx

# 3. 安装前端依赖
cd frontend
npm install
cd ..
```

配置环境变量（**两个 .env 文件，都不在 git 里，需要手动创建**）：

```powershell
# backend/.env — 从单位机器上复制内容，包含：
# DATABASE_URL=postgresql://...
# SECRET_KEY=...
# MINIMAX_EMBED_API_KEY=...
# MINIMAX_GROUP_ID=...
# DEEPSEEK_API_KEY=...

# ai-labeling/.env — 包含：
# MIMO_API_KEY=...
```

**注意**：数据库连接指向腾讯云 PostgreSQL，两台机器连的是同一个数据库，不需要本地装 PostgreSQL。

---

## 每次开工（不管在哪台机器）

```powershell
cd E:\tps-dashboard    # 或者家里对应的路径
git pull origin main   # 拉取对方机器推送的最新代码
```

如果有新的前端依赖（别人装了新 npm 包），还需要：

```powershell
cd frontend && npm install && cd ..
```

如果有新的 Python 依赖，激活虚拟环境后 pip install。

---

## 启动开发服务器

开两个 PowerShell 窗口：

**窗口 1 — 后端**：

```powershell
cd E:\tps-dashboard
.\.venv\Scripts\Activate.ps1
cd backend
python -m uvicorn app.main:app --reload --port 8000
```

**窗口 2 — 前端**：

```powershell
cd E:\tps-dashboard\frontend
npm run dev
```

浏览器访问 `http://localhost:5173`（或 5174）。

---

## 收工推送（每次下班前必做）

```powershell
cd E:\tps-dashboard
git add -A
git status              # 检查一眼，确认没有不该提交的文件（.env 等）
git commit -m "你的提交信息"
git push origin main
```

---

## 常见问题

### pull 时报冲突
说明两台机器改了同一个文件。先看冲突内容：
```powershell
git diff
```
手动解决冲突后：
```powershell
git add .
git commit -m "resolve merge conflict"
git push origin main
```

### 忘记 push 就换了机器
在另一台机器上 `git pull` 会发现没有新内容。回到原来的机器先 push，再回来 pull。

### .env 文件丢失
.env 不进 git，换机器需要手动复制。建议用安全的方式（如加密 U 盘或密码管理器）在两台机器间同步 .env 内容。

---

## 给 Claude Code 的指令

如果你在家里用 Claude Code 开新 session，让它先执行：

```
请先阅读 CLAUDE.md 和 docs/dual_machine_sync.md，了解项目背景和双机开发环境。
然后阅读 docs/git_workflow.md 第 7 章了解 git 工作流。
我现在在家里的电脑上，代码已经 pull 到最新。请帮我启动开发环境并确认一切正常。
```