# 中科兴皖一体化门户后端(空壳) 当前 `app.main` **不连接数据库、不注册任何业务路由**,仅提供根路径与 `/health`,便于占位或 CI。原 `app/api` 下 Python 文件已删除(请从 git 历史恢复)。`app/models`、`app/crud` 等目录仍保留为未引用代码,可按需继续清理。 ## 技术栈 - FastAPI - 现代高性能异步 Web 框架 - SQLAlchemy - ORM 数据库映射 - Pydantic - 数据验证 - JWT - 用户认证 - MySQL/PostgreSQL - 数据库 ## 项目结构 ``` backend/ ├── app/ │ ├── api/ # 包占位(路由实现已删除) │ ├── core/ # 核心配置 │ ├── models/ # 数据库模型 │ ├── schemas/ # Pydantic schemas │ ├── services/ # 业务逻辑 │ └── main.py # 应用入口 ├── requirements.txt └── README.md ``` ## 快速开始 ### 1. 创建虚拟环境 ```bash python -m venv venv venv\Scripts\activate # Windows # source venv/bin/activate # Linux/Mac ``` ### 2. 安装依赖 ```bash pip install -r requirements.txt ``` ### 3. 配置环境变量 复制 `.env.example` 为 `.env` 并修改配置: ```env # 数据库配置 DATABASE_URL=mysql+pymysql://root:password@localhost:3306/zkxw # JWT配置 SECRET_KEY=your-secret-key-change-in-production ALGORITHM=HS256 ACCESS_TOKEN_EXPIRE_MINUTES=30 # 应用配置 APP_NAME=中科兴皖一体化门户 DEBUG=true ``` ### 4. 启动服务 ```bash uvicorn app.main:app --reload --port 8000 uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload ``` 服务启动后,访问: - API 文档:http://127.0.0.1:8000/docs - ReDoc 文档:http://127.0.0.1:8000/redoc ## API 路由分组 | 前缀 | 说明 | 认证方式 | |------|------|----------| | `/api/admin` | 运营端接口 | JWT Token | | `/api/supplier` | 供应商端接口 | JWT Token | | `/api/client` | 客户端接口 | JWT Token | | `/api/deliver` | 配送员端接口 | JWT Token | | `/api/public` | 公共接口(登录等) | 无需认证 | ## 开发规范 - 使用 Pydantic 进行数据验证 - 使用 SQLAlchemy ORM 进行数据库操作 - 所有接口遵循 RESTful 规范 - 密码使用 bcrypt 加密存储 - 使用 JWT Token 进行用户认证