https://github.com/maximbilan/morph
A Go-based service that transforms financial transactions into MoneyWiz deep links using AI analysis
https://github.com/maximbilan/morph
Last synced: 6 months ago
JSON representation
A Go-based service that transforms financial transactions into MoneyWiz deep links using AI analysis
- Host: GitHub
- URL: https://github.com/maximbilan/morph
- Owner: maximbilan
- Created: 2025-04-21T08:40:47.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-07-25T11:03:02.000Z (6 months ago)
- Last Synced: 2025-07-25T17:25:19.773Z (6 months ago)
- Language: Go
- Homepage:
- Size: 90.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Morph - Financial Transaction Management System
Morph is a serverless application built on Google Cloud Functions that helps manage and categorize financial transactions. The system integrates with Monobank for transaction monitoring and uses AI to automatically categorize expenses. The primary output of the system is deep links for the MoneyWiz app, allowing users to quickly add categorized expenses to their financial tracking.
## Architecture Overview
The application consists of four main Google Cloud Functions that work together to process and manage financial transactions:
### 1. `cashHandler`
- **Purpose**: Processes manual cash transactions entered by users via Telegram
- **Flow**:
1. Receives transaction details via HTTP request
2. Uses AI to categorize the transaction
3. Generates a MoneyWiz deep link for expense tracking
4. Schedules a message to be sent to the user with transaction details
### 2. `monoHandler`
- **Purpose**: Processes Monobank transactions
- **Flow**:
1. Receives transaction data from Monobank webhook
2. Uses AI to categorize the transaction
3. Generates a MoneyWiz deep link
4. Schedules a message to be sent to the user with transaction details
### 3. `monoWebHook`
- **Purpose**: Receives webhook notifications from Monobank
- **Flow**:
1. Validates incoming webhook requests
2. Extracts transaction details
3. Schedules the transaction for processing via Google Tasks
### 4. `sendMessage`
- **Purpose**: Sends messages to users via Telegram
- **Flow**:
1. Receives message details via HTTP request
2. Sends the message to the specified chat ID
3. Supports message replies through `ReplyToMessageID`
## Task Processing
The application uses Google Cloud Tasks for asynchronous processing:
- **Task Types**:
- `ScheduledMessage`: Contains chat ID, message text, and optional reply message ID
- `ScheduledTransaction`: Contains transaction details (MCC, category, description, amount)
- **Task Scheduling**:
- Messages and transactions are scheduled for immediate processing
- Uses Google Cloud Tasks API for reliable delivery
- Tasks are processed in the order they are received