Anlayabileceğiniz ürünler. İnşa edebileceğimiz sistemler.

Çözülmesi gerekenler

Yüzlerce ücretli hizmetten oluşan bir nomenklatöre sahip bir tıp merkezinin, her hizmetin aramada bulunabilir, fiyatı ve ölçü birimi olan ayrı bir sayfa olmasına ihtiyacı vardı — fiyat listesi içeren bir PDF’ye değil. Ayrıca fiyatlar ve ekip değiştiği için kliniğin bunları kendi başına düzenleyebilmesi gerekiyordu; randevuların da bir e-posta kutusuna değil, hemen resepsiyona ulaşması gerekiyordu.

Ne kurduk

Next.js 14.2.35 (App Router) ile React 18, TypeScript ve Tailwind. Tıbbi nomenklatürdeki her kalem kendi statik rotasına dönüştü: `src/app` içinde 521 `page.tsx` dosyası, bunların 481'i `/servicii` altında — 184 fizyoterapi, 122 danışmanlık hizmeti, 61 periyodik tıbbi muayene, 27 jinekoloji, 26 ozonoterapi, 23 tedavi paketi, 18 alternatif tıp, 12 tanı, geri kalanı bölümlere göre. Üretim sitemap'i 890 adres listeliyor. Site iki dilli ro/ru. Düzenlenebilir içerik (doktorlar, paketler, tedaviler, makaleler, ayarlar, görseller) `better-sqlite3` üzerinden WAL günlükleme ve aktif yabancı anahtarlarla yerel bir SQLite veritabanında tutulur, `/admin` üzerinden 20 API rotası ile yönetilir; kimlik doğrulama oturum için `jose` ve parola için `bcryptjs` kullanır, parola değişimi mevcut oturumları geçersiz kılar. Programasyon ve iletişim formları `zod` + `react-hook-form` ile doğrulanır ve mesajı biçimlendirilmiş olarak doğrudan Telegram'a, Bot API üzerinden gönderir. `calculator` üzerinde bir fiyat hesaplayıcısı da vardır.

Çözülmesi gerekenler

Bir kulübün menüsü sık sık değişir, fiyatları ve hacimleri tam olmalıdır ve telefondan, karanlıkta, üç dil konuşan insanlar tarafından okunur. Bir QR kod üzerindeki taranmış PDF bunun hiçbirini çözmez: aranamaz, çevrilemez, kod yeniden basılmadan güncellenemez.

Ne kurduk

Çalışma çerçevesi ve paketler olmadan dijital bir menü: gerçek kaynaklar dört JSON dosyasıdır ve 402 satırlık bir Python üretici bunlardan tek bir `index.html` yazar. 21 kategoride 119 ürün, her biri için fiyat, hacim, bileşim ve fotoğraf; ürün başına bir tane olmak üzere 119 kısa tanıtım metni; ziyaretçinin her kartta gördüğü 119 eşleştirme önerisi seti („neyle gider”). Menü üç dillidir: Romence temel dildir, Rusça ve İngilizce ise yalnızca arayüzü değil, kategorileri, hacimleri, bileşimleri, 82 tat etiketini ve tüm 119 tanıtım metnini de kapsar. Sepet, favoriler listesi ve hesabı bölme işlemi tarayıcıda, hesap ve sunucu olmadan çalışır. Yazı tipleri Google’da değil, aynı alan adında barındırılır. Her yayınlamadan önce 233 satırlık bir betik 16 kontrol çalıştırır — hiçbir izleyicinin sızmadığını, üçüncü taraf bir alan adından hiçbir şey istenmediğini, JSON’un geçerli olduğunu ve her fotoğrafın mevcut olduğunu, menünün üç dilde de eksiksiz olduğunu, fiyatların her kategoride azaldığını ve sayfadaki yapılandırılmış verilerin geçerli olduğunu denetler. Yayınlama, `main` dalına birleştirme sırasında GitHub Actions’tan otomatik yapılır; iş akışı üretimin tam bir kopyasını aldıktan ve 30 gün sakladıktan sonra.

Çözülmesi gerekenler

Bir komün belediye başkanlığının, HG 728/2023’e uygun resmi bir web sayfası olması gerekir — sabit bölümlerle (karar alma şeffaflığı, projeler ve kararlar, duyurular, belgeler, iletişim, bütçe) — ve bunu her duyuru için geliştirici olmadan kendi başına güncelleyebilmelidir. Bunlar olmadan, kamu yararına olan bilgi kâğıtta veya bir Facebook grubunda kalır.

Ne kurduk

PHP 8.2 üzerinde Laravel 12 uygulaması, MySQL 8, front-end Vite + Tailwind ile, iki Docker konteynerine paketlenmiş (`japca_app` = nginx + PHP-FPM, `japca_db` = MySQL). Mimari, kasıtlı olarak iki tür içeriği ayırır: nadiren değişen editoryal içerik (coğrafya, tarihçe, kurumlar, iletişim, bütçe) Blade şablonlarının doğrudan okuduğu 1613 satırlık tek bir PHP yapılandırma dosyasında durur; sık değişen içerik (duyurular, fotoğraf galerisi, projeler ve kararlar, belgeler, şeffaflık ayarları) MySQL’de durur ve `/admin` panelinden düzenlenir. 40 Blade şablonu, 32 rota, 10 veritabanı migrasyonu. Paneldeki kimlik doğrulama aynı adresten dakikada 5 istekle sınırlandırılmıştır — altıncısı 429 alır — ve her yönetim işlemi bir denetim tablosuna girer. Güvenlik başlıkları ve sitemap, CI’da çalışan otomatik testlerle kapsanır.

Çözülmesi gerekenler

QR kodlu herhangi bir menüdekiyle aynı şey: telefonda hızlı olmalı, fiyatı doğru olmalı, üç dilde okunabilir olmalı ve mutfak bir yemek çıkardığında beş dakika içinde değiştirilebilmelidir. Ayrıca, restoranın hiçbir müşteri takibine ihtiyacı yoktur — o zaman asıl soru, birinin gerçekten hiçbir şey toplamayan bir site kurup kurmadığı, yoksa bunu sadece gizlilik politikasına mı yazdığıdır.

Ne kurduk

Tek bir `index.html`, JSON dosyalarından 377 satırlık bir Python betiği tarafından üretilmiş: 31 kategoride 146 ürün, 143 kısa tanıtım metni, ayrıca kategoriler, adlar, hacimler, bileşimler, etiketler ve metinler için Rusça ve İngilizce çeviriler. Sepet, favoriler listesi ve not paylaşımı tarayıcıda çalışır. Site doğrudan Caddy 2 ile, otomatik HTTPS ile sunulur. İlginç olan şu ki kullanıcı tespitinin olmaması bir vaat değil, sürekli entegrasyonun dayattığı bir kuraldır: her birleştirme isteğinde CI, `index.html` dosyasını kaynaklardan yeniden üretir ve sonuç depodaki dosyadan farklıysa PR’ı reddeder (dolayısıyla yayımlanan sayfa her zaman kaynaklarla uyumludur), ardından 14 kontrol çalıştırır — izleyici yok, üçüncü taraf bir alandan otomatik yüklenen hiçbir kaynak yok, fontlar yerel olarak barındırılıyor, repoya ulaşmış yedek dosyalar yok, gizlilik politikası mevcut ve alt bilgiye bağlı, menü üç dilde eksiksiz, fiyatlar her kategoride azalan sırada, yapılandırılmış veriler geçerli — ve ayrıca sunucu yapılandırmasından güvenlik başlıklarının ve günlüklerde IP adresi maskelemesinin kaybolmadığını da denetler. Kullanılan tüm GitHub Actions’lar commit’in kontrol toplamına sabitlenmiş ve workflow `permissions: {}` ile başlıyor.

Çözülmesi gerekenler

doğrulanmadı — kaynaklarımız yok, bu yüzden sorunu uydurmadan çalışma sorununu açıklayamam.

Ne kurduk

Vite ile derlenmiş React uygulaması, nginx tarafından statik olarak sunuluyor, Rusça sürüm `/ru/` altında. Üretim sitemap’inde 181 adres var. Dışarıdan söylenebilecek tek şey bu: kaynaklar bu makinede değil, bu yüzden kütüphaneleri, yapıyı veya entegrasyonları adlandıramam.

Çözülmesi gerekenler

Bir bölge diş merkezinin fiyatlarıyla birlikte kamuya açık hizmet listesine, zorunlu sigortanın karşıladığı hizmetlerin açık işaretlenmesine, ekibe, acil durum programına ve şeffaflık sayfalarına ihtiyacı vardı — programcı değil, personel tarafından düzenlenebilir. Projeyi devraldığımızda yönetim panelinde ciddi bir sorun vardı: yönetici parolası tarayıcıda karşılaştırılıyor ve kamuya açık JavaScript paketine giriyordu, API’ye yazma istekleri ise internetten herkes tarafından yapılabiliyordu.

Ne kurduk

React 18 + TypeScript uygulaması, Vite 6 üzerinde, `react-router-dom` yönlendirmesiyle — hizmetler ve fiyatlardan acil durumlar, ortodonti, implantlar, pedodonti, şeffaflık ve geri bildirime kadar 22 ekran. Arka planda PM2 altında çalışan bir Express 4 API var; nginx derlenmiş dosyaları sunuyor ve yalnızca `/api` yönlendiriyor. Genel veriler (hizmetler, ekip) hem API hem de doğrudan ön uç tarafından okunan JSON dosyalarında duruyor. Bizim getirdiğimiz kısım güvenlik oldu: parola artık sunucudan çıkmıyor — `POST `login` onu orada doğruluyor ve 12 saat geçerli, IP başına 15 dakikada 8 deneme sınırı olan, HMAC-SHA256 ile imzalanmış bir jeton döndürüyor ve karşılaştırmalar sabit sürede yapılıyor; `services` ve `team` üzerindeki yazma işlemleri artık jeton gerektiriyor; imzalama sırrı, depodan ayrı tutulan, 0600 izinli bir dosyada kendi kendine oluşturuluyor; API yalnızca 127.0.0.1 üzerinde dinliyor, dolayısıyla kamuya açık tek yol nginx; CORS kendi alan adlarıyla sınırlandırıldı ve JSON gövdesi 1 MB ile sınırlı. Bunun üzerine, derleyen, tipleri kontrol eden ve içinde bir gizli anahtar bulursa paketi reddeden CI ile haftalık npm ritminde Dependabot ekledik.

Çözülmesi gerekenler

Bir kredi şirketinin bir siteden daha fazlasına ihtiyacı vardır: başvuru çevrimiçi girmeli, bir karar akışından geçmeli, bir PDF sözleşme üretmeli, bir ödeme çizelgesi oluşturmalı ve denetimde iz bırakmalıdır — ve tüm bunlar, kişisel verilerini geri isteyen bir müşterinin sorduğu sorulara dayanmalıdır. Kamuya açık bölüm (hesaplayıcılar, makaleler, kredi türüne göre sayfalar) aynı zamanda aramadan insan getirmelidir.

Ne kurduk

Aynı depoda iki yarı. Kamuya açık bölüm, statik olarak derlenmiş bir Vite + React Router uygulamasıdır — 50 ekran, bunlar arasında dört hesaplayıcı (kredi, uygunluk, refinansman, ödeme çizelgesi), kredi türüne göre ayrı sayfalar, blog, sözleşme öncesi ve uyumluluk bilgilendirme sayfaları. Romence rotalar önek olmadan kalır, Rusça rotalar ise `/ru/…` üzerinden gider; aktif rota dilinden oluşturulan kanonik ve alternatif etiketlerle birlikte. İş tarafı, PostgreSQL üzerinde Prisma kullanan modüler bir TypeScript Express arka ucu: 16 modül — kimlik doğrulama, rol bazlı yetkiler, başvuru akışı, belgeler, ödemeler, bildirimler, planlanmış görevler, blog, SEO, GDPR, müşteriler, leadler, iletişim, hesaplayıcı, Google Ads, sağlık — ve Prisma şemasında 18 tablo, bunlar arasında `Contract`, `Payment`, `AuditLog`, `GdprRequest`, `UploadedDocument`, `DailyKpiSnapshot` ve `CronJobRun`. PM2 altında çalışır; üretimde migrasyonlar, yayından önce kontroller, sırların oluşturulması, yedekleme ve veritabanı geri yükleme için ayrı scriptler bulunur.

Çözülmesi gerekenler

Bir oto servis çok spesifik kombinasyonlarla aranır — marka artı işlem artı semt („BMW Botanica otomatik şanzıman onarımı”). Tek bir „Hizmetler” sayfası bunların hiçbirine yanıt veremez. Teknik sorun, sitenin tek sayfalık bir React uygulaması olmasıdır; yani özel bir şey yapılmazsa arama motorunun gördüğü şey boş bir `<div>` olur.

Ne kurduk

Vite 6 üzerinde React Router’lı React 19 + TypeScript uygulaması, ancak derleme sırasında prerender edilmiş: her rota build’den kendi HTML dosyası olarak çıkar, dolayısıyla arama motoru boş bir sayfa değil içerik alır. Adres yapısı, tarihte doğrulanabilir biçimde kademeli olarak genişletildi — 206 indekslenebilir sayfadan, marka × iş kategorisi kombinasyonlarının, makalelerin ve Kişinev sektör sayfalarının eklenmesiyle 316’ya. Rotaların dil sürümleri, ayrı bir görsel sitemap’i, Open Graph görselleri ve daha hızlı yükleme için bölünmüş JavaScript paketi vardır. Son commit, sessizce indekslemeyi bozan bir ayrıntıyı düzeltti: kanonik adres, `hreflang` ve sitemap’teki adresler artık hepsi aynı son eğik çizgili biçimi verir.