{"id":124,"date":"2026-10-30T06:07:00","date_gmt":"2026-10-30T06:07:00","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=124"},"modified":"2026-10-30T06:07:00","modified_gmt":"2026-10-30T06:07:00","slug":"archunit-module-boundaries","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/10\/30\/archunit-module-boundaries\/","title":{"rendered":"Mod\u00fcl S\u0131n\u0131rlar\u0131n\u0131 Testle Korumak: ArchUnit"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Projenin ba\u015f\u0131nda bir mimari diyagram \u00e7izilir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kutular ve oklar. Sipari\u015f mod\u00fcl\u00fc fatura mod\u00fcl\u00fcn\u00fc sadece belirli bir API \u00fczerinden \u00e7a\u011f\u0131r\u0131r. Domain katman\u0131 altyap\u0131ya ba\u011f\u0131ml\u0131 de\u011fildir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bir y\u0131l sonra kodda \u015fu sat\u0131r vard\u0131r:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>import com.example.billing.internal.InvoiceRepository;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Sipari\u015f mod\u00fcl\u00fc, fatura mod\u00fcl\u00fcn\u00fcn repository&#8217;sine do\u011frudan eri\u015fiyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kimse bilerek yapmad\u0131. Bir hata d\u00fczeltilirken, bir deadline yeti\u015ftirilirken, IDE&#8217;nin \u00f6nerdi\u011fi ilk import kabul edildi.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Diyagram h\u00e2l\u00e2 ayn\u0131. Kod art\u0131k ba\u015fka bir \u015fey anlat\u0131yor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mimari kurallar dok\u00fcmanda kal\u0131rsa<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Mimari kurallar genellikle bir wiki sayfas\u0131nda veya bir ADR&#8217;de yaz\u0131l\u0131d\u0131r. Code review s\u0131ras\u0131nda bu kurallar\u0131 hat\u0131rlamak reviewer&#8217;\u0131n dikkatine kal\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Y\u00fczlerce dosyal\u0131k bir pull request&#8217;te tek bir import sat\u0131r\u0131n\u0131 fark etmek zordur.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kurallar otomatik olarak kontrol edilmedik\u00e7e, zamanla a\u015f\u0131nmas\u0131 ka\u00e7\u0131n\u0131lmazd\u0131r.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">ArchUnit<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">ArchUnit, Java kodunun yap\u0131s\u0131n\u0131 analiz edip mimari kurallar\u0131 birim testleri olarak yazmay\u0131 sa\u011flayan bir k\u00fct\u00fcphane.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Katman kural\u0131:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ArchTest\nstatic final ArchRule layers = layeredArchitecture()\n    .consideringAllDependencies()\n    .layer(\"Web\").definedBy(\"..web..\")\n    .layer(\"Service\").definedBy(\"..service..\")\n    .layer(\"Persistence\").definedBy(\"..persistence..\")\n    .whereLayer(\"Web\").mayNotBeAccessedByAnyLayer()\n    .whereLayer(\"Service\").mayOnlyBeAccessedByLayers(\"Web\")\n    .whereLayer(\"Persistence\").mayOnlyBeAccessedByLayers(\"Service\");<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Mod\u00fcl s\u0131n\u0131r\u0131:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ArchTest\nstatic final ArchRule billingInternals = noClasses()\n    .that().resideOutsideOfPackage(\"..billing..\")\n    .should().dependOnClassesThat()\n    .resideInAPackage(\"..billing.internal..\");<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Biri fatura mod\u00fcl\u00fcn\u00fcn i\u00e7 s\u0131n\u0131flar\u0131n\u0131 import etti\u011finde test k\u0131r\u0131l\u0131r. Hata mesaj\u0131 hangi s\u0131n\u0131f\u0131n hangi kural\u0131 ihlal etti\u011fini a\u00e7\u0131k\u00e7a s\u00f6yler.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kural art\u0131k bir \u00f6neri de\u011fil, build&#8217;in par\u00e7as\u0131.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">D\u00f6ng\u00fcsel ba\u011f\u0131ml\u0131l\u0131klar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Mod\u00fcller aras\u0131ndaki d\u00f6ng\u00fcsel ba\u011f\u0131ml\u0131l\u0131klar, bir mod\u00fcler monolitin zamanla b\u00fcy\u00fck bir \u00e7amur topuna d\u00f6n\u00fc\u015fmesinin en tipik i\u015faretlerinden biri.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ArchTest\nstatic final ArchRule noCycles = slices()\n    .matching(\"com.example.(*)..\")\n    .should().beFreeOfCycles();<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Sipari\u015f mod\u00fcl\u00fc faturay\u0131, fatura mod\u00fcl\u00fc sipari\u015fi \u00e7a\u011f\u0131r\u0131yorsa bu test k\u0131r\u0131l\u0131r. D\u00f6ng\u00fc, iki mod\u00fcl\u00fcn asl\u0131nda ayr\u0131 olmad\u0131\u011f\u0131n\u0131 g\u00f6sterir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mevcut projeye eklemek<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Y\u0131llard\u0131r geli\u015ftirilen bir projeye ArchUnit eklendi\u011finde, kurallar\u0131n ilk \u00e7al\u0131\u015ft\u0131rmada y\u00fczlerce ihlal bulmas\u0131 muhtemeldir.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Hepsini d\u00fczeltmeden testi aktif etmek m\u00fcmk\u00fcn de\u011fil gibi g\u00f6r\u00fcn\u00fcr. ArchUnit&#8217;in freezing rules \u00f6zelli\u011fi bunun i\u00e7in var. Mevcut ihlaller bir dosyaya kaydedilir ve kabul edilir. Test sadece yeni ihlallerde k\u0131r\u0131l\u0131r.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mevcut bor\u00e7 g\u00f6r\u00fcn\u00fcr hale gelir ama b\u00fcy\u00fcmesi durur. Ekip zamanla mevcut ihlalleri azaltabilir.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Spring Modulith<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Spring tabanl\u0131 projelerde Spring Modulith de benzer bir amaca hizmet ediyor. Ana paket alt\u0131ndaki her alt paketi bir mod\u00fcl kabul ediyor, mod\u00fcller aras\u0131 eri\u015fimi do\u011fruluyor ve mod\u00fcl yap\u0131s\u0131n\u0131n dok\u00fcmantasyonunu \u00fcretebiliyor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mod\u00fcller aras\u0131 ileti\u015fimi uygulama event&#8217;leri \u00fczerinden kurmay\u0131 ve mod\u00fclleri izole \u015fekilde test etmeyi de kolayla\u015ft\u0131r\u0131yor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Kurallar az ve net olmal\u0131<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Her \u015feyi kurala ba\u011flamak, testleri k\u0131r\u0131lgan ve can s\u0131k\u0131c\u0131 hale getirir. Ekip kurallar\u0131 a\u015fman\u0131n yollar\u0131n\u0131 aramaya ba\u015flar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Bence birka\u00e7 temel kural yeterli: mod\u00fcllerin i\u00e7 paketlerine d\u0131\u015far\u0131dan eri\u015fim olmamas\u0131, d\u00f6ng\u00fcsel ba\u011f\u0131ml\u0131l\u0131k olmamas\u0131 ve domain kodunun altyap\u0131 detaylar\u0131na ba\u011f\u0131ml\u0131 olmamas\u0131.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mimari, diyagramlarda de\u011fil kodda ya\u015far.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ve kodun mimariye uyup uymad\u0131\u011f\u0131n\u0131 her commit&#8217;te hat\u0131rlatan bir test, en ikna edici dok\u00fcmantasyondur.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Mimari diyagramda mod\u00fcller birbirinden ayr\u0131, kodda ise her \u015fey her \u015feyi import ediyor. ArchUnit ile katman ve mod\u00fcl kurallar\u0131n\u0131 otomatik testlere d\u00f6n\u00fc\u015ft\u00fcrmek.<\/p>\n","protected":false},"author":1,"featured_media":123,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"class_list":["post-124","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-mimari"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/124","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/comments?post=124"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/124\/revisions"}],"predecessor-version":[{"id":202,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/124\/revisions\/202"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media\/123"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=124"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=124"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=124"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}