Organization MIS

Is a web based management information system app for managing an organization.

Main Features

Manage:

• Member
• Recruitments
• Accounting
• Presences
• in-out letters
• Files

Tech

• Laravel v8.x (documentation)
• Bootstrap v5.2 (documentation)

Deployment

1. Clone this repository

2. Create .env fle

You have to create .end file based on .env.example file. these are some variables that need to be set.

database connection is required, please filling up all variables below.

...

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=

...

This apps is capale for sending emails but you have to setup the connection to the email server first. please filling up these variables.

MAIL_MAILER=
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=
MAIL_FROM_ADDRESS=

This apps is also capable using Google OAuth. first, you need create a project on Google Cloud. then, create a credentials for OAuth for filling these variables.

...

GOOGLE_OAUTH_CLIENT_ID=
GOOGLE_OAUTH_CLIENT_SECRET=

...

3. run composer install on terminal

composer install

4. Generate laravel key

php artisan key:generate

5. Migrate Database

php artisan migrate

Reference: https://laravel.com/docs/8.x/migrations#introduction

6. Seed Database

php artisan db:seed

Reference: https://laravel.com/docs/8.x/seeding#introduction

7. Serve the web apps

for quickstart you can type command below:

php artisan serve

8. Initialize the apps

This app need a few setup to make it works. To setting up, first open your browser, then go to [YOUR DOMAIN]/initialize-app

If you serve the app by 'php artisan serve' command, by default the initialization page is located at http://localhost:8000/initialize-app.

9. Done

Congratulations‼, this App is ready on [YOUR DOMAIN]

🎉🎉🎉

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

The code is released under the MIT license.

Contact

Email - pemrogrammer@gmail.com