docs: service request architecture reference doc #181

New issue

Closed

opened 2026-06-08 05:07:57 +00:00 by ldraney · 0 comments

ldraney commented

2026-06-08 05:07:57 +00:00

Owner

Type

Feature

Lineage

Supports Phase 3 tickets #123, #176, #179, #180.

Repo

ldraney/landscaping-assistant

User Story

As a dev agent, I need a focused architecture doc for the service request workflow so I can build the UI tickets without digging through the 400-line user-stories-auth.md.

Context

The service request workflow (status lifecycle, data model, client/admin flows, Stripe integration, property comments) is documented in user-stories-auth.md but buried among unrelated auth content. A standalone doc with mermaid diagrams gives agents a clean reference.

File Targets

docs/service-requests.md (new)

Acceptance Criteria

Mermaid state diagram for status lifecycle
ERD reflecting actual schema (crew_member_id, not user_id)
Client and admin flow diagrams
Role access matrix

Test Expectations

Docs only — no code changes
Run: N/A

Constraints

Must match post-#122 schema

Feature Flag

None

Checklist

PR opened
No unrelated changes

#122 — ServiceRequest model (merged)
#123, #176, #179, #180 — downstream tickets that reference this doc

### Type Feature ### Lineage Supports Phase 3 tickets #123, #176, #179, #180. ### Repo `ldraney/landscaping-assistant` ### User Story As a dev agent, I need a focused architecture doc for the service request workflow so I can build the UI tickets without digging through the 400-line user-stories-auth.md. ### Context The service request workflow (status lifecycle, data model, client/admin flows, Stripe integration, property comments) is documented in user-stories-auth.md but buried among unrelated auth content. A standalone doc with mermaid diagrams gives agents a clean reference. ### File Targets - `docs/service-requests.md` (new) ### Acceptance Criteria - [ ] Mermaid state diagram for status lifecycle - [ ] ERD reflecting actual schema (crew_member_id, not user_id) - [ ] Client and admin flow diagrams - [ ] Role access matrix ### Test Expectations - Docs only — no code changes - Run: N/A ### Constraints - Must match post-#122 schema ### Feature Flag None ### Checklist - [ ] PR opened - [ ] No unrelated changes ### Related - #122 — ServiceRequest model (merged) - #123, #176, #179, #180 — downstream tickets that reference this doc