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
┌──────────────┐ ┌──────────────────────────────┐ │
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 │
└─────────────────────────────────────────────────────────────┘
──────────────────────────┐
User Browser
└────────────┬─────────────┘
│ :8080
┌────────────▼─────────────┐
│ Nginx (React SPA)
Static files + API proxy
└────────────┬─────────────┘
:8000
┌─────────────────────────────────────▼──────────────────────────────────┐
FastAPI Backend (Python 3.12)
8 uvicorn workers × 10 threads
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────────────┐
│ 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) │
└─────────────────────────┘
```
---