{"id":21933926,"url":"https://github.com/pabloxt14/nlw-expert-polls","last_synced_at":"2026-04-09T23:01:52.819Z","repository":{"id":221780477,"uuid":"755299822","full_name":"PabloXT14/nlw-expert-polls","owner":"PabloXT14","description":"Um sistema de votação em tempo real em que os usuários podem criar uma enquete e outros usuários podem votar. O sistema gera uma classificação entre as opções e atualiza os votos em tempo real.","archived":false,"fork":false,"pushed_at":"2024-02-12T20:19:07.000Z","size":1341,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-27T22:03:20.189Z","etag":null,"topics":["fastify","nodejs","postgresql","prisma","redis","typescript","websocket","zod"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PabloXT14.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2024-02-09T20:54:03.000Z","updated_at":"2024-02-12T20:21:14.000Z","dependencies_parsed_at":"2025-05-29T03:04:15.092Z","dependency_job_id":"a5e14d84-401d-4a83-9159-0547137e8cb5","html_url":"https://github.com/PabloXT14/nlw-expert-polls","commit_stats":null,"previous_names":["pabloxt14/nlw-expert-polls"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PabloXT14/nlw-expert-polls","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PabloXT14%2Fnlw-expert-polls","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PabloXT14%2Fnlw-expert-polls/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PabloXT14%2Fnlw-expert-polls/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PabloXT14%2Fnlw-expert-polls/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PabloXT14","download_url":"https://codeload.github.com/PabloXT14/nlw-expert-polls/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PabloXT14%2Fnlw-expert-polls/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262341616,"owners_count":23296068,"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":["fastify","nodejs","postgresql","prisma","redis","typescript","websocket","zod"],"created_at":"2024-11-29T00:13:59.767Z","updated_at":"2026-04-09T23:01:52.772Z","avatar_url":"https://github.com/PabloXT14.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\r\n  \u003cimg\r\n    src=\".github/nlw-expert-logo.png\"\r\n    title=\"Logo NLW Expert\"\r\n    alt=\"Logo NLW Expert\"\r\n    width=\"30px\"\r\n  /\u003e\r\n  NLW Expert (Node.js)\r\n\u003c/h1\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cimg alt=\"GitHub language count\" src=\"https://img.shields.io/github/languages/count/pabloxt14/nlw-expert-polls\"\u003e\r\n\r\n  \u003cimg alt=\"GitHub Top Language\" src=\"https://img.shields.io/github/languages/top/pabloxt14/nlw-expert-polls\" /\u003e\r\n\r\n  \u003cimg alt=\"Repository size\" src=\"https://img.shields.io/github/repo-size/pabloxt14/nlw-expert-polls\"\u003e\r\n  \r\n  \u003ca href=\"https://github.com/pabloxt14/nlw-expert-polls/commits/master\"\u003e\r\n    \u003cimg alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/pabloxt14/nlw-expert-polls\"\u003e\r\n  \u003c/a\u003e\r\n    \r\n   \u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-MIT-blue\"\u003e\r\n\r\n   \u003ca href=\"https://github.com/pabloxt14/nlw-expert-polls/stargazers\"\u003e\r\n    \u003cimg alt=\"Stargazers\" src=\"https://img.shields.io/github/stars/pabloxt14/nlw-expert-polls?style=social\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp\u003e\r\n  \u003cimg src=\".github/cover.png\" alt=\"Capa do projeto\" /\u003e\r\n\u003c/p\u003e\r\n\r\n\u003ch4 align=\"center\"\u003e \r\n\t🚀 Aplicação finalizada 🚀\r\n\u003c/h4\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n \u003ca href=\"#-about\"\u003eAbout\u003c/a\u003e | \r\n \u003ca href=\"#-requisites\"\u003eRequisites\u003c/a\u003e | \r\n \u003ca href=\"#-setup\"\u003eSetup\u003c/a\u003e | \r\n \u003ca href=\"#-http-routes\"\u003eHTTP Routes\u003c/a\u003e | \r\n \u003ca href=\"#-websocket-routes\"\u003eWebsocket Routes\u003c/a\u003e | \r\n \u003ca href=\"#-license\"\u003eLicense\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n## 💻 About\r\n\r\nUm sistema de votação em tempo real em que os usuários podem criar uma enquete e outros usuários podem votar. O sistema gera uma classificação entre as opções e atualiza os votos em tempo real.\r\n\r\nVale ressaltar que este projeto foi desenvolvido durante o evento **NLW** oferecido pela [Rocketseat](https://www.rocketseat.com.br/).\r\n\r\n---\r\n\r\n## 📝 Requisites\r\n\r\nAntes de baixar o projeto você vai precisar ter instalado na sua máquina as seguintes ferramentas:\r\n\r\n* [Git](https://git-scm.com)\r\n* [NodeJS](https://nodejs.org/en/)\r\n* [NPM](https://www.npmjs.com/) ou [Yarn](https://yarnpkg.com/) \r\n* Para o banco de dados ter o [Docker](https://www.docker.com/) para baixar as imagens dos bancos PostgreSQL e Redis que utilizamos na aplicação.\r\n\r\nAlém disto é bom ter um editor para trabalhar com o código como [VSCode](https://code.visualstudio.com/)\r\n\r\n\u003e Para mais detalhes das dependências gerais da aplicação veja o arquivo [package.json](./package.json)\r\n\r\n---\r\n\r\n## ⚙ Setup\r\n\r\nPasso a passo para clonar e executar a aplicação na sua máquina:\r\n\r\n```bash\r\n# Clone este repositório\r\n$ git clone git@github.com:pabloxt14/nlw-expert-polls.git\r\n\r\n# Instale as dependências\r\n$ npm install\r\n\r\n# Configurar PostgreSQL e Redis\r\n$ docker compose up -d\r\n\r\n# Crie uma arquivo .env e preencha conforme apresentado no arquivo .env.example\r\n$ cp .env.example .env\r\n\r\n# Criar as migrations no banco com o Prisma\r\n$ npx prisma migrate dev\r\n\r\n# Execute a aplicação em modo de desenvolvimento\r\n$ npm run dev\r\n```\r\n\r\nTeste! (Eu pessoalmente recomendo testar a aplicação com o [Hoppscotch](https://hoppscotch.io/)).\r\n\r\n---\r\n\r\n## HTTP Routes\r\n\r\n### POST `/polls`\r\n\r\nCria uma nova enquete.\r\n\r\n#### Request body\r\n\r\n```json\r\n{\r\n  \"title\": \"Qual a melhor linguagem de programação?\",\r\n  \"options\": [\r\n    \"JavaScript\",\r\n    \"Java\",\r\n    \"PHP\",\r\n    \"C#\"\r\n  ]\r\n}\r\n```\r\n\r\n#### Response body\r\n\r\n```json\r\n{\r\n  \"pollId\": \"194cef63-2ccf-46a3-aad1-aa94b2bc89b0\"\r\n}\r\n```\r\n\r\n### GET `/polls/:pollId`\r\n\r\nRetorna os dados de uma única enquete.\r\n\r\n#### Response body\r\n\r\n```json\r\n{\r\n\t\"poll\": {\r\n\t\t\"id\": \"e4365599-0205-4429-9808-ea1f94062a5f\",\r\n\t\t\"title\": \"Qual a melhor linguagem de programação?\",\r\n\t\t\"options\": [\r\n\t\t\t{\r\n\t\t\t\t\"id\": \"4af3fca1-91dc-4c2d-b6aa-897ad5042c84\",\r\n\t\t\t\t\"title\": \"JavaScript\",\r\n\t\t\t\t\"score\": 1\r\n\t\t\t},\r\n\t\t\t{\r\n\t\t\t\t\"id\": \"780b8e25-a40e-4301-ab32-77ebf8c79da8\",\r\n\t\t\t\t\"title\": \"Java\",\r\n\t\t\t\t\"score\": 0\r\n\t\t\t},\r\n\t\t\t{\r\n\t\t\t\t\"id\": \"539fa272-152b-478f-9f53-8472cddb7491\",\r\n\t\t\t\t\"title\": \"PHP\",\r\n\t\t\t\t\"score\": 0\r\n\t\t\t},\r\n\t\t\t{\r\n\t\t\t\t\"id\": \"ca1d4af3-347a-4d77-b08b-528b181fe80e\",\r\n\t\t\t\t\"title\": \"C#\",\r\n\t\t\t\t\"score\": 0\r\n\t\t\t}\r\n\t\t]\r\n\t}\r\n}\r\n```\r\n\r\n### POST `/polls/:pollId/votes`\r\n\r\nAdiciona um voto a uma enquete específica.\r\n\r\n#### Request body\r\n\r\n```json\r\n{\r\n  \"pollOptionId\": \"31cca9dc-15da-44d4-ad7f-12b86610fe98\"\r\n}\r\n```\r\n\r\n#### Response body\r\n\r\n```json\r\n{\r\n  \"message\": \"Votado com sucesso!\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## WebSocket Routes\r\n\r\n### ws `/polls/:pollId/results`\r\n\r\n#### Message\r\n\r\n```json\r\n{\r\n  \"pollOptionId\": \"da9601cc-0b58-4395-8865-113cbdc42089\",\r\n  \"votes\": 2\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📝 License\r\n\r\nEste projeto está sob a licença MIT. Consulte o arquivo [LICENSE](./LICENSE) para mais informações\r\n\r\n---\r\n\r\n\u003cp align=\"center\"\u003e\r\n  Feito com 💜 por Pablo Alan 👋🏽 \u003ca href=\"https://www.linkedin.com/in/pabloalan/\" target=\"_blank\"\u003eEntre em contato!\u003c/a\u003e  \r\n\u003c/p\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpabloxt14%2Fnlw-expert-polls","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpabloxt14%2Fnlw-expert-polls","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpabloxt14%2Fnlw-expert-polls/lists"}