genealogy-app/README.md

家谱管理系统 (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. 安装依赖

pip install -r requirements.txt

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

2. 初始化数据库

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

python init_db.py

• 默认账号：admin
• 默认密码：admin123

3. 运行应用

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