docs: update frontend architecture documentation

Update frontend architecture documentation across all three frontends
(admin, vendor, shop) to reflect current implementation:

- Document template inheritance patterns
- Update Alpine.js component usage
- Add CDN fallback strategy references
- Clarify context variable usage
- Update template structure diagrams

Also update base templates with improved comments and organization.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/frontend/admin/architecture.md

@@ -586,9 +586,11 @@ Optimization Techniques:
    • Server-side pagination
    • Load only needed data
 
-5. CDN Assets
-   • Tailwind CSS from CDN
-   • Alpine.js from CDN
+5. CDN Assets with Fallback
+   • Tailwind CSS from CDN (fallback to local)
+   • Alpine.js from CDN (fallback to local)
+   • Works offline and in restricted networks
+   • See: [CDN Fallback Strategy](../cdn-fallback-strategy.md)
 
 6. Initialization Guards
    • Prevent duplicate setups

docs/frontend/overview.md

@@ -163,12 +163,13 @@ All three frontends share the same core technologies:
 | Backend | FastAPI | REST API + routing |
 | Templates | Jinja2 | Server-side rendering |
 | Interactivity | Alpine.js 3.x | Client-side reactivity |
-| Styling | Tailwind CSS 2.x | Utility-first CSS |
+| Styling | Tailwind CSS 2.x | Utility-first CSS (CDN + fallback) |
 | Icons | Heroicons | SVG icon system |
 | HTTP Client | Fetch API | API requests |
 | State Management | Alpine.js reactive | No external state lib |
 | Logging | Custom LogConfig | Centralized logging |
 | Error Handling | Custom exceptions | Structured errors |
+| Asset Loading | CDN with fallback | Offline support - [Details](cdn-fallback-strategy.md) |
 
 ### Why This Stack?
 
@@ -179,6 +180,7 @@ All three frontends share the same core technologies:
 - ✅ Small bundle sizes
 - ✅ Easy to learn and maintain
 - ✅ Python developers can contribute to frontend
+- ✅ Works offline with CDN fallback (see [CDN Fallback Strategy](cdn-fallback-strategy.md))
 
 ---
 

docs/frontend/vendor/architecture.md

@@ -492,9 +492,11 @@ Optimization Techniques:
    • Server-side pagination
    • Load only needed data
 
-5. CDN Assets
-   • Tailwind CSS from CDN
-   • Alpine.js from CDN
+5. CDN Assets with Fallback
+   • Tailwind CSS from CDN (fallback to local)
+   • Alpine.js from CDN (fallback to local)
+   • Works offline and in restricted networks
+   • See: [CDN Fallback Strategy](../cdn-fallback-strategy.md)
 
 
 🧪 TESTING APPROACH