{"id":24482008,"url":"https://github.com/alejok0/control-estudiantes-mindbox","last_synced_at":"2026-04-17T03:02:06.332Z","repository":{"id":273475622,"uuid":"919829593","full_name":"Alejok0/control-estudiantes-mindbox","owner":"Alejok0","description":"Proyecto para registrar numeros de control de alumnos en Mindbox desde app en Flutter api en PHP y base de datos en MySQL escaneando la credencial de Mindbox","archived":false,"fork":false,"pushed_at":"2025-01-21T05:51:09.000Z","size":283,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T06:26:01.428Z","etag":null,"topics":["api-rest","flutter-app","mindbox","mysql","php"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alejok0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-01-21T05:03:35.000Z","updated_at":"2025-01-21T05:51:12.000Z","dependencies_parsed_at":"2025-01-21T06:36:49.563Z","dependency_job_id":null,"html_url":"https://github.com/Alejok0/control-estudiantes-mindbox","commit_stats":null,"previous_names":["alejok0/control-estudiantes-mindbox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alejok0%2Fcontrol-estudiantes-mindbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alejok0%2Fcontrol-estudiantes-mindbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alejok0%2Fcontrol-estudiantes-mindbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alejok0%2Fcontrol-estudiantes-mindbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alejok0","download_url":"https://codeload.github.com/Alejok0/control-estudiantes-mindbox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243632644,"owners_count":20322433,"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":["api-rest","flutter-app","mindbox","mysql","php"],"created_at":"2025-01-21T12:12:11.711Z","updated_at":"2026-04-17T03:02:01.274Z","avatar_url":"https://github.com/Alejok0.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Proyecto de Registro y Validación de Estudiantes\n\nEste repositorio contiene tres componentes principales: una API REST desarrollada en PHP, una aplicación móvil creada con Flutter y una base de datos para almacenar la información de los estudiantes.\n\n## Estructura del Repositorio\n\n- **API REST**: Proporciona los endpoints necesarios para la validación y el registro de estudiantes.\n- **Aplicación Móvil**: Una app que permite escanear códigos QR, validar credenciales y registrar estudiantes.\n- **Base de Datos**: Diseño y configuración para almacenar la información de los estudiantes.\n\n---\n\n## Requisitos Previos\n\n- **Servidor Web**: Recomendado [XAMPP](https://www.apachefriends.org/) o [WAMP](https://www.wampserver.com/).\n- **PHP**: Versión 7.4 o superior.\n- **MySQL**: Versión 5.7 o superior.\n- **Flutter**: Última versión estable.\n- **Composer**: Para gestionar dependencias de PHP.\n- **Android Studio o Xcode**: Para la compilación y ejecución de la aplicación móvil.\n\n---\n\n## Instalación\n\n### 1. Configuración de la Base de Datos\n\n1. Crea una base de datos llamada `control-mindbox`.\n2. Importa el archivo `control-mindbox.sql` incluido en el repositorio a través de phpMyAdmin u otra herramienta de gestión de bases de datos.\n\n```bash\n# Importación con MySQL\nmysql -u root -p control-mindbox \u003c control-mindbox.sql\n```\n\n### 2. Configuración de la API REST\n\n1. Coloca los archivos PHP de la API en el directorio raíz de tu servidor web (por ejemplo, `htdocs` para XAMPP).\n2. Modifica las credenciales de la base de datos en los scripts PHP (`api_numero_control.php` y `api_datos_credencial.php`):\n\n```php\n$db_host = \"localhost\";\n$db_user = \"root\";\n$db_pass = \"tu_contraseña\";\n$db_name = \"control-mindbox\";\n```\n\n3. Verifica que el servidor tenga habilitada la extensión `cURL` de PHP.\n\n### 3. Configuración de la Aplicación Móvil\n\n1. Asegúrate de tener Flutter instalado y configurado.\n2. Abre el directorio de la app móvil en tu IDE (Android Studio o VS Code).\n3. Modifica el archivo `QRScannerScreen.dart` para apuntar a tu API:\n\n```dart\nconst baseUrl = \"https://tu-servidor.com/\";\n```\n\n4. Ejecuta la app en un dispositivo o emulador:\n\n```bash\nflutter run\n```\n\n---\n\n## Endpoints de la API REST\n\n### Registro de Estudiantes\n\n**URL**: `/api_numero_control.php`\n\n**Método**: `GET`\n\n**Parámetros**:\n- `num` (string): Número de control del estudiante.\n\n**Respuesta**:\n```json\n{\n  \"success\": true,\n  \"message\": \"Número registrado exitosamente.\"\n}\n```\n\n---\n\n### Validación de Credenciales\n\n**URL**: `/api_datos_credencial.php`\n\n**Método**: `GET`\n\n**Parámetros**:\n- `qr_data` (string): Información del código QR.\n\n**Respuesta**:\n```json\n{\n  \"name\": \"Juan Pérez\",\n  \"matricula\": \"12345678\",\n  \"curp\": \"CURP1234567890\",\n  \"grado\": \"1\",\n  \"plan_estudios\": \"Octavo\",\n  \"vigencia\": \"2025-12-31\",\n  \"cadena_digital\": \"ABCDEF123456\"\n}\n```\n\n---\n\n## Uso de la Aplicación Móvil\n\n1. Abre la aplicación en tu dispositivo.\n2. Escanea el código QR de un estudiante.\n3. Valida la credencial y, si es correcta, registra al estudiante para otorgar beneficios.\n\n---\n\n## Licencia\n\nEste proyecto está bajo la Licencia GNU GENERAL PUBLIC LICENSE. Consulta el archivo `LICENSE` para más detalles.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falejok0%2Fcontrol-estudiantes-mindbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falejok0%2Fcontrol-estudiantes-mindbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falejok0%2Fcontrol-estudiantes-mindbox/lists"}