Un'app mobile e un pannello di amministrazione spesso condividono account, dati e regole di business. FlowApps LAB sviluppa backend .NET e ASP.NET Core che collegano questi client ai dati relazionali e ad altri sistemi. Si parte dalle operazioni che gli utenti devono svolgere, per poi definire l'API in base a permessi, dati in ingresso e risultati attesi.
Distinguere l'identificazione di un utente dalla decisione su ciò che può fare. Definire titolarità dei dati, ruoli, gestione delle sessioni e controlli dei permessi nell'API: nascondere un pulsante nel client non è una regola di accesso.
Mantenere le regole condivise sul server, così che i client mobili e di amministrazione non producano risultati incompatibili. Specificare campi obbligatori, cambi di stato consentiti, richieste duplicate e modalità di comunicazione di un'operazione rifiutata.
Definire dati e relazioni prima di scegliere gli endpoint. Il lavoro con PostgreSQL o SQL Server può comprendere progettazione dello schema, query e migrazioni. Per i sistemi esterni, chiarire responsabilità sui dati, credenziali, gestione degli errori e condizioni per ripetere una richiesta in sicurezza.
Questo esempio immaginario di richiesta di lavoro illustra i confini del sistema; non è un caso cliente né una descrizione di VitaFlow.
Un utente autenticato invia una richiesta di lavoro con l'identificativo del record e l'azione desiderata. Il client mostra i riscontri della validazione e non decide i permessi degli altri utenti.
L'API verifica identità, accesso al record e transizione di stato consentita. Rifiuta dati non validi oppure esegue l'operazione, restituendo un risultato documentato che entrambi i client possano interpretare.
Il livello dati salva la modifica rispettando relazioni e transazioni necessarie. L'API restituisce lo stato salvato; un errore di integrazione richiede un percorso di recupero definito, anziché una risposta di successo fuorviante.
Documentare strutture di richieste e risposte, errori, paginazione e compatibilità. Verificare operazioni riuscite e rifiutate, compresi gli errori di integrazione. Prima della pubblicazione, concordare configurazione degli ambienti, gestione dei segreti, migrazioni, log, responsabilità sui backup e procedure di ripristino. Accesso e responsabilità dell'hosting incidono sul lavoro: la preparazione alla produzione fa parte della definizione dell'ambito e non si deduce dal numero di endpoint.
Portare esempi di operazioni reali e vincoli attuali aiuta a distinguere una piccola integrazione da un backend responsabile di un intero processo.