Happ Developer Documentation
Internal developer documentation for the Happ Platform platform
Welcome
This is the internal developer documentation for the Happ Platform platform — a multi-channel AI assistant system for businesses. It covers architecture, project structure, development workflows, and operational guides for the engineering team.
Platform Overview
Happ enables businesses to deploy AI-powered assistants across messaging channels (Telegram, Instagram, WhatsApp, Facebook Messenger, Viber) and voice calls, managed from a single dashboard.
Access
All internal services and documentation are protected by Cloudflare Zero Trust. To access any *.happ.tools service (dashboards, APIs, docs), you must authenticate through the Cloudflare Access portal. Access policies are managed in the Cloudflare Zero Trust dashboard.
System Components
| Project | Role | Tech Stack | Docs |
|---|---|---|---|
| platform-api | Backend API | NestJS 11 + TypeORM + PostgreSQL 16 | api.docs.happ.tools |
| platform-admin | Admin dashboard | Angular 21 + Material M3 + SSR | admin.docs.happ.tools |
| platform-client | Customer web app | Angular 21 + SSR | client.docs.happ.tools |
| platform-mobile | Mobile app | Expo SDK 54 + React Native 0.81 | mobile.docs.happ.tools |
| platform-telegram-client | Telegram bot | NestJS 11 + Telegraf | telegram.docs.happ.tools |
| platform-deploy | Infrastructure | Docker Compose + Traefik | deploy.docs.happ.tools |
| platform-monitoring | Observability | Prometheus + Grafana + Loki + Tempo | monitoring.docs.happ.tools |
| platform-e2e | E2E tests | Playwright | e2e.docs.happ.tools |
| platform-docs | Documentation | Next.js 15 + Fumadocs | — |
Each project is a separate Git repository under the Happ-AI GitHub organization.