Фабрика документов кооператива — библиотека для генерации юридически значимых документов (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)

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

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

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

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

Лицензия

BY-NC-SA 4.0

README.md Unescape Escape

📄 @coopenomics/factory