Production platform case study
Role Junino
Mobile-first digital guide for Paraiba Junino festivals, launched in June 2026. Built as a full-stack production platform with SSR web, domain API, Redis cache/queues, and AI-assisted delivery orchestration.
- Problem
- Festival information was fragmented across social networks, city channels, and private groups during high-demand tourism periods.
- Role
- Founder & Tech Lead: architecture, execution orchestration, quality gates, and production operation.
- Stack
- Next.js 16, React 19, Express, PostgreSQL/Prisma, Redis, BullMQ, Zod, Docker, Coolify, k6.
Architecture
- pnpm monorepo with
apps/web,apps/api, andpackages/sharedfor type-safe contracts. - Public read-heavy APIs separated from admin APIs with JWT + RBAC authorization.
- Graceful degradation strategy: app keeps running without Redis by falling back to in-memory behavior.
- Shared Zod schemas for runtime validation and frontend form/type consistency.
Engineering Highlights
- Google Places integration with async imports, dry-run controls, cost kill-switches, and claim flow conversion.
- Cache middleware + targeted invalidation by domain with
X-Cache: HIT|MISSobservability. - BullMQ workers for heavy async jobs (places import and geocoding) decoupled from request/response.
- Scalability improvements validated with k6 test suite: from ~300-400 to ~2-3K concurrent users.