https://github.com/sudarshanmg/gotask
A complete backend for Task Manager with JWT Authentication, filtering, sorting and pagination support
https://github.com/sudarshanmg/gotask
api api-rest backend go golang jwt jwt-authentication postgresql
Last synced: 6 months ago
JSON representation
A complete backend for Task Manager with JWT Authentication, filtering, sorting and pagination support
- Host: GitHub
- URL: https://github.com/sudarshanmg/gotask
- Owner: sudarshanmg
- Created: 2025-05-14T20:22:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-16T06:58:33.000Z (about 1 year ago)
- Last Synced: 2025-08-22T19:26:34.930Z (10 months ago)
- Topics: api, api-rest, backend, go, golang, jwt, jwt-authentication, postgresql
- Language: Go
- Homepage:
- Size: 19.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 📌 gotask — Secure Task Manager API in Go
A production-ready, modular REST API built with Go, PostgreSQL, and JWT authentication.
---
### ⚙️ Features
- ✅ Clean architecture (handler → service → repository)
- 🔐 JWT-based authentication (register, login, protect routes)
- 🗃️ PostgreSQL persistence
- 📦 CRUD operations on tasks
- 🔍 Pagination, filtering, and sorting
- 🧼 Input validation using `go-playground/validator`
- 🧱 Structured error handling
- 📁 Environment-based config loading
---
### 📁 Project Structure
```
gotask/
├── cmd/
│ └── server/ # app entrypoint
├── internal/
│ ├── auth/ # register, login, jwt
│ └── task/ # task logic
├── pkg/
│ ├── config/ # env loader
│ ├── db/ # database connection
│ ├── response/ # response writers
│ └── validation/ # form validation
└── .env # local secrets (not committed)
```
---
### 🔧 Requirements
- Go 1.21+
- PostgreSQL
- Docker (optional)
---
### 🚀 Getting Started
#### 1. Clone the repo
```bash
git clone https://github.com/sudarshanmg/gotask.git
cd gotask
```
#### 2. Create `.env`
```env
PORT=8080
URL=postgres://:@localhost:5432/gotaskdb?sslmode=disable
JWT_SECRET=yourSuperSecretKey
JWT_EXPIRY=15m
```
#### 3. Run Postgres (Docker optional)
```bash
docker run -d --name pg \
-p 5432:5432 \
-e POSTGRES_USER=su \
-e POSTGRES_PASSWORD=secret \
-e POSTGRES_DB=gotaskdb \
postgres
```
#### 4. Create tables
```sql
-- run in psql
CREATE TABLE users (
id SERIAL PRIMARY KEY,
username TEXT UNIQUE NOT NULL,
password_hash TEXT NOT NULL,
created_at TIMESTAMP DEFAULT NOW()
);
CREATE TABLE tasks (
id SERIAL PRIMARY KEY,
title TEXT NOT NULL,
description TEXT,
completed BOOLEAN DEFAULT false,
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
```
#### 5. Run the server
```bash
go run cmd/server/main.go
```
---
### 🧪 API Endpoints
#### 🔑 Auth
- `POST /auth/register` – Register user
- `POST /auth/login` – Login, returns JWT token
#### 📌 Tasks (requires JWT)
- `GET /tasks` – List tasks (supports `?page=1&limit=10&sort=created_at&order=desc`)
- `POST /tasks` – Create a task
- `GET /tasks/{id}` – Get task by ID
- `PUT /tasks/{id}` – Update task
- `DELETE /tasks/{id}` – Delete task
> 💡 Pass `Authorization: Bearer ` in headers for protected routes.
---
### 🧭 Roadmap
- [x] JWT auth
- [x] Filtering & pagination
- [ ] Swagger docs
- [ ] Dockerfile & Compose setup
- [ ] Unit & integration tests
- [ ] CI/CD via GitHub Actions
---
### 👨💻 Author
Made with ❤️ by [@sudarshanmg](https://github.com/sudarshanmg)