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

オープン 初心者向け
#1,042 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
72/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
python

調査の方向性

まず backend/app/api/v1/endpoints/feature_flags.py を読み、その監査エントリの書き込み動作を、docs/api/endpoints.md に記載されたトランザクション保証と比較します。threat model の表および docs/architecture/overview.md にある監査ログに関する記述も確認します。完了とは、各リソースの永続性保証がドキュメントで明確に示され、best-effort の監査エントリについては、記録されなかったエントリが既存の監査失敗メトリクスで確認できることが説明されていることを意味します。

索引モデルが issue の本文から書いたものです。

説明

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).

主要言語
Python
スター
0
フォーク
4
平均マージ
5時間 19分
マージ済み PR(30日)
503

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Controlvar/controlvar のほかの issue

Controlvar/controlvar の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。