How fastapi-practices/fastapi_best_architecture works
FastAPI Best Architecture is an enterprise backend framework organized around a three-tier API/schema/service/CRUD/model structure. Its main request path begins at the HTTP API and returns a response; authentication verifies JWTs and loads user state. Major product branches include administration, asynchronous scheduled tasks, and dynamically routed plugins for code generation, configuration, dictionaries, email, notices, and OAuth2. The graph also shows shared runtime infrastructure. Some subsystem routes and calls are unsampled, so uncertain links are omitted or marked unverified.
Main entry points: router.py Plugin routing · jwt.py JWT security · api Admin API · auth_service.py Authentication
Components 27
Application entry
- App startup
backend/main.py - App routes
backend/app/router.py - Plugin routing
backend/plugin/router.py
Administration
- Admin API
backend/app/admin/api - Authentication
backend/app/admin/service/auth_service.py - User access
backend/app/admin/crud/crud_user.py - User schemas
backend/app/admin/schema/user.py - Admin domains
backend/app/admin
Background tasks
- Task API
backend/app/task/api - Scheduler service
backend/app/task/service/scheduler_service.py - Task database
backend/app/task/database.py - Task execution
backend/app/task/celery.py
Plugin capabilities
- Code generation
backend/plugin/code_generator/service/code_gen_service.py - Configuration plugin
backend/plugin/config - Dictionary plugin
backend/plugin/dict/service/dict_data_service.py - Email plugin
backend/plugin/email - Notice plugin
backend/plugin/notice/service/notice_service.py - OAuth2 plugin
backend/plugin/oauth2/service/oauth2_service.py
Shared runtime
- JWT security
backend/common/security/jwt.py - Settings
backend/core/conf.py - Redis client
backend/database/redis.py - Request context
backend/common/context.py - Metrics
backend/common/observability/prometheus/fastapi.py - Shared utilities
backend/utils - Shared types
backend/common/enums.py - Logging
backend/common/log.py
Other components
- API client
Connections 27
- API client → Admin API: sends requests
README.md - Admin API → Authentication: authenticates
- Authentication → JWT security: issues tokens
backend/app/admin/service/auth_service.py - JWT security → User access: loads users
backend/common/security/jwt.py - JWT security → Redis client: checks token state
backend/common/security/jwt.py - JWT security → User schemas: validates user data
backend/common/security/jwt.py - Authentication → User access: accesses users
backend/app/admin/service/auth_service.py - Authentication → User schemas: uses schemas
backend/app/admin/service/auth_service.py - Admin API → Metrics: registers metrics
backend/app/admin/api/router.py - Admin API → Admin domains: routes domains
backend/app/admin/api/v1/sys/__init__.py - App startup → Plugin routing: initializes plugins
backend/main.py - Plugin routing → App routes: registers routes
backend/plugin/router.py - Plugin routing → Code generation: routes capability
- Plugin routing → Configuration plugin: routes capability
- Plugin routing → Dictionary plugin: routes capability
- Plugin routing → Email plugin: routes capability
- Plugin routing → Notice plugin: routes capability
- Plugin routing → OAuth2 plugin: routes capability
- Task API → Scheduler service: handles schedules
- Scheduler service → Task execution: dispatches tasks
backend/app/task/service/scheduler_service.py - Scheduler service → Task database: accesses persistence
- Task API → Metrics: registers metrics
backend/app/task/api/router.py - Settings → Redis client: configures client
backend/database/redis.py - Settings → Metrics: configures metrics
backend/common/observability/prometheus/fastapi.py - JWT security → Request context: sets identity
backend/common/security/jwt.py - Logging → Settings: reads configuration
backend/common/log.py - Logging → Shared utilities: uses timezone utilities
backend/common/log.py