# 1. 从fastapi框架导入核心类FastAPI，用于创建Web应用
from fastapi import FastAPI
# 2. 从pydantic库导入BaseModel，用于定义数据格式、自动校验请求数据
from pydantic import BaseModel

# 3. 创建FastAPI应用实例，整个接口服务的核心对象
app = FastAPI()

# 4. 定义一个数据模型（请求体格式）
# 继承BaseModel：pydantic的核心功能，会自动校验前端传来的数据是否符合格式
class Question(BaseModel):
    # 定义必填字段：用户输入的问题，类型必须是字符串(str)
    content: str              
    # 定义可选字段：会话ID，用于区分不同用户/对话
    # = "default" 表示如果前端不传这个参数，自动使用默认值 default
    session_id: str = "default"  

# 5. 定义POST接口：访问路径为 /ask
# POST 适合提交数据（比如用户问题），比GET更安全
@app.post("/ask")
# 6. 接口函数：参数 q 是上面定义的 Question 模型
# FastAPI会自动接收前端传来的JSON数据，校验格式，并封装成 q 对象
def ask(q: Question):
    # 7. 返回JSON格式的响应数据
    return {
        # 取出用户提交的问题内容
        "question": q.content,
        # 取出会话ID（前端传了用传的，没传用默认值）
        "session": q.session_id,
        # 占位符：下一步我们会在这里接入真正的AI回复
        "answer": "（AI 回复将在下一步接入）"
    }    