Leer esta guía antes de modificar el planificador. Es el mapa breve de su arquitectura, flujo y reglas de mantenimiento.
Toda modificación de código debe reflejarse también en esta guía. Al terminar un cambio:
No dupliques el código en esta guía: documenta responsabilidades, dependencias, contratos entre módulos y comportamientos que un cambio futuro podría romper.
index.html es parte de la arquitectura.app-core.js declara el estado general y las herramientas declaran su lógica en drawing-tools/. Evitar duplicar ese estado o introducir módulos aislados sin actualizar sus consumidores y el orden de carga.id en index.html. Si se renombra o elimina un elemento, actualizar todos sus usos.index.html crea la interfaz y carga Fabric.js y las dependencias externas.app-core.js crea el lienzo Fabric, declara estado e inicializa historial, carga del plano y zoom.canvas-events.js configura modos y despacha los eventos del puntero a la herramienta activa.drawing-tools/ implementan las etapas y objetos de cada herramienta.tool-help.js actualiza las instrucciones visibles cuando cambian el modo, la escala o la etapa de dibujo.dialogs.js, project-files.js y toolbar-actions.js conectan los modales, el almacenamiento/exportación y los controles de la barra lateral.| Archivo | Responsabilidad / punto de entrada |
|---|---|
index.html |
Estructura, estilos, controles, elementos DOM, dependencias CDN y orden de carga. |
js/app-core.js |
Estado compartido, lienzo, historial/deshacer, carga de plano, zoom/paneo y normalización de rótulos direccionales. |
js/canvas-events.js |
setMode, manejadores de mouse y enrutamiento hacia las herramientas. |
js/tool-help.js |
updateToolHelp: texto de ayuda inferior derecha e indicadores de plano/escala. |
js/drawing-tools/measurements.js |
Medición de distancia/radio, formato, etiquetas y normalización de sus estilos. Su fábrica de etiquetas también se usa en zonificación. |
js/drawing-tools/zoning.js |
Perímetros y rótulos de zona, selección por borde y prioridad visual. |
js/drawing-tools/directional-arrows.js |
Dibujo por etapas, ancho y rótulos de viento/propagación. |
js/drawing-tools/attack-line.js |
Tramos de ataque, orientación de lanza, alcance y ancho del chorro, cancelación. |
js/dialogs.js |
Modales de escala, configuración/continuación de línea de ataque y avisos. |
js/project-files.js |
Exportación a imagen/PDF, serialización JSON, proyectos recientes y restauración. |
js/toolbar-actions.js |
Brigadistas, íconos, barra de escala, texto, borrado y teclado. |
assets/garrafa.svg, assets/tablero-electrico.svg, assets/medidor gas.svg, assets/tanque propano.svg, assets/pallet.svg |
Recursos vectoriales usados por los sellos de la barra lateral. |
js/drawing-tools/. Añadir estado global en app-core.js solo si realmente debe compartirse.canvas-events.js para inicio, movimiento, finalización, selección, cursor, limpieza y cancelación. Mantener setMode coherente.js/tool-help.js cada vez que cambien las instrucciones, controles, etapas o requisitos de la herramienta. Actualizarla en cada transición visible llamando a updateToolHelp(). No dejar fases nuevas sin explicación.id correspondientes en index.html; conectar sus acciones en el archivo responsable. Para un diálogo modal, usar dialogs.js.app-core.js y la carga/normalización en project-files.js. Mantener también coherente la restauración de undo() en app-core.js.<script> de index.html. No usar async, defer ni type="module" sin migrar explícitamente el modelo de dependencias.index.html; su contenido dinámico pertenece a tool-help.js.id tool-help-title y tool-help-list son consumidos por updateToolHelp().updateToolHelp(), debe hacerlo después de actualizar el estado para mostrar la fase correcta.dialogs.js; no mezclar esa responsabilidad con el panel contextual.undo() en app-core.js.index.html carga scripts clásicos en orden: app-core.js, tool-help.js, herramientas de dibujo, canvas-events.js, diálogos, archivos de proyecto y acciones de barra.selectable, evented, selección y cursores. No habilitar el arrastre de objetos durante una operación de dibujo si la herramienta necesita capturar el puntero.pixelsPerMeter; los controles deben conservar la validación de escala antes de iniciar esas operaciones.node --check sobre los archivos JavaScript modificados (o sobre todos los .js si se cambió el orden/carga global).