{"id":18990275,"url":"https://github.com/unix-user/authmkphp","last_synced_at":"2025-04-22T11:14:02.444Z","repository":{"id":60392657,"uuid":"542838873","full_name":"Unix-User/AuthMKPHP","owner":"Unix-User","description":"syncs user and product data between pppoe servers on mikrotik devices using PHP","archived":false,"fork":false,"pushed_at":"2025-03-13T20:53:53.000Z","size":630,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-17T00:15:03.658Z","etag":null,"topics":["laravel","mikrotik","php","vue","vue3","vuejs"],"latest_commit_sha":null,"homepage":"https://authmkphp.udianix.com.br/","language":"Vue","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/Unix-User.png","metadata":{"files":{"readme":"README-ES.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}},"created_at":"2022-09-28T23:54:27.000Z","updated_at":"2025-03-13T20:52:27.000Z","dependencies_parsed_at":"2025-01-31T08:26:39.623Z","dependency_job_id":"c1d7a73c-6448-4e08-b25f-e1d547976721","html_url":"https://github.com/Unix-User/AuthMKPHP","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Unix-User%2FAuthMKPHP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Unix-User%2FAuthMKPHP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Unix-User%2FAuthMKPHP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Unix-User%2FAuthMKPHP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Unix-User","download_url":"https://codeload.github.com/Unix-User/AuthMKPHP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250228687,"owners_count":21395958,"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","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":["laravel","mikrotik","php","vue","vue3","vuejs"],"created_at":"2024-11-08T17:09:24.212Z","updated_at":"2025-04-22T11:14:02.396Z","avatar_url":"https://github.com/Unix-User.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/Unix-User/AuthMKPHP\" target=\"_blank\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/38821945/192930836-6be0ee28-7206-4651-a18c-da7e8ab99a11.svg\" width=\"400\" alt=\"Logotipo AuthMKPHP\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \n  [Português](README-PT.md) | [English](README.md)\n  \n\u003c/p\u003e\n\n## Acerca de AuthMKPHP\n\nAuthMKPHP es una aplicación web construida con Laravel y Vue.js, diseñada para optimizar la gestión de usuarios y perfiles en servidores PPPoE de dispositivos Mikrotik. Proporciona una interfaz amigable para gestionar usuarios y sus dispositivos asociados, mejorando la eficiencia y centralizando la administración.\n\n## Instalación y Configuración\n\nEsta sección le guía a través de la configuración de AuthMKPHP en su sistema.\n\n### Prerrequisitos\n\nAntes de comenzar, asegúrese de tener lo siguiente instalado y configurado en su sistema:\n\n* **PHP:** Versión 8.2 o superior. Además, asegúrese de que las siguientes extensiones de PHP estén habilitadas: BCrypt, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML y sockets. El archivo `composer.json` especifica `^8.2.0`, así que asegúrese de tener al menos PHP 8.2 instalado.\n* **Composer:** El gestor de dependencias de PHP. Puede descargarlo desde [https://getcomposer.org/](https://getcomposer.org/).\n* **Node.js y npm:** Node.js y npm son necesarios para gestionar las dependencias de JavaScript y compilar los assets del frontend. Descárguelos desde [https://nodejs.org/](https://nodejs.org/).\n\n\n### Configuración para Desarrollo\n\nEstos pasos configurarán AuthMKPHP para el desarrollo local.\n\n1. **Clonar el repositorio:** Clone el repositorio AuthMKPHP a su máquina local usando Git:\n   ```bash\n   git clone https://github.com/Unix-User/AuthMKPHP.git\n   cd AuthMKPHP\n   ```\n\n2. **Instalar dependencias:** Instale las dependencias PHP y JavaScript necesarias usando Composer y npm:\n   ```bash\n   composer install\n   npm install\n   ```\n\n3. **Configurar variables de entorno:** Cree un archivo `.env` copiando el archivo `.env.example`. Este archivo contiene varias configuraciones para su aplicación. Necesitará configurar lo siguiente:\n\n    * **Credenciales de la Base de Datos:** Especifique los detalles de conexión de su base de datos, incluyendo el hostname, nombre de la base de datos, nombre de usuario y contraseña. Para el desarrollo local, puede usar SQLite para simplificar.\n    * **Claves API:** Si la aplicación utiliza alguna API externa (por ejemplo, pasarelas de pago, servicios de mensajería), necesitará proporcionar las claves API necesarias aquí.\n    * **Otras Configuraciones:** Otras configuraciones pueden incluir URLs de la aplicación, configuraciones de correo electrónico y otros parámetros específicos de la aplicación. Consulte el archivo `.env.example` para obtener una lista completa de variables y sus descripciones.\n\n4. **Vincular el directorio de almacenamiento:** Cree el enlace simbólico para el directorio de almacenamiento para que sus archivos subidos sean accesibles desde la web:\n   ```bash\n   php artisan storage:link\n   ```\n\n5. **Generar clave de aplicación:** Genere una clave de aplicación única para seguridad:\n   ```bash\n   php artisan key:generate\n   ```\n\n6. **Ejecutar las migraciones de la base de datos:** Aplique las migraciones de la base de datos para crear las tablas necesarias:\n   ```bash\n   php artisan migrate\n   ```\n\n7. **Iniciar el servidor de desarrollo:** Inicie el servidor de desarrollo para ejecutar la aplicación:\n   ```bash\n   npm run dev\n   ```\n\n### Configuración para Producción\n\nPara desplegar AuthMKPHP en un entorno de producción, siga estos pasos:\n\n1. **Siga los pasos 1-3 de la sección Configuración para Desarrollo.**\n\n2. **Ejecutar las migraciones de la base de datos con seeding:** Ejecute las migraciones de la base de datos y llene la base de datos con datos iniciales (si es necesario):\n   ```bash\n   php artisan migrate:fresh\n   php artisan db:seed\n   ```\n\n3. **Compilar assets para producción:** Compile los assets frontend para un rendimiento optimizado en producción:\n   ```bash\n   npm run build\n   ```\n\n4. **Desplegar:** Despliegue la aplicación en su servidor web elegido. El proceso de despliegue variará dependiendo de su proveedor de hosting e infraestructura. Consulte la documentación de su proveedor de hosting para obtener instrucciones específicas.\n\n\n## Funcionalidades\n\nAuthMKPHP ofrece las siguientes funcionalidades (algunas aún en desarrollo):\n\n- [x] **Despliegue Automatizado:** El despliegue automatizado está configurado usando GitHub Actions.\n- [ ] **Documentación Completa:** Documentación detallada está planeada para futuras versiones.\n- [x] **Operaciones CRUD Básicas:** Proporciona funcionalidades básicas de Crear, Leer, Actualizar y Eliminar (CRUD) para gestionar usuarios y dispositivos.\n- [ ] **Integración con Chat de Telegram:** La integración con Telegram para notificaciones y comunicación está planeada.\n- [ ] **Integración con la API de PagSeguro:** La integración con la pasarela de pago PagSeguro está planeada.\n- [ ] **Integración con la API de Mercado Pago:** La integración con la pasarela de pago Mercado Pago está planeada.\n- [x] **Integración con la API de Mikrotik:** Integración robusta con la API de Mikrotik para la gestión de dispositivos.\n\n\n## Patrocinadores\n\nEstamos buscando activamente patrocinadores para apoyar el desarrollo continuo y la mejora de AuthMKPHP. Su contribución nos ayudará a entregar una aplicación más robusta y rica en funcionalidades.\n\n### Socios\n\nAgradecemos las asociaciones para colaborar en el desarrollo y expansión de AuthMKPHP. Si está interesado en convertirse en socio, visite [udianix.com.br](udianix.com.br).\n\n\n## Contribuyendo\n\n¡Animamos las contribuciones a AuthMKPHP! Por favor, revise nuestras directrices de contribución antes de enviar un pull request.\n\n\n## Vulnerabilidades de Seguridad\n\nSi descubre una vulnerabilidad de seguridad, por favor, repórtela de manera responsable creando un issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funix-user%2Fauthmkphp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funix-user%2Fauthmkphp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funix-user%2Fauthmkphp/lists"}