9568dd7875
- Run cargo fmt on all Rust crates for consistent formatting - Update CLAUDE.md with WASM plugin commands and dev.ps1 instructions - Update wiki: add WASM plugin architecture, rewrite dev environment docs - Minor frontend cleanup (unused imports)
72 lines
1.8 KiB
Markdown
72 lines
1.8 KiB
Markdown
# infrastructure (开发环境)
|
|
|
|
## 设计思想
|
|
|
|
开发环境在 **Windows** 宿主机直接运行所有服务：
|
|
- PostgreSQL 16+ 和 Redis 7+ 通过 Windows 原生安装运行
|
|
- 后端 Rust 服务通过 `cargo run` 快速重启
|
|
- 前端 Vite 热更新直接在宿主机
|
|
- PowerShell 脚本 (`dev.ps1`) 提供一键启动/停止
|
|
|
|
> Docker Compose 配置保留在 `docker/` 目录下，可供需要容器化环境的场景使用，但日常开发不依赖 Docker。
|
|
|
|
## 代码逻辑
|
|
|
|
### 服务配置
|
|
|
|
| 服务 | 端口 | 用途 |
|
|
|------|------|------|
|
|
| PostgreSQL 16+ | 5432 | 主数据库 |
|
|
| Redis 7+ | 6379 | 缓存 + 会话 |
|
|
| erp-server (Axum) | 3000 | 后端 API |
|
|
| Vite dev server | 5174 | 前端 SPA |
|
|
|
|
### 连接信息
|
|
```
|
|
PostgreSQL: postgres://erp:erp_dev_2024@localhost:5432/erp
|
|
Redis: redis://localhost:6379
|
|
```
|
|
|
|
### 一键启动
|
|
|
|
```powershell
|
|
.\dev.ps1 # 启动后端 + 前端
|
|
.\dev.ps1 -Status # 查看端口状态
|
|
.\dev.ps1 -Stop # 停止所有服务
|
|
.\dev.ps1 -Restart # 重启所有服务
|
|
```
|
|
|
|
### 环境变量
|
|
通过 `crates/erp-server/config/default.toml` 配置，无需额外环境变量文件即可启动。
|
|
|
|
## 关联模块
|
|
|
|
- **[[erp-server]]** — 连接 PostgreSQL 和 Redis
|
|
- **[[database]]** — 迁移在 PostgreSQL 中执行
|
|
- **[[frontend]]** — Vite 代理 API 到后端
|
|
- **[[testing]]** — 测试环境详细指南
|
|
|
|
## 关键文件
|
|
|
|
| 文件 | 职责 |
|
|
|------|------|
|
|
| `dev.ps1` | 一键启动/停止脚本 |
|
|
| `docker/docker-compose.yml` | 可选的 Docker Compose 配置 |
|
|
| `crates/erp-server/config/default.toml` | 默认连接配置 |
|
|
|
|
## 常用命令
|
|
|
|
```powershell
|
|
# 一键启动（推荐）
|
|
.\dev.ps1
|
|
|
|
# 手动启动后端
|
|
cargo run -p erp-server
|
|
|
|
# 手动启动前端
|
|
cd apps/web && pnpm dev
|
|
|
|
# 连接数据库
|
|
psql -U erp -d erp -h localhost
|
|
```
|