Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eric-souzams/node-polls-realtime
A real-time voting system where users can create a poll and other users can cast their votes in real-time.
https://github.com/eric-souzams/node-polls-realtime
docker fastify nodejs postgres prisma-orm redis websocket zod
Last synced: 22 days ago
JSON representation
A real-time voting system where users can create a poll and other users can cast their votes in real-time.
- Host: GitHub
- URL: https://github.com/eric-souzams/node-polls-realtime
- Owner: eric-souzams
- Created: 2024-04-20T15:17:16.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-04-20T15:17:51.000Z (8 months ago)
- Last Synced: 2024-04-20T17:01:53.836Z (8 months ago)
- Topics: docker, fastify, nodejs, postgres, prisma-orm, redis, websocket, zod
- Language: TypeScript
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Polls Realtime
A real-time voting system where users can create a poll and other users can cast their votes in real-time.
## Requisites
- Docker;
- Node.js v20;
## HTTP
### POST `/polls`
Create a new poll.
#### Request body
```json
{
"title": "Which programming language do you prefer?",
"options": [
"JavaScript",
"Java",
"PHP",
"C#"
]
}
```
#### Response body
```json
{
"pollId": "194cef63-2ccf-46a3-aad1-aa94b2bc89b0"
}
```
### GET `/polls/:pollId`
Return data from a single poll.
#### Response body
```json
{
"poll": {
"id": "e4365599-0205-4429-9808-ea1f94062a5f",
"title": "Which programming language do you prefer?",
"options": [
{
"id": "4af3fca1-91dc-4c2d-b6aa-897ad5042c84",
"title": "JavaScript",
"score": 1
},
{
"id": "780b8e25-a40e-4301-ab32-77ebf8c79da8",
"title": "Java",
"score": 0
},
{
"id": "539fa272-152b-478f-9f53-8472cddb7491",
"title": "PHP",
"score": 0
},
{
"id": "ca1d4af3-347a-4d77-b08b-528b181fe80e",
"title": "C#",
"score": 0
}
]
}
}
```
### POST `/polls/:pollId/votes`
Add a vote to specific poll.
#### Request body
```json
{
"pollOptionId": "31cca9dc-15da-44d4-ad7f-12b86610fe98"
}
```
## WebSockets
### ws `/polls/:pollId/results`
#### Message
```json
{
"pollOptionId": "da9601cc-0b58-4395-8865-113cbdc42089",
"votes": 2
}
```
## Setup
- Clone the repository;
- Install dependencies (`npm install`);
- Setup PostgreSQL and Redis (`docker compose up -d`);
- Copy `.env.example` file (`cp .env.example .env`);
- Run application (`npm run dev`);