Техническая документация Backend

Backend системы NARMAK построен на Django и обеспечивает REST API, документооборот, склад, производство, TMS, финансы и интеграции.

Технологический стек

• Фреймворк: Django 4.x/5.x, Django REST Framework
• БД: PostgreSQL
• Кэш: Redis
• Очереди: Celery
• WebSocket: Django Channels
• API документация: drf-yasg (Swagger)
• Аудит: django-auditlog
• Иерархии: django-mptt

Обзор модулей

Модуль	Назначение
users	Аутентификация по телефону, роли, организации
document	Документы, позиции, workflow, НДС
counterparty	Контрагенты, DaData, группы
stock	Номенклатура (Raw), остатки, цены
warehouse_zones	Зоны, остатки по зонам, движения
company_structure	Подразделения, должности, сотрудники
manufacture	Смены, табель, зарплаты, отпуска, KPI
marketplace	Ozon, Wildberries, Яндекс.Маркет и др.
tasks	Проекты, задачи, статусы, приоритеты
tms	Транспорт, водители, маршруты, рейсы, топливо, ТО
intercompany_settlements	Взаимозачеты, задолженности
bank	Счета, выписки, операции, платежные поручения
lms	Курсы, уроки, тесты, прогресс, сертификаты
Дополнительные	ATS, HACCP, Telegram, Gantt, finance, cart/order, invoice, plantmaintenance

Разделы

• Модули (reference) — модели и ключевые поля по каждому модулю
• API и интеграции — REST API v2, Swagger, внешние сервисы
• Развертывание — Docker, PostgreSQL, Redis, Celery, WebSocket
• Безопасность и аудит — права доступа, аудит, CSRF, валидация

См. также

• Frontend документация — Angular, Nx, State Management
• Обзор архитектуры проекта — общая архитектура системы
• ADR — архитектурные решения — принятые архитектурные решения
• Глоссарий — термины и определения