EmberClone/scripts/phase12_features.py

#!/usr/bin/env python3
"""Phase-12: invoicing-stub, time-rounding, user-avatars, mentions, version-display."""

from __future__ import annotations

import asyncio
import datetime
import json
import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from phase2_features import Feature, FileGen, ROOT, log, log_section  # noqa: E402
from phase3_features import run_feature_v2  # noqa: E402

PHASE12_STATE = ROOT / ".phase12-state.json"

FEATURES: list[Feature] = [
    Feature(
        name="invoicing-stub",
        description="Invoices-Page (read-only stub generated from billable time-entries)",
        files=[
            FileGen(
                path="apps/api/src/routes/invoices.ts",
                purpose=(
                    "Fastify-Plugin /api/invoices. Auth required. "
                    "GET / → list (generierte invoices, stub: 1 fake-invoice pro customer mit summe der billable time-entries letzten Monat). "
                    "GET /:id → details mit positions (time-entries). "
                    "Use FastifyInstance NOT FastifyPluginAsync as param type."
                ),
                refs=["apps/api/src/routes/customers.ts"],
            ),
            FileGen(
                path="apps/web/src/pages/Invoices.tsx",
                purpose=(
                    "Invoices-Page. Liste der pro-Customer-aggregierten Mock-Invoices: "
                    "Customer-Name, Period, Hours, geschätzter Betrag (hours * 80€). Klick → Modal mit Detail-Positions."
                ),
                refs=["apps/web/src/pages/Customers.tsx"],
            ),
        ],
    ),
    Feature(
        name="time-rounding-rules",
        description="Settings-Option: Rundung für Time-Entries (5/15/30 min)",
        files=[
            FileGen(
                path="apps/api/src/db/schema.ts",
                purpose=(
                    "ERWEITERT — füge `roundingMinutes: integer('rounding_minutes').notNull().default(0)` zu appSettings (0 = keine Rundung). "
                    "Behalte alle anderen Spalten + Tabellen."
                ),
                refs=["apps/api/src/db/schema.ts"],
            ),
            FileGen(
                path="apps/web/src/pages/Settings.tsx",
                purpose=(
                    "ERWEITERT — füge Select-Field 'Time-Rounding: keine / 5min / 15min / 30min' (mapped auf 0/5/15/30). "
                    "Behalte alle existierenden Fields."
                ),
                refs=["apps/web/src/pages/Settings.tsx"],
            ),
        ],
    ),
    Feature(
        name="user-avatars",
        description="Avatar-Component (Initialen-Badge) + überall einsetzen",
        files=[
            FileGen(
                path="apps/web/src/components/Avatar.tsx",
                purpose=(
                    "Avatar-Component. Props: name (string), size? ('sm'|'md'|'lg', default 'md'). "
                    "Generiert farbigen Kreis mit Initialen (max 2 Zeichen). "
                    "Farbe: hash(name) → preset-palette ['bg-orange-500','bg-blue-500','bg-emerald-500','bg-purple-500','bg-pink-500']. "
                    "Tailwind rounded-full text-white font-medium."
                ),
            ),
            FileGen(
                path="apps/web/src/components/Nav.tsx",
                purpose=(
                    "ERWEITERT — füge <Avatar name={user.name} size='sm' /> links neben Logout-Button (current user). "
                    "Behalte alle bestehenden Links und Toggles."
                ),
                refs=["apps/web/src/components/Nav.tsx"],
            ),
        ],
    ),
    Feature(
        name="app-version-display",
        description="Version-Badge im Footer (aus package.json)",
        files=[
            FileGen(
                path="apps/web/src/components/VersionBadge.tsx",
                purpose=(
                    "VersionBadge-Component. Liest Version aus import.meta.env.VITE_APP_VERSION (Fallback '0.0.1'). "
                    "Rendert kleines Badge: 'v{version}' in Footer-Stil (text-xs text-gray-400). "
                    "Klick → öffnet Link zu Git-Repo in neuem Tab."
                ),
            ),
            FileGen(
                path="apps/web/src/App.tsx",
                purpose=(
                    "ERWEITERT — füge <VersionBadge /> im Footer-Bereich des Root-Routes. "
                    "Footer mit border-top, py-2, text-center."
                ),
                refs=["apps/web/src/App.tsx"],
            ),
        ],
    ),
    Feature(
        name="api-client-phase12",
        description="API um invoices erweitern",
        files=[
            FileGen(
                path="apps/web/src/lib/api.ts",
                purpose=(
                    "ERWEITERT — behalte ALLES. Füge: listInvoices(), getInvoice(id)."
                ),
                refs=["apps/web/src/lib/api.ts"],
            ),
        ],
    ),
    Feature(
        name="router-phase12",
        description="App + routes/index für /invoices",
        files=[
            FileGen(
                path="apps/api/src/routes/index.ts",
                purpose="ERWEITERT — füge invoiceRoutes ('/api/invoices').",
                refs=["apps/api/src/routes/index.ts"],
            ),
            FileGen(
                path="apps/web/src/App.tsx",
                purpose="ERWEITERT — füge /invoices Route. Behalte alles.",
                refs=["apps/web/src/App.tsx"],
            ),
            FileGen(
                path="apps/web/src/components/Nav.tsx",
                purpose="ERWEITERT — füge Invoices-Link in Nav (alle User). Behalte alles.",
                refs=["apps/web/src/components/Nav.tsx"],
            ),
        ],
    ),
]


def load_state() -> dict:
    if PHASE12_STATE.exists():
        return json.loads(PHASE12_STATE.read_text())
    return {"completed_features": [], "current_feature": None, "started_at": datetime.datetime.now().isoformat()}


def save_state(state: dict) -> None:
    PHASE12_STATE.write_text(json.dumps(state, indent=2))


async def main() -> int:
    log_section("🚀 Phase-12 Codegen-Run gestartet")
    state = load_state()
    for feature in FEATURES:
        if feature.name in state.get("completed_features", []):
            continue
        state["current_feature"] = feature.name; save_state(state)
        try:
            success = await run_feature_v2(feature)
            if success:
                state.setdefault("completed_features", []).append(feature.name)
            else:
                state.setdefault("attempted_features", []).append(feature.name)
            save_state(state)
        except Exception as e:
            log(f"❌ {feature.name} crashed: {e}", level="ERROR")
            state.setdefault("attempted_features", []).append(feature.name); save_state(state)

    log_section("Phase-12 Run beendet")
    log(f"OK: {len(state.get('completed_features', []))}, Attempted: {len(state.get('attempted_features', []))}, Total: {len(FEATURES)}")
    return 0


if __name__ == "__main__":
    sys.exit(asyncio.run(main()))