feat: Инициализация базовой структуры проекта Telegram-бота на NestJS, Telegraf и Drizzle ORM.

README.md

@@ -1,2 +1,77 @@
-# t-bot
+# Telegram Bot Template
 
+Шаблон Telegram-бота на NestJS + Telegraf + Drizzle ORM + PostgreSQL.
+
+## Стек
+
+- **NestJS** — фреймворк
+- **Telegraf** — Telegram Bot API
+- **Drizzle ORM** — работа с БД
+- **PostgreSQL** — база данных
+- **Zod** — валидация
+
+## Быстрый старт
+
+### 1. Установка зависимостей
+
+```bash
+pnpm install
+```
+
+### 2. Настройка окружения
+
+Создай `.env` файл:
+
+```env
+ENV=development
+PORT=3000
+
+DATABASE_URL=postgresql://admin:admin@localhost:5432/tg-bot
+DB_PORT=5432
+DB_USERNAME=admin
+DB_PASSWORD=admin
+DB_NAME=tg-bot
+
+TELEGRAM_TOKEN=your_bot_token_here
+```
+
+### 3. Запуск PostgreSQL
+
+```bash
+docker-compose up -d
+```
+
+### 4. Миграция БД
+
+```bash
+pnpm db:push
+```
+
+### 5. Запуск бота
+
+```bash
+pnpm start:dev
+```
+
+## Структура проекта
+
+```
+src/
+├── app/
+│   ├── bot/           # Telegram бот
+│   └── user/          # Модуль пользователей
+├── db/                # База данных (Drizzle)
+├── middleware/        # Middleware
+├── app.module.ts      # Главный модуль
+├── env.validator.ts   # Валидация ENV
+└── main.ts            # Точка входа
+```
+
+## Команды
+
+| Команда | Описание |
+|---------|----------|
+| `pnpm start:dev` | Запуск в dev режиме |
+| `pnpm build` | Сборка проекта |
+| `pnpm db:push` | Применить схему к БД |
+| `pnpm db:generate` | Сгенерировать миграцию |