Skip to content

Commit d469a14

Browse files
committed
docs(adr): ADR-010 — reframe address-book value for external readers (drop monetization framing)
1 parent 8ccd3ba commit d469a14

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

docs/ADR-010-branches-as-entities.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,12 +51,12 @@ Walking the feature through from the driver's seat, the string→entity fix serv
5151
user-facing surfaces. All four read from one `branches` table; **this ADR builds the table and
5252
the address book**, and sets direction for the rest (ADR-011). In rising order of ambition:
5353

54-
- **The address book — the foundation, and the part that earns the $5.** Before any routing, a
55-
hunter wants a searchable, mappable notebook of *their* branches: phone, hours, whether it
56-
charges a coin fee, its box-order limit, which denominations it stocks, and — the single most
57-
valuable field — teller notes ("ask for Diane, Tuesdays"). Most of the CRH community would
58-
pay-what-you-want for this alone. The optimizer is garnish; this is the meal, and it is
59-
literally the columns in Decision (a).
54+
- **The address book — the everyday foundation.** Before any routing, a hunter wants a
55+
searchable, mappable notebook of *their* branches: phone, hours, whether it charges a coin
56+
fee, its box-order limit, which denominations it stocks, and — the single most valuable
57+
field — teller notes ("ask for Diane, Tuesdays"). For most hunters this notebook is the whole
58+
point of the app; routing is a bonus layered on top. It is literally the columns in
59+
Decision (a).
6060

6161
- **Nearby — opportunistic.** "I'll already be in that area; what's worth a five-minute
6262
detour?" Drop a pin (or use current location), get branches by distance with a CRH overlay:
@@ -182,7 +182,8 @@ It answers the questions a hunter actually has before any route exists — *who
182182
(`denoms`), *who charges a fee* (`coin_fee_usd`), *how many will they order and how far ahead*
183183
(`box_limit`/`box_lead_days`), *who's the teller* (`notes`). Alias-backed dedup (Decision (b))
184184
is what makes it trustworthy; a merge UI (list, pick survivor, repoint) is part of this slice,
185-
not a follow-up. Don't let the solver eclipse this — it is the meal.
185+
not a follow-up. Don't let the solver eclipse it — for most hunters this is the surface they
186+
open every day.
186187

187188
### What a planned run must respect (and a pin-map ignores)
188189

@@ -289,7 +290,7 @@ first is the cheap, independently valuable slice: it fixes the `byBank` grouping
289290
## Consequences
290291

291292
- **+** The address book — the highest value-per-effort slice — serves every hunter with zero
292-
routing built, and ships in this ADR alone. It is likely what earns the pay-what-you-want.
293+
routing built, and ships in this ADR alone. For many, it's reason enough to use the app.
293294
- **+** The headline "which banks pay off" table and `branch_count` stop forking on typos —
294295
the bug is fixed by the migration, before any routing exists.
295296
- **+** Pickup/dropoff eligibility becomes data (`buys`/`dumps`) instead of a fixture constant.

0 commit comments

Comments
 (0)