loom/backend/README.md

Loom Backend

FastAPI + SQLAlchemy 2.0 (async) + Celery + PostgreSQL + Redis。

本地开发

# 1. 创建虚拟环境并安装依赖
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

# 2. 配置（根目录 .env 由 .env.example 复制）
# 生成 APP_SECRET_KEY：openssl rand -hex 32
# 生成 FERNET_KEY：python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

# 3. 起 pg/redis
docker compose -f ../docker-compose.yml up -d postgres redis

# 4. 跑迁移（P1 暂无迁移文件，可跳过）
alembic upgrade head

# 5. 启动
uvicorn app.main:app --reload

# 6. 检查
open http://localhost:8000/api/v1/healthz
open http://localhost:8000/docs

测试

pytest

目录

app/
├── main.py              FastAPI 入口
├── core/                配置、日志、异常、JWT、依赖
├── db/                  SQLAlchemy 引擎 & Base
├── api/v1/              REST 路由
├── models/              ORM（P2 起）
├── schemas/             Pydantic DTO（P2 起）
├── services/            业务服务（P2 起）
├── tasks/               Celery 任务（P5 起）
├── integrations/        Lobster / OpenAI 客户端（P4/P6）
└── utils/