feat: track task scope status and version
This commit is contained in:
@@ -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`;
|
||||
|
||||
Reference in New Issue
Block a user