Документация проекта YARU

Yet Another Russian Uncompleted... — федеративная социальная сеть на базе ActivityPub

---

📁 Разделы документации

Раздел	Описание	Статус
Backend	FastAPI, PostgreSQL, ActivityPub, экспорт данных	✅ Заполнен
Frontend	Svelte, компоненты, редактор, real-time	✅ Заполнен
Marketing	Позиционирование, аудитория, конкуренты, брендинг	✅ Заполнен
Design	Логотип, цвета, типографика, компоненты	📝 Требует утверждения
API	REST + ActivityPub спецификации	✅ Заполнен
Deployment	Docker, CI/CD, мониторинг, бэкапы	✅ Заполнен

---

🎯 О проекте

YARU — это попытка создать альтернативу Mastodon со следующими особенностями:

• ✅ Без ограничений на длину поста — пишите статьи, а не твиты
• ✅ Экспорт данных — ваш контент всегда принадлежит вам (Markdown + медиа)
• ✅ Fediverse совместимость — полная совместимость с Mastodon
• ✅ Карма — качественная оценка контента вместо лайков
• ✅ Сменяемая концепция — название адаптируется под контекст

Стек технологий

Компонент	Технология
Бэкенд	Python 3.11+ + FastAPI
Фронтенд	Svelte 4+ + TypeScript
База данных	PostgreSQL 15+ (основная + кэш + очереди)
Протокол	ActivityPub (Fediverse)
Редактор	Временное решение (Chronicle в разработке)

---

📋 MVP функционал

1. Лента — домашняя и публичная
2. Профили — создание, редактирование, аватар
3. Посты — создание, редактирование, удаление (без ограничения длины)
4. Подписки — follow/unfollow, список подписчиков
5. Карма — начисление/списание, защита от накрутки
6. Экспорт — выгрузка всего контента в Markdown + медиа

---

🔍 Вопросы для обсуждения

Критичные для начала разработки

1. ActivityPub совместимость — обсуждение полной совместимости с Mastodon (обратная связь?)
2. Дизайн — кто делает макеты, есть ли предпочтения по цветам/стилю?
3. Хостинг — где размещать (Timeweb, Selectel, Hetzner, свой сервер)?
4. Домен — использовать yaru.nixg.ru или купить отдельный (yaru.ru, yaru.social)?
5. Редактор — какой WYSIWYG выбрать для MVP (TipTap, Quill, Markdown textarea)?

Технические детали

• Нужен ли SSR (SvelteKit) или достаточно SPA?
• Как хранить медиа: локально, S3, или оба варианта?
• Требуется ли модерация контента (админ-панель)?
• Нужна ли программа раннего доступа?

---

📞 Контакты и ресурсы

• Репозиторий: yaru.nixg.ru
• Редактор: chronicle.nixg.ru
• Документация для разработчиков: см. разделы выше

---

Последнее обновление: 2026-03-01