dg-node

# dg-node

Поиск и ридер текстов Пали-канона (SuttaCentral Bilara + переводы проекта DhammaGift). Node.js (Fastify в проде, Express — старый сервер), самодостаточный — всё, что фронтенд реально запрашивает из `/assets/...` (jQuery, Bootstrap, DataTables, словарь DPD, картинки кнопок, тулзы мультитула), лежит в `public/overrides/`; `siteroot/assets/` (symlink на легаси-репо) остаётся только запасным маунтом для того, чего в `public/overrides/` нет (тяжёлые PDF/аудио, тексты).

Архитектура и правила разработки — см. [CLAUDE.md](CLAUDE.md).

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

```bash
git pull
npm install
npm run build-search-db   # собрать dg.db (SQLite/FTS5) из свежих Bilara-данных
npm start                 # запустить прод-сервер (dg-fastify.js), порт 3000
```

`build-search-db` нужно перезапускать при изменении исходных текстов/переводов на диске — сервер каждый раз читает только уже собранный `dg.db`, не сканирует диск заново.

Пути к данным (`SC_BILARA`, `DG_OFFLINE`, офлайн-зеркала) определяются автоматически по окружению (Termux / Windows-разработка / Linux-прод).

`unused/dg-light.js`/`unused/dblight.js` (`npm run start:express`) — старый Express+grep
сервер, legacy, в проде не используется (см. CLAUDE.md).

## Проверка после деплоя/обновления

```bash
curl "http://localhost:3000/search?q=kacchapa&scope=dhamma&langs=ru,en"
curl -I "http://localhost:3000/assets/js/datatables/datatables.min.js"   # 200 из public/overrides/js/datatables, не из легаси-репо
curl -I "http://localhost:3000/dn22"                                  # ридер по чистому URL
curl -I "http://localhost:3000/dn22:10.5"                             # сегментная ссылка (скролл к 10.5)
```

Глазами в браузере:
- `/nodejs/res/?q=kacchapa&scope=dhamma` — поиск, DataTables, экспорт.
- `/dn22` — ридер, полный текст.
- Переключатель Pāḷi/Рус (три режима: пали+перевод → только пали → только перевод) — должен реально прятать текст (проверять `getComputedStyle(el).display`), а не только менять CSS-класс.
- `/?q=dn22#12.1` (старый формат) — должен продолжать работать наравне с `/dn22:12.1`.

## Важно при деплое за Apache/PHP

Если публичный dhamma.gift сейчас обслуживается Apache/PHP, а Node — отдельный бэкенд, проксируемый только на `/search`, то новые роуты (`/`, `/dn22`, `/assets/*`, `/api/text/*`) снаружи видны не будут, пока правила проксирования не расширят на эти пути тоже. Легаси-репозиторий (`/c/soft/dg` в деве, соответствующий путь в проде) при этом не трогаем — правим только конфиг проксирования.

## Структура

```
dg-fastify.js         — прод-сервер (Fastify + SQLite/FTS5, dg.db): /search, /api/text/:suttaId,
                        статика (search/, reader/, siteroot/assets/), офлайн-зеркала,
                        чистые URL (/dn22, /dn22:12.1)
unused/dg-light.js    — legacy Express+grep сервер, в проде не используется (см. CLAUDE.md)
unused/dblight.js     — билд-скрипт dg-light.js → dg_db_light.json (легаси, не нужен dg.db)
search/               — страница поиска (DataTables); URL остался /nodejs/res/... (см. CLAUDE.md)
reader/               — ридер (reader-template.html + megareader.js)
configs/              — json-конфиги проекта (openapi, reader/*, search/*), см. CLAUDE.md
docs/                  — документация не для каждой сессии (SPA-планы, backward compat)
siteroot/             — публикация от корня сайта: assets/ (легаси-ассеты), 4nt/config/login/
                        memo/read (легаси-тулзы), см. CLAUDE.md
```