SaaS Admin Docs

SaaS AdminАдмин-панель SaaS платформы

Angular 21 + Angular Material M3 + SSR

Быстрый старт

О проекте

Быстрый старт

Начните работу за 5 минут — установка, настройка окружения и первый запуск

Архитектура

Модульная структура с Core, Admin и Shared секциями. Standalone components и современные паттерны

Стандарты кода

Единые правила написания TypeScript и SCSS. ESLint, Stylelint, Prettier

Инфраструктура

Git hooks, CI/CD, автоматический деплой через Docker и GitHub Actions

Зависимости

Полный список зависимостей с ссылками на документацию каждой библиотеки

Секреты

Управление переменными окружения через Doppler для local/dev/prod

Быстрый старт

bash

git clone git@github.com:Happ-AI/saas-admin.git
cd saas-admin
npm install
npm run generate:env -- local
npm start

Ссылки

Ресурс	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

Структура документации

Раздел	Описание	Когда читать
Быстрый старт	Установка и первый запуск	Один раз при онбординге
Архитектура	Структура проекта	Для понимания кодовой базы
Правила кода	TypeScript стандарты	Перед написанием кода
Стили	SCSS гайдлайны	Перед написанием стилей
Паттерны	Архитектурные паттерны	При проектировании
Зависимости	Все библиотеки с доками	При выборе инструментов
Секреты	Doppler и окружения	При настройке проекта
Деплой	CI/CD и Docker	При деплое
Качество кода	ESLint, Stylelint	При настройке линтеров
Workflow	Git hooks, workflow	Для разработчиков

Tech Stack

Framework: Angular 21 с Server-Side Rendering
UI: Angular Material 21 (Material Design 3)
State Management: @ngneat/elf
Charts: ECharts 6 + ngx-echarts
Code Editor: Monaco Editor
i18n: @jsverse/transloco
WebSocket: Socket.IO
HTTP: Angular HttpClient с перехватчиками
Authentication: JWT с localStorage
Styling: SCSS с design tokens
Secrets: Doppler

Основные возможности

Управление пользователями и компаниями
Управление ассистентами (голосовые и текстовые боты)
Просмотр чатов и истории звонков
Биллинг (тарифы, подписки, счета, платежи, возвраты, купоны, события биллинга)
Мониторинг Temporal workflows (статусы, таймлайн, входные/выходные данные)
Управление интеграциями и телефонами
Broadcasts (email кампании, аудитории, трекинг доставки, открытий, кликов)
Аналитика и дашборды с графиками
Адаптивный дизайн с темной темой