From 31cfd5d83c499434ff2163bfde31031737155d5c Mon Sep 17 00:00:00 2001
From: Nikolai Papin <nikolai@weirdcat.ru>
Date: Thu, 2 Oct 2025 22:48:06 +0300
Subject: [PATCH] feat: readme

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8dcb788
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+ ## LCT2025 — Эспада (Alabuga)
+
+Команда:
+- **Тимлид:** Дорошко Максим Игоревич  
+- **Бекенд:** Папин Николай Алексеевич, Хлынин Роман Олегович  
+- **Фронтенд:** Шевченко Рудольф Дмитриевич  
+- **Дизайн:** Кривошеева Екатерина Валерьевна
+
+## Архитектура
+Монолитное веб-приложение с REST API. Основные технологии:
+- фронтенд: Next.js
+- бекенд: C# (.NET 9 / ASP.NET 9)
+- база данных: PostgreSQL
+- хранилище объектов: MinIO (S3-совместимое)
+- кеш/очереди: Redis
+
+Развёртывание и оркестрация через docker compose.
+
+## Реализованные механики
+- магазин — покупка предметов
+- инвентарь — хранение купленных/полученных предметов или артефактов
+- система уровней навыков
+- ранги — ранги пользователей влияют на доступность миссий и предметов в магазине
+- пути развития миссий — ветвящиеся миссии/прогресс
+- REST CRUD для основных сущностей (пользователь, миссия, предмет) со стороны API
+- интеграция с MinIO и Redis для хранения и кеширования
+
+## Что не реализовано и почему
+- полная микроcервисная декомпозиция — проект сделан монолитом из-за ограничений времени и объёма работ
+
+## Инструкция по запуску (локально)
+1. Клонировать репозиторий:
+   ```
+   git clone https://github.com/EspadaKomanda/lct2025-monlith
+   cd lct2025-monolith
+   ```
+2. Запустить сервисы через Docker Compose:
+   ```
+   docker compose up
+   ```
+3. Открыть сайт в браузере:
+   - http://localhost:3000
+
+## Ссылки
+- Репозиторий: https://github.com/EspadaKomanda/lct2025-monlith