Prinsip Mutlak Pengembangan
Seluruh pengembang perangkat lunak diwajibkan mematuhi aturan baku berikut demi menjaga keterbacaan, kebersihan, dan kemudahan pemeliharaan jangka panjang sistem ITEC Solution Indonesia.1
Maksimal 500 Baris Per Berkas
Setiap berkas di antarmuka frontend maupun backend API dirancang modular dengan batas maksimal 500 baris kode. Setiap fitur dipecah menjadi komponen atau service modular yang rapi, independen, dan reusable.
2
Komponen Pagination Standar (DataTablePagination)
Seluruh antarmuka data table menggunakan komponen pagination seragam:
components/DataTablePagination.tsx, mencakup pemilihan baris per halaman (10, 25, 50, 100), status rentang data, tombol navigasi first/prev/angka/next/last, dan performa instan tanpa lag.Struktur Hierarki Komponen Frontend
Modul antarmuka diorganisir mengacu pada konsep Atomic Design:Arsitektur Backend Go (itec-api)
Pada modul backend Golang:
- Pemisahan Handler:
- CRUD dasar diletakkan di
[entity]_handler.go. - Alur kerja khusus (approval, email, validasi, konversi) diletakkan di
[entity]_actions_handler.go.
- CRUD dasar diletakkan di
- Service Layer: Logika bisnis dan transaksi database diisolasi dari HTTP context.
- Cascade Clean-up: Penghapusan data membersihkan relasi child secara bersih dalam satu transaksi database (
tx).