🚀 HisaabPlus - Professional Business Management App

Complete Accounting & Business Management Solution for Pakistani Businesses

Version 4.0 | December 2024

📱 Overview

HisaabPlus is a comprehensive Flutter-based business management application specifically designed for Pakistani businesses. It provides complete invoice management, inventory control, customer relationship management, and financial reporting with specialized PKR currency formatting.

✨ Features

🔐 Security & Authentication

✅ Secure user authentication with SHA-256 password hashing
✅ Encrypted local storage using flutter_secure_storage
✅ Role-based access control (Owner, Manager, Accountant, Staff, Viewer)
✅ Session management and auto-logout

🧾 Invoice Management

✅ Professional invoice creation and editing
✅ Multiple invoice templates
✅ PDF generation with company branding
✅ WhatsApp and email sharing
✅ Payment tracking (Pending, Paid, Overdue)
✅ Automatic invoice numbering

👥 Customer & Vendor Management

✅ Complete customer database
✅ Vendor/supplier management
✅ Contact information storage
✅ Purchase history tracking
✅ Outstanding balance monitoring

📦 Inventory Management

✅ Product catalog with categories
✅ Stock level tracking
✅ Low stock alerts
✅ Barcode support
✅ Purchase and selling price management
✅ Stock movement history

💰 Financial Management

✅ Specialized PKR currency formatting (لاکھ، کروڑ)
✅ Credit/Debit account management
✅ Expense tracking and categorization
✅ Payment reminders
✅ Cash flow analysis

📊 Reports & Analytics

✅ Comprehensive business dashboard
✅ Sales and expense reports
✅ Profit & Loss statements
✅ Inventory reports
✅ Visual charts and graphs
✅ Export to PDF and Excel

☁️ Cloud Features

✅ Firebase real-time synchronization
✅ Multi-device access
✅ Automatic backup
✅ Offline mode with sync
✅ Data conflict resolution

🎨 User Experience

✅ Material Design 3 interface
✅ Dark/Light theme support
✅ Responsive design for tablets
✅ Intuitive navigation
✅ Professional animations

🛠️ Technical Stack

Technology	Version	Purpose
Flutter	3.16+	Cross-platform mobile framework
Dart	3.0+	Programming language
SQLite	Latest	Local database storage
Firebase	Latest	Cloud sync and authentication
Provider	6.1.2	State management
Material Design 3	Latest	UI/UX framework

📋 Requirements

Development Environment

Flutter SDK 3.16.0 or higher
Dart SDK 3.0.0 or higher
Android Studio or VS Code
Git for version control

Device Requirements

Android: API level 21+ (Android 5.0+)
iOS: iOS 12.0+ (coming soon)
Storage: Minimum 100MB free space
RAM: 2GB+ recommended

🚀 Installation & Setup

1. Clone Repository

git clone https://github.com/yourusername/hisabplusz1.git
cd hisabplusz1

2. Install Dependencies

flutter pub get

3. Environment Configuration

Create .env file in project root:

GOOGLE_API_KEY=your_google_api_key_here
FIREBASE_PROJECT_ID=your_firebase_project_id

4. Firebase Setup

Create Firebase project at console.firebase.google.com
Add Android app to Firebase project
Download google-services.json and place in android/app/
Enable Firestore Database and Authentication

5. Run Application

flutter run

🧪 Testing

Run Unit Tests

flutter test

Run Widget Tests

flutter test test/widgets/

Run Integration Tests

flutter test integration_test/

Generate Coverage Report

flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

📁 Project Structure

hisabplusz1/
├── android/                 # Android platform files
├── assets/                  # App assets (icons, images)
│   ├── icons/              # App icons
│   ├── images/             # Images and graphics
│   └── logos/              # Brand logos
├── docs/                   # Documentation
│   ├── USER_MANUAL.md      # User guide
│   └── API_DOCUMENTATION.md # Technical docs
├── integration_test/       # Integration tests
├── ios/                    # iOS platform files
├── lib/                    # Main application code
│   ├── config/            # Configuration files
│   ├── models/            # Data models
│   ├── providers/         # State management
│   ├── screens/           # UI screens
│   ├── services/          # Business logic
│   ├── utils/             # Utilities and helpers
│   └── web_dashboard/     # Web interface
├── test/                   # Unit and widget tests
└── web/                    # Web platform files

🔧 Configuration

Database Schema

The app uses SQLite for local storage with the following main tables:

parties - Customer and vendor information
products - Inventory items
invoices - Invoice headers
invoice_items - Invoice line items
expenses - Business expenses

Security Configuration

All sensitive data encrypted with flutter_secure_storage
Passwords hashed using SHA-256
API keys stored in environment variables
Role-based access control implemented

📚 Documentation

For Users

User Manual - Complete user guide
Feature Guide - Detailed feature explanations

For Developers

API Documentation - Technical reference
Testing Guide - Testing procedures
Architecture Overview - System design

🌟 Key Highlights

Pakistani Business Focus

PKR Currency: Specialized formatting with لاکھ and کروڑ support
Local Numbers: Pakistani phone number validation
Business Practices: Designed for local business workflows
Urdu Support: Ready for Urdu language integration

Professional Features

Multi-User System: Role-based access for teams
Cloud Sync: Real-time data synchronization
Offline Mode: Work without internet connection
Advanced Analytics: Business intelligence and insights
PDF Generation: Professional invoice and report PDFs

Enterprise Ready

Scalable Architecture: Handles growing business needs
Security First: Enterprise-grade data protection
Audit Trail: Complete change tracking
Backup & Restore: Data protection and recovery

🚀 Deployment

Google Play Store

Generate Release APK:
```
flutter build apk --release
```
Generate App Bundle:
```
flutter build appbundle --release
```
Configure Signing: Update android/app/build.gradle with signing config
Upload to Play Console: Submit to Google Play Store

Web Deployment

flutter build web --release

🤝 Contributing

Development Guidelines

Code Style: Follow Flutter/Dart conventions
Testing: Write tests for new features
Documentation: Update docs for changes
Security: Never commit sensitive data

Pull Request Process

Fork the repository
Create feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open Pull Request

🐛 Troubleshooting

Common Issues

Build Errors:

Run flutter clean && flutter pub get
Check Flutter/Dart SDK versions
Verify environment configuration

Firebase Issues:

Verify google-services.json placement
Check Firebase project configuration
Ensure Firestore rules are set

Sync Problems:

Check internet connection
Verify Firebase authentication
Use "Force Sync" in settings

📞 Support

Getting Help

Email: support@hisaabplus.com
Documentation: Check docs/ folder
Issues: Create GitHub issue for bugs
Discord: Join our developer community

Business Inquiries

Partnership: business@hisaabplus.com
Custom Development: custom@hisaabplus.com
Training: training@hisaabplus.com

📜 License

MIT License

Copyright (c) 2024 HisaabPlus Development Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILTY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🏆 Acknowledgments

Flutter Team - Amazing cross-platform framework
Firebase Team - Excellent cloud services
Pakistani Developer Community - Inspiration and feedback
Local Businesses - Real-world testing and requirements

🔗 Links

Website: www.hisaabplus.com
Play Store: Download HisaabPlus
Documentation: docs.hisaabplus.com
API Reference: api.hisaabplus.com

Made with ❤️ for Pakistani Businesses

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
android		android
assets		assets
docs		docs
integration_test		integration_test
ios		ios
test		test
web		web
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
ENHANCEMENT_PACKAGE.md		ENHANCEMENT_PACKAGE.md
LICENSE		LICENSE
README.md		README.md
analysis_options.yaml		analysis_options.yaml
firebase.json		firebase.json
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

License

MavCodeAI/HP4

Folders and files

Latest commit

History

Repository files navigation