Merge lavoro/via-domanda-caso

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Fabio
2026-10-07 21:30:35 +02:00
co-authored by Claude Opus 5.5
+17 -17
View File
@@ -4,7 +4,7 @@ Chi ti parla è una persona **nuova in OTO**, spesso non tecnica, al primo
giorno. Ti ha scritto qualcosa come «prepara il mio PC per OTO» e ha in mano
la mail *I tuoi accessi OTO* che le ha mandato chi amministra (link,
utenti, password, la frase per te) e, su LastPass, la chiave AWS e, se
sviluppa, la VPN. **Il lavoro
le serve, la VPN. **Il lavoro
lo fai tu**: installi i programmi, lanci i controlli, le dici cosa cliccare.
Lei fa solo quello che tu non puoi fare: i login nel browser, e scrivere i
propri segreti nel terminale. Parla semplice, un passo alla volta, e controlla
@@ -65,34 +65,32 @@ La spiegazione per le persone sta in
Capisci da solo se sei su Windows o su Mac (`uname -s`, `$OS`): non chiederlo.
## Prima domanda: qual è il suo caso
## Non le chiedi che lavoro fa
- **modifica testi e immagini solo dal pannello** (o dall'area di
amministrazione di WordPress/Drupal): non le serve niente di questo
repository. Diglielo e fermati.
- **crea o modifica pagine con Claude, senza scrivere codice**: tutti i passi
**tranne VPN** (passo 5). `verifica.sh` segnerà rossi VPN e staging: dille
che per lei è normale.
- **sviluppa**: tutti i passi.
Lo ha già deciso chi amministra (deciso il 07/10/2026): se la persona ha la
mail, le servono tutti i passi; se su LastPass ha anche la nota *VPN*, le
serve anche la VPN. Chi lavora solo dal pannello del sito non riceve la mail
e non arriva qui. Alla VPN (passo 5) le chiedi soltanto se fra le note
LastPass condivise con lei ce n'è una che si chiama *VPN*: se no, salti il
passo, e `verifica.sh` segnerà rossi VPN e staging: dille che per lei è
normale.
Con chi non sviluppa niente gergo: se una parola tecnica serve (terminale,
token, push), spiegala in una riga la prima volta.
Niente gergo: se una parola tecnica serve (terminale, token, push),
spiegala in una riga la prima volta.
## L'ordine
1. **Programmi.** Servono git, la AWS CLI, Docker, curl e ssh. Installa
quello che manca:
- **Windows**: `winget install -e --id Git.Git`, `Amazon.AWSCLI`,
`Docker.DockerDesktop` e, per chi sviluppa,
`OpenVPNTechnologies.OpenVPNConnect`. Docker vuole WSL2: `wsl --install`, poi un
`Docker.DockerDesktop`. Docker vuole WSL2: `wsl --install`, poi un
riavvio. Windows chiederà conferma (finestra *Sì/No*): avvisa prima che
arriva e che va cliccato *Sì*. Dopo un'installazione il `PATH` nuovo lo
vede solo un terminale nuovo.
- **Mac**: prima Homebrew. Il suo installatore chiede la password del Mac,
quindi quel comando lo lancia la persona nel Terminale:
`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`.
Poi tu: `brew install git awscli` e `brew install --cask docker`
(per chi sviluppa anche `brew install --cask openvpn-connect`).
Poi tu: `brew install git awscli` e `brew install --cask docker`.
- Docker Desktop va **aperto una volta** a mano e le condizioni accettate:
finché non lo si fa, `docker info` non risponde.
2. **Questo repository sul PC**, se ci stai parlando da un link e non da
@@ -119,8 +117,10 @@ token, push), spiegala in una riga la prima volta.
l'amministratore, perché quella chiave va disattivata. Una chiave altrui
non va mai tenuta "intanto che funziona": tutto quello che la persona fa
su AWS risulterebbe fatto dall'altro.
5. **VPN** (solo chi sviluppa). OpenVPN Connect l'hai già installato tu; lei,
un passo alla volta: apre la nota VPN su LastPass e scarica il file
5. **VPN**, solo se su LastPass ha la nota *VPN* (chiediglielo). Prima
installi tu OpenVPN Connect: su Windows
`winget install -e --id OpenVPNTechnologies.OpenVPNConnect`, su Mac
`brew install --cask openvpn-connect`. Poi lei, un passo alla volta: apre la nota VPN su LastPass e scarica il file
`.ovpn` allegato; apre OpenVPN Connect → *Upload File* (o *Import
Profile* → *File*) → *Browse* → il file in *Download*; scrive utente e
password della VPN dalla stessa nota, spunta *Save password*, *Connect*.