feat(learn): a studyset's subject, picked from a fixed list (ADR 0041)

A top studyset is filed under one of 44 subjects in six groups (the
developer's decisions of 9 and 10 Nov 2026): languages as one, computing
in five, Other / not sure last. Each has a Lucide icon and a default
colour, which picking it gives the studyset, its own to change from then
on. The studyset's sheet picks it (pickSubject); a sub-studyset shows its
top studyset's (subjectOf) and offers none. The payload keeps it as
`subject` (schema 8), so archives and published studysets carry it; an
ID this version doesn't know is kept and reads as none.

Whats-New: A studyset can now be filed under a subject, which gives it that subject's colour.
Whats-New-De: Ein Lernset lässt sich jetzt einem Fach zuordnen, das ihm dessen Farbe gibt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
This commit is contained in:
Tizian 「ティツィアーン」 2026-11-10 18:37:17 +01:00
commit 9868dc27c6
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64

View file

@ -0,0 +1,98 @@
# ADR 0041: Learn's subjects: one per studyset, from a fixed list
- **Status:** decided 9 and 10 Nov 2026 by the developer: D1 to D4 and D6 are their own
choices, D5 and D7 to D9 the agent's recommendations, which they confirmed. D1 to D7
are built; D8 (the library) is next, and D10 later.
- **Builds on:** ADR 0002 (payloads and their schemas), ADR 0005 (publishing), ADR 0031
(the palette's twenty colours).
## Context
A library of a hundred studysets, most of them computing books and language courses,
shows them by title alone. Vaia files every studyset under a subject from a fixed
list, shown on its card with a stripe in the subject's colour, and lets the library be
narrowed to one.
## Decisions
- **D1.** One subject per studyset, from a fixed list of about Vaia's breadth, with
*Other / not sure* last.
- **D2.** Each subject has a Lucide icon and a default colour from the palette. Choosing
one gives the studyset that colour, which stays the studyset's to change.
- **D3.** Languages are one subject, *Languages*. The language itself comes from the
studyset's front language, which every course already gives.
- **D4.** Computing is five subjects: *Computer science*, *Software engineering*, *Data
science and AI*, *IT and operations*, *Security and privacy*. Most of the library is
computing, and a single subject would narrow nothing.
- **D5.** The subject sits on the top studyset alone, which its sub-studysets show as
theirs (`subjectOf`); their sheet offers none. It is kept in the studyset's sealed
payload as `subject`, a subject's ID (schema 8), and so goes into archives and is
published with the studyset, for Explore to filter by later.
- **D6.** The list is the agent's draft of 10 Nov 2026, taken as it is (below).
- **D7.** IDs are never renamed. An ID this app version doesn't know (a newer one's) is
kept as it is and reads as no subject until another is picked.
- **D8.** The library, as Vaia's: a dropdown of the subjects in use, cards naming the
subject under the title with a stripe in its colour, sections by recency (the last 7
days, the last month, older), the archive last.
- **D9.** Existing studysets: the agent writes a subject into each of the developer's 72
archives not yet imported; those already in the library get one by hand.
- **D10.** Explore filters by subject later; its releases don't keep the subject in a
column yet (it is in each release's repository).
## The list (D6)
ID, English and German name, Lucide icon, default colour (`Subject`, `subject.dart`).
| Group | ID | English | German | Icon | Colour |
|---|---|---|---|---|---|
| Sciences and health | `biology` | Biology | Biologie | dna | fern |
| | `chemistry` | Chemistry | Chemie | flask-conical | reef |
| | `physics` | Physics | Physik | atom | slateblue |
| | `astronomy` | Astronomy | Astronomie | telescope | enzian |
| | `earth-sciences` | Earth sciences | Geowissenschaften | mountain | sahara |
| | `environmental-science` | Environmental science | Umweltwissenschaften | leaf | forest |
| | `medicine` | Medicine | Medizin | stethoscope | cerise |
| | `nursing` | Nursing | Pflege | heart-pulse | strawberry |
| | `pharmacy` | Pharmacy | Pharmazie | pill | pink |
| | `nutrition` | Nutrition | Ernährung | apple | carrot |
| | `psychology` | Psychology | Psychologie | brain | plum |
| | `sports-science` | Sports science | Sportwissenschaft | dumbbell | copper |
| Mathematics and computing | `mathematics` | Mathematics | Mathematik | sigma | cobalt |
| | `statistics` | Statistics | Statistik | chart-column | ocean |
| | `computer-science` | Computer science | Informatik | cpu | slateblue |
| | `software-engineering` | Software engineering | Softwareentwicklung | code | enzian |
| | `data-science-ai` | Data science and AI | Data Science und KI | brain-circuit | purple |
| | `it-operations` | IT and operations | IT und Betrieb | server | pine |
| | `security-privacy` | Security and privacy | Sicherheit und Datenschutz | shield-check | forest |
| | `engineering` | Engineering | Ingenieurwesen | cog | soil |
| | `architecture` | Architecture | Architektur | building-2 | sahara |
| Society | `history` | History | Geschichte | landmark | soil |
| | `geography` | Geography | Geografie | globe | pacific |
| | `politics` | Politics | Politik | vote | cobalt |
| | `law` | Law | Recht | scale | pickle |
| | `economics` | Economics | Volkswirtschaft | trending-up | olive |
| | `business` | Business | Betriebswirtschaft | briefcase | copper |
| | `marketing` | Marketing | Marketing | megaphone | carrot |
| | `accounting-finance` | Accounting and finance | Rechnungswesen und Finanzen | calculator | pine |
| | `sociology` | Sociology | Soziologie | users | plum |
| | `anthropology` | Anthropology | Anthropologie | footprints | sahara |
| | `education` | Education | Pädagogik | school | ocean |
| | `media-studies` | Media studies | Medienwissenschaft | tv | pink |
| | `philosophy` | Philosophy | Philosophie | lightbulb | purple |
| | `religious-studies` | Religious studies | Religionswissenschaft | book-open | olive |
| Languages and arts | `languages` | Languages | Sprachen | languages | cerise |
| | `literature` | Literature | Literatur | book-marked | strawberry |
| | `linguistics` | Linguistics | Linguistik | speech | enzian |
| | `art-design` | Art and design | Kunst und Design | palette | pink |
| | `music` | Music | Musik | music | plum |
| | `theatre-film` | Theatre and film | Theater und Film | clapperboard | cerise |
| Everyday | `cooking-hospitality` | Cooking and hospitality | Kochen und Gastronomie | chef-hat | carrot |
| | `driving-licences` | Driving and licences | Führerschein und Lizenzen | car | soil |
| Other | `other` | Other / not sure | Sonstiges / unsicher | circle-question-mark | none |
## Consequences
- A studyset saved by this version is in schema 8, which older versions refuse to read,
as every schema before (ADR 0002): an archive with subjects imports from this version
on.
- Adding a subject is cheap; renaming an ID isn't (D7), so names change, IDs don't.