docs: modernized architecture diagram with full component detail

This commit is contained in:
nogueiraguh
2026-03-26 10:16:57 -03:00
parent ee550b6632
commit b11cc44648

View File

@@ -246,37 +246,47 @@ The platform combines security compliance scanning, AI-powered chat with **RAG (
## Architecture ## Architecture
``` ```
┌─────────────────────────────────────────────────────────────┐ ──────────────────────────┐
Docker Compose User Browser
└────────────┬─────────────┘
┌──────────────┐ ┌──────────────────────────────┐ │ │ :8080
Nginx │ │ FastAPI Backend │ │ ┌────────────▼─────────────┐
(Frontend) │──────▶│ (Python 3.12) │ │ Nginx (React SPA)
:8080 :8000 Static files + API proxy
│ └──────────────┘ │ │ │ └────────────┬─────────────┘
│ ┌─────────────┐ :8000
│ │ │ OCI SDK │──▶ OCI APIs │ │ ┌─────────────────────────────────────▼──────────────────────────────────┐
├─────────────┤ FastAPI Backend (Python 3.12)
│ │ GenAI Client │──▶ LLM 8 uvicorn workers × 10 threads
├─────────────┤ (tools) │
│ │ MCP Client │──▶ MCP Svrs │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────────────┐
│ ├─────────────┤ (discover │ │ Chat │ Terraform│ │ CIS │ │ Embedding Pipeline │
│ │ +execute) │ │ Agent │ Agent │ │ Scanner │ (chunk + embed +
├─────────────┤ │ (RAG + │ (IaC│ (MCP purge + progress) │ │
│ │ │ Terraform │──▶ Plan / MCP Plan/ 12 │ │
│ │ │ Apply Tools) Apply) │ │ tools) Auto-map CSV→Table │ │
│ ├─────────────┤ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └───────────┬───────────┘
│ │ │ oracledb │──▶ ADB
│ ├─────────────┤ │ ──────────────────▼──────────────▼─────────────────────▼───────────┐
│ RAG Pipeline │──▶ Embed + Shared Services
│ │ │ Search │ OCI SDK → OCI APIs │ GenAI → LLM (16 models) │ │
│ └─────────────┘ │ oracledb → ADB Vector │ Chromium → PDF generation │
│ SQLite (agent.db) Terraform CLI 1.14.7 │ │
│ SQLite (agent.db) │ └────────────────────────────────────────────────────────────────────┘
└──────────────────────────────┘ └────────────────────────────────┬───────────────────────────────────────
agent-data volume │ ┌────────────▼────────────┐
└─────────────────────────────────────────────────────────────┘ │ agent-data volume │
│ /data (SQLite, reports, │
│ terraform workspaces, │
│ OCI configs, wallets) │
└─────────────────────────┘
┌─────────────────────────┐
│ Oracle ADB (external) │
│ 11 vector tables │
│ (RAG + embeddings) │
└─────────────────────────┘
``` ```
--- ---