[Docs] Create Mermaid.js Architecture Diagrams for README

[Vishisht16]

🎯 Objective

Convert our text-based ASCII architecture diagrams in the README.md into beautiful, renderable Mermaid.js diagrams.

💡 Why this matters

HumaneProxy uses a complex 3-stage cascading inference pipeline. While the text explanation is good, a visual flowchart helps developers and enterprise architects understand the data flow, early exits, and webhook triggers in less than 5 seconds.

✅ Acceptance Criteria

• Learn Mermaid.js syntax for flowcharts.
• Create a Mermaid block (```mermaid) in the README replacing the current ASCII diagram.
• The diagram must accurately depict:
  • User Request -> Stage 1 (Heuristics)
  • Early exit to Block/LLM.
  • Fallback to Stage 2 (Embeddings).
  • Fallback to Stage 3 (Reasoning LLM).
  • Async Webhook dispatch & DB logging.
• The diagram should be color-coded if possible (e.g., Red for Block, Green for LLM Forward).

📚 Resources

• Mermaid.js Flowchart Docs

[Ad1th]

Hi! I’d like to work on this issue. I can replace the existing ASCII diagrams with clean Mermaid.js flowcharts that accurately represent the 3-stage pipeline, early exits, webhook dispatch flow, and DB logging.
I’ll also ensure the diagrams are readable, color-coded, and render properly across GitHub markdown. Please assign this issue to me if it’s available.

@Vishisht16

[Vishisht16]

Hello @Ad1th, please note that only one issue can be assigned to each contributor at a time.
I suggest choosing one out of the two issues you commented on and allow other contributors to explore these.
If nobody else comments by the time you're done with the other issue, I'll assign this one to you.

[Ad1th]

Okay, I would pick the other issue since backend is my primary domain and I can leave this one out for absolute beginners to programming

[deepaksinghrx]

Hi, @Vishisht16 ,I would like to work on this issue by replacing the ASCII architecture diagram with a Mermaid.js flowchart and improving the pipeline visualization with color-coded stages.

[Vishisht16]

Sure @deepaksinghrx
I'll assign it to you in a few days

[Vishisht16]

@deepaksinghrx by when can I expect it? From what I can see, you haven't even forked the repository yet. Feel free to let me know if you're facing any particular issues.

[akshayagunna151]

Hi @Vishisht16
I’d love to work on this issue under GSSoC ’26. The task aligns well with my interest in documentation and developer experience, and I can create a clean Mermaid.js architecture diagram that clearly visualizes the cascading safety pipeline, early exits, webhook flow, and DB logging.

I’ve already gone through the current README structure and Mermaid flowchart syntax, and I’m ready to start working on the implementation.
Could you please assign this issue to me?

[Vishisht16]

@akshayagunna151 please go ahead and work on it. if you have any questions about something in particular about the project, let me know.