"""Endpoints for the <area> team (GP5).

src/planner/main.py finds this file and adds `router` to the application,
so every endpoint here appears on the /docs page. Run the application from
the top of the repository:

    fastapi dev src/planner/main.py

Each person replaces one read stub and one write stub with their own work,
renames them, and puts their name in the docstrings. Add imports as you
need them, such as:

    from fastapi import HTTPException
    from sqlalchemy.exc import IntegrityError
    from sqlmodel import Field, SQLModel

    from planner.core.security import CurrentAdvisor, CurrentStudent
    from planner.<area>.queries import QuietStudent, quiet_students

Import only what you use, since ruff check fails on an unused import.
"""

from fastapi import APIRouter

from planner.core import SessionDep
from planner.core.security import CurrentPerson

# Every path below starts with /<area>, which this prefix adds for you.
router = APIRouter(prefix="/<area>", tags=["<area>"])


# ---------------------------------------------------------------------------
# Read endpoints: one per person, each serving a query or view from
# queries.py, with its view class (or another SQLModel class) as the
# return type.
# ---------------------------------------------------------------------------


@router.get("/read-one")
def read_one(person: CurrentPerson, session: SessionDep) -> list:
    """Author: First Last. Which use case from the README does this serve?"""
    return []


@router.get("/read-two")
def read_two(person: CurrentPerson, session: SessionDep) -> list:
    """Author: First Last. Which use case from the README does this serve?"""
    return []


@router.get("/read-three")
def read_three(person: CurrentPerson, session: SessionDep) -> list:
    """Author: First Last. Which use case from the README does this serve?"""
    return []


@router.get("/read-four")
def read_four(person: CurrentPerson, session: SessionDep) -> list:
    """Author: First Last. Which use case from the README does this serve?"""
    return []


# ---------------------------------------------------------------------------
# Write endpoints: one per person, each creating, changing, or deleting rows
# of this team's own tables, with a request model and the right status code.
# Replace the method too: @router.post, @router.patch, or @router.delete.
# ---------------------------------------------------------------------------


@router.post("/write-one", status_code=201)
def write_one(person: CurrentPerson, session: SessionDep) -> dict:
    """Author: First Last. Which use case from the README does this serve?"""
    return {}


@router.post("/write-two", status_code=201)
def write_two(person: CurrentPerson, session: SessionDep) -> dict:
    """Author: First Last. Which use case from the README does this serve?"""
    return {}


@router.post("/write-three", status_code=201)
def write_three(person: CurrentPerson, session: SessionDep) -> dict:
    """Author: First Last. Which use case from the README does this serve?"""
    return {}


@router.post("/write-four", status_code=201)
def write_four(person: CurrentPerson, session: SessionDep) -> dict:
    """Author: First Last. Which use case from the README does this serve?"""
    return {}
