{"id":25099796,"url":"https://github.com/enrtorgil/pawfinder","last_synced_at":"2025-10-25T15:08:52.054Z","repository":{"id":243415979,"uuid":"800175584","full_name":"enrtorgil/pawFinder","owner":"enrtorgil","description":"Propuesta TFC de GS DAW. PawFinder es una aplicación web diseñada para facilitar la adopción de mascotas y la gestión de animales perdidos. Se emplean tecnologías tales como Laravel, PHP, JavaScript y Leaflet.","archived":false,"fork":false,"pushed_at":"2024-09-10T08:13:42.000Z","size":5190,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T05:15:38.663Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/enrtorgil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-13T21:02:03.000Z","updated_at":"2024-09-10T08:13:45.000Z","dependencies_parsed_at":"2024-06-09T22:25:22.703Z","dependency_job_id":"9c6d42f7-298b-41b4-b4ba-fccc77ad45b8","html_url":"https://github.com/enrtorgil/pawFinder","commit_stats":null,"previous_names":["enrtorgil/pawfinder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/enrtorgil/pawFinder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enrtorgil%2FpawFinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enrtorgil%2FpawFinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enrtorgil%2FpawFinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enrtorgil%2FpawFinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/enrtorgil","download_url":"https://codeload.github.com/enrtorgil/pawFinder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enrtorgil%2FpawFinder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280973058,"owners_count":26422912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-07T19:39:59.850Z","updated_at":"2025-10-25T15:08:52.025Z","avatar_url":"https://github.com/enrtorgil.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"display: flex; justify-content: space-between; align-items: center;\"\u003e\n  \u003ch1\u003ePawFinder - Enrique Torrella\u003c/h1\u003e\n  \u003cimg src=\"https://komarev.com/ghpvc/?username=enrtorgil\u0026color=006bed\" alt=\"Profile Views\"\u003e\n\u003c/div\u003e\n\n### Descripción del Proyecto 🎓\nEl proyecto PawFinder consiste en una aplicación web diseñada para agilizar los procesos de adopción de mascotas y gestión de animales perdidos. Para asegurar el éxito del proyecto, se ha optado por seguir una metodología waterfall, que permite avanzar de manera progresiva y garantizar la coherencia entre cada etapa cumplida y las anteriores. \n\nLa aplicación se apoya principalmente en el framework Laravel, utilizando plantillas Blade, y emplea tecnologías como PHP, JavaScript y Leaflet. Ofrece características clave como registro de usuarios, autenticación de inicio de sesión, control de acceso basado en roles y mensajería entre usuarios. Los usuarios pueden crear, editar, actualizar, eliminar, reportar y marcar como favoritas las publicaciones de animales perdidos o en adopción. Los administradores tienen acceso completo a los datos de usuarios y publicaciones, con permisos para gestionarlos según sea necesario. La aplicación es multilingüe (castellano e inglés) y cuenta con un diseño adaptable para ofrecer una experiencia fluida en todos los dispositivos. \n\nCon PawFinder, se espera abordar de manera efectiva el creciente problema del extravío y abandono de animales al ofrecer una plataforma intuitiva y accesible para la adopción y gestión de mascotas perdidas. Se espera que esta iniciativa tenga un impacto significativo en la comunidad local y más allá, promoviendo la solidaridad y el cuidado responsable de los animales.\n\n\u003chr\u003e\n\n### Tecnologías Utilizadas\n- ![Laravel](https://img.shields.io/badge/-Laravel-333333?style=flat\u0026logo=laravel) -----------------------\u003e 10.48.10\n- ![Laragon](https://img.shields.io/badge/-Laragon-333333?style=flat\u0026logo=laragon) ----------------------\u003e 6.0\n- ![phpMyAdmin](https://img.shields.io/badge/-phpMyAdmin-333333?style=flat\u0026logo=phpmyadmin) ------------------\u003e 5.2.1\n- ![MariaDB](https://img.shields.io/badge/-MariaDB-333333?style=flat\u0026logo=mariadb) ----------------------\u003e 10.11.7\n- ![PHP](https://img.shields.io/badge/-PHP-333333?style=flat\u0026logo=php) ---------------------------\u003e 8.1.10\n- ![Composer](https://img.shields.io/badge/-Composer-333333?style=flat\u0026logo=composer) ---------------------\u003e 2.6.6\n- ![Apache](https://img.shields.io/badge/-Apache-333333?style=flat\u0026logo=apache) ------------------------\u003e 2.4.54\n\n\u003cbr/\u003e\n\n\u003e [!IMPORTANT]\n\u003e ### Funcionalidades Principales\n\u003e \n\u003e #### 1. Visualización de Páginas\n\u003e - **Páginas disponibles para usuarios no registrados**: Los usuarios no registrados pueden visualizar el apartado de preguntas frecuentes (FAQ) y un mensaje de bienvenida.\n\u003e - **Páginas adicionales para usuarios registrados**: Los usuarios registrados tienen acceso a todas las secciones de la aplicación, incluyendo ‘Inicio’, ‘Publicaciones’, ‘Mis anuncios’, ‘Favoritos’, ‘Mi perfil’, ‘Mensajes’, ‘Administrador’ (solo para administradores), ‘Cerrar sesión’ y ‘Alternar idioma’.\n\u003e \n\u003e #### 2. Visualización de Páginas Específicas\n\u003e - **Todas las páginas**: La aplicación muestra un conjunto de publicaciones, incluyendo el anuncio más reciente, el anuncio con más favoritos, y permite la creación de nuevas publicaciones desde cualquier sección accesible para usuarios registrados.\n\u003e \n\u003e #### 3. Funcionalidades Específicas\n\u003e - **Registro de Usuario**: Permite a los usuarios registrarse proporcionando un nombre de usuario, correo electrónico, contraseña y número de contacto.\n\u003e - **Inicio de Sesión**: Permite a los usuarios iniciar sesión utilizando su correo electrónico y contraseña.\n\u003e - **Creación de Anuncios**: Los usuarios registrados pueden crear anuncios de animales perdidos o en adopción, especificando detalles como nombre del animal, tipo de publicación, tipo de animal, tamaño, imagen, fecha, última ubicación y descripción adicional.\n\u003e - **Gestión de Anuncios**: Los usuarios pueden editar y eliminar sus propios anuncios, así como marcar anuncios como favoritos para revisarlos posteriormente.\n\u003e - **Mensajería**: Los usuarios pueden contactar con los autores de los anuncios mediante mensajes que incluyen asunto, descripción breve y número de contacto.\n\u003e - **Reportes**: Los usuarios pueden reportar anuncios por contenido inapropiado, información incorrecta, spam u otras razones, y los administradores reciben notificaciones sobre estos reportes.\n\u003e - **Administrador**: Los administradores tienen acceso a una sección exclusiva donde pueden gestionar usuarios, publicaciones y reportes, así como eliminar usuarios y anuncios si es necesario.\n\u003e - **Exportación de Datos**: Los usuarios pueden exportar sus mensajes a una tabla tipo Excel, y los administradores pueden exportar tablas relativas al dashboard de ‘Usuarios’, ‘Publicaciones’ y ‘Reportes’.\n\u003e - **Multilingüe**: La aplicación está disponible en castellano e inglés, permitiendo a los usuarios alternar entre ambos idiomas.\n\n\u003e [!WARNING]\n\u003e ### Estructura de ficheros a destacar (Laravel 10.x)\n\u003e - 📁 `app/`\n\u003e   - 📁 `Console/`\n\u003e   - 📁 `Exceptions/`\n\u003e   - 📁 `Http/`\n\u003e     - 📁 `Controllers/`\n\u003e     - 📁 `Middleware/`\n\u003e     - 📁 `Requests/`\n\u003e     - 📁 `Mail/`\n\u003e   - 📁 `Models/`\n\u003e - 📁 `config/`\n\u003e - 📁 `database/`\n\u003e   - 📁 `migrations/`\n\u003e   - 📁 `seeders/`\n\u003e - 📁 `lang/`\n\u003e - 📁 `public/`\n\u003e - 📁 `resources/`\n\u003e   - 📁 `css/`\n\u003e   - 📁 `js/`\n\u003e   - 📁 `views/`\n\u003e - 📁 `routes/`\n\u003e   - 📄 `web.php`\n\u003e - 📄 `.env`\n\u003e - 📄 `composer.json`\n\u003e - 📄 `composer.lock`\n\u003e - 📄 `LICENSE.md`\n\u003e - 📄 `README.md`\n\n\u003e [!CAUTION] \n\u003e ### Licencia\n\u003e Este proyecto está bajo la Licencia MIT. Consulta el archivo `LICENSE.md` para obtener más detalles. [MIT license](https://opensource.org/licenses/MIT).\n\n\u003e [!TIP]\n\u003e ### Instalación y Ejecución\n\u003e 1. Clona este repositorio: `git clone https://github.com/enrtorgil/EnriqueTorrellaLaravel.git`\n\u003e 2. Navega al directorio del proyecto: `cd pawFinder`\n\u003e 3. Instala las dependencias: `composer install` OR `php composer.phar install`\n\u003e 4. Generar clave de cifrado si fuera necesario `php artisan key:generate`\n\u003e 5. Configura el archivo `.env` con la información de tu base de datos.\n\u003e 5. Ejecuta las migraciones: `php artisan migrate`\n\u003e 6. Ejecuta la aplicación: `php artisan serve`\n\u003e 7. Abre tu navegador y visita `http://localhost:8000/` o host de prueba si lo hubiese.\n\u003e 8. Se recomienda desplegar desde Laragon. En ese caso acceder al dominio local `pawfinder.test`.\n\n## Algunas capturas de pantalla\n\n### Página de Inicio (usuario no autenticado)\n![Página de Inicio](public/img/img-readme/index1-captura.png)\n\n### Gestión de Usuarios\n![Gestión de Usuarios](public/img/img-readme/manage-users.png)\n\n### Mis Publicaciones\n![Mis Publicaciones](public/img/img-readme/mypublications.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenrtorgil%2Fpawfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fenrtorgil%2Fpawfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenrtorgil%2Fpawfinder/lists"}