$ cat ~/projects/agentventa/README.md
AgentVenta
Приложение для торговых агентов и автономных точек продаж: заказы, оплаты и фискальные чеки без постоянного интернета, обмен с 1С.
- kind
- android
- status
- active
- since
- 2023
- source
- закрытый
- stack
- Kotlin · Room · Hilt · Coroutines · Retrofit · WorkManager · Google Maps · Firebase
- store
- Google Play
Что делает
AgentVenta («Агент Venta») — второе поколение приложения «Агент» для торговых агентов на маршруте и автономных торговых точек. Агент принимает заказы, оформляет возвраты и приём оплаты, а документы уходят в учётную систему — 1С или другую. Постоянная связь не нужна: данные хранятся на устройстве и отправляются при обмене. Состав выгрузки настраивается на стороне учётной системы, в том числе с ограничением доступа для мобильных пользователей. Обмен идёт через сервер-посредник по REST API, для интеграторов есть описание API и пример модуля 1С.
Возможности
- каталог товаров с остатками, ценами и картинками, сортировка и отбор по остаткам;
- клиенты: адрес, телефон, сальдо взаиморасчётов с группировкой долгов, последние операции;
- заказы клиента с выбором организации, склада, типа цен и расчёта, скидками (включая иерархические), возвратами и доставкой;
- кассовые ордера и задачи;
- фискальные чеки через программный РРО (Checkbox): вход кассира, смены, служебные внос и вынос, X-отчёт, копии чеков;
- печать чеков и заказов на Bluetooth-принтере;
- сканер штрих-кодов — встроенный или аппаратный, с диагностикой;
- история местоположений на карте с подсчётом пройденного за день расстояния, клиенты на карте;
- несколько учётных записей (баз 1С) на одном устройстве;
- демо-подключение для знакомства.
История разработки
- 2023 — сентябрь: новое приложение на Kotlin, версия 3.0, публикация в Google Play; фискальные чеки через Checkbox, клиенты на карте, копирование документов, чтение штрих-кодов. Осень: настройки Bluetooth-принтера.
- 2024 — печать текстов из фискального сервиса на принтере, целевой Android 15 (API 35), очистка старых документов.
- 2025 — май: выбор организации и склада в заказе, доработка кассовых документов. Июль: собственная проверка лицензий вместо Firebase. Ноябрь: переход на Clean Architecture (use cases, StateFlow), модульные тесты, синхронизация через сервер-посредник по WebSocket. Декабрь: интерфейс на Material 3, печать через вебхук.
- 2026 — март: новая тема и нижняя навигация, полная синхронизация, иерархические скидки. Май: отслеживание местоположения только при открытом приложении, удалённый отладочный журнал. Июнь: обмен переведён с WebSocket на REST, WebSocket удалён. Июль: группировка долгов, опции доставки и правки цен/скидок. Осень: целевой API 36, устойчивые к обрывам связи чеки Checkbox со скидками.

