ArchLib — Mimarlığın açık çalışma alanı
Retro-minimalist arayüz, özgün mimari SVG çizimleri, yerel fontlar ve mevcut ArchLib çalışma modülleri.
Teslim durumu: Derleme, 12 DOM entegrasyon kontrolü ve HTTP dosya kontrolleri başarılı. Yeni tasarımın gerçek tarayıcıda görsel, mobil ve FPS kabulü tamamlanamadı: çalışma ortamının Browser URL güvenlik politikası yerel önizlemeyi engelledi. docs/TEST-RAPORU.md doğrulanan ve bekleyen işleri ayırır.
Çalıştırma
Node.js 24.15 veya üzeri gerekir. Bu teslim Node.js 24.19.0 ile derlendi.
npm ci
npm run build
npm run preview
Terminalin gösterdiği http://localhost:4173 adresini aç. Başka bir port gerekiyorsa PORT ortam değişkenini ayarla. npm run dev de aynı statik önizleme sunucusunu çalıştırır; kaynak düzenlemelerinden sonra npm run build komutunu yeniden çalıştırıp tarayıcıyı yenile. HMR sunucusu içermez.
Hazır dist/ klasörü ayrıca pakette bulunur. Bunu doğrudan statik bir HTTP/HTTPS sunucusunun kök dizininde servis edebilirsin. ES modülleri nedeniyle index.html dosyasını çift tıklamak yerine HTTP sunucusu kullan.
Vercel yapılandırması
Proje kökünü bu README'nin bulunduğu dizin olarak seç. vercel.json şu değerleri içerir:
| Ayar | Değer |
|---|
| Framework preset | Other (null) |
| Build command | npm run build |
| Output directory | dist |
| Node | 24.x; yerel testler için en az 24.15 |
Bu alanların davranışı Vercel'in vercel.json belgesinde açıklanır. Vercel'in desteklediği Node sürümleri için resmî Node sürümü belgesine bak.
Üretim alan adı üzerinde herhangi bir dağıtım yapılmadı. İlk dağıtımı bir HTTPS önizleme olarak inceleyip docs/GORSEL-KABUL.md içindeki kontrolleri tamamla.
Dosya haritası
| Yol | İşlev |
|---|
src/app.js | Uygulama, hash rotaları, kayıtlar ve genel durum |
src/pages/Home.js | Editoryal ana sayfa ve araç seçkisi |
src/pages/Catalog.js | 55 araç, arama, filtreler ve görünüm seçimi |
src/pages/Notes.js | Kişisel notlar ve özel kategoriler (yalnızca bu tarayıcı) |
src/pages/Workspace.js | Mevcut çalışma modüllerini yeni arayüze bağlar |
src/components/Artwork.js | Özgün kemer/kütle çizimi ve araç illüstrasyonları |
src/components/Chrome.js | Üst gezinme, stüdyo menüsü, açılış ve alt bölüm |
src/components/ToolCard.js | Araç kartı |
src/components/ToolDetail.js | Araç açıklaması ve gerçek site bağlantısı |
src/components/Settings.js | Sağlayıcı, API anahtarı ve özel model seçimi |
src/components/Dialog.js | Yerel dialog, Escape ve odak geri dönüşü |
src/core/engine.js | Korunan uygulama motoruna tek erişim noktası |
src/core/motion.js | Kaydırma, tek seferlik görünme, imleç ve düğme hareketi |
src/core/ui.js | Ortak öğeler, ikonlar ve depolama yardımcıları |
src/styles/ | Tasarım değişkenleri, yerleşim, bileşen ve hareket CSS'i |
public/fonts/ | Türkçe karakterleri içeren WOFF2 fontları ve lisans |
public/art/ | ArchLib kemer simgesi |
legacy/ | Yüklenen ZIP'in değişmeden saklanan derlenmiş motoru |
scripts/build.mjs | Kontrollü uyumluluk dönüşümü ve optimize derleme |
scripts/check.mjs | DOM entegrasyon kontrolleri ve paket ölçümleri |
scripts/serve.mjs | Yerel HTTP önizlemesi |
dist/ | Hazır dağıtım; otomatik üretilir |
Özgün kaynakların sınırı
Paylaşılan archlib-dist.zip yalnızca derlenmiş Vite çıktısı içeriyordu; özgün .tsx dosyaları, package.json veya source map yoktu. Bu nedenle bu teslim, tüm eski uygulamanın özgün kaynaklarının geri kazanıldığı anlamına gelmez.
Yeni arayüz 13 okunabilir ES modülü ve 4 CSS dosyasıyla yazıldı. Mevcut kritik, bilgi, kontrol listesi, çizim, arazi ve forum motoru legacy/ içinde korunur. Derleme sırasında ana paketin otomatik eski arayüzü açması kaldırılır, bileşenlere isimli dışa aktarımlar eklenir ve dosya ön yükleme adresi yeni konuma uyarlanır. Anahtarların sağlayıcıya iletildiğini doğru açıklamak için kaynaklar sayfasındaki gizlilik metnine bir cümle eklenir. Kritik istek protokolü ve model yönlendirme mantığı değiştirilmez.
Derleme, beklediği eski kod imzaları değişmişse hata verir. Yeni bir eski-sürüm dağıtımı geldiğinde legacy/ klasörünü körlemesine değiştirme; scripts/build.mjs içindeki uyumluluk sınırını gözden geçir. Özgün geliştirme kaynakları geldiğinde src/core/engine.js doğrudan bu bileşenlere bağlanabilir.
Korunan işlevler ve veriler
- Pafta/maket kritiği, görsel yükleme, geçmiş ve dışa aktarma motoru.
- 2B çizim, 3B sahne, arazi, plan, kesit ve dışa aktarma paketleri.
- Forumun mevcut Firebase bağlantısı ve uygulaması.
- 55 araç; açıklamaları, gerçek adresleri, kategori/ücret/aşama bilgileri.
- Bilgi bankası, kaynaklar ve kontrol listeleri.
- Mevcut
archlib.anahtar.v1, archlib.saglayici.v1, archlib.liste.v1, archlib.gecmis.v1 ve archlib.tema.v1 anahtarları.
Yeni kayıtlar archlib.favorites.v2, oturumluk archlib.welcome.v2, archlib.notlar.v1 (notlar) ve archlib.notkategori.v1 (özel not kategorileri) alanlarını kullanır. Tarayıcı verileri origin'e bağlıdır; başka bir önizleme adresinde üretim sitesindeki kayıtlar görünmez. Aynı üretim origin'inde saklama anahtarları korunur.
ArchLib v2 artık koyu temayla sabittir; açık tema kaldırıldı ve eski archlib.tema tercihi bir daha okunmaz. <html data-theme="dark"> sabittir ve motor paketinin içe aktarımda tetiklediği tema senkronizasyonu app.js tarafından her yüklemede geri zorlanır.
AI kullanımı kendi sağlayıcı anahtarını gerektirir. Eski model kataloğu korunmuştur; hesabında bulunmayan bir model için otomatik seçimi kapatıp erişebildiğin modelin tam adını gir. Forumun ve coğrafi servislerin erişimi mevcut servis ayarlarına bağlıdır.
Hareket ve performans
- Ana sayfada masaüstü tekerlek hareketini yumuşatan, yalnızca ihtiyaç olduğunda çalışan
requestAnimationFrame döngüsü.
- Çizim, harita, form, pencere ve iç kaydırma alanlarında yerel etkileşim.
IntersectionObserver ile bir kez oynayan reveal; görünürlük sonrası izlemeyi bırakır.- Harf yerine satır maskeleriyle açılan büyük başlıklar;
transform ve opacity ağırlıklı animasyon.
- 1,18 saniyelik, ilk oturuma özgü sanatsal açılış. İlerleme çizgisi dekoratif; ağ yükleme yüzdesi iddiası içermez.
- Fareyi izleyen mimari artı imleci ve hafif düğme hareketi; doğal imleç erişimi korunur.
- Dokunmatik ve
prefers-reduced-motion koşullarında hareket azalır/devre dışı kalır.
- Yerel SVG ve WOFF2; yeni arayüz için haricî görsel, font, GSAP veya Lenis CDN bağımlılığı yoktur.
- Yeni arayüz tek minify edilmiş JS paketine, yeni CSS tek stil dosyasına derlenir.
- Ağır eski modüller
React.lazy ile ilgili bölümde yüklenir.
Dosya temelli ilk yükleme tahmini yaklaşık 279 KiB gzip. Bu değer bütün yerel fontları dahil eder; gerçek ağ transferi, Core Web Vitals veya FPS ölçümü değildir. Ayrıntı: docs/check-results.json.
Kontroller
npm run build
npm run check
npm run check:http
Testler yapay verili, ağ erişimi kapalı JSDOM ortamında çalışır. Gerçek API anahtarı veya ücretli istek kullanmaz; forumda içerik yayınlamaz. Üretilen JSON, test yöntemini ve sınırlarını açıkça içerir.
Görsel kimlik
Kâğıt #fcfbf8, kart #fffefa, mürekkep #30332d, kiremit #b9573e, adaçayı #727d63: özgün paletin temel (açık) tonları — motor paketinin [data-theme='dark'] karşılıkları artık tek gösterilen sürüm. Nimbus Roman, Nimbus Sans ve Nimbus Mono tabanlı yerel fontlar; lisans public/fonts/LICENSE.txt içinde. Kemer ve geometrik mekân çizimleri bu sürüm için kodla oluşturulmuştur.
Ana sayfa artık tam ekran (100svh) karşılama sahnesiyle açılır: büyük başlık, aksonometrik kemer çizimi (fare ile hafif eğilir), alt kenarda renkli bir geçiş çubuğu ve "BİRAZ DAHA KEŞFET" düğmesi. Kaydırma ya da bu düğmeyle kitaplığın geri kalanına inilir.
