Init

2026-07-30 09:41:42 +07:00
parent aef8e412a8
commit 3efac50f39
70 changed files with 3217 additions and 0 deletions
@@ -0,0 +1,267 @@
+# RayLab Core Phase 8 --- Development Workflow
+
+## Tujuan
+
+Fase 8 mendefinisikan alur kerja pengembangan (Development Workflow)
+RayLab Core agar proses implementasi, pengujian, review, dan rilis
+dilakukan secara konsisten.
+
+Dokumen ini menjadi standar kerja untuk seluruh pengembangan RayLab
+Core.
+
+------------------------------------------------------------------------
+
+# Prinsip
+
+-   Seluruh perubahan dapat dilacak.
+-   Setiap fitur dikembangkan secara terpisah.
+-   Kualitas kode lebih penting daripada kecepatan.
+-   Otomatisasi digunakan sebanyak mungkin.
+-   Dokumentasi diperbarui bersamaan dengan perubahan kode.
+
+------------------------------------------------------------------------
+
+# Development Lifecycle
+
+``` text
+Requirement
+      │
+      ▼
+Architecture
+      │
+      ▼
+Issue / Task
+      │
+      ▼
+Implementation
+      │
+      ▼
+Unit Test
+      │
+      ▼
+Integration Test
+      │
+      ▼
+End-to-End Test
+      │
+      ▼
+Code Review
+      │
+      ▼
+Merge
+      │
+      ▼
+Release
+```
+
+------------------------------------------------------------------------
+
+# Git Workflow
+
+## Branch Utama
+
+``` text
+main
+```
+
+Selalu berisi kode yang stabil.
+
+## Branch Pengembangan
+
+Gunakan branch terpisah untuk setiap pekerjaan.
+
+Contoh:
+
+``` text
+feature/identity
+feature/media-manager
+feature/api-users
+
+fix/login-session
+fix/storage-permission
+
+refactor/authorization
+
+docs/api-architecture
+```
+
+Satu branch hanya menangani satu tujuan.
+
+------------------------------------------------------------------------
+
+# Commit Convention
+
+Format commit:
+
+``` text
+type(scope): description
+```
+
+Contoh:
+
+``` text
+feat(identity): add user service
+fix(media): resolve folder permission bug
+docs(api): update endpoint documentation
+refactor(registry): simplify adapter registration
+test(users): add integration test
+```
+
+Jenis commit:
+
+-   feat
+-   fix
+-   docs
+-   refactor
+-   test
+-   chore
+-   ci
+
+------------------------------------------------------------------------
+
+# Pull Request Checklist
+
+Sebelum merge:
+
+-   Kode berhasil dikompilasi.
+-   Unit test lulus.
+-   Integration test lulus.
+-   E2E test lulus (jika relevan).
+-   Dokumentasi diperbarui.
+-   Migration ditinjau.
+-   Tidak ada perubahan yang tidak terkait.
+
+------------------------------------------------------------------------
+
+# Testing Strategy
+
+## Unit Test
+
+Menguji business logic secara terisolasi.
+
+Tool:
+
+-   Jest
+
+------------------------------------------------------------------------
+
+## Integration Test
+
+Menguji interaksi antar modul.
+
+Tool:
+
+-   Jest
+
+------------------------------------------------------------------------
+
+## End-to-End Test
+
+Menguji perilaku sistem dari sudut pandang pengguna.
+
+Tool:
+
+-   Playwright
+
+Standar ini mengikuti proses pengujian RayLab yang telah ditetapkan.
+
+------------------------------------------------------------------------
+
+# Code Review
+
+Fokus review:
+
+-   Kesesuaian dengan arsitektur.
+-   Kualitas business logic.
+-   Keamanan.
+-   Konsistensi penamaan.
+-   Keterbacaan kode.
+-   Dampak terhadap modul lain.
+
+Review tidak hanya memeriksa apakah kode berjalan, tetapi juga apakah
+kode sesuai dengan standar RayLab Core.
+
+------------------------------------------------------------------------
+
+# Database Workflow
+
+Perubahan database:
+
+1.  Ubah `schema.prisma`.
+2.  Buat migration.
+3.  Jalankan migration pada lingkungan pengembangan.
+4.  Perbarui dokumentasi jika diperlukan.
+
+Perubahan langsung pada database produksi tidak diperbolehkan.
+
+------------------------------------------------------------------------
+
+# Documentation Workflow
+
+Setiap perubahan yang memengaruhi arsitektur, API, atau modul harus
+diikuti dengan pembaruan dokumentasi.
+
+Area dokumentasi:
+
+-   Architecture
+-   API
+-   Module
+-   ADR
+-   Guide
+
+Dokumentasi menjadi bagian dari proses pengembangan.
+
+------------------------------------------------------------------------
+
+# Release Workflow
+
+``` text
+Development
+      │
+      ▼
+Testing
+      │
+      ▼
+Review
+      │
+      ▼
+Tag Release
+      │
+      ▼
+Docker Build
+      │
+      ▼
+Deployment
+```
+
+Setiap rilis menggunakan tag versi yang jelas.
+
+Contoh:
+
+``` text
+v1.0.0
+v1.1.0
+v2.0.0
+```
+
+------------------------------------------------------------------------
+
+# Definition of Done
+
+Sebuah pekerjaan dianggap selesai apabila:
+
+-   Implementasi selesai.
+-   Seluruh test lulus.
+-   Tidak ada error linting.
+-   Dokumentasi diperbarui.
+-   Migration tersedia (jika diperlukan).
+-   Telah melalui code review.
+
+------------------------------------------------------------------------
+
+# Hasil Akhir Fase 8
+
+Pada akhir fase ini RayLab Core memiliki standar workflow pengembangan
+yang mencakup implementasi, pengujian, review, dokumentasi, dan proses
+rilis. Workflow ini menjadi pedoman agar seluruh pengembangan tetap
+konsisten, berkualitas, dan mudah dipelihara dalam jangka panjang.