| Category | Requirement | |----------|-------------| | Scalability | Horizontal scaling of crawlers (up to 10 k new URLs/hour). Transcoder pool auto‑scales based on pending jobs. | | Latency | Video start‑up < 3 seconds on 3G; < 1 second on 4G/5G. | | Availability | 99.9 % SLA for the playback API; CDN guarantees 99.95 % edge availability. | | Data Privacy | No personal data is stored from the source sites; only user‑generated data (watch history) resides in our DB, encrypted at rest. | | Compliance | DMCA takedown workflow, GDPR‑style user data export & deletion endpoints. | | Observability | Prometheus metrics for crawl success rate, transcoding queue depth, playback errors. Grafana dashboards for ops. | | Accessibility | WCAG 2.1 AA compliance – captions, keyboard navigation, high‑contrast mode. |
| Risk | Impact | Mitigation | |------|--------|------------| | Copyright infringement | Legal & platform takedown | Only ingest publicly‑accessible URLs; provide easy DMCA takedown flow; partner agreements for whitelist domains. | | FLV source instability | Playback failures | Automatic fallback to original FLV URL via RTMP if transcoding fails; monitor source health. | | Heavy transcoding cost | Budget overrun | Use GPU‑accelerated instances; implement on‑demand transcoding only for videos with ≥ X views. | | Search relevance for Tagalog | Poor user experience | Custom analyzer with Tagalog stop‑words; periodic relevance tuning using click‑through data. | | Network latency in Southeast Asia | Buffering & churn | Deploy edge nodes in Manila, Jakarta, Singapore; pre‑warm popular segments. | | Endpoint | Method | Description | Example
| Endpoint | Method | Description | Example |
|----------|--------|-------------|---------|
| /api/v1/search | GET | Query across all sources. Parameters: q, lang, duration_min, duration_max, source | /api/v1/search?q=walang+malay&lang=tl |
| /api/v1/video/id | GET | Returns JSON with metadata, HLS URL, subtitle URLs, and highlight link. | /api/v1/video/12345 |
| /api/v1/highlight/id | GET | Direct link to the auto‑generated highlight clip. | /api/v1/highlight/12345 |
| /api/v1/partner/stats | GET (OAuth) | Partner‑specific aggregated stats. | /api/v1/partner/stats?site=libug.com |
| /api/v1/auth/token | POST | OAuth2 token exchange. | – | provide easy DMCA takedown flow
All responses are JSON‑API compliant, with pagination via links and meta. pre‑warm popular segments. |