Skip to content

Python 后端概览

路径:packages/server-python
技术:FastAPI + SQLAlchemy 2.0 + JWT + bcrypt

启动

bash
cd packages/server-python
pip install -e .
uvicorn app.main:app --reload --host 0.0.0.0 --port 8080
# 或
pnpm dev

文档:http://localhost:8000/docs

目录结构

text
app/
├── api/v1/       auth.py、system.py、router.py
├── api/deps.py   get_current_user、require_permission
├── core/         config、security、database、permissions
├── models/       SQLAlchemy 模型
├── schemas/      Pydantic DTO
├── services/     业务逻辑、seed
└── main.py       入口、异常处理

与 Java 对齐

  • 相同 API 路径与 JSON 字段
  • 相同 12 个 permission code
  • 相同 401/403 中文 message
  • 相同菜单过滤逻辑

相关文档

Xichen Full Stack 内部文档