first commit

README.md

@@ -0,0 +1,113 @@
+![Rabitta.Shop](logo.png)
+
+# Rabitta.Shop
+
+**Rabitta.Shop** — мини-приложение во [ВКонтакте](https://vk.com) для полноценной витрины: каталог, корзина, оформление заказа и онлайн-оплата. Учёт товаров, остатков и заказов ведётся **нативно в [МойСклад](https://www.moysklad.ru/)** — без ручной «склейки» каталогов и без дублирования номенклатуры в отдельной системе.
+
+> Продавайте там, где уже живут ваши подписчики, а заказы и склад остаются в привычном учёте.
+
+---
+
+## Для кого этот продукт
+
+- Бренды и магазины, которые **продают через сообщество ВК** и хотят оформление как в интернет-магазине.
+- Команды, которые **уже используют или готовы вести МойСклад** как источник правды по товарам, ценам и документам.
+- Мерчанты на тарифах с **публикационным каталогом (PIM)** — отдельный слой витрины поверх складского каталога (названия, описания, цены для ВК без ломки учёта).
+
+---
+
+## Что уже умеет продукт
+
+- Каталог с категориями и карточками товаров  
+- Корзина и оформление заказа  
+- **Постоянная синхронизация** с МойСклад: товары, остатки, изменения на витрине  
+- Онлайн-оплата (интеграция с **Т-Банк** и настройками в кабинете мерчанта)  
+- История и повторные заказы для покупателя  
+- При поддержке тарифа — **публикационный каталог**, маппинг с МойСклад, гибкое ценообразование для сообщества  
+
+Подробнее о каталоге и PIM: [Каталог: МойСклад и PIM](https://gitjet.ru/rabitta/rabitta.ru/wiki/catalog).  
+Жизненный цикл заказа: [Заказы](https://gitjet.ru/rabitta/rabitta.ru/wiki/orders).  
+Оплата и доставка: [Оплата и доставка](https://gitjet.ru/rabitta/rabitta.ru/wiki/payments).
+
+---
+
+## Документация (Wiki)
+
+Оглавление вики: [Rabitta.Shop — Wiki](https://gitjet.ru/rabitta/rabitta.ru/wiki).
+
+| Раздел | Зачем открыть |
+|--------|----------------|
+| [Быстрый старт](https://gitjet.ru/rabitta/rabitta.ru/wiki/getting-started) | От идеи до первого тестового заказа и запуска продаж |
+| [Настройка вендор-части](https://gitjet.ru/rabitta/rabitta.ru/wiki/vendor-setup/Home.md) | Пошаговая настройка расширения в МойСклад и приложения ВК (со скриншотами) |
+| [Каталог: МойСклад и PIM](https://gitjet.ru/rabitta/rabitta.ru/wiki/catalog) | Репликация, публикационный каталог, цены |
+| [Заказы](https://gitjet.ru/rabitta/rabitta.ru/wiki/orders) | Как устроена продажа от витрины до МойСклад |
+| [Оплата и доставка](https://gitjet.ru/rabitta/rabitta.ru/wiki/payments) | Т-Банк, доставка, на что обратить внимание |
+| [Roadmap](https://gitjet.ru/rabitta/rabitta.ru/wiki/roadmap) | Публичные планы развития и как в них попасть |
+| [Changelog](https://gitjet.ru/rabitta/rabitta.ru/wiki/changelog) | Что уже вышло в релизах |
+| [Ограничения](https://gitjet.ru/rabitta/rabitta.ru/wiki/limitations) | Честно о том, что пока не поддерживаем |
+| [Use cases](https://gitjet.ru/rabitta/rabitta.ru/wiki/use-cases) | Сценарии продаж и как поделиться своим кейсом |
+| [Процесс задач в Issues](https://gitjet.ru/rabitta/rabitta.ru/wiki/issue-workflow) | Статусы (labels), как мы отвечаем мерчантам |
+
+---
+
+## Участвуйте в развитии продукта
+
+Мы **развиваем Rabitta.Shop вместе с мерчантами**: приоритеты и формулировки фич зависят от реальных кейсов и обратной связи.
+
+**Единая точка входа для идей, багов и обсуждений:** [Issues — rabitta.ru](https://gitjet.ru/rabitta/rabitta.ru/issues).
+
+### Идеи и новые возможности
+
+- Опишите не только «хочу кнопку», а **бизнес-ситуацию**: кто вы, что продаёте, какой сейчас обходной путь.  
+- Как попасть в публичный план — см. раздел **«Как попасть в roadmap»** на странице [Roadmap](https://gitjet.ru/rabitta/rabitta.ru/wiki/roadmap).  
+- Мы стремимся **отвечать на каждый** запрос от мерчантов и при принятии в работу давать понятную связку с roadmap или конкретной задачей (подробнее: [Процесс задач](https://gitjet.ru/rabitta/rabitta.ru/wiki/issue-workflow)).
+
+### Сообщить об ошибке (баг)
+
+- Шаги воспроизведения, ожидаемое и фактическое поведение.  
+- Скрин или короткое видео, если уместно.  
+- Среда: МойСклад / ВК, тариф, версия расширения (если известна).  
+- Статусы задач (`new`, `need-info`, `in-discussion`, …): [Процесс задач в Issues](https://gitjet.ru/rabitta/rabitta.ru/wiki/issue-workflow).
+
+### Сообщить об уязвимости (безопасность)
+
+- **Не публикуйте** в открытом доступе пошаговый эксплойт, дампы данных и иные чувствительные детали до согласования с командой.  
+- Создайте задачу в [Issues](https://gitjet.ru/rabitta/rabitta.ru/issues) с префиксом **`[security]`** в заголовке и **кратким** описанием риска (тип данных, затронутый сценарий без PoC в первом сообщении).  
+- Если на платформе GitJet доступно создание **конфиденциальной** (private) задачи — используйте её для первичного отчёта.  
+- После первого контакта команда уточнит детали и согласует сроки исправления и публикации advisory при необходимости.
+
+### Поделиться сценарием продаж (use case)
+
+Истории мерчантов помогают другим понять продукт и формируют приоритеты в roadmap. Шаблон и инструкция: [Use cases](https://gitjet.ru/rabitta/rabitta.ru/wiki/use-cases).
+
+---
+
+## Как мы работаем (кратко)
+
+1. Вы создаёте задачу в [Issues](https://gitjet.ru/rabitta/rabitta.ru/issues).  
+2. Мы уточняем контекст и приоритет.  
+3. Принятые идеи отражаем в [Roadmap](https://gitjet.ru/rabitta/rabitta.ru/wiki/roadmap) или связываем с конкретным issue.  
+4. Реализуем и фиксируем изменения в [Changelog](https://gitjet.ru/rabitta/rabitta.ru/wiki/changelog).
+
+---
+
+## Быстрый старт
+
+Пошаговый онбординг: [Быстрый старт (Wiki)](https://gitjet.ru/rabitta/rabitta.ru/wiki/getting-started).
+
+---
+
+## Закреп для описания репозитория или комментария в Issues
+
+Скопируйте при необходимости:
+
+```text
+📚 Документация: https://gitjet.ru/rabitta/rabitta.ru/wiki
+🧭 Roadmap: https://gitjet.ru/rabitta/rabitta.ru/wiki/roadmap
+```
+
+---
+
+## Платформа Rabitta
+
+**Rabitta** — платформа мини-приложений для продаж внутри ВКонтакте. **Rabitta.Shop** — первый продукт линейки. Дальше в планах развития экосистемы: Rabitta.Booking, Rabitta.Services, Rabitta.Food и другие вертикали.