💎 Smart Finance Bot

💰 Intelligent Personal Finance Management Telegram Bot

Professional Java Telegram Bot Powered by Spring Boot & PostgreSQL

Manage your income, expenses, financial reports, and personal budget directly inside Telegram with a modern, secure, and intelligent finance management system.

---

---

📖 Overview

Smart Finance Bot is a professional Telegram-based personal finance management system built with Java and Spring Boot.

The bot helps users efficiently manage daily income and expenses, generate financial reports, analyze spending habits, and improve budgeting through an intuitive Telegram interface.

Unlike traditional expense trackers, Smart Finance Bot offers real-time analytics, categorized financial reports, intelligent session management, and a seamless user experience directly inside Telegram.

---

🎯 Project Goals

✅ Simplify personal finance management

✅ Track daily income and expenses

✅ Provide detailed financial analytics

✅ Improve budgeting habits

✅ Generate professional financial reports

✅ Deliver a fast and secure Telegram experience

---

✨ Main Features

---

💰 Income Management

Easily record all sources of income.

Features include:

• Salary tracking
• Freelance income
• Bonuses
• Investments
• Custom income categories
• Automatic balance updates

---

💸 Expense Tracking

Track every expense with category support.

Supported categories:

• Food
• Transport
• Shopping
• Bills
• Education
• Entertainment
• Healthcare
• Other

---

📊 Financial Reports

Generate powerful reports instantly.

Available reports:

• 📅 Daily Report
• 📆 Weekly Report
• 🗓 Monthly Report
• 📈 Income Analysis
• 📉 Expense Analysis
• 💵 Current Balance
• 💹 Net Profit
• 📊 Category Statistics

---

📈 Spending Analytics

Visual financial insights include:

• Largest expense category
• Largest income source
• Spending percentage
• Budget distribution
• Financial trends
• Income vs Expense comparison

---

🧠 Intelligent Financial Engine

Designed with scalable backend architecture.

Includes:

• Session Management
• User State Management
• Category Grouping
• Automatic Calculations
• Financial Summary Generation
• Smart Navigation

---

🤖 Professional Telegram Experience

Built using Telegram Bot API.

Features:

• Interactive Inline Keyboards
• Multi-step conversations
• Fast response time
• Clean user interface
• Easy navigation

---

🗄 Database Management

All data is securely stored inside PostgreSQL.

Tables:

Users

• User ID
• Chat ID
• First Name
• Last Name
• Registration Date

Transactions

• Transaction ID
• Amount
• Type
• Category
• Date
• User ID

---

🔐 Security

Security features include:

• Telegram Token via Environment Variables
• Secure PostgreSQL Storage
• Hidden Configuration Files
• .gitignore Protection
• Safe Session Handling

---

🏗 Architecture

Telegram User

↓

Telegram Bot API

↓

Controller Layer

↓

Service Layer

↓

Repository Layer

↓

Spring Data JPA

↓

Hibernate

↓

PostgreSQL Database

---

⚙ Technology Stack

Backend

• Java 25
• Spring Boot
• Spring Data JPA
• Hibernate
• Maven

Database

• PostgreSQL

Telegram

• Telegram Bots API

---

🚀 Installation

1 Clone Repository

git clone https://github.com/your-username/Smart-Finance-Bot.git

---

2 Configure PostgreSQL

CREATE DATABASE financebot;

---

3 Configure application.properties

spring.datasource.url=jdbc:postgresql://localhost:5432/financebot
spring.datasource.username=postgres
spring.datasource.password=your_password

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=false

---

4 Configure Telegram Token

Never upload your bot token to GitHub.

Windows

set TELEGRAM_TOKEN=your_token

Linux / macOS

export TELEGRAM_TOKEN=your_token

application.properties

telegram.bot.token=${TELEGRAM_TOKEN}

---

5 Run

mvn spring-boot:run

or

mvn clean package

java -jar target/financebot.jar

---

📷 Screenshots

Add screenshots here.

Example:

• Main Menu
• Add Income
• Add Expense
• Monthly Report
• Weekly Statistics
• Current Balance
• Category Analysis

---

📊 Project Statistics

Feature	Status
Income Tracking	✅
Expense Tracking	✅
Category Management	✅
Weekly Reports	✅
Monthly Reports	✅
Balance Calculation	✅
Session Management	✅
PostgreSQL Storage	✅
Telegram Bot	✅
Inline Keyboard UI	✅

---

📦 Deployment

Supported platforms:

• Railway
• Render
• Docker
• VPS
• AWS EC2
• DigitalOcean

---

🚀 Future Improvements

• 📱 Web Dashboard
• 📊 Interactive Charts
• 💱 Multi-Currency Support
• 📈 AI Spending Prediction
• 🔔 Automatic Monthly Reports
• 📤 Excel Export
• 📥 PDF Reports
• ☁ Cloud Backup
• 👥 Multi-user Analytics
• 🤖 AI Financial Advisor

---

👩‍💻 Developer

Dinora Sharipova

Software Engineering Student

Java Backend Developer

Spring Boot • PostgreSQL • REST APIs • Telegram Bots

Passionate about building scalable backend systems and intelligent software solutions.

---

⭐ Support

If you found this project useful,

⭐ Star this repository

🍴 Fork it

🤝 Contribute

💬 Share your feedback

Let's build smarter software together.