update readme, add mermaid diagrams

[0xrinegade]

Is your feature request related to a problem? Please describe.
update readme, add mermaid diagrams

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

[github-actions]

Enhanced Issue: Update README, Add Mermaid Diagrams

When working on this GitHub issue, the following plan ensures clarity, proper execution, and alignment with stakeholder expectations. Below is an enhanced breakdown of the issue, clarifying objectives, execution steps, and acceptance criteria.

---

Issue Context

Summary:
The repository README documentation aims to be more visually engaging and easier to understand. To accomplish this, we need to add Mermaid diagrams for representing complex workflows, dataflows, and other visual information. By escaping all quotes (or avoiding them completely, when appropriate), we prevent potential rendering or parsing bugs.

---

What We Expect

1. Improved Documentation via Mermaid Diagrams
   Add relevant Mermaid diagrams to the repository’s README file. These diagrams should visually clarify processes and flows related to the project and improve overall understanding for developers, contributors, and stakeholders.

2. Escaping Quotes (or Avoiding Quotes)
   Quotes often cause markdown