Bharat ERP — AMS Phase 1

Production-ready Asset Management System for Web, Android, and iOS — the foundation for Bharat ERP.

Phase 1 Modules

• Authentication — Login, logout, OTP, JWT sessions
• Company Management — Multi-company support
• Branch Management — Branch hierarchy per company
• User Management — Employee accounts and roles
• Role & Permissions — RBAC with dynamic menu
• Dashboard — KPIs and charts
• Assets — Categories, master, allocation, maintenance, disposal, QR
• Reports — Asset register, allocation, maintenance, warranty, disposal
• Settings — Theme, branding, preferences

Tech Stack

Flutter · Riverpod · GoRouter · Dio · Freezed · Material 3 · Responsive Framework

Getting Started

Prerequisites

• Flutter SDK 3.9+
• Dart 3.9+

Setup

# Clone and enter project
cd Bharat_ERP

# Environment files are already included:
# .env.development / .env.uat / .env.production

# Install dependencies
flutter pub get

# Generate Freezed/JSON models
dart run build_runner build --delete-conflicting-outputs

# Run with Development
flutter run -d chrome --dart-define=ENV=development

# Run with UAT
flutter run --dart-define=ENV=uat

# Run with Production
flutter run --dart-define=ENV=production

# Release builds
flutter build apk --release --dart-define=ENV=production
flutter build ios --release --dart-define=ENV=production
flutter build web --release --dart-define=ENV=production

Project Structure

See docs/ARCHITECTURE.md for full architecture documentation.

lib/
├── core/           # Constants, network, theme, errors, utils
├── shared/         # Routes, widgets, global providers, shared models
└── modules/        # Feature modules (auth, company, assets, ...)

Roles

Role	Description
Super Admin	Full access across all companies
Company Admin	Full access within assigned company
Asset Manager	Asset operations within company
Employee	View assets and own allocations

License

Proprietary — Bharat ERP