Přeskočit obsah

AVAX Legal — programátorská příručka

Audience: vývojáři AVAX + vendoři, kteří konzumují právní data (apm, apz, app-stavebni).

Repo: git.avaxis.cz/avax-apps/app-legal (monorepo: backend/ + client/desktop/ + client/web/ + libs/formula_engine/). Produktová spec (AVAX): spec/avax-legal.md.

AVAX Legal není „AI chatbot nad PDF". Je to deterministická, auditovatelná, time-travel kalkulačka nad reálným právním textem: extrahuje české zákony + prováděcí předpisy z e-Sbírky → korpus (strom uzlů) → spustitelné vzorce a proměnné (OpenFisca-destilované) → propojené grafy s klikací provenience na konkrétní §.

Vedle vlastní aplikace (čtenář zákonů + Explorer + AI výklad) je app-legal content supply backbone pro ostatní AVAX appky — dodává jim právní pravdu přes konektory a S3 supply.

Co najdete kde

Stránka Obsah
Architektura End-to-end pipeline, event-sourcing + OpenFisca destilace, dvourychlostní AI, dvoumotorová interpretace, korpusová struktura, provenience
Konektory legal-search, legal-author, legal-corpus, legal-stavebni (provides) + consumes (ai-*, ipc, theme)
API Referenční přehled REST endpointů (přes apps-gateway /apps/app-legal/*)
Supply S3 supply avaxlegal/ — apm (text), stavebni (strukturovaná data), apz (formule): temporal + checksum kontrakt

Tech stack

Vrstva Technologie
Backend Python 3.13, FastAPI (standalone avax_legal_backend.standalone:app, port 8101)
DB PostgreSQL 16, schema legal, pgvector (embeddings bge-m3, 1024 dim)
Migrace Alembic (backend/alembic/, head 0049+)
Async Celery worker (extrakce, embed backfill)
Scraping Playwright Firefox (live e-Sbírka)
Výpočty libs/formula_engine (avax_legal_formula, sympy DSL)
AI přes konektory ai-chat / ai-chat-async / ai-embed / ai-rag-* → app-ai-helper (M2M)
Klient desktop Python customtkinter (.exe), lokální SQLite cache
Klient web Next.js (standalone, avaxdev :3000)

Zdrojové specifikace (vendor repo)

Detailní specifikace žijí v repo app-legal/docs/spec/ (nejsou public). Master přehled: avax-legal-master-plan.md (AUTHORITATIVE, sceluje 12+ dílčích speců). Klíčové:

  • avax-legal-corpus-structure.md — makro-hierarchie, prameny, provenience (§-level), věcný rejstřík
  • avax-legal-esbirka-import.md — import pipeline (e-Sbírka REST → TreeNode)
  • avax-legal-references.md / -souvislosti.md — cross-link graf (ELI, souvislosti law↔law)
  • avax-legal-variables.md / -formulas.md — OpenFisca Variables + Parameters + Formula
  • avax-legal-data-fields.md — rodina E (údaje / datová pole, 1:N kotvy na zákon)
  • avax-legal-dual-engine-interpretation.md — MAX(Claude) + LLM(qwen) výklad
  • avax-legal-apm-supply.md / -stavebni-supply.md / -apz-supply.md — supply kontrakty

Související (platforma)