Butkhuzi Setup (SNIP Norms Source)

Preferred ingestion path is deterministic parser (xlsx -> JSON payload -> upsert). Use RAG/chunking only for semantic search and assistant UX, not as source-of-truth ingest.

Multilingual fields

butkhuzi_norms supports localized titles via title_i18n JSON map.

Upsert payload row can include:

{
  "title": "Основной заголовок",
  "titleI18n": {
    "ru": "Основной заголовок",
    "en": "Primary heading",
    "ka": "ძირითადი სათაური"
  }
}

Component rows can also include localized labels via components[].labelI18n.

1. Preconditions

• PostgreSQL running on 127.0.0.1:5432
• API services running (services/api and services/svc-tenders)
• Python 3 available (openpyxl is required for XLSX parser)