students/README_students.md

# students模块解释

## 项目层：
web框架：FastAPI(自动生成接口)
ORM：sqlalchemy
校验：pydantic
数据库：MYSQL(通过 PyMysql 驱动)
运行：uvicorn，端口暂定52000

总结：用 FastAPI 暴露一组 HTTP 接口
   ， 对 MySQL 里的一张 `students` 表做**增、删、改、查**
   ， 其中删除是**逻辑删除（软删除）**
   ， 数据不会被真正抹掉。

项目根目录是`main.py`是程序入口，而`students/`是一个

## main：学生管理系统的主程序文件、测试接口
1. 下面所有配置文件的接口全部导入并建表
2. 创建fastapi接口并本地运行

## databases：链接数据库配置文件
1. 链接本地mysql，实例化mysql，创建引擎，创建基类，实例化数据库会话
2. 创建函数，调用数据库会话

## api.students_api：接口文件
### 学生表students的功能接口:
1. 学生信息的查询
2. 学生信息的新增
3. 学生信息的更新
4. 学生信息的逻辑删除

## dao.students_dao：数据筛选文件
### 数据库的逻辑筛选文件:
1. 查询：get_student_dao
2. 新增：add_student_dao
3. 更新：update_student_dao
4. 逻辑删除：delete_student_dao

## model.students_model：数据库建表文件
1. 数据表建表代码
2. 字段信息： sid **PK**
          , student_name 
          , student_phone 
          , class_name 
          , job_open_time 
          , offer_issue_time 
          , company_name 
          , salary 
          , create_date 
          , update_date 
          , is_deleted 
          , deleted_date
          , **待建FK:** class_id/teacher_id/score_id/company_id/


## schema.students_request：请求体、数据过滤
请求体根据业务要求有不同调整，方便后续维护和更改需求
1. 查询：StudentsQuery
2. 新增：StudentsResponse
3. 更新：StudentsUpdate
4. 逻辑删除：StudentsDelete