{"id":23882637,"url":"https://github.com/edwinabdonshayo/jabudine","last_synced_at":"2026-04-18T11:03:28.455Z","repository":{"id":270766994,"uuid":"910942108","full_name":"EdwinAbdonShayo/JabuDine","owner":"EdwinAbdonShayo","description":"A mobile application designed for restaurant management, enabling customers to place orders, make table reservations, and streamline restaurant operations. Works of @Daemon403 \u0026 @EdwinAbdonShayo","archived":false,"fork":false,"pushed_at":"2025-01-10T21:27:46.000Z","size":289,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-10T22:24:07.063Z","etag":null,"topics":["flask","kivy","mobile","python","restaurant"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EdwinAbdonShayo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-01T21:21:13.000Z","updated_at":"2025-01-10T21:27:48.000Z","dependencies_parsed_at":"2025-01-03T00:24:37.139Z","dependency_job_id":"6d88dc78-9489-46b1-8fb6-c579a57682d6","html_url":"https://github.com/EdwinAbdonShayo/JabuDine","commit_stats":null,"previous_names":["edwinabdonshayo/jabudine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinAbdonShayo%2FJabuDine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinAbdonShayo%2FJabuDine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinAbdonShayo%2FJabuDine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinAbdonShayo%2FJabuDine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EdwinAbdonShayo","download_url":"https://codeload.github.com/EdwinAbdonShayo/JabuDine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240255631,"owners_count":19772659,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","kivy","mobile","python","restaurant"],"created_at":"2025-01-04T02:56:32.131Z","updated_at":"2026-04-18T11:03:23.401Z","avatar_url":"https://github.com/EdwinAbdonShayo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"***\n\n# JabuDine\n\nJabuDine is a mobile application designed for restaurant management, enabling customers to place orders, make table reservations, and streamline restaurant operations. The app offers a user-friendly interface and leverages modern technologies for a seamless dining experience.\n\n## Features\n- **Order Management**: Customers can browse menus and place orders directly from the app.\n- **Table Reservations**: Customers can book tables in advance based on availability.\n- **Notifications**: Real-time notifications for order status and reservation confirmations.\n- **Admin Panel**: Manage menu items, track reservations, and view analytics.\n- **User Authentication**: Secure login and registration system.\n\n---\n\n## Technologies Used\n\n### 1. **Frontend**\n   - **Kivy**: A Python-based framework for developing multi-platform mobile applications. Kivy is used for building the user interface, ensuring responsiveness and cross-platform compatibility.\n   - **KivyMD**: Extends Kivy with Material Design components for a modern and intuitive UI.\n\n### 2. **Backend**\n   - **Flask**: A lightweight Python web framework used to handle API requests and manage data flow.\n   - **SQLite (Subjected to Change)**: A lightweight database for storing user data, orders, reservations, and menu details.\n\n### 3. **APIs**\n   - RESTful APIs will be developed for communication between the frontend and backend. Key endpoints include:\n     - `POST /register` - User registration\n     - `POST /login` - User authentication\n     - `GET /menu` - Fetch menu items\n     - `POST /order` - Place an order\n     - `POST /reserve` - Make a table reservation\n     - `GET /reservations` - Fetch user reservations\n\n### 4. **Deployment**\n   - **Backend Hosting**: Flask will be deployed on a platform such as AWS or Heroku.\n   - **Database Hosting**: SQLite can be upgraded to PostgreSQL for production scalability and hosted on cloud services.\n   - **Mobile App Distribution**: The Kivy app will be compiled into APK (for Android) and IPA (for iOS) using `Buildozer` and `Xcode` respectively.\n\n---\n\n## Project Structure\n```\nJabuDine/\n├── backend/\n│   ├── app.py           # Main Flask application\n│   ├── models.py        # Database models\n│   ├── routes/          # API endpoints\n│   └── templates/       # HTML templates for admin panel (optional)\n│\n├── mobile_app/\n│   ├── main.py          # Kivy main application file\n│   ├── screens/         # Kivy screen files\n│   ├── assets/          # Images, fonts, and other resources\n│   ├── components/      # Custom widgets and Material Design components\n│   └── buildozer.spec   # Configuration for building APK/IPA\n│\n├── database/\n│   └── db.sqlite        # SQLite database\n│\n└── README.md            # Project documentation\n```\n\n---\n\n## Development Approach\n\n1. **Planning and Prototyping**\n   - Define core functionalities and user workflows.\n   - Design wireframes for user interfaces.\n\n2. **Frontend Development**\n   - Build UI screens using Kivy and KivyMD.\n   - Implement navigation and user interactions.\n\n3. **Backend Development**\n   - Set up Flask server and create API endpoints.\n   - Design database schema for orders, reservations, and user management.\n\n4. **Integration**\n   - Connect the Kivy frontend with the Flask backend via RESTful APIs.\n   - Test API responses and handle errors gracefully.\n\n5. **Testing**\n   - Perform unit testing for API endpoints.\n   - Conduct end-to-end testing on Android and iOS devices.\n\n6. **Deployment**\n   - Package the Kivy app using Buildozer and Xcode.\n   - Deploy the backend to a cloud platform.\n\n---\n\n## Prerequisites\n\n### Software Requirements\n- Python 3.8+\n- Kivy and KivyMD\n- Flask (or Django)\n- SQLite\n- Buildozer (for Android APKs)\n- Xcode (for iOS builds)\n\n### Installation Steps\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/edwinabdonshayo/jabudine.git\n   cd jabudine\n   ```\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. Run the backend server:\n   ```bash\n   cd backend\n   python app.py\n   ```\n4. Run the mobile app (Kivy):\n   ```bash\n   cd mobile_app\n   python main.py\n   ```\n\n---\n\n## Future Enhancements\n- **Payment Integration**: Add support for online payments via mobile money or credit cards.\n- **Push Notifications**: Use Firebase for real-time notifications.\n- **Advanced Analytics**: Provide detailed insights for restaurant owners.\n- **Multi-language Support**: Localize the app for various regions.\n\n---\n\n## Contributing\nWe are currently not taking any contributions. If you are interested in contributing, please reach out to us either through [Nicholas](https://github.com/Daemon403) or [Edwin](https://edwinshayo.com).\n\n---\n\n## License\nSee the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinabdonshayo%2Fjabudine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedwinabdonshayo%2Fjabudine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinabdonshayo%2Fjabudine/lists"}