Finance Module

The Finance Module provides a complete financial management system for multi-tenant business operations. It handles all aspects of monetary transactions, cash flow management, financial reporting, and accounting operations.

Module Overview

The Finance Module manages the complete financial lifecycle:

  • Money Accounts: Bank accounts, cash registers, payment systems
  • Transactions: Core transaction records with multi-currency support
  • Payments: Payment processing with category tracking
  • Expenses: Expense management with category classification
  • Counterparties: Customer/vendor management with contact details
  • Debts: Receivables and payables tracking
  • Inventory: Product/service inventory with pricing
  • Financial Reports: Income statements, cash flow analysis, account statements

Architecture 

modules/finance/
├── domain/
│   ├── aggregates/
│   │   ├── payment/            # Payment processing
│   │   ├── expense/            # Expense tracking
│   │   ├── payment_category/   # Expense categories
│   │   ├── expense_category/   # Payment categories
│   │   ├── debt/               # Receivables/Payables
│   │   ├── money_account/      # Account management
│   │   └── expense_category/   # Category definitions
│   ├── entities/
│   │   ├── transaction/        # Transaction records
│   │   ├── counterparty/       # Customer/vendor data
│   │   └── inventory/          # Product inventory
│   └── value_objects/
│       ├── income_statement/   # Financial reports
│       └── cashflow_statement/ # Cash flow analysis
├── infrastructure/
│   ├── persistence/
│   │   ├── schema/            # Database migrations
│   │   └── repositories/      # Data access layer
│   └── query/                 # Advanced queries
├── services/                  # Business logic layer
├── presentation/
│   ├── controllers/           # HTTP request handlers
│   ├── templates/             # Templ-based UI templates
│   └── locales/              # I18n translation files
└── permissions/               # Permission constants

Integration Points

Module Integration Purpose
Core User/Tenant Context Authorization, tenant isolation, user tracking
Warehouse Inventory Product pricing, stock management
HRM Employee Management Expense approval, payroll (future)
Reporting Analytics Financial KPIs, dashboards (future)

Key Entities

Money Accounts

  • Bank accounts with balances
  • Multi-currency support
  • Transaction history
  • Balance reconciliation

Transactions

  • Core transaction records
  • Multi-currency transactions
  • Exchange rate tracking
  • Income/expense/transfer types
  • Transaction dates and periods

Payments

  • Payment processing
  • Counterparty tracking
  • Payment categories
  • Attachment support
  • Settlement tracking

Expenses

  • Expense categorization
  • Category-based organization
  • Transaction linking
  • Budget tracking

Counterparties

  • Customer/vendor management
  • Contact information
  • Tax identification (TIN)
  • Legal entity details
  • Communication history

Debts

  • Receivables (customer debts)
  • Payables (vendor debts)
  • Settlement tracking
  • Due date management
  • Multi-currency support

Financial Reports

  • Income statements (P&L)
  • Cash flow statements
  • Account reconciliation
  • Period-based reporting

Common Operations

Create Payment 

// Service handles payment creation
paymentService.Create(ctx, paymentData)
// Automatically updates account balance

Record Expense 

// Service handles expense recording
expenseService.Create(ctx, expenseData)
// Links to transaction and category

Track Debt 

// Service handles debt tracking
debtService.Create(ctx, debtData)
// Tracks receivable or payable

Generate Report 

// Service generates financial reports
reportService.GenerateIncomeStatement(ctx, params)
reportService.GenerateCashflowStatement(ctx, params)

Module Statistics

  • Tables: 12+ (accounts, transactions, payments, expenses, debts, categories, etc.)
  • Services: 10+ (payment, expense, transaction, account, debt, inventory, report services)
  • Controllers: 10+ (payments, expenses, accounts, debts, counterparties, reports)
  • Permissions: 40+ granular permissions for financial operations
  • Repositories: 10+ with advanced query and reporting support

Highlights

  • Multi-tenant Isolation: Complete financial data isolation per tenant
  • Multi-currency Support: Transaction and account management in multiple currencies
  • Real-time Balance Updates: Automatic balance calculation on transactions
  • Financial Reporting: Comprehensive income and cash flow statements
  • Debt Management: Track both receivables and payables with settlement tracking
  • Event Publishing: Domain events for all financial operations
  • File Attachments: Support for receipts and documentation
  • Query Optimization: Advanced queries for reporting and analysis

Key Features

Payment Processing

  • Multiple payment types (cash, check, transfer, etc.)
  • Counterparty tracking
  • Category-based organization
  • Attachment support for receipts
  • Balance synchronization

Expense Management

  • Category-based organization
  • Transaction linking
  • Approval workflows (future)
  • Budget tracking
  • Receipt documentation

Financial Reporting

  • Period-based reporting
  • Multi-currency consolidation
  • Income statement (P&L) generation
  • Cash flow analysis
  • Account reconciliation

Debt Tracking

  • Receivables and payables
  • Settlement tracking
  • Due date management
  • Multi-currency debt
  • Partial settlement support

Account Management

  • Balance tracking
  • Transaction history
  • Statement generation
  • Account reconciliation
  • Multi-currency accounts

Table of contents

Back to top

IOTA SDK - Multi-tenant Business Management Platform