Chopwella

Chopwella is a comprehensive campus-based feeding solution tailored for students and managed by administrators. It enables students to purchase food conveniently from campus restaurants using a secure PIN-based ordering system. With rich administrative controls and cross-platform support, Chopwella streamlines the feeding process while ensuring accountability and security.

🔧 Features

🎓 Student-Facing App

• Browse and order food from campus restaurants.
• Secure order placement using a personal PIN.
• View and manage transaction history with load-more support.
• Profile dashboard with personal and balance information.
• QR code scanning for restaurant-specific ordering (requires camera permissions).
• Optimized for mobile kiosks and full-screen browser use (especially on iOS).

🛠 Admin Dashboard

• Create, audit, and manage user accounts.
• Credit user balances securely.
• Ban or restrict students with outstanding payments.
• View all transactions and total user spending.
• Change or reset user passwords and PINs.
• Edit transactions (secured by admin PIN).
• Reorder restaurant listings displayed on the app.
• Access real-time stats: total users, total restaurants, and more.
• Toggle maintenance mode to temporarily disable app access.
• Change global admin credentials (password & PIN).

📁 Project Structure

This is a monorepo with the following structure:

.
├── chopwella     # Main app and admin dashboard (PWA-compatible)
└── chopwella-app   # Kiosk/mobile-optimized version of the app (APK for Android)

🌐 Cross-Platform Support

• Responsive Design : Fully adaptive layouts for mobile, tablet, and desktop views.

• PWA Support : Progressive Web App features supported for both Android and iOS.

• Platform-Aware UX : Detects platform and adapts UI/UX accordingly. iOS receives optimized treatment due to kiosk availability on Android via APK.

🔐 Security

• PIN-based authentication for orders and sensitive operations.

• Admin actions secured with an additional layer of PIN verification.

• Role-based access control between students and feeding managers.

📷 Permissions

• Camera Access : Required for QR code scanning to identify restaurants when placing orders via the web or kiosk.

🚀 Deployment & Maintenance

• Designed to be kiosk-friendly and support fullscreen usage scenarios.

• Admins can disable the entire application system-wide for maintenance via the dashboard.

📦 Coming Soon / Future Work

• Real-time notifications for order updates.

• Enhanced analytics dashboard for feeding trends.

• Role-based granular permissions for multiple admin levels.

📜 License

This project is licensed under your preferred open-source license. (You can update this section with MIT, GPL, etc.)

🙌 Acknowledgements

Chopwella was built with students in mind, providing a secure, accessible, and efficient way to manage feeding operations on school campus.