Система генерации базовых документов кооператива.

Монорепозиторий для автоматизации генерации базовых документов кооператива с использованием DOCX шаблонов.

Структура проекта

├── apps/
│   ├── frontend/          # Next.js веб-интерфейс
│   └── backend/           # Express.js API
├── packages/
│   └── shared/            # Общие типы и утилиты
├── data/                  # DOCX шаблоны
└── temp/                  # Временные файлы генерации

Установка и запуск

Предварительные требования

• Node.js 18+
• pnpm (рекомендуется)

Установка зависимостей

pnpm install

Запуск в режиме разработки

# Запуск всех приложений
pnpm dev

# Запуск только backend
pnpm dev:backend

# Запуск только frontend
pnpm dev:frontend

Сборка

# Сборка всех пакетов
pnpm build

# Сборка отдельных пакетов
pnpm build:shared
pnpm build:backend
pnpm build:frontend

Использование

Режимы работы

1. Пакет подключения - генерация 8 документов для подключения к кооперативу
2. Новый кооператив - генерация Устава и Протокола №1 для создания нового кооператива

API Endpoints

• POST /api/cooperative/connection-package - Генерация пакета подключения
• POST /api/cooperative/new-cooperative - Генерация документов нового кооператива
• GET /api/download/:folderName - Скачивание сгенерированных документов

Веб-интерфейс

Доступен по адресу http://localhost:3001 после запуска frontend.

Разработка

Добавление новых типов

Общие типы добавляются в packages/shared/src/document.types.ts

Добавление новых утилит

Общие утилиты добавляются в packages/shared/src/utils.ts

Обновление шаблонов

DOCX шаблоны находятся в папке data/

Технологии

• Frontend: Next.js 14, TypeScript, Tailwind CSS
• Backend: Express.js, TypeScript
• Генерация: docxtemplater, pizzip, libreoffice-convert
• Монорепозиторий: pnpm workspaces

Лицензия

Продукт Потребительского Кооператива "ВОСХОД" распространяется по лицензии BY-NC-SA 4.0.

Разрешено делиться, копировать и распространять материал на любом носителе и форме, адаптировать, делать ремиксы, видоизменять и создавать новое, опираясь на этот материал. При использовании, Вы должны обеспечить указание авторства, предоставить ссылку, и обозначить изменения, если таковые были сделаны. Если вы перерабатываете, преобразовываете материал или берёте его за основу для производного произведения, вы должны распространять переделанные вами части материала на условиях той же лицензии, в соответствии с которой распространяется оригинал. Запрещено коммерческое использование материала. Использование в коммерческих целях – это использование, в первую очередь направленное на получение коммерческого преимущества или денежного вознаграждения.

Юридический текст лицензии: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ru