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