hyf-backend/README.md

启动项目（本地）

1. 准备环境

   • 推荐 Python 3.11+
   • 创建并激活虚拟环境：python3 -m venv .venv && source .venv/bin/activate
   • 依赖安装：pip install -r requirements.txt（若 requirements.txt 为 UTF-16，需要先转 UTF-8）

2. 配置数据库

   • 确保本地 MySQL 运行，并创建数据库/账号（例）：

     CREATE DATABASE allm DEFAULT CHARACTER SET utf8mb4;
     ALTER USER 'root'@'localhost' IDENTIFIED BY '*******';
     GRANT ALL PRIVILEGES ON allm.* TO 'root'@'localhost';
     FLUSH PRIVILEGES;
     

   • 启动前设置环境变量：

     export DATABASE_URL="******"
     

3. 迁移（首次必跑）

   python -m alembic upgrade head
   

4. 启动服务

   # 启动项目命令
   python3 -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload