初始提交:项目基础结构

- backend: FastAPI 后端服务 (Python)
- frontend: React + Tauri 前端应用
- docker-compose.yml: 容器编排配置
This commit is contained in:
2026-08-04 10:05:59 +08:00
commit 17105dc9c2
61 changed files with 3633 additions and 0 deletions

1
backend/alembic/README Normal file
View File

@ -0,0 +1 @@
Generic single-database configuration.

59
backend/alembic/env.py Normal file
View File

@ -0,0 +1,59 @@
"""Alembic 迁移环境配置 — 异步引擎 + 自动加载模型"""
import asyncio
from logging.config import fileConfig
from alembic import context
from sqlalchemy.ext.asyncio import create_async_engine
from app.core.config import settings
from app.models import Base # 自动发现所有 SQLAlchemy 模型
# Alembic Config 对象
config = context.config
# 日志配置
if config.config_file_name is not None:
fileConfig(config.config_file_name)
# 将 DATABASE_URL 同步到 alembic 配置中(覆盖 alembic.ini 中的占位值)
config.set_main_option("sqlalchemy.url", settings.DATABASE_URL)
# 自动生成迁移时需要的 models 元数据
target_metadata = Base.metadata
def run_migrations_offline() -> None:
"""离线模式:生成 SQL 脚本而非直接执行"""
url = config.get_main_option("sqlalchemy.url")
context.configure(
url=url,
target_metadata=target_metadata,
literal_binds=True,
dialect_opts={"paramstyle": "named"},
)
with context.begin_transaction():
context.run_migrations()
def do_run_migrations(connection):
"""在线模式:通过数据库连接执行迁移"""
context.configure(connection=connection, target_metadata=target_metadata)
with context.begin_transaction():
context.run_migrations()
async def run_migrations_online() -> None:
"""在线模式:异步引擎"""
connectable = create_async_engine(
config.get_main_option("sqlalchemy.url"),
echo=settings.DEBUG,
)
async with connectable.connect() as connection:
await connection.run_sync(do_run_migrations)
await connectable.dispose()
if context.is_offline_mode():
run_migrations_offline()
else:
asyncio.run(run_migrations_online())

View File

@ -0,0 +1,28 @@
"""${message}
Revision ID: ${up_revision}
Revises: ${down_revision | comma,n}
Create Date: ${create_date}
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
${imports if imports else ""}
# revision identifiers, used by Alembic.
revision: str = ${repr(up_revision)}
down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
def upgrade() -> None:
"""Upgrade schema."""
${upgrades if upgrades else "pass"}
def downgrade() -> None:
"""Downgrade schema."""
${downgrades if downgrades else "pass"}