# main.py
# 项目入口文件：创建 FastAPI 应用、注册路由

from pathlib import Path

from fastapi import FastAPI, Request
from fastapi.middleware.cors import CORSMiddleware
from fastapi.responses import JSONResponse
from fastapi.staticfiles import StaticFiles

from api import statistics_api, stu_score_api, cls_mgmt_api, employ_api, stu_api, teacher_api, advisor_api
from dao.exceptions import DaoError

# 1. 创建 FastAPI 实例
app = FastAPI(
    title="码力全开: 学生管理系统",
    description="本项目旨在开发一个基于 FastAPI 的学生管理系统，"
                "提供学生基本信息管理、考核成绩管理、就业管理、教师/顾问管理和统计分析等核心功能模块。"
                "系统采用 RESTful API 设计，支持前后端分离架构。<br>",
    version="0.1.0"
)

# 2. 添加跨域中间件（允许前端跨域请求）
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],           # 允许所有来源，生产环境应指定具体域名
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

# 3. 注册 DAO 层异常处理器
#    dao 层只抛 NotFoundError / ConflictError 这类业务异常，不依赖 FastAPI；
#    在这里统一映射成 HTTP 状态码（404 / 409），接口层因此不需要写 try/except。
@app.exception_handler(DaoError)
async def dao_error_handler(request: Request, exc: DaoError):
    """把 DAO 层异常转成 {"detail": "..."} 的标准错误响应。"""
    return JSONResponse(status_code=exc.status_code, content={"detail": exc.detail})


# 4. 注册子路由
app.include_router(statistics_api.router, prefix="/api/stats", tags=["统计分析模块(动态查询与综合能力锻炼)"])

app.include_router(stu_score_api.router, prefix="/api/score", tags=["学生成绩管理模块"])

app.include_router(cls_mgmt_api.router, prefix="/api/classes", tags=["班级管理模块"])

app.include_router(employ_api.router, prefix="/api/employ", tags=["学生就业管理模块"])

app.include_router(teacher_api.router, prefix="/api/teacher", tags=["教师信息管理模块"])

app.include_router(advisor_api.router, prefix="/api/advisor", tags=["顾问信息管理模块"])

app.include_router(stu_api.router, prefix="/api/student", tags=["学生信息管理模块"])


# 5. 挂载前端静态页面（原生 HTML/CSS/JS 单页应用，无需构建）
#    访问 http://localhost:8002/ui 即可打开可视化管理界面
STATIC_DIR = Path(__file__).resolve().parent / "static"
if STATIC_DIR.is_dir():
    app.mount("/ui", StaticFiles(directory=str(STATIC_DIR), html=True), name="ui")


# 6. 根路径
@app.get("/")
async def root():
    return {"message": "欢迎访问 码力全开: 学生管理系统 分层示例！请访问 /docs 查看 API 文档。"}


# 7. 如果直接运行此文件，启动 uvicorn 服务器
if __name__ == "__main__":
    import os

    import uvicorn
    uvicorn.run(
        "main:app",      # 指定应用位置（模块名:应用变量名）
        host=os.getenv("HOST", "0.0.0.0"),  # 0.0.0.0 才能在容器内被外部访问
        port=int(os.getenv("PORT", "8002")),  # 端口（避开原项目的 8001）
        reload=os.getenv("APP_RELOAD", "false").lower() == "true"  # 开发模式可设为 true
    )