/Medbele-Anba

A library management system developed using Flutter and Django.

Primary LanguageDartMIT LicenseMIT

መድብለ-አምባ Library Management System

Welcome to መድብለ-አምባ, our library management system project! This project combines the power of Django for the backend and Flutter for the frontend to create an efficient library management system.

Project Folder Structure

መድብለ-አምባ/
├── flutter_app/
│   ├── lib/
│   │   ├── main.dart
│   │   ├── ...
│   ├── android/
│   ├── ios/
│   ├── ...
├── django_backend/
│   ├── library_project/ 
│   │   ├── library_project/ (Django Project Configuration)
│   │   │   ├── __init__.py
│   │   │   ├── asgi.py
│   │   │   ├── settings.py
│   │   │   ├── urls.py
│   │   │   ├── wsgi.py
│   │   ├── library_app/ (Django's RestApi app for the Library)
│   │   │   ├── __init__.py
│   │   │   ├── admin.py
│   │   │   ├── apps.py
│   │   │   ├── migrations/
│   │   │   │   ├── __init__.py
│   │   │   ├── models.py
│   │   │   ├── serializers.py
│   │   │   ├── tests.py
│   │   │   ├── views.py
│   │   ├── media/ (User-Uploaded Media Files)
│   │   ├── manage.py (Django Management Script)
│   ├── requirements.txt (Python Dependency List)
  • flutter_app/: This directory houses the source code for our Flutter mobile app. Explore the lib/ folder for app logic and the android/ and ios/ folders for platform-specific code.

  • django_backend/: In this directory, you'll find the Django rest api that powers our library management system.

Please note that when you browse this repository on GitHub, you'll encounter these two directories directly at the top level, without a parent folder named መድብለ-አምባ/. This organization is designed for simplicity.

Getting Started

To get up and running with our library management system, follow these steps:

  1. Clone the Repository: Clone this repository to your local machine using the following command:

    git clone https://github.com/Abthon/Medbele-Anba.git
  2. Set Up Your Environment: Create a virtual environment for your Django project and activate it. Then, install the required dependencies from requirements.txt. For Flutter, ensure you have Flutter and Dart installed on your system.

  3. Run the Django Backend: Navigate to the django_backend/ directory and run the following commands:

    python manage.py migrate
    python manage.py runserver
  4. Run the Flutter App: Open the flutter_app/ directory in your preferred code editor. Use the following command to launch the Flutter app on an emulator or device:

    flutter run



Contributors

Issues and Support

If you encounter any issues or have questions about our library management system, please visit our Issue Tracker to report problems or seek assistance.

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute it as per the terms of the license.

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 12 Screenshot 4 Screenshot 9 Screenshot 5 Screenshot 6 Screenshot 11 Screenshot 16 Screenshot 13 Screenshot 14 Screenshot 7 Screenshot 8 Screenshot 10 Screenshot 15 Screenshot 17 Screenshot 18