# Documentazione Datacenter

Benvenuto nella documentazione tecnica completa del datacenter.

!!! info "Aggiornamento Automatico"
    Questa documentazione è generata e aggiornata automaticamente da un sistema di automazione.
    Ultimo aggiornamento: {{ git.date }}

## 🎯 Panoramica

Questa documentazione fornisce una visione completa e dettagliata di tutti gli aspetti tecnici del datacenter, inclusi:

- Infrastruttura fisica (layout, elettrico, raffreddamento)
- Networking (switch, router, firewall, VLAN)
- Server e virtualizzazione
- Storage (SAN, NAS, object storage)
- Sicurezza e compliance
- Backup e disaster recovery
- Monitoring e alerting
- Database e middleware
- Procedure operative

## 📊 Struttura Documentazione

La documentazione è organizzata nelle seguenti sezioni principali:

### Infrastruttura

<div class="grid cards" markdown>

-   :material-server-network:{ .lg .middle } __Infrastruttura Fisica__

    ---

    Layout datacenter, rack, sistema elettrico (UPS, generatori), raffreddamento, sicurezza fisica

    [:octicons-arrow-right-24: Vai alla sezione](sections/01_infrastruttura_fisica.md)

-   :material-lan:{ .lg .middle } __Networking__

    ---

    Switch, router, firewall, VLAN, routing, DNS/DHCP, monitoring rete

    [:octicons-arrow-right-24: Vai alla sezione](sections/02_networking.md)

-   :material-server:{ .lg .middle } __Server e Virtualizzazione__

    ---

    VMware/Hypervisor, host fisici, VM, cluster, high availability

    [:octicons-arrow-right-24: Vai alla sezione](sections/03_server_virtualizzazione.md)

-   :material-harddisk:{ .lg .middle } __Storage__

    ---

    SAN, NAS, object storage, capacity planning, performance

    [:octicons-arrow-right-24: Vai alla sezione](sections/04_storage.md)

</div>

### Sicurezza e Compliance

<div class="grid cards" markdown>

-   :material-shield-check:{ .lg .middle } __Sicurezza__

    ---

    IAM, vulnerability management, compliance, encryption, SIEM

    [:octicons-arrow-right-24: Vai alla sezione](sections/05_sicurezza.md)

-   :material-backup-restore:{ .lg .middle } __Backup e DR__

    ---

    Backup jobs, RPO/RTO, disaster recovery site, restore testing

    [:octicons-arrow-right-24: Vai alla sezione](sections/06_backup_disaster_recovery.md)

</div>

### Operations

<div class="grid cards" markdown>

-   :material-monitor-dashboard:{ .lg .middle } __Monitoring__

    ---

    Piattaforme monitoring, alerting, dashboards, metriche

    [:octicons-arrow-right-24: Vai alla sezione](sections/07_monitoring_alerting.md)

-   :material-database:{ .lg .middle } __Database__

    ---

    DBMS, instances, middleware, application servers

    [:octicons-arrow-right-24: Vai alla sezione](sections/08_database_middleware.md)

-   :material-notebook-edit:{ .lg .middle } __Procedure__

    ---

    SOP, runbook operativi, escalation, change management

    [:octicons-arrow-right-24: Vai alla sezione](sections/09_procedure_operative.md)

</div>

### Strategia

<div class="grid cards" markdown>

-   :material-lightbulb-on:{ .lg .middle } __Miglioramenti__

    ---

    Analisi opportunità, roadmap, ottimizzazioni, investimenti

    [:octicons-arrow-right-24: Vai alla sezione](sections/10_miglioramenti.md)

</div>

## 🔌 API REST

Questa documentazione è accessibile anche tramite API REST per integrazione con sistemi e LLM.

### Endpoints Principali

- `GET /api/v1/sections` - Lista tutte le sezioni
- `GET /api/v1/sections/{id}` - Contenuto sezione specifica
- `GET /api/v1/summary` - Summary ottimizzato per LLM
- `GET /api/v1/search?q=query` - Ricerca full-text
- `GET /api/v1/stats` - Statistiche documentazione
- `GET /api/v1/llm-optimized/{id}` - Contenuto ottimizzato per LLM

[:octicons-arrow-right-24: Documentazione API completa](api/index.md)

## 🤖 MCP Server

Il sistema include un MCP (Model Context Protocol) Server che permette agli LLM di connettersi direttamente alle infrastrutture per recuperare dati in tempo reale.

### Metodi Disponibili

- SSH execution su device di rete
- SNMP queries su UPS, switch, sensori
- API calls a VMware, storage, monitoring
- Database queries

[:octicons-arrow-right-24: Documentazione MCP](api/mcp.md)

## 📈 Statistiche

!!! tip "Informazioni Sistema"
    - **Ultimo aggiornamento**: Automatico ogni 6 ore
    - **Formato**: Markdown strutturato
    - **Accesso**: Web UI + API REST
    - **Ottimizzato per**: Umani e LLM

## 🔍 Ricerca

Utilizza la barra di ricerca in alto per trovare rapidamente informazioni specifiche nella documentazione.

## 📞 Contatti

Per domande o supporto sulla documentazione:

- **Team**: Automation Team
- **Email**: automation@company.com
- **Repository**: [GitHub](https://github.com/company/datacenter-docs)

---

*Documentazione generata automaticamente dal sistema di automazione datacenter*