first commit
This commit is contained in:
@@ -0,0 +1,18 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2026 rabitta
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
|
||||||
|
associated documentation files (the "Software"), to deal in the Software without restriction, including
|
||||||
|
without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
|
||||||
|
following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial
|
||||||
|
portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
|
||||||
|
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
|
||||||
|
EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||||
|
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
|
||||||
|
USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||||
@@ -0,0 +1,113 @@
|
|||||||
|

|
||||||
|
|
||||||
|
# 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 и другие вертикали.
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|
Формат вдохновлён [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/).
|
||||||
|
|
||||||
|
## [Unreleased]
|
||||||
|
|
||||||
|
### Планируется
|
||||||
|
|
||||||
|
- *(Пусто — следующие изменения переносите сюда до публикации версии.)*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## [1.0.0] — 2026-04-24
|
||||||
|
|
||||||
|
Первый публичный релиз Rabitta.Shop.
|
||||||
|
|
||||||
|
### Добавлено
|
||||||
|
|
||||||
|
#### Мини-приложение ВКонтакте
|
||||||
|
|
||||||
|
- Каталог: поиск и разделы; в списке — название и цена товара; кнопка «В корзину» с изменением количества прямо в каталоге, без перехода в корзину.
|
||||||
|
- Карточка товара: галерея изображений, цена, название, описание, код; кнопка «В корзину» с тем же изменением количества без перехода в корзину.
|
||||||
|
- Профиль клиента: автоматическое подтягивание аватара, ФИО, телефона и почты из ВКонтакте.
|
||||||
|
- Профиль клиента — **История заказов**: все заказы клиента, повтор заказа, оплата неоплаченного заказа.
|
||||||
|
- Профиль клиента — **Баланс**: отображение актуального баланса (положительного или отрицательного).
|
||||||
|
- Профиль клиента — **Адреса доставки**: список адресов; выбор точки на интерактивной Яндекс.Карте; подсказки адресов через DaData.
|
||||||
|
- **Корзина**: изменение состава заказа, кнопка «Оформить заказ»; ограничение минимальной суммы заказа.
|
||||||
|
- **Оформление заказа**: выбор адреса доставки, способа оплаты, комментарий к заказу; при онлайн-оплате — оплата сразу после оформления или позже из списка в «Истории заказов».
|
||||||
|
|
||||||
|
#### Настройки в решении МойСклад (кабинет мерчанта)
|
||||||
|
|
||||||
|
- Пользователь МойСклад с правами **администратора** может полностью настроить приложение.
|
||||||
|
- Пользователь МойСклад **без** прав администратора может настраивать каталог **PIM** и работать с закладкой «Пользователи ВК».
|
||||||
|
- Закладка **«Настройки»**: использование остатков в мини-приложении ВК; разрешение пользователям настраивать каталоги; обновление справочников из МойСклад (редко меняющиеся данные — см. инструкцию).
|
||||||
|
- Закладка **«Интеграция ВК»**: таблица привязанных сообществ; управление сообществами (параметры, работа с остатками, привязка публикационных каталогов).
|
||||||
|
- Закладка **«Каталог PIM»** (если тариф включает PIM): создание и управление публикационными каталогами для администратора или пользователя — по настройкам прав.
|
||||||
|
- Закладка **«Платежи»**: настройка интеграций с платёжными системами (доступ администратора).
|
||||||
|
- Закладка **«Пользователи ВК»**: таблица пользователей, зарегистрировавшихся через ВК.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 💡 Не хватает функции?
|
||||||
|
|
||||||
|
Создайте задачу и опишите ваш кейс:
|
||||||
|
https://gitjet.ru/rabitta/rabitta.ru/issues
|
||||||
Reference in New Issue
Block a user