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

Objetivo
========

Operar colaboracao de times, ciclo de assinatura e controles admin com resultado previsivel.

Gestao de times
===============

1. Abrir ``Teams``.
2. Criar time ou abrir time existente.
3. Convidar membros por email.
4. Definir papel por membro (owner/admin/member conforme politica).
5. Validar que cada usuario acessa apenas modulos autorizados.

Billing e ciclo de plano
========================

1. Abrir secao de perfil/billing.
2. Validar estado de plano atual (Free, Pro, Team).
3. Executar upgrade quando necessario:
   - Free -> Pro.
   - Pro -> Team.
4. Confirmar atualizacao de status apos checkout.
5. Validar habilitacao dos recursos de Team.

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

1. Abrir ``Admin`` (somente papeis autorizados).
2. Revisar:
   - Audit logs.
   - Estado operacional.
   - Controles de tenant/team.
3. Aplicar mudancas apenas com ticket/aprovacao.

Checklist de validacao funcional
================================

1. Convite, aceite e papel de time concluem com sucesso.
2. Upgrade de plano reflete no estado e permissoes da UI.
3. Status de assinatura persiste apos logout/login e refresh.
4. Paginas admin ficam bloqueadas para papeis nao autorizados.
5. Erros de billing sao explicitos e sem estado ambiguo.

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

1. Colaboracao e billing funcionam ponta a ponta.
2. Admin diagnostica incidentes sem corromper dados.

Playbook rapido de recuperacao
==============================

1. Problema de sessao:
   - Logout/login e validar estado da conta.
2. Modulo/dado ausente:
   - Validar projeto ativo e permissoes.
3. Billing inconsistente:
   - Verificar provider da assinatura e owner do time.
4. UI desatualizada:
   - Hard refresh e repetir ultima acao.

Imagem
======

.. image:: ../../_static/user-manual/common/teams-billing.png
   :alt: Membros de team e status de billing
   :width: 65%

Controles de time e billing no perfil/workspace.