Giter VIP home page Giter VIP logo

khaledashrafh / students-registration-system Goto Github PK

View Code? Open in Web Editor NEW
0.0 2.0 0.0 824 KB

It's a subsystem that facilitates the process of registering student data. It includes two components: the main menu component for individual student registration and the batch data component for bulk student registration.

License: MIT License

Dockerfile 4.02% Java 95.98%
ci-cd cicd cloud-computing cloud-computing-course component continous-deployment continous-integration docker docker-compose docker-container

students-registration-system's Introduction

Student Registration System

It's a subsystem that facilitates the process of registering student data. It includes two components: the main menu component for individual student registration and the batch data component for bulk student registration.

Main Menu Component

The main menu component allows users to register individual student data to the system. It provides a simple menu interface with the following options:

  1. Add student data
  2. Add batch students data

Adding Individual Student Data

To add an individual student's data, follow these steps:

  1. Run the component.

  2. The main menu will be displayed. Enter 1.

  3. Enter the student's data in the following order: Name, ID, Courses. For example:

    Ahmed
    1
    AI, Math
    

Batch Data Component

The batch data component enables users to insert multiple student records into the system at once. It allows the selection of eligible files containing bulk student data.

Adding Batch Students Data

To add batch students data to the system, follow these steps:

  1. Run the component.

  2. The main menu will be displayed. Enter 2.

  3. The eligible files will be shown, which are the files containing the phrase "verified" in their names.

  4. Select the desired file by entering its name. For example:

    1_verified.csv
    

Assumptions

  • The path /app/data/batch/ is correctly mounted to a specific folder.
  • The eligible files contain student data in a specific format, where each line represents one student's data separated by semicolons, and courses are separated by commas.

CI/CD Pipeline

To ensure the successful building and deployment of the relevant components, a CI/CD pipeline is implemented for the software. The pipeline consists of continuous integration (CI) and continuous deployment (CD) processes for each repository.

CI Process

The CI process ensures that each repository's component is built successfully. It involves the following steps:

  1. Set up a CI configuration in the repository to trigger a build process on each commit.
  2. Configure the build process to compile the source code and run any necessary tests.
  3. If the build process succeeds, proceed to the CD process.

CD Process

The CD process pushes the image for the relevant component to Docker Hub. It includes the following steps:

  1. Set up a CD configuration in the repository to trigger the deployment process upon a successful build.
  2. Build a Docker image for the component, using the provided Dockerfile.
  3. Tag the image with the appropriate version, such as latest.
  4. Push the image to Docker Hub, using the specified repository and version.

Docker Compose Configuration

The provided Docker Compose file allows for the deployment of the subsystem components. It defines two services: student-statistics-process and registration-process.

student-statistics-process

  • Builds the image from the source code.
  • Maps the local folder /app/data/batch to the corresponding folder in the Docker container.
  • Exposes port 80 for accessing the component.

registration-process

  • Builds the image from the source code.
  • Maps the local folder /app/data/batch to the corresponding folder in the Docker container.
  • Exposes port 81 for accessing the component.

Running the Docker Compose File

To run the Docker Compose file and deploy the subsystem, follow these steps:

  1. Download the Docker Compose file from the repository.

  2. Update the file with the appropriate local paths as indicated.

  3. Open a terminal or PowerShell in the directory where the Docker Compose file is located.

  4. Run the following command to start the containers:

    docker-compose up -d
    
  5. Open another terminal to execute the other component if needed.

  6. To execute commands inside a container, run the following command in the terminal:

    docker exec -it component-name bash
    
  7. Run the component's main class or entry point inside the container. For example, for the main class Main:

    java Main
    

By following these steps, you can deploy and utilize the Student Registration Subsystem, incorporating CI/CD practices and Docker containerization concepts.

Contributing

Contributions to the system are welcome. If you would like to contribute, please follow these steps:

  1. Fork the repository on GitHub.

  2. Create a new branch for your feature or bug fix.

  3. Make the necessary changes in your branch.

  4. Test your changes thoroughly.

  5. Submit a pull request to the main repository.

  6. Provide a clear description of your changes and the problem they solve.

  7. Be responsive to any feedback or questions regarding your pull request.

Team

This System was created by a team of four computer science students at Faculty of Computers and Artificial Intelligence Cairo University. The team members are:

Acknowledgment

  • This System is based on Cloud Computing course at Faculty of Computers and Artificial Intelligence Cairo University. We would like to thank prof. Fatma Omara for his guidance and support throughout this course.

  • The Another Subsystem.

License

The System is released under the MIT License. You are free to use, modify, and distribute the toolbox in accordance with the terms of this license.

students-registration-system's People

Contributors

khaledashrafh avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.