project logoREADME.md

Backend

This directory contains all server-side code organized by functionality:

  • /routes - HTTP route handlers organized by functionality
  • /api - JSON API endpoints for frontend/backend communication
  • /tasks - Webhook handlers for Notion integrations (PDF extraction, page duplication)
  • /views - Server-side rendered views for frontend
  • /emails - Email trigger handlers for processing incoming emails
  • /services - External API integrations (pure API calls only)
  • /controllers - Business logic coordination between routes and services
  • /crons - Scheduled task handlers
  • /types - Shared TypeScript type definitions
  • /utils - Common utility functions

Architecture

  • Services: Pure API calls to external systems
  • Controllers: Business logic and orchestration
  • Routes: HTTP request/response handling only