From 40c8be5a57f577d59ff4b8e9919699db136b0bbd Mon Sep 17 00:00:00 2001
From: code <code@4lt.ca>
Date: Wed, 15 Jul 2026 02:39:22 +0000
Subject: [PATCH] refactor: rewrite paisa_dev to match template conventions

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 paisa_dev/README.md          | 64 +++++++++++++++++++++++++++++++++---
 paisa_dev/compose.yaml       | 19 +++++++++++
 paisa_dev/docker-compose.yml |  6 ----
 paisa_dev/sample.env         |  7 ++--
 4 files changed, 82 insertions(+), 14 deletions(-)
 create mode 100644 paisa_dev/compose.yaml
 delete mode 100644 paisa_dev/docker-compose.yml

diff --git a/paisa_dev/README.md b/paisa_dev/README.md
index 9e42ae6..1b8796b 100644
--- a/paisa_dev/README.md
+++ b/paisa_dev/README.md
@@ -2,7 +2,63 @@
 
 ## Overview
 
-Docker Hub: https://hub.docker.com/r/ananthakumaran/paisa
-Project: https://paisa.fyi/
-Github: https://github.com/ananthakumaran/paisa
-Proxy Port: 7500
+Paisa is a self-hosted personal finance manager built on top of the
+plain-text `ledger` accounting format, with a web UI for dashboards,
+budgets, and transaction management.
+
+## Project Details
+
+-   **Project Repository:** [github.com/ananthakumaran/paisa](https://github.com/ananthakumaran/paisa)
+-   **Container Image:** [Docker Hub](https://hub.docker.com/r/ananthakumaran/paisa)
+-   **Documentation:** [paisa.fyi](https://paisa.fyi/)
+-   **Reverse Proxy Port:** `7500`
+
+## Getting Started
+
+1. Start the container: `docker compose up -d`
+2. Open http://localhost:7500 in your browser
+3. Configure your ledger journal and accounts via the web UI
+
+## Environment Variable Notes
+
+    PAISA_IMAGE – container image (default ananthakumaran/paisa:latest)
+    PAISA_RESTART – restart policy (default unless-stopped)
+    VOL_PATH – host base path for volumes (default /data)
+    PAISA_PORT – host port for the web UI (default 7500)
+
+## Volume Notes
+
+-   `/root/Documents/paisa` — ledger journal, config, and database;
+    stored at `${VOL_PATH:-/data}/paisa` on the host
+
+## Network Notes
+
+Requires proxy network
+
+## Docker Run
+
+```bash
+docker run -d \
+  --name=paisa \
+  -p 7500:7500 \
+  -v /data/paisa:/root/Documents/paisa \
+  ananthakumaran/paisa:latest
+```
+
+## Additional Notes / Gotchas
+
+-   This is a `_dev` stack — experimental, not yet production-ready.
+-   The container runs as root and stores everything under
+    `/root/Documents/paisa`; back up that directory to preserve your
+    ledger data.
+
+## Dockhand Stack, Deploy from Git
+
+-   Cookbooks Repository
+-   stackname: paisa_dev
+-   Compose file path: paisa_dev/compose.yaml
+-   Additional env file (optional): paisa_dev/sample.env
+
+Then "Load" paisa_dev/sample.env into the Environment variables in dockhand.
+
+Create the Stack
diff --git a/paisa_dev/compose.yaml b/paisa_dev/compose.yaml
new file mode 100644
index 0000000..2cc983a
--- /dev/null
+++ b/paisa_dev/compose.yaml
@@ -0,0 +1,19 @@
+# Paisa Personal Finance Manager
+
+services:
+  paisa:
+    image: ${PAISA_IMAGE:-ananthakumaran/paisa:latest}
+    restart: ${PAISA_RESTART:-unless-stopped}
+
+    volumes:
+      - ${VOL_PATH:-/data}/paisa:/root/Documents/paisa
+
+    ports:
+      - "${PAISA_PORT:-7500}:7500"
+
+    networks:
+      - proxy
+
+networks:
+  proxy:
+    external: true
diff --git a/paisa_dev/docker-compose.yml b/paisa_dev/docker-compose.yml
deleted file mode 100644
index 53269c0..0000000
--- a/paisa_dev/docker-compose.yml
+++ /dev/null
@@ -1,6 +0,0 @@
-services:
-  paisa:
-    image: ${PAISA_IMAGE:-ananthakumaran/paisa:latest}
-    restart: unless-stopped
-    volumes:
-      - ${VOL_PATH:-./data}/paisa:/root/Documents/paisa/
diff --git a/paisa_dev/sample.env b/paisa_dev/sample.env
index 1e687a6..95fa2bc 100644
--- a/paisa_dev/sample.env
+++ b/paisa_dev/sample.env
@@ -1,5 +1,4 @@
-COOKBOOK=/git/docker-compose-cookbooks #HELP: cookbooks
-VOL_PATH=./data/ #HELP: volpath
-
-# Paisa
 PAISA_IMAGE=ananthakumaran/paisa:latest
+PAISA_RESTART=unless-stopped
+VOL_PATH=/data
+PAISA_PORT=7500