Skip to content

MatrixRex/Mahar-Calculator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

মহর ক্যালকুলেটর (Mahar Calculator)

🇺🇸 English

মহরে ফাতেমি এবং সর্বনিম্ন মহর-এর পরিমাণ বাংলাদেশি টাকায় (BDT) গণনা করার জন্য একটি রিয়েল-টাইম ওয়েব অ্যাপ্লিকেশন।


🚀 লাইভ ডেমো

👉 আজকের মহরের পরিমাণ দেখুন


**📖 এই প্রজেক্টটি কেন? **

বিয়ের সময় মহর নির্ধারণ একটি গুরুত্বপূর্ণ ধর্মীয় দায়িত্ব। কিন্তু রূপার দাম প্রতিদিন বদলায়—তাই সঠিক হিসাব অনেক সময় বিভ্রান্তিকর হয়ে ওঠে।

এই টুলটি বিশেষভাবে তৈরি করা হয়েছে মহরে ফাতেমি নিয়ে সচেতনতা বাড়ানো এবং পরিবারের সিদ্ধান্ত গ্রহণকে সহজ করার জন্য। এটি সেই ঝামেলাটা একদম সহজ করে দেয়। আপনি এক ক্লিকেই জানতে পারবেন:

  • আজকের মহরে ফাতেমি কত টাকা
  • সর্বনিম্ন বৈধ মহর কত টাকা

সব হিসাবই হয় শরীয়ত সম্মত নিয়ম এবং প্রতিদিনের বাজারদরের উপর ভিত্তি করে।


🕌 মহর সম্পর্কে সংক্ষিপ্ত ধারণা

ইসলামি শরীয়ত অনুযায়ী বিবাহবন্ধনে আবদ্ধ হওয়ার জন্য বর কর্তৃক কনেকে যে বাধ্যতামূলক উপহার বা অর্থ প্রদান করতে হয়, তাকে মহর বলা হয়। মহর নির্ধারণের চারটি পদ্ধতি প্রচলিত:

১. সর্বনিম্ন মহর

শরীয়ত নির্ধারিত সর্বনিম্ন পরিমাণ, যার নিচে মহর নির্ধারণ করা যায় না।

  • পরিমাণ: ১০ দিরহাম
  • রূপার ওজন: প্রায় ৩০.৬১৮ গ্রাম (২.৬২৫ ভরি)

২️. মহরে ফাতেমি

রাসুলুল্লাহ (সাঃ) তাঁর কন্যা হযরত ফাতিমা (রাঃ) ও অন্যান্য পরিবারবর্গের জন্য যে পরিমাণ মহর নির্ধারণ করেছিলেন।

  • পরিমাণ: ৫০০ দিরহাম
  • রূপার ওজন: প্রায় ১৫৩০.৯ গ্রাম (১৩১.২৫ ভরি)

৩️. মহরে মিছিল

কনের বাবার পরিবারের সমসাময়িক নারীদের মহরের সাথে সামঞ্জস্য রেখে নির্ধারিত মহর।

৪️. মহরে মুসাম্মা

বর ও কনে পক্ষের পারস্পরিক সম্মতিতে নির্ধারিত মহর (তবে ১০ দিরহামের কম হতে পারবে না)।


**🎯 এই অ্যাপের মূল উদ্দেশ্য **

  • সাধারণ মানুষের জন্য বিশেষভাবে মহরে ফাতেমির সঠিক হিসাব সহজ করা
  • শরীয়তের নিয়ম ও বর্তমান রূপার বাজারমূল্য এক জায়গায় নিয়ে আসা
  • কোন রকম জটিল হিসাব ছাড়াই সেকেন্ডের মধ্যে নির্ভুল ফলাফল দেখানো

এই অ্যাপ ব্যবহারের জন্য আলাদা করে বাজারদর খোঁজা বা ক্যালকুলেটর নিয়ে বসার দরকার নেই—সব কিছু এখানেই অটোমেটিক!

🤍 এটি একটি কমিউনিটির জন্য তৈরি টুল—কোনো বাণিজ্যিক উদ্দেশ্য নেই, শুধুমাত্র সহজ, নির্ভুল ও শরীয়তসম্মত তথ্য পৌঁছে দেওয়াই লক্ষ্য।


🛠 ব্যবহৃত প্রযুক্তি (Tech Stack)

এই প্রজেক্টটি তৈরি করা হয়েছে দ্রুত এবং ঝামেলাহীনভাবে চালানোর জন্য—কোনো সার্ভার খরচ নেই!

  • Frontend: HTML5, Tailwind CSS, Vanilla JavaScript
  • Icons & Fonts: Phosphor Icons, Google Fonts (Tiro Bangla)
  • Automation & Hosting: GitHub Actions, GitHub Pages

⚙️ এটি যেভাবে কাজ করে (Behind the Scenes)

এই অ্যাপটি পুরোপুরি Serverless Automation ব্যবহার করে তৈরি—মানে আলাদা কোনো ব্যাকএন্ড সার্ভার নেই।

🔁 ধাপ ১: অটোমেটেড প্রাইস আপডেট (GitHub Actions)

প্রতিদিন রাত ১২:০০ টায় (বাংলাদেশ সময়) একটি অটোমেশন নিজে থেকেই কাজ করে:

  1. goldapi.io থেকে রূপার বর্তমান দাম (USD)
  2. open.er-api.com থেকে USD → BDT রেট
  3. এই দুইটা ডেটা দিয়ে আজকের রূপার দাম টাকায় হিসাব
  4. একটি নতুন price.json ফাইল তৈরি
  5. সেটি data ব্রাঞ্চে অটো-ডিপ্লয়

🌐 ধাপ ২: ওয়েবসাইটে ডেটা দেখানো

আপনি যখন সাইট ওপেন করবেন:

  • script.js সরাসরি data ব্রাঞ্চ থেকে price.json পড়বে

  • তারপর অটোমেটিক হিসাব করে দেখাবে:

    • মহরে ফাতেমি = প্রতি গ্রাম দাম × ১৫৩০.৯
    • সর্বনিম্ন মহর = প্রতি গ্রাম দাম × ৩০.৬১৮

কোনো রিফ্রেশ, রিলোড ঝামেলা ছাড়াই সব আপডেটেড!


✅ এই আর্কিটেকচারের সুবিধা

  • 💸 সম্পূর্ণ ফ্রি হোস্টিং
  • 🛡 API একদিন ডাউন হলেও আগের ডেটা সেফ থাকে
  • সুপার ফাস্ট লোডিং (শুধু ছোট একটা JSON ফাইল লোড হয়)
  • 🧠 কোনো ব্যাকএন্ড মেইনটেইন করতে হয় না

🔌 API ব্যবহার (Developers)

আপনি যদি আপনার নিজের অ্যাপে বা ওয়েবসাইটে মহরের রেট দেখাতে চান, তাহলে আমাদের ফ্রি API ব্যবহার করতে পারেন।

👉 API ডকুমেন্টেশন দেখুন (API.md)


📂 প্রজেক্ট স্ট্রাকচার

Mahar-Calculator/
├── .github/workflows/   # অটোমেশন স্ক্রিপ্ট (update_price.yml)
├── assets/              # ছবি এবং আইকন
├── css/                 # কাস্টম স্টাইল (style.css)
├── js/                  # অ্যাপ্লিকেশনের লজিক (script.js)
├── index.html           # মূল অ্যাপ্লিকেশন ফাইল
└── README.md            # প্রজেক্ট ডকুমেন্টেশন

🤝 অবদান (Contributing – Community First)

এই প্রজেক্টটি একটি কমিউনিটি টুল—আপনার আইডিয়া, সাজেশন, বাগ রিপোর্ট—সবকিছুই আন্তরিকভাবে স্বাগত!


📄 লাইসেন্স

এই প্রজেক্টটি ওপেন সোর্স এবং MIT License-এর আওতাভুক্ত।