# 家谱管理系统 (Genealogy Management System)

本项目实现了家谱管理功能，包括用户登录、文件上传（图片/扫描件）、上传到 OSS、OCR 自动解析页码以及数据库存储。

## 功能特性

1. **登录管理**：基于数据库 `users` 表的身份验证。
2. **家谱管理**：支持上传扫描件或图片。
3. **OSS 上传**：通过指定的 `https://crmapi.dcjxb.yunzhixue.cn/file/upload` 接口实现。
4. **OCR 页码解析**：自动解析图片中的页码并记录。
5. **数据库存储**：在 MySQL 数据库中存储记录。

## 目录结构

- `app.py`: Flask 应用主入口。
- `oss_utils.py`: OSS 上传工具类。
- `ocr_utils.py`: OCR 页码解析工具类。
- `init_db.py`: 数据库初始化脚本（创建表和添加测试用户）。
- `templates/`: HTML 模板文件。
- `requirements.txt`: Python 依赖项。

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

*注意：OCR 功能需要系统安装 `tesseract-ocr` 引擎。*

### 2. 初始化数据库

运行初始化脚本以创建必要的表并添加默认管理员账号：

```bash
python init_db.py
```

- 默认账号：`admin`
- 默认密码：`admin123`

### 3. 运行应用

```bash
python app.py
```

访问 `http://127.0.0.1:5001` 即可开始使用。

## 数据库配置

- 主机: `rm-f8ze60yirdj8786u2wo.mysql.rds.aliyuncs.com`
- 用户: `csqz`
- 密码: `csqz@2026`
- 数据库: `csqz-client`

## 接口说明

- OSS 上传接口：`POST https://crmapi.dcjxb.yunzhixue.cn/file/upload`
- 参数：`file` (form-data)

## AI能力

- 模型：`doubao-seed-1-8-251228`
- 接口地址：`https://ark.cn-beijing.volces.com/api/v3/responses`
- API-KEY：`a1800657-9212-4afe-9b7c-b49f015c54d3`