46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# 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](./overview.md) | Scope, boundaries, stage flow, and key design decisions |
|
|
| [Architecture](./architecture.md) | Runtime topology, stage contracts, persistence, and retrieval |
|
|
| [Runbook](./runbook.md) | Step-by-step local setup, ingestion, rebuilds, recovery, and shutdown |
|
|
| [Configuration](./configuration.md) | Environment variables, defaults, and production guidance |
|
|
| [Source contract](./source-contract.md) | JSONL and PostgreSQL handoff schemas |
|
|
| [API reference](./api.md) | Internal endpoints, JWT claims, permissions, and examples |
|
|
| [Data model](./data-model.md) | Checkpoint tables and stage ownership |
|
|
| [Testing](./testing.md) | Test commands, prerequisites, and performance checks |
|
|
| [Operations and troubleshooting](./operations.md) | Logs, health checks, failures, retries, and known limitations |
|
|
| [Module reference](./module-reference.md) | Python modules, stage entry points, and responsibilities |
|
|
|
|
## C4 diagrams
|
|
|
|
The diagrams are editable in [diagrams.net/draw.io](https://app.diagrams.net/).
|
|
|
|
| C4 level | Diagram |
|
|
|---|---|
|
|
| Context | [c4-context.drawio](./diagrams/c4-context.drawio) |
|
|
| Container | [c4-container.drawio](./diagrams/c4-container.drawio) |
|
|
| Component | [c4-component.drawio](./diagrams/c4-component.drawio) |
|
|
| Code | [c4-code.drawio](./diagrams/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.
|
|
|