Teksanor Kurumsal Operasyon Platformu

Teknik servis, bakım ve mühendislik ekipleri için kurumsal web sitesi ile rol tabanlı operasyon portalını aynı uygulamada birleştiren uçtan uca ürün prototipi.

Canlı demoyu aç · Özellikleri incele · Yol haritası · English

Portföy ve ürün prototipi: Bu depo gerçek bir işletme problemini çözmek amacıyla geliştirilmiş çalışan bir demonstrasyondur. Canlı ortamda yalnızca demo/test verileri kullanılmalıdır. Teksanor resmî muhasebe, bankacılık veya ERP ürünü değildir.

Ürün turu: Herkese açık ürün vitrini → Servis akışı → Güven ve ürün sınırları. Görsel ürün akışını anlatır; müşteri ekran görüntüsü veya gerçek işlem kaydı değildir.

Yeni servis masası

/servis ekranında talep → teklif → müşteri onayı → saha notu/fotoğraf → servis formu → tahsilat takibi birleştirilir. Onay bağlantıları süreli ve sürüme bağlıdır. QR etiketi ekipmanın yetkili servis geçmişini açar. PDF çıktısı servis formunun yazdırma ekranından alınır. E-posta, yapay zekâ ve harici dosya tarama bağlantıları için pilot teslim belgesini okuyun.

Canlıda ne var, ne yok (25.09.2026)

Özellik	Durum
Kurumsal tanıtım sayfaları	Canlı; arayüz yalnız Türkçedir (İngilizce yalnız README).
Giriş, kayıt, rol ve firma kapsamı	Canlı. Rol × firma sınırları davranış testleriyle doğrulanır (tests/access-matrix.test.mjs).
Servis masası: iş emri → teklif → müşteri onayı → saha → servis formu → tahsilat	Canlı; uçtan uca davranış testi var (tests/workflow-e2e.test.mjs). Fotoğraf/belge eki R2 gerektirdiği için kapalı.
Finans kayıtları, gider, Excel/CSV içe/dışa aktarma	Canlı. Eksik değer 0 sayılmaz; çift gönderim ve tekrar içe aktarma mükerrer kayıt açmaz.
Müşteri imzası	Onay sayfasında isteğe bağlı parmakla imza; sunucuda doğrulanmış SVG yolu olarak D1'de saklanır (R2 gerekmez). Servis formunda görünür. Nitelikli elektronik imza değildir.
Telefonda ana ekrana ekleme ve çevrimdışı	Web uygulaması olarak eklenebilir. Bağlantı yoksa "Bağlantı yok" sayfası açılır; saha notu "Cihazda taslak sakla" ile tutulur. Kayıtlar ve API yanıtları cihazda önbelleğe alınmaz; çevrimdışı kayıt eşitleme yoktur.
Saha formları (kontrol listesi)	Yönetici form şablonu tasarlar (hazır: klima bakım, jeneratör testi, İSG); teknisyen sahada doldurur. Zorunlu maddeler bitmeden iş "tamamlandı" yapılamaz; müşteri onayından sonra form kilitlenir.
Planlama panosu	/servis/plan: haftalık teknisyen × gün görünümü; yönetici tarih ve sorumlu atar; kişi başı günde 3+ iş uyarısı.
Kolay kullanım	Panelin üstünde "Bugün" kartı (geciken/bugün/bu hafta işleri, tek dokunuşla açılır) ve yöneticiye başlangıç listesi. Servis masasında iş önceliğe göre sıralanır, filtre çipleri, her işte "Sıradaki adım" düğmesi; onay bağlantısı WhatsApp/e-posta ile gönderilir. Kenar menüsü gruplandı, servis masası menüde.
E-fatura taslağı	Onaylanan işten UBL 2.1 biçiminde muhasebe ön taslağı (standart uyumu doğrulanmadı). Entegratöre gönderilmez; GİB/Peppol gönderimi ayrı bir entegratör sözleşmesi gerektirir.
Dosya yükleme / indirme	Kapalı: R2 bağlı değil; /api/health bunu uyarı olarak gösterir.
TCMB kuru ve altın referansı	Canlı (/api/public/fx); bilgi amaçlı referanstır, bağlayıcı fiyat değildir.
E-posta ile parola kurtarma, üretken yapay zekâ, harici dosya tarama	Yapılandırmaya bağlıdır; anahtar yoksa özellik açıkça kapalı/etiketli çalışır ve çalışıyormuş gibi gösterilmez.

Problem ve çözüm

Teknik servis ve mühendislik işletmelerinde iş emirleri, saha ziyaretleri, bakım planları, projeler, belgeler ve finansal kayıtlar çoğu zaman farklı tablolarda tutulur. Bu da güncel bilgiye ulaşmayı, yetki kontrolünü ve yönetim kararlarını zorlaştırır.

Teksanor bu dağınık akışı tek çalışma alanında toplar. Her firma kendi verisini görür; ekip görevlerini takip eder; yönetici operasyon ve finansal görünümü merkezi olarak izler.

Öne çıkan yetenekler

• Kurumsal tanıtım sitesi, çözüm sayfaları ve içerik alanları
• Tek giriş ekranı ve rol bazlı yetkilendirme
• Firma/organizasyon bazlı veri ayrımı
• Proje, departman, çalışan ve iş takibi
• İş emri, saha ziyareti, ekipman ve periyodik bakım yönetimi
• Ödeme, borç, gider, nakit, döviz ve ziynet takibi
• TCMB günlük kurları ve referans altın fiyatıyla TL karşılığı
• Excel içe aktarma; R2 etkinleştirilirse belge yükleme ve kontrollü indirme
• İşlem geçmişi ve denetim kayıtları
• Cloudflare D1 veri tabanı; R2 dosya depolama isteğe bağlı (canlı demoda kapalı)
• GitHub Actions üzerinden test, derleme ve Cloudflare Pages dağıtımı

Teknik mimari

Katman	Teknoloji / yaklaşım
Arayüz	React 19, TypeScript, Vinext, Tailwind CSS
Sunucu	Vinext Worker, Cloudflare çalışma zamanı
Veri	Cloudflare D1 / SQLite uyumlu sorgular
Dosyalar	Cloudflare R2 isteğe bağlı; bağlantı yoksa yükleme kapalı
Entegrasyon	TCMB döviz verisi, altın referans servisi
Dağıtım	GitHub Actions, Wrangler, Cloudflare Pages
Kalite	Node test runner, otomatik üretim derlemesi

Çalıştırma

Gereksinimler

• Node.js 22
• npm 11
• Cloudflare hesabı ve yerel geliştirme için Wrangler

Kurulum

git clone https://github.com/ekremalann-sketch/Teksanor.git
cd Teksanor
npm ci
npm run dev

Uygulama geliştirme sunucusunun terminalde gösterdiği yerel adreste açılır.

Kontroller

npm test
npm run build
npm run build:pages

• npm test: otomatik kontrolleri çalıştırır.
• npm run build: Worker üretim çıktısını hazırlar.
• npm run build:pages: Cloudflare Pages için dist/pages çıktısını üretir.
• npm run start: derlenmiş Worker'ı Wrangler ile yerelde çalıştırır.

Ortam ve Cloudflare yapılandırması

Uygulama koduna gerçek kimlik bilgisi yazılmaz. Yerel değişken adları için .env.example dosyasını kullanın; gerçek değerleri yalnızca yerel .env dosyasında veya Cloudflare/GitHub secret yönetiminde tanımlayın.

Üretim dağıtımı için gereken GitHub Actions secret adları:

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID

D1 bağlantısı gereklidir. R2 isteğe bağlıdır; etkin değilse dosya yükleme kapalı kalır. Gizli değerleri issue, commit, ekran görüntüsü veya loglarda paylaşmayın.

Demo güvenliği

• Canlı demoya gerçek müşteri, personel, finans veya kimlik verisi girmeyin.
• Demo hesaplarının parolalarını README veya kaynak kodda yayınlamayın.
• Üretim kullanımı öncesinde erişim politikaları, yedekleme, gözlemleme, KVKK süreci ve felaket kurtarma planı ayrıca doğrulanmalıdır.
• Güvenlik bildirimi için SECURITY.md dosyasını inceleyin.

Proje durumu

Teksanor çalışan bir ürün prototipidir; ticari üretim sistemi olarak sunulmadan önce yol haritasındaki kritik güvenlik ve işletim maddeleri tamamlanmalıdır. Mevcut ve planlanan kapsam docs/ROADMAP.md içinde açıkça ayrılmıştır.

Portföyde neyi gösteriyor?

Bu proje; ihtiyaç analizi, kurumsal arayüz tasarımı, rol ve firma bazlı veri modeli, API geliştirme, üçüncü taraf veri entegrasyonu, test, CI/CD ve Cloudflare dağıtımını tek üründe birleştirebilme yetkinliğini gösterir. Daha kısa ve işe alım odaklı anlatım için docs/PORTFOLIO.md dosyasını kullanabilirsiniz.

Katkı ve kullanım hakkı

Katkı süreci CONTRIBUTING.md dosyasında açıklanmıştır. Kaynak kodu herkese açık olarak incelenebilir; ancak kopyalama, yeniden dağıtma, ticari kullanım veya türev ürün oluşturma izni verilmemiştir. Ayrıntılar için LICENSE dosyasına bakın.

---

Teksanor — Sahadaki işi merkezdeki karara bağlayan mühendislik ve operasyon platformu.