{"id":26903488,"url":"https://github.com/oxtornado/senasec","last_synced_at":"2026-04-11T05:32:06.597Z","repository":{"id":284995813,"uuid":"948799534","full_name":"oxtornado/senasec","owner":"oxtornado","description":"Facial recognition with hardware scope project 📥","archived":false,"fork":false,"pushed_at":"2025-10-01T14:57:49.000Z","size":49033,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-01T16:15:32.634Z","etag":null,"topics":["arduino","backend","cplusplus","csharp","database-management","fastapi","frontend","python","react","sql","vitest"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/oxtornado.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-03-15T01:39:12.000Z","updated_at":"2025-10-01T14:57:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"af5eeb47-2509-4cf2-8b3b-67c9781a7b5f","html_url":"https://github.com/oxtornado/senasec","commit_stats":null,"previous_names":["oxtornado/zajudem"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oxtornado/senasec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxtornado%2Fsenasec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxtornado%2Fsenasec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxtornado%2Fsenasec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxtornado%2Fsenasec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oxtornado","download_url":"https://codeload.github.com/oxtornado/senasec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxtornado%2Fsenasec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31669668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"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":["arduino","backend","cplusplus","csharp","database-management","fastapi","frontend","python","react","sql","vitest"],"created_at":"2025-04-01T10:28:35.922Z","updated_at":"2026-04-11T05:32:06.591Z","avatar_url":"https://github.com/oxtornado.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ZAJUDEM SOFTWARE\n\nZAJUDEM es un servicio de software desarrollado por la empresa Senasec. Este sistema integra reconocimiento facial con inteligencia artificial para permitir el acceso del profesorado a las instalaciones educativas. Además, proporciona una plataforma para visualizar las aulas disponibles y los horarios de clase junto con sus respectivos cursos.\n\n## Tecnologías utilizadas\n\n- **Frontend:** React + Vite (TypeScript)\n- **Backend:** FastAPI (Python), Django REST Framework\n- **Base de datos:** PostgreSQL\n- **APIs:** API RESTful\n- **Hardware:** Arduino (C) con servomotor y otros componentes\n\n## 🔧 Requisitos\n\n- Python 3.10 o superior\n- Node.js 18 o superior\n- npm (viene con Node.js)\n- postgreSQL \n\n---\n\n## ⚙️ Instalación\n\n### 📦 Backend (FastAPI)\n\n1. Abrí una terminal y navegá al directorio del backend:\n\n    ```bash\n    cd backend-IA\n    ```\n\n2. (Opcional pero recomendado) Creá y activá un entorno virtual:\n\n    - En Linux/macOS:\n\n        ```bash\n        python -m venv venv\n        source venv/bin/activate\n        ```\n\n    - En Windows:\n\n        ```bash\n        python -m venv venv\n        venv\\Scripts\\activate\n        ```\n\n3. Instalá las dependencias:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4. Ejecutá el servidor (si usás `main.py` como entrada):\n\n    ```bash\n    uvicorn main:app --reload\n    ```\n\n---\n\n### 💻 Frontend (React)\n\n1. Abrí otra terminal y navegá al directorio del frontend:\n\n    ```bash\n    cd frontend-IA\n    ```\n\n2. Instalá las dependencias:\n\n    ```bash\n    npm install\n    ```\n\n3. Iniciá la app en modo desarrollo:\n\n    ```bash\n    npm run dev\n    ```\n### Base de datos dirigida por Django (postgreSQL)\n1. crear un usuario y crearle una contraseña\n2. En cuanto se este en la carpeta `db_django` en `settings.py` remplace el usuario existente por el usuario que acaba de crear y por la contraseña del usuario  \n\n\n---\n### Instalación en Arduino\n1. Conectar el Arduino y abrir el IDE de Arduino.\n2. Subir el código en lenguaje C proporcionado en el directorio `arduino/`.\n3. Conectar el servomotor y otros componentes según el esquema proporcionado.\n\n## Uso del sistema\n1. **Acceso mediante reconocimiento facial:** Los profesores pueden acceder al sistema escaneando su rostro.\n2. **Consulta de aulas disponibles:** La plataforma muestra las aulas libres en tiempo real.\n3. **Visualización de horarios:** Se puede consultar el horario de clases por curso.\n4. **Demostración con hardware:** Un Arduino con servomotor puede simular el desbloqueo de una puerta tras la autenticación.\n\n## Factor diferencial\n- Integración de **reconocimiento facial con IA** para mejorar la seguridad y eficiencia.\n- **Gestión optimizada de espacios y horarios** en instituciones educativas.\n- **Uso de hardware (Arduino)** para una demostración práctica de acceso seguro.\n- **Estructura modular** que permite escalabilidad y fácil mantenimiento del software.\n\n## Contribución \n- **Etapas de la contribución:**\n- **1.Planeación:**\nAntes de hacer una contribución haga el ejercicio de plantear y formular de manera adecuada el cambio que va a realizar (actualizar, añadir o eliminar).\n\n- **2.Edición:**\nDebe tener en cuenta que por motivos de optimización y mantenimientó del software la edición del codigo para actualizar, añadir o eliminar debe realizarce de manera puntual afectando la menor cantidad de modulos y archivos (se espera *un* cambio que solucione *un* problema).\n\n- **3.Pull Request:**\nComo se menciona en el apartado **\"Edición\"** se espera que las contribuciones den solución a *un* problema especifico, asi mismo el Pull Request debe contener *un* cambio a ser valorado, esto con el fin de tener una mejor estructura y una mejor lectura de historial.\n- **Sintaxis:**\n- **Encabezado:**\n```sh\nacción: mencione el proposito del pr.\n```\n- **Descripción:**\n```sh\nEn esta parte describa de manera detallada el cambio que hizo y describa los modulos y archivos afectados.\n```\n\n- **Ejemplo:**\n- **Encabezado**\n```sh\nactualización: mejora en la logica de inicio de sesión\n```\n- **Descripción:**\n```sh\nLa logica del inicio de sesión no sera vulnerable a inyecciones SQL debido a la importacion de la libreria \"nombre de la libreria\" en la direccion /user/login/login.php\n```\n\n- **Nota:**\nDe ser posible espere que un integrante del grupo acepte el pr, en dado caso de aceptar un pr que cause problemas en producción la persona que acepto ese pr asumira las consecuncias dando solución al problema generado.\n\n## Licencia\nEste proyecto está bajo la licencia MIT.\n\n---\nPara más información, contacta a [Zajudem](mailto:dnielussa@gmail.com) o revisa la [documentación oficial del proyecto](#).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxtornado%2Fsenasec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxtornado%2Fsenasec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxtornado%2Fsenasec/lists"}