О проекте

SaaS Admin — это админ-панель для управления платформой AI-ассистентов (Telegram, голосовые, веб-виджеты). Приложение построено на Angular 21 с использованием Server-Side Rendering и Angular Material.

Что это такое?

SaaS Admin предоставляет удобный веб-интерфейс для:

• Управления пользователями — список, детали, привязанные компании и workflows
• Управления компаниями — участники, ассистенты, телефоны, интеграции
• Управления ассистентами — голосовые и текстовые ассистенты, knowledge base, tools
• Чатов — история сообщений между пользователями и ассистентами
• Биллинга — тарифы, подписки, счета, платежи, возвраты, купоны, события
• Workflows — мониторинг Temporal workflows
• Интеграций — управление внешними интеграциями
• Телефонов — управление SIP номерами
• Аналитики — дашборды, графики, статистика

Ссылки

Ресурс	URL
Основная документация	docs.happ.tools
Admin Panel (Prod)	admin.happ.tools
Admin Panel (Dev)	admin.dev.happ.tools
Client App	client.saas.happ.tools
API (Prod)	api.happ.tools/api
API (Dev)	api.dev.happ.tools/api

Технологический стек

Frontend

• Angular 21 — современный фреймворк с standalone components
• Angular Material 21 — UI компоненты с Material Design 3
• Angular SSR — Server-Side Rendering
• TypeScript 5.8+ — строгая типизация

State Management

• @ngneat/elf — легковесное state management решение
• @ngneat/elf-devtools — инструменты разработчика
• @ngneat/elf-persist-state — персистентность состояния

Charts & Editors

• ECharts 6 + ngx-echarts — графики и диаграммы
• Monaco Editor + ngx-monaco-editor-v2 — редактор кода

Утилиты

• RxJS 7.8 — реактивное программирование
• date-fns — работа с датами
• Socket.IO — WebSocket коммуникация
• @jsverse/transloco — интернационализация
• jwt-decode — декодирование JWT токенов

Архитектура

Приложение построено по модульной архитектуре с четким разделением на:

• Core — ядро приложения (сервисы, guards, interceptors)
• Admin — админская секция (layout, страницы)
• Shared — переиспользуемые компоненты

src/app/
├── core/           # Ядро приложения
├── admin/          # Админ секция
└── shared/         # Shared компоненты

Философия проекта

Проект следует принципам:

• Минимализм — код должен быть максимально лаконичным
• Типобезопасность — вся кодовая база строго типизирована
• Модульность — каждая сущность в своем модуле
• Standalone Components — современный подход Angular без NgModules

Следующие шаги

• Быстрый старт — начните работу с проектом
• Секреты и Doppler — настройка переменных окружения
• Архитектура — узнайте больше об архитектуре
• Правила стилей — гайдлайны по написанию SCSS
• Правила кода — code style и best practices