How ikramsarfraz/fluxora-oss works
Fluxora is a multi-tenant operations platform for food and wholesale distributors. Users enter a tenant workspace, then manage purchasing and receiving, inventory traceability, sales fulfillment, invoices, payments, and related finance operations. Tenant membership, roles, authentication, and subscription status frame access to those workflows; bank synchronization and platform administration are supporting capabilities. The graph combines README-described product stages with the sampled auth, database, invoice-parsing, and Plaid relationships. Several distribution modules are represented at their documented directory level because their implementation excerpts were not provided.
Main entry points: parsing-pipeline.ts Supplier invoices · auth.ts Authentication · transaction-sync.ts Bank synchronization · billing Tenant billing
Components 22
Identity & Workspace
- Authentication
lib/auth.ts - Tenant membership
modules/shared/services/portal-users.ts - Tenant context
modules/core/tenants/services/tenants.ts - Tenant host routing
lib/tenant-host.ts
Distribution Operations
- Customers & products
modules/distribution - Supplier invoices
modules/distribution/supplier-invoices/services/parsing-pipeline.ts - PDF prefill
modules/distribution/supplier-invoices/utils/pdf-prefill.ts - Invoice AI extraction
modules/distribution/supplier-invoices/services/ai-provider.ts - Line normalization
modules/distribution/supplier-invoices/utils/normalization.ts - Invoice review mapping
modules/distribution/supplier-invoices/components/review/map-pipeline-to-review-data.ts - Inventory & lots
modules/distribution - Sales orders
modules/distribution/orders - Sales invoices
modules/distribution/invoices
Finance & Integrations
- Payments & expenses
modules/distribution - Bank synchronization
modules/distribution/plaid/services/transaction-sync.ts - Plaid API
Platform Services
- Tenant billing
modules/core/billing - Stripe
- Application database
db/schema.ts - Database client
db/index.ts - Platform administration
modules/core/platform-admin
Other components
- Workspace user
Connections 22
- Workspace user → Authentication: signs in
README.md - Authentication → Tenant context: resolves workspace
lib/auth.ts - Authentication → Tenant membership: provisions access
lib/auth.ts - Tenant context → Tenant host routing: resolves host
modules/core/tenants/services/tenants.ts - Workspace user → Customers & products: manages records
README.md - Workspace user → Supplier invoices: receives supplier bills
README.md - Supplier invoices → PDF prefill: parses PDF text
modules/distribution/supplier-invoices/services/parsing-pipeline.ts - Supplier invoices → Invoice AI extraction: extracts with vision
modules/distribution/supplier-invoices/services/parsing-pipeline.ts - Supplier invoices → Line normalization: normalizes lines
modules/distribution/supplier-invoices/services/parsing-pipeline.ts - Supplier invoices → Invoice review mapping: maps for review
modules/distribution/supplier-invoices/components/review/map-pipeline-to-review-data.ts - Workspace user → Inventory & lots: tracks stock
README.md - Workspace user → Sales orders: fulfills orders
README.md - Workspace user → Sales invoices: generates invoices
README.md - Workspace user → Payments & expenses: records finances
README.md - Workspace user → Bank synchronization: connects bank
README.md - Plaid API → Bank synchronization: sends updates
- Bank synchronization → Plaid API: fetches transactions
modules/distribution/plaid/services/transaction-sync.ts - Workspace user → Tenant billing: manages subscription
README.md - Tenant billing → Stripe: uses billing services
README.md - Stripe → Tenant billing: updates by webhook
- Database client → Application database: configures schema
db/index.ts - Platform administration → Application database: manages platform data