Initial commit

docs/POCKETBASE_SETUP.md

@@ -0,0 +1,72 @@
+# PocketBase Setup
+
+## 1. Download & run PocketBase
+
+Download the binary for your OS from https://pocketbase.io/docs/ and run it:
+
+```bash
+./pocketbase serve
+# Admin UI: http://127.0.0.1:8090/_/
+```
+
+Create your admin account on first launch via the Admin UI.
+
+---
+
+## 2. Create the `economy_users` collection
+
+In the Admin UI → **Collections** → **New collection** → name it exactly `economy_users`.
+
+Add the following fields:
+
+| Field name        | Type      | Required | Default |
+|-------------------|-----------|----------|---------|
+| `user_id`         | Text      | ✅       | -       |
+| `balance`         | Number    |          | `0`     |
+| `exp`             | Number    |          | `0`     |
+| `daily_streak`    | Number    |          | `0`     |
+| `last_daily`      | Text      |          | -       |
+| `last_work`       | Text      |          | -       |
+| `last_beg`        | Text      |          | -       |
+| `last_crime`      | Text      |          | -       |
+| `last_rob`        | Text      |          | -       |
+| `last_streak_date`| Text      |          | -       |
+| `jailed_until`    | Text      |          | -       |
+| `items`           | JSON      |          | `[]`    |
+| `item_uses`       | JSON      |          | `{}`    |
+| `reminders`       | JSON      |          | `[]`    |
+| `eco_banned`      | Bool      |          | `false` |
+
+> **Tip:** Set `user_id` as a unique index under **Indexes** tab.
+
+Set **API rules** (all four: list, view, create, update) to admin-only (leave blank / locked).
+
+---
+
+## 3. Configure .env
+
+Add to your `.env`:
+
+```
+PB_URL=http://127.0.0.1:8090
+PB_ADMIN_EMAIL=your-admin@email.com
+PB_ADMIN_PASSWORD=your-admin-password
+```
+
+---
+
+## 4. Migrate existing data (one-time)
+
+If you have existing data in `data/economy.json`, run the migration script **once** before starting the bot:
+
+```bash
+python migrate_to_pb.py
+```
+
+---
+
+## 5. Production
+
+On a server, run PocketBase as a background service (systemd, Docker, etc.) and update `PB_URL` in `.env` to the server's address.
+
+PocketBase stores all data in `pb_data/` - back this directory up regularly.