1. Что это за продукт«Ревизор»— это веб-система для учёта оборудования, запасов и связанных операций: справочники, остатки, документы, заявки на обслуживание, отчёты и печатные формы. Заказчик подключается к сервису по сети Интернет; у себя сервер не ставит — данные хранятся и обрабатываются на стороне разработчика (или у его российского оператора по договору).
Снаружи это одно веб-приложение: тонкий клиент в браузере общается с сервером по HTTPS, обмен — в основном JSON через REST API.
2. Что умеет система — по блокамПользователи и безопасностьВход по логину и паролю; права — через роли (группы). Есть администрирование пользователей. Для интеграций может использоваться токен API (по политике тарифа).
Инфраструктура учётаОрганизации; управляемые объекты и системы; локации и типы локаций; представление иерархии для привязки техники и складских позиций.
Оборудование и запасыПроизводители, типы, модели; режимы учёта (в т.ч. поштучно и пакетами); экземпляры; остатки и движения; установленное оборудование; учёт ПО, пулов и распределения.
ДокументыТипы и сами документы, строки документа (в т.ч. под разные виды номенклатуры); жизненный цикл с проведением и отменой проведения у уполномоченных ролей.
Обслуживание и заявкиСправочники обслуживания; заявки (инциденты) с вложениями.
Печать и маркировкаНастройки этикеток, шаблоны, пул кодов, профили принтеров; пользовательские шабло- ны печати; серверная генерация PDF и других форматов — по реализации.
Отчёты и аналитикаОтчёты по учётным данным; расширенный набор — в зависимости от тарифа и конфигу- рации SaaS.
АудитЖурнал значимых событий для контроля.
ИнтеграцияREST API; при включённой опции — машиночитаемое описание (OpenAPI/Swagger) на контуре сервиса.
Ограничения SaaSЧисло пользователей, объём данных, набор функций задаются
тарифом и конфигура- цией облака. Обновления версий выполняются на стороне разработчика.
3. Полный стек технологий (как написано и на чём работает)
Ниже — состав стека по репозиторию разработки: клиент, сервер, зависимости, типич-
ное окружение эксплуатации. Версии уточняйте на дату релиза, подаваемого на регистрацию.
3.1. Клиентская часть (браузер)
Технология | Роль в продукте |
HTML / CSS | Вёрстка и оформление экранов |
TypeScript (~5.9) | Язык разработки клиентской логики |
Angular (21.x) | Фреймворк SPA, маршрутизация, формы, внедре- ние зависимостей |
Angular Material / CDK | Готовые UI-компоненты и вспомогательные примитивы |
RxJS | Реактивные потоки данных, асинхронность |
Zone.js | Слой отслеживания асинхронных вызовов для Angular |
CodeMirror 6 (@codemirror/*) | Редактор кода/разметки в интерфейсе (шаблоны и подобное) |
html5-qrcode | Работа со сканированием QR/штрихкодов через браузер |
Сборка клиента: Angular CLI / @angular/build (цепочка включает esbuild и иные средства сборки, поставляемые с Angular), npm; тесты: Karma, Jasmine. В продакшен у пользователя попадают уже собранные статические файлы — отдельно Node.js на ПК пользователя не нужен.
3.2. Серверная часть (облако)
Технология | Роль в продукте |
Python (3.x, конкретная минорная — по релизу) | Язык серверной логики |
Django (5.2.x) | Веб-фреймворк, ORM, админка, пользователи |
Django REST Framework (3.14.x) | REST API, сериализация, права доступа |
drf-spectacular | Генерация OpenAPI-схемы для документирования API |
django-cors-headers | Настройка CORS для запросов из браузера |
python-decouple | Конфигурация из переменных окружения / .env |
mysqlclient | Драйвер к MySQL / совместимой СУБД |
Pillow | Обработка изображений |
Jinja2 | Шаблонизация (в т.ч. для печатных представле- ний, где применимо) |
WeasyPrint | Генерация PDF из HTML/CSS |
qrcode, pyStrich, python-barcode | Штрихкоды и машиночитаемые метки |
openpyxl | Работа с форматом Excel (xlsx), где используется |
cryptography | Криптопримитивы общего назначения в приложении |
asgiref, sqlparse | Зависимости экосистемы Django |
СУБД в эксплуатации: как правило MySQL или MariaDB (совместимый протокол)
Типичный контур размещения: ОС семейства Linux, перед приложением — обрат- ный прокси (часто nginx) и WSGI/ASGI-сервер (Gunicorn, uvicorn или аналог — конкретика по внедрению у правообладателя). Статика отдаётся через nginx или CDN по внутренней схеме.
3.3. Вспомогательный компонент (не обязателен для всех)Технология | Роль в продукте |
Node.js + небольшой JavaScript-сервер (zpl-proxy) | Локальный HTTP→TCP для печати ZPL на сетевые принтеры (где это нужно) |
3.4. Инструменты разработки (не поставляются конечному пользователю)Git (хранение кода на GitLab CE в офисе правообладателя, г. Санкт-Петербург), IDE (VS Code, PyCharm, WebStorm и др.), системы CI/CD для сборки и проверок — по внутренней инфраструктуре ООО «Элтекс Ти Си».
4. Требования к компьютеру пользователяДостаточно современного ПК или планшета с 4–8 ГБ ОЗУ, нормальным экраном (от 1366×768 комфортнее) и стабильным Интернетом. Нужен актуальный браузер с под- держкой TLS. Для сканирования штрихкодов и QR в типовом сценарии предполагается мобильное устройство с камерой (смартфон, планшет) для работы непосредственно на объекте (склад, стойка, площадка); камера стационарного ПК не обязательна.