Mengapa Validasi Arsitektur Harus Otomatis
Arsitektur modular sering kali mengalami degradasi struktural (architectural erosion) seiring bertambahnya anggota tim dan kecepatan rilis. Aturan seperti domain layer tidak boleh mengimpor infrastructure layer sering terlanggar saat code review manual luput memeriksa dependency graph. Berdasarkan konsep evolutionary architecture oleh Neal Ford, Rebecca Parsons, dan Martin Fowler, architectural fitness functions menyediakan pengujian objektif dan otomatis untuk memverifikasi karakteristik integritas arsitektur pada setiap commit.
Deteksi Circular Dependency dan Isolasi Layer dengan dependency-cruiser
Untuk ekosistem modular JavaScript/TypeScript, dependency-cruiser memungkinkan pendefinisian aturan dependensi berbasis graph traversal. Konfigurasi ini mendeteksi circular dependency dan memastikan batasan layer Clean Architecture tetap terjaga.
Contoh file konfigurasi .dependency-cruiser.js:
module.exports = {
forbidden: [
{
name: 'no-circular',
severity: 'error',
comment: 'Cegah dependency cycle antar modul.',
from: {},
to: {
circular: true
}
},
{
name: 'domain-must-not-depend-on-infrastructure',
severity: 'error',
comment: 'Domain layer dilarang mengimpor komponen dari infrastructure layer.',
from: {
path: '^src/domain'
},
to: {
path: '^src/infrastructure'
}
},
{
name: 'modules-must-use-public-api',
severity: 'error',
comment: 'Akses antar modul domain harus melewati public interface index.ts.',
from: {
path: '^src/domain/([^/]+)'
},
to: {
path: '^src/domain/([^/]+)',
pathNot: [
'^src/domain/$1',
'^src/domain/$1/.*',
'^src/domain/[^/]+/index\.ts$'
]
}
}
],
options: {
doNotFollow: {
path: 'node_modules'
},
tsPreCompilationDeps: true,
tsConfig: {
fileName: 'tsconfig.json'
}
}
};Pendekatan JVM Menggunakan ArchUnit
Untuk Java dan Kotlin, ArchUnit mengeksekusi fitness functions sebagai bagian dari test runner standar (JUnit), menganalisis bytecode secara langsung tanpa memerlukan parser eksternal.
@AnalyzeClasses(packages = "com.app.core")
public class ArchitectureTest {
@ArchTest
public static final ArchRule domain_should_not_depend_on_infrastructure =
noClasses()
.that().resideInAPackage("..domain..")
.should().dependOnClassesThat()
.resideInAPackage("..infrastructure..");
@ArchTest
public static final ArchRule packages_must_be_free_of_cycles =
slices().matching("com.app.core.(*)..")
.should().beFreeOfCycles();
}Integrasi pada Pipeline CI/CD (GitHub Actions)
Fitness function harus menggagalkan build runner secara otomatis ketika rule dilanggar dengan memanfaatkan non-zero exit code. Berikut konfigurasi workflow GitHub Actions:
name: Architecture Fitness Check
on:
pull_request:
branches: [main]
jobs:
validate-architecture:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: 20
cache: 'npm'
- run: npm ci
- name: Run dependency-cruiser fitness function
run: npx depcruise src --config .dependency-cruiser.jsJika aturan dilanggar, tool menghasilkan exit code 1 yang langsung memblokir proses merge PR sebelum code reviewer menghabiskan waktu memeriksa code level logic.
Dampak terhadap Developer Experience (DX)
Menggeser validasi struktur ke pipeline CI menghasilkan beberapa keuntungan operasional:
- Mengeliminasi bikeshedding saat review: Reviewer fokus pada business logic, bukan menelusuri graph import satu per satu.
- Feedback loop cepat: Developer mengetahui batas domain yang dilanggar langsung di mesin lokal atau CI dalam hitungan detik.
- Dokumentasi hidup: Aturan batas modul didefinisikan secara deklaratif di kode repository, bukan dokumen teks arsitektur yang usang.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!