How hamzadenizyilmaz/gib-framework works
GIB Framework is a multi-tenant e-invoicing platform for Turkish e-Fatura and e-Arşiv workflows. Its principal flow prepares invoices, applies tax and compliance checks, then supports approval, signing, submission, and archiving; marketplace and commerce integrations can also turn incoming orders into invoices. The graph preserves major documented capabilities, including GİB Portal, messaging, and audit. Several links are documented at product level; frontend-to-backend wiring and unsampled implementation details are left unverified rather than inferred.
Main entry points: InvoiceService.cs Invoice workflow · App.jsx Web application · Controllers REST controllers · InvoiceRepository.cs Invoice repository
Components 24
User experience
- Web application
GIBFramework/ClientApp/src/App.jsx - REST controllers
GIBFramework/Controllers
Invoice lifecycle
- Invoice workflow
GIBFramework/Services/Invoices/InvoiceService.cs - Invoice records
GIBFramework/Models/Invoices/Invoice.cs - Invoice repository
GIBFramework/DAL/Invoices/InvoiceRepository.cs - GİB Portal workflow
GIBFramework/Services/GibPortal/GibPortalService.cs - Portal client
GIBFramework/Infrastructure/GibPortal/GibPortalClient.cs
Tax and compliance
- Tax calculation
GIBFramework/Services/Tax/TaxEngine.cs - Compliance rules
GIBFramework/Services/Compliance/ComplianceEngine.cs - Rule definitions
GIBFramework/DAL/Compliance/JsonRuleSetLoader.cs
Documents and evidence
- UBL generation
GIBFramework/Services/Ubl/UblInvoiceWriter.cs - UBL validation
GIBFramework/Services/Ubl/UblValidator.cs - XAdES signing
GIBFramework/Services/Signing/XadesSigner.cs - PDF rendering
GIBFramework/Services/Documents/PdfInvoiceRenderer.cs - Evidence vault
GIBFramework/Infrastructure/Storage/FileSystemEvidenceVault.cs
Platform services
- Order integrations
GIBFramework/Services/Integrations/IntegrationService.cs - Email and SMS
GIBFramework/Services/Messaging/MessageDeliveryService.cs - Audit trail
GIBFramework/DAL/Audit/SqlAuditTrail.cs - Tenant context
GIBFramework/Infrastructure/Tenancy/RequestTenantContext.cs - SQL Server
GIBFramework/DAL/SqlConnectionFactory.cs
Other components
- Tenant user
- GİB services
- Mail and SMS providers
- Commerce platforms
Connections 23
- Tenant user → Web application: uses
README.md - Web application → REST controllers: calls API
- REST controllers → Invoice workflow: handles invoice actions
- Invoice workflow → Invoice records: creates and updates
GIBFramework/Services/Invoices/InvoiceService.cs - Invoice workflow → Invoice repository: persists invoices
GIBFramework/Services/Invoices/InvoiceService.cs - Invoice workflow → Tax calculation: validates tax
GIBFramework/Services/Invoices/InvoiceService.cs - Invoice workflow → Compliance rules: checks rules
GIBFramework/Services/Invoices/InvoiceService.cs - Compliance rules → Rule definitions: uses rule sets
- Invoice workflow → UBL generation: generates UBL
GIBFramework/Services/Invoices/InvoiceService.cs - UBL generation → UBL validation: validates output
- Invoice workflow → XAdES signing: signs document
- Invoice workflow → PDF rendering: renders PDF
- Invoice workflow → Evidence vault: archives evidence
GIBFramework/Services/Invoices/InvoiceService.cs - Invoice workflow → GİB Portal workflow: submits via portal
GIBFramework/Services/GibPortal/GibPortalService.cs - GİB Portal workflow → Portal client: uses client
GIBFramework/Services/GibPortal/GibPortalService.cs - Portal client → GİB services: communicates with
- Commerce platforms → Order integrations: sends orders
README.md - Order integrations → Invoice workflow: creates invoices
GIBFramework/Services/Integrations/IntegrationService.cs - Invoice workflow → Email and SMS: notifies recipients
- Email and SMS → Mail and SMS providers: delivers messages
README.md - Invoice workflow → Audit trail: records actions
GIBFramework/Services/Invoices/InvoiceService.cs - Tenant context → SQL Server: scopes connections
GIBFramework/DAL/SqlConnectionFactory.cs - Invoice repository → SQL Server: reads and writes