{"id":25930560,"url":"https://github.com/odevthomas/invoice-generator","last_synced_at":"2025-03-03T23:21:44.190Z","repository":{"id":249451833,"uuid":"831557100","full_name":"odevthomas/Invoice-Generator","owner":"odevthomas","description":"O projeto de gestão de faturas é uma aplicação web destinada a gerar e gerenciar faturas de forma eficiente. Ele permite visualizar uma prévia da fatura, adicionar e editar produtos, e imprimir ou gerar um PDF da fatura. ","archived":false,"fork":false,"pushed_at":"2024-09-08T21:19:06.000Z","size":252,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T15:41:36.055Z","etag":null,"topics":["invoice-generator","pdf","react"],"latest_commit_sha":null,"homepage":"https://invoice-generator--omega.vercel.app/","language":"JavaScript","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/odevthomas.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-07-20T23:11:06.000Z","updated_at":"2024-09-18T03:00:12.000Z","dependencies_parsed_at":"2025-01-30T15:41:41.619Z","dependency_job_id":"c474bd93-2ccc-4aa2-bd22-6a46432b9003","html_url":"https://github.com/odevthomas/Invoice-Generator","commit_stats":null,"previous_names":["devthmedu/gerador-de-faturas-main","odevthomas/invoice-generator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odevthomas%2FInvoice-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odevthomas%2FInvoice-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odevthomas%2FInvoice-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odevthomas%2FInvoice-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odevthomas","download_url":"https://codeload.github.com/odevthomas/Invoice-Generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241753800,"owners_count":20014362,"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":["invoice-generator","pdf","react"],"created_at":"2025-03-03T23:21:40.560Z","updated_at":"2025-03-03T23:21:43.325Z","avatar_url":"https://github.com/odevthomas.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Projeto de Gestão de Faturas\n\n![Gerador de Fatura](https://github.com/user-attachments/assets/b042cd0a-10aa-4df6-9fc9-855253205ac8)\n\n## Visão Geral\n\nO projeto de gestão de faturas é uma aplicação web destinada a gerar e gerenciar faturas de forma eficiente. Ele permite visualizar uma prévia da fatura, adicionar e editar produtos, e imprimir ou gerar um PDF da fatura. A interface foi desenvolvida com React e utiliza bibliotecas modernas para garantir uma experiência de usuário fluida e responsiva.\n\n## Funcionalidades\n\n- **Visualização de Fatura:** Exibe uma prévia da fatura com informações detalhadas.\n- **Gerenciamento de Produtos:** Adiciona, edita e remove produtos da fatura.\n- **Cálculo Automático do Total:** Calcula automaticamente o total da fatura com base na quantidade e preço dos produtos.\n- **QR Code:** Gera um QR Code para a fatura que pode ser utilizado para referência rápida.\n- **Impressão e PDF:** Permite imprimir a fatura ou gerar um PDF utilizando a funcionalidade do React-to-Print.\n- **Interface Responsiva:** Adapta-se a diferentes tamanhos de tela para uma melhor experiência em dispositivos móveis e desktops.\n\n## Estrutura do Projeto\n\n- `src/`\n  - `components/`\n    - `InvoicePreview/` - Componente para a visualização da fatura.\n    - `ProductForm/` - Componente para o formulário de adição/edição de produtos.\n    - `ActionButton/` - Componente para botões de ação reutilizáveis.\n    - `Template/` - Componente para o layout da fatura e geração do PDF.\n  - `App.js` - Arquivo principal do React que configura e renderiza os componentes.\n  - `index.js` - Ponto de entrada da aplicação React.\n\n## Tecnologias Utilizadas\n\n- **React**: Biblioteca JavaScript para construção da interface de usuário.\n- **Material-UI**: Biblioteca de componentes React que segue as diretrizes de design do Material Design.\n- **React-to-Print**: Biblioteca para impressão e geração de PDFs.\n- **QRCode.react**: Biblioteca para gerar QR Codes.\n- **Lucide Icons**: Biblioteca de ícones para interfaces modernas.\n\n## Instalação\n\nPara rodar o projeto localmente, siga as instruções abaixo:\n\n1. **Clone o repositório:**\n\n   ```bash\n   git clone https://github.com/seu-usuario/projeto-faturas.git\n   cd projeto-faturas\n   ```\n\n2. **Instale as dependências:**\n\n   ```bash\n   npm install\n   ```\n\n3. **Inicie o servidor de desenvolvimento:**\n\n   ```bash\n   npm start\n   ```\n\n   O projeto estará disponível em [http://localhost:3000](http://localhost:3000).\n\n## Uso\n\n1. **Visualização da Fatura:**\n   - Acesse o componente `InvoicePreview` para ver uma prévia da fatura.\n\n2. **Gerenciamento de Produtos:**\n   - Utilize o componente `ProductForm` para adicionar ou editar produtos na fatura.\n\n3. **Impressão e PDF:**\n   - Clique no botão de impressão para gerar uma versão imprimível da fatura.\n\n4. **QR Code:**\n   - Visualize o QR Code gerado que está associado à fatura.\n\n## Contribuição\n\nContribuições são bem-vindas! Se você deseja contribuir para o projeto, por favor, siga estas etapas:\n\n1. Fork o repositório.\n2. Crie uma branch para suas alterações (`git checkout -b minha-nova-feature`).\n3. Faça commit das suas alterações (`git commit -am 'Adiciona nova feature'`).\n4. Push para a branch (`git push origin minha-nova-feature`).\n5. Abra um Pull Request.\n\n## Licença\n\nEste projeto é licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodevthomas%2Finvoice-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodevthomas%2Finvoice-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodevthomas%2Finvoice-generator/lists"}