An open API service indexing awesome lists of open source software.

https://github.com/marcesdan/turnos

Scheduling appointment web system for health centers
https://github.com/marcesdan/turnos

axios bootstrap-notify bootstrap4 datatables fullcalendar jquery laravel npm php php7 sass select2 sweetalert vali-admin webpack

Last synced: 3 months ago
JSON representation

Scheduling appointment web system for health centers

Awesome Lists containing this project

README

          

# Sistema de gestión de turnos para centros de salud

# Turn-based management system for health centers

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. [Official Documentation](https://laravel.com/docs/5.4/installation#installation)

Clone the repository

git clone github.com/marcesdan/turnos.git turnos

Switch to the repo folder

cd turnos

Install all the dependencies using composer

composer install

Copy the example env file and make the required configuration changes in the .env file

cp .env.example .env

Generate a new application key

php artisan key:generate

Run the database migrations (**Set the database connection in .env before migrating**)

php artisan migrate

Install node modules

npm install

Compile assets

npm run dev

Or watch/recompile for assets changes with Browsersync

npm run watch

Start the local development server

php artisan serve

You can now access the server at http://localhost:8000
And with the watch option... at http://localhost:3000

## Database seeding

**Populate the database with seed data with relationships which includes users, medicos, roles, especialidades, turnos. This can help you to quickly start testing the api or couple a frontend and start using it with ready content.**

Open the DatabaseSeeder and set the property values as per your requirement

database/seeds/DatabaseSeeder.php

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

----------

# Code overview

## Dependencies

- [laravel-cors](https://github.com/barryvdh/laravel-cors) - For handling Cross-Origin Resource Sharing (CORS)

## Folders

- `app` - Contains all the Eloquent models
- `app/Http/Controllers` - Contains all the controllers
- `app/Http/Middleware` - Contains the JWT auth middleware
- `app/Http/Requests` - Contains all the api form requests
- `app/Http/Resources` - Contains all the eloquent api resources
- `app/Services` - Contains the business logic
- `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
- `routes` - Contains all theroutes defined in api.php file and web.php file

## 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.

----------

# Testing API

Run the laravel development server

php artisan serve

The api can now be accessed at

http://localhost:8000/api

# Authentication

This applications use the auth scaffolding provided by Laravel

- https://laravel.com/docs/master/authentication

----------

# Cross-Origin Resource Sharing (CORS)

This applications has CORS enabled by default on all API endpoints. The default configuration allows requests from `http://localhost:3000` and `http://localhost:4200` to help speed up your frontend testing. The CORS allowed origins can be changed by setting them in the config file. Please check the following sources to learn more about CORS.

- https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS
- https://en.wikipedia.org/wiki/Cross-origin_resource_sharing
- https://www.w3.org/TR/cors