JNZader backend-layer
This skill covers the backend functionality of the RepoForge application.
Trigger: When working in backend/ directory and its main responsibility is to manage server-side logic.
Quick Reference
| Task | Pattern |
|---|---|
| Configure logging | configure_logging() |
| Run migrations | run_migrations_online() |
Critical Patterns (Summary)
- Middleware Configuration: Set up custom middleware for request handling.
- Database Migration: Manage database schema changes using Alembic.
Critical Patterns (Detailed)
Middleware Configuration
Set up custom middleware for handling requests, such as logging and authentication.
# apps/server/app/main.py
app.add_middleware(correlation_id_middleware)
app.add_middleware(request_logging_middleware)
app.add_middleware(security_headers_middleware)
Database Migration
Manage database schema changes using Alembic for version control.
# apps/server/alembic/env.py
run_migrations_online()
When to Use
- When implementing new API endpoints that require authentication.
- When modifying database schemas and needing to run migrations.
Commands
# To run the server
uvicorn apps.server.app.main:app --reload
# To run migrations
alembic upgrade head
Anti-Patterns
Don't: Change API response formats without updating the frontend
This can lead to broken integrations and user-facing errors.
# BAD
return {"message": "success"} # Frontend expects a different structure