Feedcrumb — Ürün ve Sistem Mimarisi | Ahmet Canal

CTX-01

Bağlam

RSS basit görünür; gerçek ürün problemi kaynakların aynı formatta gelmemesi ve makale içeriğinin güvenilir biçimde ayrıştırılmasıdır.

PRB-01

Problem

XML varyasyonları, bozuk HTML, tam metin / özet farkları ve yüzlerce girdinin aynı arayüzde performanslı gösterilmesi tek bir ingestion hattı gerektiriyor.

ROL-01

Rolüm

Ürün mimarisi
Feed işleme sistemi
Frontend / backend

SOL-01

Çözüm

Kaynak alma, parse, normalization, Readability extraction, sanitization ve persistence adımlarını ayrı aşamalara bölerek içerik hattını deterministik hale getirdim.

BLD-01

Neler yapıldı

RSS / Atom ingestion ve XML normalization
Makale extraction ve okunabilir içerik üretimi
HTML sanitization ve HTML → Markdown dönüşümü
Yer imleri ve kaynak yönetimi
Virtualized büyük feed listeleri
PWA temeli

ARC-01

Sistem mimarisi

İçerik hattı

RSS / Atom
XML Parser
Normalization
Mozilla Readability
sanitize-html
Reader
Supabase

STK-01

Teknik yığın

Frontend

React 19 · TypeScript · TanStack Start · TanStack Router · TanStack Query · Tailwind CSS 4 · TanStack Virtual

Backend / Veri

Supabase

İçerik işleme

Mozilla Readability · fast-xml-parser · rss-parser · sanitize-html · Turndown

Platform

PWA

DEC-01

Önemli mühendislik kararları

Parser çıktısını doğrudan UI'a taşımamak; normalize edilmiş ortak entry modeli kullanmak
Sanitization'ı render katmanından önce zorunlu aşama yapmak
Büyük listelerde DOM büyümesini virtualization ile sınırlamak

CODE-01

Kod / mimari örnekleri

Ingestion pipelineTS

01const article = await pipe(
02  fetchFeed,
03  parseXml,
04  normalizeEntry,
05  extractArticle,
06  sanitizeContent,
07  persistArticle,
08)(source);

FLOW-01

Veri akışı

Feed akışı

Feed URL
Fetch
Parse
Normalize
Extract
Sanitize
Persist
Virtualized reader

OUT-01

Sonuç / mevcut durum

Feedcrumb bugün deneysel bir ürün olarak ingestion, okuma, yer imi ve PWA katmanlarını tek akışta test ediyor.

LRN-01

Mühendislik çıkarımları

İçerik ürünlerinde veri temizleme arayüzden daha kritik olabilir.
Pipeline adımlarını ayrıştırmak hatayı kaynağa kadar izlemeyi kolaylaştırır.

OUT-LIVE / Ürünü gör

Feedcrumb

Ürünü gör