# 债务管理系统

个人/小团队债务记录、跟踪和管理平台。

## 技术栈

- **前端**: 纯 HTML/CSS/JS（无框架依赖）
- **后端**: Python FastAPI + SQLAlchemy (async)
- **数据库**: PostgreSQL 15
- **部署**: Docker Compose

## 功能

### 前台
- 用户注册/登录（JWT 双 token）
- 借款管理：CRUD + 分组展示 + 一键还款
- 月度还款计划：按月汇总 + 复选框标记已还
- 支持：等额本息、等额本金、先息后本
- 利率/总利息互算
- 数据导入/导出（CSV）
- 修改密码

### 后台
- 用户管理（审批/禁用/启用/删除/重置密码）
- 用户组管理（同组共享数据）
- 系统数据总览

## 快速开始

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

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

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

## 默认账户

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

## 端口说明

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

## 项目结构

```
debt-manager/
├── backend/              # FastAPI 后端
│   ├── app/
│   │   ├── api/          # API 路由
│   │   ├── core/         # 配置、数据库、认证
│   │   ├── models/       # SQLAlchemy 模型
│   │   ├── schemas/      # Pydantic 模型
│   │   └── services/     # 业务逻辑
│   └── Dockerfile
├── frontend/             # 前端页面
│   ├── index.html        # 主页面
│   ├── admin.html        # 管理后台
│   └── Dockerfile
├── docker-compose.yml
├── .env
└── DEPLOY.md             # 部署指南
```