Enflow — uçtan uca süreç yönetimi
Bir işin müşteri ilgisinden (fırsat) başlayıp teklif → sözleşme → proje → satınalma → faturalamaya kadar tüm yolculuğunu tek platformda yöneten, çok-kiracılı kurumsal yazılım. Bu sayfa yazılımı hiç bilmeyen birine baştan sona anlatır.
1Enflow nedir? (tek paragraf)
Enflow, bir işin müşteri ilgisinden (fırsat) başlayıp teklif → sözleşme → proje → satınalma → faturalamaya kadar tüm yolculuğunu tek platformda yöneten, çok-kiracılı (multi-tenant) bir kurumsal süreç yönetim yazılımıdır. Her aşama bir birime (Satış, Presales, İhale, Hukuk, Proje, Satınalma, Finans…) aittir. İşler birimler arasında görevler, onay zincirleri ve hand-off (devir) mekanizmasıyla akar; her adım kayıt altına alınır (log/bildirim). Enflow AI v3.0.0 bu yapının üzerine, hiçbirini değiştirmeden bir yapay zeka katmanı ekler: kullanıcı bilgiyi ekranlar arasında aramak yerine asistana sorar (ayrıntı: "Enflow AI (v3.0.0)" bölümü).
2Uçtan uca akış — bir işin yolculuğu (newcomer anlatımı)
[Saha/Ziyaret] Müşteri ziyaret planlanır, günlük rapor girilir
│
▼
[CRM] Fırsat açılır (müşteri + tahmini değer). Kazanılır/kaybedilir.
│
▼
[Presales] Fırsata BoM (malzeme listesi) + maliyet/marj hazırlanır → Teklif
│ (Şartname varsa SpecAnalysis ile AI analizi)
▼
[Teklif/Müzakere] Teklif versiyonlanır, onaya gönderilir (Onay Zinciri devreye girer),
│ müşteriyle pazarlık turları yürütülür
▼
[İhale/İYB] (Kamu işi ise) İhale dosyası + uygunluk checklist + geçici teminat
│
▼
[Sözleşme] ContractWorkflow: evrak hazırlık → imza onayı → SIGNED
│ (Birim yöneticisi onayı; AI ile sözleşme/şartname analizi)
▼
[Proje Yönetimi] Kazanılan iş projeye döner: milestone'lar, maliyet, karlılık,
│ 11 zorunlu evrakla "Devir Paketi"; sözleşmedeki teslim süresi
│ alt-kırılımlı takvime (Sipariş Onayı/Üretim/Sevkiyat/Teslim) döner
▼
[Satınalma] Talep → tedarikçi teklifi → PO → teslimat → fatura (9 statü)
│
▼
[Garanti & Servis] Teslim sonrası servis talebi/arıza kaydı (ServiceTicket) açılır
│ → "Teknisyen Sevk Et" ile Profesyonel Hizmetlere köprülenir
▼
[Profesyonel Kurulum/arıza/bakım iş emri (WorkOrder): birim yöneticisi teknisyen
Hizmetler] sevk eder (uzmanlık/kapasite-farkında) → SLA takibi → kapanış
│ **dosya-kanıtı zorunlu** (müşteri imza/onayı olmadan tamamlanamaz)
▼
[Finans] Faturalama, tahsilat (kısmi), teminat mektupları, maliyet onayı,
kur farkı (FX) mahsubu
Bu hattın üstünde çalışan kesişen bileşenler: Onay Swimlane (Finans→İGB→GM→KSU), Hukuk (vaka takibi), Genel Hususlar (risk/ders/KPI), Yönetim Raporları (birim metrikleri), Sanal Agentlar (boş birim koltuğunu dolduran vekiller), Kârlılık (proje/tenant genelinde plan↔gerçek zamana-duyarlı kârlılık + nakit/hazine analizi — hattı izler, mutasyon yapmaz). Ayrıca ana hatla paralel/opsiyonel bir kanal: DMO Kataloğu — devlet malzeme ofisi tipi sipariş/kârlılık akışı, kendi kur+risturn+komisyon maliyetlendirme motoruyla ana CRM→Sözleşme hattından bağımsız çalışır (Kârlılık modülünde ayrı bir sekme olarak görünür, proje kümülatifine karışmaz).
financeEngine); döviz toplamları daima ayrı (sessiz tek-toplam yok).3Katmanlı bileşen haritası
| Katman | Bileşenler (model → modül → API) |
|---|---|
| 0 · Platform/SaaS | Tenant, Subscription, UsageMetric → SettingsModule (Abonelik alt-sekmesi) / LicenseTypes / LicenseGenerator / ProvisionWizard → /tenants |
| 1 · Kimlik & Yetki (RBAC) | User, Unit → UserManagement / UnitManagement / PermissionSettings → /auth, /users, /units |
| 2 · Akış motoru | Workflow, WorkflowStep, WorkflowLog, TodoTask, ApprovalChain, ApprovalStage, Notification, ActivityLog → WorkflowBuilder / TodoModule + workflowService → /workflows, /tasks, /approval-chains, /notifications |
| 3 · Domain birimleri | VisitPlan/Visit/DailyReport · Customer/Contact/Opportunity · BoMItem/CostItem · Proposal · Tender/TenderChecklistItem · Contract/ContractWorkflow/Doc · Project/Milestone/CostItem/HandoverDoc · Vendor/PurchaseRequest/Item/Quote/DeliveryRecord · Invoice/Payment/GuaranteeLetter/FxAdjustment · LegalCase · ServiceTicket → ilgili modüller (+ Garanti & Servis) → /visits,/customers,/opportunities,/proposals,/tenders,/contracts,/contract-workflows,/projects,/purchase-requests,/vendors,/finance,/legal,/service-tickets |
| 3b · Profesyonel Hizmetler | WorkOrder (SLA/teknisyen maliyeti/müşteri CSAT) · WorkSpecialty/UserWorkSpecialty (tenant-bazlı uzmanlık taksonomisi) · ServiceWorkPlan (haftalık teknisyen dağıtım planı) · WorkOrderMaterialRequest (dış kaynak malzeme mini-onayı, 9 statülü satınalma zincirinin KASITLI dışında) · ServiceTicketAttachment/WorkOrderAttachment → ProfessionalServicesModule (Liste/Haftalık Takvim/Ekip Utilizasyonu) → /work-orders,/work-specialties,/service-work-plans |
| 4 · Yönetişim & Belge | DocumentCodingProfile/CategoryCode/Sequence · LessonsLearned/RiskOpportunity/CorporateMetric/ExternalDocumentRegister · CorporateDocument/ArchiveItem · UnitReport → CorporateGovernance / Documents / Archive / ManagementReporting → /document-coding,/corporate-governance,/documents,/archive,/reports |
| 5 · YZ / Sanal Agent | PluginEntitlement, AgentRun, AssistantRun → AssistantPanel (Enflow AI asistanı, 21 salt okunur araç, ASSISTANT eklenti lisansı) + VirtualAgentsTestModule + SpecAnalysis / SpecComplianceMatrix (Şartname↔Ürün specsheet uygunluk matrisi + xlsx, yalnız YZ anahtarı varsa) / ContractWorkflow (istenilen YZ — tenant-yapılandırmalı, aiClient; modül-bazlı YZ kapısı, key yoksa Entegrasyonlar'a yönlendirir) → /plugins, /assistant, /presales/spec-extract, /presales/spec-compliance, /tenants/ai-settings |
| 6 · Entegrasyon & Admin | IntegrationWizard (YZ/Nextcloud/Exchange/WhatsApp), SecurityTestModule → nextcloud/exchange/whatsapp servisleri → /sync, /admin/security-test |
| 7 · Yedekleme & Yönetişim | BackupJob, RestoreJob → BackupModule + Backup Admin (salt-okunur rol) → backupService/backupVerifyService/restoreService/backupScheduler (LOCAL/Nextcloud/S3, doğrulama, fark-analizli restore, zamanlı) → /backup. Yönetişim: governance (Görev Ayrılığı SoD + tutar-bazlı onay matrisi/DoA), financeEngine (kuruş tabanlı net/KDV/brüt + kur farkı) → /tenants/governance-settings, /finance/calc. İşletme maliyeti: OperatingCostPool/UnitBudget/ProjectUnitParticipation → overheadService (şirket% + birim katsayı 2-katmanlı dağıtım, tam-yüklü net marj) → proje detayında Overhead paneli. DMO Kataloğu (paralel kanal): DmoCatalogItem/DmoFrameworkAgreement/DmoExchangeRate/DmoOrder/DmoOrderItem → dmoCosting (kur açığı+risturn+komisyon) → DmoModule → /dmo. Kârlılık & Hazine: profitabilityLedger/profitabilityRollup/profitabilityCashflow/profitabilityInstruments/profitabilitySnapshot (salt-okunur, plan↔gerçek + nakit pozisyonu + faiz-bazlı hazine + faktoring/mevduat/forward-FX senaryoları + aylık plan-drift) → ProfitabilityModule → /profitability. Teslim Süresi Takibi: DeliveryTimelineStep → deliveryTimeline/deliveryPenalty (alt-kırılımlı takvim + otomatik cezai şart hesabı, 30/15/7/1 gün hatırlatması) → ContractWorkflow/Tender/Proje ekranlarında. Uygulama-içi Yardım: statik makale seti (src/content/helpArticles.ts) → HelpModule (Header'daki Yardım ikonu) → rol-duyarlı, bağlamsal kullanım kılavuzu; harici genel-tanıtım için bu wiki'ye link verir. |
4Akış motoru — birimler birbiriyle nasıl "konuşur"
Süreç-yönetiminin kalbi bu katmandır; domain birimlerini birbirine bağlar:
- İş Akışı Şablonu (Workflow/WorkflowStep): Tenant'ın aktif birimlerinden türeyen kanonik sıra; bir birim çıkarılınca iş otomatik bir sonraki aktif birime yönlenir (skip-logic, deadlock olmaz).
- Görevler (TodoTask): Birimler-arası iş, görev olarak atanır.
relatedModuleetiketi işin hangi modüle ait olduğunu söyler: OPPORTUNITY · PROPOSAL · CONTRACT · PROJECT · PROCUREMENT · DELIVERY · LEGAL · GENERAL. İş günü SLA ile termin otomatik hesaplanır. - Hand-off / Devir (
workflowService.triggerHandOff): Bir birim işini bitirince sonraki birime devreder → e-posta + bildirim + log üretilir. - Onay Zinciri (ApprovalChain/Stage): Çok-aşamalı onay (Finans→İGB→GM→KSU). "Bekleyen Onaylarım" sekmesi role göre sırası gelmiş onayları gösterir; aktif kullanıcısı olmayan rol otomatik atlanır (orphan-skip).
- Bildirim & Log (Notification / ActivityLog): Kullanıcı bildirimleri + değişiklik/denetim izi (provenance:
AGENT:<key>ile agent kökeni dahil).
5Roller & birimler
GENERAL_MANAGER (superuser), SALES_MANAGER, PRESALES, PROCUREMENT, LEGAL_MGR, PROJECT_MANAGER, ADMIN + kurumsal onay rolleri: FINANCE_MGR, IGPD_MGR (İş Geliştirme), KGD_MGR (Kalite Yönetimi), KSU_MGR (Kontrat & Sözleşme), ISAB_MGR (İhale Birimi) + BACKUP_ADMIN (Yedek Yöneticisi — tüm akışa salt-okunur dahil; yalnız yedek/restore yazabilir) + OPERATIONS_MGR (Profesyonel Hizmetler Müdürü — teknisyen sevkiyatı) / PS_TECH (teknisyen — yalnız kendi iş emrini görür/yürütür). Toplam 21 rol. İzinler kullanıcının permissions JSON'undan gelir; GM her şeyi görür.
6Modül kılavuzu (özet)
Sidebar'daki her modül: ne yapar, kim kullanır.
| Modül | Ne yapar | Kim |
|---|---|---|
| Dashboard | Role göre kişisel kokpit: KPI, zamana-duyarlı işler, bekleyen onaylar | Herkes |
| Ziyaret Planı | Haftalık ziyaret + günlük rapor; plan↔gerçekleşen mutabakatı | Satış / Saha |
| CRM | Müşteri & fırsat, teklif, pazarlık; Maliyet Analizi (forward-kur + marj, müdür onayı) | Satış |
| Presales & Dizayn | BoM + vendor teklif değerlendirme (fiyat + teknik uygunluk + dosya kanıtı) + Şartname↔Ürün specsheet uygunluk matrisi/xlsx (yalnız YZ anahtarı varsa) → Satışa devir | Presales / Teknik |
| Satış Destek (İhale) | Şartname YZ analizi → evrak listesi (otomatik eşleme) → teminat → zaman-duyarlı hatırlatma | Satış Destek / İYB |
| Sözleşme Yönetimi | Evrak hazırlık → imza onayı (KSU→GM) → SIGNED → Proje + Satınalmaya devir; teslim süresi + cezai şart takibi (alt-kırılımlı takvim) | KSU + Yönetim |
| Proje Yönetimi | Otomatik proje + milestone şablonu; karlılık (overhead dahil); 11 zorunlu devir evrakı; teslim milestone'u tamamlanınca ilgili birimlere teyit bildirimi | Proje |
| Satın Alma | BoM + referans alış fiyatı ile 9 statülü satınalma (talep→PO→teslimat→fatura) | Satın Alma |
| Garanti & Servis | Teslim-sonrası servis/arıza talebi kaydı (ServiceTicket) → çözüm → kapanış; projeyle ilişkili; "Teknisyen Sevk Et" ile Profesyonel Hizmetlere köprülenir | Proje / Teknik Servis |
| Profesyonel Hizmetler | Ticket-bazlı iş emri (WorkOrder): kurulum/arıza/bakım → birim yöneticisi uzmanlık+kapasite-farkında teknisyen sevk eder; haftalık dağıtım planı (Liste/Haftalık Takvim); SLA takibi (öncelik-bazlı öneri + eskalasyon bildirimi) + teknisyen maliyeti (yalnız GM/Müdür görür) + CSAT; kapanış dosya-kanıtı zorunlu (müşteri imza/onayı); dış malzeme için 9 statülü satınalma zincirinin dışında mini-onay akışı; Ekip Utilizasyonu raporu | Operasyon Müdürü / Teknisyen |
| Finans | Fatura/tahsilat/maliyet onayı; teminat; taksitli tahsilat + finansman etkisi; kur farkı mahsubu | Finans |
| DMO Kataloğu | Devlet malzeme ofisi tipi sipariş + kur/risturn/komisyon kârlılık motoru (paralel kanal) | Satış / Finans (lisanslı) |
| Kârlılık | Zamana duyarlı plan↔gerçek kârlılık (proje/aylık/çeyreklik/yıllık) + konsolide nakit pozisyonu + hazine katkısı + finansal enstrüman senaryoları (faktoring/vadeli mevduat/forward FX) + aylık plan-drift snapshot'ı; salt-okunur, mutasyon yapmaz | GM / Finans / Proje / Satış Müdürü |
| Görevler & Takip | Birimler-arası görev havuzu + "Bekleyen Onaylarım"; iş-günü SLA | Tüm birimler |
| Yönetim Raporları | Birim metrik + darboğaz + dönem raporu (escalation) + yazdırma | GM + Müdürler |
| Genel Hususlar | Dersler/risk/KPI/dış doküman + doküman kodlama | Kalite / Yönetim |
| Şirket Evrakları | Kurumsal doküman envanteri (geçerlilik tarihli) + alt-menüde Fiziksel Arşiv (kutu/raf arşiv; kaybedilen fırsat + BoM değerlendirme otomatik) | İdari |
| Yedekleme | Sistem yedeği (LOCAL/Nextcloud/S3) → doğrulama → fark-analizli restore → zamanlama | Backup Admin |
| Şirket Ayarları | Birim/kullanıcı, RBAC, YZ & entegrasyonlar, abonelik, lisans, sanal-agent | ADMIN / GM |
| Enflow AI Asistanı | Her ekrandan açılan sohbet paneli: tüm modülleri okuyup soruları kayıtlardan cevaplar, kaynak ekranı söyler; kayıt değiştirmez (ayrıntı: "Enflow AI (v3.0.0)" bölümü) | Herkes (kendi yetkisi kadar) |
| Talep & Geri Bildirim | Enflow'a ürün talebi/hata/iyileştirme gönder; sınıflandırma/öncelik/timeline dış triage aracından döner | Herkes |
| Yardım | Uygulama-içi, bağlamsal kullanım kılavuzu — her modül için "nasıl kullanılır" | Herkes |
7Enflow AI (v3.0.0) — yapay zeka katmanı ve asistan
Enflow AI v3.0.0, çalışan Enflow v2.5.0'ın üzerine kurulan bir yapay zeka katmanıdır. Uçtan uca akış, roller ve izinler, onay zincirleri ve denetim izi olduğu gibi korunur; yapay zeka bunların yerine geçmez, onları taşır.
Asistan ne yapar? Ekranın sağından açılan bir sohbet penceresidir. Kullanıcı "Bu çeyreğin kârlılığı nasıl?" gibi bir soru sorar; asistan cevabı modelin hafızasından değil, o anki kayıtlardan üretir.
- Tüm modülleri okur: 21 okuma aracıyla CRM, teklif, ihale, sözleşme, proje, satınalma, finans, görevler, evraklar, yönetişim ve denetim izi; dashboard göstergeleri, kârlılık ve yönetim analizleri dahil.
- Soruya göre araç seçer: Her soruda modele yalnız ilgili araçlar sunulur; küçük yerel modellerde de isabetli ve hızlı cevap verir.
- Dönemi ve niyeti netleştirir: Tarihe bağlı bir soruda dönem verilmemişse sorar; belirsiz bir soruda (örn. hangi kırılım: proje, müşteri ya da ürün grubu) önce ne kastedildiğini sorar.
- Kaynağını söyler: Cevabın hangi ekrandan geldiğini ve nasıl hesaplandığını belirtir; kullanıcı aynı rakamı o ekranda doğrulayabilir.
- Uydurmaz: Veri yoksa "yok" der; kayıtlara bakmadan cevap üretmeye kalkışırsa yeniden yönlendirilir.
- Sınırını belirtir: Pencerede her zaman "Asistan hata yapabilir" uyarısı görünür; önemli kararlarda kaynak ekran kontrol edilmelidir.
Uzun belgelerin analizi: Sözleşme ve şartnameler parçalara bölünür, her parça ayrı incelenir (yükümlülük, ceza, teminat, süre) ve sonuçlar birleştirilir. Uzun analizler arka planda sürer; ilerleme ekranda izlenir.
Güvenlik — yeni bir istisna yok:
- Ekranla birebir yetki: Her asistan aracı rol ve izin kontrolünden geçer. Kullanıcının ekranda göremediği veriyi asistan da göremez (örn. satış temsilcisi yalnız kendi fırsatlarını). Dashboard ve rapor API uçları da aynı kurala göre sıkılaştırıldı; bin üzerinde otomatik yetki testi her değişiklikte çalışır.
- Salt okunur: Asistan kayıt oluşturamaz, değiştiremez, onaylayamaz. Onay ve eylem her zaman yetkili kişidedir.
- Modele giden veri: Kayıt kimlikleri ve kişisel iletişim bilgileri modele gönderilmez. Her asistan çalışması araç kullanımıyla denetim izine yazılır; mesaj içeriği saklanmaz.
Sağlayıcı ve model: Yapay zeka sağlayıcısı koda gömülü değildir; şirket kendi sağlayıcısını kendi anahtarıyla Şirket Ayarları → Entegrasyonlar'dan seçer. Ollama, LM Studio veya vLLM gibi yerel bir sunucu kullanıldığında veri şirket dışına çıkmaz. Model profili bağlanan modelin bağlam uzunluğunu ve hızını ölçer; girdi boyutu, cevap uzunluğu ve zaman aşımlarını buna göre kendisi ayarlar, daha büyük bir modele geçildiğinde ayarlar kendiliğinden güncellenir.
Lisans: Asistan, ASSISTANT eklenti lisansıyla açılır.
8Kurulum ve İlk Yapılandırma (Yönetici İçin)
Enflow'u ilk kez kuran/yapılandıran bir yönetici için adım adım anlatım — işletim sistemine göre kurulum, lisans girişi, birim/kullanıcı oluşturma, iş akışı yapılandırma ve birim-bazlı kullanım kılavuzu dahil tam sürüm: install/ILK_KURULUM_KILAVUZU.md (kurulum paketiyle birlikte dağıtılır). Özet:
1. Kurulum — Windows: install\install.bat'e çift tıklayın (veya PowerShell'de install.ps1). macOS/Linux: ./install/install.sh. Betik Node/git eksikse otomatik kurar, ardından port + veritabanı (SQLite/PostgreSQL) + güvenlik anahtarları için birkaç soru sorup backend/.env'i kendisi yazar. 2. İlk açılış — tarayıcıda uygulamayı ilk açtığınızda 5 adımlı bir sihirbaz (Sistem → Şirket → Yönetici → Lisans → Tamamla) sizi karşılar; oluşturduğunuz ilk kullanıcı otomatik Genel Müdür (GENERAL_MANAGER) olur. 3. Lisans — Şirket Ayarları → Lisans Planları'nda Tenant ID'nizi kopyalayıp lisans anahtarınızı aktifleştirin (lisans yoksa 30 günlük deneme ile devam edilir). Sanal agent/eklenti lisansları ayrıdır, Test Ortamı → Sanal Agentlar'dan girilir. 4. Birimler & kullanıcılar — Şirket Ayarları → Birimler'de "Varsayılan Şablonu Yükle" tek tıkla 8 standart onay-zinciri birimini + varsayılan iş akışını kurar; organizasyona özgü ek birimler (Proje, Satın Alma, Hukuk vb.) elle eklenir. Kullanıcılar'da ekip eklenirken rol + birim atanır — rol otomatik izin vermez, Yetkiler sekmesinden ayrıca modül erişimi açılmalıdır. 5. İş akışı — birimlerden otomatik türeyen varsayılan şablon İş Akışı sekmesinde gözden geçirilip adım bazında ince ayar yapılabilir; Simülasyon sekmesi canlı veri değiştirmeden akışı test etmeye yarar.
9Wiki kılavuzluk notu
Statik enflow-wiki (wiki/index.html) bu bölümden otomatik üretilir (node wiki/build.mjs). Akış değişince önce §27 güncellenir, sonra generator yeniden çalıştırılır — tek doğruluk kaynağı §27'dir. Hedef: yazılımı hiç görmemiş birinin tek sayfadan uçtan uca anlayabilmesi.