Files
Andrew Beveridge ☄️andClaude Opus 4.6 937f8f7ec1 feat: YouTube quota GCP monitoring + legacy beta cleanup (#460)
## Summary
- Remove the deprecated beta enrollment system (endpoints, models, email
templates, admin UI, rate limits) — ~20 files cleaned
- Remove legacy count-based YouTube upload tracking from
rate_limit_service and dead blocklist methods
- Add GCP Cloud Monitoring integration to cross-reference YouTube API
quota usage with Firestore tracking
- Add drift detection (alerts when GCP reported vs Firestore tracked
differs >10%)
- Display GCP quota data in admin rate-limits dashboard

## Changes

### Backend (15 files)
- **Removed:** 5 beta endpoints, `BetaTesterStatus` enum, beta User
fields, beta email templates, `validate_email_for_beta()`, deprecated
YouTube/beta rate limit methods, dead blocklist CRUD methods
- **Added:** `get_gcp_quota_usage()` to `YouTubeQuotaService` with Cloud
Monitoring API query, 5-min cache, and drift detection
- **Updated:** Rate limits API response model with GCP quota fields
(`gcp_quota_available`, `gcp_quota_units_consumed`, `quota_drift`,
`quota_drift_alert`)

### Frontend (11 files)
- **Deleted:** `frontend/app/admin/beta/page.tsx` (entire beta admin
page)
- **Removed:** Beta sidebar nav, layout breadcrumb, admin stats card,
beta types/API methods, legacy YouTube stats cards
- **Added:** GCP Cloud Monitoring section in rate-limits page showing
reported usage, delay, and drift alerts

### Tests (4 files)
- Removed 8 obsolete tests for deprecated methods
- Created `test_gcp_quota_monitor.py` with 10 tests covering GCP quota
querying, caching, fallbacks, and drift detection
- Updated mock data and assertions across test files

### Docs (3 files)
- Removed beta endpoint docs from API.md, added GCP quota fields
- Updated ARCHITECTURE.md with Cloud Monitoring integration
- Removed beta program section from PRODUCT-VISION.md

## Test plan
- [x] All 2265 backend tests pass (1 pre-existing failure unrelated)
- [x] All 516 frontend Jest tests pass
- [x] New GCP quota monitor tests cover success, caching, fallbacks,
drift alerts
- [ ] Verify admin rate-limits page no longer shows beta/legacy cards
- [ ] Verify GCP quota section shows "unavailable" gracefully when
monitoring data not yet populated

@coderabbitai ignore

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

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 20:48:07 -05:00

110 lines
3.6 KiB
Python
Executable File

#!/usr/bin/env python3
"""
Preview email templates by generating HTML files.
Usage:
python scripts/preview-emails.py
This will create HTML files in /tmp/email-previews/ that can be opened in a browser.
"""
import os
import sys
from pathlib import Path
# Add parent directory to path for imports
sys.path.insert(0, str(Path(__file__).parent.parent))
# Set dummy env vars before importing
os.environ.setdefault("FRONTEND_URL", "https://gen.nomadkaraoke.com")
from backend.services.email_service import EmailService, PreviewEmailProvider
from backend.services.template_service import TemplateService
def main():
output_dir = Path("/tmp/email-previews")
output_dir.mkdir(exist_ok=True)
# Create email service with preview provider to capture HTML
preview_provider = PreviewEmailProvider()
email_service = EmailService()
email_service.provider = preview_provider
# Create template service for realistic message content
template_service = TemplateService()
print(f"Generating email previews in {output_dir}...")
# Magic link email
email_service.send_magic_link("user@example.com", "abc123xyz")
save_preview(output_dir, "magic_link", preview_provider)
# Credits added email
email_service.send_credits_added("user@example.com", credits=5, total_credits=8)
save_preview(output_dir, "credits_added", preview_provider)
# Welcome email
email_service.send_welcome_email("user@example.com", credits=3)
save_preview(output_dir, "welcome", preview_provider)
# Feedback request email
email_service.send_feedback_request_email(
"user@example.com",
feedback_url="https://forms.example.com/feedback",
job_title="Taylor Swift - Love Story",
)
save_preview(output_dir, "feedback_request", preview_provider)
# Job completion email - use template service for realistic content
job_completion_content = template_service.render_job_completion(
name="there",
youtube_url="https://www.youtube.com/watch?v=abc123",
dropbox_url="https://www.dropbox.com/folder/example",
artist="Taylor Swift",
title="Love Story",
job_id="abc123",
feedback_url="https://forms.example.com/feedback",
)
email_service.send_job_completion(
to_email="user@example.com",
message_content=job_completion_content,
artist="Taylor Swift",
title="Love Story",
brand_code="NOMAD-1234",
)
save_preview(output_dir, "job_completion", preview_provider)
# Action reminder (lyrics) email - use template service for realistic content
lyrics_reminder_content = template_service.render_action_needed_lyrics(
name="there",
artist="Taylor Swift",
title="Love Story",
review_url="https://gen.nomadkaraoke.com/lyrics/?baseApiUrl=...",
)
email_service.send_action_reminder(
to_email="user@example.com",
message_content=lyrics_reminder_content,
action_type="lyrics",
artist="Taylor Swift",
title="Love Story",
)
save_preview(output_dir, "action_reminder", preview_provider)
print(f"\nOpen these files in a browser to preview the emails.")
print(f"Example: open {output_dir}/magic_link.html")
def save_preview(output_dir: Path, name: str, provider: PreviewEmailProvider):
"""Save the captured HTML to a file."""
html = provider.get_last_html()
if html:
output_file = output_dir / f"{name}.html"
output_file.write_text(html)
print(f" Created: {output_file}")
else:
print(f" ERROR: No HTML captured for {name}")
if __name__ == "__main__":
main()