1ba5ce851d
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
176 lines
4.9 KiB
Markdown
176 lines
4.9 KiB
Markdown
# 🎯 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
|