feat: track task scope status and version

This commit is contained in:
user
2026-07-17 18:08:24 +02:00
parent 3589eaf709
commit 586644bcff
5 changed files with 264 additions and 31 deletions
+35
View File
@@ -45,6 +45,41 @@ której powstaje `https://<url_host_uuid>/<doc_uuid>`.
`show_repository_qr: true` wymaga `repository_url`. Adres podglądu `localhost`
nie powinien być publikowany na karcie.
### Status i wersja tasków w zakresie karty
Wiersze `front_page_scope.scope_table.rows[]` mogą opisywać stan opracowania
pojedynczego tasku. JSON przechowuje stabilny angielski klucz `status`, a
renderer pokazuje jego krótką polską etykietę w HTML i PDF.
| Klucz | Etykieta | Znaczenie |
|---|---|---|
| `not-started` | brak | task nie został jeszcze opracowany |
| `draft` | robocze | istnieje niepełna wersja robocza |
| `in-progress` | w trakcie | task jest aktualnie opracowywany |
| `review` | do przeglądu | materiał czeka na sprawdzenie |
| `ready` | opracowane | materiał jest sprawdzony i gotowy do użycia |
| `blocked` | zablokowane | dalsza praca wymaga rozwiązania zależności |
Pole `version` ma format `vNN.NN`, na przykład `v00.01`. Drugi człon
zwiększamy przy zaakceptowanej rewizji treści lub materiałów tasku. Pierwszy
człon zwiększamy, gdy zmienia się kontrakt dydaktyczny albo wymagany rezultat;
po takim zwiększeniu drugi człon zaczyna się od `00`.
```json
{
"chapter": "5.4",
"task": "Task04",
"idea_tex": "arytmetyka adresów, alokator",
"priority": "obowiązkowe",
"status": "in-progress",
"version": "v00.01",
"key": true
}
```
Status i wersję zmieniamy wyłącznie w źródłowym `card_source.json`; pliki
HTML, TeX i PDF pozostają artefaktami generatora.
### Efekty i kryteria
- `educational_requirements` — wymagania `WE`;