init

.idea/.gitignore

@@ -0,0 +1,10 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 已忽略包含查询文件的默认文件夹
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/

.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.14 (wl_student_manager_system)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.14 (wl_student_manager_system)" project-jdk-type="Python SDK" />
+</project>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/wl_student_manager_system.iml" filepath="$PROJECT_DIR$/.idea/wl_student_manager_system.iml" />
+    </modules>
+  </component>
+</project>

.idea/wl_student_manager_system.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.14 (wl_student_manager_system)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

database.py

@@ -0,0 +1,39 @@
+# database.py
+# 本文件负责配置数据库连接、创建引擎、会话工厂，并提供依赖注入函数
+
+from sqlalchemy import create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+
+# 1. 配置 MySQL 数据库连接 URL
+# 格式：mysql+pymysql://用户名:密码@主机:端口/数据库名?编码
+# 请将下面的 'root', '123456', 'localhost', '3306', 'test_db' 替换为你自己的实际信息
+SQLALCHEMY_DATABASE_URL = "mysql+pymysql://root:123456@localhost:3306/test_db"
+
+# 2. 创建数据库引擎
+#    - pool_pre_ping=True 表示每次从连接池取出连接前先 ping 一下，防止使用已断开的连接
+engine = create_engine(
+    SQLALCHEMY_DATABASE_URL,
+    pool_pre_ping=True,
+    echo=True  # 设置为 True 会在控制台打印所有 SQL 语句，便于调试，生产环境可关闭
+)
+
+# 3. 创建会话工厂
+#    autocommit=False：不自动提交，需要手动 commit
+#    autoflush=False：不自动 flush，在查询前会自动 flush，一般保持默认
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+# 4. 创建声明式基类，所有模型类都继承自它
+Base = declarative_base()
+
+# 5. 依赖注入函数：用于 FastAPI 路由中获取数据库会话
+def get_db():
+    """
+    每次请求创建一个数据库会话，请求结束后关闭。
+    这个函数会作为 Depends 的参数注入到路由中。
+    """
+    db = SessionLocal()          # 创建一个会话实例
+    try:
+        yield db                 # 将会话交给路由函数使用
+    finally:
+        db.close()               # 无论是否发生异常，最后都会关闭会话，释放连接

main.py

@@ -0,0 +1 @@
+#项目初始化入口