From 10eaccf897b1fb58faa5bdb10bffbfe30de85ced Mon Sep 17 00:00:00 2001 From: Wolf Date: Sat, 26 Sep 2026 21:04:00 +0200 Subject: [PATCH] Docs: open items after the search sources and the Sources tab Co-Authored-By: Claude Opus 5.5 --- README.md | 1 + docs/open.md | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/open.md diff --git a/README.md b/README.md index ba0841d..4214b8b 100644 --- a/README.md +++ b/README.md @@ -53,5 +53,6 @@ A role's read page, `/roles/{uid}`, shows the full posting: the same vote and Sa ## Docs - [`docs/decisions.md`](docs/decisions.md): what was decided for roledesk and why. +- [`docs/open.md`](docs/open.md): what is left to do, for whoever picks this up next. - [`desk/README.md`](desk/README.md), [`pipeline/README.md`](pipeline/README.md), [`auth/README.md`](auth/README.md), [`deploy/README.md`](deploy/README.md): the copied modules, where each comes from and how to refresh it. - [`docs/hosting.md`](docs/hosting.md), [`docs/release.md`](docs/release.md), [`docs/server.md`](docs/server.md), [`docs/password-protection.md`](docs/password-protection.md), [`docs/llm-backends.md`](docs/llm-backends.md): the boilerplate's deployment docs. diff --git a/docs/open.md b/docs/open.md new file mode 100644 index 0000000..ee88936 --- /dev/null +++ b/docs/open.md @@ -0,0 +1,19 @@ +# Open items + +What is left after the search sources and the Sources tab (commits `047f7cd`, `6b40702`). Delete an entry when it is done; delete this file when it is empty. + +## Before the first beta run + +- **The local database is not cleaned up yet.** `roledesk.db` is gitignored, so copy it into the new checkout if its history matters, or start fresh with `uv run app companies seed`. On the Sources tab, run the prune (`europe`, or `DK,SE,NO,FI,EU` for a short list). Only 35 boards have no European role, so `europe` alone still leaves about 150 mostly US employers. +- **The three new starter agents are not in the existing database.** "Copenhagen engineering", "Remote from Europe" and "Europe hybrid" in `config.yaml` import only into an empty agents table, and the old "Berlin backend" and "Remote EU stretch" are there. Add them on the Agents tab, or delete the old two before the first start of a fresh database. +- **The starter searches assume a backend/platform engineer.** Queries were taken from the old starter agents; confirm the user's actual field and adjust the searches and agent intents on the Sources and Agents tabs. + +## Known gaps + +- **Adzuna has not run live.** Built against its documented response; needs `ADZUNA_APP_ID` and `ADZUNA_APP_KEY` from developer.adzuna.com. Check the parser against a real response on first use. +- **No company discovery from search results.** A Jobindex item links to Jobindex's own page; its `/c?t=` redirect leads to the employer's site or ATS, but following it per role counts as a click in Jobindex's statistics. A cleaner route to "this search found a company, follow its board" is still open. +- **Jobnet and Jooble are left out.** Jobnet's search endpoint answers 401 outside its own site's session; Jooble needs a manual key application and answered a Cloudflare challenge. See `docs/decisions.md`. +- **About 10% of roles have no country.** Location lines such as "Remote", "Hybrid" or "North America" name none, so country gates drop them. `extract` or a longer `_PLACES` table in `app/models.py` would fill more. +- **`extract` is off.** Seniority, permit and languages stay empty, so gates on them match nothing. Turning it on is a Haiku call per batch of 20 roles. +- **Some Jobindex ads have no company.** A crawled ad with no logo and no ", Company" suffix in its title stores an empty company. +- **Sources tab race.** A Save that is still reloading the list can overwrite an on/off switch made during the reload in the page's copy (not in the database). Reloading the page shows the true state.