Локальная установка

Требования

• Node.js 24;
• pnpm через Corepack;
• PostgreSQL, предоставленный DevOps;
• отдельная development schema;
• доступ к репозиторию ReactiveEngineering/re-it-asset-management.

Установка

corepack enable
pnpm install --frozen-lockfile
cp .env.example .env.local

Минимальная конфигурация:

NEXT_PUBLIC_APP_NAME="ITAM"
DATABASE_URL="postgresql://user:password@localhost:5432/database?schema=itam"
DATABASE_SCHEMA="itam"
BETTER_AUTH_SECRET="replace-with-at-least-32-random-characters"
BETTER_AUTH_URL="http://localhost:3000"
AUTH_ADMIN_NAME="Admin User"
AUTH_ADMIN_EMAIL="admin@example.com"
AUTH_ADMIN_PASSWORD="change-me-before-first-login"
CRON_SECRET="long-random-cron-secret"

MIGRATION_DATABASE_URL необязателен. Используйте его, если DDL выполняется отдельной учётной записью, а runtime user имеет только DML-права.

База данных

pnpm db:deploy
pnpm db:seed

db:deploy создаёт только заданную schema, если она отсутствует, и применяет закоммиченные Prisma migrations. Seed идемпотентно создаёт permissions, системные роли, справочники, классы/типы активов, lifecycles, relation types и Owner.

Запуск и проверка

pnpm dev

Откройте http://localhost:3000. Перед завершением изменения выполните:

pnpm check
git diff --check
git status --short

pnpm check включает Prisma validation, email contracts, TypeScript, ESLint и production build.

SMTP

Без SMTP development пропускает отправку писем и пишет безопасный статус в лог. В production SMTP обязателен для создания пользователей и восстановления пароля.

pnpm email:test -- recipient@example.com