Skip to content

Planning System Models

Dataclass-based domain models for project planning.

Key Classes

Class Purpose
ProjectContainer Root structure: flat dict of items, root_order, metadata
ProjectItem Single planning item with hierarchy, properties, and visual data
CompletionStatus Enum: PLANNED, IN_PROGRESS, COMPLETED, ISSUES

Notes

  • ProjectItem uses @dataclass with to_dict() / from_dict() for serialization
  • create_from_library_item() converts library items into project items
  • clone() creates deep copies with new UUIDs
  • calculate_path_symbolik() builds hierarchical symbol paths (e.g. =A1+K1-M1)
  • Items reference parents/children by instance_id strings, not object references