Skip to main content

Repo Fit

Questo monorepo è più grande di gb-travio-webhooks, ma dovrebbe mantenere la stessa postura operativa.

Regole di continuità

  • scrivere README diretti
  • mantenere espliciti lo stato del runtime e le superfici di replay
  • preferire configurazioni tipizzate al comportamento implicito basato sull’ambiente
  • trattare l’auditability e i recapiti rifiutati come requisiti di prodotto
  • mantenere la CI sufficientemente leggibile da poter essere verificata rapidamente
  • rilasciare tramite GitHub, non da un laptop

Standard per le PR

Ogni PR di funzionalità dovrebbe includere:
  • codice tipizzato
  • test per il percorso principale e almeno un percorso di fallimento
  • documentazione per superfici runtime nuove o modificate
  • note esplicite dove il comportamento mock sostituisce ancora la persistenza durevole

Standard per il Runtime

Ogni superficie operativa dovrebbe documentare:
  • percorso dell’endpoint
  • modello di autenticazione
  • forma della richiesta e della risposta
  • modalità di fallimento
  • postura di retry o replay

Prossime letture