This repository was archived by the owner on Aug 11, 2026. It is now read-only.
docs: comprehensive project documentation for handoff - #891
Open
jon-myers wants to merge 1 commit into
Open
Conversation
13-chapter documentation covering the full IDTAP project: - Project overview, intellectual foundations, and research publications - 4-year development history (4,010 commits across 12 phases) - System architecture (frontend, backend, Python API, deployment) - Domain model (Piece/Phrase/Trajectory/Pitch hierarchy, Raga, Meter, Assemblage) - Spectrogram system (CQ pipeline, Web Worker rendering, cascade invalidation) - Audio synthesis engines (Karplus-Strong, Sarangi waveguide, Klatt, Chikari) - Editor and rendering (D3 SVG, drag dots, lazy loading, full UI inventory) - Analysis and query systems (pattern matching, pitch prevalence, DN_Extractor) - Database and storage (MongoDB schema, permissions, backups, migrations) - Python API (PyPI package architecture and integration) - Deployment and infrastructure (CI/CD, server management, backups) - Known issues and roadmap (~105 open issues, architecture recommendations) - Onboarding guide for new developers Includes an HTML viewer for browsing docs locally. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/project/(3,461 lines of markdown)docs/project/viewer.html) for browsing locally viapython3 -m http.server.gitignoreto trackdocs/project/while keeping auto-generated TypeDoc ignoredDocumentation Structure
Test plan
.gitignorecorrectly tracksdocs/project/while ignoring TypeDoc output🤖 Generated with Claude Code