From 2cc7f8646811601ac29872af4c4dceaf06506aea Mon Sep 17 00:00:00 2001
From: Maxim <darlinggbm@gmail.com>
Date: Fri, 10 Apr 2026 22:41:36 +0300
Subject: [PATCH 1/3] docs: add README with stack and quick start guide

---
 README.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 65 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 6d83c08..b821479 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,65 @@
-# task-tracker-backend
-Task-tracker-backend
+# Task Tracker Backend 🚀
+
+Современная лёгкая open-source система управления IT-проектами (альтернатива Jira/Yandex Tracker). Бэкенд построен на высокопроизводительном стеке с упором на типизацию и скорость разработки.
+
+**Статус:** `In Development`
+
+## 🛠 Технологический стек
+
+- **Runtime:** Node.js 22+ (pnpm)
+- **Framework:** NestJS 11 (**Fastify**)
+- **Database:** PostgreSQL + **Drizzle ORM**
+- **Validation:** Zod
+- **API:** Swagger (OpenAPI)
+- **Infrastructure:** Docker (Multi-stage builds)
+- **Testing:** Vitest
+
+## ⚡ Quick Start
+
+### 1. Окружение
+
+Скопируйте пример файла окружения и настройте переменные (БД, API ключи DeepSeek):
+
+```bash
+cp .env.example .env
+```
+
+### 2. Запуск через Docker (Рекомендуется)
+
+Проект полностью контейнеризирован:
+
+```bash
+docker-compose up --build
+```
+
+### 3. Локальный запуск
+
+Если вы хотите запустить проект без Docker:
+
+```bash
+pnpm install
+pnpm db:generate
+pnpm db:migrate
+pnpm start:dev
+```
+
+## 📖 API Documentation
+
+После запуска проекта документация доступна по адресу:
+
+**http://localhost:3000/api/v1/docs**
+
+> Note:
+> Мы используем drizzle-zod для автоматической генерации схем. Это гарантирует, что документация в Swagger всегда на 100% соответствует реальной валидации запросов.
+
+## 📂 Структура проекта
+
+- src/ — основная бизнес-логика.
+- libs/bootstrap — логика инициализации и настройки приложения.
+- src/shared/entities — описание схем данных Drizzle.
+- test/ — E2E и интеграционные тесты на Vitest.
+
+## 🚀 Infrastructure
+
+- CI/CD: Настроены GitHub Actions для автоматической проверки типов, линтинга и запуска тестов.
+- Docker: Используются оптимизированные multi-stage образы для минимизации размера production-билда.

From d3b76ad530ea8100bdc3099375c59231f1e841c6 Mon Sep 17 00:00:00 2001
From: Maxim <darlinggbm@gmail.com>
Date: Fri, 10 Apr 2026 22:49:47 +0300
Subject: [PATCH 2/3] docs: add contributing guidelines with development
 standards

---
 CONTRIBUTING.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..8272506
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,59 @@
+# Contributing Guidelines 🤝
+
+Добро пожаловать в проект! Чтобы поддерживать высокое качество кода и чистоту истории коммитов, мы следуем строгим стандартам разработки.
+
+## 1. Workflow (Работа с ветками)
+
+Мы используем **Trunk-based** подход. Это означает, что `main` (trunk) — единственный источник истины.
+
+- **Запрет на прямые пуши:** Пуш напрямую в `main` (или `master/dev`) строго запрещен. Любые изменения вносятся **только через Pull Request (PR)**.
+- **Code Review:** Каждый PR должен пройти обязательное код-ревью перед мерджем.
+- **Short-lived branches:** Ветки должны быть короткими (1-2 дня).
+
+**Правила именования веток:**
+
+- `feat/` — для новых функциональных возможностей.
+- `fix/` — для исправления багов.
+- `refactor/` — для переписывания кода без изменения логики.
+- `docs/` — для обновления документации.
+
+## 2. Commit Message Convention
+
+Мы используем стандарт **Conventional Commits**. Это позволяет автоматически генерировать логи изменений и поддерживать историю в чистоте.
+
+**Формат:** `<type>(<scope>): <description>`
+
+- **Пример:** `feat(database): add user entity and drizzle migrations`
+- **Пример:** `fix(auth): resolve jwt expiration issue`
+
+## 3. Разработка и стандарты кода
+
+- **Validation (Zod):** Использование схем **Zod** для эндпоинтов (DTO) обязательно. Без них не будет работать валидация данных и автоматическая типизация в Swagger.
+- **Linting & Formatting:** Перед каждым коммитом обязательно запускайте `pnpm lint` и `pnpm format`. Код, не прошедший проверку линтером, не будет принят.
+- **Drizzle Migrations:** **Никаких ручных изменений в базе данных.** Все изменения схем должны сопровождаться миграциями.
+    - Команда: `pnpm db:generate`
+- **No God-commits:** Разделяйте свои изменения на небольшие логические коммиты.
+
+## 4. Pull Request (PR) Process
+
+Прежде чем отправить PR, убедитесь, что:
+
+1. **Self-Review:** Вы сами перечитали свой код и удалили отладочные логи (`console.log`).
+2. **Checks:** Все автоматические тесты (`pnpm test`) и линтер проходят успешно.
+3. **Description:** В описании PR четко указано, что именно было сделано и зачем.
+
+_PR не принимается, если тесты или линтер упали на этапе CI._
+
+## 5. Local Setup
+
+Для быстрой настройки локального окружения обратитесь к разделу **Quick Start** в [README.md](./README.md).
+
+Краткий список команд для старта:
+
+```bash
+pnpm install
+cp .env.example .env
+pnpm db:generate
+pnpm db:migrate
+pnpm start:dev
+```

From 82d78a23ea495be874d9554b1fdf3e67160a5090 Mon Sep 17 00:00:00 2001
From: Maxim <darlinggbm@gmail.com>
Date: Fri, 10 Apr 2026 22:56:13 +0300
Subject: [PATCH 3/3] chore: bump per reviewer requests

---
 README.md | 18 ++++--------------
 1 file changed, 4 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index b821479..cd789c0 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 **Статус:** `In Development`
 
-## 🛠 Технологический стек
+## Технологический стек
 
 - **Runtime:** Node.js 22+ (pnpm)
 - **Framework:** NestJS 11 (**Fastify**)
@@ -14,7 +14,7 @@
 - **Infrastructure:** Docker (Multi-stage builds)
 - **Testing:** Vitest
 
-## ⚡ Quick Start
+## Quick Start
 
 ### 1. Окружение
 
@@ -43,23 +43,13 @@ pnpm db:migrate
 pnpm start:dev
 ```
 
-## 📖 API Documentation
+## API Documentation
 
 После запуска проекта документация доступна по адресу:
 
 **http://localhost:3000/api/v1/docs**
 
-> Note:
-> Мы используем drizzle-zod для автоматической генерации схем. Это гарантирует, что документация в Swagger всегда на 100% соответствует реальной валидации запросов.
-
-## 📂 Структура проекта
-
-- src/ — основная бизнес-логика.
-- libs/bootstrap — логика инициализации и настройки приложения.
-- src/shared/entities — описание схем данных Drizzle.
-- test/ — E2E и интеграционные тесты на Vitest.
-
-## 🚀 Infrastructure
+## Infrastructure
 
 - CI/CD: Настроены GitHub Actions для автоматической проверки типов, линтинга и запуска тестов.
 - Docker: Используются оптимизированные multi-stage образы для минимизации размера production-билда.