https://github.com/oxtornado/senasec
Facial recognition with hardware scope project 📥
https://github.com/oxtornado/senasec
arduino backend cplusplus csharp database-management fastapi frontend python react sql vitest
Last synced: 2 months ago
JSON representation
Facial recognition with hardware scope project 📥
- Host: GitHub
- URL: https://github.com/oxtornado/senasec
- Owner: oxtornado
- Created: 2025-03-15T01:39:12.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-01T14:57:49.000Z (9 months ago)
- Last Synced: 2025-10-01T16:15:32.634Z (9 months ago)
- Topics: arduino, backend, cplusplus, csharp, database-management, fastapi, frontend, python, react, sql, vitest
- Language: TypeScript
- Homepage:
- Size: 46.8 MB
- Stars: 1
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 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:
```bash
cd backend-IA
```
2. (Opcional pero recomendado) Creá y activá un entorno virtual:
- En Linux/macOS:
```bash
python -m venv venv
source venv/bin/activate
```
- En Windows:
```bash
python -m venv venv
venv\Scripts\activate
```
3. Instalá las dependencias:
```bash
pip install -r requirements.txt
```
4. Ejecutá el servidor (si usás `main.py` como entrada):
```bash
uvicorn main:app --reload
```
---
### 💻 Frontend (React)
1. Abrí otra terminal y navegá al directorio del frontend:
```bash
cd frontend-IA
```
2. Instalá las dependencias:
```bash
npm install
```
3. Iniciá la app en modo desarrollo:
```bash
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:**
```sh
acción: mencione el proposito del pr.
```
- **Descripción:**
```sh
En esta parte describa de manera detallada el cambio que hizo y describa los modulos y archivos afectados.
```
- **Ejemplo:**
- **Encabezado**
```sh
actualización: mejora en la logica de inicio de sesión
```
- **Descripción:**
```sh
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](mailto:dnielussa@gmail.com) o revisa la [documentación oficial del proyecto](#).