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).
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"
▼
[Satınalma] Talep → tedarikçi teklifi → PO → teslimat → fatura (9 statü)
│
▼
[Garanti & Servis] Teslim sonrası servis talebi/arıza kaydı → çözüm → kapanış
│
▼
[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). 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.
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 |
| 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 → 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, /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. 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). Toplam 20 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 | KSU + Yönetim |
| Proje Yönetimi | Otomatik proje + milestone şablonu; karlılık (overhead dahil); 11 zorunlu devir evrakı | 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ı → çözüm → kapanış; projeyle ilişkili | Proje / Teknik Servis |
| 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ı) |
| 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 |
| 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 |
7Kurulum 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.
8Wiki 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.