# Paperless — Guida per la famiglia LOOGLE

**Archivio documenti di casa:** https://docs.loogle.it

Questa guida spiega **perché** usiamo Paperless, **come** configurarlo e **come** installare l’app sul telefono.

---

## Perché usiamo Paperless

Paperless è l’**archivio digitale di casa**: bollette, contratti, manuali, referti, ricevute, documenti scolastici, ecc.

| Prima (cartaceo) | Con Paperless |
|------------------|---------------|
| Documenti sparsi in cassetti e cartelle | Tutto in un unico archivio searchable |
| Difficile trovare «la bolletta luce del 2024» | Cerca per parola, tag, mittente, data |
| Fotocopie e PDF persi nel telefono | PDF centralizzati, backup su NAS di casa |
| Solo chi ha il foglio fisico | Chi ha l’account può consultare (con permessi) |

**Vantaggi per noi:**

- **Resta in casa** — i file sono sui nostri dispositivi (Pi + NAS), non su Google Drive o iCloud di terzi
- **OCR in italiano** — Paperless legge il testo nei PDF e nelle scansioni, così puoi cercare anche dentro il documento
- **Integrazione** — l’assistente AI (MCP) può cercare documenti già archiviati quando chiedi «trova la bolletta gas»
- **Accesso da telefono** — consulta e carica documenti ovunque (in rete casa o via VPN)

---

## Cos’è, in pratica

Paperless-ngx è un sito web dove:

1. **Carichi** un PDF o una foto (upload, email, cartella sul telefono)
2. **Paperless** fa OCR, propone titolo, data, tag
3. **Tu** confermi o correggi (opzionale)
4. **Archivi** — il documento resta indicizzato e ricercabile

**Indirizzo:** https://docs.loogle.it  
Funziona da browser (PC, tablet, telefono) o da app dedicata.

---

## Account famiglia

| Nome | Username | Password iniziale |
|------|----------|-------------------|
| Daniele | `daniele` | *(chiedi a Daniele)* |
| Lucia | `lucia` | `lucia` |
| Davide | `davide` | `davide` |
| Luca | `luca` | `luca` |

**Al primo accesso cambia la password** (vedi sotto).

Ogni persona vede i **propri** documenti e quelli **condivisi in famiglia** (secondo i permessi impostati).

---

## Primo accesso e configurazione (browser)

### 1. Accedi al sito

1. Apri **https://docs.loogle.it** (da casa o in VPN — vedi sotto)
2. Inserisci **username** e **password**
3. Se è la prima volta, Paperless può chiederti di completare il profilo

### 2. Cambia la password

1. Clicca sul **nome utente** in alto a destra
2. Vai su **Profilo** / **Impostazioni**
3. Sezione **Password** → inserisci la vecchia e la nuova
4. Salva

### 3. Conosci l’interfaccia

| Area | A cosa serve |
|------|----------------|
| **Dashboard** | Panoramica, documenti recenti |
| **Documenti** | Elenco e ricerca di tutti i PDF |
| **Inbox** (se attiva) | Documenti appena caricati da revisionare |
| **Tag / Tipi / Corrispondenti** | Organizzazione (es. tag `bollette`, `salute`) |

### 4. Caricare un documento

**Da computer:**

1. **Documenti** → **Carica** (o trascina il PDF nella finestra)
2. Attendi l’OCR (qualche secondo)
3. Controlla titolo, data, tag → **Salva**

**Da telefono (browser):**

- Stesso procedimento dal browser mobile su docs.loogle.it

**Suggerimento:** usa tag semplici e coerenti, es. `bollette`, `casa`, `auto`, `salute`, `scuola`.

### 5. Cercare un documento

- Barra **Cerca** in alto: parole chiave (es. «enel», «bolletta», «assicurazione»)
- Filtri per **tag**, **tipo documento**, **data**
- Paperless cerca anche **dentro** il testo del PDF (OCR)

### 6. Scaricare o condividere

- Apri un documento → icona **Download** o **Condividi**
- Puoi inviare il PDF via email/WhatsApp dal telefono

---

## Accesso da fuori casa (VPN)

`docs.loogle.it` è raggiungibile **in rete di casa** (Wi‑Fi domestico o dati se sei a casa).

**Se sei fuori** (ufficio, viaggio): connettiti prima alla **VPN di casa**:

- Indirizzo: **https://vpn.loogle.it**
- Credenziali WireGuard: chiedi a Daniele (file `.conf` o QR code)

Dopo la VPN, apri normalmente https://docs.loogle.it o l’app Paperless.

---

## App sul telefono

Paperless **non ha un’app ufficiale** del team Paperless-ngx, ma esistono app **compatibili** che si collegano al nostro server.

### Consigliate

| App | Android | iPhone/iPad |
|-----|---------|-------------|
| **Paperless Mobile** | [Google Play](https://play.google.com/store/apps/details?id=de.astubenbord.paperless_mobile) | Cerca «Paperless Mobile» su App Store |
| **Paperless Go** | [Google Play](https://play.google.com/store/apps/details?id=com.github.iweinzierl.paperlessgo) / F-Droid | [App Store](https://apps.apple.com/app/paperless-go/id6738696198) |

Per la famiglia consigliamo **Paperless Mobile** (molto usata, italiano supportato) oppure **Paperless Go** (interfaccia moderna, scansione documenti).

---

## Installazione app — passo passo

### Android (Paperless Mobile)

1. Apri **Google Play Store**
2. Cerca **«Paperless Mobile»** (sviluppatore: Andrei Stübenbord)
3. **Installa**
4. Apri l’app → **Aggiungi account** / **Connect**
5. **URL server:** `https://docs.loogle.it`
6. **Username** e **password** (le tue credenziali Paperless)
7. Accetta eventuale avviso certificato (connessione sicura LOOGLE)
8. Fatto — vedi l’elenco documenti

### iPhone / iPad (Paperless Mobile o Paperless Go)

1. Apri **App Store**
2. Cerca **«Paperless Mobile»** o **«Paperless Go»**
3. **Scarica** e apri
4. Inserisci:
   - **Server URL:** `https://docs.loogle.it`
   - **Username** / **Password**
5. Opzionale: attiva **Face ID / Touch ID** per proteggere l’app
6. Fatto

### Scansione con il telefono (Paperless Go)

1. Nell’app → **Scansiona** / icona fotocamera
2. Inquadra il documento (bolletta, lettera)
3. Ritaglia e conferma
4. Scegli tag / tipo se richiesto → **Carica**
5. Il PDF compare in Paperless dopo pochi secondi

---

## Configurazione consigliata nell’app

| Impostazione | Consiglio |
|--------------|-----------|
| **Tema scuro** | Più comodo di sera |
| **Biometria** | Face ID / impronta per aprire l’app |
| **Notifiche** | Opzionali (nuovi documenti in inbox) |
| **Account multipli** | Un account per persona (non condividere la stessa login) |

---

## Buone abitudini

1. **Carica subito** bollette e documenti importanti (non lasciare pile di carta)
2. **Usa tag** — pochi ma chiari (`luce`, `gas`, `banca`, `medico`)
3. **Controlla l’inbox** — correggi titolo/data se Paperless sbaglia
4. **Non eliminare** l’originale cartaceo finché non sei sicuro che il PDF sia ok
5. **Cambia password** se pensi che qualcuno l’abbia vista

---

## Collegamento con l’assistente AI (MCP)

Se usi ChatGPT, Claude o Cursor collegati a **Loogle MCP** (`https://mcp.loogle.it`):

- Puoi chiedere: *«Cerca in Paperless la bolletta luce dell’ultimo trimestre»*
- L’AI cerca solo nei documenti **che il tuo account può vedere**
- Per funzionare, i documenti devono **già essere** in Paperless

La guida MCP è separata: `GUIDA-UTENTI.pdf` nella stessa cartella.

---

## Problemi comuni

| Problema | Cosa fare |
|----------|-----------|
| «Sito non raggiungibile» | Sei in rete casa? Se no, attiva **VPN** (vpn.loogle.it) |
| Login fallisce | Controlla username/password; prova da browser prima |
| App «connessione fallita» | URL esatto: `https://docs.loogle.it` (con **https**) |
| Certificato / SSL | Accetta il certificato LOOGLE; data/ora telefono corretta |
| Non vedo un documento | Potrebbe essere personale di un altro utente; chiedi a Daniele |
| OCR illeggibile | Scansiona con buona luce; PDF meglio di foto storta |

---

## Contatti

**Daniele** — account, permessi, VPN, problemi tecnici.

---

## Scheda rapida

```
Sito:        https://docs.loogle.it
VPN fuori:   https://vpn.loogle.it
App Android: Paperless Mobile (Play Store)
App iPhone:  Paperless Mobile o Paperless Go (App Store)
Server URL:  https://docs.loogle.it
Login:       il tuo username (lucia / davide / luca)
Primo passo: cambia password → installa app → carica una bolletta di prova
```

---

*Loogle — documenti di famiglia, a casa nostra.*