╔═══════════════════════════════════════════════════════════════════════╗
║                        NakamaSpace v1.0.0                              ║
║                   Telegram Mini App Social Network                     ║
╚═══════════════════════════════════════════════════════════════════════╝

📋 ОПИСАНИЕ
───────────────────────────────────────────────────────────────────────
Полноценная мини-социальная сеть внутри Telegram с 4 вкладками:
🏠 Лента - создание постов, лайки, комментарии, репосты
🔍 Поиск - интеграция e621 и gelbooru API
🔔 Уведомления - Telegram-стиль баблов
👤 Профиль - настройки, статистика, донаты

🎨 ДИЗАЙН
───────────────────────────────────────────────────────────────────────
• Стиль: iOS минимализм 2025
• Цвета: Нейтральная серая палитра
• Теги: Furry (оранжевый), Anime (синий), Other (серый)
• Шрифт: SF Pro Display / Roboto
• Радиус: 16px карточки, 12px кнопки
• Анимации: 0.2-0.3s плавные

🔧 ТЕХНОЛОГИИ
───────────────────────────────────────────────────────────────────────
Frontend:
• React 18 + Vite
• React Router
• Telegram Mini App SDK
• Axios
• Lucide React (иконки)

Backend:
• Node.js + Express
• MongoDB + Mongoose
• Multer (загрузка файлов)
• Crypto (Telegram Init Data)

Интеграции:
• Telegram Bot API
• e621 API
• gelbooru API

📂 СТРУКТУРА
───────────────────────────────────────────────────────────────────────
nakama/
├── backend/              Backend сервер
│   ├── models/           MongoDB схемы
│   ├── routes/           API endpoints
│   ├── middleware/       Auth middleware
│   └── server.js         Точка входа
├── frontend/             Frontend приложение
│   └── src/
│       ├── components/   React компоненты
│       ├── pages/        Страницы-вкладки
│       ├── utils/        API + Telegram SDK
│       └── styles/       CSS стили
├── README.md             Основная документация
├── SETUP.md              Инструкция по установке
├── QUICKSTART.md         Быстрый старт
├── PROJECT_STRUCTURE.md  Детальная карта
├── CONTRIBUTING.md       Гайд для разработчиков
└── start.sh              Скрипт запуска

⚙️ ВОЗМОЖНОСТИ
───────────────────────────────────────────────────────────────────────
✅ Создание постов с изображениями (до 10MB)
✅ Обязательные теги (Furry, Anime, Other)
✅ Лайки, комментарии, репосты
✅ Упоминания пользователей (@username)
✅ NSFW маркировка
✅ Фильтрация по тегам
✅ Поиск в e621 и gelbooru с автокомплитом
✅ Просмотрщик изображений с swipe
✅ Система уведомлений
✅ Профили и подписки
✅ Модерация и жалобы
✅ Настройки фильтров контента
✅ Роли (User, Moderator, Admin)

🚀 ЗАПУСК
───────────────────────────────────────────────────────────────────────
Быстрый запуск (5 минут):
  ./start.sh

Ручная установка:
  1. npm install
  2. cd frontend && npm install
  3. Настроить .env файлы
  4. Запустить MongoDB
  5. npm run dev

Скрипты:
  npm run dev      - Запуск dev режима (backend + frontend)
  npm run server   - Только backend
  npm run client   - Только frontend
  npm run build    - Сборка для production
  npm start        - Production запуск

🔐 БЕЗОПАСНОСТЬ
───────────────────────────────────────────────────────────────────────
✅ Telegram Init Data валидация (HMAC-SHA256)
✅ Безопасная загрузка файлов
✅ Система ролей и прав
✅ XSS защита через React
✅ CORS настройки
✅ HTTPS only для production

🌐 ДЕПЛОЙ
───────────────────────────────────────────────────────────────────────
Рекомендуемые платформы:
• Backend: Railway, Render, Heroku
• Frontend: Vercel, Netlify
• MongoDB: MongoDB Atlas (бесплатный tier)

🛣️ ROADMAP
───────────────────────────────────────────────────────────────────────
Реализовано:
☑ Backend API
☑ Frontend приложение
☑ Telegram авторизация
☑ Система постов
☑ Поиск (e621 + gelbooru)
☑ Уведомления
☑ Профили и подписки
☑ Модерация
☑ iOS-стиль дизайн

В планах:
☐ Тесты (Unit, E2E)
☐ Rate limiting
☐ WebSocket уведомления
☐ Telegram Stars (донаты)
☐ Поиск по постам
☐ Хэштеги
☐ Приватные сообщения
☐ Группы/сообщества
☐ Рекомендации
☐ Dark mode
☐ Мультиязычность

📚 ДОКУМЕНТАЦИЯ
───────────────────────────────────────────────────────────────────────
README.md              Основная документация
QUICKSTART.md          Быстрый старт за 5 минут
SETUP.md               Подробная установка и деплой
PROJECT_STRUCTURE.md   Детальная структура проекта
CONTRIBUTING.md        Гайд для разработчиков

📄 ЛИЦЕНЗИЯ
───────────────────────────────────────────────────────────────────────
MIT License

👥 АВТОРЫ
───────────────────────────────────────────────────────────────────────
Создано с ❤️ для сообщества

📞 ПОДДЕРЖКА
───────────────────────────────────────────────────────────────────────
Issues: GitHub Issues
Документация: SETUP.md
Troubleshooting: SETUP.md#troubleshooting

🌟 БЛАГОДАРНОСТИ
───────────────────────────────────────────────────────────────────────
• Telegram за платформу Mini Apps
• e621 за API
• gelbooru за API
• Сообществу за поддержку

╔═══════════════════════════════════════════════════════════════════════╗
║                    Сделано с 🦊 и 🎌                                   ║
╚═══════════════════════════════════════════════════════════════════════╝