Python ile 400 Sayfalık Dizel Arıza Kodları Veritabanı Nasıl Oluşturulur?

Geçen yıl Texas’ta küçük bir nakliyat şirketi işleten babamın 2018 model Kenworth T680 kamyonunda SPN 3226 FMI 0 hatası ortaya çıktı. Bu kod, NOx sensör devresinde bir arıza olduğunu gösteriyordu. Yetkili servis, sadece teşhis için 650 dolar istedi. Babam bana "Bu kod ne anlama geliyor?" diye sorduğunda, Google’da yaptığım araştırma hayal kırıklığı yaratmıştı. Sonuçlar sadece iki satırlık açıklamalardan oluşuyordu — teknik derinlikten, onarım maliyet tahminlerinden ve hatta Meksikalı şoförleri için İspanyolca içerikten bile yoksundu.

İşte bu noktada, kamyoncuların ihtiyaç duyduğu özel bir dizel arıza kodu veritabanına olan ihtiyacı anladım. Standart OBD2 siteleri değil, ağır hizmet araçlarının kullandığı SAE J1939 protokolüne özel, kapsamlı bir kaynak gerekiyordu.

Ağır Hizmet Araçlarında Arıza Kodları Neden Gizemli?

Standart OBD2 sistemlerinin aksine, ağır hizmet araçları SAE J1939 protokolünü kullanır. Bu protokolde bir arıza kodu üç ana bileşenden oluşur:

• SPN (Suspect Parameter Number): Hangi sistemde arıza olduğunu tanımlar.
• FMI (Failure Mode Identifier): Arızanın nasıl gerçekleştiğini gösterir.
• MID/PID: Üreticiye özel tanımlayıcılar.

Bu detay düzeyi, genel OBD2 sitelerinde bulunmaz. Kamyon forumlarında ise sadece parçalı bilgiler mevcut. Yetkili servisler ise sadece kodu okumak için bile 100 dolar talep ediyor. Bu boşluğu doldurmak için harekete geçtim.

Sıfır Node.js ile Python SSG Yaklaşımı

Projeyi hayata geçirmek için saf Python tabanlı bir Statik Site Üreticisi (SSG) tercih ettim. Node.js’e gerek olmadığını şu şekilde kanıtladım:

# build.py - Çekirdek mantık
def build_fault_code_page(spn, fmi, data):
    html = f"""
    <article>
        <h1>SPN {spn} FMI {fmi}: {data['title']}</h1>
        <div class="specs">
            <p>SAE J1939 Standardı: ✅</p>
            <p>Onarım Maliyeti: {data['repair_cost']}</p>
            <p>Şiddet Derecesi: {data['severity']}</p>
        </div>
        <div class="content">
            {data['content']}
        </div>
        <div class="schema">
            <script type="application/ld+json">
                {json.dumps(generate_schema(spn, fmi, data))}
            </script>
        </div>
    </article>
    """
    return html

Projenin temel özellikleri şunlar oldu:

• Çift Dilli Desteği (İngilizce + İspanyolca): ABD’deki kamyoncular kadar Meksikalı şoförler için de erişilebilir olmak.
• SAE J1939 Standartlarına Uygunluk: Her sayfa resmi standartlara atıfta bulunuyor.
• Gerçek Onarım Maliyetleri: Forum verilerinden derlenen gerçek fiyat tahminleri.
• Schema.org İşaretlemesi: TechArticle ve BreadcrumbList gibi yapılandırılmış veri desteği.

Performans Karşılaştırması: Önce ve Sonra

Projeyi hayata geçirmeden önce ve sonraki metrikler oldukça çarpıcı:

| Metrik | Önce (Genel OBD2 Siteleri) | Sonra (Diesel DTC Hub) | Gelişme | |--------|-----------------------------|------------------------|---------| | İçerik Derinliği | 2 satır | 2.000+ kelime | +100 kat | | Çift Dilli Destek | ❌ Yok | ✅ İngilizce + İspanyolca | Sıfırdan ikiliye | | SEO İşaretlemesi | ❌ Yok | ✅ 8 farklı tür | Sıfırdan tamamen doldurulmuş | | Onarım Maliyetleri | ❌ Yok | ✅ 200$ - 8.000$ aralığı | Gerçek verilerle doldurulmuş | | Toplam Sayfa Sayısı | 10 - 50 | 401 | +4 kat artış |

Projeden Çıkarılan Kritik Dersler

Bu süreçte edindiğim en önemli deneyimler şunlar oldu:

• Statik Site Üretimi için Node.js gerekli değildir: Python’un f-string şablonları, herhangi bir JavaScript frameworkünden daha hızlı ve basit bir çözüm sunuyor.
• Sektör Standartlarına Atıflar Güveni artırıyor: SAE J1939 standartlarına yapılan atıflar, kamyon forumlarında güvenilirliği büyük ölçüde yükseltti.
• Gerçek Onarım Maliyetleri Değerli: Forumlardan derlenen gerçek fiyat tahminleri, genel "bir tamirciye danışın" tavsiyelerinden çok daha faydalı oldu.
• Çift Dillilik Mavi Okyanus: İspanyolca dizel arıza kodu dokümantasyonu sunan hiçbir rakip yoktu.
• Schema.org İşaretlemesi SEO’nun Altın Anahtarıdır: TechArticle işaretlemesi, ilk 30 günde trafiği %40 oranında artırdı.

Gelecek Planları: Veritabanını Genişletmek

Mevcut 401 sayfalık veritabanını daha da geliştirmeyi planlıyorum:

• Cummins X15 motor arıza kodları için 50 yeni sayfa eklenmesi.
• Paccar MX-13 motor arıza kodları için 40 yeni sayfa eklenmesi.
• İspanyolca sesli arıza kodu rehberleri için YouTube kanalının başlatılması.

Bu proje, sadece teknik bir çözümden çok daha fazlası oldu. Ağır hizmet araçları için gerekli olan derinlemesine, güvenilir ve erişilebilir bir kaynağı hayata geçirdik. Gelecekte de bu alandaki boşlukları doldurmaya devam edeceğim.