karung-web-admin/README.md

karung-web-admin

Admin dashboard that aggregates KTC (tuang) and KPC (masuk) counter data and exposes a single combined API.

Sources

Role	Project	Typical port	Cameras
Tuang	zenai-ktc-python	9000	K1 - Use, K2 - Use, ...
Masuk	zenai-kpc-python	7000	K1 - In, K1 - Out, K2 - In, K2 - Out, ...

Host IPs are not hardcoded. Configure them per machine in sources.env.

Multiple hosts per role (comma-separated) are labeled by env order. Tuang combines each host's left/right counts into K{n} - Use; masuk keeps K{n} - In and K{n} - Out.

Install path

Deploy code to /opt/karung-web-admin (matches the systemd units below).

Configure source hosts (required)

cd /opt/karung-web-admin
cp sources.env.example sources.env
nano sources.env   # set real KTC/KPC URLs for this site

Example sources.env:

KTC_BASE_URL=http://10.0.0.11:9000,http://10.0.0.12:9000
KPC_BASE_URL=http://10.0.0.11:7000,http://10.0.0.12:7000
SOURCE_HISTORY_DAYS=30
SOURCE_PULL_INTERVAL_SECONDS=30

After editing:

sudo systemctl restart karung-web-admin-pull-sources.service

sources.env is gitignored so each production host keeps its own IPs.

Puller (systemd service)

sudo cp karung-web-admin-pull-sources.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now karung-web-admin-pull-sources.service

It loads /opt/karung-web-admin/sources.env, runs pull_sources.py --loop, and refreshes every SOURCE_PULL_INTERVAL_SECONDS (default 30).

Writes:

• Live JSON: karung_tuang.json, karung_masuk.json
• History SQLite: karung_tuang.db, karung_masuk.db
• Status: .pull_status.json

One-shot (optional / debugging):

python pull_sources.py

Web app

python app.py

Or enable the dashboard service:

sudo cp karung-web-admin.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now karung-web-admin.service

If you previously used frigate-counter_karung-web-admin.service, disable/remove it:

sudo systemctl disable --now frigate-counter_karung-web-admin.service
sudo rm /etc/systemd/system/frigate-counter_karung-web-admin.service
sudo systemctl daemon-reload

Dashboard: http://0.0.0.0:8090/
Combined API: GET /api/k1/combined?history_days=30

Environment

Configured in sources.env (see sources.env.example):

Variable	Description
KTC_BASE_URL	Comma-separated tuang/KTC base URLs (summed)
KPC_BASE_URL	Comma-separated masuk/KPC base URLs (summed)
SOURCE_HISTORY_DAYS	History window to pull (default 30)
SOURCE_PULL_INTERVAL_SECONDS	Pull loop interval (default 30)
KARUNG_TUANG_JSON	Live tuang JSON path (default karung_tuang.json)
KARUNG_MASUK_JSON	Live masuk JSON path (default karung_masuk.json)
KARUNG_TUANG_DB	Tuang history DB path (default karung_tuang.db)
KARUNG_MASUK_DB	Masuk history DB path (default karung_masuk.db)