snoopycodex / panguil-ecopark-admin-laravel

An admin system for Panguil River Eco-park and Resort

Panguil EcoPark and Resort Admin System

About this project

This is a web-based admin system for Panguil EcoPark and Resort which is made using Laravel + Vite and Bootstrap. The admin dashboard template used was from NobleUI.com. This system features:

• Quick summaries of total tourists visited in the current year and previous year, registered tourists, reservations and assigned tourists.
• The dashboard itself also shows the reminders
• Complete list of registered tourists
• Complete list of reservations
• Complete list of tour guides
• Live map tracking of users

This admin system was built and made specifically for Panguil EcoPark and Resort so that it will be easier for them to keep track of their data and manage each tourist and tour guides' informations.

Techs Used

• Laravel v10.xx
• Pubnub
• Vite.JS
• Leaflet.JS
• Mapbox Tiles
• Bootstrap 5
• NobleUI Admin Template

Project Preview

Geofence editing

Building Project

Download dependencies:

composer install
npm install
npm install --dev

Copy .env.example to .env file:

cp .env.example .env

Run artisan command:

php artisan key:generate

Next, open .env file and find and replace these keys' values with your own pubnub account credentials and database credentials. Create an account at pubnub.com to get your own credentials if you don't have one.

DB_DATABASE=[YOUR DATABASE NAME]
DB_USERNAME=[YOUR DATABASE USERNAME]
DB_PASSWORD=[YOUR DATABASE PASSWORD]

PUBNUB_PUBLISH_KEY=[YOUR PUBNUB PUBLISH KEY]
PUBNUB_SUBSCRIBE_KEY=[YOUR PUBNUB SUBSCRIBE KEY]
PUBNUB_SECRET_KEY=[YOUR PUBNUB SECRET KEY]
PUBNUB_CHANNEL_NAME=[YOUR CUSTOM CHANNEL NAME]

Next, run migration to generate all the tables:

php artisan migrate

Next, run this command to create a default admin account for the system:

php artisan app:create-admin

The default admin email address and password is:

Email: [email protected]
Password: test123

Next, run this command twice (for some reason it doesn't take effect by running once) if you want to run the system in development mode:

php artisan app:run-as-dev

Hit Ctrl+C to stop and then execute it again. Then it will work, then just open http://localhost:8000 in your browser. By default, the system is hosted on port 8000.

To run the system in production mode, you just do the same thing but with this command:

php artisan app:run-as-prod

Note: When executing php artisan app:run-as-dev and php artisan app:run-as-prod while in production mode, you will be prompted in the console. When that happens, just type yes on each prompts and press Enter.

Generating PHP Docs

Just execute these commands:

# Generate php docs for laravel facades
php artisan ide-helper:generate

# Generate php docs for laravel models
# You will be prompted in the console, just type no.
php artisan ide-helper:models

About Laravel

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Learning Laravel

Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.

You may also try the Laravel Bootcamp, where you will be guided through building a modern Laravel application from scratch.

If you don't feel like reading, Laracasts can help. Laracasts contains over 2000 video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.

Laravel Sponsors

We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the Laravel Patreon page.

Premium Partners

• Vehikl
• Tighten Co.
• Kirschbaum Development Group
• 64 Robots
• Cubet Techno Labs
• Cyber-Duck
• Many
• Webdock, Fast VPS Hosting
• DevSquad
• Curotec
• OP.GG
• WebReinvent
• Lendio

Contributing

Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [email protected]. All security vulnerabilities will be promptly addressed.

License

The Laravel framework is open-sourced software licensed under the MIT license.