#!/usr/bin/env python3
"""
Generate an HTML landing page (dashboard) for demo-epb.

Scans the repo for Word documents, reports, code, tests, architecture, and
writes build/index.html with clickable links.

Run after `make test && make coverage && make docs && make test-report &&
python3 tools/traceability.py publish docs/traceability &&
python3 tools/render_plantuml.py`.

Output:
  build/index.html   — standalone, open in a browser

Use in the release bundle:
  - Lives at demo-epb-vX.Y.Z/index.html
  - Links to all other bundle contents using relative paths
"""
from __future__ import annotations

import datetime
import html
import os
import re
import subprocess
from pathlib import Path

REPO = Path(__file__).resolve().parent.parent
BUILD = REPO / "build"


def count_files(pattern: str, base: Path = REPO) -> int:
    return sum(1 for _ in base.glob(pattern))


def git_info() -> tuple[str, str]:
    try:
        sha = subprocess.check_output(
            ["git", "rev-parse", "--short", "HEAD"], cwd=str(REPO),
            text=True).strip()
    except Exception:
        sha = "?"
    try:
        tag = subprocess.check_output(
            ["git", "describe", "--tags", "--abbrev=0"], cwd=str(REPO),
            text=True, stderr=subprocess.DEVNULL).strip()
    except Exception:
        tag = "(no tag)"
    return sha, tag


def count_doorstop_items(directory: str) -> int:
    return count_files(f"{directory}/*.md")


def count_tests() -> int:
    total = 0
    for f in (REPO / "tests" / "unit").glob("test_*.c"):
        text = f.read_text()
        total += len(re.findall(r"TEST_BEGIN\(", text))
    return total


def collect_docs(rel_dir: str, in_release: bool = False) -> list[tuple[str, str]]:
    """Return [(display_name, href)] for all .docx in a directory."""
    out = []
    d = REPO / rel_dir
    if not d.exists():
        return out
    for f in sorted(d.glob("*.docx")):
        href = os.path.relpath(f, REPO)
        out.append((f.stem, href))
    return out


def kpi_card(label: str, value: str, sub: str = "", color: str = "#1f3864") -> str:
    return f"""
    <div class='kpi'>
      <div class='kpi-value' style='color:{color}'>{html.escape(value)}</div>
      <div class='kpi-label'>{html.escape(label)}</div>
      <div class='kpi-sub'>{html.escape(sub)}</div>
    </div>
    """


def doc_section(title: str, docs: list[tuple[str, str]], description: str = "") -> str:
    if not docs:
        items = "<li class='cnt'>— no documents —</li>"
    else:
        items = "\n".join(
            f'<li><a href="{html.escape(href)}">{html.escape(name)}</a></li>'
            for name, href in docs
        )
    return f"""
    <section>
      <h2>{html.escape(title)}</h2>
      {f"<p class='cnt'>{html.escape(description)}</p>" if description else ""}
      <ul>{items}</ul>
    </section>
    """


def report_link(name: str, href: str, exists: bool, desc: str) -> str:
    cls = "ok" if exists else "missing"
    label = name + ("" if exists else " (not generated — run coverage/build)")
    if exists:
        return (f"<li><a href='{html.escape(href)}'>{html.escape(label)}</a> "
                f"<span class='cnt'>— {html.escape(desc)}</span></li>")
    return f"<li class='{cls}'>{html.escape(label)} <span class='cnt'>— {html.escape(desc)}</span></li>"


def main() -> int:
    BUILD.mkdir(parents=True, exist_ok=True)
    sha, tag = git_info()
    now = datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="seconds")

    # Counts
    n_sg  = count_doorstop_items("safety/sg")
    n_sys = count_doorstop_items("reqs/sys")
    n_swe = count_doorstop_items("reqs/swe")
    n_sa  = count_doorstop_items("arch/sys")
    n_swa = count_doorstop_items("arch/swe")
    n_tests = count_tests()
    n_impl  = sum(1 for f in (REPO / "src").glob("*.c"))
    n_stubs = sum(1 for f in (REPO / "src" / "stubs").glob("*.h"))

    # Word docs
    plans   = collect_docs("docs/plans")
    safety  = collect_docs("docs/safety")
    manuals = collect_docs("docs/manuals")
    reviews = collect_docs("docs/reviews")
    ncs     = collect_docs("docs/non-conformities")
    misra_r = collect_docs("misra/records")

    # Reports — links target BUNDLE paths (relative to index.html in deploy).
    # The CI pipeline copies artifacts to exactly these paths, so the links
    # always resolve in the deployed bundle.
    rep_paths = {
        "coverage":  "coverage/index.html",
        "test":      "reports/test-report.html",
        "api":       "api-doc/index.html",
        "trace":     "traceability/index.html",
        "cppcheck":  "reports/cppcheck-report.xml",
    }

    html_body = f"""<!doctype html>
<html lang='en'><head>
<meta charset='utf-8'>
<title>demo-epb {html.escape(tag)} — Project Dashboard</title>
<style>
:root {{ color-scheme: light; }}
body {{ font-family: -apple-system, "Segoe UI", sans-serif; margin: 0; padding: 0; color: #222; background: #f5f6f8; }}
header {{ background: #1f3864; color: white; padding: 20px 40px; }}
header h1 {{ margin: 0; font-size: 26px; }}
header .meta {{ color: #b9c2d6; font-size: 13px; margin-top: 6px; }}
main {{ max-width: 1100px; margin: 0 auto; padding: 20px 40px; }}
.kpis {{ display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; margin: 20px 0; }}
.kpi {{ background: white; padding: 16px; border-radius: 6px; box-shadow: 0 1px 3px rgba(0,0,0,0.07); }}
.kpi-value {{ font-size: 28px; font-weight: 700; }}
.kpi-label {{ color: #555; font-size: 13px; margin-top: 4px; text-transform: uppercase; letter-spacing: 0.5px; }}
.kpi-sub {{ color: #888; font-size: 12px; margin-top: 2px; }}
section {{ background: white; padding: 16px 24px; border-radius: 6px; margin-bottom: 16px; box-shadow: 0 1px 3px rgba(0,0,0,0.06); }}
h2 {{ color: #1f3864; margin-top: 0; font-size: 17px; }}
ul {{ list-style: none; padding-left: 0; }}
li {{ padding: 4px 0; }}
a {{ color: #1f3864; text-decoration: none; border-bottom: 1px dotted #1f3864; }}
a:hover {{ background: #ffea8a; }}
.cnt {{ color: #888; font-size: 13px; }}
.missing {{ color: #c00; font-style: italic; }}
.cols {{ display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }}
@media (max-width: 700px) {{ .cols {{ grid-template-columns: 1fr; }} }}
footer {{ text-align: center; color: #888; padding: 30px; font-size: 13px; }}
.banner {{ background: #fff3cd; padding: 10px 24px; border-left: 4px solid #ff9800; margin-bottom: 16px; border-radius: 4px; }}
</style></head>
<body>
<header>
  <h1>demo-epb — Electric Parking Brake</h1>
  <div class='meta'>Version <strong>{html.escape(tag)}</strong> &middot; Commit <code>{html.escape(sha)}</code> &middot; Generated {html.escape(now)}</div>
</header>
<main>

<div class='banner'>
  <strong>Demo project:</strong> Complete demonstration of the
  <a href='https://gitea.slohmaier.com/slohmaier/dev-process'>slohmaier Dev Process</a>.
  This software is intentionally not production code; it is a showcase of the engineering method.
</div>

<div class='kpis'>
{kpi_card("Safety Goals", str(n_sg), "ASIL D/D/A/C/B", "#d62728")}
{kpi_card("System Reqs",   str(n_sys), f"in reqs/sys/")}
{kpi_card("SW Reqs",       str(n_swe), f"in reqs/swe/")}
{kpi_card("Arch Elements", f"{n_sa+n_swa}", f"{n_sa} SA + {n_swa} SWA")}
{kpi_card("Components",   f"{n_impl}", f"+ {n_stubs} stubs", "#2ca02c")}
{kpi_card("Unit tests",    str(n_tests), "All green", "#2ca02c")}
</div>

"""

    html_body += "<div class='cols'>"
    html_body += doc_section("Plans (Word)", plans,
                             "Project Manual, PID, PM Plan, QA Plan, SWE Plan, Test Plan, CM Plan, RM Plan")
    html_body += doc_section("Functional Safety (Word)", safety,
                             "HARA, Safety Case, FMEDA, Compliance, Verification, Tool Qualification")
    html_body += "</div><div class='cols'>"

    html_body += doc_section("Manuals (Word)", manuals,
                             "End-user + workshop documentation")

    audit_docs = reviews + ncs + misra_r
    html_body += doc_section("Audit Artifacts (Word)", audit_docs,
                             "Reviews, non-conformities, MISRA deviation records")

    html_body += "</div>"

    # Reports — always emit links, bundle-relative paths.
    html_body += "<section><h2>Engineering Reports (CI-generated)</h2><ul>\n"
    html_body += report_link("Traceability Matrix", rep_paths["trace"], True,
                              "SG -> SYS -> SA, SWE -> SWA -> Code+Test, verified bidirectionally")
    html_body += report_link("Test Summary", rep_paths["test"], True,
                              f"{n_tests} unit tests with requirement mapping")
    html_body += report_link("Coverage (gcov/lcov)", rep_paths["coverage"], True,
                              "Statement + branch coverage, drill down to line level")
    html_body += report_link("API Documentation (Doxygen)", rep_paths["api"], True,
                              "All headers + functions, with @arch/@reqs/@asil")
    html_body += report_link("Cppcheck Report (HTML)", "reports/cppcheck/index.html", True,
                              "Static analysis + MISRA findings, clickable per file")
    html_body += report_link("Cppcheck Report (XML, raw)", rep_paths["cppcheck"], True,
                              "Machine-readable format for your own tools")
    html_body += "</ul></section>"

    # Diagrams (bundle layout: SVGs are at <bundle>/diagrams/, not docs/diagrams/)
    diagrams = sorted((REPO / "docs" / "diagrams").glob("*.svg"))
    if diagrams:
        html_body += "<section><h2>Architecture Diagrams (PlantUML)</h2><ul>"
        for d in diagrams:
            href = f"diagrams/{d.name}"
            html_body += f"  <li><a href='{html.escape(href)}'>{html.escape(d.stem)}</a></li>\n"
        html_body += "</ul></section>"

    # Source code links
    html_body += """
<section>
  <h2>Source Code</h2>
  <ul>
    <li><a href='src/safety_manager.c'>safety_manager.c</a> — Safety Manager (ASIL-D: Hill-Hold + Auto-Apply + Drive-Away)</li>
    <li><a href='src/apply_controller.c'>apply_controller.c</a> — Apply Controller (ASIL-D, state machine)</li>
    <li><a href='src/actuator_driver.c'>actuator_driver.c</a> — Actuator Driver (ASIL-B, overcurrent cutoff)</li>
    <li><a href='src/switch_debouncer.c'>switch_debouncer.c</a> — Switch Debouncer (QM)</li>
    <li class='cnt'>Plus 6 stub headers in <a href='src/stubs/'>src/stubs/</a></li>
  </ul>
</section>
"""

    html_body += f"""
<section>
  <h2>External Links</h2>
  <ul>
    <li><a href='https://gitea.slohmaier.com/slohmaier/demo-epb'>Gitea repo</a></li>
    <li><a href='https://gitea.slohmaier.com/slohmaier/demo-epb/releases'>Releases</a></li>
    <li><a href='https://gitea.slohmaier.com/slohmaier/dev-process'>Methodology repo (dev-process)</a></li>
  </ul>
</section>

</main>

<footer>
  Build {html.escape(now)} &middot; demo-epb {html.escape(tag)} ({html.escape(sha)}) &middot; slohmaier.com
</footer>

</body></html>
"""

    out = BUILD / "index.html"
    out.write_text(html_body)
    print(f"Wrote {out}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())