betelgeusebytes/ROADMAP.md

Roadmap & Next Steps

Phase 1 – Knowledge Modeling

• Design Neo4j isnād schema
• Identity resolution
• Relationship typing

Phase 2 – Authenticity Scoring

• Chain continuity analysis
• Narrator reliability
• Graph‑based scoring
• LLM‑assisted reasoning

Phase 3 – Productization

• Admin dashboards
• APIs
• Provenance visualization

Phase 4 – Scale & Extend

• GPU nodes
• vLLM integration
• Multi‑project tenancy

sequenceDiagram
  autonumber
  participant User as User/Client
  participant Admin as Admin UI (optional)
  participant KC as Keycloak (OIDC)
  participant OR as Orchestrator (FastAPI)
  participant TEI as TEI Embeddings
  participant QD as Qdrant
  participant N4 as Neo4j
  participant LLM as LLM (Ollama/llama.cpp)
  participant PG as Postgres
  participant S3 as MinIO (S3)

  User->>Admin: Open app / submit query (optional)
  Admin->>KC: OIDC login
  KC-->>Admin: ID/Access token
  Admin->>OR: Request + Bearer token

  OR->>KC: Verify token / JWKS
  KC-->>OR: OK

  OR->>PG: Load user/session/config
  PG-->>OR: context

  OR->>TEI: Embed query/text
  TEI-->>OR: vector

  OR->>QD: Vector search (hadith/bios)
  QD-->>OR: top-k passages/IDs

  OR->>N4: Graph query (narrator chain / relations)
  N4-->>OR: chain/edges

  OR->>LLM: Prompt + retrieved context + schema
  LLM-->>OR: JSON extraction / reasoning result

  OR->>S3: (optional) store artifacts/provenance
  S3-->>OR: stored

  OR-->>Admin: Response (JSON + citations/provenance)
  Admin-->>User: Render result + review tools