animarum

Индексированные данные исторических документов (исповедные ведомости) с отображением по шифрам дел и архивным листам.

Быстрый старт

1. Скопируйте Google API credentials в .env.local (см. переменные ниже).
2. Установите зависимости и загрузите данные:

npm install
npm run prebuild
npm run dev

Приложение будет доступно на http://localhost:4003.

Документация процесса

Подробное описание архитектуры, ETL, маршрутов, границ модулей и чеклистов для рефакторинга и обновлений:

docs/PROCESS.md — придерживаться этого документа при изменениях.

Переменные окружения

Переменная	Назначение
PROJECT_ID или GAPI_PROJECT_ID	Google Cloud project
ANIMARUM_SPREADSHEET_ID	ID Google-таблицы с данными
GAPI_CREDENTIALS_PRIVATE_KEY	OAuth private key / client secret
GAPI_CREDENTIALS_CLIENT_SECRET	OAuth client secret
GAPI_CREDENTIALS_REFRESH_TOKEN	OAuth refresh token
GAPI_CREDENTIALS_CLIENT_EMAIL	OAuth client email
GAPI_CREDENTIALS_CLIENT_ID	OAuth client ID

Кратко об архитектуре

• npm run prebuild — загрузка Google Sheet → ETL → public/data/*.json
• npm run build — SSG страниц из JSON (prebuild запускается автоматически)
• Главная: список шифров (фонд / опись / дело)
• /[slug]/[pageSlug]/ — семьи на конкретном архивном листе