{"id":30268103,"url":"https://github.com/adalbertobrant/chargeoff","last_synced_at":"2026-04-13T09:32:06.591Z","repository":{"id":296611082,"uuid":"993953474","full_name":"adalbertobrant/chargeoff","owner":"adalbertobrant","description":"Análise do endividamento de cartões de créditos nos EUA dados FED - FRED API","archived":false,"fork":false,"pushed_at":"2025-05-31T22:06:19.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-16T00:54:31.868Z","etag":null,"topics":["analise-de-dados","cartoes-credito","estados-unidos","fred-api","pandas","pandas-dataframe","python3","streamlit"],"latest_commit_sha":null,"homepage":"https://chargeoff.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adalbertobrant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T21:57:12.000Z","updated_at":"2025-05-31T22:06:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"9470b948-dab1-448d-9b42-b766391b247f","html_url":"https://github.com/adalbertobrant/chargeoff","commit_stats":null,"previous_names":["adalbertobrant/chargeoff"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/adalbertobrant/chargeoff","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adalbertobrant%2Fchargeoff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adalbertobrant%2Fchargeoff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adalbertobrant%2Fchargeoff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adalbertobrant%2Fchargeoff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adalbertobrant","download_url":"https://codeload.github.com/adalbertobrant/chargeoff/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adalbertobrant%2Fchargeoff/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31746294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analise-de-dados","cartoes-credito","estados-unidos","fred-api","pandas","pandas-dataframe","python3","streamlit"],"created_at":"2025-08-16T00:40:17.917Z","updated_at":"2026-04-13T09:32:06.585Z","avatar_url":"https://github.com/adalbertobrant.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📈 Dashboard de Taxas de Cartão de Crédito - EUA\n\nUm dashboard interativo construído com **Streamlit** que exibe dados históricos das taxas de inadimplência e baixas por prejuízo (charge-off) de cartões de crédito em bancos comerciais dos Estados Unidos, obtidos diretamente do Federal Reserve Economic Data (FRED).\n\n![Dashboard Preview](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-the-badge\u0026logo=streamlit\u0026logoColor=white)\n![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![Plotly](https://img.shields.io/badge/Plotly-3F4F75?style=for-the-badge\u0026logo=plotly\u0026logoColor=white)\n\n## 🚀 Funcionalidades\n\n- **Dados em Tempo Real**: Integração com a API do FRED para dados atualizados\n- **Visualizações Interativas**: Gráficos dinâmicos com Plotly\n- **Análise Estatística**: Métricas, tendências e comparações históricas\n- **Interface Intuitiva**: Dashboard responsivo e fácil de usar\n- **Múltiplas Fontes**: API FRED ou dados simulados para demonstração\n- **Cache Inteligente**: Otimização de performance com cache de 6 horas\n\n## 📊 Métricas Disponíveis\n\n| Métrica | Série FRED | Descrição |\n|---------|------------|-----------|\n| **Taxa de Inadimplência** | `DRCCLACBS` | Percentual de empréstimos com 90+ dias em atraso |\n| **Taxa de Baixa por Prejuízo** | `CORCCACBS` | Percentual de dívidas consideradas incobráveis |\n\n## 🛠️ Tecnologias Utilizadas\n\n- **[Streamlit](https://streamlit.io/)** - Framework para aplicações web\n- **[Pandas](https://pandas.pydata.org/)** - Manipulação e análise de dados\n- **[Plotly](https://plotly.com/)** - Visualizações interativas\n- **[FRED API](https://fred.stlouisfed.org/)** - Federal Reserve Economic Data\n- **[Python-dotenv](https://pypi.org/project/python-dotenv/)** - Gerenciamento de variáveis de ambiente\n\n## 📋 Pré-requisitos\n\n- Python 3.12. ou superior\n- Chave da API FRED (gratuita)\n\n## 🚀 Instalação e Configuração\n\n### 1. Clone o repositório\n```bash\ngit clone https://github.com/adalbertobrant/chargeoff.git\ncd chargeoff\n```\n\n### 2. Instale as dependências\n```bash\npip install -r requirements.txt\n```\n\n### 3. Configure a API FRED\n1. Obtenha uma chave gratuita em: [fred.stlouisfed.org/docs/api/api_key.html](https://fred.stlouisfed.org/docs/api/api_key.html)\n2. Crie um arquivo `.env` na raiz do projeto:\n```bash\n# .env\nAPI_FRED=sua_chave_da_api_fred_aqui\n```\n\n### 4. Execute o aplicativo\n```bash\nstreamlit run app.py\n```\n\nO dashboard estará disponível em: http://localhost:8501\n\n## 📁 Estrutura do Projeto\n\n```\nchargeoff/\n├── app.py              # Aplicação principal Streamlit\n├── requirements.txt    # Dependências Python\n├── .env               # Variáveis de ambiente (não commitado)\n├── .gitignore         # Arquivos ignorados pelo Git\n└── README.md          # Este arquivo\n```\n\n## 🎯 Como Usar\n\n1. **Acesse o Dashboard**: Abra http://localhost:8501 no seu navegador\n2. **Configure Período**: Use a barra lateral para selecionar as datas\n3. **Escolha a Fonte**: FRED API (dados reais) ou Simulados (demo)\n4. **Explore os Dados**: Visualize gráficos, tabelas e estatísticas\n5. **Analise Tendências**: Compare períodos e identifique padrões\n\n## 📈 Capturas de Tela\n\n### Dashboard Principal\n- Gráfico interativo com séries temporais\n- Controles de data na barra lateral\n- Indicadores de status da API\n\n### Análise Estatística\n- Métricas atuais, médias, máximos e mínimos\n- Análise de tendências dos últimos 12 meses\n- Comparações com picos históricos (crise 2008-2010)\n\n## 🔧 Configuração Avançada\n\n### Variáveis de Ambiente (.env)\n```bash\n# Chave da API FRED (obrigatória para dados reais)\nAPI_FRED=sua_chave_aqui\n\n# Configurações opcionais\nDEBUG=True\nPORT=8501\n```\n\n### Personalização\nO código é modular e permite fácil personalização:\n- Adicionar novas séries do FRED\n- Modificar visualizações\n- Incluir análises adicionais\n- Customizar interface\n\n## 🐛 Resolução de Problemas\n\n### Erro \"distutils not found\"\nSe encontrar erros relacionados ao `distutils`:\n```bash\npip install --upgrade setuptools\u003e=65.0.0\n```\n\n### API FRED não funciona\n- Verifique se a chave está correta no arquivo `.env`\n- Confirme se a chave não expirou\n- Use \"Dados Simulados\" como alternativa\n\n### Dependências\nSe houver problemas com instalação:\n```bash\npip install --upgrade pip\npip install -r requirements.txt --force-reinstall\n```\n\n## 📊 Dados e Fontes\n\nOs dados são obtidos do **Federal Reserve Economic Data (FRED)**, mantido pelo Federal Reserve Bank of St. Louis. As séries utilizadas são:\n\n- **DRCCLACBS**: Delinquency Rate on Credit Card Loans, All Commercial Banks\n- **CORCCACBS**: Charge-Off Rate on Credit Card Loans, All Commercial Banks\n\nAmbas as séries são ajustadas sazonalmente e atualizadas trimestralmente.\n\n## 🤝 Contribuindo\n\nContribuições são bem-vindas! Para contribuir:\n\n1. Faça um fork do projeto\n2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)\n3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)\n4. Push para a branch (`git push origin feature/AmazingFeature`)\n5. Abra um Pull Request\n\n## 📝 Ideias para Melhorias\n\n- [ ] Adicionar mais séries econômicas do FRED\n- [ ] Implementar alertas de tendências\n- [ ] Incluir comparações com outros países\n- [ ] Adicionar download de dados em CSV/Excel\n- [ ] Criar relatórios automáticos\n- [ ] Implementar previsões com ML\n\n## 📜 Licença\n\nEste projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.\n\n## 👤 Autor\n\n**Adalberto Brant**\n- GitHub: [@adalbertobrant](https://github.com/adalbertobrant)\n- LinkedIn: [adalbertobrant](https://linkedin.com/in/ilha)\n\n## 🙏 Agradecimentos\n\n- [Federal Reserve Economic Data (FRED)](https://fred.stlouisfed.org/) pelos dados\n- [Streamlit](https://streamlit.io/) pelo framework fantástico\n- Comunidade Python pelos packages incríveis\n\n---\n\n⭐ **Se este projeto foi útil para você, considere dar uma estrela!** ⭐\n\n## 📞 Suporte\n\nSe você encontrar problemas ou tiver sugestões:\n- Abra uma [Issue](https://github.com/adalbertobrant/chargeoff/issues)\n- Entre em contato através das redes sociais\n- Consulte a [documentação do FRED](https://fred.stlouisfed.org/docs/api/)\n\n---\n\n*Dashboard desenvolvido para análise de risco de crédito e educação financeira. Dados fornecidos pelo Federal Reserve Economic Data (FRED).*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadalbertobrant%2Fchargeoff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadalbertobrant%2Fchargeoff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadalbertobrant%2Fchargeoff/lists"}