📝 Task Tracker API

A lightweight, containerized task management system built with Go (Gin), PostgreSQL, and Vite + Nginx. Designed for fast development, reproducibility, and future scalability — ideal for learning Docker, backend API design, and full-stack orchestration.

🚀 Features

• RESTful API with GET and POST endpoints
• PostgreSQL database with auto-init via init.sql
• Frontend served via Nginx (Vite build)
• Docker Compose orchestration
• Clean separation of concerns: models, handlers, db
• Environment-based configuration via .env

🧱 Tech Stack

| Layer | Technology | |------------|--------------------| | Backend | Go + Gin | | Database | PostgreSQL | | Frontend | Vite + Nginx | | DevOps | Docker Compose |

📦 Setup Instructions

1. Clone the repo

git clone https://github.com/your-username/task-tracker-api.git
cd task-tracker-api

1. Create .env file
env
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=tasks
DB_URL=postgres://postgres:postgres@db:5432/tasks?sslmode=disable

2. Run the app
docker compose up --build

3. Access the app
Frontend: http://localhost:3000
Backend API: http://localhost:8080/tasks

📮 API Endpoints
GET /tasks
Returns all tasks.

json
[
  {
    "id": 1,
    "title": "Learn Docker",
    "completed": false
  }
]
POST /tasks
Creates a new task.

bash
curl -X POST http://localhost:8080/tasks \
  -H "Content-Type: application/json" \
  -d '{"title": "New Task", "completed": false}'

🛠 Project Structure
Code
task-tracker-api/
├── backend/
│   ├── db/
│   ├── handlers/
│   ├── models/
│   └── main.go
├── frontend/
│   └── (Vite project)
├── db/
│   └── init.sql
├── .env
├── docker-compose.yml
└── README.md

📄 License
This project is licensed under the MIT License. See LICENSE for details.

🌟 Author
Murad — building scalable, reproducible, and impactful platforms. Follow my journey on GitHub: github.com/MuradIsazade777