LifeRPG_v2.0/modern/docs/admin-ops.md
TLimoges33 7fe4ae5365
🧙‍♂️ Transform LifeRPG into The Wizard's Grimoire - Production-Ready Application
 Major Features Added:
- Complete magical theming and rebranding from LifeRPG to The Wizard's Grimoire
- Production-grade React frontend with Tailwind CSS v4 and magical aesthetics
- Comprehensive analytics dashboard with Recharts integration (ScryingPortal)
- Push notifications system with PWA service worker support
- Drag & drop functionality using @dnd-kit for habit reordering
- Social features with friends system and leaderboards
- Performance optimization tools and monitoring
- Mobile app enhancement with PWA installation support

🏗️ Technical Infrastructure:
- Advanced service worker with offline support and background sync
- Zustand state management for scalable application state
- Production-ready UI component system with enhanced Button, Card, Input
- Progressive Web App (PWA) with manifest and app installation
- FastAPI backend with comprehensive API endpoints
- Docker containerization and CI/CD pipeline setup

📱 Progressive Web App Features:
- Offline functionality with intelligent caching
- Push notification support for habit reminders
- App installation on mobile and desktop platforms
- Background sync for offline data management
- Performance monitoring and optimization tools

🎨 User Experience:
- Magical wizard/grimoire theming throughout application
- Responsive design optimized for all device sizes
- Drag & drop habit management with smooth animations
- Interactive analytics with multiple chart types
- Social connectivity with friends and competitive features
- Comprehensive notification and performance settings

🔧 Developer Experience:
- Modern development stack with Vite and React
- Comprehensive testing setup and CI/CD pipelines
- Code quality tools with pre-commit hooks
- Docker development environment
- Detailed documentation and implementation guides

This represents a complete transformation from prototype to production-ready application with enterprise-grade features and magical user experience.
2025-08-30 17:32:42 +00:00

29 lines
1.4 KiB
Markdown

# Admin operations guide
This page summarizes admin/ops capabilities and where to find them.
API endpoints (all under /api/v1):
- GET /admin/orchestration — current in-flight counts, queue depths, effective provider caps, and RQ queue length.
- GET/POST /admin/provider_caps — view/update per-provider concurrency caps (persisted); reflected in metrics and enqueue logic.
- GET /admin/hooks/schema — JSON schema and examples for hooks configuration to aid validation.
- POST /admin/hooks/validate — validate a hooks object server-side before saving.
- GET /admin/email/health — show email transport config and attempt an SMTP handshake when enabled.
- POST /admin/email/test — send a test email to verify delivery.
Frontend UI:
- Integrations page includes:
- Provider caps editor (view/edit) and orchestration summary with manual refresh, auto-refresh, sorting, and cap utilization badges.
- Hooks editor with example prefill and server-side validation, showing inline errors.
- Admin settings controls for integration close mode and default sync interval.
Metrics to watch (Prometheus):
- sync_inflight, sync_queue_depth, sync_provider_cap, rq_queue_length
- sync_enqueue_skips_total{reason}
- sync_job_duration_seconds (histogram by provider,result)
Alerts (Prometheus examples in ops/prometheus-alerts.yaml):
- Provider at cap for sustained periods
- Queue depth increasing
- RQ queue backlog sustained
- Slow syncs (p95 duration) exceeding threshold