Organizaciones

Una organización es la unidad de membresía y facturación en Kisenon. Cada proyecto — y por tanto cada rama, endpoint, rol y base de datos bajo él — pertenece a exactamente una organización.

Qué es una organización

Cuando inicias sesión por primera vez, Kisenon crea una organización personal para ti y te convierte en su owner. Puedes trabajar enteramente dentro de ella, o crear una organización de equipo más tarde e invitar a otros.

Las organizaciones poseen las cosas a las que se adjuntan la membresía y el dinero:

• Proyectos. Cada proyecto vive en una organización; los nombres de proyecto solo necesitan ser únicos dentro de ella.
• Facturación. El plan, las cuotas y el uso se contabilizan por organización.
• Auditoría. El registro de operaciones tiene alcance de organización — cada miembro puede leer la actividad de cada proyecto en la organización.

Miembros y roles

Cada membresía lleva uno de cuatro roles. La consola pre-restringe la UI por rol; el plano de control aplica el mismo mínimo del lado del servidor, de modo que un cliente que se salta la restricción igualmente recibe un 403. Cada acción tiene un rol mínimo — cualquiera en o por encima de él puede realizarla.

Los roles se ordenan viewer < member < admin < owner. Un viewer es de solo lectura; un member puede construir (proyectos, ramas, endpoints, claves) pero no gestionar personas; un admin añade la gestión de miembros e invitaciones; un owner además controla la facturación, la transferencia de propiedad y la eliminación.

Cambiar de organización

La organización activa es parte de tu sesión. El selector de organizaciones se encuentra en la barra superior de la consola: muestra la organización activa y un desplegable de cada organización a la que perteneces, cada una etiquetada con tu rol allí.

Elegir otra organización hace un POST a /api/auth/switch-org, que reacuña tu token de sesión con alcance a la organización de destino y recarga en sus proyectos. Desde el mismo desplegable también puedes llegar a Members y Org settings, o crear una nueva organización.

En la CLI, la organización activa es por credencial. Establécela con:

keon orgs switch <org-id>

que escribe default_org_id en tus credenciales almacenadas. Puedes anularlo para una sola invocación con --org-id o la variable de entorno KEON_ORG_ID. Cada clave de API está vinculada a una organización cuando se crea; el plano de control autoriza esa clave solo contra su organización vinculada.

Gestión

• Renombrar. En Org settings → Identity, los admins y superiores pueden renombrar la organización.
• Roles de miembros. Desde la página Members de la organización, los admins y superiores cambian el rol de un miembro o lo eliminan. El plano de control rechaza cualquier cambio que degradaría o eliminaría al último owner.
• Facturación. En Settings → Billing, el owner o el rol de billing gestiona el método de pago, las facturas y el coste por proyecto — consulta Facturación.
• Salir. La Danger Zone en Org settings (y keon orgs leave) te elimina de la organización. Si eres el único owner, el plano de control bloquea la solicitud — promueve a alguien más, o transfiere la propiedad, antes de salir.

Relacionado

• Invitaciones — añadir personas a una organización.
• Facturación — plan, cuotas y uso, con alcance por organización.
• Proyectos — lo que contiene una organización.