Файл .env

Создай файл с переменными окружения для порта, режима запуска, хоста, строки подключения к PostgreSQL и секрета для JWT.

PORT=3000
NODE_ENV=development
HOST=0.0.0.0
DATABASE_URL=postgres://postgres:postgres@localhost:5432/eventsdb
JWT_SECRET=super-secret

Конфиг окружения config/env.ts

Создай модуль, который загружает .env, преобразует числовые значения и собирает все переменные окружения в один объект env.

import { config } from 'dotenv';

config();

const toNumber = (value: string | undefined, fallback: number

Что делает toNumber

Функция toNumber нужна для безопасного преобразования строки из переменной окружения в число с fallback значением по умолчанию.

const toNumber = (value: string | undefined, fallback: number): number => {
  if (

Что делает validateEnv

Функция validateEnv проверяет, что обязательные переменные окружения заданы, и останавливает приложение с ошибкой, если их нет.

export const validateEnv = () => {
  if (!env.databaseUrl) {
    throw new

Источник данных src/db/data-source.ts

Создай конфиг TypeORM DataSource, который подключается к PostgreSQL, использует сущности приложения и автоматически запускает миграции при старте.

import 'reflect-metadata';
import { DataSource } from 'typeorm';
import { env }

Что означает DataSource конфиг

Этот объект описывает подключение к базе и правила работы ORM.

• type: 'postgres' — используется PostgreSQL
• url: env.databaseUrl — строка подключения берется из .env
• synchronize: false — автоизменение схемы базы отключено
• logging: false — SQL логи отключены
• migrationsRun: true — миграции применяются автоматически при старте
• entities — список сущностей, с которыми работает TypeORM
• migrations — путь к файлам миграций

Почему synchronize: false

Автосинхронизация схемы базы отключается, чтобы структура базы менялась только через миграции, а не неявно при запуске приложения.

synchronize: false

Почему migrationsRun: true

Эта опция нужна, чтобы при запуске приложения TypeORM сам применял все неприменённые миграции.

migrationsRun: true