Financial Management
Relevant source files
The following files were used as context for generating this wiki page:
Financial Management within the Tuturuuu platform is a multi-layered system designed to provide intelligent oversight of both personal and business finances. It integrates with the broader workspace ecosystem to automate expense tracking, budget monitoring, and financial reporting. The system is built to minimize digital noise by centralizing financial data and providing actionable insights through AI-powered analytics.
The module operates across several applications, primarily the core web application and a dedicated finance service. It handles everything from individual transaction recording to complex workspace-level payroll processing and workforce compensation management.
Sources: README.md:16-24, apps/web/src/app/[locale]/(marketing)/products/finance/page.tsx:86-90
Core Features and Functionality
The financial management system is categorized into several high-level functional areas, ranging from simple expense tracking to enterprise-grade financial planning.
| Feature | Description |
|---|---|
| Expense Tracking | Automated receipt processing and categorization of spending. |
| Budget Management | Real-time monitoring of spending against defined budget limits. |
| Financial Reports | Generation of comprehensive analytics and spreadsheets for financial health. |
| Payment Processing | Secure handling of transactions via integrated payment gateways. |
| Cash Flow Analysis | Advanced analytics for monitoring and forecasting liquidity. |
| Financial Planning | AI-powered strategy optimization and scenario planning. |
Sources: apps/web/src/app/[locale]/(marketing)/products/finance/page.tsx:28-52
Workforce and Payroll System
A significant component of the financial management architecture is the Workspace Workforce & Payroll System. This system links active workspace members to HR and financial records to automate compensation.
System Architecture and Data Flow
The payroll system follows a structured lifecycle from data foundation to financial history reporting. It relies on a series of database tables to maintain referential integrity between users, their contracts, and their pay history.
The diagram shows the logical progression from establishing workforce identities to the execution of payroll runs and final payouts.
Sources: conductor/tracks/workforce_20251225/plan.md:3-35
Implementation Phases
The workforce financial module is implemented through the following phases:
- Identity Linking: Smart re-linking of workspace members to HR records.
- Employment Lifecycle: Management of multi-term contracts and recurring benefits.
- Payroll Engine: Integration with time-trackers to calculate hourly rates and overtime multipliers.
- Administrative UI: Tools for HR to manage directories and employee profiles.
- Self-Service: Portals for employees to view payslip history and leave balances.
Sources: conductor/tracks/workforce_20251225/plan.md:6-45
Technical Infrastructure
External Integration and SDK
The platform provides a public SDK (tuturuuu) that allows external applications to interact with the financial and storage infrastructure. For financial operations, the SDK utilizes signed URLs and specific permission scopes to ensure security.
- Permission Scopes: Operations are gated by permissions such as
manage_driveandmanage_documents. - Security: Uses bank-grade encryption and state-of-the-art security measures for protecting financial data.
- Currency Logic: In the finance module, exchange rates use USD as the base currency.
Sources: apps/web/src/app/[locale]/(dashboard)/[wsId]/(workspace-settings)/api-keys/sdk-guide.tsx:105-130, apps/web/src/app/[locale]/(marketing)/products/finance/page.tsx:94-102, GEMINI.md:280-282
AI-Powered Analytics
The system leverages the platform's AI capabilities (Mira) to provide insights. The AI can process uploaded financial documents (PDFs, JSON, Text) to generate summaries or identify optimization opportunities.
The sequence diagram illustrates how the AI interacts with financial data and storage to provide user insights.
Sources: GEMINI.md:280-285, apps/web/src/app/[locale]/(marketing)/products/finance/page.tsx:143-155
Data Models and Storage
The system utilizes specialized RPCs and tables within Supabase to manage financial state.
Key Database Elements
get_category_breakdown: An RPC that accepts_wallet_ids UUID[]for wallet scoping and provides breakdown data.- Wallet Tracking: Supports multiple wallets within a workspace for granular budgeting.
- Redacted Amounts: For estimated amounts or sensitive data, the system uses a
hasRedactedAmountsflag and an≈prefix in the UI.
Sources: GEMINI.md:280-283, apps/web/src/app/[locale]/(marketing)/products/finance/page.tsx:158-163
Financial Management in the Tuturuuu platform serves as a critical bridge between administrative workforce management and automated financial operations. By integrating payroll, expense tracking, and AI-driven planning into a single workspace context, it aims to eliminate the friction typically associated with separate financial tools.