1.2.7. Otros documentos: certificado de fin de obra, boletín de instalación y protocolo de pruebas

# legalizacion_generator.py - Genera plantillas de documentos de legalización en Markdown
# Útil para estandarizar la documentación final de proyectos

import json
from datetime import datetime

class DocumentoLegalizacion:
    """Clase base para generar documentos de legalización."""
    def __init__(self, tipo, proyecto, cliente, ubicacion, tecnico):
        self.tipo = tipo  # "certificado", "boletin", "protocolo"
        self.proyecto = proyecto
        self.cliente = cliente
        self.ubicacion = ubicacion
        self.tecnico = tecnico
        self.fecha = datetime.now().strftime("%d/%m/%Y")

    def generar_markdown(self):
        raise NotImplementedError

class CertificadoFinObra(DocumentoLegalizacion):
    def __init__(self, proyecto, cliente, ubicacion, tecnico, normativa, modificaciones=None):
        super().__init__("certificado", proyecto, cliente, ubicacion, tecnico)
        self.normativa = normativa
        self.modificaciones = modificaciones if modificaciones else []

    def generar_markdown(self):
        doc = f"# CERTIFICADO DE FIN DE OBRA\n\n"
        doc += f"**Proyecto:** {self.proyecto}\n\n"
        doc += f"**Titular:** {self.cliente}\n\n"
        f"**Ubicación:** {self.ubicacion}\n\n"
        doc += f"**Técnico competente:** {self.tecnico}\n\n"
        doc += f"**Fecha:** {self.fecha}\n\n"

        doc += "## 1. Objeto\n\n"
        doc += "El presente certificado tiene por objeto dejar constancia de que la instalación descrita ha sido ejecutada conforme al proyecto aprobado.\n\n"

        doc += "## 2. Normativa aplicada\n\n"
        for n in self.normativa:
            doc += f"- {n}\n"
        doc += "\n"

        if self.modificaciones:
            doc += "## 3. Modificaciones durante la ejecución\n\n"
            for m in self.modificaciones:
                doc += f"- {m}\n"
            doc += "\n"

        doc += "## 4. Declaración\n\n"
        doc += "Por la presente, el técnico que suscribe DECLARA que la instalación está finalizada y es apta para su uso, cumpliendo con la normativa aplicable.\n\n"
        doc += f"Firmado: {self.tecnico}\n\n"
        return doc

class BoletinInstalacion(DocumentoLegalizacion):
    def __init__(self, proyecto, cliente, ubicacion, instalador, potencia, descripcion):
        super().__init__("boletin", proyecto, cliente, ubicacion, instalador)
        self.instalador = instalador
        self.potencia = potencia
        self.descripcion = descripcion

    def generar_markdown(self):
        doc = f"# BOLETÍN DE INSTALACIÓN\n\n"
        doc += f"**Proyecto:** {self.proyecto}\n\n"
        doc += f"**Titular:** {self.cliente}\n\n"
        doc += f"**Ubicación:** {self.ubicacion}\n\n"
        doc += f"**Instalador autorizado:** {self.instalador}\n\n"
        doc += f"**Fecha:** {self.fecha}\n\n"

        doc += "## 1. Características de la instalación\n\n"
        doc += f"- Potencia total instalada: {self.potencia}\n"
        doc += f"- Descripción: {self.descripcion}\n\n"

        doc += "## 2. Declaración\n\n"
        doc += "El instalador que suscribe DECLARA que la instalación ha sido ejecutada según las normas técnicas vigentes y que las pruebas reglamentarias han resultado satisfactorias.\n\n"
        doc += f"Firmado: {self.instalador}\n\n"
        return doc

class ProtocoloPruebas(DocumentoLegalizacion):
    def __init__(self, proyecto, cliente, ubicacion, responsable, pruebas):
        super().__init__("protocolo", proyecto, cliente, ubicacion, responsable)
        self.pruebas = pruebas  # lista de dict con {nombre, procedimiento, resultado, valor_esperado}

    def generar_markdown(self):
        doc = f"# PROTOCOLO DE PRUEBAS\n\n"
        doc += f"**Proyecto:** {self.proyecto}\n\n"
        doc += f"**Instalación:** {self.cliente} - {self.ubicacion}\n\n"
        doc += f"**Responsable de pruebas:** {self.tecnico}\n\n"
        doc += f"**Fecha:** {self.fecha}\n\n"

        doc += "## 1. Equipos de medida utilizados\n\n"
        doc += "| Equipo | Nº serie | Última calibración |\n"
        doc += "|--------|----------|--------------------|\n"
        doc += "| Megger XYZ-100 | 123456 | 15/01/2025 |\n"
        doc += "| Multímetro Fluke 87V | 789012 | 10/02/2025 |\n\n"

        doc += "## 2. Resultados de las pruebas\n\n"
        doc += "| Prueba | Procedimiento | Valor medido | Valor esperado | Resultado |\n"
        doc += "|--------|---------------|--------------|----------------|-----------|\n"
        for p in self.pruebas:
            doc += f"| {p['nombre']} | {p['procedimiento']} | {p['valor']} | {p['esperado']} | {'✅ OK' if p['resultado'] else '❌ NO OK'} |\n"

        doc += "\n## 3. Conclusión\n\n"
        doc += "Todas las pruebas se han realizado con resultado satisfactorio. La instalación cumple con los requisitos reglamentarios y está apta para su puesta en servicio.\n\n"
        doc += f"Firmado: {self.tecnico}\n\n"
        return doc

# --- Ejemplo de uso ---
if __name__ == "__main__":
    # Certificado de fin de obra
    certificado = CertificadoFinObra(
        proyecto="Control de temperatura en reactor R-101",
        cliente="Industrias Químicas del Norte S.A.",
        ubicacion="Polígono Industrial Sur, nave 12, Madrid",
        tecnico="Ing. Laura Gómez (col. 12345)",
        normativa=["UNE-EN 60204-1", "REBT (RD 842/2002)", "IEC 61010"],
        modificaciones=["Sustitución del modelo de transmisor por compatible con HART"]
    )
    certificado.generar_markdown()
    with open("certificado_fin_obra.md", "w") as f:
        f.write(certificado.generar_markdown())

    # Boletín de instalación
    boletin = BoletinInstalacion(
        proyecto="Control de temperatura en reactor R-101",
        cliente="Industrias Químicas del Norte S.A.",
        ubicacion="Polígono Industrial Sur, nave 12, Madrid",
        instalador="Instalaciones Eléctricas López S.L. (RE-1234)",
        potencia="15 kW",
        descripcion="Sistema de control PID con PLC Siemens S7-1200, sensores PT100 y válvula de control DN25."
    )
    with open("boletin_instalacion.md", "w") as f:
        f.write(boletin.generar_markdown())

    # Protocolo de pruebas
    pruebas = [
        {"nombre": "Aislamiento circuitos", "procedimiento": "Medición con megámetro", "valor": "> 50 MΩ", "esperado": "> 1 MΩ", "resultado": True},
        {"nombre": "Continuidad tierra", "procedimiento": "Medición con microhmmeter", "valor": "0.8 Ω", "esperado": "< 1 Ω", "resultado": True},
        {"nombre": "Precisión lazo temperatura", "procedimiento": "Simulación 100°C", "valor": "99.8°C", "esperado": "±0.5°C", "resultado": True}
    ]
    protocolo = ProtocoloPruebas(
        proyecto="Control de temperatura en reactor R-101",
        cliente="Industrias Químicas del Norte S.A.",
        ubicacion="Polígono Industrial Sur, nave 12, Madrid",
        responsable="Ing. Carlos Méndez",
        pruebas=pruebas
    )
    with open("protocolo_pruebas.md", "w") as f:
        f.write(protocolo.generar_markdown())

    print("✅ Documentos generados: certificado_fin_obra.md, boletin_instalacion.md, protocolo_pruebas.md")

Este script genera plantillas de los tres documentos de legalización en formato Markdown, con campos predefinidos que pueden personalizarse para cada proyecto. Es una herramienta excelente para estandarizar la documentación final y evitar omisiones.