PWA

Author: TamerOnLine

api/main.py

@@ -4,6 +4,9 @@
 - GET  /healthz
 - POST /generate-form-simple : build PDF from profile + (optional) layout/theme
 - /api/profiles/*            : save/load JSON profiles (via profiles router)
+- GET  /                     : PWA home (serves templates/index.html)
+- GET  /manifest.json        : PWA manifest (root scope)
+- GET  /service-worker.js    : PWA service worker (root scope)
 """
 
 from __future__ import annotations
@@ -14,29 +17,54 @@
 from pathlib import Path
 from typing import Any, Dict, Optional
 
-from fastapi import FastAPI, HTTPException, Response
+from fastapi import FastAPI, HTTPException, Response, Request
 from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import HTMLResponse, FileResponse
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
 from pydantic import BaseModel, Field, ValidationError, field_validator
 
 # 1) Register fonts (side-effect)
 from api.pdf_utils import fonts  # noqa: F401
 from api.pdf_utils.builder import build_resume_pdf
 from api.pdf_utils.mapper import profile_to_overrides
 from api.routes import profiles as profiles_routes  # /api/profiles/*
-from api.pdf_utils.schema import ensure_profile_schema  # ✅ أضفنا هذا الاستيراد
+from api.pdf_utils.schema import ensure_profile_schema
+
+import asyncio
+import httpx
+from starlette.responses import StreamingResponse
+
 
 log = logging.getLogger("resume.api")
 logging.basicConfig(level=logging.INFO)
 
-APP_ROOT = Path(__file__).resolve().parent.parent
+# Project paths
+APP_ROOT = Path(__file__).resolve().parent.parent          # build/
+API_DIR   = Path(__file__).resolve().parent                # build/api
 THEMES_DIR = APP_ROOT / "themes"
 LAYOUTS_DIR = APP_ROOT / "layouts"
 
+# ---------------------------------------------------------------------
+# FastAPI app
+# ---------------------------------------------------------------------
 app = FastAPI(title="Resume API")
 
-# ─────────────────────────────────────────────────────────────
+# ---------------------------------------------------------------------
+# PWA: root endpoints (so SW has scope '/')
+# ---------------------------------------------------------------------
+@app.get("/manifest.json")
+def manifest() -> FileResponse:
+    return FileResponse(API_DIR / "static" / "manifest.json", media_type="application/json")
+
+@app.get("/service-worker.js")
+def service_worker() -> FileResponse:
+    # Important: correct JS media type
+    return FileResponse(API_DIR / "static" / "service-worker.js", media_type="application/javascript")
+
+# ---------------------------------------------------------------------
 # CORS (tighten in production)
-# ─────────────────────────────────────────────────────────────
+# ---------------------------------------------------------------------
 ALLOWED_ORIGINS = [
     "http://localhost:8501",  # Streamlit (local)
     "http://127.0.0.1:8501",
@@ -49,17 +77,39 @@
     allow_headers=["Content-Type", "Authorization"],
 )
 
-# Routes for profiles CRUD
+# ---------------------------------------------------------------------
+# Routers
+# ---------------------------------------------------------------------
 app.include_router(profiles_routes.router, prefix="/api")
 
+# ---------------------------------------------------------------------
+# Static & Templates
+# ---------------------------------------------------------------------
+# Serve api/static at /static (icons, extra assets...)
+app.mount("/static", StaticFiles(directory=str(API_DIR / "static")), name="static")
+
+# Templates
+templates = Jinja2Templates(directory=str(API_DIR / "templates"))
+
+@app.get("/", response_class=HTMLResponse)
+def index(request: Request) -> HTMLResponse:
+    """PWA home page (renders templates/index.html)."""
+    return templates.TemplateResponse("index.html", {"request": request})
+
+
+
+
 
+
+# ---------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------
 def normalize_theme_name(tn: Optional[str]) -> str:
     """Normalize an incoming theme name (drop '.theme.json' if present)."""
     if not tn:
         return "default"
     return tn[:-11] if tn.endswith(".theme.json") else tn
 
-
 def coerce_summary(profile: Dict[str, Any]) -> None:
     """If summary is a stringified list, convert it to a single joined string."""
     val = profile.get("summary")
@@ -68,14 +118,12 @@ def coerce_summary(profile: Dict[str, Any]) -> None:
         if s.startswith("[") and s.endswith("]"):
             try:
                 import ast
-
                 lst = ast.literal_eval(s)
                 if isinstance(lst, list):
                     profile["summary"] = " ".join(str(x) for x in lst if x)
             except Exception:
                 pass
 
-
 def _decode_headshots(node: Any) -> None:
     """Recursively convert avatar_circle.data.photo_b64 -> photo_bytes."""
     if isinstance(node, dict):
@@ -93,7 +141,6 @@ def _decode_headshots(node: Any) -> None:
         for it in node:
             _decode_headshots(it)
 
-
 def _deep_merge_fill_missing(dst: dict, src: dict) -> dict:
     """
     Merge without overwriting existing keys in dst (fill-only-missing).
@@ -107,7 +154,6 @@ def _deep_merge_fill_missing(dst: dict, src: dict) -> dict:
             dst[k] = v
     return dst
 
-
 def _safe_read_layout_by_name(layout_name: str) -> Dict[str, Any]:
     """Read a JSON layout by name safely (prevent path traversal)."""
     candidate = (LAYOUTS_DIR / layout_name).resolve()
@@ -120,7 +166,9 @@ def _safe_read_layout_by_name(layout_name: str) -> Dict[str, Any]:
     except Exception as exc:
         raise HTTPException(status_code=400, detail=f"Failed to read layout: {exc}")
 
-
+# ---------------------------------------------------------------------
+# Payload model
+# ---------------------------------------------------------------------
 class GeneratePayload(BaseModel):
     theme_name: Optional[str] = Field(default=None, description="Theme name or 'x.theme.json'")
     theme: Optional[str] = Field(default=None, description="Legacy alias for theme_name")
@@ -139,7 +187,9 @@ def _trim_lang(cls, v: str) -> str:
     def effective_theme_name(self) -> str:
         return normalize_theme_name(self.theme_name or self.theme)
 
-
+# ---------------------------------------------------------------------
+# Lifecycle & health
+# ---------------------------------------------------------------------
 @app.on_event("startup")
 def _startup() -> None:
     try:
@@ -148,12 +198,13 @@ def _startup() -> None:
     except Exception as exc:
         log.warning("Font registration failed: %s", exc)
 
-
 @app.get("/healthz")
 def healthz() -> Dict[str, bool]:
     return {"ok": True}
 
-
+# ---------------------------------------------------------------------
+# PDF generation endpoint
+# ---------------------------------------------------------------------
 @app.post("/generate-form-simple")
 def generate_form_simple(payload: Dict[str, Any]) -> Response:
     """Generate a resume PDF from the provided payload."""
@@ -170,7 +221,7 @@ def generate_form_simple(payload: Dict[str, Any]) -> Response:
         "profile": args.profile or {},
     }
 
-    # ✅ Normalize profile data before PDF build
+    # Normalize profile data before PDF build
     data["profile"] = ensure_profile_schema(data["profile"])
 
     # Resolve layout_inline (prefer inline, else by name)

api/static/icons/icon-192.png

@@ -0,0 +1,20 @@
+{
+  "name": "Tamer Resume Builder API",
+  "short_name": "ResumeAPI",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#0d47a1",
+  "icons": [
+    {
+      "src": "/static/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/static/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}

api/static/icons/icon-512.png

@@ -0,0 +1,31 @@
+
+const CACHE_NAME = "resume-pwa-v1";
+const URLS_TO_CACHE = ["/", "/static/manifest.json"];
+
+self.addEventListener("install", (e) => {
+  e.waitUntil(
+    caches.open(CACHE_NAME).then((c) => c.addAll(URLS_TO_CACHE))
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(keys.filter(k => k !== CACHE_NAME).map(k => caches.delete(k)))
+    )
+  );
+  self.clients.claim();
+});
+
+self.addEventListener("fetch", (e) => {
+  e.respondWith(
+    caches.match(e.request).then((res) => {
+      return res || fetch(e.request).then((resp) => {
+        const copy = resp.clone();
+        caches.open(CACHE_NAME).then((c) => c.put(e.request, copy));
+        return resp;
+      }).catch(() => res);
+    })
+  );
+});

api/static/manifest.json

@@ -0,0 +1,81 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Tamer Resume Builder</title>
+
+  <!-- روابط الـ PWA -->
+  <link rel="manifest" href="/manifest.json" />
+  <meta name="theme-color" content="#0d47a1" />
+  <link rel="icon" href="/static/icons/icon-192.png" />
+
+  <!-- تسجيل الـ Service Worker -->
+  <script>
+    if ("serviceWorker" in navigator) {
+      window.addEventListener("load", () => {
+        navigator.serviceWorker
+          .register("/service-worker.js")
+          .then(() => console.log("Service Worker registered"))
+          .catch(console.error);
+      });
+    }
+  </script>
+
+  <!-- تصميم بسيط -->
+  <style>
+    body {
+      font-family: "Segoe UI", Roboto, sans-serif;
+      background: #f9fafc;
+      color: #222;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      height: 100vh;
+      margin: 0;
+    }
+    h1 {
+      color: #0d47a1;
+      font-size: 2rem;
+      margin-bottom: 1rem;
+    }
+    p {
+      color: #555;
+      margin-bottom: 2rem;
+    }
+    a.button {
+      display: inline-block;
+      padding: 0.9rem 1.6rem;
+      background: #0d47a1;
+      color: #fff;
+      font-weight: 500;
+      border-radius: 0.6rem;
+      text-decoration: none;
+      transition: background 0.25s ease;
+    }
+    a.button:hover {
+      background: #1565c0;
+    }
+    footer {
+      position: absolute;
+      bottom: 1rem;
+      font-size: 0.85rem;
+      color: #777;
+    }
+  </style>
+</head>
+
+<body>
+  <h1>🚀 Tamer Resume Builder</h1>
+  <p>Welcome to your portable Resume Builder API (PWA).</p>
+
+  <!-- الزر الذي يفتح واجهة Streamlit -->
+  <a class="button" href="http://127.0.0.1:8501/" target="_blank">
+    Open Resume Builder UI
+  </a>
+
+  
+</body>
+<footer>© 2025 TamerOnLine — All rights reserved</footer>
+</html>