首次提交

app/__init__.py

@@ -0,0 +1,35 @@
+"""
+应用工厂模块（Application Factory Pattern）
+- 延迟创建 Flask 实例，支持测试时传入不同配置
+- 扩展对象在模块顶层创建但不绑定 app，通过 init_app() 延迟绑定
+- 这种模式是 Flask 官方推荐的最佳实践，避免循环导入
+"""
+from flask import Flask
+from flask_sqlalchemy import SQLAlchemy
+from flask_migrate import Migrate
+from app.config import Config
+
+# ✅ 扩展实例在工厂外部创建，不与任何 app 绑定
+# 这样可以在测试中创建多个 app 实例共享同一套扩展
+db = SQLAlchemy()
+migrate = Migrate()
+
+
+def create_app(config_class=Config):
+    """
+    应用工厂函数
+    :param config_class: 配置类，默认使用 Config，测试时可替换为 TestingConfig
+    :return: 配置完成的 Flask 应用实例
+    """
+    app = Flask(__name__)
+    app.config.from_object(config_class)
+
+    # 将扩展绑定到当前 app 实例
+    db.init_app(app)
+    migrate.init_app(app, db)
+
+    # 注册蓝图（放在这里避免循环导入：蓝图引用 db → db 在工厂中初始化）
+    from app.routes.user import user_bp
+    app.register_blueprint(user_bp, url_prefix='/api/users')
+
+    return app