"""
dev_notes.py — note di sviluppo visibili all'avvio di Linker solo in DEV mode.

Aggiornare DEV_NOTES con nuove annotazioni. Rimuovere quando risolte.
"""
from PyQt6.QtWidgets import QDialog, QVBoxLayout, QTextEdit, QPushButton, QLabel
from PyQt6.QtGui import QFont

DEV_NOTES = """
╔══════════════════════════════════════════════════════════════════╗
║                    NOTE DI SVILUPPO — LINKER                     ║
╚══════════════════════════════════════════════════════════════════╝

── PRODUCT ANNOTATIONS — stato 2026-06-26 ───────────────────────────

  FATTO: tabella in linker.db (1652 record migrati da INFO_GLOBAL),
         metodi DB: ensure_product_annotations(), get/save_product_annotation()
         OTT: NOTA ICR, NETWORK FREE, FORNITORE DIRITTI gia' esposti (2026-06-22)

  TODO: esporre le 3 colonne anche in Linker, Aggancio, InScadenza.
  TODO: aggiornare annotazioni per RIFER dopo aggancia OTT (secondo pass).

── STANDARDIZZAZIONE FOGLI — TODO residui ──────────────────────────

  • Linker + In Scadenza: aggiungere double-click URL (come Agg. Multiplo)
  • In Scadenza: aggiungere tasto destro su cella (come Agg. Multiplo)
  • Box Prossime Uscite: aggiungere FilterBar
  • Box Prossime Uscite: aggiungere Valutazioni Gemma (16 colonne da LINKER_VALUTAZIONE)
    -- foglio non eredita LinkerSheetBase -> richiede innesto logica da zero
  • OTT: aggiungere Export Excel
  • Gemma: aggiungere tasto destro su cella

── PARQUET AGGREGATI — Layer 3 (implementato 2026-06-16) ───────────

  • TODO: linker_sheet.py usa ancora read_parquet(emesso.parquet) L2
    direttamente (righe ~639, ~878) — migrare a emesso_agg.parquet L3.

────────────────────────────────────────────────────────────────────
"""


def show_dev_notes(dev_mode: bool, parent=None):
    """Mostra il dialogo note di sviluppo. No-op se non in DEV mode."""
    if not dev_mode:
        return
    dlg = QDialog(parent)
    dlg.setWindowTitle("⚠  DEV MODE — Note di sviluppo")
    dlg.setMinimumSize(640, 480)
    dlg.setModal(True)

    lay = QVBoxLayout(dlg)
    lay.setSpacing(10)
    lay.setContentsMargins(14, 14, 14, 14)

    lbl = QLabel("Annotazioni attive — rimuovile da dev_notes.py quando risolte.")
    lbl.setFont(QFont("Calibri", 9))
    lbl.setStyleSheet("color: #996600;")
    lay.addWidget(lbl)

    txt = QTextEdit()
    txt.setReadOnly(True)
    txt.setFont(QFont("Consolas", 9))
    txt.setStyleSheet("background:#FFFDE7; border: 1px solid #F9A825;")
    txt.setPlainText(DEV_NOTES.strip())
    lay.addWidget(txt, stretch=1)

    btn = QPushButton("OK — ho letto")
    btn.setMinimumHeight(34)
    btn.setFont(QFont("Calibri", 10))
    btn.clicked.connect(dlg.accept)
    lay.addWidget(btn)

    dlg.exec()