SUN Booking Tours

A tour booking web application with separate public and admin interfaces, built with Go and server-side rendering.

Tech Stack

• Backend: Go 1.22+, Gin Web Framework
• Database: PostgreSQL 16, GORM
• Auth: bcrypt, OAuth2 (goth)
• Templating: Go html/template (SSR)
• UI: Bootstrap 5
• Container: Docker, Docker Compose

Features

Public Site

• Browse tours and categories
• User registration and authentication (email + OAuth2)
• Tour booking with schedule selection
• User profile and bank account management
• Tour ratings and reviews with comments

Admin Site

• User management
• Tour and category management
• Booking and payment tracking
• Review moderation

Quick Start

Prerequisites

• Docker and Docker Compose
• Go 1.22+ (for local development)

Setup

1. Clone the repository:

git clone <repository-url>
cd sun-booking-tours

2. Copy environment file:

cp .env.example .env

3. Start services:

make up

4. Run migrations:

make migrate-up

5. Access the application:

• Public site: http://localhost:8080
• Admin site: http://localhost:8080/admin

Development

Docker Commands

# Start containers
make up

# View logs (follow mode)
make logs

# Stop containers
make down

# Restart containers
make restart

# Rebuild and start
make docker-build

Database Commands

# Run migrations (inside Docker)
make migrate-up

# Rollback migration
make migrate-down

# Seed database
make seed

Local Development (Hot Reload)

For automatic code reloading during development (run locally, not in Docker):

# 1. Install Air (one-time setup)
go install github.com/air-verse/air@latest

# 2. Make sure .env has GIN_MODE=debug
cp .env.example .env
# Edit .env: GIN_MODE=debug

# 3. Start database only (not the app)
make db

# 4. Run dev server with hot reload
make dev
# or
make run

# Now edit any .go, .html, .css file → auto-reload! ⚡

Hot reload features:

• ✅ Go code changes auto-rebuild (~1-2s)
• ✅ Template (.html) changes refresh immediately (no rebuild needed)
• ✅ Static files (.css, .js) auto-reload

Important:

• Hot reload only works when running locally with make dev
• If running in Docker (make up), templates are cached and won't hot reload
• For production, GIN_MODE=release caches templates for performance

Other Commands

# Run tests
make test

# Format code
make fmt

# Tidy dependencies
make tidy

Project Structure

├── cmd/app/                # Application entry point
├── internal/
│   ├── config/            # Configuration
│   ├── models/            # GORM models
│   ├── repository/        # Data access layer
│   ├── services/          # Business logic
│   ├── handlers/          # HTTP handlers (admin & public)
│   └── middleware/        # Auth, CSRF, etc.
├── templates/             # Go html templates
├── static/                # CSS, JS, images
├── migrations/            # Database migrations
└── specs/                 # Task specifications

Architecture

The application follows a layered architecture:

Handler → Service → Repository → GORM Model

• Handler: Parse requests, render templates
• Service: Business logic and validation
• Repository: Database queries
• Model: GORM entity definitions

License

MIT