A tool to improve location and equipment reservation workflow for clubs, students and faculty members.
You must have the ZenHub Extension installed for your browser to properly our issues board and sprints.
- PHP >= 7.3, preferably 7.4
- PHP extensions you might not have by default:
bcmath, pgsql
composer
&npm
executables- Postgres > 12
- Latest Apache / Nginx / Caddy
xdebug
is always a plus
Use any XAMPP/ MAMP like tools, I recommended laragon
on pc or valet
/valet+
on mac
- once you clone the repo run
composer fresh
, it will run a batch of the starter commands. - Open the
.env
and configure it to work with what you need, namely the DB connection - Create a pgsql database matching the connection details in your
.env
- Create the db schema and seed it with random values with
composer mfs
- verify your setup is functional with alias
composer diag
or the full commandphp artisan self-diagnosis
- Access the web app through your preferred local web server setup (I like valet+ on macs & laragon on PC, ghetto way: php artisan serve + manual Postgres install)
- When you see DB issues run
php artisan migrate:fresh --seed
(composer mfs
for short) to quickly recreate the db tables and seed it with random data - If you just need more random data in the db run
php artisan db:seed
- When everything goes to hell run
composer fresh
orcomposer reset
if you don't want to rerun migrations npm run dev
ornpm run watch
for frontend dev build, the watch command will recompile when files are changed.
Navigate to your local site. Varies depending on web server. Could be localhost:8000, could be csu.test 🤷
Look at routes/api.php
file for a quick view of api specific routes that are defined for this application.
Postman or Insomnia are good tools for building
out api endpoint collections.
Tinker is the primary tool for testing queries, php logic, and debugging weird code... Basically your best friend.
Open it with php artisan tinker
. It's an interactive repl php shell that makes it quick & easy to dumbass proof your code.
We'll be using the laravel framework for this project. A good place to start learning all of this scary new tech is Laracasts, specifically the laravel from scratch series & Vue 2 Step by step.
Here are some more resources you might want to take a look at :
- Video Game Aggregator (Laravel+Tailwind)
- Vue Step-by-Step
- Testing Laravel
- https://www.youtube.com/watch?v=U3rPtLW5iuI
- https://www.youtube.com/watch?v=EU7PRmCpx-0&list=PLillGF-RfqbYhQsN5WMXy6VsDMKGadrJ-
- Best Practices Summary Site
- Laravel Team on Laravel 4 patterns - Presentation Talk
- Design Patterns in Laravel Book
- Code examples of patterns - Here's a video if you don't like reading
- Adapter, Straregy & Factory Patterns in Laravel w/ examples prepare to 2x speed and hit the left key 8x a sec
- Design Patterns in PHP and Laravel by Kelt Dockins, ISBN:9781484224502 link on gdrive coming soon
- Detailed Installation
- Detailed Debug Setup in PhpStorm
- Doc appointment DB Design
- Actually best vid, basically 341 in 45m
This booking application is open-sourced software licensed under the MIT license.