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

Эта страница поможет вам быстро начать работу с Integ Admin.

Требования

Перед началом работы убедитесь, что у вас установлены:

Node.js 20 или выше
npm 10 или выше
Angular CLI 20 или выше

bash

# Проверить версии
node --version  # должен быть >= 20
npm --version   # должен быть >= 10
ng version      # должен быть >= 20

Установка

1. Клонирование репозитория

bash

git clone <repository-url>
cd integ-admin

2. Установка зависимостей

bash

npm install

3. Генерация переменных окружения

Проект использует генерацию environment файлов через Doppler или локальные настройки.

Для локальной разработки создайте .env.local файл:

bash

# .env.local
API_URL=http://localhost:3000/api
WEBHOOK_BASE_URL=http://localhost:3001

Сгенерируйте environment файлы:

bash

npm run generate:env -- local

Важно

Этот шаг обязателен перед первым запуском проекта. Без генерации environment файлов приложение не запустится.

Подробнее о секретах

См. Секреты и Doppler для полного списка переменных, примеров значений для local/dev/prod и инструкций по настройке Doppler.

4. Загрузка типов с бэкенда (опционально)

Если бэкенд запущен, можно загрузить актуальные типы:

bash

npm run generate:types

TIP

Этот шаг опциональный. Типы уже есть в репозитории, но если бэкенд обновился — запустите эту команду для синхронизации.

5. Запуск dev сервера

bash

npm start

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

Быстрый старт (все команды)

bash

git clone <repository-url>
cd integ-admin
npm install
npm run generate:env -- local
npm run generate:types      # опционально, если бэкенд запущен
npm start

Основные команды

Разработка

bash

npm start           # Запуск dev сервера
npm run start:dev   # Запуск на порту 4200
npm run build:watch # Сборка с watch mode

Production сборка

bash

npm run build       # Обычная сборка
npm run build:prod  # Production сборка с SSR

Проверка кода

bash

npm run lint:check    # Проверка ESLint
npm run lint:fix      # Автоисправление ESLint

npm run slint:check   # Проверка Stylelint
npm run slint:fix     # Автоисправление Stylelint

npm run format:check  # Проверка Prettier
npm run format:fix    # Форматирование Prettier

npm run typecheck     # Проверка TypeScript

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

bash

npm test            # Запуск тестов

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

integ-admin/
├── src/
│   ├── app/
│   │   ├── core/              # Ядро приложения
│   │   │   ├── guards/        # Auth guards
│   │   │   ├── interceptors/  # HTTP interceptors
│   │   │   ├── interfaces/    # TypeScript интерфейсы
│   │   │   ├── services/      # Core сервисы
│   │   │   └── routes/        # Определение роутов
│   │   ├── admin/             # Админ секция
│   │   │   ├── layout/        # Layout компонент
│   │   │   └── pages/         # Страницы (features)
│   │   ├── shared/            # Shared компоненты
│   │   │   └── components/    # Переиспользуемые компоненты
│   │   └── app.component.ts   # Root компонент
│   ├── environments/          # Конфигурации окружений
│   ├── styles.scss            # Глобальные стили
│   ├── main.ts                # Browser entry point
│   ├── main.server.ts         # Server entry point
│   └── server.ts              # Express SSR server
├── docs/                      # Документация (VitePress)
├── scripts/                   # Утилитарные скрипты
├── angular.json               # Angular конфигурация
├── tsconfig.json              # TypeScript конфигурация
└── package.json               # NPM dependencies

Первые шаги

1. Запустите приложение

bash

npm start

2. Откройте браузер

Перейдите на http://localhost:4200

3. Зарегистрируйтесь

Создайте новый аккаунт через страницу регистрации

4. Войдите в систему

Используйте созданные credentials для входа

Настройка API

По умолчанию приложение подключается к API по адресу http://localhost:3000/api.

Чтобы изменить адрес API, обновите файл environments/environment.ts:

typescript

export const environment = {
	production: false,
	apiUrl: "http://your-api-url/api"
};

Или используйте переменные окружения через Doppler.

Git Hooks

Проект использует Husky для автоматической проверки кода перед коммитом:

bash

npm run husky:install   # Установка hooks

При коммите автоматически выполняется:

ESLint проверка и автоисправление
Prettier форматирование
Stylelint проверка SCSS
Удаление комментариев
Удаление return types

Что дальше?

Секреты и Doppler — настройка переменных окружения для local/dev/prod
Архитектура — изучите архитектуру приложения
API Reference — ознакомьтесь с доступными сервисами
Функции — узнайте о функциональности
Правила кода — изучите правила написания кода