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

Goal
====

Operate team collaboration, subscription lifecycle, and admin controls with predictable outcomes.

Teams management
================

1. Open ``Teams``.
2. Create team or open existing team workspace.
3. Invite members by email.
4. Assign role per member (owner/admin/member according to policy).
5. Validate invited user can access only authorized modules.

Billing and plan lifecycle
==========================

1. Open profile/billing section.
2. Validate current plan state (Free, Pro, Team).
3. Execute upgrade flow when needed:
   - Free -> Pro.
   - Pro -> Team.
4. Confirm billing status updates after successful checkout.
5. Verify team entitlements are unlocked for Team plan.

Admin controls
==============

1. Open ``Admin`` (authorized roles only).
2. Review:
   - Audit logs.
   - Operational status pages.
   - Tenant/team controls.
3. Apply changes only with change ticket or approval workflow.

Functional validation checklist
===============================

1. Team invite, acceptance, and role assignment complete successfully.
2. Plan upgrades reflect in UI and permission model.
3. Subscription status survives logout/login and refresh.
4. Admin pages are inaccessible to unauthorized roles.
5. Billing errors are explicit and do not leave ambiguous plan state.

Expected result
===============

1. Collaboration and plan controls work end-to-end.
2. Operational admins can diagnose issues without data corruption.

Troubleshooting quick playbook
==============================

1. Session/auth issue:
   - Logout/login and validate account state.
2. Missing module/data:
   - Validate active project and role permissions.
3. Billing mismatch:
   - Verify subscription provider status and team ownership.
4. UI stale state:
   - Hard refresh and rerun last action once.

Screenshot
==========

.. image:: ../../_static/user-manual/common/teams-billing.png
   :alt: Team membership and billing status
   :width: 65%

Team and billing controls from profile/workspace context.