{"id":31588656,"url":"https://github.com/rafa-x64/proyecto","last_synced_at":"2026-05-04T09:32:35.749Z","repository":{"id":314781927,"uuid":"1056308412","full_name":"Rafa-x64/proyecto","owner":"Rafa-x64","description":"Este repositorio contiene una base modular para aplicaciones web en PHP, organizada bajo el patrón Modelo-Vista-Controlador (MVC). Está diseñada para desarrolladores que buscan una arquitectura clara, escalable y segura, con separación estricta entre lógica, presentación y flujo de ejecución.","archived":false,"fork":false,"pushed_at":"2025-09-23T02:04:14.000Z","size":909,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-23T03:39:44.266Z","etag":null,"topics":["ajax","apache","bootstrap5","composer","developer-guide","documentation","dynamic-views","git-workflow","javascript","modular-architecture","mvc","openssl","password-hashing","pdo","php","php-mvc","prepared-statements","secure-development","template-engine","web-template"],"latest_commit_sha":null,"homepage":"","language":"Hack","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rafa-x64.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-13T20:13:52.000Z","updated_at":"2025-09-23T01:58:43.000Z","dependencies_parsed_at":"2025-09-14T19:40:31.672Z","dependency_job_id":"931667d8-dbf4-4a01-81d7-7fb94a63b34b","html_url":"https://github.com/Rafa-x64/proyecto","commit_stats":null,"previous_names":["rafa-x64/proyecto"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Rafa-x64/proyecto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafa-x64%2Fproyecto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafa-x64%2Fproyecto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafa-x64%2Fproyecto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafa-x64%2Fproyecto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rafa-x64","download_url":"https://codeload.github.com/Rafa-x64/proyecto/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafa-x64%2Fproyecto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278547821,"owners_count":26004775,"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-06T02:00:05.630Z","response_time":65,"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":["ajax","apache","bootstrap5","composer","developer-guide","documentation","dynamic-views","git-workflow","javascript","modular-architecture","mvc","openssl","password-hashing","pdo","php","php-mvc","prepared-statements","secure-development","template-engine","web-template"],"created_at":"2025-10-06T02:12:04.024Z","updated_at":"2025-10-06T02:12:17.338Z","avatar_url":"https://github.com/Rafa-x64.png","language":"Hack","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💡 Proyecto Base MVC en PHP\n\nAplicación web modular construida bajo el patrón **Modelo-Vista-Controlador** (**MVC**) para facilitar el desarrollo escalable, seguro y mantenible de interfaces dinámicas en PHP.\n\n---\n## 📝 Tareas\n\nPara ver la **Estructura Completa de Tareas y Pendientes**, visita nuestro [Tablero Kanban aquí ➡️](.kanbn/index.md).\n\n---\n\n## 🚀 Inicio Rápido\n\nEste repositorio sirve como **plantilla base** para cualquier aplicación web construida en PHP que requiera una estructura organizada, segura y modular. Ir a [manual de desarrollador](src/docs/manual_desarrollador.md) para más detalles.\n\n---\n\n## 🛠️ Tecnologías Principales\n\nEl proyecto está construido con un stack moderno y enfocado en la seguridad y la modularidad.\n\n| Componente    | Versión / Propósito                   |\n| :------------ | :------------------------------------ |\n| **PHP**       | 8.0+ (POO, modularidad)               |\n| **Composer**  | Gestión de dependencias y autoloading |\n| **Bootstrap** | 5 (Estilos y diseño responsivo)       |\n| **PDO**       | Acceso seguro a Bases de Datos        |\n| **Apache**    | Reescritura de URLs con `.htaccess`   |\n| **OpenSSL**   | Encriptación de datos sensibles       |\n\n---\n\n## ⚙️ Instalación y Configuración\n\nSigue estos pasos para poner en marcha el proyecto en tu entorno local (requiere **PHP 8.0+**, **Apache** y **Composer**).\n\n### 1. Clonar el Repositorio\n\nClona el proyecto en tu directorio de servidor web (ej. `htdocs` de XAMPP):\n\n```bash\ngit clone [URL_DEL_REPO]\ncd proyecto\n```\n## 2. Instalar Dependencias\n\nUsa **Composer** para descargar todas las librerías necesarias (incluyendo Bootstrap):\n\n```bash\ncomposer install\n```\n## 3. Configuración Inicial\n\nConfigura las **variables esenciales del sistema** en los siguientes archivos. Asegúrate de configurar `config/SERVER` para la conexión a la base de datos.\n\n* `config/SERVER`: Credenciales de BD, claves de encriptación y parámetros sensibles. **⚠️ Añadir a `.gitignore`.**\n* `config/APP`: Nombre del sistema, ruta base y configuración general.\n\n---\n\n## 4. Iniciar el Servidor\n\nAccede al proyecto en tu navegador. El punto de entrada es `index.php`, que gestiona las rutas dinámicas.\n\n```bash\nhttps://localhost/nombre_del_proyecto/\n```\n---\n\n## 🏗️ Estructura del Proyecto (MVC)\n\nEl núcleo del sistema sigue el patrón **Modelo-Vista-Controlador (MVC)**, garantizando la separación de responsabilidades:\n\n| Carpeta       | Responsabilidad     | Descripción                                                         |\n| :------------ | :------------------ | :------------------------------------------------------------------ |\n| `controller/` | **Controlador (C)** | Gestiona el flujo de la aplicación e interactúa con el Modelo.      |\n| `model/`      | **Modelo (M)**      | Lógica de negocio, conexión a BD, validaciones y encriptación.      |\n| `view/html/`  | **Vista (V)**       | Archivos `.php` que contienen la interfaz de usuario (`-view.php`). |\n| `assets/`     | **Recursos**        | CSS, JS, imágenes, layouts y componentes reutilizables.             |\n| `helpers/`    | **Auxiliares**      | Funciones de PHP y JavaScript reutilizables para todo el sistema.   |\n| `config/`     | **Configuración**   | Constantes y parámetros de entorno.                                 |\n\n### Referencia a estructura del proyecto\n\n\u003e[Estructura del proyecto](src/docs/estructura_proyecto.md)\n\n---\n\n## 🤝 Contribución\n\n**¡Las contribuciones son bienvenidas!** Para colaborar en el desarrollo:\n\n1.  Clona el repositorio y crea una rama a partir de `master`: \n\n```bash\ngit checkout -b feature/nombre-funcionalidad\n```\n\n2.  Sigue las **Convenciones de Desarrollo**.\n3.  Asegúrate de que tus cambios pasen las pruebas.\n4.  Realiza un `commit` descriptivo y abre un **Pull Request (PR)**.\n\n### Referencia a Guia de contribucion\n\n\u003e[Contributing.md](src/docs/Contributing.md)\n\n---\n\n## 🛡️ Seguridad\n\nLa seguridad es una prioridad. Por favor, asegúrate de:\n\n* Usar siempre **consultas preparadas (PDO)** para interactuar con la base de datos.\n* **Hashear contraseñas** con `password_hash`.\n* **No modificar** archivos críticos como `config/SERVER` o `.htaccess`.\n\n---\n\n## 📄 Licencia\n\nEste proyecto está bajo la Licencia **MIT** - ver el archivo [LICENSE.md](src/docs/LICENSE.MD) para más detalles.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafa-x64%2Fproyecto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafa-x64%2Fproyecto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafa-x64%2Fproyecto/lists"}