Chicken Poultry app to simplify daily business operations for entrepreneurs and customers in Tanzania
# Kokorikoo — Poultry Business Mobile App
Android app (Java, XML layouts) built for the BCS_3 Individual Project Assignment (IFM).
## What's included
All 20 required screens are implemented and functional:
| Requirement | Activity |
|---|---|
| Splash | `SplashActivity` |
| Login (checks database + internet) | `LoginActivity` |
| Dashboard | `DashboardActivity` |
| Sign up | `SignUpActivity` |
| Reset password | `ResetPasswordActivity` |
| User feedback | `UserFeedbackActivity` |
| Settings | `SettingsActivity` |
| Account | `AccountActivity` |
| Privacy policy | `PrivacyPolicyActivity` |
| Complaints | `ComplainsActivity` |
| Help | `HelpActivity` |
| Contact | `ContactActivity` |
| Main | `MainActivity` (hosts Navigation Drawer + Bottom Navigation) |
| Report / Receipt | `ReportActivity`, `ReceiptActivity` |
| **Content screens (7+)** | `ProductListActivity`, `AddProductActivity`, `OrderActivity`, `OrderHistoryActivity`, `CustomerListActivity`, `StockManagementActivity`, plus Report/Receipt above |
**Built-in communication features used:**
- Notifications — `NotificationHelper` (low-stock alerts, order placed)
- SMS — `SmsHelper` (order confirmation texts to customers)
- Phone calls — `ContactActivity` (tap to dial)
- Network connection check — `NetworkUtils` (used before login)
- Bluetooth — `BluetoothHelper` (pairing a receipt printer in Stock Management / Receipt screens)
**Database:**
- SQLite — `DatabaseHelper` (local storage: users, products, customers, orders)
- Cloud database — Firebase Authentication + Realtime Database (`FirebaseSync`)
## Setup instructions (Android Studio)
1. Open Android Studio → **Open** → select this `Kokorikoo` folder.
2. Let Gradle sync (it will download dependencies automatically — needs internet).
3. **Set up Firebase (required for cloud login/sync to work):**
- Go to
console.firebase.google.com and create a new project.
- Add an Android app with package name: `com.ifm.kokorikoo`
- Download the generated `google-s …