docs: sync docs with current FastAPI implementation

[gkorland]

Summary

• update README.md to reflect the FastAPI/Uvicorn runtime, /api/* routes, current auth behavior, supported analyzers, and current dev commands
• refresh .env.template with the current FalkorDB/auth/model variables and remove stale Flask/OpenAI-specific guidance
• add accurate architecture and quick-reference docs for the current backend

Testing

• not run (documentation-only changes)
• baseline note: legacy analyzer/git-history tests still fail on a clean checkout

Summary by CodeRabbit

• Documentation

  • Added architecture analysis and quick reference guides for developers and operators.
  • Updated comprehensive README with backend restructuring details, new API endpoints, and configuration guidance.

• New Features

  • Added support for FalkorDB and LiteLLM model configurations.
  • Introduced optional analysis directory constraints and Uvicorn server settings.

• Chores

  • Updated environment configuration template with new authentication and service variables.

[coderabbitai]

📝 Walkthrough

Walkthrough

The pull request updates project documentation and environment configuration to reflect a migration from Flask to FastAPI architecture. Changes include renaming API authentication variables, adding FalkorDB and LiteLLM configuration parameters, removing Flask-specific settings, and introducing comprehensive architecture documentation alongside updated README guidance.

Changes

Cohort / File(s)	Summary
Configuration Update .env.template	Removed OpenAI API key; added FalkorDB authentication credentials (USERNAME, PASSWORD); introduced LiteLLM variables (MODEL_NAME, GEMINI_API_KEY); removed Flask server settings; added Uvicorn host/port options; updated CODE_GRAPH_PUBLIC and SECRET_TOKEN documentation; added optional ALLOWED_ANALYSIS_DIR constraint.
Architecture Documentation ARCHITECTURE_ANALYSIS.md	New comprehensive document detailing FastAPI backend structure, HTTP layer organization, domain modules, runtime considerations, storage models, request flows, routing, authentication dependencies, endpoint inventory, and flows for key operations like analyze_repo and chat.
Quick Reference Guide QUICK_REFERENCE.txt	New concise reference document consolidating backend snapshot details, key API paths, installation and runtime commands, authentication rules, environment variables, API endpoints, analysis notes, and development guidance.
Project Documentation README.md	Expanded and restructured documentation reflecting FastAPI migration: updated API backend description, frontend layout expectations, local running instructions, dependency commands, environment variable listings, authentication behavior details, API usage examples with /api/ prefixes, supported language/analyzer inventory, and categorized endpoint table with read and mutating operations.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Poem

🐰 Hops through FastAPI paths so bright,
FalkorDB credentials in sight,
LiteLLM whispers in the night,
Docs rebuilt with all their might,
Configuration's dance is just right! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the primary change: updating documentation to align with the current FastAPI implementation rather than the legacy Flask setup.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch async-endpoints

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

ARCHITECTURE_ANALYSIS.md (1)

11-33: Add language specification to fenced code block.

The code block would benefit from a language identifier for proper syntax highlighting and linting compliance.

📝 Proposed fix

-```
+```text
 api/
 ├── __init__.py                     # Public package exports

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@ARCHITECTURE_ANALYSIS.md` around lines 11 - 33, The fenced code block in
ARCHITECTURE_ANALYSIS.md is missing a language spec causing highlighting/lint
issues; update the opening fence to include a language identifier (for example
"text" or "yaml") so the block becomes ```text (or ```yaml) and keep the
existing content unchanged; target the code block that lists the api/ directory
and related files to apply this change.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@ARCHITECTURE_ANALYSIS.md`:
- Around line 11-33: The fenced code block in ARCHITECTURE_ANALYSIS.md is
missing a language spec causing highlighting/lint issues; update the opening
fence to include a language identifier (for example "text" or "yaml") so the
block becomes ```text (or ```yaml) and keep the existing content unchanged;
target the code block that lists the api/ directory and related files to apply
this change.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 312a25c9-e52a-4b22-9c86-f1c2a218a535

📥 Commits

Reviewing files that changed from the base of the PR and between 0c64e8d and c46427e.

📒 Files selected for processing (4)

• .env.template
• ARCHITECTURE_ANALYSIS.md
• QUICK_REFERENCE.txt
• README.md