document explicit set levels

This commit is contained in:
Yisroel Baum 2026-08-11 23:02:45 +03:00
parent 8e38b8f7e8
commit 98a4e2e007
Signed by: yisroelbaum
GPG key ID: 0FA60884F75520A9

View file

@ -9,14 +9,17 @@ these rules.
- Attainly is in early development. - Attainly is in early development.
- Attainly helps users break hierarchical goals into scheduled assignments, - Attainly helps users break hierarchical goals into scheduled assignments,
complete daily work, and track progress toward a target date. complete daily work, and track progress toward a target date.
- Schedules target whole sets. Users choose an element kind as the assignment - Sets define explicit ordered element levels. Every depth has one kind, and
a kind can appear at only one depth within a set. Root elements use the
first level, and children use the level immediately after their parent.
- Schedules target whole sets. Users choose a set level as the assignment
granularity. To schedule a subset, create a separate named set containing granularity. To schedule a subset, create a separate named set containing
that subset. that subset.
- Schedules are immutable historical snapshots. Copy the set name and each - Schedules are immutable historical snapshots. Copy the set name and each
assignment's name, kind, and full path when creating a schedule. assignment's name, kind, and full path when creating a schedule.
- Persisted schedules must not reference their source set, and persisted - Persisted schedules must not reference their source set or selected level.
assignments must not reference their source elements. Later source edits or Persisted assignments must not reference their source elements. Later
deletions must not change an existing schedule. source edits or deletions must not change an existing schedule.
- Schedule recalculation must preserve completed work while redistributing - Schedule recalculation must preserve completed work while redistributing
unfinished assignments across the remaining dates. unfinished assignments across the remaining dates.
- Planned features in `README.md` are future ideas, not authorized scope. - Planned features in `README.md` are future ideas, not authorized scope.