knowledge center · index

GitHub is the database — this is the catalog

Every authoritative document lives at github.com/RavivKvisi/kvisi-backend. The dashboard is a derived view over that source — never a second copy. Source rows open the canonical doc on GitHub; view rows open an operational view inside the app.

9 numbered docs8 ADRs10 research artifacts

Foundation

What we are building, why, against what legacy.

Overviewdocs/00-OVERVIEW.mdsource

What / why / non-negotiables.

Legacy systemdocs/01-LEGACY-SYSTEM.mdsource

~350 endpoints · ~130 tables · 80+ SPs · 12 external integrations.

Target architecturedocs/02-TARGET-ARCHITECTURE.mdsource

NestJS modular monolith on ECS Fargate + Async Workers on Lambda+SQS.

Migration plandocs/03-MIGRATION-PLAN.mdsource

Strangler-fig + traffic-replay + per-endpoint feature flags + Debezium CDC.

API inventorydocs/08-API-INVENTORY.mdsource

13 bounded contexts · ~325 endpoints with keep/rename/deprecate verdicts.

Process

How we work day-to-day. Binding rules.

AI orchestrationdocs/04-AI-ORCHESTRATION.mdsource

3 loops · 6-8 agent hierarchical swarm · Raft consensus · agent roster.

Methodologydocs/05-METHODOLOGY.mdsource

Strangler · ACL · contract-first · replay-diff · DDD.

Coding styledocs/07-CODING-STYLE.mdsource

FP/DDD-strict · neverthrow + Remeda + ts-pattern · 9 binding rules.

Reference

Open questions, glossaries, decisions.

Open questionsdocs/06-OPEN-QUESTIONS.mdsource

16 questions · Q1–Q5 blocking · Q10 legal (residency).

—

Glossary/glossaryview

40+ technical terms · grouped by category · searchable.

—

Decisions (ADRs)/decisionsview

4 accepted · 1 superseded · 2 partial · 1 stub. ADR-0008 is the remaining P0 blocker.

Research

Synthesis docs — debate outcomes, breadth surveys, cross-checks.

—

Octopus debate · over-engineeringdocs/research/octo-debate-over-engineering.mdsource

4-way debate · Round 1+2 + synthesis. Drove the 2026-05-13 sweep.

—

AI orchestration researchdocs/research/ai-orchestration-research.mdsource

Patterns for 3-loop AI dev with foreground / Ralph / cron watchers.

—

AI/RAG-ready on AWSdocs/research/ai-rag-ready-on-aws.mdsource

pgvector vs OpenSearch vs S3 Vectors economics. (Superseded by ADR-0004.)

—

Octopus · when to usedocs/research/octopus-when-to-use.mdsource

Scenarios + anti-patterns + provider mix defaults.

—

Architecture cross-checkdocs/research/review-architecture-bestpractice.mdsource

Best-practice review · §5 blockers feeding ADRs.

—

Domain cross-checkdocs/research/review-domain-crosscheck.mdsource

Bounded context corrections post-review.

—

Migration patterns researchdocs/research/migration-patterns-research.mdsource

Strangler / dual-write / CDC / diff comparator patterns.

—

IA Audit · Round 1apps/migration-dashboard/IA-AUDIT.mdsource

Information architecture audit of the dashboard itself.

—

IA Audit · Round 2 (Surfaces)apps/migration-dashboard/IA-SURFACES.mdsource

Control + Knowledge surface design — what is clickable, what is not.

—

OSS dashboard alternativesapps/migration-dashboard/RESEARCH-ALTERNATIVES.mdsource

Verdict: keep building. Integrate Tremor + EventCatalog schema + Langfuse at Phase 2.