Docs for the phone plan: tabs table, decisions, plan deleted

README's tabs table now matches two tabs and the settings cog, and
mentions the read page, votes, and the Fetch/Summarise buttons.
docs/decisions.md gets a new "The phone" section recording each
decision the mobile plan made, confirmed against the merged code.
docs/mobile-plan.md is deleted per its own package C.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
WolfandClaude Fable 5.1 committed 2026-09-25 22:10:25 +02:00
1 parent bf8f6885a5
commit da1a62577a
3 files changed
+42 -159

No files matched your search

+16 -8
View File
@@ -13,11 +13,11 @@ uv run app job pull # read every board and search, then extract, embe
uv run app serve # http://127.0.0.1:8790
```
`uv run app worker` drains the queue without the web app, and `uv run pytest` runs the app's tests and the copied modules' own. `config.yaml` is the committed default, with three starter agents and four Copenhagen searches on Jobindex; `config.example.yaml` documents every key.
`uv run app worker` drains the queue without the web app, and `uv run pytest` runs the app's tests and the copied modules' own. `config.yaml` is the committed default, with one starter agent and four Copenhagen searches on Jobindex; `config.example.yaml` documents every key, including the `summarise:` block below.
## Searches and companies
The Sources tab does all of this; the same actions exist on the command line:
The Searches and Companies sub-tabs do all of this; the same actions exist on the command line:
```bash
uv run app searches add jobindex "Copenhagen golang" --q "golang go-udvikler" --area 1
@@ -30,18 +30,26 @@ A Jobindex query is its own syntax: words are OR, `"a b"` is a phrase, `+word` i
## The tabs
Two tabs, and a cog for settings.
| | |
|---|---|
| **Roles** | open roles, newest or ordered by one agent's score, with filters, a Save button and each company's affinity |
| **Roles** | open roles, newest or by Best match, with filters, votes (▲ like ● neither way ▼ pass) and a Save button. A title opens the role's own read page |
| **Applications** | the saved roles and their status, each change recorded as an event |
| **Agents** | the search agents: intent, require and prefer gates, weights. Saving one rescores it |
| **Companies** | every company whose board is read, its open roles, and its affinity: mute, neutral, like, favourite |
| **Sources** | what a pull reads: saved searches (try, save, edit, remove), company boards (follow one, switch any on or off), and a prune of boards by region, with the countries each one's roles are in |
| **Jobs** | a button per job (`pull`, `extract`, `embed`, `score`) and what is running |
| **Schedules** | `pull` every 6h by default, editable in place |
The cog opens `/settings`, one shell with six sub-tabs:
| | |
|---|---|
| **Ranking** | the one search agent the UI edits: intent, weights, and require/prefer gates behind an Advanced disclosure. Saving rescores it |
| **Searches** | saved searches that find roles across companies (try, save, edit, remove) |
| **Companies** | every company whose board is read, its open roles, and its affinity: hidden, neutral, liked, favourite; following a company and pruning boards by region live here too |
| **Pulls** | a Pull now button and what is running, the pull schedule, and the extract/embed/score buttons behind a disclosure |
| **Messages** | everything the server said that nobody has cleared |
| **Account** | the password, sessions and passkeys. Open on loopback, locked on anything else |
A role's read page, `/roles/{uid}`, shows the full posting: the same vote and Save controls, the company's own affinity, and the summary when there is one. A search role's posting is a teaser; its page offers a Fetch button that scrapes the original listing once and stores the text. A Summarise button asks for a short summary of that one role; `config.yaml`'s `summarise:` block turns summarising on for the pull itself, bounded to the top `per_agent` roles of each agent so the cost stays flat.
## Docs
- [`docs/decisions.md`](docs/decisions.md): what was decided for roledesk and why.