Lewati ke konten
DispatchAtlas
Cari

Higiene repositori

Kendali versi DispatchAtlas berisi sumber, pengujian, konfigurasi, dokumentasi, dan metadata reproduktibel yang ditulis tangan. Produk eksekusi lokal tetap di luar Git kecuali sebuah kebijakan secara eksplisit mempromosikannya menjadi sumber.

🧹 Kebijakan keluaran yang dihasilkan

Data eksperimen yang dihasilkan, checkpoint, paket hasil, laporan cakupan, keluaran build docs, artefak paket, dan kandidat rilis diabaikan secara default. Mereka diregenerasi dari sumber dan dicatat melalui provenans ketika gate berikutnya mempromosikannya.

Berkas yang dihasilkan dan terlacak membutuhkan:

  • Seorang pemilik sumber.
  • Sebuah perintah regenerasi.
  • Sebuah rasional retensi.
  • Sebuah jalur peninjauan untuk keluaran usang.

🗃️ Kebijakan cache

Cache lokal dari Python, Ruff, mypy, pytest, cakupan, build dokumentasi, dan lingkungan virtual diabaikan. CI boleh men-cache dependensi, tetapi kunci cache harus diturunkan dari lockfile dan input alur kerja.

🔬 Kebijakan keluaran eksperimen lokal

Eksekusi eksperimen lokal menulis ke lapisan keluaran yang diabaikan dari ruang kerja eksperimen — hasil eksekusi, log, checkpoint, dan paket bukti, sebagaimana ditata di README ruang kerja itu sendiri — bersama lokasi scratch lain yang diabaikan seperti outputs/ atau artifacts/. Bukti penelitian final diproduksi melalui perintah kampanye dan analisis tervalidasi sebelum penggunaan publik apa pun.

📋 Aturan retensi artefak

Kelas artefakLokasi defaultStatus GitRetensi
Build paketdist/DiabaikanBangun ulang sesuai permintaan.
Build docssite/out/DiabaikanBangun ulang sesuai permintaan.
Cakupanhtmlcov/, .coverage*DiabaikanBangun ulang selama pemeriksaan kualitas.
Keluaran asapoutputs/DiabaikanSimpan secara lokal hanya saat debugging.
Hasil kampanyelapisan hasil dan checkpoint ruang kerja eksperimenDiabaikanPromosikan hanya melalui ekspor ber-gate-provenans.
Bukti rilisartifacts/Diabaikan sampai disetujuiTahan sesuai kebijakan kandidat rilis.