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: BaseModel

Operational 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: BaseModel

A 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: BaseModel

One 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: BaseModel

One 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.