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

Environment config

Each environment has its own entry point in lib/config/ that sets Environment.flavor.
API URL and .env file are picked automatically (see lib/core/config/environment.dart).

Flavor	Entry point	API URL (auto)	Web base-href
dev	`lib/config/main_dev.dart`	`https://demo.venbait.in/api/v1`	`/`
uat	`lib/config/main_uat.dart`	`https://uat-api.bharaterp.com/api/v1`	`/`
prod	`lib/config/main_prod.dart`	`https://api.bharaterp.com/api/v1`	`/`

Dev web uses path URLs (no index.html#). Build with --base-href / and deploy web/.htaccess for Apache/LiteSpeed SPA fallback.

Web builds

# Dev
flutter build web -t lib/config/main_dev.dart --release --base-href /

# UAT
flutter build web -t lib/config/main_uat.dart --release --base-href /

# Prod
flutter build web -t lib/config/main_prod.dart --release --base-href /

Android APK / AAB

flutter build apk --flavor dev -t lib/config/main_dev.dart --release
flutter build apk --flavor uat -t lib/config/main_uat.dart --release
flutter build apk --flavor prod -t lib/config/main_prod.dart --release

flutter build appbundle --flavor prod -t lib/config/main_prod.dart --release

iOS

flutter build ios -t lib/config/main_prod.dart --release

Local dev run

flutter run -d chrome -t lib/config/main_dev.dart --web-port=8080
flutter run --flavor dev -t lib/config/main_dev.dart

Output (web): build/web/

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

3.3 KiB Raw Permalink Blame History