Empezando

Dos roles, dos puntos de partida

Tu invitación determina lo que tenés que hacer el primer día. Elegí el camino que matchea con tu rol.

BA Owner / Account Operator

Explorar y gobernar

Aceptar invitación → sign in → setear contexto de billing → listar workspaces en tu billing account → abrir dashboards en la UI.

No hace falta setup de BigQuery ni autoría de models. Cualquier workspace que tus developers hayan publicado en el billing account está listo para explorar en la UI.

Developer / Analytics Engineer

Construir y publicar

Aceptar invitación → sign in → setear contexto de billing → crear el service account de BigQuery → crear workspace → autorear sources, models, visualizations, dashboards → push.

Esta guía usa BigQuery como camino inicial, así que se configura un service account de BigQuery antes de escribir models. Postgres y MySQL están igual de soportados — mirá Sources si tus datos viven ahí.

Prerequisitos antes de correr comandos

Tenés una invitación a la cuenta target en https://my.looky.studio.
El CLI de Looky está instalado y disponible como looky en tu shell.
Tenés una carpeta local que va a actuar como el linked root (ejemplo: <local_root>).
Sabés el id del billing account en el que tenés que operar (ejemplo: <billing_account_id>).

Secuencia de día cero

Aceptar invitación y verificar tu rol y alcance (Invitación de Owner).
Hacer sign in en la UI, después linkear el CLI a la misma instancia y root (Sign In y conectar el CLI).
Solo developers: Emití un JSON de service account de GCP — lo vas a dejar en la carpeta secrets/ del workspace cuando exista, en el paso siguiente (Acceso al Dataset de BigQuery).
Seteá el contexto de billing, creá el workspace, configurá runtime/sources.runtime.yml, y desplegá las settings con looky push --settings (Creá tu primer workspace).
Invitá más builders solo después de que el primer workspace tenga sus sources desplegadas y al menos un push de content funcione (Invitar developers y colaboradores).

Flow base de comandos

looky login https://my.looky.studio <local_root>
looky whoami

cd <local_root>
looky billing list
looky billing use <billing_account_id>

cd <local_root>/<billing_account_id>
looky create <workspace_slug> --name "My Workspace"
cd <workspace_slug>
looky status

# Editá runtime/sources.runtime.yml con tus valores reales de source
# y dejá el JSON de credenciales en secrets/. Después desplegá:
looky push --settings

# Armá contenido bajo content/ (models, viz, dashboards). Después:
looky validate
looky push

looky login https://my.looky.studio <local_root>
looky whoami

Set-Location <local_root>
looky billing list
looky billing use <billing_account_id>

Set-Location <local_root>\<billing_account_id>
looky create <workspace_slug> --name "My Workspace"
Set-Location <workspace_slug>
looky status

# Editá runtime\sources.runtime.yml con tus valores reales de source
# y dejá el JSON de credenciales en secrets\. Después desplegá:
looky push --settings

# Armá contenido bajo content\ (models, viz, dashboards). Después:
looky validate
looky push

Success criteria antes de pasar a Build Workflow

looky whoami devuelve tu usuario autenticado para el linked root.
looky billing use <billing_account_id> tiene éxito desde <local_root>.
looky status resuelve un workspace id con shape <billing_account_id>/<workspace_slug>.
looky push --settings deploya la config de runtime sources sin errores.

Si alguno de estos falla, parate y arreglalo antes de autorear dashboards. La mayoría de las fallas downstream son fallas de setup disfrazadas. Correr looky validate tiene sentido solo después de que las sources estén deployadas y haya contenido para compilar.