01-PAAW-MS01 — Master Shell

Desktop View Required

PHYSIQ Academy Admin Workspace is designed as a desktop application interface. Please use a desktop or wide tablet screen for stable workspace operation.

Workspace Ready

PAAW-MS01 Master Shell

ADMIN

PAAW-MS01 MASTER SHELL

Workspace Ready — Unified Shell Foundation

The Master Shell is active. It controls the rail, sidebar, route registry, iframe page registry, widget registry, view activation, access state, and safe fallback handling. Static Blogger pages must be registered through PAAW.registerIframePage(). Complex applications must remain separate widgets registered through PAAW.registerWidget().

window.PAAW.registerIframePage({ itemId: 'PAGE-LN-001', categoryId: 'CAT-05', railGroup: 'content', sectionId: 'basic-lesson-pages', routeId: 'page-lesson-note-template-01', sidebarLabel: 'Lesson Note Template 01', title: 'Lesson Note Template 01', subtitle: 'Blogger Page / Content Creation', icon: 'file-text', iframeUrl: 'https://example.blogspot.com/2026/lesson-note-template-01.html', routeContext: 'lesson-note', status: 'active', accessLevel: 'all', order: 10 });

REGISTRY STATUS

Unified Navigation Registry

Live summary of categories, iframe pages, complex widgets, routes, views, and recent errors registered in PAAW-MS01.

Loading workspace page...

SAFE FALLBACK

Route Not Available

The selected route is missing, disabled, hidden, in future status, restricted, or waiting for its Web Application widget to register.

No debug details.

03-PAAW-DB03 — Workspace Dashboard

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 03-PAAW-DB03 — Workspace Dashboard Complete Implementation Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: PAAW-DB03 is the advanced workspace home/dashboard widget for the PHYSIQ Academy Admin Workspace. It gives administrators, teachers, and designers a safe overview of the system and fast access to the remaining tools. Responsibilities: - Show a welcome/workspace overview section. - Display live registry statistics from PAAW-MS01. - Provide quick action cards for the complex widgets. - Provide Blogger/static page shortcuts from registered iframe pages. - Display recently used tools using local route history. - Show system status for Master Shell, Iframe Controller, access state, route state, theme foundation, cache, and Firebase adapter. - Provide future analytics preview blocks without duplicating PAAW-UA44 Usage Analytics. - Provide admin guidance for correct widget load order and route usage. - Use lazy initialization and duplicate guards. - Use localStorage cache immediately and Firebase Firestore adapter when available. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads PAAW-DB03. 4. PAAW-DB03 registers itself with window.PAAW.registerWidget(). 5. Master Shell creates/detects view-paaw-db03. 6. When route widget-workspace-dashboard opens, paawDB03Init() renders the dashboard. 7. Admin clicks dashboard shortcut cards. 8. Dashboard opens registered widget routes or iframe routes through the Master Shell. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional: Firebase v8 compat Firestore exposed as window.firebase.firestore(). ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-db03-workspace-dashboard/ ├── blogger-widget/ │ └── 03-PAAW-DB03-Workspace-Dashboard.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-DB03.md Note: The real deployment unit for Blogger is the single widget HTML file. The folders above are the clean implementation package structure for source control, handoff, and documentation. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/03-PAAW-DB03-Workspace-Dashboard.widget.html Purpose: Complete Blogger HTML/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional window.PAAW_IF02, optional window.firebase.firestore(), optional lucide. 2. firebase/firestore.rules Purpose: Firestore access rules for dashboard state, dashboard activity, and analytics snapshots. Usage: Add to Firebase Security Rules when connecting the workspace to Firebase. Dependencies: Firebase Authentication custom claims with role/admin. 3. firebase/firestore.indexes.json Purpose: Required composite indexes for dashboard activity and analytics query growth. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for dashboard exports or generated files. Usage: Add to Firebase Storage security rules if dashboard artifacts are stored. Dependencies: Firebase Authentication custom claims with role/admin. 5. docs/README-PAAW-DB03.md Purpose: Installation, route, and runtime summary. Usage: Developer handoff document. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/03-PAAW-DB03-Workspace-Dashboard.widget.html ------------------------------------------------------------ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function userRole() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || userRole() in ['admin', 'owner', 'developer'] ); } function canReadDashboard() { return signedIn() && (isAdmin() || userRole() in ['teacher', 'designer']); } function canWriteDashboard() { return isAdmin(); } match /paawWorkspaces/{workspaceId} { allow read: if canReadDashboard(); allow create, update, delete: if isAdmin(); match /dashboardState/{documentId} { allow read: if canReadDashboard(); allow create, update, delete: if canWriteDashboard() && request.resource.data.keys().hasOnly([ 'summary', 'recentActivity', 'analyticsPreview', 'updatedAt', 'updatedBy', 'sourceWidget' ]); } match /dashboardActivity/{activityId} { allow read: if canReadDashboard(); allow create: if signedIn() && request.resource.data.source == 'PAAW-DB03' && request.resource.data.widgetCode == 'PAAW-DB03'; allow update, delete: if isAdmin(); } match /analyticsSnapshots/{snapshotId} { allow read: if canReadDashboard(); allow create, update, delete: if canWriteDashboard(); } } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "dashboardActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "widgetCode", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] }, { "collectionGroup": "dashboardActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "targetRouteId", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] }, { "collectionGroup": "analyticsSnapshots", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function userRole() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || userRole() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/dashboard/{allPaths=**} { allow read: if signedIn() && (isAdmin() || userRole() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 10 * 1024 * 1024; } } } ------------------------------------------------------------ FILE: docs/README-PAAW-DB03.md ------------------------------------------------------------ PAAW-DB03 is a Blogger-compatible complex web application widget. It is not a FlutterFlow page and it is not an iframe page. It is loaded as an HTML/JavaScript Blogger widget after PAAW-MS01 and PAAW-IF02. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 03-PAAW-DB03 widget. 4. Add the remaining complex widgets after DB03. Runtime registration: - widgetId: PAAW-DB03 - widgetCode: PAAW-DB03 - categoryId: CAT-01 - railGroup: workspace - routeId: widget-workspace-dashboard - viewId: view-paaw-db03 - initFunction: paawDB03Init The widget supports localStorage immediately and automatically detects Firebase v8 compat Firestore through window.firebase.firestore() when the host site provides it. ============================================================ 5. FIREBASE DESIGN ============================================================ Collections: - paawWorkspaces/{workspaceId}/dashboardState/workspace-dashboard - paawWorkspaces/{workspaceId}/dashboardActivity/{activityId} - paawWorkspaces/{workspaceId}/analyticsSnapshots/{snapshotId} Storage Structure: - paaw/{workspaceId}/dashboard/exports/ - paaw/{workspaceId}/dashboard/snapshots/ Authentication: - Firebase Auth is expected when Firebase is used. - The rules support custom claims: role and admin. - Admin-like roles can write dashboard state. - Teacher/designer roles can read dashboard state. Fallback Strategy: - If Firebase is not present, the widget uses localStorage. - No Firebase config is embedded in the widget because Firebase app initialization belongs to the host/site-level integration layer. ============================================================ 6. UI COMPONENTS ============================================================ Reusable internal UI blocks: - Hero overview card - Control/status card - Registry stat cards - Complex widget action cards - Iframe page shortcut cards - Recent route list rows - System status rows - Analytics preview cards - Admin guidance rows - Empty-state block - Toast notification CSS Prefix: - All classes use paaw-db03- prefix. - All IDs use paaw-db03 or view-paaw-db03. - No generic .card, .button, .panel, or .grid class names are used. ============================================================ 7. STATE MANAGEMENT ============================================================ State Object: - version - registered - initialized - eventsBound - routeEventsBound - registrationAttempts - lastRefresh - lastDataSource - routeHistory - dashboardData - errors - toastTimer Local Storage Keys: - paaw-db03-dashboard-cache-v02 - paaw-db03-route-history-v02 - paaw-db03-last-snapshot-v02 Events Listened: - paaw:ready - paaw:route-changed - paaw:widget-registered - paaw:access-changed ============================================================ 8. MODELS ============================================================ Dashboard Summary: - resources: number - readyTools: number - iframePages: number - warningCount: number - lastMaintenance: string Route History Item: - routeId: string - title: string - icon: string - routeType: string - time: ISO string - timeLabel: display string Dashboard Activity Event: - widgetId: string - widgetCode: string - routeId: string - viewId: string - source: string - eventType: string - targetRouteId: string - title: string - message: string - status: string - icon: string - createdAt: ISO string Quick Action Item: - code: widget code - label: visible label - icon: lucide icon name - category: dashboard category - routes: route candidates - description: user-facing summary ============================================================ 9. SERVICES ============================================================ Dashboard services included inside the widget: - Registry snapshot service: reads PAAW.getRegistrySnapshot(). - Route resolver service: resolves route candidates against PAAW.state.routes. - Permission service: checks accessLevel against PAAW.state.accessState. - Local cache service: reads/writes localStorage safely. - Firebase adapter service: detects window.firebase.firestore() and reads/writes dashboard paths. - Activity writer service: writes local activity and optional Firestore activity. - Validation service: validates route IDs and iframe URLs. - Toast service: displays safe dashboard notices. ============================================================ 10. VALIDATION ============================================================ Implemented validation: - Route ID validation with /^[a-zA-Z0-9][a-zA-Z0-9_-]{1,80}$/. - URL validation using URL parser and http/https protocols only. - Access validation against route accessLevel and current Master Shell access state. - Duplicate guard prevents multiple initialization of V02 script. - Registration retry prevents failure when DB03 loads slightly before PAAW is ready. ============================================================ 11. ERROR HANDLING ============================================================ Implemented error handling: - Safe Firebase detection. - Safe localStorage read/write. - Registry snapshot failure fallback. - Route opening failure toast. - Missing Master Shell warning block. - Firebase read/write catch blocks. - Error list capped to 40 entries. - No uncaught dependency failure if lucide or Firebase is missing. ============================================================ 12. RESPONSIVE LAYOUT ============================================================ Supported layouts: - Desktop: two-column dashboard with wide quick action grid. - Laptop: stats and actions reduce to two columns. - Tablet: dashboard sections become one column. - Mobile: internal blocks become single column. Note: The current Master Shell has its own mobile policy. DB03 still includes internal responsive CSS so it remains safe if the shell mobile policy changes later. ============================================================ 13. THEME SUPPORT ============================================================ Theme tokens used: - --paaw-primary - --paaw-primary-hover - --paaw-bg - --paaw-surface - --paaw-surface-soft - --paaw-surface-muted - --paaw-text - --paaw-text-soft - --paaw-text-muted - --paaw-border - --paaw-border-strong - --paaw-shadow-sm - --paaw-shadow-md - --paaw-shadow-lg - --paaw-radius-sm - --paaw-radius-md - --paaw-radius-lg - --paaw-radius-xl The widget inherits light/dark/custom theme values from PAAW-MS01 and future PAAW-TH48 Theme Manager. ============================================================ 14. PERFORMANCE OPTIMISATION ============================================================ Included: - Lazy initialization through paawDB03Init(). - Local cache avoids repeated remote reads. - Route history capped to 12 entries. - Error list capped to 40 entries. - Firebase calls are optional and asynchronous. - Rendering is scoped inside view-paaw-db03. - No polling loop. - No duplicate event binding. - No custom iframe creation. ============================================================ 15. SECURITY ============================================================ Included: - Output escaping for dynamic text. - Route ID validation before switching. - URL validation for iframe helper method. - Access checks against Master Shell access state. - Firebase Security Rules included. - No embedded Firebase config or secrets. - No direct HTML injection from user-controlled data. - No duplicate global route or view registration. ============================================================ 16. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is placed first. [ ] PAAW-IF02 is placed immediately after PAAW-MS01. [ ] PAAW-DB03 is placed after PAAW-IF02. [ ] Browser console has no duplicate route/view errors. [ ] Sidebar shows Workspace Dashboard under Dashboard & Workspace. Route + Registration: [ ] PAAW.getRegistrySnapshot() contains widgetId PAAW-DB03. [ ] Route widget-workspace-dashboard exists. [ ] View view-paaw-db03 exists inside #paaw-content-area. [ ] paawDB03Init() is callable from console. [ ] Backward compatibility alias paawDb03Init() is callable. Dashboard UI: [ ] Hero card appears without breaking Master Shell layout. [ ] Registry stats render. [ ] Complex widget shortcuts render. [ ] Unregistered widgets show waiting/disabled state. [ ] Registered widgets open using PAAW.switchRoute(). [ ] Iframe page shortcuts appear after registering iframe pages. [ ] Recent routes update after opening tools. [ ] Clear history button clears local route history. [ ] System status shows Master Shell and Iframe Controller states. [ ] Analytics preview cards render. [ ] Admin guidance panel renders. Fallbacks: [ ] Dashboard works when Firebase is absent. [ ] Dashboard works when PAAW-IF02 global status object is absent. [ ] Missing Master Shell warning appears if DB03 is installed alone. [ ] localStorage disabled/private mode does not crash the widget. Responsive: [ ] Desktop two-column layout is clean. [ ] Laptop layout reduces grids correctly. [ ] Tablet layout becomes one column. [ ] Mobile internal layout stays readable if shell allows mobile later. Security: [ ] Invalid route ID does not switch routes. [ ] Invalid iframe URL is rejected. [ ] Dynamic labels are escaped. [ ] Firebase rules restrict writes to admin roles. ============================================================ 17. FUTURE EXTENSION NOTES ============================================================ Recommended future upgrades: 1. Connect PAAW-UA44 to provide live analytics data. 2. Add dashboard cards from Firebase Cloud Functions if the workspace grows. 3. Add per-role dashboard layouts for admin, teacher, and designer. 4. Add notification stream from PAAW system events. 5. Add dashboard search that routes to registered widgets and iframe pages. 6. Add export snapshot action that stores dashboard reports under Firebase Storage. 7. Add PAAW-TH48 theme preview support for dashboard cards. 8. Add cross-widget handoff events such as paaw:dashboard-open-resource. ============================================================ 18. FINAL IMPLEMENTATION NOTE ============================================================ This V02 package follows the uploaded architecture: - Master Shell owns layout, registry, sidebar, route, view, access, and theme foundation. - Iframe Controller owns iframe/static viewer behavior. - PAAW-DB03 is an independent complex Web Application Widget. - PAAW-DB03 registers through window.PAAW.registerWidget(). - PAAW-DB03 does not duplicate other widgets and does not create its own iframe. END OF FILE

04-PAAW-RM04 — Resource Manager

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 04-PAAW-RM04 — Resource Manager Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Study guide, teacher resource, design asset, download, upload, categorization, detail-preview, and reusable resource organization manager. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-rm04. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-RM04. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-RM04 widget. 4. The widget registers route paaw-rm04 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-rm04. 6. When the route opens, paawRM04Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-rm04-resource-manager/ ├── blogger-widget/ │ └── 04-PAAW-RM04-Resource-Manager.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-RM04.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/04-PAAW-RM04-Resource-Manager.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Resource Manager data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Resource Manager files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-RM04.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/04-PAAW-RM04-Resource-Manager.widget.html ------------------------------------------------------------

PAAW-RM04 / RESOURCE MANAGEMENT

Resource Manager

Manage PHYSIQ Academy teaching resources, design assets, uploads, downloads, categories, metadata, and internal resource organization from one controlled workspace widget.

Resource Library

Card and table management for internal PHYSIQ resource records.

0 resources

Resource Manager

Ready.

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/resourceManager/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-RM04' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/resourceManagerActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-RM04' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "resourceManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "resourceManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "resourceManagerActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/resources/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-RM04.md ------------------------------------------------------------ PAAW-RM04 — Resource Manager Purpose: Study guide, teacher resource, design asset, download, upload, categorization, detail-preview, and reusable resource organization manager. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 04-PAAW-RM04 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-RM04 - widgetCode: PAAW-RM04 - categoryId: CAT-02 - railGroup: resources - routeId: paaw-rm04 - viewId: view-paaw-rm04 - initFunction: paawRM04Init - accessLevel: admin, teacher, designer Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-RM04 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-RM04. [ ] Route paaw-rm04 is registered. [ ] View view-paaw-rm04 exists. [ ] paawRM04Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/resourceManager. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to resourceManagerActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

05-PAAW-PP05 — Past Paper Manager

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 05-PAAW-PP05 — Past Paper Manager Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Past paper gateway, subject/year/medium selectors, paper category registry, paper URL registry, and iframe handoff for paper viewing. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-pp05. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-PP05. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-PP05 widget. 4. The widget registers route paaw-pp05 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-pp05. 6. When the route opens, paawPP05Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-pp05-past-paper-manager/ ├── blogger-widget/ │ └── 05-PAAW-PP05-Past-Paper-Manager.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-PP05.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/05-PAAW-PP05-Past-Paper-Manager.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Past Paper Manager data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Past Paper Manager files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-PP05.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/05-PAAW-PP05-Past-Paper-Manager.widget.html ------------------------------------------------------------ ============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/pastPaperManager/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-PP05' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/pastPaperManagerActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-PP05' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "pastPaperManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "pastPaperManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "pastPaperManagerActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/past-papers/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-PP05.md ------------------------------------------------------------ PAAW-PP05 — Past Paper Manager Purpose: Past paper gateway, subject/year/medium selectors, paper category registry, paper URL registry, and iframe handoff for paper viewing. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 05-PAAW-PP05 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-PP05 - widgetCode: PAAW-PP05 - categoryId: CAT-03 - railGroup: past-papers - routeId: paaw-pp05 - viewId: view-paaw-pp05 - initFunction: paawPP05Init - accessLevel: admin, teacher Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-PP05 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-PP05. [ ] Route paaw-pp05 is registered. [ ] View view-paaw-pp05 exists. [ ] paawPP05Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/pastPaperManager. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to pastPaperManagerActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

06-PAAW-SP08 — Social Post Prompt Studio

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 06-PAAW-SP08 — Social Post Prompt Studio Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Social media prompt builder with platform-specific templates, captions, CTA suggestions, hashtags, design prompts, saved presets, and copy/export actions. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-sp08. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-SP08. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-SP08 widget. 4. The widget registers route paaw-sp08 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-sp08. 6. When the route opens, paawSP08Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-sp08-social-post-prompt-studio/ ├── blogger-widget/ │ └── 06-PAAW-SP08-Social-Post-Prompt-Studio.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-SP08.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/06-PAAW-SP08-Social-Post-Prompt-Studio.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Social Post Prompt Studio data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Social Post Prompt Studio files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-SP08.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/06-PAAW-SP08-Social-Post-Prompt-Studio.widget.html ------------------------------------------------------------ ============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/socialPostPromptStudio/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-SP08' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/socialPostPromptStudioActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-SP08' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "socialPostPromptStudio", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "socialPostPromptStudio", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "socialPostPromptStudioActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/social-posts/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-SP08.md ------------------------------------------------------------ PAAW-SP08 — Social Post Prompt Studio Purpose: Social media prompt builder with platform-specific templates, captions, CTA suggestions, hashtags, design prompts, saved presets, and copy/export actions. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 06-PAAW-SP08 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-SP08 - widgetCode: PAAW-SP08 - categoryId: CAT-04 - railGroup: ai-design - routeId: paaw-sp08 - viewId: view-paaw-sp08 - initFunction: paawSP08Init - accessLevel: admin, designer, teacher Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-SP08 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-SP08. [ ] Route paaw-sp08 is registered. [ ] View view-paaw-sp08 exists. [ ] paawSP08Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/socialPostPromptStudio. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to socialPostPromptStudioActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

07-PAAW-LN18 — Lesson Note Builder

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 07-PAAW-LN18 — Lesson Note Builder Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Lesson note creation workspace for syllabus-aligned lesson outlines, objectives, key points, classroom activities, teacher notes, summaries, and exportable lesson drafts. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-ln18. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-LN18. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-LN18 widget. 4. The widget registers route widget-lesson-note-builder with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-ln18. 6. When the route opens, paawLN18Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-ln18-lesson-note-builder/ ├── blogger-widget/ │ └── 07-PAAW-LN18-Lesson-Note-Builder.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-LN18.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/07-PAAW-LN18-Lesson-Note-Builder.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Lesson Note Builder data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Lesson Note Builder files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-LN18.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/07-PAAW-LN18-Lesson-Note-Builder.widget.html ------------------------------------------------------------ ============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/lessonNoteBuilder/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-LN18' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/lessonNoteBuilderActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-LN18' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "lessonNoteBuilder", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "lessonNoteBuilder", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "lessonNoteBuilderActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/lesson-notes/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-LN18.md ------------------------------------------------------------ PAAW-LN18 — Lesson Note Builder Purpose: Lesson note creation workspace for syllabus-aligned lesson outlines, objectives, key points, classroom activities, teacher notes, summaries, and exportable lesson drafts. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 07-PAAW-LN18 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-LN18 - widgetCode: PAAW-LN18 - categoryId: CAT-05 - railGroup: content - routeId: widget-lesson-note-builder - viewId: view-paaw-ln18 - initFunction: paawLN18Init - accessLevel: admin, teacher Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-LN18 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-LN18. [ ] Route widget-lesson-note-builder is registered. [ ] View view-paaw-ln18 exists. [ ] paawLN18Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/lessonNoteBuilder. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to lessonNoteBuilderActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

08-PAAW-PL26 — AI Prompt Library

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 08-PAAW-PL26 — AI Prompt Library Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Searchable AI prompt repository with categories, collections, prompt preview, variables, tags, status states, copy actions, and prompt handoff events. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-pl26. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-PL26. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-PL26 widget. 4. The widget registers route paaw-pl26 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-pl26. 6. When the route opens, paawPL26Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-pl26-ai-prompt-library/ ├── blogger-widget/ │ └── 08-PAAW-PL26-AI-Prompt-Library.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-PL26.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/08-PAAW-PL26-AI-Prompt-Library.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for AI Prompt Library data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for AI Prompt Library files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-PL26.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/08-PAAW-PL26-AI-Prompt-Library.widget.html ------------------------------------------------------------

AI Prompt Engine

AI Prompt Library

Store, organize, search, preview, and reuse AI prompts for PHYSIQ Academy workflows. This widget remains an internal prompt repository and prepares safe handoff to future Prompt Builder, Testing Studio, and Export Manager widgets.

Collections

Prompt Repository

Loading AI Prompt Library...

Add Prompt

Prompt Title Category Use Case Language Prompt Body Detected / Manual Variables Tags Output Format Negative Instructions Notes Status Version Label

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/aiPromptLibrary/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-PL26' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/aiPromptLibraryActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-PL26' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "aiPromptLibrary", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "aiPromptLibrary", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "aiPromptLibraryActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/ai-prompts/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-PL26.md ------------------------------------------------------------ PAAW-PL26 — AI Prompt Library Purpose: Searchable AI prompt repository with categories, collections, prompt preview, variables, tags, status states, copy actions, and prompt handoff events. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 08-PAAW-PL26 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-PL26 - widgetCode: PAAW-PL26 - categoryId: CAT-06 - railGroup: ai-engine - routeId: paaw-pl26 - viewId: view-paaw-pl26 - initFunction: paawPL26Init - accessLevel: admin, teacher, designer Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-PL26 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-PL26. [ ] Route paaw-pl26 is registered. [ ] View view-paaw-pl26 exists. [ ] paawPL26Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/aiPromptLibrary. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to aiPromptLibraryActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

09-PAAW-IL31 — Image Library

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 09-PAAW-IL31 — Image Library Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Image, photo, illustration, background, AI graphic, preview, metadata, tag, category, collection, and visual asset organization manager. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-il31. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-IL31. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-IL31 widget. 4. The widget registers route paaw-il31 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-il31. 6. When the route opens, paawIL31Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-il31-image-library/ ├── blogger-widget/ │ └── 09-PAAW-IL31-Image-Library.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-IL31.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/09-PAAW-IL31-Image-Library.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Image Library data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Image Library files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-IL31.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/09-PAAW-IL31-Image-Library.widget.html ------------------------------------------------------------

Media Management

Image Library

Organize, search, preview, select, and manage PHYSIQ Academy images, photos, illustrations, backgrounds, and AI-generated graphics for reusable design workflows.

Search & Filters

Text Search Image Type Orientation File Type Status Tag Sort

Image Repository

Loading Image Library...

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/imageLibrary/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-IL31' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/imageLibraryActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-IL31' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "imageLibrary", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "imageLibrary", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "imageLibraryActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/images/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-IL31.md ------------------------------------------------------------ PAAW-IL31 — Image Library Purpose: Image, photo, illustration, background, AI graphic, preview, metadata, tag, category, collection, and visual asset organization manager. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 09-PAAW-IL31 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-IL31 - widgetCode: PAAW-IL31 - categoryId: CAT-07 - railGroup: media - routeId: paaw-il31 - viewId: view-paaw-il31 - initFunction: paawIL31Init - accessLevel: admin, designer, teacher Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-IL31 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-IL31. [ ] Route paaw-il31 is registered. [ ] View view-paaw-il31 exists. [ ] paawIL31Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/imageLibrary. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to imageLibraryActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

10-PAAW-PD36 — PDF Resource Manager

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 10-PAAW-PD36 — PDF Resource Manager Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: PDF resource, eBook, teacher note, student note, metadata, version history, collection, download, preview handoff, and document resource organization manager. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-pd36. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-PD36. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-PD36 widget. 4. The widget registers route paaw-pd36 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-pd36. 6. When the route opens, paawPD36Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-pd36-pdf-resource-manager/ ├── blogger-widget/ │ └── 10-PAAW-PD36-PDF-Resource-Manager.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-PD36.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/10-PAAW-PD36-PDF-Resource-Manager.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for PDF Resource Manager data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for PDF Resource Manager files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-PD36.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/10-PAAW-PD36-PDF-Resource-Manager.widget.html ------------------------------------------------------------

DOCUMENT MANAGEMENT

PDF Resource Manager

Organize, preview, classify, and manage PHYSIQ Academy PDF resources, study materials, eBooks, notes, educational documents, versions, and download-ready references.

PDF Repository

Loading PDF Resource Manager...

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/pdfResourceManager/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-PD36' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/pdfResourceManagerActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-PD36' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "pdfResourceManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "pdfResourceManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "pdfResourceManagerActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/pdf-resources/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-PD36.md ------------------------------------------------------------ PAAW-PD36 — PDF Resource Manager Purpose: PDF resource, eBook, teacher note, student note, metadata, version history, collection, download, preview handoff, and document resource organization manager. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 10-PAAW-PD36 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-PD36 - widgetCode: PAAW-PD36 - categoryId: CAT-08 - railGroup: documents - routeId: paaw-pd36 - viewId: view-paaw-pd36 - initFunction: paawPD36Init - accessLevel: admin, teacher, designer Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-PD36 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-PD36. [ ] Route paaw-pd36 is registered. [ ] View view-paaw-pd36 exists. [ ] paawPD36Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/pdfResourceManager. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to pdfResourceManagerActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

11-PAAW-TM40 — Teacher Manager

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 11-PAAW-TM40 — Teacher Manager Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Teacher profile, contact, subject assignment, status, staff metadata, batch assignment handoff, and user-management handoff workspace. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-tm40. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-TM40. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-TM40 widget. 4. The widget registers route paaw-tm40 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-tm40. 6. When the route opens, paawTM40Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-tm40-teacher-manager/ ├── blogger-widget/ │ └── 11-PAAW-TM40-Teacher-Manager.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-TM40.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/11-PAAW-TM40-Teacher-Manager.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Teacher Manager data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Teacher Manager files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-TM40.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/11-PAAW-TM40-Teacher-Manager.widget.html ------------------------------------------------------------

USER MANAGEMENT

Teacher Manager

Manage PHYSIQ Academy teacher profiles, subject assignments, contact records, teacher status, activity summaries, batch handoff, and permission-management preparation inside the internal workspace.

Teacher Filters

Search by name, subject, role, status, medium, batch, or tags.

Subject

Role

Status

Medium

Tag

Sort

Teacher Directory

Internal records only. Contact data is kept inside the workspace and prepared for future permission checks.

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/teacherManager/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-TM40' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/teacherManagerActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-TM40' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "teacherManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "teacherManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "teacherManagerActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/teachers/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-TM40.md ------------------------------------------------------------ PAAW-TM40 — Teacher Manager Purpose: Teacher profile, contact, subject assignment, status, staff metadata, batch assignment handoff, and user-management handoff workspace. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 11-PAAW-TM40 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-TM40 - widgetCode: PAAW-TM40 - categoryId: CAT-09 - railGroup: people - routeId: paaw-tm40 - viewId: view-paaw-tm40 - initFunction: paawTM40Init - accessLevel: admin Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-TM40 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-TM40. [ ] Route paaw-tm40 is registered. [ ] View view-paaw-tm40 exists. [ ] paawTM40Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/teacherManager. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to teacherManagerActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

12-PAAW-UA44 — Usage Analytics

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 12-PAAW-UA44 — Usage Analytics Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Workspace usage, route activity, widget activity, feature utilization, session statistics, analytics timeline, report generation, and usage handoff manager. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-ua44. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-UA44. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-UA44 widget. 4. The widget registers route paaw-ua44 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-ua44. 6. When the route opens, paawUA44Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-ua44-usage-analytics/ ├── blogger-widget/ │ └── 12-PAAW-UA44-Usage-Analytics.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-UA44.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/12-PAAW-UA44-Usage-Analytics.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Usage Analytics data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Usage Analytics files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-UA44.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/12-PAAW-UA44-Usage-Analytics.widget.html ------------------------------------------------------------

Analytics Layer / Widget 44

Usage Analytics

Analyze workspace usage, user activity, sessions, feature utilization, widget activity, route activity, and system performance metrics for the PHYSIQ Academy Admin Workspace.

Analytics Filters

Adjust time range, widget group, role, event, session, performance, and search filters.

Time Range

Widget Group

User Role

Event Type

Session Status

Performance Status

Sort

Workspace Usage Dashboard

Widget ranking, feature utilization, route activity, and filtered analytics records.

Widget Usage Ranking

Open count and interaction level by internal widget.

Widget	Group	Route	Opens	Users	Avg Time	Load	Errors	Status

Feature Utilization Analytics

Feature clicks, uses, completions, errors, status, and importance level.

Feature	Parent Widget	Clicks	Uses	Completions	Errors	Last Used	Status	Importance

Recent Activity Timeline

Route opens, widget loads, resource actions, PDF previews, paper opens, and errors.

Analytics Report Panel

Prepare daily, weekly, monthly, widget, user activity, session, feature, and performance reports.

Analytics Handoff

Prepared safe handoff to specialized analytics widgets. This widget does not duplicate their full logic.

Download Analytics

Resource downloads, file access history, download trends, and popular resources.

Resource Statistics

Educational content usage, resource distribution, storage metrics, and asset statistics.

AI Usage Reports

Prompt activity, AI tool use, generation history, token placeholders, and AI performance reports.

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/usageAnalytics/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-UA44' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/usageAnalyticsActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-UA44' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "usageAnalytics", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "usageAnalytics", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "usageAnalyticsActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/analytics/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-UA44.md ------------------------------------------------------------ PAAW-UA44 — Usage Analytics Purpose: Workspace usage, route activity, widget activity, feature utilization, session statistics, analytics timeline, report generation, and usage handoff manager. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 12-PAAW-UA44 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-UA44 - widgetCode: PAAW-UA44 - categoryId: CAT-10 - railGroup: analytics - routeId: paaw-ua44 - viewId: view-paaw-ua44 - initFunction: paawUA44Init - accessLevel: admin Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-UA44 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-UA44. [ ] Route paaw-ua44 is registered. [ ] View view-paaw-ua44 exists. [ ] paawUA44Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/usageAnalytics. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to usageAnalyticsActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

13-PAAW-TH48 — Theme Manager

PHYSIQ-ACADEMY-ADMIN-WORKSPACE 13-PAAW-TH48 — Theme Manager Final Revised Complete Sample Code Package — UTF-8 Plain Text Version: V02 Revision Date: 2026-07-10 04:15:00 +0530 (Asia/Colombo) Development Owner: PHYSIQ Academy / Dr Malith Gunawardana ============================================================ 1. WIDGET OVERVIEW ============================================================ Purpose: Workspace theme, appearance, color schemes, dark/light mode, typography, radius, shadow, presets, preview mode, and global design preference manager. Responsibilities: - Register as a separate complex Web Application Widget through window.PAAW.registerWidget(). - Render only inside its assigned view container: view-paaw-th48. - Reuse PAAW-MS01 design tokens, route system, sidebar system, and access state. - Avoid iframe logic, Master Shell layout logic, and unprefixed global CSS. - Provide safe fallback behaviour if PAAW-MS01 is missing. - Keep all CSS, DOM IDs, JavaScript state, and public functions namespaced to PAAW-TH48. User Flow: 1. Blogger loads PAAW-MS01. 2. Blogger loads PAAW-IF02. 3. Blogger loads this PAAW-TH48 widget. 4. The widget registers route paaw-th48 with PAAW-MS01. 5. The Master Shell creates/detects view-paaw-th48. 6. When the route opens, paawTH48Init renders the widget. 7. Admin uses the widget-specific panels, actions, filters, previews, and handoff buttons. Dependencies: - Required: 01-PAAW-MS01 — Master Shell. - Required before this widget: 02-PAAW-IF02 — Iframe Controller. - Optional: lucide icons loaded by Master Shell. - Optional production persistence: Firebase Auth, Firestore, Storage. ============================================================ 2. FOLDER STRUCTURE ============================================================ paaw-th48-theme-manager/ ├── blogger-widget/ │ └── 13-PAAW-TH48-Theme-Manager.widget.html ├── firebase/ │ ├── firestore.rules │ ├── firestore.indexes.json │ └── storage.rules └── docs/ └── README-PAAW-TH48.md Note: The real Blogger deployment unit is the single widget HTML file. The folder tree above is the clean source-control and developer handoff structure. ============================================================ 3. FILE LIST ============================================================ 1. blogger-widget/13-PAAW-TH48-Theme-Manager.widget.html Purpose: Complete Blogger HTML/CSS/JavaScript widget source. Usage: Paste into a Blogger HTML/JavaScript widget after PAAW-MS01 and PAAW-IF02. Dependencies: window.PAAW, optional lucide, optional Firebase. 2. firebase/firestore.rules Purpose: Production access rules for Theme Manager data. Usage: Merge into Firebase Security Rules when live storage is connected. Dependencies: Firebase Authentication custom claims. 3. firebase/firestore.indexes.json Purpose: Suggested composite indexes for status/category/activity queries. Usage: Deploy with Firebase indexes. Dependencies: Firestore. 4. firebase/storage.rules Purpose: Storage safety path for Theme Manager files and exports. Usage: Merge into Firebase Storage rules. Dependencies: Firebase Authentication custom claims. 5. docs/README-PAAW-TH48.md Purpose: Installation, route, runtime, and handoff summary. Usage: Developer documentation. Dependencies: None. ============================================================ 4. COMPLETE SOURCE CODE ============================================================ ------------------------------------------------------------ FILE: blogger-widget/13-PAAW-TH48-Theme-Manager.widget.html ------------------------------------------------------------

SYSTEM MANAGEMENT

Theme Manager

Manage workspace appearance, color schemes, dark/light modes, typography, radius, shadows, preview mode, and reusable theme presets for PHYSIQ Academy.

Theme Preset Library

Preview, apply, duplicate, export, edit, or archive saved themes.

No theme presets found. Create a new theme preset or reset to PHYSIQ Default.

Theme Editor

Edit approved CSS variables only. Preview can be cancelled before permanent apply.

Saved

Theme Name Theme Mode Typography Preset Status

Color Scheme Manager

Updates shared PAAW root variables for all registered widgets.

Radius and Shape

Card, button, drawer, and modal shape variables.

Large Radius Medium Radius Small Radius

Typography

First-version safe typography preferences.

Font Family Base Font Size Heading Scale Density

Shadow and Depth

Controls shared small and medium elevation variables.

Small Shadow Medium Shadow

Notes

Theme Manager ready. Select a preset, edit values, then preview or apply.

Theme Preview Mode

Preview changes against a workspace-like surface and cancel before permanent apply.

Workspace Preview

Header, surface, sidebar, border, radius, and depth check

Primary Surface

Content Card

Theme JSON Import / Export

============================================================ 5. FIREBASE DESIGN ============================================================ ------------------------------------------------------------ FILE: firebase/firestore.rules ------------------------------------------------------------ rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } function canReadWorkspace() { return signedIn() && (isAdmin() || role() in ['teacher', 'designer']); } function canWriteWorkspace() { return isAdmin() || role() in ['teacher', 'designer']; } match /paawWorkspaces/{workspaceId}/{document=**} { allow read: if canReadWorkspace(); } match /paawWorkspaces/{workspaceId}/themeManager/{docId} { allow read: if canReadWorkspace(); allow create, update: if canWriteWorkspace() && request.resource.data.widgetCode == 'PAAW-TH48' && request.resource.data.workspaceId == workspaceId; allow delete: if isAdmin(); } match /paawWorkspaces/{workspaceId}/themeManagerActivity/{activityId} { allow read: if canReadWorkspace(); allow create: if signedIn() && request.resource.data.sourceWidget == 'PAAW-TH48' && request.resource.data.workspaceId == workspaceId; allow update, delete: if isAdmin(); } } } ------------------------------------------------------------ FILE: firebase/firestore.indexes.json ------------------------------------------------------------ { "indexes": [ { "collectionGroup": "themeManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "status", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "themeManager", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "categoryId", "order": "ASCENDING" }, { "fieldPath": "updatedAt", "order": "DESCENDING" } ] }, { "collectionGroup": "themeManagerActivity", "queryScope": "COLLECTION", "fields": [ { "fieldPath": "sourceWidget", "order": "ASCENDING" }, { "fieldPath": "createdAt", "order": "DESCENDING" } ] } ], "fieldOverrides": [] } ------------------------------------------------------------ FILE: firebase/storage.rules ------------------------------------------------------------ rules_version = '2'; service firebase.storage { match /b/{bucket}/o { function signedIn() { return request.auth != null; } function role() { return signedIn() && request.auth.token.role is string ? request.auth.token.role : 'guest'; } function isAdmin() { return signedIn() && ( request.auth.token.admin == true || role() in ['admin', 'owner', 'developer'] ); } match /paaw/{workspaceId}/themes/{allPaths=**} { allow read: if signedIn() && (isAdmin() || role() in ['teacher', 'designer']); allow write: if isAdmin() && request.resource.size < 25 * 1024 * 1024; } } } ============================================================ 5. DOCUMENTATION ============================================================ ------------------------------------------------------------ FILE: docs/README-PAAW-TH48.md ------------------------------------------------------------ PAAW-TH48 — Theme Manager Purpose: Workspace theme, appearance, color schemes, dark/light mode, typography, radius, shadow, presets, preview mode, and global design preference manager. Installation order: 1. Add 01-PAAW-MS01 — Master Shell. 2. Add 02-PAAW-IF02 — Iframe Controller immediately after the Master Shell. 3. Add this 13-PAAW-TH48 widget. 4. Keep all later complex widgets after the core widgets. Runtime registration: - widgetId: PAAW-TH48 - widgetCode: PAAW-TH48 - categoryId: CAT-11 - railGroup: system - routeId: paaw-th48 - viewId: view-paaw-th48 - initFunction: paawTH48Init - accessLevel: admin, developer Usage: Paste the Blogger widget source into a Blogger HTML/JavaScript widget. The widget must not be embedded inside an iframe destination page. It must register into window.PAAW and render inside the view container created by PAAW-MS01. Dependencies: - Required: window.PAAW from PAAW-MS01. - Required load order: PAAW-IF02 before complex widgets. - Optional: lucide icons. - Optional: Firebase compat SDK if live persistence is added later. Data strategy: The shipped sample code uses in-memory data and local UI state so it can run immediately in Blogger. The Firebase rules and indexes in this package define the production storage direction for live data. ============================================================ 6. TESTING CHECKLIST ============================================================ Installation: [ ] PAAW-MS01 is first in Blogger layout. [ ] PAAW-IF02 is immediately after PAAW-MS01. [ ] PAAW-TH48 is placed after PAAW-MS01 and PAAW-IF02. [ ] Browser console has no duplicate widgetId, routeId, or viewId errors. [ ] Sidebar item appears in the correct category / rail group. Registration: [ ] PAAW.getRegistrySnapshot() includes widgetId PAAW-TH48. [ ] Route paaw-th48 is registered. [ ] View view-paaw-th48 exists. [ ] paawTH48Init is callable. [ ] The widget initializes only when opened or intentionally refreshed. UI / UX: [ ] Header/hero section renders correctly. [ ] Search/filter/action panels work. [ ] Detail/editor/preview sections do not overflow the Master Shell. [ ] Buttons use only prefixed widget classes. [ ] Light theme variables inherit from PAAW-MS01. [ ] The widget does not create a separate shell or iframe controller. Data / Safety: [ ] Dynamic text is safely escaped by the widget helper functions where rendered. [ ] Invalid route handoffs fail safely. [ ] localStorage/private browsing does not crash the page. [ ] Firebase rules are reviewed before production deployment. Responsive: [ ] Desktop layout is clean. [ ] Laptop layout contracts without broken columns. [ ] Tablet layout stacks major panels. [ ] Future mobile shell support can stack the widget internally. ============================================================ 7. FUTURE EXTENSION NOTES ============================================================ 1. Replace local sample arrays with Firestore queries under paawWorkspaces/{workspaceId}/themeManager. 2. Add role-based editing and moderation states through Firebase custom claims. 3. Add Cloud Function audit logging to themeManagerActivity. 4. Add cross-widget handoff events using the PAAW event namespace. 5. Connect PAAW-UA44 to measure route opens, exports, searches, and edits. 6. Connect PAAW-TH48 theme presets to validate light/dark visual consistency. END OF FILE

Posts

Showing posts with the label STRUCTURED-ESSAY

Show all

PAAW | A/L Physics | 2020 | Sinhala Medium | Physics II | Part A | Structured Essay

July 07, 2026

PAAW | අ.පො.ස. උසස් පෙළ භෞතික විද්‍යාව | 2020 | Physics II | Part A | Structured Essay අධ්‍යයන පොදු සහතික පත්‍ර (උසස් පෙළ) විභාගය, 2020 භෞතික විද්‍යාව II භෞතික විද්‍යාව II 01 E II පැය තුනයි PART A — ව්‍යුහගත රචනා මෙම ප්‍රශ්න පත්‍රයේම ප්‍රශ්න හතරටම පිළිතුරු සපයන්න. g = 10 m s -2 සියලුම ප්‍රශ්නවලට මෙම ප්‍රශ්න පත්‍රයේම පිළිතුරු සපයන්න. එක් එක් ප්‍රශ්නය සඳහා දී ඇති ඉඩකඩ තුළ ඔබගේ පිළිතුරු ලියන්න. දී ඇති ඉඩකඩ පිළිතුරු සඳහා ප්‍රමාණවත් වන අතර, අතිවිස්තරාත්මක පිළිතුරු අපේක්ෂා නොකෙරේ. 1. හෙලිකල් ස්ප්‍රිංගයක ස්ප්‍රිංග නියතය ( k ) බරට සාපේක්ෂව දිගුවේ ප්‍රස්තාරයක් ඇඳීමෙන් නිර්ණය කිරීමට ඔබගෙන් ඉල්ලා ඇත. රූපයේ දැක්වෙන පරීක්ෂණ සැකසුමේදී, ස්ප්‍රිංගයේ එක් අගයක් ස්කේල් තට්ටුවකට සම්බන්ධ කර ඇති අතර අනෙක් අගය ස්ථාවරයකට තදින් සම්බන්ධ කර ඇත. ස්කේල් තට්ටුවේ හා ස්ප්‍රිංගයේ ස්කන්ධ නොගණනීය යැයි උපකල්පනය කරන්න. M ස්ථාවරය ස්ප්‍රිංගය දර්ශකය ස්කේල් තට්ටුව මීටර් රූල (a) බලයක් F ස්ප්‍රිංගයට යෙදූ විට, ස්ප්‍රිංගයේ දිග x ප්‍රමාණයකින් වැඩි වේ. F සඳහ...

PAAW | A/L Physics | 2020 | Physics II | Part A | Structured Essay

July 07, 2026

PAAW | A/L Physics | 2020 | Physics II | Part A | Structured Essay General Certificate of Education (Adv. Level) Examination, 2020 Physics II Physics II 01 E II Three hours PART A — Structured Essay Answer all four questions on this paper itself. g = 10 m s -2 Answer all the questions on this paper itself. Write your answers in the space provided for each question. The space provided is sufficient for your answers and extensive answers are not expected. 1. You are asked to determine the spring constant ( k ) of a helical spring by plotting a graph of extension against load. In the experimental setup shown in the figure, one end of the spring is attached to a scale pan and the other end is firmly connected to a stand. Assume that the masses of the scale pan and the spring are negligible. M Stand Spring Pointer Scale pan Metre ruler (a) When a force F is applied to the spring, the length of the spring is increased by...

Desktop View Required

Workspace Ready — Unified Shell Foundation

Unified Navigation Registry

Route Not Available

Workspace Dashboard

Workspace Statistics

Complex Widget Shortcuts

Basic Page Shortcuts

Recently Used Tools

System Status

Future Analytics Preview

Admin Guidance

Resource Library

Past Paper Manager

A/L Physics Past Paper Workspace

Selection Flow Panel

Paper Section Results

Paper URL Registry

Social Post Prompt Studio

Prompt Controls

Generated Output

Prompt Template Library

Generated History & Saved Presets