https://github.com/jcardonamde/php-kasumi-web-service
A Laravel-based PHP web service providing user registration and authentication endpoints with clear success and error responses.
https://github.com/jcardonamde/php-kasumi-web-service
jetstream-laravel laravel-framework mysql php sqlite
Last synced: 2 months ago
JSON representation
A Laravel-based PHP web service providing user registration and authentication endpoints with clear success and error responses.
- Host: GitHub
- URL: https://github.com/jcardonamde/php-kasumi-web-service
- Owner: jcardonamde
- Created: 2025-07-23T04:10:15.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-26T22:15:05.000Z (11 months ago)
- Last Synced: 2025-08-31T11:17:01.390Z (10 months ago)
- Topics: jetstream-laravel, laravel-framework, mysql, php, sqlite
- Language: Blade
- Homepage:
- Size: 173 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📚 GA7-220501096-AA5-EV01: Diseño y desarrollo de servicios web - Caso
## 📝 Descripción
Este proyecto corresponde a la evidencia solicitada en el componente formativo **"Construcción de API"**. El objetivo es diseñar y codificar un servicio web que permita el registro de usuarios y el inicio de sesión, cumpliendo con los siguientes requisitos:
- El servicio recibe un usuario y una contraseña.
- Si la autenticación es correcta, retorna un mensaje de autenticación satisfactoria.
- Si la autenticación es incorrecta, retorna un mensaje de error.
- El código contiene comentarios explicativos.
- El proyecto utiliza herramientas de versionamiento (Git).
🎥 Demostración
Puedes ver una demostración del funcionamiento del proyecto en el siguiente enlace:
👉 [Visita el proyecto Kasumi](https://www.youtube.com/watch?v=72OaYShzdgw)
## 🗂️ Estructura del Proyecto
El proyecto está desarrollado en Laravel e incluye:
- **Registro de usuario:** Permite crear nuevos usuarios.
- **Inicio de sesión:** Permite autenticar usuarios existentes.
- **Mensajes claros:** Respuestas diferenciadas para autenticación exitosa o fallida.
- **Comentarios:** El código fuente contiene comentarios para facilitar su comprensión.
## 🛠️ Tecnologías Utilizadas
- **PHP 8.x**
- **Laravel 10.x**
- **Jetstream** (con Livewire)
- **MySQL** (u otro motor compatible)
- **Node.js** y **NPM**
- **Tailwind CSS**
- **Laragon** (entorno de desarrollo local)
## ⚙️ Requisitos Previos
Antes de iniciar, asegúrate de tener instalado en tu equipo:
- [Laragon](https://laragon.org/download/) (recomendado para Windows, incluye Apache, MySQL, PHP y más)
- Composer
- Node.js y NPM
- Un navegador web moderno
## 🚀 Creación del Proyecto desde Cero
Si quieres crear este proyecto desde el inicio, sigue estos pasos:
### 1. **Crear el proyecto con Laragon desde la terminal**
```bash
composer create-project laravel/laravel tienda-sena
cd tienda-sena
```
### 2. **Instalar paquete Jetstream**
```bash
composer require laravel/jetstream
```
### 3. **Instalar Jetstream con Livewire**
```bash
php artisan jetstream:install livewire
```
### 4. **Instalar dependencias y construir las dependencias NPM**
```bash
npm install
npm run dev
```
### 5. **Ejecutar la migración de la base de Datos**
```bash
php artisan migrate
```
## 🔧 Instalación (Proyecto Existente) y Ejecución
1. **Clona el repositorio**
```bash
git clone https://github.com/jcardonamde/php-kasumi-web-service.git
cd tienda-sena
```
2. Instala las dependencias de PHP y JavaScript:
```bash
composer install
npm install
```
3. Configura el archivo `.env` con los datos de tu base de datos.
4. Ejecuta las migraciones:
```bash
php artisan migrate
```
5. Inicia el servidor de desarrollo:
```bash
npm run dev
```
## Pruebas del Servicio
- **Registro:** Accede a `/register` para crear un nuevo usuario. Ejemplo en el navegador usar: http://localhost/tienda-sena/public/register
- **Inicio de sesión:** Accede a `/login` para autenticarte. Ejemplo en el navegador usa: http://localhost/tienda-sena/public/login
- **Recuperar contraseña:** Accede a `/forgot-password` para recuperar el acceso al sistema mediante un enlace de restablecimiento de contraseña. Ejemplo en el navegador usa: http://localhost/tienda-sena/public/forgot-password
- El sistema mostrará mensajes claros según el resultado de la autenticación.
## 👨💻 Autor
**Desarrollado por:**
👥 Daniel Alejandro Vargas Uzuriaga
👥 Daniela López Chica
👥 Jonathan Cardona Calderon
👥 Luz Eleidis Baldovino González
:computer: Programa Tecnólogo en Análisis y Desarrollo de Software
Ficha Técnica 2977435
---