dobacksoft-stabilsafe

name	dobacksoft-stabilsafe
description	Enforces DobackSoft/StabilSafe V3 conventions: API via frontend/src/config/api.ts, logger (no console.log), organizationId on requests, ports 9998/5174, iniciar.ps1 as sole startup, Windows/PowerShell, immutable menu modules, PDF export flow. Use when editing backend, frontend, or docs in this repo or when the user mentions DobackSoft, StabilSafe, iniciar.ps1, or project rules.

DobackSoft (StabilSafe V3) — Convenciones de proyecto

Cuándo aplicar: Al editar código o docs de este repo, o cuando el usuario cite reglas del proyecto, DobackSoft o iniciar.ps1. Para auth, multi-tenant, DoD y rutas por ámbito ver AGENTS.md en la raíz.

Actuar como programador en pareja: explicar qué se va a hacer y por qué antes de editar. Respetar modularidad, roles y flujo del producto.

Reglas críticas (no violar)

Regla	Acción
Inicio del sistema	NUNCA iniciar backend/frontend; el usuario usa iniciar.ps1
URLs y API	NUNCA hardcodear URLs; usar frontend/src/config/api.ts
Logging	NUNCA console.log; usar logger de utils/logger
Puertos	Backend 9998, frontend 5174 — no cambiar
Menú	No crear módulos fuera del menú oficial V3
Datos	No exponer datos entre organizaciones; siempre filtro organizationId
Dependencias	No usar >300 KB sin justificar

Código

• Un archivo por turno; un diff agrupado por archivo. Formato: // ... existing code ... donde aplique.
• Antes de editar: leer contexto (imports, funciones relacionadas). No código basura ni hashes largos. Máximo 3 intentos por error; si falla, pedir ayuda al usuario.
• Config: TypeScript estricto (no any sin justificación). Headers con organizationId en requests. Timeout configurable en API.

Entorno y comandos

• Windows: scripts PowerShell (p. ej. iniciar.ps1), rutas Windows (\), comandos compatibles con PowerShell.
• Salida de comandos: añadir | cat cuando sea útil (git log, head, less). Procesos largos en segundo plano. Proponer comandos y pedir confirmación antes de ejecutar.

Menú oficial V3 (inmutable)

• Panel de Control | Estabilidad | Telemetría (CAN/GPS) | IA | Geofences | Operaciones | Reportes | Administración (ADMIN) | Base de Conocimiento (ADMIN) | Mi Cuenta.

Diseño: React + Tailwind, Leaflet + TomTom para mapas. KPIs protagonistas en Panel; scroll solo donde haga falta. Comparadores: solo Estabilidad o solo CAN/GPS según módulo.

Flujo obligatorio

Subida → Procesamiento automático → Visualización → Comparación → Exportación. PDF en 1 clic desde Panel, Sesiones, IA y comparadores.

Checklist rápida por cambio

Antes de cerrar un cambio, comprobar:

• Modularidad y menú oficial V3
• Scroll solo donde haga falta; comparadores correctos (Estabilidad vs CAN/GPS)
• Roles ADMIN/MANAGER; flujo Subida→Exportación; PDF en 1 clic
• config/api.ts (no URLs hardcodeadas); logger (no console.log); filtro organizationId
• Compatible con iniciar.ps1 (no iniciar backend/frontend por cuenta propia)

Ejemplos

Evitar	Usar
const base = 'http://localhost:9998'	import { apiBaseUrl } from '@/config/api' (o equivalente del proyecto)
console.log('debug', x)	logger.debug('debug', { x }) (desde utils/logger)
Lanzar npm run dev en backend/frontend	Recordar al usuario que use iniciar.ps1

Verificación en navegador

Cuando el usuario pida comprobar algo en el navegador (Swagger UI, login, pantallas), usar el MCP de navegador (cursor-ide-browser o chrome-devtools): listar pestañas, navegar a la URL (p. ej. http://localhost:9998/api-docs/), tomar snapshot para ver el contenido. Detalle del flujo lock/unlock y URLs: reference.md.

Más detalle

Módulos, métricas por área y checklist extendida: reference.md.