🇹🇷 Türkçe · 🇬🇧 English

---

Excel Denetim Raporu Üreticisi

.xlsx ve .xlsm dosyalarını tarayıcıda işleyip LLM ile denetim için yapılandırılmış bir Markdown raporu üretir. Dosya hiçbir sunucuya gönderilmez.

Çalıştırma

index.html dosyasını doğrudan tarayıcıda açın — çift tıklamak yeterli (file:// desteklenir, build adımı veya yerel sunucu gerekmez).

GitHub Pages veya python -m http.server 8000 ile de çalışır; sadece tarayıcıda CDN'den SheetJS çekebilmek için internet bağlantısı yeterli.

Standalone tek-dosya sürümü

.js dosyalarına izin vermeyen ortak ağ sürücüleri (FSRM "Executable Files" kuralı vb.) için tek dosyalık (CSS+JS inline) sürüm: uygulamayı normal şekilde açın, sayfanın altındaki "⬇ Tek-dosya (standalone) sürümünü indir" butonuna basın — anlık olarak güncel kaynaktan üretilip index.html adıyla indirilir.

İndirilen dosya tek başına çalışır, klasör yapısına ihtiyacı yok. Repoda hazır bir bundle tutulmaz; daima en son koddan üretilir, sync drift olmaz.

Kullanım

1. .xlsx veya .xlsm dosyanızı dropzone'a sürükleyin (veya "dosya seçin").
2. Analiz Et butonuna basın.
3. Hassas veri triajı: raporda görünecek benzersiz değerler 3 sekmeli (Metin / Sayısal / Ondalıklı) bir grid'de gelir; gizlemek istediklerinizi tek tek ya da "Hepsini Seç" ile işaretleyin → Bitti.
4. Üretilen raporu Panoya Kopyala veya Raporu İndir (.md / .txt seçilebilir) ile alın, LLM'inize yapıştırın.
5. Tek bir sheet ve onun çapraz referans verdiği sheet'leri içeren odaklı bir alt-küme almak için: result alanındaki Alt küme seçicisinden sheet'i seçip Sheet+bağlıları indir.

LLM Prompt Şablonu

LLM'inize ne sormak istediğinizden emin değilseniz, hazır bir prompt şablonu var: docs/PROMPT.md. Bu şablon LLM'e iki bölümlü bir analiz yaptırır:

1. Genel iş kuralları — workbook'un amacı, baskın şablonlar, sheet'ler arası akış, anomaliler
2. Sheet bazlı analiz — her sheet için görevi, önemli formüller, dikkat noktaları

docs/PROMPT.md'nin içeriğini kopyalayın, sonuna ürettiğiniz Markdown raporu yapıştırın, LLM'e gönderin.

Meraklısına: nasıl çalışıyor?

Aracın kapakaltındaki mantığı (neden tarayıcıdan çıkmıyor, "skeleton" ne demek, KDV hatası tek bakışta nasıl ortaya çıkıyor) teknik olmayan bir dille anlatan kısa bir yazı: docs/HOW_IT_WORKS.md.

Bağımlılıklar

index.html CDN'den tek dosya çeker:

• SheetJS xlsx@0.20.3 (Excel parse + CFB)

İnternet bağlantısı yoksa CDN scripti cdn.jsdelivr.net fallback'ine düşer.

Mimari

Tek sayfa, vanilla JS. Build adımı yok, npm yok. Modüller klasik <script> tag'leriyle bağımlılık sırasına göre yüklenir; her modül window.EA.<modul> namespace'ine yazar (IIFE) — file:// üzerinden çift tıkla açma çalışsın diye.

.
├── LICENSE          # PolyForm Noncommercial 1.0.0
├── README.md        # Türkçe (varsayılan)
├── README.en.md     # English
├── docs/
│   ├── PROMPT.md        # LLM analiz prompt şablonu (TR)
│   ├── PROMPT.en.md     # LLM analiz prompt şablonu (EN)
│   ├── HOW_IT_WORKS.md     # Çalışma algoritması açıklaması (TR)
│   └── HOW_IT_WORKS.en.md  # Çalışma algoritması açıklaması (EN)
├── index.html       # HTML iskelet, CDN script, modül yükleme sırası
├── css/styles.css   # Sade CSS (sistem font, max-width 900px)
└── js/
    ├── parse.js     # SheetJS workbook + sheet metadata + formül toplama
    ├── patterns.js  # Tokenizer + skeleton patternize + groupByPattern + compactRanges
    ├── analysis.js  # Sabitler + sayfa-arası ref + workbook-seviyesi şablon aggregation
    ├── triage.js    # Hassas veri triaj modali (sekmeli grid)
    ├── markdown.js  # Markdown rapor montajı (full + alt-küme)
    └── main.js      # DOM olayları + pipeline + standalone bundle indirme

Sürüm Günlüğü

• M1 — İskelet + dosya yükleme: Drag-drop, SheetJS yükleme, sheet listesi.
• M2 — Düz formül listesi: Sheet başına Hücre | Formül | Tip | Değer tablosu, async yield ile UI bloklamadan ilerleme.
• M3 — Patern motoru: Tek-pas regex tokenizer, anchor-bazlı patern üretimi, sütun-bazlı range compaction (C2:C100).
• M4 — Sabitler + cross-sheet: Hardcoded sayısal sabit ve sayfa-arası referans tabloları, tek-seferlik formül listesi.
• M5 — Named ranges, external links, gizli sayfalar: Workbook meta toplulaştırması ve genel rapor şekli.
• Hassas veri triajı: sekmeli (Metin/Sayısal/Ondalıklı) grid + filtre + toplu seçim; işaretlenenler raporda ***.
• Sheet alt-kümesi: seçilen sheet ve doğrudan referans verdiği sheet'leri içeren odaklı, kısa Markdown indirme.
• Standalone bundle butonu: kaynaktan canlı CSS+JS inline tek-dosya index.html üretir; repoda generated dosya tutulmuyor.
• PolyForm Noncommercial 1.0.0 lisansı: ticari kullanım yasak; tüm kaynak dosyalarda SPDX header.
• Semantik sıkıştırma: Tüm sayısal sabitler skeleton'da {const} ile abstrakte; aynı skeleton'ı paylaşan formüller workbook seviyesinde tek "Şablonlar" tablosunda; sabit dağılımı ve outlier hücre tespiti otomatik. Per-column tutarsızlık analizi kaldırıldı (Şablonlar tablosu işlevini daha keskin yapıyor).
• İndirme formatı: .md (varsayılan) veya .txt selectbox'tan seçilir.
• Prompt şablonu: docs/PROMPT.md — LLM'e raporu yorumlatmak için hazır 2 bölümlü (genel iş kuralları + sheet bazlı analiz) şablon.
• M6 (sonra): VBA makro çıkarma (MS-OVBA dekompresyonu).