zlwuandCursor
be22c37196
Mobile protocol create/update saves v2 per-sample payments; detail includes samplePayments for edit hydration. Co-authored-by: Cursor <cursoragent@cursor.com>
zkxw 后端骨架（FastAPI）
基于 FastAPI 的精简后端：Web 鉴权（登录 RSA、登录、刷新 Token、登出、当前用户、菜单 code）、静态运营菜单树、运营端路由占位。原叁强鲜配业务 API 已移除，可按模块在 app/api/admin.py 等位置扩展。
数据库结构与种子数据基线见：docs/sql/zkxw.sql（全库导出；默认账号 admin / 111111，角色 super_admin）。
技术栈
- FastAPI - 现代高性能异步 Web 框架
- SQLAlchemy - ORM 数据库映射
- Pydantic - 数据验证
- JWT - 用户认证
- MySQL/PostgreSQL - 数据库
项目结构
backend/
├── app/
│ ├── api/ # API 路由
│ │ ├── admin/ # 运营端接口
│ │ ├── supplier/ # 供应商端接口
│ │ ├── client/ # 客户端接口
│ │ └── deliver/ # 配送员端接口
│ ├── core/ # 核心配置
│ │ ├── config.py # 应用配置
│ │ ├── security.py # 安全认证
│ │ └── database.py # 数据库连接
│ ├── models/ # 数据库模型
│ ├── schemas/ # Pydantic schemas
│ ├── services/ # 业务逻辑
│ └── main.py # 应用入口
├── requirements.txt
└── README.md
快速开始
1. 创建虚拟环境
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # Linux/Mac
2. 安装依赖
pip install -r requirements.txt
3. 配置环境变量
复制 .env.example 为 .env 并修改配置：
# 数据库配置
DATABASE_URL=mysql+pymysql://root:password@localhost:3306/sanqiang
# JWT配置
SECRET_KEY=your-secret-key-change-in-production
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
# 应用配置
APP_NAME=陇耘鲜达
DEBUG=true
4. 启动服务
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 进行用户认证