Repository navigation
FastAPI Template v1.0.0
Production-ready async FastAPI template with full feature parity from the Flask TaxTechCompass prototype.
What's Included
Foundation & Database
- Async app factory with lifespan, pydantic-settings v2 config (dev/prod/test)
- SQLAlchemy 2.0 async ORM (asyncpg / aiosqlite), Alembic migrations
- User and AuditLog models with UUID primary keys
Authentication & Security
- Session-based auth with sliding expiration and single-session enforcement
- RBAC via FastAPI dependency injection (admin/moderator/user)
- CSRF protection, rate limiting (10/min login), CSP/security headers, server masking
UI & Templates
- Deloitte-branded Bootstrap 5.3 Jinja2 templates (navbar with logo animation, gradient headers)
- Login page, authenticated home page, custom error pages (401/403/404/500)
- User dropdown menu with role badge and admin link
Admin Dashboard
- Stats cards (total/active/admin user counts)
- User management table with modal-confirmed toggle-active and role-change
- Paginated audit log with action type and date range filters
- Self-action guards (admin cannot deactivate/demote themselves)
i18n
- German/English with
t()template helper and session-persisted language - 60+ translation keys covering all UI text
Audit Logging
- Async background tasks for login, logout, toggle-active, role-change
- Captures user ID, IP address, user agent, and old/new values
Developer Experience
- arel-based browser livereload in dev mode
- Template regression tests (role rendering, i18n coverage, smoke tests)
- Swagger/ReDoc auto-generated (dev only)