Джерела inCust — індекс посилань

Зведений реєстр оригінальних джерел знань платформи inCust: документи Google, PDF, таблиці, малюнки, тек з підвмістом, веб-ресурси на incust.com.

Це людський індекс для швидкого доступу. Канонічне джерело правди — catalog.json (документи в documents[], знання в knowledge[]). Згенеровано з catalog.json v4.3 (станом на 2026-05-13). Усього: 34 документи в 12 категоріях.

---

Зміст

• Інфраструктура (servers, database, templates)
• Архітектура (overview, roles, rules, security)
• Покупці (customers)
• Бізнес (taxes & fees)
• Програми лояльності (loyalty)
• Паливо та АЗС (fuel)
• Інтеграції (integration)
• Авторизація (auth)
• Електронна комерція (ecommerce)
• API
• Платежі (payments)
• Навігація — Knowledgebase Registry
• Знання (knowledge)

---

Інфраструктура

Servers — конфігурація серверів

Зміст: конфігурації 5 VM (DB, API, Messaging, Broker, Analytics) для масштабів 100K і 300K транзакцій/місяць.

Database — DB/DBA sizing

Зміст: матриця 8×8 (CPU/RAM/SSD) для DB (MySQL OLTP) та DBA (OLAP) серверів.

Templates

Зміст: шаблон мінімальних технічних вимог до розгортання inCust.

---

Архітектура

Зміст:

• DOC-008 — оглядовий ~285KB документ з архітектурою inCust v02.
• DOC-009 — опис ролей користувачів у системі inCust і їхні права.
• DOC-010 — документ про правила інтерпретації / роботи системи (~200KB).
• DOC-034 — Security architecture overview: 6 компонентів (Admin Dashboard, Business Dashboard, POS/Каса, аналітична БД, сервери, хмара OVH); JWT-токени, 2FA, RBAC, API KEY, anti-brute-force (Google reCaptcha + блокування + чорні списки), SSH-доступ, firewall IP/мереж, MFA через Google Authenticator для OVH.

---

Покупці

Зміст:

• DOC-011 — імпорт корпоративних покупців.
• DOC-012 — типи, структура й операції з рахунками роздрібних покупців.
• DOC-013 — розширення/доробка функціональності категорій покупців.
• DOC-014 — реєстр приватних даних (PII), GDPR-релевантне.
• DOC-015 — функціональність зворотного зв'язку від покупців.

---

Бізнес

Зміст: документ про обробку податків і зборів у системі inCust.

---

Програми лояльності

DOC-017 — Нарахування бонусів поза правилами для операцій продажу (тека)

📁 Тека: ↗

Вкладене:

• DOC-017.1 — Нарахування бонусів поза правилами для операцій продажу (Google Doc) · ↗

DOC-018 — Схема списання/нарахування бонусів рознесених у часі (тека)

📁 Тека: ↗

Вкладене:

• DOC-018.1 — Зовнішня інтеграція: списання/нарахування бонусів рознесених у часі (Google Doc) · ↗
• DOC-018.2 — Схема: бонуси рознесені в часі одним Терміналом (drawing) · ↗
• DOC-018.3 — Схема: бонуси рознесені в часі різними Терміналами (drawing) · ↗

---

Паливо та АЗС

Зміст:

• DOC-019 — процес заправки/відпуску палива в системі inCust.
• DOC-020 — авторизація колонки без вказання конкретного пістолета (~187KB).
• DOC-021 — модуль автоцистерни Prime: інтеграція та документація.
• DOC-022 — сценарій: одна паливна колонка обслуговується декількома Терміналами (POS + Kiosk).
• DOC-023 — інтеграція PLC контролера з обладнанням через MODBUS протокол (~95KB).
• DOC-024 — базова концепція інтеграції PLC з обладнанням мийки (CarWash).

---

Інтеграції

Зміст: документація інтеграції із зовнішньою системою FuFit.

---

Авторизація

Зміст:

• DOC-026 — загальний потік автентифікації в системі inCust.
• DOC-027 — OAuth через Google (Sign in with Google).
• DOC-028 — OAuth через Apple (Sign in with Apple).

---

Електронна комерція

Зміст: варіанти моделювання вартості доставки у Крамниці inCust.

---

API

DOC-030 — Message Additional Data (тека)

📁 Тека: ↗

Вкладене:

• DOC-030.1 — Messages Additional Data (Google Doc) · ↗
• DOC-030.2 — incust_api_notification_messages_templates (spreadsheet) · ↗
• DOC-030.3 — params incust_api_notification_messages_templates (spreadsheet) · ↗

DOC-031 — REST API Термінала inCust (веб-документація)

🌐 Веб-ресурс: https://incust.com/files/docs/api/register/REST_API/uk/index.html

Зміст: повна REST API: авторизація, товари, покупці, чеки, платежі, купони, паливо.

Ключові факти:

• Base URL: https://api.incust.com/v1
• Типи автентифікації: token (24h), API KEY (10 років)
• Типи ідентифікаторів покупця: phone, qr, email, card, temporary-card, id, social-network, ssn, itin

---

Платежі

Зміст: ТЗ системи розстрочки для покупців: індивідуальний кредитний ліміт, графік чергових платежів, фінансування роботодавцем (B2E). Реалізація через рахунок типу «Гроші» з кредитним лімітом, транзакції типу reserve та special-account-write-offs-loan. Підтримує позачергове погашення, нарахування на рівні Бренда, webhook-сповіщення, шаблони повідомлень.

Ключові факти:

• Тип рахунку: Гроші, Кредитний з лімітом
• Типи транзакцій: reserve, special-account-write-offs (subtype: special-account-write-offs-loan)
• Режими погашення: автоматичне за датою, погашення через API БП (вручну/інтеграція)
• Налаштування рівня Бренда: рахунок, часова зона, дата періоду, автопогашення, овердрафт, webhook, допустима сума кредиту, допустима кількість одночасних кредитів

---

Навігація — Knowledgebase Registry

DOC-032 — inCust Knowledgebase URL Registry

🌐 Корінь: https://incust.com/ua/knowledgebase/review/

Зміст: повний реєстр 229 публічних URL inCust у 18 секціях (A–R): головне меню, база знань (Огляд, Кабінет бізнесу 1-14, Технічні інструкції, PKPASS, Паливо, Автоцистерни, Корп. покупці, Відгуки, Ціноутворення), Навчання, API/інтеграції, Матеріали, Статті, FAQ/глосарій, зовнішні сервіси (Панель Бізнесу, Term/Kiosk/Web), футер.

Ключові факти: 18 секцій · 229 посилань · корінь https://incust.com/ua/knowledgebase/.

---

A. Головне меню сайту

Корінь: https://incust.com/ua/

• Платформа
• Модулі
• Галузі
• Ціни
• Ідеї для бізнесу
• Вхід/Реєстрація

---

B. База знань — точки входу

Корінь: https://incust.com/ua/knowledgebase/

• Огляд
• Інструкції
• Інструкції-опис кабінету бізнесу
• База знань (головна)

---

C. Кабінет бізнесу (інструкція-опис)

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/instruction-business/

• 1. Статистика — Огляд
• 1.1 Активність покупців
• 1.2 Оборот в програмі лояльності
• 1.3 Візити / викорисано видач
• 1.4 Вартість програми лояльності / користувачі додатку
• 2. Налаштування — Огляд
• 2.1 Бізнес
• 2.2 Програми лояльності
• 2.2.1 Налаштування програми лояльності
• 2.2.2 Категорії покупців
• 2.2.3 Налаштування категорій покупців
• 2.2.4 Правила програми лояльності
• 2.2.5 Програма рекомендацій
• 2.2.6 Крамниця
• 2.2.6.1 Крамниця налаштування
• 2.2.6.2 Способи доставлення
• 2.2.7 Шаблони повідомлень
• 2.2.8 Податки та Збори
• 2.2.9 Витрати/Націнки
• 2.2.10 Додаткові налаштування
• 2.3 Цінові групи
• Цінові групи: Огляд
• 2.3.1 Цінові групи товарів
• 2.3.2 Режим ¢Таблиці цін
• 2.4 Точки продажу
• 2.4.1 Налаштування точки продажу
• 2.4.2 Публікація точки продажу в мобільному каталозі
• 2.5 Термінали і продавці
• 2.5.1 Режими Термінала
• 2.5.2 Режими Кіоску
• 2.5.3 Налаштування Наційок та Витрат
• 2.6 Рахунки покупців
• 2.7 Товари та послуги
• 2.7.2 Список категорій
• 2.8 Контролери паливної колонки
• 3. Журнал транзакцій
• 4. Журнал замовлень
• 5. Покупці
• 5.1 Імпорт покупців
• 5.2 Анкета покупців
• 5.3 Додати нового покупця
• 6. Новини та інформація
• 7. Повідомлення
• 8. Серії купонів
• 8.1 Купони
• 8.2 Створити серію купонів
• 9. Біржа купонів
• 10. Подарункові сертифікати
• 11. Серії передоплачених сертифікатів
• 11.1 Передоплачені сертифікати
• 11.2 Рахунки для передоплачених сертифікатів
• 11.3 Категорії передоплачених послуг
• 11.4 Послуги для сертифікатів
• 12. Мій рахунок
• 12.1 Рахунки та фінанси
• 12.2 Поповнення рахунку
• 13. Рекомендуйте нас
• 14. Підтримка

---

D. Технічні інструкції

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/ways-working-customer/

• Варіанти взаємодії із покупцем
• Кабінет покупця і мобільний додаток
• Мобільний додаток inCust
• Новини, повідомлення
• Способи видачі та погашення винагород
• Способи прийому оплати від покупців
• Як налаштувати Крамницю
• Оплата за прямим посиланням або QR
• Оплата кредитною карткою без термінала
• Налаштування Кіоску
• Розширена Анкета покупця
• Купони і сертифікати
• Випуск квитків
• Корпоративні рахунки
• Біржа купонів
• Подарункові картки

---

E. Цифрова карта PKPASS

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/instruction-pkpass/

• Інструкція
• Огляд
• Самостійна реєстрація покупця
• Чим відкрити PKPASS?
• Додавання цифрової картки pkpass
• Отримання в SMS посилання на цифрову картку
• Самостійне отримання копії пластикової картки
• Отримання посилання на картку іншими каналами

---

F. Паливо та енергія

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/fuel-energy/

• Інструкція
• Опис можливостей
• Огляд процедури налаштування (controller-settings-2)
• Огляд процедури налаштування (controller-settings)
• Огляд корпоративних рахунків
• Детальний опис налаштування
• 1. Рахунок покупця
• 2. Програми лояльності
• 3. Точки Продажу
• 4. Налаштування Терміналів
• 5. Категорії товарів
• 6. Товари
• 7. Контролер паливної колонки
• 7.1 Опис
• 7.2 Колонки
• 7.3 Типи палива
• 8. Заправляння за USSD
• 9. QR-код для колонки
• 10. Відеоінструкція
• 11. Самообслуговування через Кіоск

---

G. Модуль автоцистерни

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/configuring-road-tankers-module/

• Інструкція (legacy URL)
• Інструкція з налаштування
• Перелік автоцистерн
• Термінали та продавці
• Доступ робітників
• Контролери паливної колонки
• Опис
• Колонки
• Типи палива
• Паливні ємності
• Мапи та маршрути
• Паливні ємності покупця
• Додати зв'язок ємностей
• Маршрути
• Додати маршрут

---

H. Інші модулі (FuelTaxi, мийки)

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/fueltaxi_configuration/

• FuelTaxi
• Обладнання, мийки, вендингові апарати

---

I. Корпоративні покупці

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/commercial-customers-settings/

• Інструкція з налаштування
• Налаштування корпоративних покупців
• Додаткові поля
• Журнал транзакцій
• Транзакції за товарами
• Корпоративні рахунки

---

J. Відгуки та рекомендації

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/instruction-of-setting-up-feedback/

• Інструкція
• Опис основних можливостей
• Налаштування відгуків

---

K. Складні схеми ціноутворення

Корінь: https://incust.com/ua/knowledgebase/business-user-manual/pricing-schemes-instruction/

• Інструкція
• Огляд
• Податки та збори
• Витрати/Націнки
• Цінові групи
• Цінові групи товарів
• Режим Таблиці цін
• Термінал: цінові групи
• Термінал: націнки і витрати
• Ціноутворення для корпоративних покупців

---

L. Навчання (Tutorials)

Корінь: https://incust.com/ua/knowledgebase/tutorials/

• Швидкий старт / Навчання
• Реєстрація програми лояльності
• Перші кроки
• Типові програми лояльності
• Бонуса за різними бонусами
• Бонуси від суми покупок
• Бонуси від суми чека
• Бонуси за 3 місяці
• Дисконт з різними знижками
• Знижка від суми покупок
• Знижка від суми чека
• Знижка за 3 місяці
• Створення Крамниці (інструкція)

---

M. Програми, інтеграція і API

Корінь: https://incust.com/ua/knowledgebase/documentation/

• Розділ
• Програмне забезпечення для бізнесу
• Програмне забезпечення для покупця
• Технологічний стек
• Чат-бот Покупця
• Довідник з API
• Інтеграція з 1С
• Інтеграція з Poster POS
• Інтеграція з Smart Touch POS
• Інтеграція з Smart Touch 1C
• Інтеграція з iiko
• Інтеграція з syrve
• Інтеграція з 1С-Bitrix
• Інтеграція з R-keeper
• Бухгалтерія онлайн
• Плагін імпорту/експорту товарів
• Скрипт 'Fuel Price'
• Скрипт масового завантаження товарів
• Схеми інтеграції для АЗС
• Контролер для АЗС
• Налаштування RemoteScanner

---

N. Матеріали та документи (логотипи, маскот)

Корінь: https://incust.com/ua/knowledgebase/resources/

• Розділ
• Маскот
• Юридична інформація
• Логотипи
• Матеріали для точок продажу
• Матеріали для QR-кодів

---

O. Статті — практика

Корінь: https://incust.com/ua/knowledgebase/articles/

• Розділ
• Розробка програми лояльності
• Як підвищити лояльність до бренду?
• Як підвищити лояльність до компанії?
• Як залучити більше покупців?
• Подарунковий сертифікат
• Купони і сертифікати

---

P. FAQ та глосарій

Корінь: https://incust.com/ua/knowledgebase/faq/

• Часті питання
• ЧаПи бізнесу
• ЧаПи покупців
• Глосарій

---

Q. Зовнішні / службові посилання (Панель Бізнесу та інше)

Корінь: https://business.incust.com/

• Панель управління бізнесом
• Налаштування бізнесу
• Програми лояльності
• Товари та послуги
• Рахунки клієнтів
• Тариф
• Точки продажу
• Термінали
• inCust Термінал (вебпосилання)
• inCust Кіоск (Google Play)
• Веб-додаток покупця
• Завантаження мобільного додатку
• Приклад Крамниці
• Чат-боти (Facebook, Telegram, Viber)
• Підтримка бізнесу
• Telegram-бот підтримки
• WhatsApp
• YouTube (огляд платформи)
• Стаття у блозі (продаж палива без інтеграції)

---

R. Футер

Корінь: https://incust.com/ua/contacts/

• Хмарний сервіс
• Ціни у хмарі
• Власний бренд
• Для бізнесу
• Для покупців
• Про нас
• Для партнерів
• Для преси
• Контакти
• Privacy Policy Google
• Terms of Service Google

---

Знання (knowledge)

Згенеровані Claude .md файли в /knowledge/. Це не оригінальні джерела, а похідні структуровані знання.

---

Папки в Shared Drive

• /catalog/ — ↗ — catalog.md + catalog.json + цей файл
• /knowledge/ — ↗ — згенеровані .md знання
• /sources/ — ↗ — оригінали (PDF, Doc)
• Корінь Shared Drive — ↗