{"id":17008900,"url":"https://github.com/barbaracalderon/teamtrack","last_synced_at":"2026-04-12T09:10:29.028Z","repository":{"id":242930342,"uuid":"803981858","full_name":"barbaracalderon/teamtrack","owner":"barbaracalderon","description":"O TeamTrack é uma aplicação para visualização de projetos com status \"em_aberto\" para manter o rastreio de seus clientes e atividades.","archived":false,"fork":false,"pushed_at":"2024-05-23T18:49:29.000Z","size":1022,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-27T12:11:44.064Z","etag":null,"topics":["backend","frontend","insomnia","java","jdk-17","jdk17","jpa","lombok","maven","postgresql","rest","rest-api","spring-boot","vuejs"],"latest_commit_sha":null,"homepage":"","language":"Java","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/barbaracalderon.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-05-21T18:20:30.000Z","updated_at":"2024-06-05T16:53:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"894b6878-20fb-4f4e-b22b-f4cc512951a9","html_url":"https://github.com/barbaracalderon/teamtrack","commit_stats":null,"previous_names":["barbaracalderon/teamtrack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fteamtrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fteamtrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fteamtrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/barbaracalderon%2Fteamtrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/barbaracalderon","download_url":"https://codeload.github.com/barbaracalderon/teamtrack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244959449,"owners_count":20538625,"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":["backend","frontend","insomnia","java","jdk-17","jdk17","jpa","lombok","maven","postgresql","rest","rest-api","spring-boot","vuejs"],"created_at":"2024-10-14T05:42:11.188Z","updated_at":"2026-04-12T09:10:28.988Z","avatar_url":"https://github.com/barbaracalderon.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TeamTrack\n\nO TeamTrack é um aplicativo de gerenciamento de projetos para manter o rastreio de seus clientes e atividades.\n\n![TeamTrack App](readme/teamtrack_01.png)\n\n## Funcionamento Geral da Aplicação\n\nPara a aplicação funcionar localmente, é preciso seguir alguns passos importantes. O detalhamento desses passos será dado adiante, mas a visão geral é a seguinte:\n\n1. Primeiramente, defina um banco de dados com nome \"teamtrack\" no PostgreSQL, com senha própria.\n2. Suba o servidor backend em `http://localhost:8080`.\n3. Com isso, é possível fazer requisições para os endpoints da API: `/clientes`, `/projetos`, `/atividades`.\n4. Recomenda-se realizar requisições por meio de aplicativos como Insomnia ou Postman.\n5. Suba também o servidor frontend em `http://localhost:5173`.\n6. A tela da aplicação será mostrada conforme a imagem acima: a diferença é que serão mostrados os projetos, clientes e atividades conforme definidos pelo usuário nas requisições com a API. A imagem acima mostra um exemplo.\n\n## Autor\n\nBarbara Calderon, desenvolvedora de software.\n\n- [Github](https://www.github.com/barbaracalderon)\n- [LinkedIn](https://www.linkedin.com/in/barbaracalderondev)\n- [Twitter](https://www.x.com/bederoni)\n\n## Tecnologias Usadas\n\n### Backend\n\n- **Linguagem:** Java 17\n- **Framework:** Spring Boot 3.2.5\n- **Banco de Dados:** PostgreSQL\n- **Dependências Principais:**\n  - Spring Boot Starter Data JPA\n  - Spring Boot Starter Web\n  - Spring Boot DevTools\n  - Lombok\n  - Jakarta Validation API\n  - Spring Boot Starter Test\n  - JUnit\n  - Mockito\n\n### Frontend\n\n- **Linguagem:** JavaScript\n- **Framework:** Vue.js 3\n- **Ferramenta de Build:** Vite\n- **Estilização:** Bootstrap 4.5.2, CSS3\n- **Gerenciamento de Estado:** Pinia\n- **HTML5**\n\nTambém foi utilizado o Insomnia para requisições ao servidor backend e povoamento do banco de dados TeamTrack.\n\n## Instruções de Configuração - Backend\n\n1. Clone o repositório:\n\n   ```bash\n   git clone git@github.com:barbaracalderon/teamtrack.git\n\n2. Crie um banco de dados no PostgreSQL com nome \"teamtrack\"\n\n3. Configure o arquivo application.properties\n\n```properties\nspring.application.name=teamtrack\nserver.port=8080\nspring.datasource.url=jdbc:postgresql://localhost:5432/teamtrack\nspring.datasource.username=postgres\nspring.datasource.password=[sua senha aqui]\nspring.datasource.driver-class-name=org.postgresql.Driver\nspring.jpa.properties.hibernate.format_sql=true\nspring.jpa.hibernate.ddl-auto=update\nspring.jpa.show-sql=true\n```\n\n4. Execute a aplicação\n\n```bash\n./mvnw spring-boot:run\n```\n\n![TeamTrack App](readme/teamtrack_02.png)\n\nO servidor será iniciado em http://localhost:8080/\n\n5. Uso pelo Insomnia\n\nRecomenda-se o uso do Insomnia para realizar as requisições aos endpoints da API e povoar o banco de dados com as informações desejadas. Neste projeto também encontra-se um arquivo do Insomnia com os dados utilizados na construção do projeto: Insomnia_teamtrackjson.\n\n![TeamTrack App](readme/teamtrack_03.png)\n![TeamTrack App](readme/teamtrack_04.png)\n\n6. Endpoints da API\n\n| Método | Endpoint                  | Descrição                                            |\n|--------|---------------------------|------------------------------------------------------|\n| POST   | /clientes                 | Cria um novo cliente                                 |\n| GET    | /clientes                 | Lista todos os clientes                              |\n| POST   | /projetos                 | Cria um novo projeto                                 |\n| GET    | /projetos                 | Lista todos os projetos                              |\n| GET    | /projetos/em_aberto       | Lista todos os projetos em aberto                    |\n| POST   | /atividades               | Cria uma nova atividade associada a um projeto       |\n| GET    | /atividades               | Lista todas as atividades                             |\n\n\n7. Logs\n\nA aplicação conta com aplicação de Logs (`@slf4j`) para visualização de `infos` e `errors` no terminal.\n\n8. Testes\n\nRode os testes com o comando:\n\n```bash\nmvn test\n```\nSão 24 testes totais. O resultado é verificado abaixo:\n\n![TeamTrack App](readme/teamtrack_05.png)\n\n## Instruções de Configuração - Frontend\n\nA parte frontend do projeto encontra-se no diretório \"frontend\". \n\n1. Entre no diretório frontend, ainda com o servidor backend ativo.\n\n2. Execute o comando para subir\n\n```bash\nnpm run dev\n```\n\nA aplicação será inicializada em `http://localhost:5173/`\n\n3. Abra o navegador no endereço citado acima e utilize a aplicação.\n\nVocê verá a aplicação dinâmica e responsiva, sendo atualizada ao mesmo tempo que novos dados são inseridos no servidor backend. Foi utilizado o \"accordion\" para visualização dos dados, de modo que temos o nome do projeto, o nome do cliente relacionado ao projeto e também as atividades daquele projeto. Algumas imagens da aplicação ativa e funcionando estão abaixo.\n\n\n![TeamTrack App](readme/teamtrack_06.png)\n\n![TeamTrack App](readme/teamtrack_07.png)\n\n![TeamTrack App](readme/teamtrack_08.png)\n\n![TeamTrack App](readme/teamtrack_09.png)\n\n![TeamTrack App](readme/teamtrack_10.png)\n\n\n## Considerações finais\n\nO TeamTrack foi desenvolvido inteiramente por mim, Barbara Calderon, com o objetivo de facilitar o gerenciamento de projetos, clientes e tarefas, oferecendo uma interface intuitiva e funcionalidades requisitadas. A combinação do Spring Boot no backend e do Vue.js no frontend proporciona uma aplicação eficiente e de fácil manutenção. Esperamos que este sistema atenda às suas necessidades e facilite o acompanhamento de suas atividades diárias.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarbaracalderon%2Fteamtrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbarbaracalderon%2Fteamtrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbarbaracalderon%2Fteamtrack/lists"}