===============================================
8. Teams, Billing, Admin y Troubleshooting
===============================================

Objetivo
========

Operar colaboracion de equipos, ciclo de suscripcion y controles admin con resultados predecibles.

Gestion de equipos
==================

1. Abrir ``Teams``.
2. Crear team o abrir team existente.
3. Invitar miembros por email.
4. Asignar rol por miembro (owner/admin/member segun politica).
5. Validar que cada usuario ve solo modulos autorizados.

Billing y ciclo de plan
=======================

1. Abrir seccion de perfil/billing.
2. Validar estado de plan actual (Free, Pro, Team).
3. Ejecutar upgrade cuando aplique:
   - Free -> Pro.
   - Pro -> Team.
4. Confirmar actualizacion de estado despues del checkout.
5. Validar que permisos Team quedan habilitados.

Controles Admin
===============

1. Abrir ``Admin`` (solo roles autorizados).
2. Revisar:
   - Audit logs.
   - Estado operativo.
   - Controles tenant/team.
3. Aplicar cambios solo con ticket/aprobacion.

Checklist de validacion funcional
=================================

1. Invitacion, aceptacion y rol de team completan correctamente.
2. Upgrade de plan refleja permisos y estado en UI.
3. Estado de suscripcion persiste tras logout/login y refresh.
4. Paginas admin no son accesibles por roles no autorizados.
5. Errores de billing son explicitos y sin estado ambiguo.

Resultado esperado
==================

1. Colaboracion y billing funcionan de punta a punta.
2. Admin puede diagnosticar incidencias sin corromper datos.

Playbook rapido de recuperacion
===============================

1. Problema de sesion:
   - Logout/login y validar estado de cuenta.
2. Modulo/dato faltante:
   - Validar proyecto activo y permisos.
3. Billing inconsistente:
   - Verificar provider de suscripcion y owner del team.
4. UI obsoleta:
   - Hard refresh y reintentar una vez.

Imagen
======

.. image:: ../../_static/user-manual/common/teams-billing.png
   :alt: Membresia de team y estado de billing
   :width: 65%

Controles de team y billing desde perfil/workspace.