init: 初始化 dpb 桃育种系统代码库

前后端 + 后端 FastAPI 全量源码、部署脚本与文档。

README.md

@@ -0,0 +1,87 @@
+启动需要三个部分（Redis → 后端 → 前端）。我先快速核实一下关键文件是否就位。
+`_backend_run.bat` 实际不存在（记忆里的路径可能已变）。我查一下真正的启动脚本和后端的运行方式。
+核实完毕。关键发现：记忆里的 `_backend_run.bat` **不存在**，真实启动靠根目录 `deploy.bat`（后端实际用 `uv run main.py run --env=dev`）。我先更新一下记忆里的错误启动方式，再给你完整命令。
+命令行启动项目，共三部分：**Redis → 后端 → 前端**（`deploy.bat` 只管后两项，Redis 要单独起）。
+
+CMD
+
+CMD 比 PowerShell 更合适——deploy.bat 本身就是批处理脚本，在 CMD 里跑最干净（之前前端 pnpm dev 在 PowerShell 里会被 .ps1 执行策略拦，用 CMD 就没这问题）。
+
+在 CMD 里启动
+
+① 开一个 CMD 窗口，先起 Redis：
+start "" "d:\dpb\dpb\redis\redis-server.exe" --dir d:\dpb\dpb\redis
+（会弹一个新窗口跑 Redis，别关）
+
+② 再开一个 CMD 窗口，一键起后端+前端：
+cd /d d:\dpb\dpb
+deploy.bat start
+
+③ 常用：
+cd /d d:\dpb\dpb
+deploy.bat stop      
+deploy.bat restart   
+deploy.bat status    
+
+只想单独起某一边（也是 CMD）
+:: 后端（新窗口）
+cd /d d:\dpb\dpb\backend
+uv run main.py run --env=dev
+
+:: 前端（新窗口）
+cd /d d:\dpb\dpb\frontend\web
+pnpm dev
+
+小提示:
+
+CMD 里 deploy.bat 直接写文件名即可，不用 .\ 前缀（写 .\ 也认）；
+访问地址不变：前端 http://localhost:5666，后端文档 http://localhost:5667/api/v1/docs；
+你改过 MenuProcessor.ts 等路由文件，起前端后记得 Ctrl+Shift+R 硬刷新。
+
+
+Powershell
+
+## 1. 先启动 Redis（必须，漏了后端会连不上）
+```powershell
+start "" "d:\dpb\dpb\redis\redis-server.exe" --dir d:\dpb\dpb\redis
+```
+
+## 2. 一键启动后端 + 前端（推荐）
+在 **项目根目录** `d:\dpb\dpb` 执行：
+```powershell
+.\deploy.bat start
+```
+它会自动：
+- 后端：`uv run main.py run --env=dev`（cwd=backend）
+- 前端：`pnpm dev`（cwd=frontend/web）
+
+常用子命令：
+```powershell
+.\deploy.bat stop      # 停止
+.\deploy.bat restart   # 重启
+.\deploy.bat status    # 看状态
+.\deploy.bat migrate   # 同步 breeding 表缺失列
+```
+
+## 3. 或分开手动起（调试某一边时用）
+```powershell
+# 后端（另开一个终端，cwd=backend）
+cd d:\dpb\dpb\backend
+uv run main.py run --env=dev
+# 若 uv 不可用，退回 conda：
+C:\ai\miniconda3\envs\dpb\python.exe main.py run --env=dev
+
+# 前端（另开一个终端，cwd=frontend/web；用 cmd 跑规避 pnpm 的 .ps1 拦截）
+cmd /c "cd /d d:\dpb\dpb\frontend\web && pnpm dev"
+```
+
+## 访问地址（以 settings 实际端口为准）
+- 前端页面：`http://localhost:5666`（`/web` 前缀，dev 实测端口 5666）
+- 后端 API 文档：`http://localhost:5667/api/v1/docs`
+- （`deploy.bat` 注释里写的是 8001/5173，那是模板默认值，实际以 `setting.py` 的 5667/5666 为准）
+
+## 两个坑提醒
+- **Redis 不在 `deploy.bat` 里**，必须第 1 步先起，否则后端启动后连 Redis 报错；
+- 你之前改过 `router/MenuProcessor.ts` 等路由初始化文件，**改动后必须重启 Vite**（不是 HMR），重启后 `Ctrl+Shift+R` 硬刷新。
+
+需要我直接帮你按顺序把这三步跑起来吗？（启动服务涉及长驻进程，需你确认，我不会擅自起。）