О приложении
Это веб-приложение позволяет создавать и редактировать макеты этикеток, а также генерировать PDF-файлы для печати на термопринтерах.
Возможности приложения
- Создание и редактирование макетов этикеток с помощью визуального редактора
- Добавление различных элементов: текст, изображения, штрихкоды
- Сохранение и загрузка макетов
- Генерация PDF-файлов из макетов с возможностью замены переменных данными
- Печать этикеток на термопринтерах различных производителей
- Поддержка различных размеров этикеток (по умолчанию 58×40 мм)
API приложения
Методы API для работы с макетами
-
GET /api/layouts - получить список всех доступных макетов
- Входные параметры: нет
- Выходные параметры: массив объектов, каждый из которых содержит:
- name: имя макета без расширения
- filename: полное имя файла макета
- createdAt: дата и время последнего изменения файла
- Пример ответа:
[ { "name": "med", "filename": "med.json", "createdAt": "2025-12-18T07:35:34.123Z" } ]
-
GET /api/layouts/:filename - получить содержимое конкретного макета
- Входные параметры:
- filename: имя файла макета (например, med.json)
- Выходные параметры: JSON-объект с содержимым макета
- Возможные ошибки:
- 400: Не указано имя файла или недопустимое имя файла
- 404: Файл макета не найден
- 500: Ошибка сервера при загрузке макета
- Входные параметры:
-
POST /api/layouts/save - сохранить новый или обновить существующий макет
- Входные параметры:
- name: имя макета (без расширения)
- layoutData: JSON-объект с данными макета
- Выходные параметры:
- message: сообщение об успешном сохранении
- filename: имя сохраненного файла
- Возможные ошибки:
- 400: Отсутствуют обязательные параметры или недопустимое имя файла
- 500: Ошибка сервера при сохранении макета
- Входные параметры:
-
DELETE /api/layouts/:filename - удалить макет
- Входные параметры:
- filename: имя файла макета для удаления
- Выходные параметры:
- message: сообщение об успешном удалении
- Возможные ошибки:
- 400: Не указано имя файла или недопустимое имя файла
- 404: Файл макета не найден
- 500: Ошибка сервера при удалении макета
- Входные параметры:
-
POST /api/generate-pdf - сгенерировать PDF из макета с заменой переменных переданными данными
- Входные параметры:
- template: имя шаблона (без расширения)
- data: объект с данными для замены переменных в шаблоне
- Выходные параметры: файл PDF с именем шаблона в качестве вложения
- Возможные ошибки:
- 400: Отсутствует имя шаблона или данные не являются объектом
- 404: Макет не найден
- 500: Ошибка сервера при генерации PDF
- Входные параметры:
Основной маршрут с параметрами
-
GET / - основная страница приложения с поддержкой параметров
- Входные параметры (в URL строке):
- template: имя шаблона для загрузки (например, med)
- все остальные параметры будут переданы в шаблон для замены на их значения
- Пример использования:
http://localhost:3000/?template=med&sort=льняной&about=полезный - Функциональность: позволяет загружать определенный шаблон при открытии приложения и передавать дополнительные параметры для настройки интерфейса
- Входные параметры (в URL строке):