Betankungen

Stand: 2026-05-06

CLI-first fuel tracking and full-tank cycle statistics tool for local SQLite data, built with Free Pascal as a Linux CLI application. English entry path for first-time visitors: docs/README_EN.md. The public GitHub Wiki is the lighter browsing layer. Detailed repository docs under docs/ stay German-first and remain the technical source of truth. The curated project chronicle lives in docs/DEV_DIARY.md; it stays visible from the entry layer, but it remains secondary to release facts and sprint traceability.

What Betankungen Does

• Capture fuel-ups interactively in a local SQLite database.
• Review per-car history in compact and detail views.
• Evaluate full-tank cycles in text, JSON, CSV, monthly, and yearly views.
• Inspect fleet and cost snapshots without moving data into a server workflow.

Start Here

If you are new to the repository, use this path first:

1. English docs entry
2. GitHub Wiki
3. Getting Started
4. CLI Quick Reference
5. Stable release 1.4.0

The English docs entry is the primary repo entry; the GitHub Wiki is the lighter public layer. Use the main project documentation in docs/README.md when you need the deeper repository overview. Repository docs under docs/ remain the technical source of truth. Stable release handoff lives on GitHub Releases; if a release does not ship binary assets, the release notes point to the expected source-build path.

Quick Start

make build
./bin/Betankungen
./bin/Betankungen --add stations
./bin/Betankungen --add fuelups
./bin/Betankungen --list fuelups --detail
./bin/Betankungen --stats fuelups

On a fresh local setup, running ./bin/Betankungen without arguments creates the config and SQLite database if needed and points to the next sensible step. A new database starts with the default car Hauptauto (ID 1), so you only need to add a station before the first fuel-up flow.

Typical Use Cases

• Keep a local fuel log per car.
• Review full-tank cycle efficiency and cost trends.
• Inspect recent fuel-ups in a detail view.
• Export or script statistics through JSON/CSV-friendly CLI paths.

Current State

• Latest stable release: 1.4.0 (released on 2026-04-15)
• Public GitHub release handoff for the stable line is published on GitHub Releases for tag 1.4.0
• Stable release consumption: the current public handoff for 1.4.0 uses source-build guidance via make build; binary assets are only expected when a release explicitly ships them
• Technical runtime state: APP_VERSION=1.5.0-dev
• Active repository line: 1.5.0-dev is active as a dedicated Gate-1 dev-start block for the planned BL-0034 product line
• 1.4.0 remains the latest stable release, while the active repository line now prepares the next focused TUI form cycle
• Release closeout record for the stable line: docs/ROADMAP_1_4_0.md, docs/RELEASE_1_4_0_PREFLIGHT.md
• The 1.5.0-dev line was activated explicitly as a separate scope-start block; BL-0034 itself is not implemented yet and BL-0032 stays out of scope
• Active roadmap for the dev line: docs/ROADMAP_1_5_0.md
• tests/smoke/smoke_cli.sh exercises btkgit through a local bare remote with a real main ref and a fresh clone instead of overriding Git signing policy
• Security features stay mandatory even in test and fixture paths; blockers must be documented instead of bypassed
• Roadmap, gate history, and planning detail: docs/STATUS.md, docs/CHANGELOG.md, docs/SPRINTS.md

Documentation

• English docs entry
• Published GitHub Wiki (recommended public entry)
• Main project documentation (German)
• English architecture summary
• Contribution guide
• Code of conduct
• Security reporting policy
• Versioned wiki source pages
• Project status and roadmap
• Dev Diary
• 1.4.0 roadmap and gates
• 1.4.0 release preflight
• Architecture
• Backlog index
• ADR index
• Changelog

Language Note

Most detailed documentation is currently written in German. GitHub issues, pull requests, and reviews should be written in English.

License

This project is licensed under the Apache License 2.0. See LICENSE.

Contributing

Contribution policy and workflow notes: CONTRIBUTING.md. Community standards: CODE_OF_CONDUCT.md, SECURITY.md, .github/ISSUE_TEMPLATE/, .github/pull_request_template.md.