📱 Plotwist - Tarefas para App iOS Nativo

Este documento contém o mapeamento completo das funcionalidades do site web e as tarefas necessárias para criar um aplicativo iOS nativo usando Swift e SwiftUI.

📋 Índice

Setup Inicial
Autenticação
Navegação
Home/Dashboard
Catálogo de Filmes
Catálogo de Séries
Detalhes de Mídia
Sistema de Reviews
Listas Personalizadas
Perfil do Usuário
Coleção do Usuário
Estatísticas
Sistema Social
Busca
Configurações
Internacionalização
Funcionalidades Premium
Importação de Dados

1. Setup Inicial

1.1 Configuração do Projeto

Criar projeto Xcode com SwiftUI
Configurar versões mínimas (iOS 16+)
Configurar SwiftLint para linting
Configurar SwiftFormat para formatação
Configurar esquemas de build (Debug, Release)
Configurar Code Signing & Capabilities

1.2 Gerenciador de Dependências

Escolher Swift Package Manager (SPM) como principal
Configurar estrutura de dependências

1.3 Dependências Principais

Alamofire - Requisições HTTP
Kingfisher - Cache e carregamento de imagens
KeychainAccess - Armazenamento seguro de tokens
SwiftUIIntrospect - Acesso a UIKit quando necessário
Lottie - Animações complexas (opcional)
SwiftUICharts ou Charts (Apple) - Gráficos para estatísticas

1.4 Arquitetura

Padrão MVVM (Model-View-ViewModel)
Combine para gerenciamento de estado reativo
async/await para operações assíncronas
Protocol-oriented programming para abstrações

1.5 Configuração de Ambiente

Criar arquivo de configuração Configuration.swift
Configurar variáveis: API_BASE_URL, TMDB_API_KEY
Criar diferentes configurações para Debug/Release
Usar xcconfig files para variáveis de ambiente

1.6 Estrutura de Pastas

Plotwist/
├── App/
│   ├── PlotwistApp.swift       # Entry point ✅
│   └── RootView.swift          # Root navigation ✅
│   └── AppDelegate.swift       # Lifecycle
├── Core/
│   ├── Network/                 # Networking layer
│   │   ├── APIClient.swift
│   │   ├── APIEndpoint.swift
│   │   └── APIError.swift
│   ├── Storage/                 # Persistência
│   │   ├── UserDefaults/
│   │   ├── Keychain/
│   │   └── CoreData/ (opcional)
│   └── Extensions/              # Swift extensions
├── Models/                      # Modelos de dados (Codable)
├── ViewModels/                  # ViewModels (ObservableObject)
│   └── LoginViewModel.swift    # ✅
├── Views/                       # SwiftUI Views
│   ├── Auth/                    # ✅
│   │   ├── LoginView.swift     # ✅
│   │   └── SignUpView.swift    # ✅ (placeholder)
│   ├── Home/                    # ✅
│   │   └── HomeView.swift      # ✅
│   ├── Movies/
│   ├── Series/
│   ├── Profile/
│   ├── Lists/
│   └── Components/              # Componentes reutilizáveis
├── Services/                    # Serviços de negócio
│   └── AuthService.swift        # ✅
│   ├── MovieService.swift
│   ├── ReviewService.swift
│   └── ...
├── Models/                      # ✅
│   └── User.swift              # ✅
├── Extensions/                  # ✅
│   ├── NotificationName+Extensions.swift  # ✅
│   └── View+Extensions.swift   # ✅
├── Utils/                       # Utilitários ✅
│   ├── Constants.swift         # ✅
│   ├── Localizable.swift       # ✅
│   ├── Formatters.swift
│   └── Validators.swift
├── Resources/
│   ├── Assets.xcassets          # Imagens e cores
│   ├── Localizable/             # i18n strings
│   └── Fonts/
└── Configuration/
    ├── Debug.xcconfig
    └── Release.xcconfig

2. Autenticação

2.1 Views de Auth

2.2 ViewModels

2.3 Gerenciamento de Sessão

AuthService (singleton criado) ✅
- Armazenar JWT no UserDefaults (migrar para Keychain)
- Métodos: signIn(), signOut(), getToken(), isAuthenticated()
- Integração com API
- NotificationCenter para mudanças de estado
Armazenar JWT no Keychain via KeychainAccess (recomendado)
Implementar auto-refresh de token
Interceptor para adicionar token automaticamente
Proteção de rotas com @EnvironmentObject

2.4 Biometria (Opcional)

Face ID / Touch ID para login rápido
LocalAuthentication framework
Salvar preferência no UserDefaults

3. Navegação

3.1 Estrutura de Navegação

3.2 Deep Linking

3.3 Coordenação

Criar Router ou Coordinator para navegação complexa
Implementar NavigationPath gerenciado

4. Home/Dashboard

4.1 Componentes da Home

4.2 ViewModel

HomeViewModel
- Carregar dados em paralelo com async let
- Gerenciar estados de loading/error
- Pagination para reviews

5. Catálogo de Filmes

5.1 Views de Listagem

5.2 Componentes de Filme

5.3 ViewModels

MoviesListViewModel
- @Published var movies: [Movie]
- @Published var filters: MovieFilters
- Métodos de fetch com paginação

6. Catálogo de Séries

6.1 Views de Listagem

6.2 Categorias Especiais

AnimesView
- Filtro pré-aplicado para animação japonesa
- Estilo visual customizado (opcional)
DoramasView
- Filtro pré-aplicado para séries coreanas

6.3 ViewModels

SeriesListViewModel
- Similar ao MoviesListViewModel
- Filtros específicos de séries

7. Detalhes de Mídia

7.1 MovieDetailView

7.2 SeriesDetailView

7.3 SeasonDetailView

7.4 EpisodeDetailView

7.5 PersonDetailView (Ator/Diretor)

7.6 ViewModels

8. Sistema de Reviews

8.1 Componentes de Review

8.2 Listagem de Reviews

8.3 ViewModels

ReviewsViewModel
ReviewFormViewModel

9. Listas Personalizadas

9.1 Views de Listas

9.2 Formulário de Lista

ListFormView
- TextField para título
- TextEditor para descrição
- Picker de visibilidade (Pública, Rede, Privada)
- PhotosPicker para banner
- ImageCropper (opcional, via library)
- Botões "Cancelar" e "Salvar"

9.3 Adicionar Item à Lista

9.4 ViewModels

ListsViewModel
ListDetailViewModel
ListFormViewModel

10. Perfil do Usuário

10.1 ProfileView

10.2 Edição de Perfil

10.3 ViewModels

ProfileViewModel
EditProfileViewModel

11. Coleção do Usuário

11.1 CollectionView

11.2 ViewModels

CollectionViewModel

12. Estatísticas

12.1 StatsView

12.2 ViewModels

StatsViewModel
- Cálculos complexos
- Cache de dados pesados

13. Sistema Social

13.1 Followers/Following

13.2 Busca de Usuários

13.3 Likes

LikeButton com animação
Heart animation (scaleEffect + spring)
Haptic feedback
Sheet de "Curtido por" (lista de usuários)

13.4 ViewModels

FollowersViewModel
FollowingViewModel
UserSearchViewModel

14. Busca

14.1 SearchView

14.2 Command Search (iOS Spotlight-like)

Implementar via .searchable() modifier
Sugestões inline
Navegação por teclado (iPad + teclado externo)

14.3 ViewModels

SearchViewModel
- Combine para debounce
- Gerenciar múltiplas queries

15. Configurações

15.1 SettingsView

15.2 ViewModels

SettingsViewModel

16. Internacionalização

16.1 Idiomas Suportados

16.2 Implementação

Criar Localizable.strings para cada idioma
Converter JSON dos dicionários web para .strings
Usar NSLocalizedString() ou String interpolation
Criar enum LocalizedStringKey helper
Persistir preferência no UserDefaults
Criar LanguageManager para troca em runtime

16.3 Formatação

NumberFormatter para moeda
DateFormatter para datas
RelativeDateTimeFormatter para datas relativas
MeasurementFormatter para horas

17. Funcionalidades Premium (PRO)

17.1 Features PRO

Badge PRO no perfil
Importação de dados externos
[Outras features a definir]

17.2 Integração com In-App Purchase

17.3 ViewModels

SubscriptionViewModel

18. Importação de Dados

18.1 Provedores Suportados

18.2 ImportView

Picker de provedor (Segmented Control)
Botão "Selecionar Arquivo"
ProgressView durante importação
ResultsView com sucesso/falha por item
List de itens importados/falhados

18.3 ViewModels

ImportViewModel
- Processar arquivo em background
- Progress tracking

🎨 Componentes UI Reutilizáveis (SwiftUI)

Componentes Base

Componentes de Mídia

Componentes de Interação

LikeButton (com animação de coração)
FollowButton
StatusMenu (Menu com opções)
AddToListButton
ShareButton (usar UIActivityViewController)

Layouts Customizados

FlowLayout (para chips de gêneros)
WaterfallLayout (para grids irregulares)

📱 Considerações iOS-Specific

UX Nativa

Performance

Offline

Cache Strategy
- URLCache configurado
- Core Data ou Realm para persistência offline
- Queue de ações offline para sincronizar
Network Monitoring
- NWPathMonitor (Network framework)
- Indicador de modo offline
- Retry automático quando conectar

Push Notifications (Futuro)

Widgets (iOS 14+)

App Clips (Opcional)

App Clip para visualização rápida de filme/série
QR Codes para compartilhamento

Siri Shortcuts (Opcional)

Adicionar à watchlist via Siri
Marcar como assistido via Siri
Buscar filme/série via Siri

📊 Estimativa de Complexidade

Módulo	Complexidade	Prioridade
Setup Inicial	Baixa	Alta
Autenticação	Média	Alta
Navegação	Média	Alta
Catálogo de Filmes	Média	Alta
Catálogo de Séries	Média	Alta
Detalhes de Mídia	Alta	Alta
Sistema de Reviews	Alta	Alta
Listas	Alta	Média
Perfil	Média	Alta
Coleção	Média	Média
Estatísticas	Alta	Baixa
Sistema Social	Média	Média
Busca	Baixa	Alta
Configurações	Baixa	Baixa
i18n	Média	Média
Premium/IAP	Alta	Baixa
Importação	Alta	Baixa

🚀 Sugestão de Sprints

Sprint 1 - MVP Base (2-3 semanas)

Setup inicial do projeto Xcode
Arquitetura base (MVVM + Network Layer)
Autenticação (login/cadastro)
Navegação básica (TabView + NavigationStack)
Catálogo de filmes (popular, detalhes básicos)
Busca simples

Sprint 2 - Core Features (2-3 semanas)

Catálogo de séries
Sistema de status (watchlist, watched, etc)
Perfil básico
Coleção do usuário
Deep linking

Sprint 3 - Social Features (2 semanas)

Sistema de reviews completo
Likes com animações
Follow/Unfollow
Feed de atividades
Review replies

Sprint 4 - Listas e Polish (2 semanas)

Listas personalizadas (criar, editar, adicionar itens)
Detalhes de temporadas/episódios
Internacionalização
Performance optimization
Dark mode polish

Sprint 5 - Extras (1-2 semanas)

Estatísticas com gráficos
Configurações avançadas
In-App Purchases (PRO)
Importação de dados
Widgets básicos

Sprint 6 - QA & Publicação (1 semana)

Testes em dispositivos reais
Correção de bugs
App Store assets (screenshots, descrição)
Submissão para App Review

📚 Referências

Backend

API Backend: apps/api/ - Mesma API usada pelo web
Schemas Gerados: apps/web/src/api/endpoints.schemas.ts (referência para modelos Codable)

Web (Referência UI/UX)

Dicionários i18n: apps/web/public/dictionaries/ → converter para .strings
Componentes Web: apps/web/src/components/ (referência de design)
Serviços TMDB: apps/web/src/services/tmdb.ts (referência de lógica)

iOS Resources

Human Interface Guidelines: https://developer.apple.com/design/human-interface-guidelines/
Swift Style Guide: https://google.github.io/swift/
SwiftUI by Example: https://www.hackingwithswift.com/quick-start/swiftui

Bibliotecas Recomendadas

Alamofire: https://github.com/Alamofire/Alamofire
Kingfisher: https://github.com/onevcat/Kingfisher
KeychainAccess: https://github.com/kishikawakatsumi/KeychainAccess
SwiftLint: https://github.com/realm/SwiftLint

🛠 Ferramentas de Desenvolvimento

Xcode Tools

Configurar Instruments para profiling
Usar Memory Graph Debugger
View Hierarchy Debugger para debug de UI

Testing

XCTest para testes unitários
XCUITest para testes de UI
Quick + Nimble (opcional)
Code coverage mínima de 70%

CI/CD

Xcode Cloud ou Fastlane
Automação de builds
TestFlight para beta testing

Documento gerado em: Janeiro 2026 Versão do projeto web: 0.1.0 Plataforma: iOS 16.0+ Linguagem: Swift 5.9+ Framework: SwiftUI

FilesExpand file tree

IOS_TASKS.md

Latest commit

History