zlwuandCursor
ac8e471aca
Let customer-service quick register write storage, certificate, and insurance separately without extra menu or data-scope checks. List freight by document data scope like the web admin, allow protocol staff outside the collection region, and pad OA datetimes to seconds so PC date pickers can show historical minute values. 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 进行用户认证