Fio's transparent page now serves recent rows as DD.MM.YY while older rows stay DD.MM.YYYY. parse_czech_date only knew the 4-digit form so every recent transfer was silently dropped — make sync-2026 reported zero new transactions. Adds %d.%m.%y and %d/%m/%y to the format list, mirroring the Go-side fix from 2026-05-07. Also adds a Python analog of make go-sync-debug: - --dry-run skips header write / append / sort and prints "would …" lines - --print-fio-table prints aligned per-txn table with NEW/DUP status - make sync-debug [DAYS=N] wrapper (default DAYS=30) - always-on stderr diagnostics in fio_utils: which fetcher was chosen (with FIO_API_TOKEN-unset lag warning) + raw-vs-filtered counts, so this class of "scraper drops everything" bug surfaces immediately. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
148 lines
6.0 KiB
Makefile
148 lines
6.0 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-sync-debug go-lint capture-fixtures parity 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 go-sync-debug [DAYS=N] - Dry-run Go sync with Fio debug logs and txn table (default DAYS=30)"
|
|
@echo " make capture-fixtures - Regenerate parity fixture corpus from live Python"
|
|
@echo " make parity - Diff /api/* between web-py (:5001) and web-go (:8080); both must be running"
|
|
@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 sync-debug [DAYS=N] - Dry-run Python sync with Fio diagnostics and txn table (default DAYS=30)"
|
|
@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)
|
|
|
|
DAYS ?= 30
|
|
go-sync-debug: go-build
|
|
LOG_LEVEL=DEBUG ./$(GO_BIN) sync -dry-run -print-fio-table -days $(DAYS)
|
|
|
|
go-lint:
|
|
cd $(GO_SRC) && golangci-lint run ./...
|
|
|
|
web-go: go-build
|
|
./$(GO_BIN) server
|
|
|
|
parity:
|
|
cd $(GO_SRC) && go run ./cmd/parity $(ARGS)
|
|
|
|
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
|
|
|
|
sync-debug: $(PYTHON) ## Dry-run Python sync with Fio diagnostics and txn table (default DAYS=30)
|
|
$(PYTHON) scripts/sync_fio_to_sheets.py --credentials .secret/fuj-management-bot-credentials.json --days $(DAYS) --dry-run --print-fio-table
|
|
|
|
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
|