📋 System Overview

This is a comprehensive utility bill management system designed specifically for properties in Cebu, Philippines. It automates bill generation, tracks payments, and maintains detailed consumption records for both electricity and water utilities.

The system features automated billing on the 13th of each month (or estimate bills if readings aren't provided). Bills are due 5 days after the bill date (18th), and the system tracks payment status for each tenant.

💵 Rates & Charges

⚙️ Key Features

Bill Date Logic: The system generates bills on the 13th of every month. Tenants can generate bills with actual readings on this date. If readings aren't provided by the 13th, the system automatically generates estimate bills.

Meter Management: Each tenant has separate electricity and water meters. The system automatically tracks reading history. When you enter a reading for a meter, it remembers it for the next bill cycle (previous reading is auto-filled).

Shared Meters: Multiple tenants can share the same meter - the system handles this transparently. Each tenant's reading history is separate.

Payment Tracking: All bills are marked as unpaid when generated. You can manually mark them as paid, and the dashboard shows your payment status.

Estimate Bills: If readings aren't provided by the 13th, both electricity and water bills are generated with estimates. These are clearly marked as "ESTIMATE" on the bill.

Usage Graphs: Both versions include professional charts showing consumption trends over time for each tenant.

🚀 Quick Start

Step 1: Setup (2 minutes)

Open either the web or mobile version, go to Settings, and enter your company information (name, address, phone). Optionally upload your company logo.

Step 2: Add Tenants (1 minute per tenant)

Go to Tenants tab and add each tenant with their name, apartment unit, address, phone, and meter numbers. Meter numbers are required unless it's the tenant's first bill.

Step 3: Generate Bills (Only on 13th)

On the 13th of each month, go to the Bills tab. The generate button becomes active only on this date. Select a tenant and bill type. If it's their first bill, enter the starting meter reading. If not, it auto-fills. Enter the current reading (or leave blank for estimate) and generate the bill.

Step 4: Export & Track

View bills in the History tab. Mark them as paid when payment is received. Export to PDF if needed. The Dashboard shows your monthly summary with payment status and usage graphs.

📊 What You'll See

Bill Information: Every bill displays tenant name, apartment unit, address, phone number, meter number, bill number, current and previous meter readings, usage amount, detailed charges breakdown, and usage graphs showing consumption trends.

Dashboard: Statistics cards show total bills, paid count, unpaid count, and revenue for the current month. Tenant cards display individual balances and payment status. Professional charts visualize usage patterns across all tenants.

Payment Tracking: Easily see which bills are paid vs unpaid. The system automatically calculates due date (5 days after bill date) and alerts for overdue payments.

📱 Which Version Should I Use?

Use Web Version (app.html) if: You have a computer/laptop/tablet. You want full analytics and comprehensive graphs. You need to perform bulk operations. You want to export bills to PDF easily. You need the complete dashboard with all features.

Use Mobile Version (mobile.html) if: You only have a smartphone. You need a lightweight app. You want a touch-optimized interface. You're on-the-go and need quick bill generation. You prefer a simplified, mobile-first experience.

Pro Tip: You can use both! The web and mobile versions share the same data (stored in browser's local storage). Switch between them freely - your data syncs automatically.

💡 Tips & Best Practices

• Remember the 13th: Mark your calendar for the 13th to generate bills - the system only allows bill generation on this date
• Consistent readings: Take meter readings on the 13th each month for accuracy and consistency
• First bills: For tenant's first bill, you'll enter the starting meter reading. After that, it auto-fills from history
• Shared meters: If multiple apartments share a meter, use the same meter number for all of them. The system tracks readings per meter
• Estimate bills: If readings aren't available by the 13th, the system auto-generates estimates marked clearly as "ESTIMATE"
• Due date: Bills are due on the 18th (5 days after 13th) - follow up if not paid by then
• Monthly review: Check Dashboard monthly to track revenue and unpaid amounts
• Company branding: Upload your logo in Settings - it appears on all bills for professional appearance

🔒 Data Storage & Privacy

All data is stored locally in your browser using "Local Storage". This means:

• ✓ No server or internet required after first load
• ✓ Your data never leaves your device
• ✓ Complete privacy - no cloud storage
• ✓ Data persists even after closing the browser
• ✓ Works offline on any device
• ⚠️ Clearing browser data will delete everything - be careful with Clear Data button
• ⚠️ Data doesn't automatically sync across different devices