Files
simple-storage/CLAUDE.md
2026-02-08 20:12:04 +03:00

2.0 KiB

Simple Storage

Учебный backend-проект для обучения студентов основам NestJS.

Назначение

Простой REST API сервис для хранения данных. Используется как демонстрационный проект в рамках обучения backend-разработке.

Стек

  • Framework: NestJS 11
  • Language: TypeScript
  • Runtime: Node.js
  • Database: PostgreSQL (shared-db) + TypeORM
  • CI/CD: Drone CI + ci-templates

Структура

src/
├── main.ts              # Точка входа
├── app.module.ts        # Корневой модуль (ConfigModule + TypeORM)
├── app.controller.ts    # REST контроллер
├── app.service.ts       # Бизнес-логика (TypeORM Repository)
├── entities/
│   ├── user.entity.ts   # Entity: users
│   └── storage.entity.ts # Entity: storages
├── health/
│   ├── health.module.ts    # Health check модуль
│   └── health.controller.ts # GET /health
├── schemas.ts           # Swagger DTO
├── types.ts             # TypeScript типы
├── consts.ts            # Константы
└── api.responses.ts     # Форматы ответов API

Команды

npm install          # Установка зависимостей
npm run start:dev    # Запуск в dev режиме
npm run build        # Сборка
npm run start:prod   # Production запуск

Деплой

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

Переменные окружения в .env.local:

  • DATABASE_HOST — хост PostgreSQL (localhost для dev через NodePort :30432)
  • DATABASE_PORT, DATABASE_USER, DATABASE_PASSWORD, DATABASE_NAME