{"id":18541392,"url":"https://github.com/samuelmsilva2v/webfinancas","last_synced_at":"2026-04-19T04:36:35.480Z","repository":{"id":255921696,"uuid":"853877935","full_name":"samuelmsilva2v/webFinancas","owner":"samuelmsilva2v","description":"Aplicação front-end desenvolvida em Angular para gerenciamento de despesas, integrando com uma API REST.","archived":false,"fork":false,"pushed_at":"2025-03-15T18:24:34.000Z","size":162,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-15T18:25:54.481Z","etag":null,"topics":["angular","bootstrap","front-end"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/samuelmsilva2v.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-09-07T19:32:17.000Z","updated_at":"2025-03-15T18:24:37.000Z","dependencies_parsed_at":"2025-02-17T08:29:35.602Z","dependency_job_id":"829d4afd-60c3-4ccf-b20d-d3ddb635fd99","html_url":"https://github.com/samuelmsilva2v/webFinancas","commit_stats":null,"previous_names":["samuelmsilva2v/webfinancas"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmsilva2v%2FwebFinancas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmsilva2v%2FwebFinancas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmsilva2v%2FwebFinancas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmsilva2v%2FwebFinancas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samuelmsilva2v","download_url":"https://codeload.github.com/samuelmsilva2v/webFinancas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270658,"owners_count":22042860,"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":["angular","bootstrap","front-end"],"created_at":"2024-11-06T20:04:57.033Z","updated_at":"2026-04-19T04:36:30.448Z","avatar_url":"https://github.com/samuelmsilva2v.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Controle de Finanças Web\n![GitHub repo size](https://img.shields.io/github/repo-size/samuelmsilva2v/webFinancas?style=for-the-badge)\n![GitHub language count](https://img.shields.io/github/languages/count/samuelmsilva2v/webFinancas?style=for-the-badge)\n![GitHub forks](https://img.shields.io/github/forks/samuelmsilva2v/webFinancas?style=for-the-badge)\n![Bitbucket open issues](https://img.shields.io/bitbucket/issues/samuelmsilva2v/webFinancas?style=for-the-badge)\n![Bitbucket open pull requests](https://img.shields.io/bitbucket/pr-raw/samuelmsilva2v/webFinancas?style=for-the-badge)\n\n[🇺🇸 Read in English](#financial-control-web)\n\n💸 Este é um projeto de front-end desenvolvido com **Angular**. O objetivo do projeto é desenvolver uma aplicação para controle de finanças, controle de receitas, despesas, categorias de transações e o saldo total de um usuário .\n\n## Funcionalidades\n\nA API de Controle de Finanças oferece as seguintes funcionalidades:\n\n- **Cadastrar, atualizar e remover contas a pagar**: Cadastre novas contas a serem pagas com nome, valor, data e categoria.\n- **Cadastrar, atualizar e remover dinheiro a receber**: Cadastre novas entradas de dinheiro com nome, valor, data e categoria.\n- **Controle de categorias**: Cada despesa pode ser associada a uma categoria (ex: Alimentação, Lazer, Transporte, etc.).\n\n## Endpoints\n\n### Endpoints de contas\n| Método | Endpoint           | Descrição                |\n|--------|--------------------|--------------------------|\n| POST   | `/api/contas`      | Registra uma nova conta  |\n| GET    | `/api/contas`      | Consulta todas as contas |\n| GET    | `/api/contas/{id}` | Detalha uma conta por ID |\n| PUT    | `/api/contas/{id}` | Atualiza uma conta       |\n| DELETE | `/api/contas/{id}` | Remove uma conta         |\n\n### Endpoints de categorias\n| Método | Endpoint               | Descrição                    |\n|--------|------------------------|------------------------------|\n| POST   | `/api/categorias`      | Registra uma nova categoria  |\n| GET    | `/api/categorias`      | Consulta todas as categorias |\n| GET    | `/api/categorias/{id}` | Detalha uma categoria por ID |\n| PUT    | `/api/categorias/{id}` | Atualiza uma categoria       |\n| DELETE | `/api/categorias/{id}` | Remove uma categoria         |\n\n## Tecnologias Utilizadas:\n* Java 17\n* Spring Boot\n* Spring Data JPA\n* Hibernate\n* PostgreSQL\n* Swagger\n* Lombok\n* Model Mapper\n* Bean Validation (javax.validation)\n* Docker\n#### Front-end:\n* Angular 19\n* Bootstrap\n* HttpClient\n\n## Instalação:\n\n#### **1. Clonar o Repositório do Back-end**\n```bash\n git clone https://github.com/samuelmsilva2v/apiFinancas.git\n cd apiFinancas\n```\n\n#### **2. Execute o comando abaixo para criar a imagem Docker:**\n```bash\ndocker build -t apifinancas .\n```\n##### Executando o container\n```bash\ndocker-compose up -d\n```\nAcesse a documentação no Swagger: http://localhost:8082/swagger-ui/index.html#\n\n**3. Clonar o Repositório do Front-end**\n```bash\n git clone https://github.com/samuelmsilva2v/webFinancas.git\n cd webFinancas\n```\n\n**4. Instale as dependências do projeto:**\n```bash\nnpm install\n```\n\n**5. Executar o front-end:**\n```bash\n$ ng s -o \n```\nIsso irá iniciar o servidor de desenvolvimento na URL http://localhost:4200/. Você pode abrir seu navegador e acessar essa URL para visualizar a aplicação.\n\n### API rodando integrada com o front-end\n![](https://github.com/samuelmsilva2v/assets/blob/main/apiFinancas/Captura%20de%20tela%202024-10-31%20184207.png)\n![](https://github.com/samuelmsilva2v/assets/blob/main/apiFinancas/Captura%20de%20tela%202024-10-31%20184231.png)\n\n#### [Repositório do back-end](https://github.com/samuelmsilva2v/apiFinancas)\n---\n\n# Financial Control Web\n\n[🇧🇷 Leia em Português](#controle-de-finanças-web)\n\n💸 This is a front-end project developed with **Angular**. The goal of the project is to develop an application for financial management, including tracking income, expenses, transaction categories, and the total balance of a user.\n\n## Features\n\nThe Financial Control API offers the following features:\n\n- **Add, update, and remove payable accounts**: Register new accounts payable with name, amount, date, and category.\n- **Add, update, and remove receivable funds**: Register new income entries with name, amount, date, and category.\n- **Category management**: Each expense can be associated with a category (e.g., Food, Leisure, Transportation, etc.).\n\n## Endpoints\n\n### Account Endpoints\n| Method | Endpoint              | Description                   |\n|--------|-----------------------|-------------------------------|\n| POST   | `/api/contas`         | Registers a new account       |\n| GET    | `/api/contas`         | Retrieves all accounts        |\n| GET    | `/api/contas/{id}`    | Retrieves account details by ID |\n| PUT    | `/api/contas/{id}`    | Updates an account            |\n| DELETE | `/api/contas/{id}`    | Deletes an account            |\n\n### Category Endpoints\n| Method | Endpoint              | Description                   |\n|--------|-----------------------|-------------------------------|\n| POST   | `/api/categorias`     | Registers a new category      |\n| GET    | `/api/categorias`     | Retrieves all categories      |\n| GET    | `/api/categorias/{id}`| Retrieves category details by ID |\n| PUT    | `/api/categorias/{id}`| Updates a category            |\n| DELETE | `/api/categorias/{id}`| Deletes a category            |\n\n## Technologies Used:\n#### Back-end:\n* Java 17\n* Spring Boot\n* Spring Data JPA\n* Hibernate\n* PostgreSQL\n* Swagger\n* Lombok\n* Model Mapper\n* Bean Validation (javax.validation\n* Docker\n#### Front-end:\n* Angular 19\n* Bootstrap\n* HttpClient\n\n## Installation:\n\n#### **1. Clone the Back-end Repository**\n```bash\n git clone https://github.com/samuelmsilva2v/apiFinancas.git\n cd apiFinancas\n```\n\n#### **2. Run the command below to create the Docker image:**\n```bash\ndocker build -t apifinancas\n```\n##### Running the Container\n```bash\ndocker-compose up -d\n```\nAccess the Swagger documentation: http://localhost:8082/swagger-ui/index.html#\n\n**3. Clone the Front-end Repository**\n```bash\ngit clone https://github.com/samuelmsilva2v/webFinancas.git\ncd webFinancas\n```\n\n**4. Install the project dependencies:**\n```bash\nnpm install\n```\n\n**5. Run the front-end:**\n```bash\nng s -o\n```\nThis will start the development server at URL http://localhost:4200/. You can open your browser and access this URL to view the application.\n\n### API Running Integrated with the Front-End\n![](https://github.com/samuelmsilva2v/assets/blob/main/apiFinancas/Captura%20de%20tela%202024-10-31%20184207.png)\n![](https://github.com/samuelmsilva2v/assets/blob/main/apiFinancas/Captura%20de%20tela%202024-10-31%20184231.png)\n\n#### [Back-end Repository](https://github.com/samuelmsilva2v/apiFinancas)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelmsilva2v%2Fwebfinancas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamuelmsilva2v%2Fwebfinancas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelmsilva2v%2Fwebfinancas/lists"}