Initial commit: LLM Automation Docs & Remediation Engine v2.0
Features: - Automated datacenter documentation generation - MCP integration for device connectivity - Auto-remediation engine with safety checks - Multi-factor reliability scoring (0-100%) - Human feedback learning loop - Pattern recognition and continuous improvement - Agentic chat support with AI - API for ticket resolution - Frontend React with Material-UI - CI/CD pipelines (GitLab + Gitea) - Docker & Kubernetes deployment - Complete documentation and guides v2.0 Highlights: - Auto-remediation with write operations (disabled by default) - Reliability calculator with 4-factor scoring - Human feedback system for continuous learning - Pattern-based progressive automation - Approval workflow for critical actions - Full audit trail and rollback capability
This commit is contained in:
LLM Automation System
175
README_MASTER.md
Normal file
175
README_MASTER.md
Normal file
@@ -0,0 +1,175 @@
|
||||
# 🎯 Sistema Completo - Documentazione Datacenter Automatizzata
|
||||
|
||||
## 📦 Pacchetto Completo
|
||||
|
||||
Questo pacchetto contiene un **sistema end-to-end** per la gestione automatizzata della documentazione datacenter:
|
||||
|
||||
1. **Template documentazione** (10 sezioni)
|
||||
2. **System prompts per LLM** (10 file)
|
||||
3. **Requisiti tecnici e script** (raccolta dati)
|
||||
4. **Webserver FastAPI** (pubblicazione web)
|
||||
5. **MCP Server** (connessioni infrastruttura)
|
||||
6. **CI/CD Pipeline** (automazione completa)
|
||||
7. **Docker containerizzazione**
|
||||
|
||||
---
|
||||
|
||||
## 📚 Documentazione
|
||||
|
||||
### 📖 README.md
|
||||
Panoramica generale del sistema di documentazione
|
||||
|
||||
### 📖 QUICK_START.md
|
||||
Guida rapida per setup e primo utilizzo
|
||||
|
||||
### 📖 INDICE_COMPLETO.md
|
||||
Indice dettagliato di tutti i file e componenti
|
||||
|
||||
### 📖 README_WEB.md
|
||||
Documentazione completa per sistema web e MCP server
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Struttura Completa
|
||||
|
||||
```
|
||||
datacenter-docs/
|
||||
│
|
||||
├── 📄 README.md # Panoramica generale
|
||||
├── 📄 README_WEB.md # Docs web/MCP system
|
||||
├── 📄 QUICK_START.md # Guida rapida
|
||||
├── 📄 INDICE_COMPLETO.md # Indice dettagliato
|
||||
├── 📄 README_MASTER.md # Questo file
|
||||
│
|
||||
├── 📄 mkdocs.yml # Config MkDocs
|
||||
├── 📄 Dockerfile # Multi-stage build
|
||||
├── 📄 docker-compose.yml # Orchestrazione
|
||||
├── 📄 docker-entrypoint.sh # Container entry
|
||||
├── 📄 requirements.txt # Python deps
|
||||
│
|
||||
├── 📁 templates/ # 10 template sezioni
|
||||
│ ├── 01_infrastruttura_fisica.md
|
||||
│ ├── 02_networking.md
|
||||
│ ├── 03_server_virtualizzazione.md
|
||||
│ ├── 04_storage.md
|
||||
│ ├── 05_sicurezza.md
|
||||
│ ├── 06_backup_disaster_recovery.md
|
||||
│ ├── 07_monitoring_alerting.md
|
||||
│ ├── 08_database_middleware.md
|
||||
│ ├── 09_procedure_operative.md
|
||||
│ └── 10_miglioramenti.md
|
||||
│
|
||||
├── 📁 system-prompts/ # 10 prompt per LLM
|
||||
│ ├── 01_infrastruttura_fisica_prompt.md
|
||||
│ ├── ... (altri 9 file)
|
||||
│ └── 10_miglioramenti_prompt.md
|
||||
│
|
||||
├── 📁 requirements/ # Requisiti tecnici
|
||||
│ ├── llm_requirements.md # Setup LLM completo
|
||||
│ ├── data_collection_scripts.md # Script Python
|
||||
│ └── api_endpoints.md # API/comandi reference
|
||||
│
|
||||
├── 📁 api/ # FastAPI application
|
||||
│ ├── main.py # Server principale
|
||||
│ └── requirements-api.txt # Dependencies
|
||||
│
|
||||
├── 📁 mcp-server/ # MCP Server
|
||||
│ └── server.py # MCP implementation
|
||||
│
|
||||
├── 📁 docs/ # MkDocs source
|
||||
│ ├── index.md # Homepage
|
||||
│ ├── sections/ # Sezioni docs
|
||||
│ └── api/ # API docs
|
||||
│ ├── index.md
|
||||
│ ├── endpoints.md
|
||||
│ └── mcp.md
|
||||
│
|
||||
├── 📁 nginx/ # Reverse proxy
|
||||
│ └── nginx.conf
|
||||
│
|
||||
├── 📁 scripts/ # Utility scripts
|
||||
│ ├── build-docs.sh
|
||||
│ └── deploy.sh
|
||||
│
|
||||
├── 📁 .github/workflows/ # CI/CD
|
||||
│ └── build-deploy.yml # Pipeline completa
|
||||
│
|
||||
└── 📁 config/ # Configuration
|
||||
└── mcp_config.example.json # MCP config example
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Workflow Completo
|
||||
|
||||
### Fase 1: Setup Iniziale
|
||||
```bash
|
||||
1. Setup ambiente Python + Docker
|
||||
2. Configurare credenziali
|
||||
3. Test connettività infrastruttura
|
||||
4. Prima generazione documentazione
|
||||
```
|
||||
|
||||
### Fase 2: Generazione Documentazione
|
||||
```bash
|
||||
LLM legge:
|
||||
├─ Template (cosa compilare)
|
||||
├─ System Prompt (come farlo)
|
||||
└─ Requirements (con quali tool)
|
||||
↓
|
||||
Connette a infrastrutture via:
|
||||
├─ SSH (switch, router)
|
||||
├─ SNMP (UPS, sensori)
|
||||
├─ API (VMware, storage)
|
||||
└─ Database (asset management)
|
||||
↓
|
||||
Compila template e salva
|
||||
```
|
||||
|
||||
### Fase 3: Pubblicazione Web
|
||||
```bash
|
||||
Commit su Git
|
||||
↓
|
||||
GitHub Actions pipeline:
|
||||
├─ Lint & validate
|
||||
├─ Build MkDocs
|
||||
├─ Build Docker image
|
||||
├─ Security scan
|
||||
└─ Deploy to production
|
||||
↓
|
||||
Documentazione live su:
|
||||
├─ Web UI (MkDocs)
|
||||
├─ API REST (FastAPI)
|
||||
└─ MCP Server (connessioni)
|
||||
```
|
||||
|
||||
### Fase 4: Accesso
|
||||
```bash
|
||||
Umani → Web Browser → MkDocs UI
|
||||
LLM → API REST → JSON/Markdown
|
||||
LLM → MCP Server → Infrastructure live data
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### 1. Setup Ambiente
|
||||
```bash
|
||||
cd datacenter-docs
|
||||
python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 2. Configurazione
|
||||
```bash
|
||||
# Edita configurazione
|
||||
cp config/mcp_config.example.json config/mcp_config.json
|
||||
vim config/mcp_config.json
|
||||
|
||||
# Secrets
|
||||
cat > .env << 'EOF'
|
||||
VCENTER_PASSWORD=your_password
|
||||
SWITCH_PASSWORD=your_password
|
||||
STORAGE_API_KEY=your_api_key
|
||||
Reference in New Issue
Block a user