first commit

This commit is contained in:
2026-05-27 00:41:24 +03:00
commit a9392518ba
4 changed files with 176 additions and 0 deletions
+18
View File
@@ -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.
+113
View File
@@ -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 и другие вертикали.
+45
View File
@@ -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
BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB