La Pipeline di Analisi Salesforce Local-First
SF Analyzer combina l'estrazione deterministica dei metadati con la documentazione AI selettiva. Ciascuno step viene eseguito localmente sul tuo PC, garantendo che codice e schemi dei clienti non tocchino mai il cloud.
Flusso di Analisi Passo-Passo
L'app desktop locale orchestra una pipeline a sei step dall'autenticazione dell'org fino alla stesura dei documenti tecnici guidata dall'AI.
Connessione Sicura dell'Org
Connetti il tuo ambiente Salesforce utilizzando OAuth standard basato sul web. SF Analyzer invoca la Salesforce CLI ufficiale (`sf org login web`) in background.
- I token di accesso rimangono nel portachiavi sicuro della Salesforce CLI.
- Il portale non riceve né fa mai da proxy per le credenziali Salesforce.
✔ Authorization succeeded. Saved credentials in local sf keychain.
Recupero Metadati Registry-Safe
Seleziona i tipi di metadati personalizzati (Apex Class, Field, Flow, Custom Object, LWC). Ispezioniamo il registro locale dei metadati di Salesforce per filtrare automaticamente i componenti non supportati, evitando crash di recupero API.
- Alimentato dalla libreria Node `@salesforce/source-deploy-retrieve`.
- Gestisce automaticamente le dipendenze di recupero e salta i tipi di API non validi.
try {
registry.getTypeByName("ActivationPlatformActvAttr"); Missing definition
} catch {
skipUnsupportedType("ActivationPlatformActvAttr");
}
Assemblaggio Lossless dello Snapshot
Uniamo il codice sorgente dei metadati grezzi con le informazioni di runtime (licenze attive, limiti di sistema, descrizioni dei campi degli oggetti e conteggi dei record). Questo crea un singolo file canonico: `snapshot.json`.
- Un singolo JSON rappresenta l'intero stato del tuo sviluppo personalizzato.
- Nessun dato viene inviato sul cloud; lo snapshot viene salvato nel workspace locale.
"metadata": { "ApexClass": ["AccountService"], "Flow": ["OrderProcess"] },
"runtime": { "limits": { "SingleEmail": 5000 }, "licenses": [...] },
"objects": { "Account": { "fields": [...], "recordCount": 24082 } }
}
Versioning del Git Store Locale
Ogni esecuzione di analisi viene versionata all'interno di un repository Git locale nella cartella di workspace dell'app. Utilizzando `isomorphic-git`, committiamo lo snapshot e assegniamo un tag unico per tracciare la cronologia.
- Abilita l'analisi del delta assoluto: ispeziona immediatamente cosa è cambiato tra due esecuzioni.
- Non è richiesto alcun server git esterno o token GitHub.
~ refactor(flow): OrderProcess.flow (modified)
- chore(class): OldRepository.cls (deleted)
Tag: analysis-2026-07-01_10-25
Generazione Wiki AI con BYO-Key
L'app desktop chiama direttamente il tuo provider AI configurato (OpenAI, Anthropic, Google) utilizzando la chiave modello memorizzata nel portachiavi del sistema operativo. Documentiamo classi, trigger e campi personalizzati, salvando l'output in pagine Markdown.
- Tracciamento del content-hash: documentiamo nuovamente solo i file che sono cambiati dall'ultima esecuzione.
- Risparmia costi e token di utilizzo, documentando in modo incrementale.
AccountTrigger.cls hash: 5c3b12 (unchanged) -> skipped (cache hit)
✔ Wrote wiki/AccountService.md with new updates.
Harness per TDD & Impatto Guidato
L'agente AI per i documenti viene eseguito localmente in background, utilizzando strumenti in sola lettura per esplorare il workspace. Guida gli sviluppatori nella stesura di documenti di progettazione tecnica (TDD) o valutazioni d'impatto basate su metadati reali.
- Strumento SOQL protetto: esegue solo query SELECT, protetto contro le scritture nel database.
- La guardia di copertura impedisce agli agenti AI di generare documenti senza analizzare i file.
Checking coverage guard: verified 4 related classes analyzed.
✔ Document exported to billing-sync-tdd.md.