Files
34047007@qq.com b95053c52c init: 初始化 dpb 桃育种系统代码库
前后端 + 后端 FastAPI 全量源码、部署脚本与文档。
2026-08-06 00:17:49 +08:00

87 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
启动需要三个部分(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` 硬刷新。
需要我直接帮你按顺序把这三步跑起来吗?(启动服务涉及长驻进程,需你确认,我不会擅自起。)