"""FastAPI 主应用模块。

定义 Web 路由和启动入口，提供 RESTful 风格的任务管理 API。
"""

from fastapi import FastAPI, HTTPException

from app.models import TodoCreate, TodoUpdate, TodoResponse, TodoListResponse
from app.services import todo_service

app = FastAPI(
    title="Todo Manager API",
    description="一个简单的任务管理器示例 API，使用内存假数据。",
    version="1.0.0",
)


@app.get("/api/todos", response_model=TodoListResponse, tags=["Todos"])
def list_todos():
    """获取所有任务列表。

    Returns:
        包含任务列表和总数的响应。
    """
    items, total = todo_service.list_todos()
    return TodoListResponse(data=items, total=total)


@app.get("/api/todos/{todo_id}", response_model=TodoResponse, tags=["Todos"])
def get_todo(todo_id: int):
    """根据 ID 获取单个任务。

    Args:
        todo_id: 任务唯一标识。

    Returns:
        包含任务详细信息的响应。

    Raises:
        HTTPException: 任务不存在时返回 404。
    """
    item = todo_service.get_todo(todo_id)
    if item is None:
        raise HTTPException(status_code=404, detail=f"Todo with id {todo_id} not found")
    return TodoResponse(data=item)


@app.post("/api/todos", response_model=TodoResponse, status_code=201, tags=["Todos"])
def create_todo(data: TodoCreate):
    """创建新任务。

    Args:
        data: 包含标题和描述的任务创建请求。

    Returns:
        包含新创建任务信息的响应。
    """
    item = todo_service.create_todo(data)
    return TodoResponse(code=201, message="created", data=item)


@app.put("/api/todos/{todo_id}", response_model=TodoResponse, tags=["Todos"])
def update_todo(todo_id: int, data: TodoUpdate):
    """更新已有任务。

    Args:
        todo_id: 要更新的任务 ID。
        data: 包含需要更新字段的请求体。

    Returns:
        包含更新后任务信息的响应。

    Raises:
        HTTPException: 任务不存在时返回 404。
    """
    item = todo_service.update_todo(todo_id, data)
    if item is None:
        raise HTTPException(status_code=404, detail=f"Todo with id {todo_id} not found")
    return TodoResponse(data=item)


@app.delete("/api/todos/{todo_id}", response_model=TodoResponse, tags=["Todos"])
def delete_todo(todo_id: int):
    """删除指定任务。

    Args:
        todo_id: 要删除的任务 ID。

    Returns:
        删除成功的确认响应。

    Raises:
        HTTPException: 任务不存在时返回 404。
    """
    deleted = todo_service.delete_todo(todo_id)
    if not deleted:
        raise HTTPException(status_code=404, detail=f"Todo with id {todo_id} not found")
    return TodoResponse(message="deleted")


@app.get("/", tags=["Root"])
def root():
    """根路径，返回 API 基础信息。"""
    return {
        "name": "Todo Manager API",
        "version": "1.0.0",
        "docs": "/docs",
    }