Story 7: Create Maintenance Task (Photo-First Parts)

Coming Soon

This feature is planned for a future release.

As a ranch technician or maintenance crew member I want to create a task with description, photos, and parts list So that the right work gets done with the right parts ready

User Journey

Entry Points

Tasks can be created from multiple contexts:

Context	Trigger	Pre-filled Info
Inspection (problem)	"Create Task" button appears when condition = Poor	Element, problem description, inspection photos
Trace view (failure)	"Create Task" on failed element	Element, upstream/downstream context
Element detail	Long-press → "Create Task"	Element name and location
General	FAB menu → "New Task"	Nothing pre-filled

Wireframes

Step 1: Problem detected in inspection → Create Task appears

┌─────────────────────────┐
│  Review         [Cancel]│
├─────────────────────────┤
│  📷 📷 📷  North Pump   │
├─────────────────────────┤
│  Condition Assessment:  │
│  ┌─────────────────────┐│
│  │ Poor - needs repair ││
│  │ [Good][Fair][● Poor]││
│  └─────────────────────┘│
│                         │
│  AI Notes:              │
│  "Visible leak at seal, │
│   corrosion on housing" │
├─────────────────────────┤
│  [ Confirm & Save ]     │
│  [ 🔧 Create Task ]     │ ← appears for Poor condition
└─────────────────────────┘

Step 2: Task form with pre-filled context

┌─────────────────────────┐
│  New Task        [Save] │
├─────────────────────────┤
│  Linked to: North Pump  │
│  From: Inspection 1/19  │
├─────────────────────────┤
│  Description:           │
│  ┌─────────────────────┐│
│  │ Repair leak at seal ││ ← AI pre-filled
│  │ Corrosion on housing││
│  └─────────────────────┘│
│                         │
│  Photos: 📷 📷 [+ Add]  │ ← from inspection
│                         │
│  Priority:              │
│  [● High][Medium][Low]  │
├─────────────────────────┤
│  Parts Needed           │
│  └─ (none yet)          │
│  [ + Add Part ]         │
└─────────────────────────┘

Step 3: Add Part → Choose New or Replace

┌─────────────────────────┐
│  Add Part        [Done] │
├─────────────────────────┤
│                         │
│  What kind of part?     │
│                         │
│  ┌─────────────────────┐│
│  │  🔄 Replace         ││
│  │  Swap existing part ││
│  │  for a new one      ││
│  └─────────────────────┘│
│                         │
│  ┌─────────────────────┐│
│  │  ➕ New             ││
│  │  Add a part that    ││
│  │  doesn't exist yet  ││
│  └─────────────────────┘│
│                         │
└─────────────────────────┘

Step 4: AI suggests part details (photo-first)

┌─────────────────────────┐
│  Part Details    [Save] │
├─────────────────────────┤
│  ┌──────┐               │
│  │ 🖼️  │  captured photo│
│  └──────┘               │
├─────────────────────────┤
│  AI Detected:           │
│                         │
│  Part Type:             │
│  ┌─────────────────────┐│
│  │ Pump seal      [✓]  ││ ← AI suggested
│  └─────────────────────┘│
│                         │
│  Model/Size:            │
│  ┌─────────────────────┐│
│  │ 2" mechanical  [✓]  ││
│  └─────────────────────┘│
│                         │
│  Quantity:              │
│  [ - ]    1    [ + ]    │
│                         │
│  Notes:                 │
│  ┌─────────────────────┐│
│  │ For North Pump seal ││
│  └─────────────────────┘│
└─────────────────────────┘

Step 5: Task with parts list complete

┌─────────────────────────┐
│  New Task        [Save] │
├─────────────────────────┤
│  Linked to: North Pump  │
│  Priority: ● High       │
├─────────────────────────┤
│  Description:           │
│  "Repair leak at seal,  │
│   replace corroded..."  │
│                         │
│  Photos: 📷 📷 📷       │
├─────────────────────────┤
│  Parts Needed (2)       │
│  ┌─────────────────────┐│
│  │ 🔄 Pump seal 2"     ││
│  │    Replacing: Seal  ││
│  │    Qty: 1    [Edit] ││
│  └─────────────────────┘│
│  ┌─────────────────────┐│
│  │ ➕ Pipe sealant     ││
│  │    New consumable   ││
│  │    Qty: 1    [Edit] ││
│  └─────────────────────┘│
│  [ + Add Part ]         │
├─────────────────────────┤
│  [ Save Task ]          │
└─────────────────────────┘

Steps

1. Trigger task creation - From inspection (Poor condition), trace (failed element), or element menu
2. Review pre-filled info - Description auto-generated from inspection/trace context
3. Add task photos - Capture or include existing inspection photos
4. Set priority - High/Medium/Low based on urgency
5. Add parts (optional) - Tap "Add Part" to start parts flow
6. Choose New or Replace - Optimize flow based on part type
7. Photo the part - Camera-first: capture part, packaging, or similar
8. Confirm AI suggestions - Part type, model, quantity pre-filled
9. Save task - Task linked to element, visible in task list

New vs Replace Parts Flow

Flow	When to Use	Optimized For
Replace	Swapping an existing part	Shows current parts on element, tracks replacement history
New	Adding something that doesn't exist	Photo-first identification, no existing context needed

Happy Path (from inspection)

Technician captures pump → AI detects "Poor condition - leak at seal" → taps "Create Task" → description pre-filled → taps "Add Part" → selects "Replace" → picks "Seal assembly" → captures replacement part from packaging → AI reads "2 inch mechanical seal" → confirms → saves task. Task created with accurate parts list in under a minute.

Implementation Status

🔜 Planned for M8: Tasks & Maintenance - This story depends on inspections (M6) for the primary entry point.

Related Features

• Element Management — Tasks are linked to elements
• Camera-First Capture — Photo-first parts identification
• AI-Assisted Creation — AI suggests part details from photos
• Record Inspection — Primary entry point for task creation