# Phase: Staff & Commission

| Field | Value |
| --- | --- |
| Identifier | `beauty-business-14-6` |
| Status | Planned |
| Owner | Platform |
| Module(s) | `beauty_business.staff`, `beauty_business.commissions` |
| Service(s) | `beauty_business` |
| Depends On | `beauty-business-14-0`, `beauty-business-14-1` (schedules), `beauty-business-14-3` (skills) |
| ADR(s) | TBD |
| Manifest | [phase-manifest.yaml](../../ai-framework/phase-manifest.yaml) |
| Framework | [ADR-013](../../architecture/adr/ADR-013.md) · [ADR-018](../../architecture/adr/ADR-018.md) · [ADR-019](../../architecture/adr/ADR-019.md) |

## Objective

Manage **beauty staff** and **commission**: staff profiles linked to Identity users, skills and certifications, working hours (feeds 14.1 schedules), commission rules (percentage, tiered, service-based), commission entries on completed services — without owning Identity admin, HCM payroll (Accounting Phase 5.9), or Healthcare doctor profiles.

## Enterprise Phase Discovery

> **Required before Implementation.**

### Target Responsibility (this phase when Complete)

- StaffProfile (identity_user_ref, branch assignment, staff_kind: stylist, barber, therapist, laser tech)
- StaffSkill, StaffCertificate (refs Storage for docs)
- StaffWorkingHours (may unify with 14.1 schedules per Discovery)
- CommissionRule, CommissionEntry (accrual shells)
- Payroll export intents to Accounting (refs only)
- Events: `beauty_business.staff.*`, `beauty_business.commission.*`

### Explicitly Excluded

- Identity user provisioning
- Accounting PayrollEngine implementation
- Healthcare doctor panel and clinical credentials

## Business Analysis

| Item | Detail |
| --- | --- |
| Actors | Salon owner, branch manager, stylist |
| Business capabilities | Staff roster, skills, commission calculation |
| Success metrics | Commission entries match completed appointments |
| Non-goals | Full HRIS |

## Scope

### In Scope

- StaffProfile, StaffSkill, StaffCertificate
- CommissionRule (per service, per staff tier, split rules shell)
- CommissionEntry (generated on appointment.completed)
- Permissions: `beauty_business.staff.*`, `beauty_business.commissions.*`

### High-Level Entities

| Entity | Purpose |
| --- | --- |
| StaffProfile | Beauty professional |
| StaffSkill | Color specialist, laser certified, … |
| CommissionRule | 40% service commission |
| CommissionEntry | Accrued commission line |

## Out of Scope

- Booking availability engine (14.1)
- Marketing (14.7)
- Accounting journal posting (intents only)
- Healthcare doctors and visit sessions

## Completion Criteria

- [ ] Staff linked by Identity ref only
- [ ] Commission entries triggered from appointment events
- [ ] No payroll engine duplication in beauty_business service

## Related Documents

- [Phase 14.1](phase-14-1-booking-engine.md)
- [Phase 14.3](phase-14-3-service-catalog.md)
- [Beauty Business Roadmap](../../beauty-business-roadmap.md)
