Vista VC
KPI autorevoli lato server per gli investitori. Basati su view SQL nello schema public, con suffisso _vc_view. I numeri qui riflettono ciò che è arrivato sul server, non ciò che il client ha emesso come telemetria — sono la fonte di verità per le ore rilevanti ai fini del pagamento e per la crescita del dataset.
investor_daily_recording_kpis_vc_view
Una riga per activity_day. La view è oggi l'unica superficie di KPI rivolta agli investitori.
| Colonna | Tipo | Significato |
|---|---|---|
activity_day | date | Giorno di attività. |
dataset_start_day | date | Primo giorno con qualsiasi attività registrata nel dataset. |
active_players | bigint | Giocatori distinti con almeno una sessione in quel giorno. |
total_sessions_seen | bigint | Tutte le sessioni osservate dal server, indipendentemente dallo stato di upload. |
sessions_with_uploads | bigint | Sessioni con almeno un artefatto caricato. |
valid_current_sessions | bigint | Sessioni che soddisfano il contratto attuale di artefatti richiesti (coppia MP4 + CSV). |
valid_future_triplet_sessions | bigint | Sessioni che soddisfano il contratto futuro a tripletta (MP4 + CSV + JSON). Usate per monitorare il livello di readiness per il rollover di schema. |
partial_upload_sessions | bigint | Sessioni con alcuni ma non tutti gli artefatti richiesti. |
uploaded_files | numeric | Totale degli artefatti caricati nel giorno. |
mp4_files / csv_files / json_files / ogg_files | numeric | Conteggi degli artefatti per tipologia. |
uploaded_size_bytes / uploaded_size_gb / uploaded_size_pretty | bigint / numeric / text | Volume giornaliero di upload. |
sessions_with_known_duration | bigint | Sessioni per cui è registrata una durata misurata. |
known_recorded_seconds / known_recorded_hours | bigint / numeric | Durata registrata per le sessioni con durata nota. |
known_valid_current_recorded_seconds / ..._hours | bigint / numeric | Durata registrata limitata a valid_current_sessions. Il valore rilevante per i pagamenti. |
cumulative_known_recorded_seconds / ..._hours | numeric | Totale progressivo a partire da dataset_start_day. |
duration_coverage_pct_for_valid_current_sessions | numeric | Frazione di valid_current_sessions per le quali è nota una durata. |
A cosa risponde questa view
- Quante ore di gameplay validato abbiamo accumulato fino a oggi? →
cumulative_known_recorded_hours(ultima riga). - Quanti giocatori sono stati attivi ieri/questa settimana? →
active_players. - Quale frazione delle sessioni registrate ha superato il contratto di upload? →
valid_current_sessions / total_sessions_seen. - Quanto siamo vicini alla readiness per la tripletta? →
valid_future_triplet_sessions / valid_current_sessions.
Relazione con le dashboard OTEL
La dashboard OTEL Audience riporta DAU e distribuzione delle versioni a partire dagli eventi emessi dal client. I numeri qui non corrisponderanno esattamente a quelli di Audience: questa view conta i giocatori le cui sessioni hanno raggiunto Supabase; Audience conta gli utenti i cui client hanno emesso qualsiasi telemetria. Le due metriche divergono per i client offline-ma-attivi e per i client che emettono telemetria senza produrre una registrazione.
Per il reporting agli investitori, preferire questa view. Per la visibilità ingegneristica sul funnel di registrazione, preferire Audience e Capture Pipeline (client).
Principi sui KPI
- Granularità giornaliera per default.
- Le ore rilevanti per i pagamenti provengono da
known_valid_current_recorded_*, non dalknown_recorded_*grezzo (che include sessioni che non hanno soddisfatto il contratto di upload). - Le colonne
size_bytessono in byte;size_gbè la conversione di comodo. - Il dataset di riferimento è
public.recording_sessions+public.s3_uploads; questa view è un livello di presentazione sopra a quelle tabelle.
Lavori aperti
- Confermare il vocabolario finale per lo status terminale / failure-reason di
recording_sessions. - Decidere se materializzare la view con uno schedule di refresh una volta che i volumi giornalieri cresceranno.