# 债务管理系统 - 部署指南

## 环境要求
- Docker 20.10+
- Docker Compose 2.0+
- 至少 1GB 可用内存

## 快速部署

```bash
# 1. 解压项目
tar -xzf debt-manager.tar.gz
cd debt-manager

# 2. 启动所有服务
docker compose up -d

# 3. 等待启动完成（约30秒）
docker compose ps

# 4. 访问系统
# 前台: http://localhost:806
# 后台: http://localhost:806/admin.html
# API文档: http://localhost:8000/docs
```

## 默认账户

| 账号 | 密码 | 角色 |
|------|------|------|
| admin | admin123 | 管理员 |
| test | test123 | 用户 |

## 端口说明

| 服务 | 端口 | 说明 |
|------|------|------|
| 前端 | 806 | 用户界面 |
| 后端 | 8000 | API接口 |
| 数据库 | 54326 | PostgreSQL |

如需修改端口，编辑 `docker-compose.yml` 中的 ports 映射。

## 数据备份

```bash
# 备份数据库
docker compose exec db pg_dump -U postgres debt_manager > backup.sql

# 恢复数据库
docker compose exec -T db psql -U postgres debt_manager < backup.sql
```

## 停止/重启

```bash
# 停止
docker compose down

# 重启
docker compose restart

# 重建（代码更新后）
docker compose up -d --build
```

## 常见问题

**Q: 启动后前端打不开？**
A: 等待30秒让后端启动完成，然后刷新页面。

**Q: 新用户注册后看不到？**
A: 管理员需先登录前台，再访问后台管理页面审批。

**Q: 如何修改管理员密码？**
A: 登录前台 → 右上角"修改密码"。