Backend Overview
The backend is a NestJS API serving the web frontend and mobile app. It handles authentication, multi-tenant data access, real-time communication, and asynchronous processing pipelines for audio transcription, document analysis, and AI-powered data extraction.
High-Level Architecture
Module Map
The backend is organized into domain modules, each owning its controller, service, DTOs, and Mongoose schemas.
| Module | Purpose | Key Collections |
|---|---|---|
| Drafts | Notes — the central intake for user content | drafts |
| Conversations | Chat threads + messages | conversations, messages |
| Parse | Structured records extracted by AI | parseresults |
| Fields | Agricultural field boundaries (geo polygons) | fields |
| Attachments | Images, PDFs, documents (S3) | attachments |
| Call Logs | Audio recordings + transcription metadata | calllogs |
| Users | User profiles + company memberships | users |
| Companies | Multi-tenant organizations | companies |
| Workspaces | Workspace schemas for structured data | workspaces |
| Transcription | Speech-to-text provider orchestration | — |
| Process | AI parsing pipeline (preprocessing, intent, extraction) | — |
| Queue | BullMQ job processors | — |
| Realtime | Socket.IO WebSocket gateway | — |
| Firebase | Firebase Auth integration | — |
Request Lifecycle
Every HTTP request passes through a layered guard system before reaching business logic:
Key Decorators
| Decorator | Purpose |
|---|---|
@Public() | Skip all auth guards |
@CompanyRequired() | Enforce company membership |
@CompanyRoles([...]) | Require specific roles (admin, manager, worker) |
@CurrentUserProfile() | Inject the resolved UserDocumentPopulated |
Multi-Tenancy
Every domain entity extends CompanyAwareBase and is automatically scoped to the user's companies. See Multi-Tenancy Architecture for the full model.
Related Pages
- Drafts (Notes) — the central data intake module
- Module Relationships — how modules connect
- Queues & Processing — async pipelines
- Main chat weather (Open-Meteo) & search result IDs —
get_weather, field ID resolution, semantic searchidfix