| Metadata | Value |
|---|---|
| Status | Active |
| Version | 1.0.0 |
| Last Updated | 2026-09-10 |
| Author | Sangeetha Grantha Team |
Every Markdown page in the application documentation is listed here by area. Current guide and Navigation lead to maintained behavior; Design reference may contain future scope; Evidence record and Archive preserve dated observations; Decision record retains architectural rationale. Review lifecycle context before following historical commands.
| Document | Reading context | |:—|:—| | Documentation maintenance | Navigation | | Current Technology Versions | Current guide | | Documentation refresh — September 2026 | Evidence record | | Documentation and Diagram Updates – January 2026 | Evidence record | | Documentation Updates Summary 2026-02 | Evidence record | | Documentation Guardian Audit & Repair (Feb 2026) | Evidence record | | Sangita Grantha Documentation Audit Report | Evidence record | | Documentation Cleanup Checklist (2026-01-30) | Evidence record | | Documentation Audit and Cleanup | Evidence record | | Sangita Grantha Documentation Quality Evaluation Report | Evidence record | | Documentation Scan Observations (2026-01-30) | Evidence record | | Sangeetha Grantha: Complete Engineering Evolution | Evidence record | | Admin authentication | Current guide | | Documentation Reorganization - January 19, 2026 | Evidence record | | Documentation Retention and Archiving Plan | Current guide | | Documentation Standards | Current guide | | Track Closure Report: 2026-02-02 | Evidence record |
| Document | Reading context | |:—|:—| | Onboarding | Navigation | | Get started locally | Current guide | | IDE and editor setup | Current guide | | Troubleshooting local development | Current guide |
| Document | Reading context | |:—|:—| | Product and domain requirements | Navigation | | Curator Console requirements | Navigation | | Curator Console — product requirements | Current guide | | Sangita Grantha Domain Model Overview | Current guide | | Feature map | Navigation | | Advanced Krithi Notation & AI Transliteration | Design reference | | Krithi Bulk Import from CSV - Comprehensive Strategy & Design | Design reference | | Koog Framework Evaluation for Import Pipeline | Design reference | | Bulk Import Master Analysis | Design reference | | Composer Deduplication – Implementation Summary | Evidence record | | Kshetra & Temple Mapping – Implementation Summary | Evidence record | | Multi-Language Lyric Extraction and Scraping Robustness – Implementation Summary | Evidence record | | Scraping Robustness and Refactor Implementation (TRACK-032) | Evidence record | | Ingestion architecture and operating guide | Current guide | | TextBlocker Parsing Fix Implementation | Evidence record | | Web Source Detailed Analysis for Krithi Import | Design reference | | Import compositions from source material | Navigation | | Python vs Existing Technical Capabilities - Analysis | Archive | | Bulk Import Documentation Consolidation Summary | Archive | | Krithi Bulk Import: Detailed Strategy & Design | Archive | | Bulk Import Orchestration & Ops Plan | Archive | | Koog Evaluation for Import Pipeline - Detailed Analysis | Archive | | Koog Integration Analysis and Options | Archive | | Koog Technical Integration Proposal | Archive | | Krithi Bulk Import Capability & Koog Integration Analysis | Archive | | Krithi Bulk Import Capability - Comprehensive Analysis | Archive | | Krithi Bulk Import from CSV - Comprehensive Strategy & Design | Archive | | Krithi Data Import and Orchestration - Comprehensive Analysis | Archive | | Krithi Import Orchestration – Comprehensive Analysis & Strategic Recommendations | Archive | | Update Summary: Guru-Guha Blogspot Source Correction | Archive | | Bulk Import UI/UX Plan | Design reference | | Bulk Import Documentation Consolidation Plan | Design reference | | Commit Guardrails and Workflow Enforcement System | Design reference | | Cross-Platform Development Environment Standardisation | Design reference | | Database Layer Optimization & Modernization | Design reference | | Documentation Integrity and Standards Enforcement | Design reference | | GCP Implementation Strategy: Serverless & Scalable | Design reference | | Intelligent Web Scraping and Domain Mapping | Design reference | | Global Scale Architecture Proposal: Sangeetha Grantha | Design reference | | Feature: Graph Explorer | Design reference | | Feature Request: Intelligent Content Ingestion & Musicological Validation Suite | Design reference | | Feature: Searchable Deity and Temple Management with Modal Forms | Design reference | | Sangita Grantha Glossary | Current guide | | Source quality and ingestion design | Navigation | | Implementation Checklist — Krithi Data Sourcing & Quality Strategy | Design reference | | PDF Diacritic Extraction Analysis — Garbled Encoding Recovery for Raga, Tala, and Section Metadata | Design reference | | Source quality and curation strategy | Current guide | | Sourcing & Extraction Monitoring — UI/UX Plan | Design reference | | Rasika requirements | Navigation | | Rasika — mobile product requirements | Current guide | | Rasika Mobile App — Minimal Working Release | Current guide | | Musicology Reviews | Navigation | | Musicological Review — viSva nAthaM bhajEhaM (Sri Visvanatham) | Musicology review | | Sangeetha Grantha — product requirements | Current guide | | Tech Debt | Navigation | | Tech Debt: Reference Data Repository Refactoring | Design reference |
| Document | Reading context |
|:—|:—|
| Architecture | Navigation |
| System architecture | Current guide |
| Architectural Proposal: Centralized Extraction Service (Python UEE) | Decision record |
| ADR-001: Spec-Driven Documentation Architecture | Decision record |
| ADR-002: Frontend Architecture Decision - React vs Kotlin/JS | Decision record |
| ADR-003: Database Migration Tool Choice - Rust vs Flyway | Decision record |
| ADR-004: Authentication Strategy - JWT with Role-Based Access Control | Decision record |
| ADR-005: Graph Database Strategy (PostgreSQL vs Neo4j) | Decision record |
| ADR-006: Integration of Google Gemini for Content Ingestion and Validation | Decision record |
| ADR-007: Exposed ORM Selection (Kotlin DSL) | Decision record |
| ADR-008: Dependency Injection with Koin | Decision record |
| ADR-009: Bulk Import Orchestration Architecture | Decision record |
| ADR-010: Migration Tool Course Correction — Rust CLI to Python db-migrate + Makefile | Decision record |
| ADR-011: PostgreSQL 18 Upgrade with UUID v7 Adoption | Decision record |
| ADR-012: Unified Extraction Architecture — Python as Single Source of Truth | Decision record |
| ADR-013: Database Migrations with Flyway — Standardizing the Migration Engine | Decision record |
| ADR-014: Versioned Canon & Provenance Graph (N5) | Decision record |
| ADR-015: Structure-Aware Extraction Adapter for the Govindan Blog Family | Decision record |
| ADR-016: Raga Naming Authority & Canonical Reference Data | Decision record |
| ADR-017: Raga Reference Entity Identity & Resolution | Decision record |
| Decisions | Decision record |
| Architectural Decision Records Index | Decision record |
| Decision: Standardization on kotlin.time.Instant | Decision record |
| Exposed ORM: DAO vs DSL Approach - Comprehensive Comparison | Decision record |
| Exposed DSL Optimization: Fixing DELETE+INSERT Anti-Pattern | Decision record |
| Architecture diagrams | Navigation |
| System context and components | Current guide |
| Data relationship diagrams | Current guide |
| Application flows | Current guide |
| Google Cloud Scaling Strategy (Cost-Effective, Global) | Design reference |
| Target Scale Architecture (Multi-Region) — Roadmap-Focused | Design reference |
| Sangeetha Grantha: Architecture Evaluation & Scaling Strategy | Design reference |
| Technology stack and ownership | Current guide |
| Document | Reading context | |:—|:—| | API guides | Navigation | | API contract | Current guide | | API request examples | Current guide | | Auth & OTP – Canonical | Design reference | | Client integration guide | Current guide | | OpenAPI and implementation synchronization | Current guide | | Catalogue search | Current guide | | UI-to-API map | Current guide |
| Document | Reading context | |:—|:—| | Database and provenance | Navigation | | Audit events and content history | Current guide | | Flyway migrations and reference data | Current guide | | Raga identity and curator resolution | Current guide | | Schema & API Alignment (Sangita Grantha) | Design reference | | Database schema guide | Current guide | | Versioned canon and provenance | Current guide |
| Document | Reading context | |:—|:—| | Client applications | Navigation | | Curator Console | Navigation | | Curator Console guide | Current guide | | Rasika mobile implementation | Navigation | | Rasika: a living library of Carnatic music | Current guide | | Rasika visual design | Current guide | | Mobile UI Specification (KMP) | Design reference | | Frontend UI Libraries | Design reference |
| Document | Reading context | |:—|:—| | Backend engineering | Navigation | | Exposed 1.0.0 Features Testing | Design reference | | Mutation handling and audit boundaries | Current guide | | Query Optimization Evaluation: Krithi UPDATE Operations | Design reference | | Backend security and visibility requirements | Current guide | | Steel Thread Implementation | Design reference |
| Document | Reading context | |:—|:—| | API Coverage Report | Evidence record | | Quality and verification | Navigation | | API Coverage Gap Implementation Plan | Evidence record | | Broken Tests Remediation Plan | Evidence record | | Bulk Import Fixes - Implementation Plan | Evidence record | | Frontend-Backend API Coverage Report | Evidence record | | Implementation Summary: Frontend E2E Testing with Playwright | Evidence record | | Integration testing architecture | Current guide | | Acceptance and test guides | Navigation | | Browser end-to-end tests | Current guide | | Mobile File Upload Testing Checklist | Design reference | | Performance Testing Guide | Design reference | | Import and catalogue acceptance checklist | Current guide | | Mobile File Upload Testing - Quick Start | Design reference | | Verification Report – Canonical | Evidence record | | Comprehensive Remediation & Sourcing Logic Plan (Feb 2026) | Evidence record | | Historical quality reports | Navigation | | Frontend Pages Code Quality Analysis Report | Evidence record | | Frontend Pages Refactoring Checklist | Evidence record | | Kotlin Codebase Quality Review Report | Evidence record | | Kotlin Codebase Refactoring Checklist | Evidence record | | Comprehensive Code Quality Evaluation Report: KrithiEditor.tsx | Evidence record | | KrithiEditor.tsx Refactoring Checklist | Evidence record | | Krithi Data Sourcing & Quality — Progress Report | Evidence record | | Steel Thread Testing & Usability Report | Evidence record | | Usability Test Report - Admin Dashboard | Evidence record | | Recorded data-quality results | Navigation | | Data Quality Audit Results (Interim) - Feb 2026 | Evidence record | | Section-Issues Cleanup | Navigation | | Flagged Krithis — Section Issues NOT auto-fixed (for review) | Evidence record | | Section-Issues Cleanup — Findings & Remediation Log | Evidence record | | Implementation Summary: TRACK-034 Bulk Import & Section Parsing Fixes | Evidence record | | TRACK-036: KrithiStructureParser & Ragamalika Optimization | Evidence record | | Implementation Summary: Data Remediation & Deduplication Hardening (TRACK-040, TRACK-041, TRACK-061) | Evidence record | | Implementation Summary: Sourcing UI & Monitoring Screens (TRACK-044, TRACK-046-052, TRACK-057) | Evidence record | | Implementation Summary: Sourcing Infrastructure & Backend API (TRACK-045) | Evidence record | | Implementation Summary: Ingestion & Language Variants (TRACK-053, TRACK-056, TRACK-058, TRACK-062, TRACK-063) | Evidence record | | Implementation Summary: PDF Extraction Hardening (TRACK-054, TRACK-055, TRACK-059, TRACK-060) | Evidence record |
| Document | Reading context | |:—|:—| | Operations | Navigation | | Agent Workflows | Design reference | | Documentation checks | Current guide | | Runtime configuration | Current guide | | Builds and deployment readiness | Current guide | | Runtime diagnostics and monitoring | Current guide | | PostgreSQL 18 Upgrade Implementation Summary | Design reference | | Bulk Import Query Optimization Plan | Design reference | | Operational runbooks | Navigation | | Database operations runbook | Current guide | | Investigate an application incident | Current guide | | Steel-thread verification | Current guide |
| Document | Reading context | |:—|:—| | AI, embeddings, and assisted delivery | Navigation | | Embedding pipeline and index operations | Current guide | | Project Knowledge Base | Design reference | | Google Gemini Selection Rationale | Design reference | | AI roadmap and evaluation criteria | Current guide | | AI and extraction capabilities | Current guide | | Track 138: Agentic build guide | Current guide | | TRACK-140: dependency graph and execution loop | Current guide | | 🤖 AI & Vibe Coding References | Design reference |
| Document | Reading context | |:—|:—| | Platform change records | Navigation | | Dependency Updates (Feb 2026) Implementation Summary | Evidence record | | Environment Variable & Config Standardization Implementation Summary | Evidence record | | Implementation evidence | Navigation | | Refactor Shared DTOs and DAL Mappers | Evidence record | | Refactor DAL Repositories | Evidence record | | Refactor Core Services | Evidence record | | Refactor Infrastructure Services | Evidence record | | Gemini Embedding 2 Catalogue Execution Report | Evidence record | | TRACK-064: Entity Resolution Cache & Field Comparison Improvements | Evidence record | | TRACK-064: Unified Extraction Engine Migration — Implementation Summary | Evidence record | | TRACK-065: Python Extraction Module First-Class Promotion & Naming | Evidence record | | TRACK-068: Markdown Krithi Ingestion Analysis Cleanup | Evidence record | | Dikshitar Krithi Import Pipeline (TRACK-071) | Evidence record | | Archive Rust CLI — Replace with Python db-migrate + Makefile | Evidence record | | E2E Pipeline Validation & Lyric Section Consistency Fix | Evidence record | | Curator Review UI & Section Issue Tracking | Evidence record | | Extraction Worker Local File Path Support | Evidence record | | Documentation Update & Conductor Track Cleanup | Evidence record | | Agent Skills, Workflows & Hooks Modernization | Evidence record | | Implementation Summary: TRACK-087 Documentation Audit & Sync | Evidence record | | Purpose | Evidence record | | Purpose | Evidence record | | Goal | Evidence record | | Goal | Evidence record | | Trinity Krithi Bulk Import | Evidence record | | Lyric Persistence Fix & Backfill | Evidence record | | Import Pipeline Test & Validation | Evidence record | | Payload Format Convergence | Evidence record | | Guru Guha Blog Source Adapter | Evidence record | | Agent Workflow Additions | Evidence record | | TRACK-099: Backend Compiler Warning Cleanup | Evidence record | | Track 108 — Conversational Carnatic Music Discovery | Evidence record | | TRACK-108 — semantic search and embeddings implementation | Current guide | | TRACK-108 validation and functional opportunities | Evidence record | | Prep & Approach — TRACK-119 (Interactive Auth) and TRACK-108 (Semantic Search) | Evidence record | | Implementation Summary - TRACK-125 Documentation Repair | Evidence record | | Section-Count Mismatch Remediation (TRACK-133) | Evidence record | | AI-native SDLC artifacts (TRACK-134) | Evidence record | | TRACK-138 Rasika mobile MVP — implementation evidence | Evidence record | | TRACK-139: Retire Corpus Data-Fix Migrations | Evidence record | | TRACK-140 implementation evidence | Evidence record |
| Document | Reading context | |:—|:—| | Retrospectives and investigations | Navigation | | Extraction & Variant Pipeline Failure Analysis | Evidence record | | Analysis: Consolidating All Extraction Logic into the Python Service | Evidence record | | Import Pipeline Analysis & Remediation Report | Evidence record | | Multi-Source Import Remediation Report | Evidence record | | Multi-Source Import Retrospective | Evidence record | | Technical Retrospective: Multi-Source Import Remediation | Evidence record | | Thyagaraja Krithi Import — Post-Mortem Analysis | Evidence record | | TRACK-064 Code Review & Validation (2026-02-13) | Evidence record | | TRACK-064 Unified Extraction Migration Handoff (2026-02-12) | Evidence record | | TRACK-064 Key-Collision Milestone Handover (2026-02-13) | Evidence record |
| Document | Reading context | |:—|:—| | Sangeetha Grantha documentation | Navigation | | Sangeetha Grantha — North-Star Evaluation | Design reference | | North-Star Production Readiness — Decision Checklist | Design reference | | North-Star Production Readiness — Implementation Plan | Design reference | | Delivery status and remaining work | Current guide | | Sangeetha Grantha — State of the Nation, Mid-2026 | Design reference | | Sangeetha Grantha — Uplift Task List | Design reference |