Skip to content

VMedeiros/Judo-Master

Repository files navigation

🏯 Judô Master

Aplicação Angular para estudo, organização e gerenciamento de técnicas de Judô por faixa.

Deploy to GitHub Pages

🔗 Acessar Aplicação


🎯 Visão Geral

O Judô Master auxilia praticantes e instrutores a acompanhar conteúdos de graduação: técnicas, categorias, descrições, execução e aplicação. A interface permite filtrar, adicionar, editar e remover técnicas, ajustar fonte, tamanho e alternar entre tema claro e escuro com persistência.

🧪 Tecnologias

  • Angular 21 (Standalone Components & Signals)
  • TypeScript 5
  • Tailwind CSS (utilização de classes utilitárias e modo escuro via classe dark)
  • RxJS para reatividade em serviços

📁 Estrutura Simplificada

src/
   app.component.*        # Componente raiz e template
   assets/judo-data.json  # Dados de faixas e técnicas
   models/judo.model.ts   # Tipagens (Belt, Technique)
   services/judo-data.service.ts # Operações CRUD em memória

🔧 Configuração & Execução

Pré-requisito: Node.js 18+

npm install       # instala dependências
npm run dev       # inicia servidor de desenvolvimento (porta 3000)
npm run build     # build produção em dist/
npm run preview   # servir build de produção
npm run deploy    # deploy para GitHub Pages

🚀 Deploy

GitHub Pages (Automático)

A aplicação é automaticamente implantada no GitHub Pages via GitHub Actions quando há push na branch main.

Deploy Manual

npm run deploy

🌓 Tema Claro/Escuro

O tema alterna entre claro e escuro através de um toggle nas Configurações. A seleção é persistida em localStorage e, na ausência de preferência salva, respeita o prefers-color-scheme do sistema. Variáveis CSS e a classe dark em <html> controlam a paleta.

📋 Funcionalidades

  • ✅ Gerenciamento de técnicas por faixa
  • ✅ Filtro e busca de técnicas
  • ✅ Visualização de vídeos demonstrativos
  • ✅ Exportação para Excel e PDF
  • ✅ Tema claro/escuro com persistência
  • ✅ Seleção de fonte e tamanho
  • ✅ Responsivo (mobile, tablet, desktop)
  • ✅ Acessibilidade (WCAG 2.1 AA)
  • PWA - Instalável e funciona offline

🛠 Scripts

  • npm run dev – Servidor de desenvolvimento
  • npm run build – Build otimizado
  • npm run preview – Servir build de produção

🚀 Próximas Melhorias (Sugestões)

  • Persistência real (API / IndexedDB)
  • Upload de mídia demonstrativa
  • Busca avançada multi-campos
  • Internacionalização (i18n)

🤝 Contribuição

  1. Faça um fork
  2. Crie uma branch: git checkout -b feat/minha-melhoria
  3. Commit: git commit -m "feat: adiciona ..."
  4. Push: git push origin feat/minha-melhoria
  5. Abra um Pull Request

📄 Licença

MIT License - Copyright (c) 2025 Victor Medeiros


Feito com dedicação para apoiar estudos de Judô. Oss! 🥋

About

O Judô Master auxilia praticantes e instrutores a acompanhar conteúdos de graduação: técnicas, categorias, descrições, execução e aplicação. A interface permite filtrar, adicionar, editar e remover técnicas, ajustar fonte, tamanho e alternar entre tema claro e escuro com persistência.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors