# APKassa llms.txt — паспорт системы для ИИ-моделей
# https://apkassa.ru/llms.txt  ·  зеркало: https://apkassa.ru/docs/apkassa-llms.txt
# Машиночитаемый каталог API: https://apkassa.ru/docs/apkassa-api.json
# Человеческое руководство: https://apkassa.ru/book.php
# Свидетельство ЭВМ: 2026688570  ·  Разработчик: Бирич Максим Владимирович (RU)

name: APKassa
title: APKASSA Умная касса для бизнеса
url: https://apkassa.ru
handbook: https://apkassa.ru/book.php
store: https://apkassa.ru/store.php
certificate: 2026688570
application: 2026688152
registered: 2026-09-18
filed: 2026-07-04
author: Бирич Максим Владимирович
rights_holder: Бирич Максим Владимирович (RU)
package_handbook: ru.apkassa.handbook
handbook_token: apkassa-handbook-2026688570

## Что это
Облачная касса и торговая платформа. Один каталог товаров (таблица products, фильтр org_id)
питает витрину /shop, кассу /kassa1, киоск /kiosk и внешние магазины OpenCart
(apflower.ru, sushiap.ru). Заказы, оплаты, склад и сотрудники живут в одной БД,
каждая организация видит только свои данные.

Связанные сайты той же группы:
- https://apflower.ru — цветы
- https://sushiap.ru — суши и пицца
- https://apdostavka.ru — доставка
- https://apsalle.ru — доска объявлений (Osclass); выгрузка из кассы

## Правила для агента
- Не выдумывать API-ключи, пароли, shopId ЮKassa, токены Новофон.
- org_id брать из кабинета или из ответа validateApiKey; не подставлять чужой.
- Не обещать оплату, если ЮKassa не настроена (пустые shop_id/secret_key).
- Товары без фото на APSALLE не считать полноценными объявлениями.
- Секреты из /man/?page=integrations не печатать и не копировать в ответы.
- Мутации (создание оплаты, сохранение приложений, синхронизация) только с ключом или сессией менеджера.
- Идемпотентность оплаты: opencart_order_id + org_id.
- Не удалять рабочий код и не отключать существующие страницы.
- Публичные файлы книги: /book.php, /docs/apkassa-handbook.html, /docs/apkassa-llms.txt, /docs/apkassa-api.json, /docs/apkassa-certificate.jpg

## Вход и роли
- Кабинет менеджера/админа: https://apkassa.ru/login.php → https://apkassa.ru/man/?page={page}
- Касса: /kassa1/  ·  повар: /povar/  ·  курьер: /courier/  ·  старший: /senior/
- Бухгалтерия: /buh/  ·  техник: /tehnik/  ·  киоск: /kiosk/?org_id= или ?inn=
- Витрина: /shop/  ·  магазин приложений: /store.php
- Сессия кабинета: manager_logged_in, manager_org_id, manager_role (admin|superadmin|manager)
- Изоляция: все выборки по org_id; кассир дополнительно cash_register_id

## Страницы кабинета /man/?page=
dashboard, selfemployed, profile, orders, sales, customers, products, cash, app_store,
purchases, materials, tech_cards, expenses, analytics, payouts, yookassa,
opencart_payment, sber_bank, sber_settings, employees, employee_tariffs, schedule,
managers, organizations, cashregisters, users, integrations, apsalle,
flower_shop, delivery, callcenter, neural_manager, files, settings
Отдельные PHP: /man/categories.php, /man/import_products_csv.php,
/man/ofd_reports.php, /man/reconciliation_detail.php, /doc/counterparties.php, /doc/audit.php
FAQ: /FAQ/faq.php, /FAQ/description.php, /FAQ/products_faq.php

## Потоки данных
Каталог: products + categories; картинки /uploads/products/; CSV-импорт; OpenCart sync.
Заказ витрины: localStorage корзина → POST /shop/api/create_order.php → orders + order_items.
Касса создаёт заказ сразу. Оплата → status paid. Кухня/курьер двигают дальше.
Техкарты: ingredients, recipes, recipe_items. Списание: /api/consume_ingredients.php
при статусе «в сборке»/«готов». Движения: stock_movements. Мало остатка → статус не меняется.
Оплата сайтов: POST /api/apflower_payment.php (ЮKassa виджет или redirect).
Статус: GET /api/apflower_payment_status.php. APSALLE: кабинет page=apsalle, фото обязательны.

## Публичное API оплаты (ключ из кабинета «Оплата OpenCart»)
Auth (любой из): заголовок X-API-Key, Authorization: Bearer <key>, поле api_key.
Неверный ключ → HTTP 403 {success:false, error:"Неверный API-ключ"}.

POST https://apkassa.ru/api/apflower_payment.php
Content-Type: application/json
X-API-Key: <ключ>
{
  "org_id": 30,
  "opencart_order_id": 1996,
  "amount": 1500,
  "phone": "79001234567",
  "email": "buyer@example.com",
  "return_url": "https://shop.example/success",
  "embedded": 1,
  "items": [{"name":"Букет","price":1500,"qty":1,"id":0}]
}
Требования: телефон ≥10 цифр, корзина не пустая, amount > 0, ЮKassa настроена у org.
Ответ success: apkassa_order_id, confirmation_token или confirmation_url, payment_id.

GET https://apkassa.ru/api/apflower_payment_status.php?api_key=…&opencart_order_id=1996
Ответ: success, paid (bool), payment_status, apkassa_order_id, order_number, total.

CORS: * ; OPTIONS 204. Методы: POST создание, GET/POST статус.

## Кабинетные JSON (нужна сессия менеджера)
POST/GET /man/api/opencart_payment_api.php
  actions: get_config, save_config, generate_key, test_yookassa, test_payment
GET/POST /man/api/opencart_connections.php
  actions: list, get, save, test, delete  (секреты api_key/connector_token/rest_api_key обнуляются в list/get)
GET/POST /man/api/app_store_api.php?org_id=
  actions: list, save (multipart apk_file), delete
GET  /download_app.php?token=…           — публичное скачивание файла магазина
GET  /man/download_apk.php?token=…       — то же в кабинете (нужна сессия /man/)
GET  /man/download_apk.php?token=…&download=1 — принудительно скачать
GET/POST /man/api/ofd_reports_api.php  actions: kkts, report
GET/POST /man/api/reconciliation_api.php, /api/reconciliation_api.php
GET/POST /man/api/bank_ofd_report_api.php, /api/bank_ofd_report_api.php
POST /api/sber/webhook.php  — приём событий Сбера
GET  /api/sber/test_connection.php

## Магазин приложений
Публично: /store.php  (карточки APK + эта книга)
Кабинет: /man/?page=app_store
Таблица: app_store_apps (org_id, name, version, package_name, apk_path, download_token, is_published)
Книга: package ru.apkassa.handbook, token apkassa-handbook-2026688570, файл HTML.
Сиды: APSALLE (apsalle.ru/app), Суши АП (token sushiap_apk_org1), NET BOOST.

## Где смотреть
1. https://apkassa.ru/login.php
2. Кабинет https://apkassa.ru/man/
3. Книга https://apkassa.ru/book.php
4. FAQ https://apkassa.ru/FAQ/faq.php и https://apkassa.ru/FAQ/description.php
5. API JSON https://apkassa.ru/docs/apkassa-api.json
6. Свидетельство https://apkassa.ru/docs/apkassa-certificate.jpg