brushline.tactical.operations
Work-order, operations configuration, violations, and the tactical-to-operational builder.
Operational work plan: work orders, sequence, crew assignment, and day windows.
- class brushline.tactical.operations.OperationsConfig(*, start_year: Annotated[int, ~annotated_types.Ge(ge=1900), ~annotated_types.Le(le=2200)] = 2026, start_day: Annotated[int, ~annotated_types.Ge(ge=1)] = 1, max_orders_per_day: Annotated[int, ~annotated_types.Ge(ge=1)] = 2, crew_ids: list[str] = <factory>)[source]
Bases:
BaseModelOperational scheduling settings.
- Parameters:
start_year (int) – First year.
start_day (int) – First day number.
max_orders_per_day (int) – Daily work-order cap.
crew_ids (list of str) – Available crews.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.tactical.operations.OperationsPlan(*, schema_version: ~typing.Literal['brushline.tactical-operations.v1'] = 'brushline.tactical-operations.v1', plan_id: str, instance_id: str, program_id: str, work_orders: list[~brushline.tactical.operations.WorkOrder], feasible: bool, violations: list[~brushline.tactical.operations.OperationsViolation] = <factory>, total_cost: ~typing.Annotated[float, ~annotated_types.Ge(ge=0)], created_utc: ~datetime.datetime)[source]
Bases:
BaseModelA work-ready operational plan.
- Parameters:
schema_version ({"brushline.tactical-operations.v1"}) – Schema version.
plan_id (str) – Plan id.
instance_id (str) – Instance id.
program_id (str) – Source tactical program.
work_orders (list of WorkOrder) – Work orders.
feasible (bool) – All actions scheduled.
violations (list of OperationsViolation) – Violations.
total_cost (float) – Total cost.
created_utc (datetime) – Timezone-aware time.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.tactical.operations.OperationsViolation(*, code: str, message: str, action_id: str | None = None)[source]
Bases:
BaseModelOne operational violation.
- Parameters:
code (str) – Code.
message (str) – Explanation.
action_id (str or None) – Action.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.tactical.operations.WorkOrder(*, work_order_id: str, action_id: str, unit_id: str, contractor_id: str, crew_id: str, machine_id: str | None = None, year: int, day: ~typing.Annotated[int, ~annotated_types.Ge(ge=1)], season: str, method: str, cost: ~typing.Annotated[float, ~annotated_types.Ge(ge=0)], status: str = 'ready', segment_ids: list[str] = <factory>)[source]
Bases:
BaseModelOne work-ready order.
- Parameters:
work_order_id (str) – Work order id.
action_id (str) – Source tactical action.
unit_id (str) – Unit id.
contractor_id (str) – Contractor id.
crew_id (str) – Crew id.
machine_id (str or None) – Machine id.
year (int) – Year.
day (int) – Day number.
season (str) – Season.
method (str) – Method.
cost (float) – Cost.
status (str) – Status.
segment_ids (list of str, optional) – Source segment ids.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- brushline.tactical.operations.build_operations_plan(*, plan_id: str, instance_id: str, program: TacticalProgram, access: AccessPlan, config: OperationsConfig | None = None, created_utc: datetime | None = None) OperationsPlan[source]
Assign tactical actions to crews and days.
- Parameters:
plan_id (str) – Plan id.
instance_id (str) – Instance id.
program (TacticalProgram) – Tactical program.
access (AccessPlan) – Access decisions.
config (OperationsConfig, optional) – Scheduling settings.
created_utc (datetime, optional) – Creation time.
- Returns:
OperationsPlan – Work orders and violations.