Files
docs/docs/50-developing/01-quick-start.md
T
2026-06-16 15:13:13 +03:00

3.3 KiB

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

Репозиторий

Настраиваем ssh ключи в gitea, клонируем репозиторий и ставим зависимости. В проекте используется пакетный менеджер yarn

git clone ssh://git@git.jt4d.ru:2222/1vit/more.git
cd more
yarn

Установка может занять несколько минут.

Настройка БД

Рекомендуется устанавливать всё через docker чтобы избежать проблем с зависимостями и сделать окружение более повторяемым.

Клонируем репозиторий с docker-compose и выполняем docker compose up. Если команда не найдена, ставим compose пакетом или из исходников.

Потом создаём в корне проекта (основного репозитория) файл .env (пример в .env.example). Он используется для подключения к основной БД.

DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=1vit_more
DB_PASSWORD=password
DB_DATABASE=1vit_more

Ещё рекомендуется создать .env.test (пример в .env.test.example), он будет использоваться для тестов с использованием БД. Если файл не найден, будет перезаписываться основная база.

Проверяем подключение yarn db:show и накатываем миграции (создание структуры данных, schema) yarn db:migrate.

Далее нужно заполнить БД демо-данными при помощи команды yarn test-data:db-restore.

Запуск

тип сервера команда
Полный dev сервер с БД yarn start
Сторибук (для тестирования отдельных компонентов) yarn storybook
Jest (unit-тесты) yarn test:unit или yarn test:unit path/to/file
Jest (db-тесты) yarn test:db, см. доку про дб тесты

CI

При каждом git push запускается сборка приложения на Gitea Actions.

Стенд для ветки доступен по адресу http://<branch-name>.<STAGING_HOST>.

Подробнее о системе деплоя, тегах и продакшн-деплое — в разделе «Поставка».