Backend Layer

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: JNZader
• Source: JNZader/repoforge
• License: MIT
• Homepage: https://repoforge.javierzader.com

Install and usage instructions live in the source repository linked above.