Tecnologías Clave
- Backend: Laravel 12, PHP 8.2, MySQL
- Autenticación: Laravel Sanctum
- Autorización: Spatie Laravel Permission
- API: RESTful JSON, versionada (v1)
Resumen
Estado del Proyecto
Avance Actual
- ✅ Autenticación y control de acceso completo.
- ✅ CRUD de bitácoras con roles dinámicos.
- ✅ Notas inmutables con adjuntos y firmas.
- ✅ Seeders y colección Postman con datos reales.
Base de
Datos
Diagrama Entidad-Relación
Las notas son inmutables y todas las relaciones respetan borrado en cascada.
API
Documentación de Endpoints (v1)
Autenticación
POST /api/v1/auth/register
Registro de nuevos usuarios (ingenieros). Retorna token sanctum.
POST /api/v1/auth/login
Login con email y password. Retorna token + datos del usuario.
POST /api/v1/auth/logout
Invalida el token actual (requiere Bearer token).
GET /api/v1/user
Devuelve el usuario autenticado.
Bitácoras
GET /api/v1/bitacoras
Listado paginado de bitácoras accesibles por el usuario.
POST /api/v1/bitacoras
Crear bitácora con licencia, vigencias y roles (propietario, contratistas, etc.).
GET /api/v1/bitacoras/{id}
Detalle de bitácora con usuarios y roles.
PUT /api/v1/bitacoras/{id}
Actualización (solo propietario). Permite redefinir roles.
DELETE /api/v1/bitacoras/{id}
Soft delete (solo propietario).
Notas (Inmutables)
GET /api/v1/bitacoras/{id}/notas
Listado paginado de notas de la bitácora.
POST /api/v1/bitacoras/{id}/notas
Crear nota (solo propietario). Las notas resultan inmutables.
GET /api/v1/notas/{id}
Detalle de nota con archivos y firmas.
Roles
Matriz de Roles y Permisos
| Acción | Propietario | Contratista | Supervisor | Coordinador | Testigo |
|---|---|---|---|---|---|
| Ver bitácora | ✅ | ✅ | ✅ | ✅ | ✅ |
| Editar bitácora | ✅ | ❌ | ❌ | ❌ | ❌ |
| Eliminar bitácora | ✅ | ❌ | ❌ | ❌ | ❌ |
| Crear nota | ✅ | ❌ | ❌ | ❌ | ❌ |
| Ver notas | ✅ | ✅ | ✅ | ✅ | ✅ |
| Firmar notas | ❌ | ✅ | ✅ | ✅ | ❌ |
Usuarios
Usuarios de Prueba Disponibles
| Nombre | Correo | Contraseña | Rol Bitácora 1 | Rol Bitácora 2 |
|---|---|---|---|---|
| Ing. Carlos Mendoza | carlos@constructora.com | password123 | Propietario | - |
| Ing. Ana García | ana@constructora.com | password123 | - | Propietario |
| Ing. Luis Rodríguez | luis@constructora.com | password123 | Contratista | Contratista |
| Ing. María López | maria@constructora.com | password123 | Supervisor | Coordinador |
| Arq. Pedro Sánchez | pedro@constructora.com | password123 | Testigo | Testigo |
Roadmap
Próximos Pasos
Módulos en progreso
- Subida y optimización de archivos/fotos.
- Sistema de firmas con verificación por correo.
- Generación automática de PDF e impresión.
- OpenAPI/Swagger y pruebas automáticas.
Móvil & Offline
- UI Flutter web/móvil con datos dummy.
- Modo offline con almacenamiento local.
- Cola de sincronización y resolución de conflictos.
- CI/CD y despliegue multi-ambiente.