Documentazione · Requisiti di sistema

Lista di controllo pre-installazione

Scopo

Questa lista di controllo consolida tutto ciò che un'agenzia o un amministratore dovrebbe verificare prima di installare ADP Car Market Hub o prima di trasferire un'installazione di staging in produzione. È intenzionalmente pratica: ogni elemento corrisponde a un controllo concreto che può essere eseguito in pochi minuti sull'ambiente di hosting, sul sito WordPress o sull'account AutoScout24.

Quando utilizzare questo documento

Utilizza questo documento quando:

  • Gestisci l'onboarding di una nuova concessionaria e hai bisogno di una singola pagina per convalidare il loro hosting prima di installare il plugin.
  • Promuovi un sito appena creato da staging a produzione.
  • Esegui un audit di un'installazione esistente attiva da tempo che potrebbe essersi allontanata dai parametri di riferimento consigliati.
  • Consegni un sito a un'altra agenzia o al team IT interno del cliente.

Panoramica

La lista di controllo è raggruppata in nove aree. Ciascuna area presenta un piccolo numero di elementi sì/no. Considera qualsiasi "no" come un blocco per le importazioni in produzione fino a quando non viene risolto o esplicitamente approvato.

Per un contesto più approfondito su qualsiasi elemento, segui il link nella sezione Documenti correlati in fondo a questa pagina.

Lista di controllo

1. Hosting e runtime

  • [ ] PHP 8.1 o versioni successive è installato e attivo per il sito WordPress.
  • [ ] Il valore di PHP memory_limit è di almeno 256 MB (128 MB è il minimo assoluto accettato dalla scheda System & Help).
  • [ ] Il valore di PHP max_execution_time è di almeno 120 secondi; 300 secondi è consigliato per importazioni con molte immagini.
  • [ ] Le estensioni PHP openssl, curl, mbstring, json e una tra gd / imagick sono caricate; ZipArchive è disponibile per i pacchetti di esportazione.
  • [ ] Almeno 1 GB di spazio libero su disco è disponibile sul volume che ospita wp-content/uploads/; pianifica 5–25 MB per veicolo per i file multimediali.
  • [ ] Il server web esegue Nginx, Apache o un altro server supportato da WordPress con la riscrittura degli URL abilitata.

2. WordPress

  • [ ] WordPress 6.2 o versioni successive è installato.
  • [ ] HTTPS è attivo sul sito pubblico con un certificato valido.
  • [ ] I permalink sono impostati su un valore diverso da "Semplice" (necessario per l'endpoint REST di cron e per URL di archivio leggibili).
  • [ ] Un account amministratore è disponibile per l'installazione e la configurazione.
  • [ ] Nessun plugin di importazione veicoli / AutoScout24 in conflitto è attivo.
  • [ ] Esiste un ambiente di staging con le stesse versioni di PHP/MySQL della produzione.

3. Database

  • [ ] MySQL 5.7+ o MariaDB 10.3+ (corrispondenti ai requisiti minimi di WordPress) è in uso, con utf8mb4 come set di caratteri predefinito.
  • [ ] L'utente del database WordPress dispone dei privilegi CREATE, ALTER, INDEX, DROP, INSERT, UPDATE, DELETE e SELECT in modo che l'attivazione possa eseguire dbDelta() per le tabelle personalizzate del plugin.
  • [ ] I backup giornalieri del database sono configurati e ne è stato testato il ripristino almeno una volta.

4. Rete, API e SSL

  • [ ] Le connessioni HTTPS in uscita (TCP/443) sono consentite dal server web verso l'host API AutoScout24 configurato (es. api.autoscout24.com, api.autoscout24.ch, …) e verso gli host CDN delle immagini di AutoScout24.
  • [ ] La risoluzione DNS dal server web stesso funziona per gli hostname di AutoScout24.
  • [ ] Il pacchetto CA di sistema è aggiornato; l'eventuale intercettazione TLS in uscita installa la CA radice aziendale nel keystore di attendibilità del sistema.
  • [ ] Se è richiesto un proxy HTTP in uscita, le costanti WP_PROXY_* sono impostate in wp-config.php.
  • [ ] Se verrà utilizzata la generazione tramite intelligenza artificiale, le connessioni HTTPS in uscita verso generativelanguage.googleapis.com sono consentite. Le funzionalità di intelligenza artificiale utilizzano la configurazione gestita di Google Gemini in ADP Car Market Hub — non è necessario inserire alcun provider, modello o chiave API nel backend di WordPress; il provisioning dell'IA specifico per il cliente viene completato da AD Promotion dopo l'installazione.

5. Licenza e account AutoScout24

  • [ ] La chiave di licenza ADP Car Market Hub fornita da AD Promotion è a portata di mano. La licenza è necessaria per sbloccare le aree premium del plugin dopo l'attivazione; senza di essa, ogni scheda di amministrazione eccetto Impostazioni mostrerà una schermata "Licenza richiesta".
  • [ ] È attivo un account partner AutoScout24 con accesso API.
  • [ ] Il Client ID e il Client Secret sono stati emessi e memorizzati in modo sicuro (gestore di password o vault dei segreti).
  • [ ] Uno o più Seller ID sono noti e confermati come appartenenti alle concessionarie per cui si sta effettuando l'onboarding.
  • [ ] L'URL di base dell'API corretto per il mercato del concessionario è noto (es. https://api.autoscout24.ch per la Svizzera).
  • [ ] Gli IP di uscita del server di produzione sono stati condivisi con AutoScout24 se l'account richiede l'inserimento degli IP in whitelist.

6. Cron e processi in background

  • [ ] È stata scelta una strategia per il cron: WP-Cron (accettabile solo per siti piccoli o ad alto traffico) o cron di sistema (consigliato per la produzione).
  • [ ] Se viene scelto il cron di sistema, define( 'DISABLE_WP_CRON', true ); è stato aggiunto a wp-config.php.
  • [ ] Se viene scelto il cron di sistema, sono pianificate due voci di cron: una che chiama l'endpoint REST del plugin con il token segreto (ogni 15 minuti è un buon valore predefinito) e una che esegue wp-cron.php (ogni 5 minuti) per mantenere attive la coda delle immagini, la pulizia delle statistiche e altre attività ricorrenti.
  • [ ] Il token segreto del cron verrà memorizzato insieme alle credenziali e ruotato ogni volta che il personale con accesso lascia il progetto.
  • [ ] Sono pianificati token cron distinti per staging e produzione, in modo che un trigger di staging non possa avviare un'importazione di produzione.

7. Email

  • [ ] È configurato un percorso di posta elettronica transazionale funzionante (MTA di hosting, plugin SMTP puntato a un provider di recapito o relay aziendale).
  • [ ] L'allineamento SPF, DKIM e DMARC è stato verificato per il dominio di invio.
  • [ ] Le email di prova (notifica lead, attivazione avviso di ricerca, reimpostazione password di WordPress) sono state inviate e ricevute.

8. Backup, monitoraggio e operazioni

  • [ ] I backup esterni giornalieri coprono l'intero database di WordPress (comprese le tabelle personalizzate del plugin con prefisso {wp_prefix}as24_) e l'intera directory wp-content/uploads/, con almeno 7 giorni di conservazione (consigliati oltre 30 giorni).
  • [ ] Il ripristino del backup è stato testato almeno una volta.
  • [ ] Il monitoraggio dell'uptime è configurato sull'URL dell'archivio pubblico.
  • [ ] Il monitoraggio dell'uptime o del successo è configurato sull'endpoint del trigger cron quando si utilizza il cron di sistema.
  • [ ] L'avviso per lo spazio su disco è configurato per il volume che ospita wp-content/uploads/.
  • [ ] Esistono un contatto reperibile e un percorso di escalation documentato per gli incidenti in produzione.

9. Convalida pre-lancio in WordPress

  • [ ] Plugin installato e attivato in staging.
  • [ ] Licenza attivata in Impostazioni → Attivazione licenza in modo da sbloccare le altre schede di amministrazione (nessuna schermata "Licenza richiesta").
  • [ ] Impostazioni completate: URL di base dell'API, URL del token (se necessario), Client ID, Client Secret, Seller ID.
  • [ ] Scheda Strumenti → Test connessione restituisce esito positivo.
  • [ ] La scheda System & Help / Stato di salute mostra indicatori verdi per PHP, database, spazio su disco, cron, API e (se configurato) AI Assistant.
  • [ ] Un'importazione di prova tramite la procedura guidata Batch-Wizard ha prodotto gli articoli dei veicoli, le tassonomie e i media previsti.
  • [ ] Le pagine del singolo veicolo e l'archivio vengono visualizzati correttamente con il tema attivo.
  • [ ] Sono stati inviati un lead di prova e un'iscrizione di prova all'avviso di ricerca e sono state ricevute le relative email.
  • [ ] La modalità cron, la pianificazione, il limite di veicoli per esecuzione e la coda delle immagini sono stati definiti nella scheda Importazione e limiti.
  • [ ] Un'importazione è stata eseguita dall'inizio alla fine tramite il trigger equivalente alla produzione (cron di sistema o alternativa scelta).
  • [ ] La stessa lista di controllo è stata riconvalidata in produzione dopo il trasferimento.

Approvazione

Prima di abilitare le importazioni in produzione, conferma che ogni elemento sopra indicato sia spuntato o formalmente accettato come limitazione nota, e registra:

  • Chi ha eseguito i controlli e in quale data.
  • La versione del plugin installata (vedi la pagina dei plugin di WordPress).
  • Le versioni di PHP, WordPress e del database in uso.
  • La modalità cron e la pianificazione configurate.
  • Il proprietario delle credenziali AutoScout24 e del token segreto del cron.

Un breve file di testo o una pagina wiki con le informazioni sopra indicate è sufficiente e semplifica notevolmente le successive richieste di supporto.

Documenti correlati