Manual Técnico

Este manual descreve a arquitetura, o processo de deploy e a manutenção do ecossistema Cultura Fácil.

Arquitetura de Sistema

O sistema utiliza uma arquitetura de microserviços (monorepo) focada em escalabilidade e facilidade de manutenção:

• Backend: NestJS (Node.js) com PostgreSQL/PostGIS.
• Frontend: React com Tailwind CSS.
• Workers: BullMQ (Redis) para processamento em background (e-mails, geocoding).
• BI: Metabase integrado para relatórios em tempo real.

Processo de Deploy

O deploy é automatizado via Docker Compose.

Pré-requisitos

• Docker & Docker Compose v2+
• Node.js 20+ (para desenvolvimento local)

Comandos Rápidos

Utilize o script de deploy na raiz:

./deploy-prod.sh

Este script realiza o git pull, reconstrói as imagens necessárias e limpa caches antigos.