Go Task API

Minimalist and high-performance task management API built strictly with the Go standard library.

Go Task API is a high-performance RESTful service designed to manage task lifecycles with zero external framework dependencies. It implements architectural patterns like Repository and Dependency Injection to ensure modularity, testability, and a low blast radius (Failure domain isolation) in multi-provider environments (Memory and PostgreSQL).

Project Showcase

API Interaction (curl)

Create a Task:

curl -i -X POST \
  -H "X-API-Key: secret-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Documentation Refactor", "description": "Implement high-quality docs", "status": "doing"}' \
  http://localhost:8080/tasks

List All Tasks:

curl -i -H "X-API-Key: secret-key" http://localhost:8080/tasks

Tech Stack

Prerequisites

• Go >= 1.22
• Docker & Docker Compose (for PostgreSQL)
• Make (optional, but recommended)

Installation and Usage

From Source

# 1. Clone the repository
git clone https://github.com/ESousa97/go-task-api.git
cd go-task-api

# 2. Start the database
docker-compose up -d

# 3. Build and Run
make run

Makefile Targets

Architecture

The project follows a modular structure separated by logical responsibilities, ensuring that business rules remain decoupled from infrastructure details.

graph TD
    Client[HTTP Client] --> Mux[net.ServeMux]
    Mux --> Handler[internal/handler]
    Handler --> RepoInterface[internal/repository Interface]
    RepoInterface --> Postgres[internal/repository/PostgreSQL]
    RepoInterface --> Memory[internal/repository/Memory]
    
    subgraph "Domain Layer"
    Task[internal/domain/Task]
    end

API Reference

View full documentation at pkg.go.dev/github.com/ESousa97/go-task-api.

Configuration

Roadmap

Acompanhe as etapas de evolução do projeto:

• Phase 1: Foundation — In-Memory persistence core.
• Phase 2: Persistence — PostgreSQL integration with Docker.
• Phase 3: Security — Middleware implementation (Auth & Recovery).
• Phase 4: Patterns — Repository Pattern & Dependency Injection.
• Phase 5: Governance — CI/CD, Professional Documentation and Badges.
• Phase 6: Observability — Structured logging and health checks.

Contributing

Interessado em colaborar? Veja nosso CONTRIBUTING.md para padrões de código e processo de PR.

License

Este projeto está licenciado sob a MIT License — veja o arquivo LICENSE para detalhes.