Fluxo de Trabalho e Automação¶

# ==========================================
# Configurações do Projeto
# ==========================================
BINARY_NAME=dataprofiler.exe
DOCKER_IMAGE=dataprofiler:latest
FRONTEND_DIR=frontend
CMD_DIR=cmd/api

# O primeiro comando é o padrão. Digitou 'make', roda o 'dev-full'.
all: dev-full

# .PHONY diz ao Make que esses não são arquivos reais
.PHONY: setup install-tools dev dev-full docs back front build build-all build-windows test test-race test-fuzz fmt \
    frontend-install frontend-build docker-build docker-run benchmark clean profile-heap \
    docs-install docs-serve docs-build release docs-clean docs-deploy check-cgo

# ==========================================
# 🚀 Workflow Diário (Daily Driver)
# ==========================================

# Roda o Backend
back:
    @echo [BACK] Iniciando Backend...
    go run $(CMD_DIR)/main.go

# Roda o Frontend
front:
    @echo [FRONT] Iniciando Frontend...
    cd $(FRONTEND_DIR) && npm run dev

# Roda tudo com logs identificados e coloridos
dev:
    -FORCE_COLOR=1 npx concurrently \
        --colors \
        --names "BACK,FRONT" \
        --prefix-colors "magenta,cyan" \
        --kill-others \
        --handle-input \
        "go run $(CMD_DIR)/main.go" \
        "cd $(FRONTEND_DIR) && node node_modules/vite/bin/vite.js"

# Roda Backend + Frontend + Documentação
dev-full:
    -FORCE_COLOR=1 npx concurrently \
        --colors \
        --names "BACK,FRONT,DOCS" \
        --prefix-colors "magenta,cyan,yellow" \
        --kill-others \
        --handle-input \
        "go run $(CMD_DIR)/main.go" \
        "cd $(FRONTEND_DIR) && node node_modules/vite/bin/vite.js" \
        "python -m mkdocs serve"

# Roda o servidor local de documentação (Hot Reload)
docs:
    @echo [DOCS] Iniciando servidor em http://127.0.0.1:8000
    python -m mkdocs serve

# ==========================================
# 📚 Documentação (MkDocs)
# ==========================================

# Instala o MkDocs e o tema Material via Python
docs-install:
    @echo [SETUP] Instalando dependencias de documentacao...
    pip install -r requirements.txt

# Gera o site estático na pasta /site (para deploy)
docs-build:
    @echo [BUILD] Compilando site estatico...
    python -m mkdocs build
    @echo [DONE] Documentacao gerada na pasta 'site/'

# Limpa a pasta de build
docs-clean:
    @echo [CLEAN] Limpando arquivos antigos...
    rm -rf site/
    @echo [DONE] Limpeza concluida.

# Publica no GitHub Pages
docs-deploy:
    @echo [DEPLOY] Publicando documentacao no GitHub Pages...
    python -m mkdocs gh-deploy --force
    @echo [DONE] Documentacao publicada! Acesse em: https://jgustavocn.github.io/dataprofiler/

# ==========================================
# 🏗️ Build & Distribuição
# ==========================================

# Build simples (Linux/Mac ou dev rápido)
build:
    go build -o $(BINARY_NAME) ./$(CMD_DIR)

# Build Completo (Front + Back)
build-all: frontend-build build

# Build Profissional Windows (Com Ícone e Otimizado)
build-windows: frontend-install frontend-build
    @echo [RSRC] Gerando icone...
    rsrc -ico app.ico -o $(CMD_DIR)/rsrc.syso
    @echo [BUILD] Compilando binário Windows...
    go build -ldflags "-s -w -H=windowsgui" -o $(BINARY_NAME) ./$(CMD_DIR)
    @echo [DONE] Build concluído: ./$(BINARY_NAME)

# ==========================================
# 🧪 Qualidade & Testes
# ==========================================
test:
    go test ./...

# Detecta Race Conditions (Essencial para Go Routines)
# Adaptação Bash: Variável definida na frente do comando, sem 'set' e sem '&&'
test-race: check-cgo
    CGO_ENABLED=1 go test -race ./...

# Teste de Estresse (Fuzzing)
test-fuzz:
    go test ./internal/profiler -fuzz=FuzzInferType -fuzztime=10s

fmt:
    go fmt ./...
    go mod tidy

# ==========================================
# 🛠️ Ferramentas & Setup
# ==========================================

# Prepara a máquina
setup: install-tools frontend-install docs-install
    go mod tidy

# Verifica se o GCC existe (Adaptação Bash: usa 'which' ou 'command -v')
check-cgo:
    @command -v gcc >/dev/null 2>&1 || (echo [ERRO] GCC nao encontrado. Instale o MinGW/TDM-GCC para usar -race. && exit 1)

install-tools:
    @echo [SETUP] Instalando ferramenta de ícone (rsrc)...
    go install github.com/akavel/rsrc@latest

frontend-install:
    cd $(FRONTEND_DIR) && npm install

frontend-build:
    cd $(FRONTEND_DIR) && npm run build

# ==========================================
# 🐳 Docker
# ==========================================
docker-build:
    docker build -t $(DOCKER_IMAGE) .

docker-run:
    docker compose up app

benchmark:
    @echo [BENCH] Iniciando Benchmark (Necessário arquivo large_dataset.csv)...
    docker compose --profile test up benchmark

# ==========================================
# 🔍 Profiling
# ==========================================
profile-heap:
    @echo [PPROF] Capturando Heap Profile...
    curl -o heap.out http://localhost:6060/debug/pprof/heap
    go tool pprof -http=:8081 heap.out

# ==========================================
# 📦 Release
# ==========================================
release: frontend-install frontend-build
    @echo [RELEASE] Preparando release...
    mkdir -p bin

    @echo [RSRC] Gerando icone...
    rsrc -ico app.ico -o $(CMD_DIR)/rsrc.syso

    @echo [BUILD] Compilando para Windows (amd64)...
    go build -ldflags="-s -w" -o bin/dataprofiler.exe ./$(CMD_DIR)

    @echo [BUILD] Compilando para Linux (amd64)...
    GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o bin/dataprofiler-linux ./$(CMD_DIR)

    @echo [DONE] Binarios criados na pasta bin/!

# ==========================================
# 🧹 Limpeza (Versão Git Bash / Linux)
# ==========================================
clean:
    go clean
    rm -f $(BINARY_NAME)
    rm -rf bin site .cache
    rm -f $(CMD_DIR)/rsrc.syso
    rm -f *.out
    @docker compose down --remove-orphans 2>/dev/null || echo "Docker não estava rodando."
    @echo [DONE] Limpeza concluida.