chore: estructura inicial del MVP

Backend (Express + MariaDB) y frontend (React + Vite, identidad Fluent/Windows) con el nucleo funcional: seguridad, organizacion, proyectos, actividades, subtareas, dependencias, dashboard, calendario, gantt, comentarios, adjuntos, notificaciones in-app y catalogos. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-03 08:37:58 -05:00
commit 1d22adc42e
135 changed files with 10913 additions and 0 deletions
@@ -0,0 +1,79 @@
+# API - project.linkedcorp.net
+
+## Base URL
+
+- Desarrollo: `http://localhost:4019/api`
+- Producción: `https://project.linkedcorp.net/api` (pendiente de deploy)
+
+## Autenticacion
+
+- Tipo: Bearer JWT (`Authorization: Bearer <token>`), emitido por `/api/auth/login`.
+- El backend revalida `is_active` del usuario en cada request (no solo la firma del JWT).
+
+## Formato de respuesta
+
+```json
+{
+  "success": true,
+  "data": {},
+  "error": null
+}
+```
+
+## Endpoints principales
+
+### Auth
+- `POST /api/auth/login` — `{ email, password }` → `{ token, user }`
+- `POST /api/auth/logout`
+- `GET /api/auth/me` — usuario actual
+
+### Usuarios (`/api/users`) — solo Administrador
+- `GET /api/users` · `POST /api/users` · `GET /api/users/:id` · `PUT /api/users/:id` · `PATCH /api/users/:id/active`
+
+### Departamentos (`/api/departments`)
+- `GET /api/departments` (árbol) · `POST /api/departments` · `PUT /api/departments/:id` · `DELETE /api/departments/:id`
+
+### Proyectos (`/api/projects`)
+- `GET /api/projects` (filtros: estado, responsable, prioridad) · `POST /api/projects`
+- `GET /api/projects/:id` · `PUT /api/projects/:id`
+- `POST /api/projects/:id/members` · `DELETE /api/projects/:id/members/:userId`
+
+### Actividades (`/api/activities`)
+- `GET /api/projects/:projectId/activities` · `POST /api/projects/:projectId/activities`
+- `GET /api/activities/:id` · `PUT /api/activities/:id`
+- `POST /api/activities/:id/dependencies` · `DELETE /api/activities/:id/dependencies/:dependsOnId`
+
+### Subtareas (`/api/activities/:activityId/subtasks`)
+- `GET` · `POST` · `PUT /api/subtasks/:id` · `PATCH /api/subtasks/:id/done` · `DELETE /api/subtasks/:id`
+
+### Comentarios (`/api/comments`)
+- `GET /api/comments?entityType=project&entityId=1` · `POST /api/comments`
+
+### Adjuntos (`/api/attachments`)
+- `GET /api/attachments?entityType=activity&entityId=1` · `POST /api/attachments` (multipart)
+- `GET /api/attachments/:id/download` · `DELETE /api/attachments/:id`
+
+### Notificaciones (`/api/notifications`)
+- `GET /api/notifications` · `PATCH /api/notifications/:id/read` · `PATCH /api/notifications/read-all`
+
+### Dashboard (`/api/dashboard`)
+- `GET /api/dashboard/summary` — KPIs (activos, atrasados, pendientes/vencidas/hoy, avance promedio)
+- `GET /api/dashboard/calendar?month=2026-09` — actividades por fecha límite
+- `GET /api/projects/:id/gantt` — actividades con fechas/avance para el Gantt
+
+### Catálogos (`/api/catalogs`) — lectura general, escritura solo Administrador
+- `GET/POST/PUT/DELETE /api/catalogs/project-statuses`
+- `GET/POST/PUT/DELETE /api/catalogs/activity-statuses`
+- `GET/POST/PUT/DELETE /api/catalogs/priorities`
+- `GET/POST/PUT/DELETE /api/catalogs/project-types`
+
+### Auditoría (`/api/audit`) — solo Administrador / Jefe de TI
+- `GET /api/audit?entityType=project&entityId=1`
+
+## Errores esperados
+
+- `400` validación
+- `401` no autenticado / token inválido o expirado
+- `403` sin permisos para la acción (según rol)
+- `404` no encontrado (incluye cuando el recurso existe pero no pertenece al usuario/alcance)
+- `500` error interno (sanitizado, sin detalle de stack en producción)