python-backend
Python Backend
Production Python backend services with FastAPI, SQLModel, async PostgreSQL, and GCP Cloud Run deployment.
Core Architecture
The non-negotiable pattern is the layered flow. Each layer only calls the layer directly below it — never skip layers.
Router → Service → Repository → Database
| Layer | Responsibility | Constraint |
|---|---|---|
| Router | HTTP in/out, request validation, response mapping | No business logic, no direct DB access |
| Service | Business logic, orchestration | No SQLModel queries, no AsyncSession, no HTTP concerns |
| Repository | Data access, query building, ORM operations | No business logic, no HTTP-aware errors |
Supporting constructs (not layers):
More from idjoo/skills
commit
Smart atomic commits with Conventional Commits and emoji. Use when committing changes, creating git commits, or when the user says 'commit'. Analyzes workspace changes, splits into logical atomic units, and commits with emoji conventional format (type(scope): emoji description).
10whatsapp
Send and manage WhatsApp messages via WAHA HTTP API. Use when the user wants to send WhatsApp messages (text, image, video, voice, file), read chats/messages, manage contacts, groups, or sessions. Triggers on: 'send a WhatsApp message', 'check my WhatsApp chats', 'send image on WhatsApp', 'WhatsApp group', 'WhatsApp session', or any WhatsApp-related task.
2beads
Local-first issue tracker using br (beads_rust). Use when the user wants to track issues, create tasks, manage dependencies between issues, or check what's ready to work on. Triggers on: 'create an issue', 'track a bug', 'what should I work on next', 'show blocked issues', 'add a dependency', 'beads', 'br', or any project issue-tracking task.
1waha
Send and manage WhatsApp messages via WAHA HTTP API. Use when the user wants to send WhatsApp messages (text, image, video, voice, file), read chats/messages, manage contacts, groups, or sessions. Triggers on: 'send a WhatsApp message', 'check my WhatsApp chats', 'send image on WhatsApp', 'WhatsApp group', 'WhatsApp session', 'WAHA', or any WhatsApp-related task.
1