mevzuat

GET /mevzuat/ara — korpus geneli tam-metin arama.

🔴 **AYRI UÇ, ÇÜNKÜ AYRI SÖZ** (P3'ün özelge feed'i kararı). GET /mevzuat kütüphane RAFIDIR: "hangi belgeler var, en son ne güncellendi" sorusuna guncellendi desc ile cevap verir ve maddeye hiç inmez. Bu uç "bu kural korpusun NERESİNDE yazıyor" sorusuna cevap verir; sıralaması alaka, birimi hükümdür. İkisini tek uca bayrakla sıkıştırmak, rafın listesine hiç işine yaramayan iki sorgu yüklemek ve o listenin vermediği bir sözü onun ağzına koymak olurdu.

Bir beyannamenin mükellefe görünen tam hâli.

🔴 404 mesajı "yetkiniz yok" DEMEZ ve dememeli: RLS satırı zaten elediği için başka bir müvekkilin beyannamesi ile hiç var olmayan bir id **ayırt edilemez** — ayırt edilebilseydi uç, "bu büroda şu id'de bir beyanname var mı" sorusunu cevaplayan bir sızıntı olurdu.

GET /mevzuat/{id}/diff?eski=<v>&yeni=<v> — iki versiyon arasındaki fark (BLE22-8079).

Parametreler **opsiyoneldir**: verilmezse "son değişiklik" karşılaştırılır ([varsayilan_cift]) — müşavirin sorduğu soru neredeyse her zaman budur. # Errors * eski > yeni ⇒ **400.** 🔴 Ters sıra sessizce takas EDİLMEZ: alan adları (eski/yeni) bir sözleşmedir ve takas, ekranın yeni metni "eski" diye etiketlemesine yol açar — eklenenler silinmiş, silinenler eklenmiş görünür. (P3'ün "ters aralık sessizce boş dönmez" ve MÜF14'ün "gövde alanının ADI bir sözleşmedir" dersleri.) * Versiyon defterde yok ⇒ 404 · yetki yok ⇒ 403 · DB hatası.

GET /mevzuat/{id}/versiyonlar/{versiyon} — geçmiş metin (versiyon seçici).

Bakiye + defter.

🔴 .view yeterli — .manage DEĞİL. MÜF1'in rol matrisi dersi: ölçüt "mutasyon mu?" değil

"bu ROLÜN RUTİN İŞİ mi?". Not düşmek muhasebe_elemani/stajyerin günlük işidir ve ellerindeki tek izin V_MUKELLEF'tir; .manage istemek not defterini onlara kapatır. Not WORM olduğu için yanlış yazılan bir not "geri alınamaz idari eylem" de değildir — düzeltmesi yeni bir nottur.

Taslak faturayı sil (BLE2-7893). **Onaylı fatura silinmez** — iptal edilir.

GET /mevzuat/ara — korpus geneli tam-metin arama.

🔴 **AYRI UÇ, ÇÜNKÜ AYRI SÖZ** (P3'ün özelge feed'i kararı). GET /mevzuat kütüphane RAFIDIR: "hangi belgeler var, en son ne güncellendi" sorusuna guncellendi desc ile cevap verir ve maddeye hiç inmez. Bu uç "bu kural korpusun NERESİNDE yazıyor" sorusuna cevap verir; sıralaması alaka, birimi hükümdür. İkisini tek uca bayrakla sıkıştırmak, rafın listesine hiç işine yaramayan iki sorgu yüklemek ve o listenin vermediği bir sözü onun ağzına koymak olurdu.

Kunye

Ölü mektup defteri — "neden bu belge aranmıyor" sorusunun tek dürüst cevabı. SALT OKUNUR:

yeniden deneme platformundur (metin değişince kendiliğinden).

GET /mevzuat/kararlar — İçtihat / yargı kararları feed'i (MÜF15 P6 · BLE22-8122).

🔴 **AYRI UÇ, ÇÜNKÜ AYRI SÖZ** (P3'ün özelge kararının aynısı). /mevzuat?tur=yargi_karari bir KESİTTİR; bu ekran üç şey taahhüt eder ve üçü de ara_hın işi değildir: kararın künyesi (mercii · esas/karar no · kesinleşme) · her satırın hukuki AĞIRLIĞI · feed'in kendi tazeliğinin hesabı. Üçünü ara_ha bayrak olarak eklemek, kanun listesine hiç işine yaramayan üç sorgu yüklemek olurdu.

GET /mevzuat/kurumlar — süzgecin değer kümesi + kurum başına adet (MÜF15 P5).

GET /mevzuat/oranlar — kategori-sekmeli referans tablo (BLE22-8112).

Her kod için: sorulan tarihte **kapsayan** dönem + geçmiş/gelecek dönemler + dayanak.

GET /mevzuat/oranlar/{kategori}/{kod} — **bir kodun sorulan tarihteki değeri**

(BLE22-8106). 🔴 Üç hâl de **200** döner: boşluk bir istemci hatası DEĞİLDİR (P2'nin "çözümleme ucu 4xx dönmez" kararının kardeşi) ve 404 dönseydi ekran onu "böyle bir oran yok" diye gösterir, veri eksiğini kod hatası sanırdı. Hâl gövdededir (hal alanı). ⚠ kategori yol parçası **doğrulanır ama süzgeç değildir**: kodun kendi kategorisiyle uyuşmazsa 404 döner. Yolun anlamsız bir süs olması, aynı kodu iki farklı kategori altında çözülebilir yapardı ve bağlantılar sessizce yanlış sekmeye giderdi.

GET /mevzuat/ozelgeler — **Son 15 Özelge** feed'i (BLE2-7942/7946/7952).

## Neden AYRI bir uç (korpus tek tablo, tur=ozelge zaten çalışıyorken) Çünkü feed **başka bir söz veriyor**. /mevzuat?tur=ozelge bir KESİTTİR: sıralaması korpus damgası, uyarısı yok, tazeliği hakkında bir iddiası da yok. Feed ise adında "son" geçen bir ekrandır ve üç şeyi taahhüt eder: 1. sıra **özelgenin kendi tarihine** göredir (ozelge_feed), 2. **kendi tazeliğinin hesabını verir** (ozelge_kunyesi — HER yanıtta), 3. her satır **dayanağıyla birlikte** gelir (VUK 413 uyarısının yanında tek somut dayanak odur). Bu üçünü ara_ha bayrak olarak eklemek, kanun listesine hiç işine yaramayan üç sorgu yüklemek ve o ekranın vermediği bir sözü de onun ağzına koymak olurdu. 🔴 **DAYANAK BURADA OPSİYONEL DEĞİLDİR.** Tebliğ listesinde dayanak=true bir tercihti; özelgede dayanağın kendisi ekranın var oluş sebebine dâhildir: bağlayıcı olmayan bir görüşe bakan müşavirin elindeki TEK sağlam şey, o görüşün dayandığı hükümdür — ve o hüküm mülga olmuşsa özelge çifte ölüdür (ne bağlayıcı, ne dayanaklı).

Bakiye + defter.

🔴 .view yeterli — .manage DEĞİL. MÜF1'in rol matrisi dersi: ölçüt "mutasyon mu?" değil

"bu ROLÜN RUTİN İŞİ mi?". Not düşmek muhasebe_elemani/stajyerin günlük işidir ve ellerindeki tek izin V_MUKELLEF'tir; .manage istemek not defterini onlara kapatır. Not WORM olduğu için yanlış yazılan bir not "geri alınamaz idari eylem" de değildir — düzeltmesi yeni bir nottur.

Not

Taslak faturayı sil (BLE2-7893). **Onaylı fatura silinmez** — iptal edilir.