{"id":20137210,"url":"https://github.com/fatec-degree/fatec-tg-api-donations-points","last_synced_at":"2026-04-05T22:35:09.132Z","repository":{"id":64818239,"uuid":"578406520","full_name":"fatec-degree/fatec-tg-api-donations-points","owner":"fatec-degree","description":"API que armazena endereços de pontos de doação de agasalhos. Esses pontos são coletados a partir de um processo de Web Scraping feito pela aplicação Donations Points Scraping.","archived":false,"fork":false,"pushed_at":"2023-04-26T23:36:03.000Z","size":184,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-01T11:51:10.963Z","etag":null,"topics":["aws","beanstalk","cicd","docker","docker-compose","github-actions","java","jpa","maven","mysql","rds-database","s3-bucket","sprintboot","terraform"],"latest_commit_sha":null,"homepage":"","language":"HCL","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/fatec-degree.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":"2022-12-15T01:22:18.000Z","updated_at":"2024-04-15T00:58:50.000Z","dependencies_parsed_at":"2024-11-13T21:33:28.568Z","dependency_job_id":"8f0c5dee-6ceb-4ed4-b40a-57b51767419f","html_url":"https://github.com/fatec-degree/fatec-tg-api-donations-points","commit_stats":null,"previous_names":["fatec-degree/fatec-tg-api-donations-points"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fatec-degree/fatec-tg-api-donations-points","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatec-degree%2Ffatec-tg-api-donations-points","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatec-degree%2Ffatec-tg-api-donations-points/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatec-degree%2Ffatec-tg-api-donations-points/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatec-degree%2Ffatec-tg-api-donations-points/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fatec-degree","download_url":"https://codeload.github.com/fatec-degree/fatec-tg-api-donations-points/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatec-degree%2Ffatec-tg-api-donations-points/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31452899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"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":["aws","beanstalk","cicd","docker","docker-compose","github-actions","java","jpa","maven","mysql","rds-database","s3-bucket","sprintboot","terraform"],"created_at":"2024-11-13T21:25:55.652Z","updated_at":"2026-04-05T22:35:08.942Z","avatar_url":"https://github.com/fatec-degree.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# API Donations Points\n\nAPI que armazena endereços de pontos de coleta de agasalhos para doação. Esses pontos são coletados a partir de um processo de **Web Scraping** feito pela aplicação [Donations Points Scraping](https://github.com/PedroHPAlmeida/fatec-tg-scraping-donations-points).\n\nO objetivo destas duas aplicações em conjunto é fazer um \"compilado\" de pontos de coleta de agasalhos, independente de instituições. Deixando as informações centralizadas em um único lugar e permitindo a fácil consulta.\n______\n## Tecnologias utilizadas\n\n* Java e Spring para desenvolvimento da API;\n* Bancos de dados H2 (em memória) e MySQL; \n* Docker para conteinerizar a aplicação e o banco de dados facilitando o desenvolvimento local;\n* Docker Compose para subir os múltiplos conteiners da aplicação (conteiner da aplicação e do banco);\n* Terraform para provisionar a infraestrutura na cloud AWS;\n* Cloud AWS para realizar o deploy da aplicação. Recursos utilizados: AWS Elastic Beanstalk, Amazon S3 e Amazon Relational Database Service (RDS);\n* GitHub Actions para CI e CD:\n    - Automação de testes e build da aplicação;\n    - Atualização automática da imagem docker da aplicação no repositório do [DockerHub Repository - Pedro](https://hub.docker.com/repository/docker/pedro6571/fatec-tg-api-donations-points);\n    - Entrega do software em ambiente produtivo de forma automática. \n\n______\n## Pré-requisitos para executar o projeto\n\n* Docker version 20.10.22\n* Docker Compose v2.6.0\n\n______\n## Como executar o projeto\n\n1. Clone este repositório:\n\n```\ngit clone https://github.com/PedroHPAlmeida/fatec-tg-api-donations-points.git\n```\n\n2. Entre na pasta onde se encontram os arquivos ```docker-compose```:\n```\ncd deploy/docker\n```\n\u003cdiv align=\"center\"\u003e\n\n![docker compose files](img/docker-compose.png)\n\n\u003c/div\u003e\n\n3. Nesta pasta há dois arquivos: ```docker-compose-dev.yml``` e ```docker-compose-prd.yml```. O objetivo do arquivo ```-dev``` é simular o ambiente de desenvolvimento, contendo um banco de dados H2 (em memória). De forma semelhante o arquivo ```-prd``` simula o ambiente de produção, contendo um banco de dados MySQL. Para executar a aplicação, execute os seguintes comandos:\n\nPara simular o ambiente de dev:\n```\ndocker compose -f docker-compose-dev.yml up -d\n```\nPara simular o ambiente de prd:\n```\ndocker compose -f docker-compose-prd.yml up -d\n```\nA aplicação estará em execução na porta 8080:\n\n![http://localhost:8080](img/localhost.png)\n\n\n4. Para buscar dados da API utilize o seguinte endpoint:\n\n```bash\ncurl --location --request GET 'localhost:8080/api/donations-points'\n```\n\n5. Para salvar dados utilize o seguinte endpoint:\n```bash\ncurl --location --request POST 'localhost:8080/api/donations-points' \\\n     --header 'Content-Type: application/json' \\\n     --data-raw '{\n     \"name\": \"string\",\n     \"cep\": \"string\",\n     \"state\": \"string\",\n     \"city\": \"string\",\n     \"district\": \"string\",\n     \"street\": \"string\",\n     \"number\": \"string\",\n     \"lng\": 0,\n     \"lat\": 0\n}'\n```\n\n6. O Swagger da aplicação se encontra no endereço: http://localhost:8080/swagger-ui/index.html\n\n![Swagger](img/swagger.png)\n______\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffatec-degree%2Ffatec-tg-api-donations-points","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffatec-degree%2Ffatec-tg-api-donations-points","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffatec-degree%2Ffatec-tg-api-donations-points/lists"}