RAG-POC/docs
GAJ3T 82a5a0e557 docs updated 2026-10-15 10:20:38 -04:00
..
diagrams docs updated 2026-10-15 10:20:38 -04:00
README.md docs updated 2026-10-15 10:20:38 -04:00
api.md docs updated 2026-10-15 10:20:38 -04:00
architecture.md docs updated 2026-10-15 10:20:38 -04:00
configuration.md docs updated 2026-10-15 10:20:38 -04:00
data-model.md docs updated 2026-10-15 10:20:38 -04:00
module-reference.md docs updated 2026-10-15 10:20:38 -04:00
operations.md docs updated 2026-10-15 10:20:38 -04:00
overview.md docs updated 2026-10-15 10:20:38 -04:00
runbook.md docs updated 2026-10-15 10:20:38 -04:00
source-contract.md docs updated 2026-10-15 10:20:38 -04:00
testing.md docs updated 2026-10-15 10:20:38 -04:00

README.md

KnowledgeGraph GraphRAG documentation

This folder is the operational and technical reference for the KnowledgeGraph GraphRAG proof of concept. The repository README remains the shortest getting started path; these documents explain the contracts behind it.

Read this first

Document Use it for
System overview Scope, boundaries, stage flow, and key design decisions
Architecture Runtime topology, stage contracts, persistence, and retrieval
Runbook Step-by-step local setup, ingestion, rebuilds, recovery, and shutdown
Configuration Environment variables, defaults, and production guidance
Source contract JSONL and PostgreSQL handoff schemas
API reference Internal endpoints, JWT claims, permissions, and examples
Data model Checkpoint tables and stage ownership
Testing Test commands, prerequisites, and performance checks
Operations and troubleshooting Logs, health checks, failures, retries, and known limitations
Module reference Python modules, stage entry points, and responsibilities

C4 diagrams

The diagrams are editable in diagrams.net/draw.io.

C4 level Diagram
Context c4-context.drawio
Container c4-container.drawio
Component c4-component.drawio
Code c4-code.drawio

Documentation scope

The documentation is based on the implementation, tests, migration, Compose definition, CI workflow, templates, and repository README. It documents current behavior rather than promising features that are not implemented. In particular:

  • source collection is external to this repository;
  • stages 1-8 are durable worker jobs;
  • query and answer are synchronous API/stage operations;
  • PostgreSQL with PgVector is the deployment target;
  • SQLite is supported for isolated tests, not production retrieval;
  • LLM output is schema-validated but not independently fact-checked.