Dokumentace pro vývojáře

Tato sekce obsahuje kompletní technickou dokumentaci pro vývojáře pracující na platformě Turtor. Najdete zde popis architektury, API endpointů, frontend vzorů a databázového schématu.

Sekce

Architektura

Celkový přehled systému, struktura monorepa a rozložení NestJS modulů.

• Přehled architektury -- stack, technologie a základní principy
• Monorepo struktura -- Turborepo, workspace, balíčky a závislosti
• NestJS moduly -- přehled všech backend modulů

API

REST API dokumentace, autentizace, cache a stránkování.

• Endpointy -- přehled controllerů, routes a Swagger dokumentace
• Autentizace -- Magic Link, Google OAuth, JWT tokeny
• Cache -- Redis CacheService, stampede protection, invalidace
• Paginace -- stránkovaná odpověď, DTOs, implementace

Frontend

React aplikace, routing a komponenty.

• Routes -- TanStack Router, file-based routing v admin a web app
• Hooks -- React Query hooky, Orval generování, STALE_TIMES
• Komponenty -- shadcn/ui, Field pattern, TanStack Form

Databáze

PostgreSQL schéma a migrace.

• Entity -- TypeORM entity, BaseEntity, relace
• Migrace -- workflow: úprava entity, generování, review, spuštění