Archived
snowy-yang
8446166120
## uv 环境管理 - pyproject.toml 声明 dependencies + [dependency-groups].dev，uv.lock 精确锁定 - 删除 requirements.txt / requirements-fastapi.txt / requirements-dev.txt - .python-version = 3.12；Dockerfile 改用 uv sync --frozen（可复现构建） - 新增 jinja2（首页渲染） ## 删除 Flask 技术债 - 从 main.py 用 ast 精确剥离 56 个 Flask 节点（路由/中间件/错误处理/启动）， 框架无关的服务层落为 services/runtime.py（MusicAPIService、下载/打包 worker、 任务监控、缓存清扫），零 Flask 依赖 - 删除 main.py（4527 行）与 auth_routes.py（1050 行） - auth_system.py 移除会话/请求上下文层（login_session/current_user/login_required/ admin_required/_client_ip 等），保留数据与业务层 - 新增 core/net.py（IP 解析）、web/auth_state.py（登录锁定/2FA 票据/发码限流） - FastAPI 侧改直接依赖 services.runtime，不再 import main - web/app.py 去掉 Flask fallback；入口默认根路径模式（API_PREFIX 可选） ## 删除 requests 技术债 - 新增 core/sync_http.py：requests 风格的同步门面（底层 aiohttp 连接池， 流式读取经有界队列背压），含 Session/headers/(connect,read) 元组超时兼容 - core/utils、auth_system、podcast_api、music_downloader、services 全部切换 - 实测真实下载 5.2MB 音频完整成功 ## 质量门禁归零 - ruff：0 错误（B904 全部修复，不再忽略） - pyright：0 错误（类型收窄修复） - pytest：140/140（含 golden 契约回归、root 模式 66 项路径覆盖） - 真实 uvicorn 启动：/health、/、/static、受保护端鉴权全部正确 新增 tests/golden/responses.json：删除 Flask 前捕获的 32 例响应快照， FastAPI 逐字段复现——删除巨石后行为回归仍有硬证据。
43 lines
1.5 KiB
Python
43 lines
1.5 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""FastAPI 服务入口（uvicorn）。
|
|
|
|
运行（生产/开发一致）：
|
|
python web/main.py
|
|
|
|
迁移期（strangler）：默认开启 Flask 兜底——未迁移的路由由遗留 Flask 应用处理，
|
|
已迁移的 /api/v1 路由走 FastAPI。全部迁移完成后把 FASTAPI_FLASK_FALLBACK 默认值
|
|
改为 0 即可完全脱离 Flask（届时删除 setdefault 行为）。
|
|
"""
|
|
import os
|
|
import sys
|
|
|
|
import uvicorn
|
|
|
|
# 直接以 `python web/main.py` 运行时，sys.path[0] 是 web/ 而非项目根——
|
|
# 补上项目根，保证 `import core` / `import music_api` / `import web.app` 可用。
|
|
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
|
|
from web.app import create_app
|
|
|
|
HOST = os.environ.get('HOST', '0.0.0.0')
|
|
PORT = int(os.environ.get('PORT', '5000'))
|
|
|
|
# Flask 巨石已删除：本应用即唯一服务端，直接服务前端使用的根路径。
|
|
# API_PREFIX 非空时挂在子前缀下（契约比对脚本使用）。
|
|
API_PREFIX = os.environ.get('API_PREFIX', '').strip()
|
|
|
|
app = create_app(api_prefix=API_PREFIX)
|
|
|
|
if __name__ == '__main__':
|
|
uvicorn.run(
|
|
app,
|
|
host=HOST,
|
|
port=PORT,
|
|
log_level=os.environ.get('LOG_LEVEL', 'info').lower(),
|
|
# 反向代理（Caddy 本机回环）下按 XFF 取真实 IP，与既有口径一致
|
|
proxy_headers=True,
|
|
forwarded_allow_ips='127.0.0.1',
|
|
server_header=False, # 不暴露服务器版本指纹
|
|
date_header=True,
|
|
)
|