"""
Flipventory v2 – FastAPI application entry point.

What is this?
--------------
Inventory management system for small-to-medium resellers who use a
"chaotic stockpiling" approach: buy first, sort later.  Items are added
quickly, placed in physical storage bins, and gradually processed through
a FOUND → LISTED → SOLD lifecycle.

Architecture overview
----------------------
  app/
    config.py       – settings (secret key, DB URL, admin e-mail)
    database.py     – SQLAlchemy engine + session factory
    models/         – ORM table definitions (user, item, storage_bin)
    schemas/        – Pydantic request/response shapes
    auth/           – JWT creation & FastAPI dependencies
    routers/
      auth.py       – /auth/register, /auth/login, /auth/me
      users.py      – /users CRUD (admin only)
      items.py      – /bins and /items CRUD

Running locally
----------------
    uvicorn app.main:app --reload

Then open http://127.0.0.1:8000/docs for the interactive Swagger UI.
"""
from contextlib import asynccontextmanager

from fastapi import FastAPI

from app.database import create_tables
from app.routers import auth, items, users


# ---------------------------------------------------------------------------
# Lifespan: run startup/shutdown logic without deprecated @app.on_event hooks
# ---------------------------------------------------------------------------

@asynccontextmanager
async def lifespan(app: FastAPI):
    # Startup: create DB tables if they don't exist yet.
    # In a production deployment with Alembic migrations this call would be
    # replaced by running `alembic upgrade head` in the CI/CD pipeline.
    create_tables()
    yield
    # (Nothing to clean up on shutdown for now.)


# ---------------------------------------------------------------------------
# Application instance
# ---------------------------------------------------------------------------

app = FastAPI(
    title="Flipventory v2",
    description=(
        "Inventory management for small/medium resellers. "
        "Tame the chaos: add items fast, sort later, track every flip."
    ),
    version="0.1.0",
    lifespan=lifespan,
)

# ---------------------------------------------------------------------------
# Routers
# ---------------------------------------------------------------------------

app.include_router(auth.router)
app.include_router(users.router)
app.include_router(items.router)


# ---------------------------------------------------------------------------
# Health check
# ---------------------------------------------------------------------------

@app.get("/health", tags=["meta"])
def health() -> dict:
    """Simple liveness probe.  Returns 200 if the server is up."""
    return {"status": "ok", "version": app.version}