Afrexai Fastapi Production

# FastAPI Production Engineering

Complete methodology for building, deploying, and scaling production FastAPI applications. Not a tutorial — a production operating system.

## Quick Health Check (/16)

Score 2 points each. Total < 8 = critical work needed.

| Signal | Healthy | Unhealthy |
|--------|---------|-----------|
| Type safety | Pydantic v2 models everywhere | `dict` returns, no validation |
| Error handling | Structured error hierarchy | Bare `HTTPException` strings |
| Auth | JWT + dependency injection | Manual token parsing |
| Testing | 80%+ coverage, async tests | No tests or sync-only |
| Database | Async ORM, migrations | Raw SQL, no migrations |
| Observability | Structured logging + tracing | `print()` debugging |
| Deployment | Multi-stage Docker, health checks | `uvicorn main:app` on bare metal |
| Documentation | Auto-generated, accurate OpenAPI | Default `/docs` untouched |

## Phase 1: Project Architecture

### Recommended Structure

```
src/
├── app/
│   ├── __init__.py
│   ├── main.py              # App factory
│   ├── config.py             # Pydantic Settings
│   ├── dependencies.py       # Shared DI
│   ├── middleware.py          # Custom middleware
│   ├── features/
│   │   ├── users/
│   │   │   ├── __init__.py
│   │   │   ├── router.py     # Endpoints
│   │   │   ├── schemas.py    # Pydantic models
│   │   │   ├── service.py    # Business logic
│   │   │   ├── repository.py # Data access
│   │   │   ├── models.py     # SQLAlchemy/SQLModel
│   │   │   ├── dependencies.py
│   │   │   └── exceptions.py
│   │   ├── auth/
│   │   ├── orders/
│   │   └── ...
│   ├── core/
│   │   ├── database.py       # Engine, session factory
│   │   ├── security.py       # JWT, hashing
│   │   ├── errors.py         # Error hierarchy
│   │   └── logging.py        # Structlog config
│   └── shared/
│       ├── pagination.py
│       ├── filters.py
│       └── responses.py
├── migrations/               # Alembic
├── tests/
│   ├── conftest.py
│   ├── unit/
│...

# 🚀 AfrexAI FastAPI Production Engineering

Complete methodology for building, deploying, and scaling production FastAPI applications. Not a tutorial — a production operating system.

## What This Skill Does

Transforms your FastAPI project from prototype to production-grade with:

- **Project architecture** — Feature-based structure with strict layering
- **Pydantic v2 mastery** — Schema design, validation, generics
- **Error handling** — Structured exception hierarchy with global handler
- **Auth & security** — JWT + RBAC + 10-point security checklist
- **Database patterns** — Async SQLAlchemy + repository pattern + migrations
- **Testing** — Async test patterns with pytest-asyncio + httpx
- **Observability** — Structlog + request tracing + health checks
- **Deployment** — Multi-stage Docker + GitHub Actions CI + production checklist

## Install

```bash
clawhub install afrexai-fastapi-production
```

## Quick Start

Ask your agent:
- `audit my FastAPI project` — get a health score out of 16
- `set up a new FastAPI project` — full structure + config
- `add authentication` — JWT + dependency injection pattern
- `prepare for production` — Dockerfile + CI + checklist

## What Makes This 10X Better

| Feature | Generic Skills | This Skill |
|---------|---------------|------------|
| Architecture | "Use routers" | Full feature-based structure with 7 rules |
| Error handling | `HTTPException(404)` | Custom hierarchy + global handler + structured JSON |
| Auth | Basic JWT example | JWT + RBAC + DI + 10-point security checklist |
| Database | Raw SQLAlchemy | Async + repository pattern + migrations |
| Testing | "Write tests" | Async patterns + fixtures + parametrized + 7 rules |
| Deployment | `uvicorn main:app` | Multi-stage Docker + CI + health checks + checklist |
| Quality | No scoring | 0-100 rubric across 8 weighted dimensions |

## ⚡ Level Up

Get the [AfrexAI SaaS Context Pack ($47)](https://afrexai-cto.github.io/context-packs/) for complete SaaS architecture,...