Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/lilymilano/adopciones-pin2203-g4-backend

Proyecto Integrador Full-Stack 2203. Liliana Milano. Backend Laravel.
https://github.com/lilymilano/adopciones-pin2203-g4-backend

api-rest backend-development laravel9

Last synced: about 2 months ago
JSON representation

Proyecto Integrador Full-Stack 2203. Liliana Milano. Backend Laravel.

Host: GitHub
URL: https://github.com/lilymilano/adopciones-pin2203-g4-backend
Owner: LilyMilano
Created: 2023-02-18T00:22:47.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2023-03-22T05:27:55.000Z (almost 2 years ago)
Last Synced: 2024-10-12T11:22:56.894Z (3 months ago)
Topics: api-rest, backend-development, laravel9
Language: PHP
Homepage:
Size: 1.19 MB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## PIN 2203 - Liliana Milano - PET ADOPCIONES SPA - BACKEND

Para poner en evidencia lo aprendido durante el dictado se presenta el desarrollo backend de una aplicación web, en Laravel 9. Corresponde a una sección de formulario con validación clara del lado del servidor.

El proyecto contempló la creación de una API REST en Laravel 9 con las funcionalidades de: envío de formulario vía mail y almacenamiento de los datos del envío en una base de datos (MySQL).

El presente desarrollo se expondrá vía web con su correspondiente frontend responsive en ReactJS.

## Servicio API REST y Endpoint:
[API REST](https://adopciones-pin2203-g4-backend-production.up.railway.app/): https://adopciones-pin2203-g4-backend-production.up.railway.app/
Endpoint: https://adopciones-pin2203-g4-backend-production.up.railway.app/index.php/api/insertContactos

## Alcance del Proyecto:

- Creación de servicio API REST. Fue probada con el software 'Postman Inc'.

![postman-response](readme/api_postman.jpg)

- Envío del formulario vía email. Se utilizó la plataforma 'Mailtrap by railsware'.
[Disposable email domains](https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt)

![envío-email-response](readme/mailtrap_pin2203.png)

- Almacenamiento de los datos en la base de datos: 'dbpin2203'.

![mysql-response](readme/dbpin2203backend.png)

## Ejecución Local del Proyecto:

- [Clonar](https://docs.github.com/es/repositories/creating-and-managing-repositories/cloning-a-repository) el repositorio pin2203backend en una nueva carpeta dentro de su carpeta htdocs local. Ejemplo: C:\xampp\htdocs\pin2203backend.
- Cambiar desde la terminal a la carpeta creada: cd C:\xampp\htdocs\pin2203backend
- Ejecutar 'composer install' para instalar las dependencias.
- Crear el archivo .env que debe ser hermano (y su contenido debe ser igual al) del archivo .env.example.
- Abrir phpmyadmin o la consola de MySQL y crear la nueva base de datos: 'dbpin2203'.
- Crear el archivo .env que debe ser hermano (y su contenido debe ser igual al) del archivo .env.example.
- En la terminal ejecutar 'php artisan migrate --seed'. Ese comando va a migrar la base de datos (crear tabla) y alimentarla.
- En la misma terminal es deseable generar una clave para nuestro proyecto con 'php artisan key:generate'.
- Ejecutar php artisan 'storage:link' para crear algunos enlaces con el almacenamiento y la carpeta pública.
- En la url http://localhost/pin2203backend/public/ debe desplegarse la app.

Nota importante: si aparece un error se recomienda ejecutar 'composer update', actualizar la versión de PHP, revisar la conexión de internet, etcétera.

## Licencia

El entorno de trabajo Laravel 9 es un proyecto de código abierto bajo licencia: [MIT license](https://opensource.org/licenses/MIT).

## Documentación de Laravel

Laravel tiene la más extensa y exhaustiva documentación: [documentation](https://laravel.com/docs).