{"id":22429865,"url":"https://github.com/arkaniightt/projeto_transacoes","last_synced_at":"2025-10-25T00:34:59.603Z","repository":{"id":265535196,"uuid":"896210138","full_name":"ArkaNiightt/Projeto_Transacoes","owner":"ArkaNiightt","description":"Aplicativo em Python para gerenciar transações financeiras com Streamlit, incluindo inserção, visualização e exportação em Excel. Fácil e eficiente.","archived":false,"fork":false,"pushed_at":"2024-12-05T17:42:53.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T07:13:46.184Z","etag":null,"topics":["python","streamlit","xlsx"],"latest_commit_sha":null,"homepage":"https://extracao-transacoes.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/ArkaNiightt.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}},"created_at":"2024-11-29T19:30:32.000Z","updated_at":"2024-12-05T17:42:56.000Z","dependencies_parsed_at":"2024-11-29T20:38:05.732Z","dependency_job_id":null,"html_url":"https://github.com/ArkaNiightt/Projeto_Transacoes","commit_stats":null,"previous_names":["arkaniightt/projeto_transacoes"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FProjeto_Transacoes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FProjeto_Transacoes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FProjeto_Transacoes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FProjeto_Transacoes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArkaNiightt","download_url":"https://codeload.github.com/ArkaNiightt/Projeto_Transacoes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245798358,"owners_count":20673902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["python","streamlit","xlsx"],"created_at":"2024-12-05T21:05:59.710Z","updated_at":"2025-10-25T00:34:54.569Z","avatar_url":"https://github.com/ArkaNiightt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💸 App de Extração de Transações\n\nEste aplicativo foi desenvolvido em Python utilizando **Streamlit** para facilitar o controle e a organização de transações financeiras. Com uma interface simples e intuitiva, é possível inserir dados de transações, visualizar uma planilha e exportá-la em formato Excel.\n\n\n## 📋 Funcionalidades\n\n- **Inserção de Transações**: Permite inserir transações financeiras em um campo de texto, respeitando o formato especificado. Cada transação deve estar em uma linha e seguir o modelo: `31/10/2024 PIX_CRED RECEBIMENTO PIX 1234***** Nome Completo 49,00`.\n- **Cálculo de Saldo Inicial**: O usuário pode inserir o saldo inicial a ser considerado na planilha.\n- **Visualização das Transações**: As transações são exibidas em uma tabela interativa que facilita a análise e edição.\n- **Exportação em Excel**: As transações podem ser exportadas para um arquivo `.xlsx` com apenas um clique.\n\n## 🚀 Como Executar o Projeto\n\n1. Clone este repositório:\n   ```sh\n   git clone https://github.com/ArkaNiightt/Projeto_Transacoes.git\n   ```\n\n2. Instale as dependências necessárias utilizando **pip**:\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n3. Execute o aplicativo Streamlit:\n   ```sh\n   streamlit run app.py\n   ```\n\n## 📄 Formato das Transações\n\nCada transação deve ser inserida no seguinte formato:\n\n```\nDD/MM/AAAA TIPO_DOC DESCRIÇÃO VALOR\n```\n\n- **Data**: Formato `DD/MM/AAAA` (Ex: `31/10/2024`).\n- **Tipo de Documento**: Código identificador da transação (Ex: `PIX_CRED`).\n- **Descrição**: Informações adicionais da transação (Ex: `RECEBIMENTO PIX 123456789 Nome Completo`).\n- **Valor**: Valor em formato brasileiro (Ex: `49,00`).\n\n## 🛠️ Tecnologias Utilizadas\n\n- **Python**: Linguagem principal utilizada para desenvolver o aplicativo.\n- **Streamlit**: Framework usado para construir a interface gráfica.\n- **Pandas**: Biblioteca para manipulação e análise de dados.\n- **XlsxWriter**: Biblioteca para exportar os dados em formato `.xlsx`.\n- **Regex**: Para analisar e extrair as partes das transações.\n\n## 🎨 Layout\n\n- O layout do aplicativo foi configurado para ser amigável e intuitivo, contando com elementos visuais como ícones e um banner no topo.\n- A imagem do banner é carregada para oferecer uma identidade visual ao aplicativo.\n\n## 📦 Estrutura do Projeto\n\n```\nproject-root/\n│\n├── src/\n│   └── images/\n│       └── header_img.jpg   # Imagem usada como banner\n├── app.py                    # Código principal do aplicativo\n└── requirements.txt          # Dependências do projeto\n```\n\n## 📥 Exportar para Excel\n\nApós adicionar as transações, você pode baixar a planilha gerada no formato `.xlsx` clicando no botão **\"📥 Baixar planilha como XLSX\"**. Esta funcionalidade facilita o compartilhamento e armazenamento das informações financeiras.\n\n## ⚖️ Saldo Inicial\n\nNo menu lateral, insira o saldo inicial desejado. O valor deve ser no formato brasileiro (`ex: 150.342,05`). Este saldo será incluído nas transações para melhor controle financeiro.\n\n## 📊 Planilha de Transações\n\nApós a inserção das transações, você poderá visualizar todas as informações em uma tabela dinâmica que facilita a verificação e análise dos dados.\n\n## 💼 Autor\n\nApp desenvolvido por [João Augusto](https://github.com/ArkaNiightt) para facilitar o controle de transações financeiras, com foco em simplicidade e praticidade.\n\n## 📜 Licença\n\nEste projeto está sob a licença [MIT](LICENSE).\n\n---\n\n**Organize suas finanças de forma prática e eficiente!** 💰✨\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkaniightt%2Fprojeto_transacoes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farkaniightt%2Fprojeto_transacoes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkaniightt%2Fprojeto_transacoes/lists"}