Pular para o conteúdo
Samuel Abreu Sales
← Voltar para os projetos
Em destaque

Anime Tracker — Planejamento e Acompanhamento de Animes

Um projeto de Samuel Abreu Sales

  • Aplicação web
  • Alpine.js
  • Blade
  • JavaScript
  • Laravel 12
  • MySQL
  • PHP 8.2
  • Tailwind CSS
  • Vite
Ver categoria e tecnologias

Aplicação web · Alpine.js · Blade · JavaScript · Laravel 12 · MySQL · PHP 8.2 · Tailwind CSS · Vite

Capa de Anime Tracker — Planejamento e Acompanhamento de Animes

Sobre o projeto

Anime Tracker — Planejamento, acompanhamento e comunidade de animes

Um episódio de cada vez.

O Anime Tracker é uma aplicação web para organizar animes, planejar uma rotina de episódios e acompanhar a evolução de cada história. O projeto reúne catálogo, biblioteca pessoal, calendário, histórico, avaliações e coleções em uma experiência integrada, com interface responsiva e identidade visual escura.

A proposta é transformar uma lista de títulos em um espaço de acompanhamento. O usuário pode guardar indicações, escolher quando começar, distribuir episódios ao longo da semana, registrar o que realmente assistiu e manter suas impressões depois da conclusão. A dimensão comunitária complementa essa organização com perfis, favoritos, rankings pessoais e agendas compartilhadas pela administração.

Página inicial do Anime Tracker, apresentando a proposta da plataforma e os caminhos para criar uma coleção ou acessar a conta.
Página inicial do Anime Tracker, apresentando a proposta da plataforma e os caminhos para criar uma coleção ou acessar a conta.

Uma solução para organizar o que assistir e quando assistir

Acompanhar vários animes envolve decisões diferentes: lembrar em qual episódio parou, separar títulos em andamento das próximas escolhas, retomar uma história interrompida e encontrar espaço para assistir durante a semana. Quando essas informações ficam dispersas, a organização passa a depender da memória ou de anotações sem relação entre si.

O Anime Tracker aproxima essas necessidades. O catálogo ajuda a encontrar títulos; a biblioteca registra a situação de cada anime; a agenda distribui os episódios; e os registros diários ajustam a previsão à rotina real. Depois, avaliações e coleções preservam a experiência de quem assistiu.

O sistema trabalha com planejamento e acompanhamento, sem reproduzir os episódios. A busca externa fornece informações sobre as obras, enquanto os recursos locais organizam as escolhas e o progresso de cada conta.

Da primeira visita à biblioteca pessoal

Cadastro, acesso e gerenciamento da conta

A jornada começa na página de apresentação, que explica a proposta do produto e oferece acesso ao cadastro ou login. O cadastro solicita nome, e-mail e senha com confirmação. Após criar a conta, o usuário é autenticado e direcionado ao painel.

O login utiliza e-mail e senha, com opção de manter a sessão. Também existem os fluxos de solicitação de recuperação de senha, redefinição por token e confirmação de senha para operações que exigem uma nova comprovação de acesso. O envio das mensagens de recuperação depende da configuração de e-mail do ambiente.

Nas configurações, é possível atualizar nome e e-mail, alterar a senha e excluir a própria conta mediante confirmação da senha atual. A aplicação não exige verificação obrigatória de e-mail para entrar no painel nesta versão.

Tela de login com identidade visual integrada, opção de manter a sessão e acesso à recuperação de senha.
Tela de login com identidade visual integrada, opção de manter a sessão e acesso à recuperação de senha.

Painel com atalhos para continuar a jornada

O dashboard apresenta uma visão resumida da biblioteca, com contadores para animes assistindo, concluídos, pausados e em espera. Os indicadores levam às respectivas categorias, reduzindo o caminho entre a visão geral e a ação desejada.

A seção de continuidade destaca os planos pessoais em andamento e mostra capa, título, progresso e controles de acompanhamento. Outra área apresenta animes da agenda global, aproximando a rotina individual do que está sendo acompanhado pela comunidade. O painel também oferece atalhos para explorar o catálogo, consultar a agenda pessoal e abrir a lista Pretendo assistir.

Dashboard com indicadores da biblioteca, acesso ao calendário e cartões dos animes em acompanhamento.
Dashboard com indicadores da biblioteca, acesso ao calendário e cartões dos animes em acompanhamento.

Catálogo e descoberta de novas histórias

Exploração dos animes cadastrados

O catálogo reúne os títulos disponíveis no banco da aplicação. Cada cartão apresenta a capa, o nome, a quantidade de episódios quando conhecida e a situação de exibição. Quando há avaliações públicas, a listagem também pode exibir a média calculada a partir dessas notas.

A apresentação considera a relação do usuário com a obra. Um título em andamento oferece acesso à biblioteca; um anime concluído permite abrir a avaliação; e uma obra ainda não acompanhada oferece caminhos para começar um planejamento ou guardar para depois.

Os filtros permitem combinar busca por título, gênero, situação na lista pessoal, exibição e quantidade de episódios. A classificação por quantidade distingue obras de até 13 episódios, de 14 a 26, acima de 26 e com total indefinido. Também é possível exibir somente os próprios favoritos ou localizar títulos que ainda não fazem parte da biblioteca.

A ordenação inclui inclusão recente, título, melhor avaliação pública e maior quantidade de episódios. A paginação mantém os parâmetros selecionados, permitindo percorrer o catálogo sem perder o contexto da busca.

Exploração do catálogo com filtros combináveis, ordenação e cartões que refletem a situação dos animes na biblioteca pessoal.
Exploração do catálogo com filtros combináveis, ordenação e cartões que refletem a situação dos animes na biblioteca pessoal.

Busca externa e importação

A busca por novos animes utiliza um adaptador para a Tenrai, com identificadores do MyAnimeList. O usuário informa o título e recebe uma lista de resultados com nome, capa e quantidade de episódios, quando esses dados estão disponíveis.

Cada resultado pode ser adicionado à biblioteca pessoal ou guardado em Pretendo assistir. Contas administrativas também têm a opção de encaminhá-lo ao planejamento global. A importação reutiliza um registro local quando o identificador MyAnimeList já está cadastrado, evitando criar uma nova obra para cada conta que deseja acompanhá-la.

Quando o resultado já existe no catálogo, o cartão abre os detalhes locais. Para obras ainda não importadas, o título aponta para sua página no MyAnimeList, com indicação de navegação externa. A interface identifica a origem dos resultados e apresenta uma mensagem de indisponibilidade quando o serviço não consegue responder adequadamente.

Resultados reais da busca por Naruto, com capas e ações para importar à biblioteca, guardar para depois ou adicionar à comunidade como administrador.
Resultados reais da busca por Naruto, com capas e ações para importar à biblioteca, guardar para depois ou adicionar à comunidade como administrador.

Detalhes da obra e avaliações da comunidade

A página individual concentra capa, título, gêneros, total de episódios, situação de exibição, sinopse e status pessoal. Os gêneros funcionam como atalhos de filtro para encontrar outras obras relacionadas.

As ações variam conforme o acompanhamento: começar a assistir, guardar para depois, abrir a biblioteca ou escrever uma avaliação. A opção Já assisti permite registrar uma conclusão pessoal e seguir para o formulário de avaliação, sem exigir a reconstrução manual de toda a agenda anterior.

A sinopse em português é priorizada quando existe; caso contrário, a aplicação utiliza o texto original disponível. A área de avaliações apresenta autores, datas, notas e comentários que atendem às regras de visibilidade da comunidade.

Página de detalhes com informações da obra, status pessoal, sinopse e avaliações compartilhadas pela comunidade.
Página de detalhes com informações da obra, status pessoal, sinopse e avaliações compartilhadas pela comunidade.

Biblioteca pessoal e ciclo de acompanhamento

A biblioteca organiza os planos em quatro estados: Pretendo assistir, Assistindo, Pausado e Concluído. Uma visão geral reúne as categorias, enquanto as abas permitem consultar um estado específico. Busca por título, gênero, filtro de favoritos e ordenação ajudam a localizar itens dentro da coleção.

Os cartões mostram o progresso e as ações adequadas a cada situação. Durante o acompanhamento, o usuário pode registrar episódios, editar a agenda, pausar ou concluir. Um plano pausado oferece retomada. Um anime concluído oferece avaliação. A remoção exclui o planejamento, mas preserva os metadados pessoais de avaliações e favoritos.

A paginação é independente por categoria. Assim, a organização visual acompanha os estados do domínio, em vez de depender de uma única lista extensa sem separação.

Biblioteca filtrada pelos animes em andamento, com progresso e ações de registro, edição, pausa, conclusão e remoção.
Biblioteca filtrada pelos animes em andamento, com progresso e ações de registro, edição, pausa, conclusão e remoção.

Pretendo assistir: guardar antes de começar

A lista de espera permite salvar uma indicação sem iniciar a contagem de episódios. A ação aparece no catálogo, nos resultados da busca e em contextos de descoberta de outras coleções. Quando o título já está em andamento, pausado ou concluído, a aplicação evita oferecer uma ação que daria a entender que ele ainda não faz parte da biblioteca.

Guardar novamente um anime não duplica o plano nem substitui seu estado atual. Os itens em espera não geram progresso previsto, calendário ou histórico de acompanhamento. Essa lista é pessoal e aparece no perfil somente para o próprio usuário.

Ao escolher Começar a assistir, o usuário abre o formulário de planejamento. A simples abertura da tela não altera o status: a ativação depende da configuração e do salvamento da agenda. Isso permite escolher uma data futura e organizar o ritmo antes do início.

Lista pessoal de espera em seu estado vazio, com filtros e orientação para guardar novas escolhas pelo catálogo ou pela busca.
Lista pessoal de espera em seu estado vazio, com filtros e orientação para guardar novas escolhas pelo catálogo ou pela busca.

Planejamento semanal adaptado à rotina

Data de início, progresso inicial e ritmo por dia

O formulário de planejamento solicita a data de início e a quantidade de episódios já assistidos antes dessa referência. Em seguida, o usuário distribui quantidades de episódios pelos sete dias da semana.

Cada dia pode ter um ritmo fixo ou ser marcado como Variado. Em um dia fixo, a quantidade participa da previsão. Em um dia variável, o sistema deixa a definição em aberto e espera um registro real para contabilizar o que foi assistido. Dias com quantidade zero não acrescentam uma programação fixa.

Esse modelo permite combinações como assistir apenas durante a semana, reservar mais episódios para um dia específico ou manter o fim de semana sem compromisso fixo. Ao editar um planejamento, o usuário também pode atualizar seu status.

Na implementação atual, a agenda salva é a referência usada para reconstruir a previsão desde a data de início. Por isso, alterar o ritmo também pode mudar a projeção dos dias anteriores sem registro real. Os logs preservam as quantidades explicitamente informadas para suas datas.

Formulário de planejamento com data inicial, episódios já assistidos e distribuição semanal entre quantidades fixas e dias variáveis.
Formulário de planejamento com data inicial, episódios já assistidos e distribuição semanal entre quantidades fixas e dias variáveis.

Previsão e registros reais trabalhando juntos

O progresso parte dos episódios informados como base, soma a programação dos dias anteriores à data de referência e considera as exceções registradas. Quando o total da obra é conhecido, o resultado exibido é limitado a essa quantidade. Obras com total indefinido continuam utilizáveis, sem uma conclusão automática presumida.

Um registro real substitui a previsão da mesma data. Se a agenda previa dois episódios e o usuário registra um, o sistema considera um. Se informa zero, o dia passa a representar que não assistiu. Um log registrado no dia atual já participa do progresso, enquanto a previsão fixa daquele dia não é tratada antecipadamente como consumo realizado.

Essa distinção permite usar a agenda como estimativa e corrigi-la conforme a rotina. O número calculado não depende de uma integração com um player e não comprova que um episódio foi reproduzido: ele representa a combinação da programação com as informações fornecidas pelo usuário.

Registro diário com observações

O formulário de registro permite escolher uma data entre o início do plano e o dia atual, informar a quantidade de episódios e acrescentar observações opcionais. Um novo salvamento para a mesma data atualiza o registro anterior, em vez de acumular entradas duplicadas.

As observações ajudam a contextualizar o acompanhamento. O usuário pode manter uma lembrança daquele dia ou uma anotação sobre a sessão, sem confundir esse comentário diário com a avaliação geral da obra.

Registro diário com data, quantidade assistida e observações, incluindo a orientação de que o valor substitui a previsão da mesma data.
Registro diário com data, quantidade assistida e observações, incluindo a orientação de que o valor substitui a previsão da mesma data.

Pausa, retomada e conclusão

Ao pausar, o sistema registra o início de um intervalo de interrupção. A previsão deixa de avançar durante esse período. Na retomada, o intervalo é encerrado, permitindo continuar o acompanhamento sem somar automaticamente os dias em que o plano esteve pausado.

A conclusão é uma mudança explícita. Para obras com total conhecido, a operação calcula o que falta e pode complementar o registro do dia para alcançar o total. A repetição da mesma conclusão não deve acrescentar novamente os episódios restantes. O serviço mantém a data de conclusão para limitar a projeção posterior.

Planos com episódios registrados não podem ser convertidos livremente para espera; a orientação é utilizar Pausado para interromper algo já iniciado. Isso diferencia uma intenção futura de um acompanhamento que possui histórico.

Calendário e histórico conectados ao mesmo planejamento

Calendário pessoal e programação da comunidade

O calendário pessoal organiza a programação dos planos em andamento por data, dentro de uma janela que vai até o mês seguinte. Cada entrada mostra a obra, o intervalo previsto de episódios ou a indicação A definir para dias variáveis.

A navegação permite alternar para o histórico e para a coleção de concluídos. Existe também um calendário da comunidade, baseado nos planos globais administrados, separado da programação de cada conta.

As informações são calculadas a partir das mesmas regras utilizadas nos cartões de progresso. Essa centralização reduz divergências entre o que aparece na biblioteca e o que é projetado para os próximos dias.

Programação agrupada por data, distinguindo episódios previstos e dias variáveis que ainda dependem de definição.
Programação agrupada por data, distinguindo episódios previstos e dias variáveis que ainda dependem de definição.

Histórico com confirmação e correção

O histórico permite consultar um período, com intervalo padrão de 90 dias e limite de até 366 dias por consulta. As entradas distinguem registros realizados, dias sem episódios, previsões ainda não confirmadas e dias variáveis.

Para uma previsão fixa pendente, o usuário pode confirmar o número previsto ou escolher Não assisti, registrando zero. Em dias variáveis, o fluxo oferece acesso ao registro da data. As ações pessoais ficam restritas ao proprietário; as confirmações da agenda global dependem da administração.

O histórico mantém a relação entre expectativa e registro real. A data, o plano e a quantidade são validados no servidor, e a confirmação opera no escopo autorizado, sem permitir que conhecer um identificador seja suficiente para alterar um plano de outra pessoa.

Histórico filtrável por período, com ações para confirmar episódios previstos ou registrar que não foram assistidos.
Histórico filtrável por período, com ações para confirmar episódios previstos ou registrar que não foram assistidos.

Conclusões e avaliações pessoais

Uma coleção para as histórias terminadas

A página de concluídos reúne os animes finalizados e oferece filtros para localizar obras por título, gênero ou favoritismo. Os cartões mantêm acesso aos detalhes, à avaliação e às ações de coleção, como favoritar e incluir no Top 10.

O sistema também apresenta uma coleção de concluídos da comunidade. A experiência conecta descoberta e memória: uma obra que outra pessoa ou a agenda global terminou pode se tornar uma próxima escolha pessoal, respeitando os estados que o visitante já possui em sua biblioteca.

Animes concluídos com acesso à avaliação e aos controles de favoritos e Top 10.
Animes concluídos com acesso à avaliação e aos controles de favoritos e Top 10.

Notas, comentários e visibilidade

A avaliação de uma obra exige um plano pessoal concluído. O formulário permite informar uma nota inteira de 1 a 10 e um comentário de até 2.000 caracteres; esses campos podem ser preenchidos conforme a preferência do usuário.

As impressões ficam associadas à combinação entre conta e anime, permitindo atualizar a avaliação existente. A exibição comunitária respeita o perfil público e a opção de compartilhar avaliações. As médias públicas são calculadas no banco a partir das notas que atendem a essa visibilidade.

O comentário é uma avaliação textual da obra, sem uma estrutura de respostas ou conversas encadeadas. Ele complementa a nota e pode aparecer nos contextos de perfil e detalhes conforme as preferências da conta.

Avaliação de um anime concluído, com nota de 1 a 10, comentário e indicação da regra de privacidade aplicada.
Avaliação de um anime concluído, com nota de 1 a 10, comentário e indicação da regra de privacidade aplicada.

Perfil como apresentação da coleção

O perfil reúne banner, avatar, nome, identificador de usuário, biografia e data de entrada na comunidade. Os indicadores apresentam totais de favoritos, assistindo, concluídos e, para o próprio usuário, itens em espera. Esses totais são calculados sobre as coleções, independentemente da página ou do filtro atualmente exibido.

A navegação interna leva às seções Top 10, Favoritos, Assistindo, Concluídos, Em espera e Avaliações, conforme a disponibilidade e as permissões. Busca por título e filtro de gênero ajudam a explorar o conteúdo sem transformar o perfil em uma sequência difícil de percorrer.

Perfil de demonstração com banner, avatar, biografia, estatísticas e navegação para as coleções.
Perfil de demonstração com banner, avatar, biografia, estatísticas e navegação para as coleções.

Favoritos e ordenação independente

Os favoritos destacam as obras que o usuário deseja manter por perto. O estado marcado aparece no controle de favorito e recebe destaque visual de estrela amarela nos cartões da seção.

A coleção possui ordenação própria. Os controles de subir e descer alteram a posição dentro dos favoritos sem reorganizar o Top 10 ou os concluídos. A lista de concluídos no perfil também possui sua própria ordem, permitindo que cada agrupamento represente uma escolha diferente de apresentação.

Favoritos com capas em destaque, estado visual da estrela e controles para alterar a ordem da própria coleção.
Favoritos com capas em destaque, estado visual da estrela e controles para alterar a ordem da própria coleção.

Top 10 pessoal

O Top 10 apresenta até dez animes em uma sequência escolhida pela conta. O usuário pode incluir um título, remover uma escolha e mover itens para cima ou para baixo. O ranking mantém posições contíguas após as alterações.

A marcação de favorito e a presença no ranking são propriedades distintas. Isso permite manter uma coleção ampla de favoritos e, ao mesmo tempo, selecionar uma apresentação limitada de títulos em ordem de preferência.

Ranking pessoal com posições numeradas e controles para favoritar, mover ou remover uma obra do Top 10.
Ranking pessoal com posições numeradas e controles para favoritar, mover ou remover uma obra do Top 10.

Personalização e controle do que compartilhar

Nas configurações, o usuário pode alterar o identificador do perfil, escrever uma biografia e enviar avatar e banner. O avatar aceita JPG, PNG e WebP até 2 MB; o banner aceita os mesmos formatos até 4 MB. O nome de usuário é único, limitado a 30 caracteres e validado pelo backend.

Os controles de privacidade permitem tornar o perfil público dentro da comunidade autenticada e escolher separadamente a exposição dos animes assistindo, concluídos, favoritos, Top 10 e avaliações. Um perfil privado continua acessível ao próprio dono, mas não é liberado a outros usuários apenas por conhecerem o endereço.

A lista Pretendo assistir permanece visível somente ao proprietário. A ocultação de avaliações também considera notas e comentários em outros blocos do perfil. Os arquivos enviados são servidos pelo storage público, portanto as opções de visibilidade controlam as páginas e consultas da aplicação, sem transformar o endereço de cada imagem em um arquivo confidencial.

Personalização do identificador e da biografia, com opções independentes de compartilhamento das coleções e avaliações.
Personalização do identificador e da biografia, com opções independentes de compartilhamento das coleções e avaliações.

Comunidade, descoberta de pessoas e cópia de agendas

O diretório de pessoas lista perfis públicos com paginação, busca por nome ou identificador e ordenação alfabética ou por entrada recente. Ao abrir um perfil, o visitante encontra somente as seções permitidas pelas preferências daquela conta.

Esse fluxo favorece a descoberta por curadoria humana: conhecer favoritos, rankings e avaliações de outras pessoas pode ajudar a escolher a próxima obra. As escolhas continuam pertencendo a cada usuário; o catálogo é compartilhado, enquanto os planos e metadados pessoais mantêm seu proprietário.

Diretório de perfis públicos com pesquisa por nome ou usuário e acesso às coleções compartilhadas.
Diretório de perfis públicos com pesquisa por nome ou usuário e acesso às coleções compartilhadas.

Copiar uma agenda sem substituir a própria biblioteca

Quando um plano pode ser compartilhado, o visitante encontra a ação Copiar agenda. A autorização considera se o plano é global, pertence à própria conta ou está visível em um perfil público com a categoria correspondente habilitada.

A cópia utiliza a programação semanal e o progresso calculado da origem como referência para criar um acompanhamento pessoal. A data é ajustada para não começar antes do dia atual, respeitando uma data futura da origem quando houver. Os logs e os intervalos de pausa da outra conta não são copiados como registros pessoais.

Se a biblioteca já contém um plano para aquele anime, ele é preservado. Copiar uma agenda não serve para sobrescrever silenciosamente o progresso ou a organização já mantida pelo usuário.

Coleção de outro usuário com ações de copiar agendas autorizadas e guardar títulos ainda não acompanhados.
Coleção de outro usuário com ações de copiar agendas autorizadas e guardar títulos ainda não acompanhados.

Administração e planejamento global

A área administrativa concentra os planos da comunidade. O administrador pode criar e editar agendas globais, registrar episódios, pausar, retomar, concluir e remover esses planejamentos. Os mesmos componentes e serviços utilizados no contexto pessoal sustentam esse fluxo, com autorização e escopo específicos.

A edição de sinopse também é restrita à administração. Quando existe tradução em português, o editor atualiza o campo priorizado na exibição; quando não existe, utiliza a sinopse original. A implementação mantém a distinção entre administrar conteúdo compartilhado e alterar dados pessoais de outras contas.

Um administrador não recebe, por esse papel, autorização genérica para editar planos pessoais nos endpoints da área global. A identificação do proprietário continua fazendo parte da verificação no servidor.

Gestão dos planos globais, com filtros e controles de acompanhamento disponíveis para a conta administrativa.
Gestão dos planos globais, com filtros e controles de acompanhamento disponíveis para a conta administrativa.

Tecnologias utilizadas e suas responsabilidades

PHP e Laravel

O backend foi desenvolvido com PHP 8.2+ e Laravel 12, responsáveis pelo gerenciamento das rotas, autenticação, autorização, validação e regras de negócio. A aplicação utiliza Eloquent ORM, Form Requests, Policies e transações para organizar o código e garantir a consistência das operações.

Blade e Laravel Breeze

O Blade é utilizado para renderização das páginas e criação de componentes reutilizáveis, como cartões, formulários e filtros. O Laravel Breeze fornece a estrutura de autenticação, cadastro, recuperação de senha e gerenciamento de contas.

Tailwind CSS e JavaScript

A interface foi desenvolvida com Tailwind CSS 3, estilos próprios e JavaScript, oferecendo uma experiência responsiva com identidade visual escura e detalhes em violeta.

O Alpine.js gerencia interações como menus e modais, enquanto a API Fetch permite atualizar determinadas áreas da interface sem recarregar toda a página.

MySQL e Eloquent ORM

O MySQL armazena usuários, animes, planejamentos, históricos, avaliações e coleções. O Eloquent ORM gerencia os relacionamentos e consultas, enquanto as migrations controlam a evolução da estrutura do banco de dados.

O SQLite é utilizado nos ambientes de testes automatizados.

Ferramentas de desenvolvimento e testes

O projeto utiliza Vite 7, Node.js, npm e Composer para gerenciamento de dependências e compilação dos recursos.

A qualidade é verificada com Pest, PHPUnit e Playwright, além do Laravel Pint para padronização do código. O GitHub Actions automatiza testes e verificações de integração contínua.

Arquitetura e organização interna

O Anime Tracker utiliza uma arquitetura monolítica modular, com responsabilidades divididas entre rotas, controllers, serviços, consultas e componentes visuais.

As principais regras de negócio são organizadas em serviços específicos:

  • PlanManager: criação e gerenciamento de planejamentos, registros e alterações de status.

  • PlanProjection: cálculo do progresso, calendário e histórico.

  • RankingManager: organização do ranking Top 10.

  • CollectionOrder: ordenação independente de favoritos e concluídos.

  • ProfileManager: gerenciamento dos perfis e imagens dos usuários.

O sistema também utiliza Form Requests para validação, Policies para autorização e consultas especializadas para filtros, paginação e relacionamentos.

Essa estrutura favorece a reutilização de código, a manutenção e a separação das responsabilidades.

Modelo de dados e integridade relacional

O banco de dados foi estruturado para separar as informações compartilhadas dos animes dos dados pessoais de cada usuário.

As principais entidades incluem:

  • User: contas, perfis e configurações de privacidade.

  • Anime: informações das obras e identificadores do MyAnimeList.

  • WatchPlan: planejamento de acompanhamento pessoal ou global.

  • WatchPlanDay: programação semanal de episódios.

  • WatchLog: registros reais dos episódios assistidos.

  • WatchPlanPause: períodos de pausa e retomada.

  • UserAnimeMeta: avaliações, favoritos e posições das coleções.

O sistema utiliza relacionamentos, índices únicos, transações e restrições de integridade para evitar duplicações e preservar a consistência dos dados.

Regras de cálculo e acompanhamento

Um dos principais diferenciais técnicos é o motor de projeção de episódios, que calcula automaticamente o progresso considerando a programação semanal, os episódios já assistidos, os registros reais e os períodos de pausa.

O cálculo utiliza semanas completas e dias restantes, evitando percorrer individualmente todo o histórico a cada consulta.

Os registros realizados pelo usuário substituem as previsões correspondentes, mantendo calendário, biblioteca e histórico sincronizados.

As operações de acompanhamento utilizam transações e bloqueios de escrita para reduzir inconsistências em alterações simultâneas.

Atualizações assíncronas e otimização

Determinadas funcionalidades, como favoritar animes e reorganizar coleções, utilizam JavaScript e Fetch para atualizar partes da interface sem recarregar toda a página.

O backend renderiza componentes Blade reutilizáveis, mantendo a apresentação consistente entre respostas completas e atualizações parciais.

A ordenação dos favoritos e concluídos também foi otimizada para movimentar itens utilizando apenas duas gravações por operação, sem precisar atualizar toda a coleção.

Integração com APIs externas

A busca de animes utiliza uma integração com a API Tenrai, baseada em identificadores do MyAnimeList.

A arquitetura utiliza um adaptador responsável por normalizar as informações recebidas, separando a estrutura da API externa das regras internas da aplicação.

O serviço também implementa cache de dez minutos, limites de tempo para requisições e tratamento de falhas, contribuindo para a estabilidade da busca.

Segurança e gerenciamento de arquivos

A aplicação implementa autenticação, proteção CSRF, senhas armazenadas com hash, limitação de tentativas de login e políticas de autorização.

Cada usuário possui controle sobre seus planejamentos, avaliações e configurações de privacidade, enquanto funcionalidades administrativas são protegidas por permissões específicas.

O gerenciamento de avatares e banners também utiliza mecanismos para coordenar alterações no banco de dados e no armazenamento de arquivos.

Interface e experiência do usuário

O Anime Tracker possui uma interface responsiva, com tema escuro, destaques em violeta e componentes reutilizáveis.

A navegação, os formulários, os cartões e as coleções se adaptam a diferentes tamanhos de tela. O projeto também incorpora recursos como indicadores de foco, mensagens de feedback e suporte à preferência de redução de movimento.

Testes e integração contínua

O projeto conta com testes automatizados que abrangem autenticação, autorização, planejamentos, histórico, avaliações, coleções e regras de negócio.

Na validação documentada, foram executados com sucesso 87 testes de backend, com 394 assertions, além de sete cenários de navegador utilizando Playwright.

O GitHub Actions automatiza verificações de código, compilação, testes e cenários de atualização do banco de dados em MySQL e MariaDB.

Principais decisões e diferenciais da implementação

  • Planejamento flexível: combina episódios previstos com registros reais.

  • Motor de projeção compartilhado: centraliza os cálculos utilizados pela biblioteca, calendário e histórico.

  • Arquitetura modular: separa regras de negócio, consultas e apresentação.

  • Integridade dos dados: utiliza validações, transações, índices únicos e controle de acesso.

  • Coleções independentes: permite organizar favoritos, concluídos e Top 10 separadamente.

  • Atualizações parciais: utiliza JavaScript e Blade para tornar as interações mais dinâmicas.

  • Integração desacoplada: organiza a comunicação com APIs externas por meio de contratos e adaptadores.

  • Testes automatizados: verifica funcionalidades e regras importantes durante o desenvolvimento.

Resultado do projeto

O Anime Tracker reúne descoberta, planejamento, acompanhamento e organização de animes em uma plataforma web integrada.

Seu desenvolvimento demonstra conhecimentos práticos de desenvolvimento Full Stack, arquitetura de software, modelagem de banco de dados, autenticação, integração com APIs, otimização de consultas, regras de negócio e testes automatizados.

O resultado é uma aplicação que vai além de uma simples lista de animes, oferecendo ferramentas para planejar rotinas, acompanhar o progresso e compartilhar experiências com outros usuários.