<!--
  @project       : Domuscan App
  @filename      : LEGGIMI.md
  @author        : Damiano | <dagneni@gmail.com>
  @description   : Dove installare i modelli di configurazione del server e come compilarli.
  @creation date : 13-11-2026
  @last update   : 13-11-2026

  @version: 0.1.1
-->

# Modelli di configurazione del server

File da copiare sulla VPS OVH (**AlmaLinux**) per un ambiente DOMUSCAN. Contengono solo configurazione, nessun segreto. La guida completa all'installazione, con il primo rilascio e le regole SELinux per `rilasci/` e `app_precedente/`, è `documentazione/installazione_vps.md`.

## Segnaposto

Tutti i file usano `__AMBIENTE__` al posto del nome dell'ambiente (`staging` o `produzione`). Si sostituisce in fase di copia, ad esempio:

```bash
AMBIENTE=staging
sed "s/__AMBIENTE__/${AMBIENTE}/g" apache_domuscan.conf > /etc/httpd/conf.d/10_domuscan_${AMBIENTE}.conf
```

Ogni ambiente ha utente di sistema, pool PHP, database, cartelle e certificato propri.

## Dove va ogni file

| Modello | Destinazione sul server | Note |
|---|---|---|
| `apache_domuscan.conf` | `/etc/httpd/conf.d/10_domuscan_<ambiente>.conf` | Il prefisso `10_` lo fa caricare prima di `ssl.conf`: così, finché non c'è un dominio, è il virtual host predefinito per le richieste all'IP. Con più ambienti sulla stessa VPS servono i nomi a dominio (`ServerName`, fase 5 del piano) |
| `apache_sicurezza.conf` | `/etc/httpd/conf.d/05_domuscan_sicurezza.conf` | Una sola copia per server, senza segnaposto |
| `php_fpm_domuscan.conf` | `/etc/php-fpm.d/domuscan_<ambiente>.conf` | Il pool predefinito `www.conf` si può lasciare o disattivare (rinominandolo in `www.conf.disattivato`) |
| `cron_domuscan` | `/etc/cron.d/domuscan_<ambiente>` | Permessi `644`, proprietario `root`. Il nome non deve contenere punti. Lancia `strumenti/backup.sh` ogni notte |

## Prerequisiti sul server

Pacchetti: `httpd`, `mod_ssl`, `php-fpm` (PHP ≥ 8.3). I moduli `rewrite`, `headers`, `proxy_fcgi` e `setenvif` sono già caricati dalla configurazione standard di AlmaLinux (`/etc/httpd/conf.modules.d/`).

Il pacchetto PHP installa `/etc/httpd/conf.d/php.conf`, che manda tutti i `.php` al pool `www`. Il virtual host DOMUSCAN lo sovrascrive con il proprio pool, quindi quel file può restare.

Cartelle dell'ambiente (proprietario l'utente di servizio `domuscan-<ambiente>`):

```
/srv/domuscan/<ambiente>/app            codice (pubblico/ è la document root)
/srv/domuscan/<ambiente>/dati/vault
/srv/domuscan/<ambiente>/dati/in_arrivo
/srv/domuscan/<ambiente>/dati/log
/srv/domuscan/<ambiente>/dati/sessioni  permessi 700
/srv/domuscan/<ambiente>/backup
```

Apache (utente `apache`) deve poter attraversare le cartelle fino a `app/pubblico` e leggerne i file; non deve poter leggere `.env`, che ha permessi `600`.

## Certificato autofirmato (finché non c'è il dominio)

```bash
openssl req -x509 -newkey rsa:3072 -sha256 -days 365 -nodes \
  -keyout /etc/pki/tls/private/domuscan_<ambiente>.key \
  -out    /etc/pki/tls/certs/domuscan_<ambiente>.crt \
  -subj "/CN=<IP della VPS>" -addext "subjectAltName=IP:<IP della VPS>"
chmod 600 /etc/pki/tls/private/domuscan_<ambiente>.key
```

## SELinux

AlmaLinux ha SELinux attivo (`enforcing`): senza queste regole Apache e PHP‑FPM non possono leggere `/srv/domuscan` né collegarsi a MariaDB.

```bash
# Codice: sola lettura per il web server
semanage fcontext -a -t httpd_sys_content_t    "/srv/domuscan/<ambiente>/app(/.*)?"
# Dati: lettura e scrittura (log, sessioni, Vault, cartella in arrivo)
semanage fcontext -a -t httpd_sys_rw_content_t "/srv/domuscan/<ambiente>/dati(/.*)?"
restorecon -Rv /srv/domuscan/<ambiente>

# PHP si collega a MariaDB via TCP (DB_HOST=127.0.0.1)
setsebool -P httpd_can_network_connect_db on
# Solo quando si passerà a EMAIL_MODALITA=smtp
# setsebool -P httpd_can_network_connect on
```

I backup in `/srv/domuscan/<ambiente>/backup` sono scritti dal cron, non dal web server: non serve un contesto dedicato.

## Firewall

```bash
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload
```

## Verifica dopo la copia

```bash
apachectl configtest
php-fpm -t
systemctl reload php-fpm httpd
curl -kI https://<IP della VPS>/     # 200, header Server: Apache senza versione
curl -kI https://<IP della VPS>/.env # 403 o 404
```
