Monthly Labor Costs

A Labor Cost is one explicit amount for one Member and one calendar month. In Settings → Teams → Labor costs, choose a year and edit all 12 months in the same worksheet. Billable Members appear by default; the Member filter can show non-billable or all Members. Search always searches all Members, regardless of the selected filter, and clearing it restores the filtered view.

Changes save automatically after a short pause. Edits made together are submitted as one atomic batch, and each changed cell shows its save state or validation error. Leave an amount blank to remove that Member-month value, or enter 0 to keep an explicit zero. Amounts must be nonnegative whole numbers with at most 13 digits.

Use the fill action beside a month heading to copy that source month into other months. The dialog lets you choose target months and either the Members currently visible after search and filtering or all Members, then previews how many cells will be filled, preserved, or skipped. Fill changes empty cells only; it never replaces an existing amount or explicit zero, and a source zero is copied as a real value.

A row records the company’s total chosen labor-cost basis for that Member-month; AndonPulse does not store an hourly rate, salary or expense components, a currency, or an automatic value for later months.

The settings API resource is /api/v1/members/labor_cost:

• GET requires year=YYYY. It returns all Members, the 12 month keys, and each Member’s amount for every month in that year. Filtering and search are presentation concerns in the worksheet.
• PUT accepts a changes array of member_id/month/amount entries. The complete request succeeds or rolls back atomically. A blank amount removes that Member-month row; 0 persists as an explicit zero. One successful batch queues one targeted dbt reconciliation so analytical Labor Cost reflects the edits.

The API rejects fractional values instead of rounding them.

Editing a past month restates only that month. Values in earlier and later months do not change, and ordinary created_at and updated_at timestamps record when each persisted row was written. The dedicated response carries Member identity and billable state without adding Labor Cost fields to the general Member resource.

This resource owns user-authored monthly amounts only. Analytical valuation belongs to dbt, which combines the amount with the Member’s complete pre-leave monthly schedule rather than storing a second authored rate. Metrics sums covered Effort and warns when it excludes contributions that lack a resolved Member, an amount, or a usable complete-month schedule.