1.2.2. Planos

# planos_manager.py - Herramienta para gestionar el listado de planos de un proyecto
# Genera índices, referencias cruzadas y verifica consistencia

import json
import os
from datetime import datetime

class Plano:
    """Clase que representa un plano del proyecto."""
    def __init__(self, codigo, titulo, tipo, formato, escala, referencias=None):
        self.codigo = codigo          # ej: "PL-01", "ES-03"
        self.titulo = titulo
        self.tipo = tipo              # "emplazamiento", "general", "detalle", "esquema"
        self.formato = formato        # "A1", "A2", "A3", "A4"
        self.escala = escala          # "1:100", "1:50", etc.
        self.referencias = referencias if referencias else []  # códigos de otros planos referenciados
        self.revision = "00"
        self.fecha = datetime.now().strftime("%d/%m/%Y")

    def to_dict(self):
        return {
            "codigo": self.codigo,
            "titulo": self.titulo,
            "tipo": self.tipo,
            "formato": self.formato,
            "escala": self.escala,
            "referencias": self.referencias,
            "revision": self.revision,
            "fecha": self.fecha
        }

class ProyectoPlanos:
    """Gestiona el conjunto de planos del proyecto."""
    def __init__(self, nombre_proyecto):
        self.nombre = nombre_proyecto
        self.planos = []

    def agregar_plano(self, plano):
        self.planos.append(plano)

    def generar_indice(self):
        """Genera un índice de planos en formato Markdown."""
        indice = f"# ÍNDICE DE PLANOS\n\n**Proyecto:** {self.nombre}\n\n"
        indice += "| Código | Título | Tipo | Formato | Escala | Revisión | Fecha |\n"
        indice += "|--------|--------|------|---------|--------|----------|-------|\n"
        for p in self.planos:
            indice += f"| {p.codigo} | {p.titulo} | {p.tipo} | {p.formato} | {p.escala} | {p.revision} | {p.fecha} |\n"
        return indice

    def verificar_referencias(self):
        """Comprueba que todas las referencias entre planos sean válidas."""
        codigos_existentes = {p.codigo for p in self.planos}
        errores = []
        for p in self.planos:
            for ref in p.referencias:
                if ref not in codigos_existentes:
                    errores.append(f"Plano {p.codigo} referencia a {ref} que no existe")
        return errores

    def generar_informe(self):
        """Genera un informe completo de la documentación de planos."""
        informe = f"=== INFORME DE PLANOS ===\nProyecto: {self.nombre}\nTotal planos: {len(self.planos)}\n\n"
        informe += self.generar_indice()
        errores = self.verificar_referencias()
        if errores:
            informe += "\n## ERRORES DE REFERENCIA\n"
            for err in errores:
                informe += f"- {err}\n"
        else:
            informe += "\n✅ Todas las referencias son válidas.\n"
        return informe

    def guardar_json(self, archivo):
        with open(archivo, 'w', encoding='utf-8') as f:
            json.dump([p.to_dict() for p in self.planos], f, indent=2, ensure_ascii=False)
        print(f"✅ Planos exportados a {archivo}")

# --- Ejemplo de uso ---
if __name__ == "__main__":
    proyecto = ProyectoPlanos("Planta de Tratamiento de Aguas")

    # Crear planos típicos
    p1 = Plano("PL-01", "Emplazamiento general de la planta", "emplazamiento", "A1", "1:500")
    p2 = Plano("PL-02", "Plano general de instrumentación", "general", "A2", "1:100")
    p3 = Plano("PL-03", "Detalle armario de control", "detalle", "A3", "1:10")
    p4 = Plano("ES-01", "Esquema eléctrico de potencia", "esquema", "A3", "S/E")
    p5 = Plano("ES-02", "Esquema de control (PLC)", "esquema", "A3", "S/E", referencias=["PL-02", "ES-01"])

    for p in [p1, p2, p3, p4, p5]:
        proyecto.agregar_plano(p)

    print(proyecto.generar_informe())
    proyecto.guardar_json("planos_proyecto.json")

Este script gestiona el listado de planos de un proyecto, generando índices, verificando referencias cruzadas y exportando a JSON. Es una herramienta útil para mantener la documentación organizada y consistente.