backend-dev-guidelines

Layered architecture separates your backend into Routes, Controllers, Services, and Repositories. This structure improves testability and maintainability by isolating concerns: Routes handle HTTP requests, Controllers orchestrate logic, Services contain business rules, and Repositories manage data access through Prisma.

Use Zod for runtime input validation in Node.js/Express APIs. Zod provides schema-based validation that catches invalid data before it reaches your services, ensuring data integrity and preventing bugs from malformed requests.

Integrate Sentry into your Node.js/Express services to capture and monitor all errors automatically. Sentry tracks exceptions across your microservices, enabling proactive issue resolution and visibility into system reliability.

Yes. Prisma works seamlessly with TypeScript microservices and provides type-safe database queries. Pair Prisma with a Repository layer to standardize data access patterns and improve code reusability across services.

A new feature requires a clean route, a Controller extending BaseController, business logic in a Service, and Zod validation for inputs. This pattern ensures consistency across your microservices and includes integrated error tracking via Sentry.

Dependency injection decouples services and repositories, making code testable and flexible. It allows you to swap implementations—such as swapping a real database for a mock during testing—without changing your core business logic.