commit a9392518bad72d19429e003ceeb06ab5500aadd4 Author: Spiridonov Max Date: Wed May 27 00:41:24 2026 +0300 first commit diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..089a6fe --- /dev/null +++ b/LICENSE @@ -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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..56ee87c --- /dev/null +++ b/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 и другие вертикали. diff --git a/changelog.md b/changelog.md new file mode 100644 index 0000000..56cf396 --- /dev/null +++ b/changelog.md @@ -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 diff --git a/logo.png b/logo.png new file mode 100644 index 0000000..34a055c Binary files /dev/null and b/logo.png differ