mono/components/factory

📄 @coopenomics/factory

Фабрика документов кооператива — библиотека для генерации юридически значимых документов (PDF). Объединяет шаблоны из блокчейна, приватные данные из хранилища и рендерит HTML через Handlebars/Nunjucks с последующей генерацией PDF через WeasyPrint.

Основные возможности

• Более 60 шаблонов юридических документов (заявления, протоколы, решения, договоры, акты)
• Рендеринг HTML из шаблонов Handlebars и Nunjucks
• Генерация PDF через WeasyPrint
• Валидация данных по JSON Schema
• Электронная подпись документов через EOSIO-ключи
• Хранение документов и метаданных в MongoDB
• Сборка как ES-модуль и CommonJS (unbuild)

Установка

Компонент является частью монорепозитория. Установка зависимостей из корня проекта:

pnpm install

Или только для этого компонента:

pnpm install --filter @coopenomics/factory

Системные зависимости

Для генерации PDF необходим WeasyPrint.

Скрипты

Скрипт	Команда	Описание
build	pnpm run build	Сборка библиотеки (unbuild)
dev	pnpm run dev	Режим разработки с автопересборкой (nodemon)
test	pnpm run test	Запуск тестов (Vitest)
lint	pnpm run lint	Проверка кода (ESLint)
typecheck	pnpm run typecheck	Проверка типов TypeScript
setup-indexes	pnpm run setup-indexes	Настройка индексов MongoDB

Из корня монорепозитория:

pnpm run build:lib       # Сборка factory + cooptypes
pnpm run dev:lib         # Режим разработки factory + cooptypes
pnpm run test:component  # Компонентные тесты factory

Конфигурация

Для тестирования и локальной работы необходимо подключение к MongoDB. Переменные окружения:

• MONGO_URI — строка подключения к MongoDB
• SOURCE — источник данных (local для тестов)

Подробное описание переменных — в файле .env-example.

Тестирование

SOURCE=local NODE_ENV=test pnpm --filter @coopenomics/factory run test

Тестовый набор покрывает генерацию документов различных типов. Тесты требуют запущенный MongoDB и используют таймаут 240 секунд.

Файлы тестов:

Файл	Описание
test/index.test.ts	Основные тесты генерации документов
test/wallet.test.ts	Тесты документов кошелька
test/meet.test.ts	Тесты документов собраний
test/blagorost.test.ts	Тесты документов программы «Благорост»
test/market.test.ts	Тесты документов маркетплейса
test/search.test.ts	Тесты поиска документов
test/udata.test.ts	Тесты пользовательских данных
test/documents-1000-plus.test.ts	Тесты документов с registry_id > 1000

Архитектура

src/
├── index.ts               # Точка входа библиотеки
├── config.ts              # Конфигурация подключений
├── Actions/               # Генераторы документов (по registry_id)
│   ├── 1.WalletAgreement.ts
│   ├── 100.ParticipantApplication.ts
│   ├── 300.AnnualGeneralMeetingAgenda.ts
│   ├── 600.FreeDecision.ts
│   ├── 1001.GenerationContract.ts
│   └── ...                # Более 60 шаблонов
├── Factory/               # Ядро фабрики документов
├── Models/                # Модели данных MongoDB
│   ├── Cooperative.ts
│   ├── Individual.ts
│   ├── Organization.ts
│   ├── Document.ts
│   └── ...
└── templates/             # HTML-шаблоны (Nunjucks/Handlebars)
test/                      # Тесты (Vitest)

Процесс генерации документа

1. Загрузка шаблона и JSON Schema из блокчейна
2. Получение приватных данных из хранилища (MongoDB)
3. Валидация данных по JSON Schema (Ajv)
4. Конструирование контекста для шаблона
5. Рендеринг HTML из Nunjucks/Handlebars-шаблона
6. Подпись хеша документа EOSIO-ключом
7. Генерация PDF через WeasyPrint

Ключевые зависимости

• nunjucks / handlebars — шаблонизаторы
• ajv — валидация JSON Schema
• mongodb — хранилище данных
• eosjs-ecc — криптографические операции EOSIO
• pdf-lib — работа с PDF
• unbuild — сборка библиотеки

Лицензия

BY-NC-SA 4.0