# 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
```