Erich Blume b8104d75ad Move zk cards to docs/zk/ for documentation restructuring (#84 )

## Summary
- Move all existing zettelkasten cards from `docs/` to `docs/zk/` as a temporary holding area
- Update `zk-docs` mise task to look in the new location
- Add `docs/README.md` explaining the Diataxis-based restructuring plan and target audiences

## Context
This is phase 1 of a multi-phase documentation restructuring effort. The goal is to reorganize docs to follow the Diataxis framework while serving multiple audiences:
1. Erich (owner) - knowledge graph/zk
2. Claude/AI agents - memory and context enrichment
3. New external readers - high-level overview
4. Potential operators/contributors - onboarding
5. Replicators - people wanting to duplicate the approach

## Testing
- [x] Verified `mise run zk-docs` still works with the new path
- [x] Updated obsidian.nvim config (in ~/.config/nvim) to point to new path

## Note
The obsidian.nvim config change is outside this repo but was made as part of this work.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/84

2026-02-03 09:13:50 -08:00

3.3 KiB

Raw Blame History

aliases

TeslaMate

TeslaMate is a self-hosted Tesla data logger running in Kubernetes (minikube on indri), collecting and visualizing vehicle data from the Tesla Owner API.

Service Details

URL: https://tesla.tail8d86e.ts.net
Namespace: teslamate
Image: teslamate/teslamate:2.2.0
Database: postgresql (CloudNativePG cluster at pg.tail8d86e.ts.net)
ArgoCD app: teslamate

What TeslaMate Collects

Battery level, state of charge, range estimates
Charging sessions (location, energy, cost, duration)
Drives (distance, efficiency, routes)
Climate/HVAC usage
Software update history
Vampire drain analysis
Vehicle states (asleep, driving, charging, online)

Grafana Dashboards

18 dashboards available in Grafana under the "TeslaMate" folder at https://grafana.tail8d86e.ts.net:

Overview, Charges, Drives, Efficiency, States
Battery Health, Vampire Drain, Statistics
Charge Level, Locations, Trip, Mileage
Drive Stats, Charging Stats, Projected Range
Timeline, Updates, Visited

Dashboards use the TeslaMate PostgreSQL datasource (not Prometheus).

Useful Commands

# View logs
kubectl --context=minikube-indri -n teslamate logs -f deployment/teslamate

# Check pod status
kubectl --context=minikube-indri -n teslamate get pods

# Restart deployment
kubectl --context=minikube-indri -n teslamate rollout restart deployment/teslamate

# Sync from ArgoCD
argocd app sync teslamate

Credentials

1Password items (blumeops vault):

TeslaMate - contains db_password and api_enc_key fields

Kubernetes secrets:

teslamate-db (teslamate ns) - DATABASE_PASS for PostgreSQL connection
teslamate-encryption (teslamate ns) - ENCRYPTION_KEY for token encryption
blumeops-pg-teslamate (databases ns) - CloudNativePG managed role password
grafana-teslamate-datasource (monitoring ns) - Grafana datasource password

Backup

TeslaMate data is backed up via borgmatic:

PostgreSQL database teslamate included in borgmatic_postgresql_databases
Backed up alongside miniflux to sifaka NAS

Tesla API Authentication

TeslaMate uses Tesla's Owner API (not Fleet API) via OAuth:

Access https://tesla.tail8d86e.ts.net
Click "Sign in with Tesla"
Complete OAuth flow in browser
Tokens are encrypted with ENCRYPTION_KEY and stored in database
TeslaMate automatically refreshes tokens as needed

Standalone OAuth tool: If you need to manually obtain tokens, there's a Rust-based helper:

Mirror: https://forge.tail8d86e.ts.net/eblume/tesla_auth.git
Runs OAuth flow and outputs access/refresh tokens

Database Notes

TeslaMate requires PostgreSQL 17.3+ or 18.x
The teslamate user has superuser privileges (required for extension management during migrations)
Extensions used: cube, earthdistance (for geospatial calculations)

Log

Thu Jan 23 2026

Initial deployment to Kubernetes
18 Grafana dashboards imported from TeslaMate project
Upgraded CloudNativePG 1.25 -> 1.28 for major version upgrade support
Upgraded PostgreSQL 17.2 -> 18.1 (required for TeslaMate 2.2.0)
Tailscale Ingress at tesla.tail8d86e.ts.net
Backup configuration added to borgmatic

3.3 KiB Raw Blame History