🚗 GR Installment Manager

From Paper Piles to Digital Power - Because every small business deserves a tech upgrade!

👋 About This Project

Hey there! I'm a hobbyist developer who built this for my dad. He used to manage his small retail business with stacks of paper, handwritten ledgers, and what seemed like an endless supply of coffee to stay organized. As his tech-savvy son, I decided to modernize his workflow and give him the digital tools he deserves.

This isn't just another business management app - it's a labor of love designed specifically for small businesses that want to ditch the paperwork and embrace the future. Whether you're tracking customer payments, managing inventory, or just trying to remember who still owes you for their purchases, this app has got your back!

✨ Features That Make Life Easier

🧑‍🤝‍🧑 Customer Management

• Smart Registration: Register customers with NIC numbers and contact details
• Profile Management: Keep track of customer information, payment history, and preferences
• Customer Search: Find customers quickly with our powerful search and filter system
• Payment Tracking: See exactly who owes what and when payments are due

🛒 Sales & Inventory

• Product Catalog: Manage your inventory with detailed product information
• Sales Recording: Record sales transactions with automatic inventory updates
• Stock Monitoring: Never run out of stock again with real-time inventory alerts
• Sales History: Complete transaction history with detailed breakdowns

💰 Payment Management

• Installment Tracking: Handle flexible payment plans with ease
• Payment Recording: Record daily payments and track outstanding balances
• Payment History: Detailed payment records for every customer
• Overdue Alerts: Stay on top of payments that need attention

📊 Dashboard & Analytics

• Business Overview: See your business performance at a glance
• Sales Charts: Visual representations of your sales trends
• Payment Analytics: Understand payment patterns and collection rates
• Revenue Tracking: Monitor profits and identify growth opportunities

📄 Professional Reports

• Customer Statements: Generate beautiful PDF reports for each customer
• Payment Summaries: Comprehensive payment history reports
• Business Reports: Detailed business performance analytics
• Export Capabilities: Download reports in PDF format for record-keeping

🔐 Security & Access

• Role-Based Access: Different permission levels for owners and staff
• Secure Authentication: Safe login system with Supabase Auth
• Data Protection: Your business data is encrypted and secure
• Audit Trails: Track all changes and activities in the system

🛠️ Tech Stack

This app is built with modern, reliable technologies:

• Frontend: Next.js 14 with React 18 and TypeScript
• Styling: Tailwind CSS for beautiful, responsive design
• Backend: Supabase (PostgreSQL database + Auth + Real-time)
• PDF Generation: jsPDF with auto-table for professional reports
• Icons: Lucide React for consistent, beautiful icons
• Deployment: Vercel for fast, reliable hosting

🚀 Quick Start

Getting started is easier than you think! Here's how:

Prerequisites

• Node.js 18 or higher
• A Supabase account (free tier works great!)

Installation

1. Clone the repository

   git clone https://github.com/sh13y/GR-Installment-Manager.git
   cd gr-installment-manager

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env.local

   Then fill in your Supabase credentials.

4. Set up the database

   npm run setup

5. Start the development server

   npm run dev

6. Open your browser Visit http://localhost:3000 and start managing your business!

🎯 Who Is This For?

• Small Business Owners: Like my dad, who want to modernize their operations
• Installment-Based Businesses: Perfect for businesses offering payment plans
• Paper-to-Digital Migrants: Businesses ready to leave paper behind
• Family-Owned Businesses: Built with love for family entrepreneurs

🤝 Contributing

Found a bug? Have a feature idea? We'd love to hear from you! This project was built with the community in mind. Feel free to:

• Open an issue for bugs or feature requests
• Submit pull requests for improvements
• Share your feedback and suggestions

📞 Support

Need help? Having trouble? Don't worry - we're here to help!

• Documentation: Check out our /docs folder for detailed guides
• Issues: Open a GitHub issue for technical problems
• Discussions: Start a discussion for general questions

🙏 Acknowledgments

A special thank you to:

• My Dad: For inspiring this project and being the best small business owner I know
• The Open Source Community: For the amazing tools that made this possible
• Supabase: For the incredible backend-as-a-service platform
• Vercel: For making deployment as easy as pie

📄 License

This project is built with love and shared freely. Feel free to use it, modify it, and share it with others who might benefit from it.

---

Built with ❤️ by a hobbyist developer for his dad, because every business deserves great software!

Remember: In the world of business software, it's not about having the fanciest features - it's about solving real problems for real people. And sometimes, those real people are family. 😉