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

启动后访问：

• API 文档：http://127.0.0.1:8000/docs
• 健康检查：http://127.0.0.1:8000/health

默认数据库文件是 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