# Design do Manus IPTV Player

## Direção do produto

O Manus IPTV Player será um reprodutor técnico para listas e contas Xtream Codes fornecidas pelo próprio usuário. A experiência visual terá a clareza de um catálogo de streaming moderno, com navegação simples, fundo escuro, cartões de conteúdo e ações de alto contraste. A interface será original, usando apenas padrões de interação familiares em players IPTV e não reproduzindo marca, ícones ou telas proprietárias de outros aplicativos.

O design assume **iPhone em orientação retrato (9:16)** e uso com uma mão. A ação principal de cada tela ficará na metade inferior ou em uma área facilmente alcançável pelo polegar. O aplicativo usará Safe Area, tipografia de tamanho legível, áreas de toque de pelo menos 44 pontos e feedback visual imediato em botões e cards.

## Lista de telas

| Tela | Conteúdo principal | Funcionalidade |
|---|---|---|
| Boas-vindas / Login | Marca do app, breve explicação e campos URL do servidor, usuário e senha | Normalizar a URL, validar campos, conectar à API Xtream, mostrar erros de rede/credenciais e permitir lembrar a conta |
| Carregando catálogo | Indicador de progresso e mensagem contextual | Buscar informações da conta, categorias e primeiros conteúdos; oferecer cancelamento quando possível |
| Início | Cabeçalho com nome da conta, busca, atalhos TV ao vivo/Filmes/Séries, seção Continue assistindo e Favoritos | Navegar para catálogos, abrir conteúdo, buscar e sair da conta |
| TV ao vivo | Abas Todas, Favoritos e categorias | Filtrar canais, pesquisar, marcar favorito e abrir o player |
| Filmes | Destaque compacto, busca, categorias e grade de pôsteres | Filtrar por categoria, abrir detalhes, favoritar e reproduzir |
| Séries | Categorias e lista de séries | Abrir detalhes, visualizar temporadas/episódios e reproduzir um episódio |
| Detalhes | Pôster, título, metadados, sinopse, categoria e ações | Reproduzir, favoritar e, para séries, escolher temporada e episódio |
| Player | Vídeo em tela cheia, título do conteúdo e controles | Play/pause, barra de progresso quando disponível, seleção de áudio/legenda quando suportado, Picture in Picture e retorno ao catálogo |
| Configurações | Conta conectada, lembrar login, tema, preferências de reprodução e sair | Limpar credenciais, trocar conta e ajustar preferências locais |
| Estado vazio / erro | Mensagem clara, causa provável e ação de recuperação | Tentar novamente, voltar ao login ou revisar a fonte Xtream |

## Identidade visual

A paleta combina **azul petróleo profundo**, **violeta elétrico** e **branco frio**, criando uma aparência premium sem depender de preto absoluto em todos os componentes. O fundo principal será `#09111F`, superfícies `#111D30`, bordas `#22314A`, texto principal `#F4F7FB`, texto secundário `#93A4BD`, cor primária `#5C7CFA`, destaque secundário `#9B6DFF` e sucesso `#36D399`. O estado de erro usará `#FF6B7A` e alertas `#F5B94C`.

A marca usará um símbolo abstrato de **play dentro de uma moldura de tela**, com linhas suaves e preenchimento azul-violeta. O ícone deverá preencher o quadrado sem cantos arredondados embutidos, para funcionar corretamente como ícone do sistema.

## Layout e componentes

A tela de login terá um cabeçalho compacto com o símbolo da marca, uma frase curta e um cartão elevado contendo os três campos. O campo URL mostrará um exemplo de formato, mas não deixará um servidor funcional pré-preenchido. O botão **Conectar** será largo e ficará acima da área inferior segura; abaixo dele haverá a opção **Usar última conta** somente quando houver credenciais salvas.

A tela inicial usará uma barra superior com saudação e ações de busca/configurações, seguida de um painel de status da conta. Os atalhos principais serão cards horizontais com ícones de TV, filme e série. Os catálogos serão listas com `FlatList`, evitando renderizações longas em `ScrollView`. Para TV ao vivo, a prioridade será legibilidade do nome do canal e troca rápida; para filmes e séries, a prioridade será a arte do pôster e a descoberta por categorias.

A navegação inferior terá quatro destinos: **Início**, **Ao vivo**, **Filmes** e **Mais**. Séries e configurações serão acessíveis por Início e Mais para evitar excesso de tabs em telas pequenas. A tab bar manterá contraste adequado, altura compatível com o indicador de início do iPhone e ícones SF Symbols mapeados para Android/web durante o desenvolvimento.

## Fluxos principais

### Primeiro acesso

1. O usuário abre o app e vê a tela de login.
2. Informa URL do servidor, usuário e senha.
3. Toca em **Conectar**.
4. O app normaliza a URL, chama `player_api.php` com os parâmetros Xtream e valida o status da conta.
5. Em caso de sucesso, salva as credenciais com SecureStore no iOS e carrega o catálogo.
6. Em caso de erro, preserva os campos, informa uma mensagem compreensível e permite tentar novamente.

### Retorno ao app

1. O app verifica se existem credenciais salvas.
2. Mostra uma tela de carregamento curta enquanto consulta a conta.
3. Se a conta continuar válida, abre Início.
4. Se a fonte estiver indisponível ou expirada, abre o erro com as ações **Tentar novamente** e **Trocar conta**.

### Reprodução

1. O usuário escolhe uma categoria e toca em um item.
2. O app abre os detalhes ou inicia a reprodução direta para canais ao vivo.
3. O player usa a URL de stream derivada da resposta Xtream, sem embutir fontes de terceiros.
4. O usuário pode pausar, retornar ao catálogo, ativar Picture in Picture quando disponível e marcar o conteúdo como favorito.

### Troca de conta

1. O usuário abre Mais e entra em Configurações.
2. Toca em **Sair desta conta**.
3. O app remove as credenciais salvas, limpa o estado de catálogo e retorna ao login.

## Acessibilidade e comportamento

Todos os controles terão rótulos acessíveis, contraste mínimo de texto adequado e feedback de toque. A busca terá teclado com ação de conclusão. Os estados de carregamento não dependerão apenas de cor ou animação. Erros indicarão o próximo passo em linguagem simples, sem expor detalhes sensíveis da senha ou da URL completa.

## Decisões de escopo inicial

A primeira versão implementará login Xtream, carregamento de categorias, catálogos básicos, favoritos locais, logout e reprodução de vídeo. EPG avançado, múltiplos perfis, controle parental e sincronização entre dispositivos ficam fora do primeiro ciclo até serem confirmados.