Plings feature flows — index
Created: Thu 25 Jun 2026 12:33:57 CEST Target Audience: Maintainers, product, Claude Code agents
A flow doc is the living, feature-named, readable truth about how a named user-facing flow works right now, with the reasoning behind it (by link). It is the current manual — the place to find, read, discuss, and build on a feature without digging through old sessions or buried specs. It links to the use-case (why users need it), to ADRs (why it works this way), and to specs (history).
Where flow docs live. Each flow doc is co-located in the repo that implements it (
<repo>/docs/flows/<flow>.md) so it is updated in the same PR as the code it describes (a living doc has the highest drift risk — seeinternal/decisions/ADR-0046). This page is the single cross-repo index. Flow docs inPlings-iOSare not yet rendered on docs.plings.io (a follow-up); open them in the repo for now.
How the layers relate: use-case = why (requirements, pre-build) · flow = how-it-works-now (this layer) · spec = how-we-built-it (point-in-time) · ADR = a decision + why · ROADMAP = what’s done/next.
Flow index
Flow docs are co-located in the repo that implements them (the repo is noted in the row when it
is not Plings-iOS/docs/flows/). Use-case status is what the use-case catch (ADR-0046) found
during the seeding sweep — ⚠️ = needs Paul’s attention.
| Flow | Doc | Use-case (why) | Key decisions |
|---|---|---|---|
| Samla — bulk capture (“inventory gun”) | samla.md |
UC-504 bulk-actions-collection · ⚠️ fleshed-from-stub, confirm intent | ADR-0021 |
| Flytta — move one object to where it is/belongs | flytta.md |
UC-303 move-between-containers (confirmed) | ADR-0048, 0005, 0044, 0043 |
| Skapa objekt — create an object | skapa-objekt.md |
mobile-batch-creation (real, mis-named) · ⚠️ no iOS-accurate use-case; create-object/object-creation are stale web-form duplicates | ADR-0037, 0003, 0013 |
| Tilldela tagg — assign/unassign a tag | tilldela-tagg.md |
tag-scanning-integration, identifier-usage-guide (both real) | ADR-0014, 0017 |
| Navigatorn — browse & organise the hierarchy | navigatorn.md |
⚠️ UC-304/UC-301/UC-303 all stubs | ADR-0005, 0020, 0039, 0044, 0045 |
| Bildhantering — object images | bildhantering.md |
image-management · ⚠️ stale (is_main vs position-0); square-image-cropping superseded |
ADR-0008, 0034, 0035, 0033 |
| Skanna — scan a tag | skanna.md |
tag-scanning-integration (real) · ⚠️ UC-401 search-object stub | ADR-0043, 0017, 0018 |
| Senast sedd — last-seen & scan history | senast-sedd.md |
lost-item-workflow, geographical-location-tracking | ADR-0036, 0027, 0024 |
Kartan — geographic view mode on the Hitta root: place pins (leaves fold in), Senast känd/Normal toggle, platsankare editing (Plings-iOS/docs/flows/) |
kartan.md |
⚠️ no use-case yet — intent to be confirmed by Paul (ADR-0046 catch) | ADR-0074, 0073, 0003, 0005, 0020, 0039, 0045 |
Class-seeded instances — register many identical objects, thin instance / rich class (Plings-API/docs/flows/) |
class-seeded-instances.md |
⚠️ no use-case yet (first impl of the user/community-class column); confirm intent | ADR-0055, 0056, 0057, 0014, 0016 |
| Administrera klasser — web admin screen: list, create, edit, and set the cover image of an org’s community classes | class-admin.md |
docs/use-cases/class-admin.md · ⚠️ use-case intent to be confirmed by Paul |
ADR-0060, 0058, 0057, 0055 |
Artikelregister — manufacturer article/SKU registry: SKU-granular article classes, crypto cp at creation, batch generation (Plings-API/docs/flows/) |
artikelregister.md |
docs/use-cases/manufacturer-article-registry.md (UC-802; intent confirmed by Paul 2026-07-02) |
ADR-0063, 0064, 0055, 0054, 0050 |
Brand Kit — public page for logos, colours, typography, font kit and guidelines (/brand) |
brand-kit.md |
docs/use-cases/brand-kit.md (UC-901; intent confirmed by Paul 2026-07-04) |
ADR-0065 |
Standardorganisation — the org the app opens in on login; Account picker + server-stored default (Plings-iOS/docs/flows/) |
default-organization.md |
docs/use-cases/configure-default-ownership.md (default-org slice built; broader ownership strategy future) |
ADR-0066, 0003, 0024, 0028 |
New flows are added here when their flow doc is created (see the use-case catch in
internal/decisions/ADR-0046 and CLAUDE.md → Documentation). The ⚠️ use-case gaps above
are tracked in the relevant repo ROADMAP Backlogs for Paul to flesh (intent is his).