Skip to content

jamunachi/budget-management-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Budget Management System

Overview

    A comprehensive budget management feature for ERPNext that provides monthly budget distribution and real-time budget tracking with configurable actions when limits are exceeded.

Features

๐Ÿš€ Budget Management System (BMS) โœจ Key Features

Automatic Monthly Allocation โ€“ Split annual budgets across months automatically.

Control Screen โ€“ Adjust (Increase/Decrease) any monthโ€™s budget. โ€“ Distribute monthly budgets with advanced filters (by Item, Cost Center, Expense Account).

Purchase Order Validation โ€“ Control overspending with Stop or Warning messages before submission when PO limits are exceeded.

Powerful Reporting โ€“ Export budget reports anytime to PDF or Excel for analysis and sharing.

Cascading Deletion (Sequential Delete) โ€“ Maintain clean data by ensuring related records are deleted in sequence.

Budget Control Log โ€“ Track every adjustment (increase/decrease) with a full audit trail for transparency.

๐ŸŽฏ Budget

Advanced budget control system with monthly distribution and automatic enforcement.

๐Ÿ“Š Monthly Budget Distribution

The system automatically distributes annual budgets across months with precise tracking:

Example Implementation:

  • Item: Office Equipment Purchase
  • Annual Budget: 12,000 EGP
  • Monthly Distribution: 8.33% per month (1,000 EGP/month)
January: 8.33% (1,000 EGP)
February: 8.33% (1,000 EGP)
...
December: 8.33% (1,000 EGP)

How It Works

Smart Budget Tracking

ERPNext budget management goes beyond annual limits by providing monthly distribution for more precise control. When a month's budget is exhausted, the system can:

  • โŒ Stop transactions completely
  • โš ๏ธ Warn users while allowing transactions

Configuration options:

  • Action Action if Monthly Budget Exceeded on PO = Stop
  • Action Action if Monthly Budget Exceeded on PO = Warn

Usage Examples

โœ… Approved Transaction

January Scenario:

  • Employee creates Purchase Order for 850 EGP
  • Result: โœ… Approved (under 1,000 EGP monthly limit)

โŒ Blocked/Warning Transaction

January Scenario:

  • Employee attempts Purchase Order for 1,200 EGP
  • Result: โŒ Blocked or โš ๏ธ Warning shown (exceeds 8.33% monthly allocation)

System Behavior

When attempting Purchase Orders exceeding the monthly limit (1,000 EGP in January), the system will:

  • Block the transaction if set to "Stop"
  • Show warning if set to "Warn"

Configuration

Budget Actions

Configure system behavior when monthly budgets are exceeded:

Action Description
Stop Completely prevent transactions exceeding monthly budget
Warn Show warning but allow transaction to proceed

Benefits

  • ๐Ÿ“ˆ Real-time Tracking: Monitor budget usage as it happens
  • ๐ŸŽฏ Monthly Precision: Distribute annual budgets across months
  • โšก Automatic Enforcement: Configurable actions when limits exceeded
  • ๐Ÿ‘ฅ User-Friendly: Clear feedback for employees and managers
  • ๐Ÿ”ง Flexible Configuration: Choose between strict enforcement or warnings

๐Ÿ”„ Main Stages:

1๏ธโƒฃ Budget Request

  • Submission by department managers

  • Specify details and justifications

  • Attach supporting documents

2๏ธโƒฃ Approval Workflow

  • Department Manager โ†’ Finance Manager โ†’ General Manager

  • Set clear approval and evaluation criteria

3๏ธโƒฃ Budget Creation

  • Prepare the base budget

  • Define control settings

  • Link accounts and cost centers

4๏ธโƒฃ Monthly Distribution

  • Equal allocation or as needed

  • Flexible seasonal distribution

  • Customizable settings

5๏ธโƒฃ Control & Monitoring

  • Real-time transaction validation

  • Apply stop/warning actions

  • Automatically update balances

6๏ธโƒฃ Reporting & Alerts

  • Instant dashboard

  • Email alerts

Scheduled periodic reports

๐ŸŽฏ Key Features: โœ… Full control from start to finish โœ… Flexible monthly allocation โœ… Complete transparency for all parties โœ… Smart alerts for proactive control โœ… Real-time monitoring and reporting

Budget Control & Monitoring - Detailed Scenarios

๐Ÿ“Š Current Budget Status (Example)

Department: Sales Department
Month: January 2024
Budget Items Status:
Office Equipment:
    Monthly Allocation: 1,000 EGP
    Spent to Date: 350 EGP
    Remaining: 650 EGP (65%)
    
Marketing Materials:
    Monthly Allocation: 667 EGP
    Spent to Date: 200 EGP
    Remaining: 467 EGP (70%)
    
Travel Expenses:
    Monthly Allocation: 1,250 EGP
    Spent to Date: 800 EGP
    Remaining: 450 EGP (36%)
Sales Department - Budget Control Panel
Date: January 25, 2024, 3:45 PM

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

๐ŸŽฏ Scenario 1: Normal Transaction (Within Budget)

Document Type: Material Request
Date: January 15, 2024
Employee: Ahmed Mohamed (Sales Executive)
Department: Sales Department
Cost Center: Sales - Head Office

Items Requested:
- Printer Cartridge: 150 EGP
- Office Supplies: 100 EGP
Total Amount: 250 EGP
Account: Office Equipment

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

User Experience: โœ… SUCCESS MESSAGE: "Material Request MR-2024-00123 approved successfully. Budget Status: Office Equipment - 60% utilized (400 EGP remaining)" โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

โš ๏ธ Scenario 2: Transaction Exceeding Monthly Budget (Warn Mode)

๐Ÿšซ Scenario 3: Transaction Blocked (Stop Mode)

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

๐Ÿ”” Scenario 4: Budget Threshold Alerts

Trigger: When monthly budget reaches 75%
Account: Marketing Materials
Budget: 667 EGP
Consumed: 500 EGP (75%)

Email Alert:
To: Sales Manager, Finance Manager
Subject: "Budget Alert: Marketing Materials 75% Consumed"

Message: "
Marketing Materials budget for January 2024 has reached 75% utilization.
Current Status: 500/667 EGP used (167 EGP remaining)
Please monitor spending for the remainder of the month.
"

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• System Budget Check Process:

Step 1 - Budget Validation:
Target Account: Office Equipment
Monthly Budget: 1,000 EGP
Already Consumed: 350 EGP
Available Balance: 650 EGP
Request Amount: 250 EGP

Step 2 - Validation Result:
Check: 250 โ‰ค 650 โœ…
Percentage Used: 60% (600/1000)
Status: APPROVED

Step 3 - System Action:
โœ… Allow Transaction
๐Ÿ“ Update Budget Balance
๐Ÿ“Š New Balance: 400 EGP remaining
๐Ÿ”” No alerts triggered    

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

๐Ÿ“ˆ Real-time Budget Dashboard

Sales Department - Budget Control Panel
Date: January 25, 2024, 3:45 PM
โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
MONTHLY BUDGET STATUS:

๐Ÿ”ด Office Equipment: [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–“โ–‘] 120% (OVER BUDGET)
Budget: 1,000 EGP | Spent: 1,200 EGP | Over: -200 EGP

๐ŸŸก Travel Expenses: [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘] 90% (CRITICAL)
Budget: 1,250 EGP | Spent: 1,125 EGP | Remaining: 125 EGP

๐ŸŸข Marketing Materials: [โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘] 60% (ON TRACK)
Budget: 667 EGP | Spent: 400 EGP | Remaining: 267 EGP

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
RECENT TRANSACTIONS:

โš ๏ธ 2:30 PM - PO-2024-00456 - Laptop (1,200 EGP) - WARNING ISSUED
โœ… 1:15 PM - MR-2024-00234 - Stationery (85 EGP) - APPROVED  
๐Ÿšซ 12:45 PM - PO-2024-00455 - Furniture (4,300 EGP) - BLOCKED

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
PENDING APPROVALS:

๐Ÿ“‹ Budget Override Request - Office Equipment (+2,000 EGP)
    Requested by: Fatima Hassan
    Status: Awaiting Finance Manager approval

โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

๐Ÿ”„ Override & Exception Process

Budget Override Workflow:

Scenario: Department needs to exceed monthly budget

Step 1 - Override Request:
User: Department Manager
Reason: "Urgent laptop replacement for key client presentation"
Amount: 1,200 EGP
Account: Office Equipment
Justification: "Client meeting tomorrow, laptop crashed"

Step 2 - Approval Chain:
Level 1: Department Head โœ…
Level 2: Finance Manager (Pending...)
Level 3: General Manager (if > 5,000 EGP)

Step 3 - If Approved:
๐Ÿ”“ Temporary budget increase
๐Ÿ“ Updated monthly allocation
โœ… Allow specific transaction
๐Ÿ“Š Log exception in reports

๐Ÿš€ ู„ุญุธุฉ... ู‡ุฐุง ุงู„ุชุทุจูŠู‚ ุณูŠุบูŠุฑ ุทุฑูŠู‚ุฉ ุฅุฏุงุฑุชูƒ ู„ู„ู…ูŠุฒุงู†ูŠุฉ!

ุฃุฎูŠุฑู‹ุง! ุฃุนู„ู† ุนู† ุฅุทู„ุงู‚ Budget Control Center ๐Ÿ“ˆ - ุงู„ุชุทุจูŠู‚ ุงู„ุฐูŠ ุทุงู„ ุงู†ุชุธุงุฑู‡ ู„ุฅุฏุงุฑุฉ ุงู„ู…ูŠุฒุงู†ูŠุงุช ุงู„ุฐูƒูŠุฉ!

โœจ ู„ู…ุงุฐุง ุณุชุญุจ ู‡ุฐุง ุงู„ุชุทุจูŠู‚ุŸ

๐ŸŽฏ ุฑุคูŠุฉ ุดุงู…ู„ุฉ ููŠ ุซูˆุงู†ู - ุงุนุฑู ุฑุตูŠุฏูƒ ุงู„ู…ุชุจู‚ูŠ ูˆุฅุฌู…ุงู„ูŠ ุงู„ู…ุตุฑูˆูุงุช ุจู†ุธุฑุฉ ูˆุงุญุฏุฉ

๐Ÿ“Š ู…ุคุดุฑุงุช ุฐูƒูŠุฉ ู…ู„ูˆู†ุฉ - ุฃุญู…ุฑ ู„ู„ุฎุทุฑุŒ ุฃุฎุถุฑ ู„ู„ุฃู…ุงู†ุŒ ุจุฑุชู‚ุงู„ูŠ ู„ู„ุชุญุฐูŠุฑ

๐Ÿ” ุชุตููŠุฉ ู…ุชู‚ุฏู…ุฉ - ุญุณุจ ุงู„ุจู†ูˆุฏุŒ ุงู„ุญุณุงุจุงุชุŒ ูˆุงู„ุฃุดู‡ุฑ... ูƒู„ ู…ุง ุชุญุชุงุฌู‡ ููŠ ู…ูƒุงู† ูˆุงุญุฏ

โšก ุชุญุฏูŠุซ ููˆุฑูŠ - ุจูŠุงู†ุงุช ุญูŠุฉ ูˆุฏู‚ูŠู‚ุฉ ุจุฏูˆู† ุงู†ุชุธุงุฑ

๐ŸŽจ ูˆุงุฌู‡ุฉ ุฌุฐุงุจุฉ - ุชุตู…ูŠู… ุนุตุฑูŠ ูŠุฌุนู„ ู…ุฑุงู‚ุจุฉ ุงู„ู…ูŠุฒุงู†ูŠุฉ ู…ุชุนุฉ ุญู‚ูŠู‚ูŠุฉ


๐Ÿ›ก๏ธ Budget Validation ุนู„ู‰ Purchase Orders:

ุชุญูƒู… ุชู„ู‚ุงุฆูŠ ุนู†ุฏ ุฅู†ุดุงุก PO ุฌุฏูŠุฏ
ูุญุต ุงู„ู…ูŠุฒุงู†ูŠุฉ ู‚ุจู„ ุงู„ู…ูˆุงูู‚ุฉ ุนู„ู‰ ุงู„ุทู„ุจ

โš ๏ธ ู†ุธุงู… ุงู„ุชุญุฐูŠุฑุงุช ุงู„ุฐูƒูŠ: ๐Ÿ”ด STOP Mode (ุฅูŠู‚ุงู ุชุงู…):

ู…ู†ุน ุฅู†ุดุงุก PO ุฅุฐุง ุชุฌุงูˆุฒ ุงู„ู…ูŠุฒุงู†ูŠุฉ
ุฑุณุงู„ุฉ ุฎุทุฃ ูˆุงุถุญุฉ ุชูˆุถุญ ุณุจุจ ุงู„ุฑูุถ
ุญู…ุงูŠุฉ ูƒุงู…ู„ุฉ ู…ู† ุชุฌุงูˆุฒ ุงู„ุญุฏ ุงู„ู…ุณู…ูˆุญ

๐ŸŸก WARN Mode (ุชุญุฐูŠุฑ ู…ุน ุงู„ุณู…ุงุญ):

ุชุญุฐูŠุฑ ุฃุตูุฑ ูŠุธู‡ุฑ ู„ู„ู…ุณุชุฎุฏู…
ุฅู…ูƒุงู†ูŠุฉ ุงู„ู…ุชุงุจุนุฉ ุจุนุฏ ุงู„ุชุฃูƒูŠุฏ
ุชุณุฌูŠู„ ุงู„ุชุญุฐูŠุฑ ููŠ ุงู„ุณุฌู„ุงุช

โœ… IGNORE Mode (ุชุฌุงู‡ู„ ุงู„ุชุญูƒู…):

ู„ุง ุชูˆุฌุฏ ู‚ูŠูˆุฏ ุนู„ู‰ ุงู„ู…ุจุงู„ุบ
ู…ุฑูˆู†ุฉ ูƒุงู…ู„ุฉ ู„ู„ุญุงู„ุงุช ุงู„ุงุณุชุซู†ุงุฆูŠุฉ

๐Ÿ“Š ู…ุคุดุฑุงุช ุจุตุฑูŠุฉ ููˆุฑูŠุฉ:

ุดุฑูŠุท ู…ู„ูˆู† ูŠูˆุถุญ ู†ุณุจุฉ ุงู„ุงุณุชู‡ู„ุงูƒ
ุฑุตูŠุฏ ู…ุชุจู‚ูŠ ูŠุธู‡ุฑ ู…ุจุงุดุฑุฉ ููŠ PO
ุชุญุฏูŠุซ ููˆุฑูŠ ู„ุญุงู„ุฉ ุงู„ู…ูŠุฒุงู†ูŠุฉ

๐ŸŽฏ ููˆุงุฆุฏ ู‡ุฐู‡ ุงู„ุฎูˆุงุต:

โšก ู…ู†ุน ุงู„ุฃุฎุทุงุก ู‚ุจู„ ุญุฏูˆุซู‡ุง
๐Ÿ’ฐ ุชุญูƒู… ุฃูุถู„ ููŠ ุงู„ู…ุตุฑูˆูุงุช
๐Ÿ‘ฅ ุดูุงููŠุฉ ูƒุงู…ู„ุฉ ู„ู„ูุฑูŠู‚ ุงู„ู…ุงู„ูŠ
๐Ÿ“ˆ ู‚ุฑุงุฑุงุช ู…ุฏุฑูˆุณุฉ ุนู†ุฏ ุงู„ุดุฑุงุก

๐Ÿ’ก ุงู„ู…ุดูƒู„ุฉ ุงู„ุชูŠ ุญู„ู‡ุง ุงู„ุชุทุจูŠู‚:

โŒ ู‚ุจู„: ุณุงุนุงุช ู…ู† ุงู„ุจุญุซ ููŠ ุชู‚ุงุฑูŠุฑ ู…ุนู‚ุฏุฉ
โŒ ู‚ุจู„: ุนุฏู… ูˆุถูˆุญ ุงู„ุฑุตูŠุฏ ุงู„ู…ุชุจู‚ูŠ
โŒ ู‚ุจู„: ุตุนูˆุจุฉ ู…ุชุงุจุนุฉ ุงู„ู…ุตุฑูˆูุงุช ุงู„ุดู‡ุฑูŠุฉ

โœ… ุงู„ุขู†: ูƒู„ ุดูŠุก ูˆุงุถุญ ููŠ ุดุงุดุฉ ูˆุงุญุฏุฉ!
โœ… ุงู„ุขู†: ุชุญูƒู… ูƒุงู…ู„ ูˆุฑุคูŠุฉ ุดุงู…ู„ุฉ!
โœ… ุงู„ุขู†: ู‚ุฑุงุฑุงุช ู…ุงู„ูŠุฉ ุฃุฐูƒู‰ ูˆุฃุณุฑุน!


๐ŸŽ‰ ุงู„ู†ุชูŠุฌุฉุŸ

๐Ÿ“ˆ ุชูˆููŠุฑ 80% ู…ู† ูˆู‚ุช ู…ุฑุงุฌุนุฉ ุงู„ู…ูŠุฒุงู†ูŠุงุช
๐Ÿ’ฐ ุชุญูƒู… ุฃูุถู„ ููŠ ุงู„ู…ุตุฑูˆูุงุช
๐ŸŽฏ ู‚ุฑุงุฑุงุช ู…ุงู„ูŠุฉ ุฃูƒุซุฑ ุฏู‚ุฉ
๐Ÿ˜Š ุฑุงุญุฉ ุจุงู„ ูƒุงู…ู„ุฉ ู„ูุฑูŠู‚ ุงู„ุฅุฏุงุฑุฉ ุงู„ู…ุงู„ูŠุฉ


ู‡ู„ ุชุนุงู†ูŠ ู…ู† ุชุนู‚ูŠุฏุงุช ุฅุฏุงุฑุฉ ุงู„ู…ูŠุฒุงู†ูŠุฉ ููŠ ู…ุคุณุณุชูƒุŸ ๐Ÿค”

ุดุงุฑูƒู†ูŠ ุชุฌุฑุจุชูƒ ููŠ ุงู„ุชุนู„ูŠู‚ุงุช!

ูˆุฅุฐุง ุฃุนุฌุจูƒ ุงู„ู…ุดุฑูˆุนุŒ ู„ุง ุชู†ุณ ุงู„ู€ Like ูˆุงู„ู…ุดุงุฑูƒุฉ ๐Ÿ’ช


#ERPNext #FrappeFramework #BudgetManagement #FinancialControl #Innovation #TechSolution #DigitalTransformation #StartupLife #AppDevelopment #BusinessIntelligence


PS: ู‡ุฐุง ู…ุฌุฑุฏ ุงู„ุจุฏุงูŠุฉ... ุงู„ู…ุฒูŠุฏ ู…ู† ุงู„ุชุญุฏูŠุซุงุช ุงู„ู…ุซูŠุฑุฉ ู‚ุงุฏู…ุฉ! ๐Ÿ”ฅ

ุชุงุจุนู†ูŠ ู„ุชูƒูˆู† ุฃูˆู„ ู…ู† ูŠุนุฑู ุจุงู„ุฅุทู„ุงู‚ุงุช ุงู„ุฌุฏูŠุฏุฉ! ๐Ÿ‘ˆ

About

A comprehensive budget management feature for ERPNext that provides monthly budget distribution and real-time budget tracking with configurable actions when limits are exceeded.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors