refactor: P2 core+common 建设(应用工厂/扩展/工具层迁入 src/)

【结构】
- src/core/:database/response/jwt/password/security/redis_client/mail/scheduler
- src/common/:base_model/base_db/forms(base_form+fields)/constants/utils
- src/models_registry.py:模型聚合器(Flask-Migrate 全量表识别)

【绞杀者 shim】extensions/、utils/、application/constants|forms|models 打兼容转发
【兼容修复】应用工厂抽取至 application/factory.py(P2 前置,P1 已完成)

【基线修复】application/models(25) + middleware(7) 原被嵌套 .gitignore(*)
误排除出版本库,已补入(base_model/base_db 现为 shim,原版在 src/common/)

【登记既有缺陷】
1. flask db CLI 因 .env FLASK_VERSION 与 --version 冲突报错 → Makefile 已加 FLASK_SKIP_DOTENV=1
2. 本机 Redis 未设密码但 REDIS_AUTH=True,/captcha 报 AUTH 错误(环境问题)

【验收】22 模型表全量识别;src/ flake8 零告警;pytest 5 passed;应用启动;
/login 表单校验、/user/page 鉴权拦截冒烟正常

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
DjangoAdmin Dev
2026-08-07 13:20:46 +08:00
co-authored by Claude
parent 92130ef070
commit 658ee6d596
96 changed files with 9926 additions and 4153 deletions
+4 -42
View File
@@ -1,46 +1,8 @@
"""
Flask-Mail 扩展初始化模块
扩展兼容 shim(绞杀者迁移期间保留)
=============================================================
仅负责 Flask-Mail 扩展实例的创建与初始化。
Flask-Mail 扩展已迁移至 src/core/mail.py。
本文件仅作兼容转发,最终在 P7(切尾)阶段删除。
"""
from flask import Flask
from flask_mail import Mail
# Flask-Mail 扩展实例
# 在应用工厂中通过 mail.init_app(app) 完成绑定
mail = Mail()
def init_mail(app: Flask):
"""
初始化 Flask-Mail 扩展,将 Mail 实例绑定到应用。
Args:
app: Flask 应用实例
Example:
# 在应用工厂函数中调用
init_mail(app)
"""
from config import (
MAIL_MAILER, MAIL_SERVER, MAIL_PORT, MAIL_USE_SSL,
MAIL_USERNAME, MAIL_PASSWORD, MAIL_ENCRYPTION,
MAIL_FROM_NAME, MAIL_FROM_ADDRESS,
)
app.config['MAIL_MAILER'] = MAIL_MAILER
app.config['MAIL_SERVER'] = MAIL_SERVER
app.config['MAIL_PORT'] = MAIL_PORT
app.config['MAIL_USE_SSL'] = MAIL_USE_SSL
app.config['MAIL_USERNAME'] = MAIL_USERNAME
app.config['MAIL_PASSWORD'] = MAIL_PASSWORD
app.config['MAIL_ENCRYPTION'] = MAIL_ENCRYPTION
app.config['MAIL_DEFAULT_SENDER'] = (
f'{MAIL_FROM_NAME} <{MAIL_FROM_ADDRESS}>' if MAIL_FROM_NAME and MAIL_FROM_ADDRESS
else MAIL_FROM_ADDRESS or None
)
mail.init_app(app)
from src.core.mail import * # noqa: F401,F403