FastAPI 微型后端工程
这是一个简易的 FastAPI 后端，用 SQLite 保存数据，提供 Todo 和用户管理接口。
start
DATABASE_PATH=/tmp/py-web.sqlite3 .venv/bin/uvicorn index:app --reload
工程结构
.
├── app
│ ├── main.py # 创建 FastAPI 应用，注册中间件和路由
│ ├── database.py # 数据库连接、建表、依赖注入
│ ├── schemas.py # 请求体和响应体的数据结构
│ └── routers
│ ├── todos.py # Todo 接口
│ └── users.py # 用户接口
├── index.py # 兼容入口，暴露 app 给 uvicorn
├── requirements.txt
└── app.sqlite3 # 启动后自动创建，保存数据
安装依赖
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
启动服务
uvicorn index:app --reload
启动后访问：
默认数据库文件是 app.sqlite3。如果想指定其他数据库文件：
DATABASE_PATH=/tmp/py-web.sqlite3 uvicorn index:app --reload
如果遇到 attempt to write a readonly database，通常说明数据库文件不是当前用户创建的。可以换一个 DATABASE_PATH，或者删除旧的数据库文件后重新启动服务。
用户接口
GET /users
POST /users
GET /users/{user_id}
PATCH /users/{user_id}
DELETE /users/{user_id}
寺院隔离模块
寺院管理接口：
GET /temples
POST /temples
GET /temples/{temple_id}
PATCH /temples/{temple_id}
DELETE /temples/{temple_id}
商品、订单、法事属于寺院隔离数据。调用这些接口时需要带请求头：
X-Temple-Id: 1
隔离接口：
GET /products
POST /products
GET /products/{product_id}
PATCH /products/{product_id}
DELETE /products/{product_id}
GET /orders
POST /orders
GET /orders/{order_id}
PATCH /orders/{order_id}
DELETE /orders/{order_id}
GET /ritual-services
POST /ritual-services
GET /ritual-services/{ritual_id}
PATCH /ritual-services/{ritual_id}
DELETE /ritual-services/{ritual_id}
商品详情模型包含商品基础信息、按钮名称、展示配置、封面和多图、上架/开售/结束/下架时间、商品规格、商品详情 HTML、微信分享配置、功德证书预留和自动处理。商品规格字段为名称、单价、库存、排序和是否超度。
创建用户：
curl -X POST http://127.0.0.1:8000/users \
-H "Content-Type: application/json" \
-d '{"name":"张三","phone":"13800000000","nickname":"小张","avatar":"","is_admin":false,"total_spent":0}'
更新用户：
curl -X PATCH http://127.0.0.1:8000/users/1 \
-H "Content-Type: application/json" \
-d '{"nickname":"张老板","is_admin":true,"total_spent":299.9}'
前端调用示例
async function createUser() {
const response = await fetch("http://127.0.0.1:8000/users", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "张三",
phone: "13800000000",
nickname: "小张",
avatar: "",
is_admin: false,
total_spent: 0,
}),
});
if (!response.ok) {
throw new Error("创建用户失败");
}
}
return response.json();
}
Todo 接口
GET /todos
POST /todos
GET /todos/{todo_id}
PATCH /todos/{todo_id}
DELETE /todos/{todo_id}
前端工程
前端目录在 front，使用 Vue 3、Vite、vue-router 和 Ant Design Vue。用户管理页面已接入后端 /users 接口。
安装依赖：
cd front
pnpm install
启动前端：
pnpm dev
前端默认运行在：
http://127.0.0.1:5173
前端路由：
/login 静态登录页
/temples 寺院管理
/products 商品管理
/orders 订单管理
/ritual-services 法事管理
/users 用户管理
/todos Todo 管理占位页
Vite 会把前端请求 /api/users 代理到后端：
http://127.0.0.1:8000/users
如果后端端口不是 8000，可以启动前端时指定：
VITE_API_TARGET=http://127.0.0.1:8010 pnpm dev
前端应用名默认是“自在福田”，可以启动时覆盖：
VITE_APP_NAME=自在福田 pnpm dev