Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💳 Bill Payment System (Android App)

🎓 University Project | Test Version 0.1

Android Java SQLite License


🌐 Choose Language / انتخاب زبان

English | فارسی


🇺🇸 English Version

📝 About the Project

This is a University Project designed as a proof-of-concept for a bill management system. It serves as the First Version (v0.1) and is intended for testing purposes. The app allows users to view their bills (Electricity, Water, Gas, etc.), simulate payments, and track their history.

[!IMPORTANT] This is an educational project. Real payment gateways are NOT implemented; instead, a simulated "Fake Payment" interface is used.

🚀 Key Features

  • 🔐 Dual Login: Sign in using Phone Number or Email.
  • 📊 Bill Dashboard: View all unpaid bills with details.
  • 💳 Payment Simulator: A mock bank gateway for testing transactions.
  • 📜 History: Full log of successful and failed payments.
  • 👤 Profile Stats: Summary of total paid amounts and bill counts.

🔑 Test Access (Credentials)

Since this is a closed test version, access is limited to pre-seeded users in the database:

Type Examples
Allowed Phones 09100000001 to 09100000020
Allowed Emails user1@gmail.com to user20@gmail.com
Blocked Access 09900000001, blocked1@gmail.com

📸 Screenshots

Login Page Home Screen Pay Bills Payment History Profile
login home pay history profile

🛠 Installation

  1. Clone the repository:
    git clone https://github.com/RandomCommitSpace/BillPayment.git
  2. Open the project in Android Studio.
  3. Sync Gradle and run on an Emulator or Physical Device (API 24+).

📦 Download Release APK

You can download and test the pre-compiled Android package directly from the Releases page:

👉 Download Latest APK


🇮🇷 نسخه فارسی

📝 درباره پروژه

این یک پروژه دانشگاهی است که به عنوان نمونه اولیه برای سیستم مدیریت و پرداخت قبوض طراحی شده است. این برنامه در نسخه اول (v0.1) خود قرار دارد و صرفاً جهت تست و ارائه کلاسی تهیه شده است. کاربران می‌توانند قبوض خود (برق، آب، گاز و غیره) را مشاهده کرده، پرداخت را شبیه‌سازی کنند و تاریخچه تراکنش‌ها را ببینند.

[!IMPORTANT] این یک پروژه آموزشی است. درگاه‌های پرداخت واقعی متصل نیستند؛ در عوض از یک رابط کاربری شبیه‌سازی شده برای "پرداخت فرضی" استفاده شده است.

🚀 قابلیت‌های کلیدی

  • 🔐 ورود دوگانه: ورود با استفاده از شماره تلفن یا ایمیل.
  • 📊 داشبورد قبوض: مشاهده لیست تمام قبوض پرداخت نشده با جزئیات.
  • 💳 شبیه‌ساز پرداخت: درگاه بانکی فرضی برای تست تراکنش‌ها.
  • 📜 تاریخچه: ثبت کامل تراکنش‌های موفق و ناموفق.
  • 👤 آمار پروفایل: خلاصه مبالغ پرداخت شده و تعداد کل قبوض.

🔑 دسترسی تستی (نام کاربری)

با توجه به اینکه این نسخه تست محدود است، دسترسی فقط برای کاربران از پیش تعریف شده در دیتابیس امکان‌پذیر است:

نوع نمونه‌ها
شماره‌های مجاز 09100000001 تا 09100000020
ایمیل‌های مجاز user1@gmail.com تا user20@gmail.com
دسترسی مسدود 09900000001, blocked1@gmail.com

📸 اسکرین‌شات‌ها

صفحه ورود صفحه اصلی پرداخت قبض تاریخچه پرداخت ها پروفایل
login home pay history profile

🛠 نصب و اجرا

۱. مخزن را کلون کنید:

git clone https://github.com/RandomCommitSpace/BillPayment.git

۲. پروژه را در Android Studio باز کنید. ۳. گرادل را سینک کرده و روی شبیه‌ساز یا دستگاه واقعی (API 24+) اجرا کنید.

📦 دانلود اپلیکیشن

شما میتوانید آخرین نسخه این برنامه را از لینک زیر دریافت کنید: 👈 دانلود آخرین ورژن


📞 Contact / تماس

Developer / توسعه‌دهنده: Ainaz Taheir
Email / ایمیل: RandomCommitSpace@gmail.com


Developed with ❤️ for Academic Purposes

About

An Android application for tracking utility bills and managing payment history with offline SQLite storage, custom adapters, and clean animated UI components.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages