From c898d9d6a988f929b66cc3219948c6cd756988ab Mon Sep 17 00:00:00 2001
From: Joe Carstairs <me@joeac.net>
Date: Sat, 26 Jul 2025 23:38:24 +0100
Subject: complete task-028

---
 requirements/data_models/dml-bucket.md | 21 +++++++++++++--------
 requirements/kanban.md                 |  1 -
 requirements/tasks/epic-003.md         |  2 +-
 requirements/tasks/task-028.md         | 26 +++++++++++++++-----------
 4 files changed, 29 insertions(+), 21 deletions(-)

diff --git a/requirements/data_models/dml-bucket.md b/requirements/data_models/dml-bucket.md
index dc7749b..01c56b5 100644
--- a/requirements/data_models/dml-bucket.md
+++ b/requirements/data_models/dml-bucket.md
@@ -2,20 +2,25 @@
 
 A bucket represents a real category of spending, like beer or holidays.
 
-| Field             | Type   | Description                                               |
-| ----------------- | ------ | --------------------------------------------------------- |
-| id                | string | A unique identifier for the bucket.                       |
-| name              | string | A short description of the real category of spending.     |
-| balance           | number | The amount of money the user intends to be free to spend. |
-| balance_cache_key | string | A cache key for the balance. See notes.                   |
+| Field             | Type    | Description                                               |
+| ----------------- | ------- | --------------------------------------------------------- |
+| id                | string  | A unique identifier for the bucket.                       |
+| name              | string  | A short description of the real category of spending.     |
+| balance           | number  | The amount of money the user intends to be free to spend. |
+| balance_cache_key | string  | A cache key for the balance. See notes.                   |
+| is_hidden         | boolean | Whether this bucket should be hidden in the UI.           |
 
 Constraints:
 
 - `name` must be unique.
-- `id` must be equal to `name`, that is, `id` is an alias of the property, `name`.
+- `id` must be equal to `name`, that is, `id` is an alias of the property,
+  `name`.
+- `is_hidden` should never be true when `balance` is non-zero.
 
 Notes:
 
 - `balance_cache_key` must be of the format: `<drip_id>:<transaction_id>`.
+- `is_hidden` is used as an equivalent of soft-deletion. Buckets should never be
+  actually deleted.
 
-Sources: req-027, req-098, req-110, req-111
+Sources: req-027, req-098, req-110, req-111, task-028
diff --git a/requirements/kanban.md b/requirements/kanban.md
index 80eff85..3ed8702 100644
--- a/requirements/kanban.md
+++ b/requirements/kanban.md
@@ -4,7 +4,6 @@
 | -------- | -------- | -------- |
 |          |          | epic-003 |
 | ======== | ======== | ======== |
-|          | task-028 |          |
 |          | task-060 |          |
 | ======== | ======== | ======== |
 | epic-000 |          |          |
diff --git a/requirements/tasks/epic-003.md b/requirements/tasks/epic-003.md
index 5ba88e1..3dbda50 100644
--- a/requirements/tasks/epic-003.md
+++ b/requirements/tasks/epic-003.md
@@ -8,5 +8,5 @@ For this Epic, the project should be ready to start work.
 - [x] task-041 (requirements)
 - [x] task-063 (add extensions to processes)
 - [x] task-059 (CRUD matrix)
-- [ ] task-028 (UI designs)
+- [x] task-028 (UI designs)
 - [ ] task-060 (refine epic-000)
diff --git a/requirements/tasks/task-028.md b/requirements/tasks/task-028.md
index f007ddb..80468db 100644
--- a/requirements/tasks/task-028.md
+++ b/requirements/tasks/task-028.md
@@ -2,6 +2,8 @@
 
 There should be UI designs for the desktop GUI.
 
+Status: done
+
 Sources: task-001, task-029, task-030, task-058, task-061, task-064
 
 Epic: epic-003
@@ -10,14 +12,16 @@ Epic: epic-003
 
 The designs should include interfaces for:
 
-- [ ] Viewing pipes
-- [ ] Creating pipes including their associations with buckets
-- [ ] Viewing buckets
-- [ ] Creating buckets
-- [ ] Updating buckets
-- [ ] Deleting buckets
-- [ ] Inserting transactions
-- [ ] Deleting transactions
-- [ ] Viewing the long-term expected monthly tank change
-- [ ] Viewing the tank balance
-- [ ] Viewing historic pipes, drips and transactions for a bucket
+- [x] Viewing pipes
+- [x] Creating pipes including their associations with buckets
+- [x] Viewing buckets
+- [x] Creating buckets
+- [x] Updating buckets
+- [x] Deleting buckets
+- [x] Inserting transactions
+- [x] Deleting transactions
+- [x] Viewing the long-term expected monthly tank change
+- [x] Viewing the tank balance
+- [x] Viewing historic pipes, drips and transactions for a bucket
+
+Added: ui-designs/desktop-views
-- 
cgit v1.2.3