Operations

Configuration (`config.yaml`)

server:
  host: "127.0.0.1"    # loopback-only
  port: 8084
  mode: "release"       # debug | release
  read_timeout: "30s"
  write_timeout: "30s"

database:
  host: "localhost"
  port: 3306
  name: "RFQ_LOG"
  user: "priceforge"
  password: "CHANGE_ME"
  max_open_conns: 25
  max_idle_conns: 5
  conn_max_lifetime: "5m"

pricing:
  default_method: "weighted_median"
  default_period_days: 90
  freshness_green_days: 30
  freshness_yellow_days: 60
  freshness_red_days: 90
  min_quotes_for_median: 3

export:
  temp_dir: "/tmp/priceforge-exports"
  max_file_age: "1h"

alerts:
  enabled: true
  check_interval: "1h"
  high_demand_threshold: 5

logging:
  level: "info"    # debug | info | warn | error
  format: "json"   # json | text

Quick Start

cp config.example.yaml config.yaml
# Edit config.yaml: database.host, database.name, database.user, database.password
make run
# Open: http://127.0.0.1:8084/admin/pricing

Commands

# Run
make run
go run ./cmd/pfs

# Build
make build          # dev build
make build-release  # optimized, version via ldflags
make build-all      # cross-compile Linux/macOS/Windows

# Migrations
go run ./cmd/pfs -migrate
make backup-db

# Version
./bin/pfs -version

# Tests
make test

# Clean
make clean

Build System (Makefile)

Target	Action
`run`	`go run ./cmd/pfs`
`backup-db`	Run `go run ./cmd/dbbackup` using current `config.yaml`
`build`	Dev build with debug info
`build-release`	`-s -w` stripped + version ldflags
`build-linux`	GOOS=linux GOARCH=amd64
`build-macos`	GOOS=darwin GOARCH=arm64
`build-windows`	GOOS=windows
`build-all`	All platforms
`release`	`./scripts/release.sh`
`test`	`go test -v ./...`
`clean`	Remove `bin/`
`deps`	`go mod download && go mod tidy`
`watch`	Auto-restart with `entr`

Build variables:

CGO_ENABLED=0 — static binaries
VERSION — from git describe or "dev"
LDFLAGS — -s -w -X main.Version=$(VERSION)

Release

./scripts/release.sh
# Creates: releases/<version>/ with archives and SHA256SUMS.txt

Migrations

SQL migrations in migrations/ (25 files). Applied automatically on startup.

Manual run: go run ./cmd/pfs -migrate

Before any migration or DB repair:

make backup-db

Backup helper:

go run ./cmd/dbbackup
# optional:
go run ./cmd/dbbackup --config /path/to/config.yaml --out-dir /path/to/backups

Default output path:

<PriceForge state dir>/backups/

Example on macOS:

~/Library/Application Support/PriceForge/backups/

Migration runner: internal/models/sql_migrations.go

macOS Gatekeeper

After downloading the binary:

xattr -d com.apple.quarantine /path/to/pfs-darwin-arm64

Requirements

Go 1.22+
MariaDB / MySQL (working database, e.g. RFQ_LOG)

2.9 KiB Raw Blame History