Task API

A RESTful task management API built with Go and MongoDB.

Features

• JWT-based authentication
• CRUD operations for tasks
• Pagination and filtering
• Soft delete functionality
• Health checks
• Docker support

Architecture

flowchart LR
    subgraph Client
      A["User Agents
Web/Mobile/CLI"]
    end
    subgraph Ingress
      B["Ingress / API Gateway"]
    end
    subgraph API
      C["Go API Pods
(Chi Router)"]
      C --> D["Handlers & Services"]
      D --> E["MongoDB Replica Set"]
    end
    subgraph Observability
      F["Prometheus"]
      G["Log Collector"]
      H["OpenTelemetry"]
    end

    A --> B --> C
    C --> E
    C --> F
    C --> G
    C --> H

Loading

Quick Start

Using Docker Compose

docker compose up --build

Local Development

1. Install MongoDB:

brew install mongodb-community@7.0
brew services start mongodb-community@7.0

2. Set environment variables:

export TASKAPI_DATABASE_URI="mongodb://localhost:27017"
export TASKAPI_JWT_SECRET="your_secret_key"

3. Run the server:

go run cmd/server/main.go

API Usage

Login (get JWT token)

curl -X POST http://localhost:8080/v1/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","password":"admin123"}'

Create a task

curl -X POST http://localhost:8080/v1/tasks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"title":"Sample Task","description":"Task description","status":"open"}'

List tasks

curl -X GET http://localhost:8080/v1/tasks \
  -H "Authorization: Bearer <token>"

Health check

curl http://localhost:8080/healthz

Environment Variables

• TASKAPI_SERVER_PORT: Server port (default: 8080)
• TASKAPI_DATABASE_URI: MongoDB connection string
• TASKAPI_DATABASE_DATABASE: Database name (default: taskdb)
• TASKAPI_JWT_SECRET: JWT signing secret
• TASKAPI_JWT_EXPIRY_HOURS: Token expiry in hours (default: 24)