How iota-uz/iota-sdk works
IOTA SDK is a modular, multi-tenant ERP platform with server-rendered web UI, GraphQL, finance, billing, authentication, search, and BI-Chat capabilities. The principal workflow is an authenticated user request entering application controllers or GraphQL, being resolved through module services and query repositories, and returning rendered or streamed results. The graph emphasizes the composition layer that assembles modules and controllers, while preserving major documented integrations. Several controller-to-service links are omitted because their implementations were not sampled.
Components 25
Runtime Composition
- Composition Engine
pkg/composition/engine.go - Server Entrypoint
cmd/server/main.go
Core ERP
- Core Controllers
modules/core/presentation/controllers - GraphQL API
modules/core/interfaces/graph - Organization Queries
modules/core/services/org_query_service.go - Group Queries
modules/core/services/group_query_service.go - User Query Repository
modules/core/infrastructure/query/user_query_repository.go - Group Query Repository
modules/core/infrastructure/query/group_query_repository.go
Finance Billing
- Finance Reports
modules/finance/infrastructure/query/financial_reports_query_repository.go - Transaction Queries
modules/finance/infrastructure/query/transaction_query_repository.go - Billing Service
modules/billing/services/billing_service.go - Payment Providers
modules/billing/infrastructure/providers
BI Chat
- BI Chat Controllers
modules/bichat/presentation/controllers - Chat Services
modules/bichat/services - OpenAI Providers
modules/bichat/infrastructure/llmproviders - Chat Persistence
modules/bichat/infrastructure/persistence - Validated Queries
modules/bichat/infrastructure/persistence/validated_query_repository.go
Auth Integrations
- Spotlight Search
pkg/spotlight/engine_meilisearch.go - OIDC Storage
modules/oidc/infrastructure/oidc/storage.go - Identity Repositories
modules/oidc/infrastructure/oidc
Other components
- ERP User
- Meilisearch
- PostgreSQL
- File Storage
- Payment Services
Connections 21
- ERP User → Server Entrypoint: requests
- Server Entrypoint → Composition Engine: assembles
- Composition Engine → Core Controllers: registers
- Composition Engine → BI Chat Controllers: registers
- Core Controllers → GraphQL API: exposes
- Organization Queries → PostgreSQL: reads
- Group Queries → Group Query Repository: calls
- Group Query Repository → PostgreSQL: queries
- User Query Repository → PostgreSQL: queries
- Finance Reports → PostgreSQL: queries
- Transaction Queries → PostgreSQL: queries
- Billing Service → Payment Providers: dispatches
- Payment Providers → Payment Services: charges
- BI Chat Controllers → Chat Services: dispatches
- Chat Services → OpenAI Providers: generates
- Chat Services → Chat Persistence: persists
- Validated Queries → PostgreSQL: stores
- Chat Persistence → PostgreSQL: stores
- Spotlight Search → Meilisearch: indexes
- OIDC Storage → Identity Repositories: uses
- OIDC Storage → PostgreSQL: reads keys