Feature-flag changes can be saved without a compliance audit entry; state the audit log's durability per resource

Aperta Adatta ai principianti
  • Qualcosa non va?
#1,042 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
python
Ambito
backend, documentation

Direzione di ricerca

Inizia con backend/app/api/v1/endpoints/feature_flags.py, quindi confronta il suo comportamento nella scrittura delle voci di audit con la garanzia transazionale descritta in docs/api/endpoints.md. Leggi anche le affermazioni sul log di audit nella tabella del threat model e in docs/architecture/overview.md. Completare il lavoro significa che la documentazione indica chiaramente la garanzia di durabilità di ogni risorsa e, per le voci di audit best-effort, spiega che le voci mancate sono visibili tramite la metrica esistente per gli errori di audit.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement post-launch

Feature-flag create, update and delete write their compliance audit entry after the flag change has been committed, and a failure to write it is logged and ignored (backend/app/api/v1/endpoints/feature_flags.py, e.g. lines ~364-384: "non-fatal: do not fail the request if this fails"). So a flag change can be saved with no compliance audit entry. User administration is different: docs/api/endpoints.md states that its audit entry is written in the same transaction and that nothing is saved if it cannot be written.

The docs describe the audit log as an "immutable audit trail" (the threat-model table and docs/architecture/overview.md), which readers can take to mean complete.

Expected: state the durability promise per resource. Either write the flag's audit entry in the same transaction (as user administration does), or say in the audit-logging docs which changes are recorded best-effort and how a missed entry is visible (the existing audit-failure metric). Found in a code review (2026-10-06).

Lingua principale
Python
Stelle
0
Fork
4
Merge medio
5h 19m
PR unite (30g)
503

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di Controlvar/controlvar

Tutte le issue di Controlvar/controlvar

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.