📘 Документация 3ERP

Системные требования

• ОС: Windows 10/11, Linux (Альт, РедОС, Астра, Ubuntu/Debian/CentOS), macOS 11+
• Память: от 512 МБ
• Диск: 100 МБ (база данных + конфигурация)
• Браузер: Chrome, Firefox, Edge, Safari (последние версии)

Порядок установки

1. Скачайте архив для вашей ОС с главной страницы.
2. Распакуйте в любую папку.
3. Запустите исполняемый файл:
   • Windows: 3erp-windows-amd64.exe
   • Linux (Альт/Астра/РедОС): ./3erp-alt-amd64 (предварительно дайте права на выполнение: chmod +x 3erp-*)
   • macOS: 3erp-macos-arm64 или 3erp-macos-intel
4. В терминале появится строка: Server started on http://localhost:8080
5. Откройте браузер → перейдите по адресу http://localhost:8080

После первого запуска доступны предустановленные пользователи. Все пароли хранятся в хешированном виде.

Справочники служат источниками данных для документов и отчётов. Работа с ними интуитивна:

• Просмотр: выберите пункт меню (Товары / Контрагенты / Склады).
• Создание: нажмите «Создать элемент» → заполните поля (СТРОКА, ЧИСЛО, БУЛЕВО, ДАТА).
• Редактирование: нажмите «Открыть» в строке → измените данные → «Сохранить».
• Удаление: откройте элемент → кнопка «Удалить» (если на элемент есть ссылки в документах, удаление будет заблокировано).

Создание документа

Меню → Документы → «НовыйПриход» (или «НовыйРасход»).

• Шапка: дата (авто), номер (формируется по шаблону), контрагент, склад.
• Табличная часть «Товары»: добавляйте строки, указывайте номенклатуру, количество, цену → сумма рассчитывается автоматически. Итоговая сумма документа обновляется в реальном времени.

Проведение и отмена

• Сохранить — черновик (не влияет на остатки).
• Провести — создаёт движения в регистре «Остатки». При расходе проверяется достаточность остатков (если в настройках запрещены отрицательные остатки).
• Отмена проведения — удаляет движения.
• Печать — открывает предварительный просмотр с суммой прописью.

3ERP включает гибкую систему отчётов:

• Остатки товаров – остатки по складам и номенклатуре.
• Продажи по товарам – аналитика по расходам.
• Анализ продаж за период – отчёт с параметрами (дата начала/конца, контрагент).
• Товарный отчёт по складу – приход/расход/конечный остаток, с фильтром нулевых остатков.

Как пользоваться параметрическими отчётами

1. Перейдите в меню → Отчёты → выберите, например, «Анализ продаж за период».
2. В панели сверху укажите период, контрагента.
3. Нажмите «Сформировать» – данные обновятся, а диаграмма (BAR) отобразит визуализацию.

Любой проведённый или сохранённый документ можно распечатать. Печатная форма формируется на основе шаблона (описывается в DSL).

• Автоматическая нумерация строк.
• Итоги по колонкам (ИТОГ).
• Сумма прописью на русском языке (рубли + копейки).
• Подписи с линией для подписания.

Пример вывода суммы: «одна тысяча двести пятьдесят рублей 50 копеек».

Конфигуратор доступен только администратору (admin). Позволяет изменять структуру системы без программирования на Go.

Возможности DSL:

• Создавать документы (шапка + табличные части, движения по регистрам).
• Определять коллекции (справочники) с произвольными полями.
• Настраивать отчёты с параметрами, группировками и визуализацией.
• Задавать роли и права доступа.
• Настраивать глобальные параметры: тема оформления, нумерация документов, плотность интерфейса.

Пример описания документа в DSL

ДОКУМЕНТ Приход
    РЕГИСТР ДокументыПрихода
    ПОЛЕ Дата ДАТАВРЕМЯ
    ПОЛЕ Номер СТРОКА
    ПОЛЕ Контрагент ВЫБОР Контрагенты
    ТАБЛИЧНАЯЧАСТЬ Товары
        ПОЛЕ Номенклатура ВЫБОР Товары
        ПОЛЕ Количество ЧИСЛО
        ПОЛЕ Цена ЧИСЛО
        ПОЛЕ Сумма ЧИСЛО
    КОНЕЦ
    ДВИЖЕНИЕ Остатки Товары ПРИХОД
КОНЕЦ

После сохранения конфигурации система перезагружает модель — изменения вступают в силу мгновенно.

Роли описываются в DSL и определяют, какие действия разрешены для объектов:

• документ – чтение, запись, проведение
• отчёт / таблица / коллекция – просмотр
• конфигуратор – доступ к настройкам

Пример роли «Менеджер»:

РОЛЬ Менеджер
    ПРАВО документ Приход: чтение, запись, проведение
    ПРАВО документ Расход: чтение, запись, проведение
    ПРАВО отчет *: просмотр
КОНЕЦ

Администратор может добавлять/удалять пользователей через интерфейс администрирования или напрямую в DSL.