Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vmdang/librarymanage
Manage library use AdminLTE 3.2 and Laravel 8
https://github.com/vmdang/librarymanage
adminlte-dashboard-template bootstrap4 html-css-javascript laravel8 mysql
Last synced: 26 days ago
JSON representation
Manage library use AdminLTE 3.2 and Laravel 8
- Host: GitHub
- URL: https://github.com/vmdang/librarymanage
- Owner: VMDang
- Created: 2022-12-20T09:58:54.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-07-09T09:46:12.000Z (over 1 year ago)
- Last Synced: 2024-10-11T11:21:51.305Z (26 days ago)
- Topics: adminlte-dashboard-template, bootstrap4, html-css-javascript, laravel8, mysql
- Language: Blade
- Homepage:
- Size: 18.1 MB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LIBRARY MANAGE
[](https://github.com/VMDang/LibraryManage/stargazers) [](https://github.com/VMDang/LibraryManage/stargazers) [](https://raw.githubusercontent.com/gothinkster/laravel-realworld-example-app/master/LICENSE)
> ### Library management project with feature such as Security, Authencation, Authorization, CRUD user, book, category,... supporting procedures for borrowing and returning books.
>### See more features and details about the source code in [Library Manage](https://github.com/VMDang/LibraryManage).
### In this project, i used HTML, CSS, jQuery, AdminLTE 3.2, PHP, Laravel 8, MySQL, Docker
This repo is functionality complete — PRs and issues welcome!
----------
# Getting started
## Installation
Please check the official laravel installation guide for server requirements before you start [Laravel 8 Documentation](https://laravel.com/docs/8.x). Necessary settings before starting as PHP >= 7.3, NodeJS, Composer
Alternative installation is possible without local dependencies relying on [Docker](#docker).
1. Clone the repository
git clone https://github.com/VMDang/LibraryManage.git
2. Switch to the repo folder
cd LibraryManage
3. Install all the dependencies using composer and npm
composer install
npm install
4. Copy the example env file and make the required configuration changes in the .env file
cp .env.example .env
> Please contact me via [Mail](mailto:[email protected]) to know more about the content in the .env file
5. Generate a new application key
php artisan key:generate
6. Run the database migrations (**Set the database connection in .env before migrating**)
php artisan migrate
7. Run database seeders
php artisan db:seed
8. Start the local development server
php artisan serve
You can now access the server at http://localhost:8000
## Database seeding
**Populate the database with seed data with relationships which includes users, roles, permission, books, category,... This can help you to quickly start testing the api or couple a frontend and start using it with ready content.**
Run the database seeder and you're done
php artisan db:seed
***Note*** : It's recommended to have a clean database before seeding. You can refresh your migrations at any point to clean the database by running the following command
php artisan migrate:refresh
## Docker
> Docker is not complete, I will be back to update when the project is done
>
To install with [Docker](https://www.docker.com), run following commands:
```
git clone https://github.com/VMDang/LibraryManage.git
cd LibraryManage
cp .env.example.docker .env
docker run -v $(pwd):/app composer install
cd ./docker
docker-compose up -d
docker-compose exec php php artisan key:generate
docker-compose exec php php artisan migrate
docker-compose exec php php artisan db:seed
docker-compose exec php php artisan serve --host=0.0.0.0
```
## Main Folders
***Note***: Only the main folders containing important code are mentioned, there are still a few folders that have not been mentioned
- `app/Models` - Contains all the Eloquent models
- `app/Http/Controllers` - Contains all the controllers
- `app/Http/Middleware` - Contains the auth middleware
- `app/Http/Requests` - Contains all the api form requests
- `app/Providers` - Contains all the providers
- `app/BaseHelper.php` - Contains all the function self-defining to help code Controller
- `config` - Contains all the application configuration files
- `database/factories` - Contains the model factory for all the models
- `database/migrations` - Contains all the database migrations
- `database/seeds` - Contains the database seeder
- `public/themes` - Contains source code AdminLTE 3.2
- `public/img` - Contains all the images project
- `public/js` - Contains all the files javascript
- `resources/views` - Contains all the filw view blade
- `routes/auth.php` - Contains route with auth feature
- `routes/web.php` - Contains all route feature
- `storage` - Storage all file in here
- `tests` - Contains all the application tests
## Environment variables
- `.env` - Environment variables can be set in this file
***Note*** : You can quickly set the database information and other variables in this file and have the application fully working.
----------
## License
The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
-------
# Developed team information
## About project
Initially the project was developed for personal purposes. But then I had a lot more teammates to do the same. It became the project of one of my subjects at HUST
> Thanks to the whole team for helping me complete this project. It's an honor to be your leader.
### This is my team
| Name | University | Role | Contact |
|-------------------| :----: |--------|----------|
| Vu Minh Dang | HUST | Leader | |
| Nguyen Duy Hung | HUST | Member | |
| Ngo Viet Bach | HUST | Member | |
| Ta Van Hoan | HUST | Member | |
| Mac Van Khanh | HUST | Member | |
| Nguyen The Thuong | HUST | Member | |
---------
## About me
### **Vu Minh Dang**
#### Hanoi University of Science and Technology - HEDSPI
Mail : [[email protected]](mailto:[email protected])