refactor: rewrite paisa_dev to match template conventions

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

paisa_dev/README.md

@@ -2,7 +2,63 @@
 
 ## Overview
 
-Docker Hub: https://hub.docker.com/r/ananthakumaran/paisa
+Paisa is a self-hosted personal finance manager built on top of the
-Project: https://paisa.fyi/
+plain-text `ledger` accounting format, with a web UI for dashboards,
-Github: https://github.com/ananthakumaran/paisa
+budgets, and transaction management.
-Proxy Port: 7500
+
+## 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

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

paisa_dev/docker-compose.yml

@@ -1,6 +0,0 @@
-services:
-  paisa:
-    image: ${PAISA_IMAGE:-ananthakumaran/paisa:latest}
-    restart: unless-stopped
-    volumes:
-      - ${VOL_PATH:-./data}/paisa:/root/Documents/paisa/

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