Jan Novak
67d2f11d7c
All checks were successful
Deploy to K8s / deploy (push) Successful in 7s
Closes M3.1–M3.6. Parity safety net proving Go output matches Python
for every ported pure-domain function (M2.1–M2.9) and reconcile (M2.10).
Capture pipeline:
- scripts/capture_fixtures.py: calls each Python function with seeded
inputs, emits JSON fixtures to stdout (never writes files directly).
- scripts/scrub_fixtures.py: deterministic PII scrubber — SHA-256
pseudonyms for member names, digit-preserving hashes for VS/account/
bank_id, name-sweep in message text. Idempotent; no salt.
- scripts/_fixture_seeds.py: handcrafted seeds for all 11 functions;
synthetic names throughout (no real roster members).
- scripts/capture_all_fixtures.sh: convenience wrapper for full corpus
regeneration outside of make.
Fixture corpus (98 files, all PII-free):
- go/tests/fixtures/pure/<func>/<case>.json — 10 function directories.
- go/tests/fixtures/reconcile/<NN>_<case>.json — 10 branch-coverage
cases: greedy, overpayment credit, proportional remainder, even-split,
out-of-window, exception override, other: purpose, junior ?, multi-
person+month fan-out, unmatched.
Go parity tests (//go:build parity):
- go/tests/parity/parityio.go: generic LoadDir/RunAll helpers + typed
In/Out struct pairs for all 10 pure functions; Envelope decoder for
int/float/none disambiguation.
- 10 pure-function test packages + bespoke reconcile test with per-cell
float tolerance (math.Abs <= 0.01 for `paid` values).
Makefile: go-parity, go-test-all, capture-fixtures targets.
go/tests/fixtures/README.md: refresh workflow + PII audit guide.
Gate: make go-test green, make go-parity green (11/11 packages),
make go-lint clean (parity tag), make go-build clean.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
135 lines
5.2 KiB
Makefile
135 lines
5.2 KiB
Makefile
.PHONY: help fees match web web-py web-debug web-go go-build go-test go-test-all go-parity go-run go-lint capture-fixtures image run sync sync-2026 test test-v docs
|
|
|
|
export PYTHONPATH := scripts:$(PYTHONPATH)
|
|
VENV := .venv
|
|
PYTHON := $(VENV)/bin/python3
|
|
CREDENTIALS := .secret/fuj-management-bot-credentials.json
|
|
|
|
GO_SRC := go
|
|
GO_BIN := bin/fuj
|
|
|
|
$(PYTHON): .venv/.last_sync
|
|
|
|
.venv/.last_sync: pyproject.toml
|
|
uv sync
|
|
touch .venv/.last_sync
|
|
|
|
help:
|
|
@echo "Available targets:"
|
|
@echo " make fees - Calculate monthly fees from the attendance sheet"
|
|
@echo " make match - Match Fio bank payments against expected attendance fees"
|
|
@echo " make web - Start Python dashboard (alias for web-py, until M8)"
|
|
@echo " make web-py - Start Python dashboard on :5001"
|
|
@echo " make web-go - Build and start Go dashboard on :8080"
|
|
@echo " make web-debug - Start Python dashboard in debug mode"
|
|
@echo " make go-build - Build Go binary to bin/fuj"
|
|
@echo " make go-test - Run Go unit tests"
|
|
@echo " make go-parity - Run Go parity tests (requires -tags=parity fixture corpus)"
|
|
@echo " make go-test-all - Run both unit and parity tests"
|
|
@echo " make go-lint - Run golangci-lint on Go code"
|
|
@echo " make capture-fixtures - Regenerate parity fixture corpus from live Python"
|
|
@echo " make image - Build Python OCI container image"
|
|
@echo " make run - Run the built Python Docker image locally"
|
|
@echo " make sync - Sync Fio transactions to Google Sheets"
|
|
@echo " make sync-2025 - Sync Fio transactions for Q4 2025 (Oct-Dec)"
|
|
@echo " make sync-2026 - Sync Fio transactions for the whole year of 2026"
|
|
@echo " make infer - Infer payment details (Person, Purpose, Amount) in the sheet"
|
|
@echo " make reconcile - Show balance report using Google Sheets data"
|
|
@echo " make venv - Sync virtual environment with pyproject.toml"
|
|
@echo " make test - Run Python web application infrastructure tests"
|
|
@echo " make test-v - Run Python tests with verbose output"
|
|
@echo " make docs - Serve documentation in a browser"
|
|
|
|
venv:
|
|
uv sync
|
|
|
|
fees: $(PYTHON)
|
|
$(PYTHON) scripts/calculate_fees.py
|
|
|
|
match: $(PYTHON)
|
|
$(PYTHON) scripts/match_payments.py
|
|
|
|
web: web-py
|
|
|
|
web-py: $(PYTHON)
|
|
$(PYTHON) app.py
|
|
|
|
web-debug: $(PYTHON)
|
|
FLASK_DEBUG=1 $(PYTHON) app.py
|
|
|
|
go-build:
|
|
cd $(GO_SRC) && go build -trimpath \
|
|
-ldflags "-X main.version=$$(git describe --tags --always 2>/dev/null || echo dev) \
|
|
-X main.commit=$$(git rev-parse --short HEAD) \
|
|
-X main.buildDate=$$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
|
|
-o ../$(GO_BIN) ./cmd/fuj
|
|
|
|
go-test:
|
|
cd $(GO_SRC) && go test -race ./...
|
|
|
|
go-parity:
|
|
cd $(GO_SRC) && go test -tags=parity ./tests/parity/...
|
|
|
|
go-test-all: go-test go-parity
|
|
|
|
capture-fixtures: $(PYTHON)
|
|
@echo "Capturing and scrubbing fixtures for all registered functions..."
|
|
@for func in normalize parse_month_references calculate_fee calculate_junior_fee \
|
|
parse_czk_amount generate_sync_id build_name_variants match_members \
|
|
infer_transaction_details format_date reconcile; do \
|
|
dir="go/tests/fixtures/$$([[ $$func == reconcile ]] && echo reconcile || echo pure/$$func)"; \
|
|
mkdir -p "$$dir"; \
|
|
PYTHONPATH=scripts:. $(PYTHON) scripts/capture_fixtures.py --func $$func --all \
|
|
| while IFS= read -r line; do \
|
|
case_id=$$(echo "$$line" | $(PYTHON) -c "import sys,json; print(json.load(sys.stdin)['case'])"); \
|
|
echo "$$line" | $(PYTHON) scripts/scrub_fixtures.py > "$$dir/$${case_id}.json"; \
|
|
done; \
|
|
echo " $$func done"; \
|
|
done
|
|
@echo "capture-fixtures complete."
|
|
|
|
go-run: go-build
|
|
./$(GO_BIN) $(ARGS)
|
|
|
|
go-lint:
|
|
cd $(GO_SRC) && golangci-lint run ./...
|
|
|
|
web-go: go-build
|
|
./$(GO_BIN) server
|
|
|
|
image:
|
|
docker build -t fuj-management:latest \
|
|
--build-arg GIT_TAG=$$(git describe --tags --always 2>/dev/null || echo "untagged") \
|
|
--build-arg GIT_COMMIT=$$(git rev-parse --short HEAD) \
|
|
--build-arg BUILD_DATE=$$(date -u +%Y-%m-%dT%H:%M:%SZ) \
|
|
-f build/Dockerfile .
|
|
|
|
run:
|
|
docker run -it --rm -p 5001:5001 -v $(CURDIR)/.secret:/app/.secret:ro fuj-management:latest
|
|
|
|
sync: $(PYTHON)
|
|
$(PYTHON) scripts/sync_fio_to_sheets.py --credentials .secret/fuj-management-bot-credentials.json
|
|
|
|
sync-2025: $(PYTHON)
|
|
$(PYTHON) scripts/sync_fio_to_sheets.py --credentials .secret/fuj-management-bot-credentials.json --from 2025-10-01 --to 2025-12-31 --sort-by-date
|
|
|
|
sync-2026: $(PYTHON)
|
|
$(PYTHON) scripts/sync_fio_to_sheets.py --credentials .secret/fuj-management-bot-credentials.json --from 2026-01-01 --to 2026-12-31 --sort-by-date
|
|
|
|
infer: $(PYTHON)
|
|
$(PYTHON) scripts/infer_payments.py --credentials $(CREDENTIALS)
|
|
|
|
reconcile: ## Match payments against attendance
|
|
export PYTHONPATH=$(PYTHONPATH):$(CURDIR)/scripts && $(PYTHON) scripts/match_payments.py --credentials $(CREDENTIALS)
|
|
|
|
test: $(PYTHON) ## Run web application tests
|
|
export PYTHONPATH=$(PYTHONPATH):$(CURDIR)/scripts:$(CURDIR) && $(PYTHON) -m unittest discover tests
|
|
|
|
test-v: $(PYTHON) ## Run tests with verbose output
|
|
export PYTHONPATH=$(PYTHONPATH):$(CURDIR)/scripts:$(CURDIR) && $(PYTHON) -m unittest discover -v tests
|
|
|
|
docs: ## Serve documentation locally
|
|
@echo "Starting documentation server at http://localhost:8000"
|
|
@echo "Press Ctrl+C to stop."
|
|
$(PYTHON) -m http.server 8000 --directory docs
|