ZAJUDEM SOFTWARE

ZAJUDEM 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.

Tecnologías utilizadas

• Frontend: React + Vite (TypeScript)
• Backend: FastAPI (Python), Django REST Framework
• Base de datos: PostgreSQL
• APIs: API RESTful
• Hardware: Arduino (C) con servomotor y otros componentes

🔧 Requisitos

• Python 3.10 o superior
• Node.js 18 o superior
• npm (viene con Node.js)
• postgreSQL

---

⚙️ Instalación

📦 Backend (FastAPI)

1. Abrí una terminal y navegá al directorio del backend:

   cd backend-IA

2. (Opcional pero recomendado) Creá y activá un entorno virtual:

   • En Linux/macOS:

     python -m venv venv
     source venv/bin/activate

   • En Windows:

     python -m venv venv
     venv\Scripts\activate

3. Instalá las dependencias:

   pip install -r requirements.txt

4. Ejecutá el servidor (si usás main.py como entrada):

   uvicorn main:app --reload

---

💻 Frontend (React)

1. Abrí otra terminal y navegá al directorio del frontend:

   cd frontend-IA

2. Instalá las dependencias:

   npm install

3. Iniciá la app en modo desarrollo:

   npm run dev

Base de datos dirigida por Django (postgreSQL)

1. crear un usuario y crearle una contraseña
2. 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

---

Instalación en Arduino

1. Conectar el Arduino y abrir el IDE de Arduino.
2. Subir el código en lenguaje C proporcionado en el directorio arduino/.
3. Conectar el servomotor y otros componentes según el esquema proporcionado.

Uso del sistema

1. Acceso mediante reconocimiento facial: Los profesores pueden acceder al sistema escaneando su rostro.
2. Consulta de aulas disponibles: La plataforma muestra las aulas libres en tiempo real.
3. Visualización de horarios: Se puede consultar el horario de clases por curso.
4. Demostración con hardware: Un Arduino con servomotor puede simular el desbloqueo de una puerta tras la autenticación.

Factor diferencial

• Integración de reconocimiento facial con IA para mejorar la seguridad y eficiencia.
• Gestión optimizada de espacios y horarios en instituciones educativas.
• Uso de hardware (Arduino) para una demostración práctica de acceso seguro.
• Estructura modular que permite escalabilidad y fácil mantenimiento del software.

Contribución

• Etapas de la contribución:

• 1.Planeación: Antes 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).

• 2.Edición: Debe 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).

• 3.Pull Request: Como 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.

• Sintaxis:

• Encabezado:

acción: mencione el proposito del pr.

• Descripción:

En esta parte describa de manera detallada el cambio que hizo y describa los modulos y archivos afectados.

• Ejemplo:
• Encabezado

actualización: mejora en la logica de inicio de sesión

• Descripción:

La 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

• Nota: De 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.

Licencia

Este proyecto está bajo la licencia MIT.

---

Para más información, contacta a Zajudem o revisa la documentación oficial del proyecto.