gracepress/technical-services-exchange
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Phase 6 and 7 scope contact safeguards

Browse Source
This commit is contained in:
Codex
2026-07-10 14:14:23 -05:00
parent 6ce2b294d0
commit 5009269907
27 changed files with 1158 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Models/Dispute.php
+13 -1
View File
@@ -9,11 +9,23 @@ use Illuminate\Database\Eloquent\Relations\MorphMany;
use Illuminate\Database\Eloquent\Model;
#[Fillable([
'work_order_id', 'opened_by_id', 'status', 'summary', 'claim', 'response',
'work_order_id', 'opened_by_id', 'status', 'summary', 'reason_code', 'claim', 'response',
'evidence_notes', 'recommended_resolution', 'peer_votes', 'resolved_at',
])]
class Dispute extends Model
{
public const REASON_CODES = [
'scope_expansion' => 'Scope expansion',
'unreachable_contact' => 'Unreachable contact',
'support_unavailable' => 'Support unavailable',
'missing_deliverable' => 'Missing deliverable',
'payment_issue' => 'Payment issue',
'schedule_issue' => 'Schedule issue',
'quality_issue' => 'Quality issue',
'insufficient_evidence' => 'Insufficient evidence',
'other' => 'Other',
];
protected function casts(): array
{
return [
app/Models/DisputeVote.php
+1 -1
View File
@@ -6,7 +6,7 @@ use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Model;
#[Fillable(['dispute_id', 'user_id', 'recommendation', 'reason'])]
#[Fillable(['dispute_id', 'user_id', 'recommendation', 'reason_code', 'reason'])]
class DisputeVote extends Model
{
public function dispute(): BelongsTo
app/Models/JobPost.php
+123 -2
View File
@@ -11,15 +11,37 @@ use Illuminate\Database\Eloquent\Model;
#[Fillable([
'buyer_id', 'title', 'status', 'service_category', 'location', 'starts_at',
'time_window', 'scope', 'required_skills', 'required_tools', 'deliverables',
'payment_terms', 'vendor_onboarding', 'visibility',
'time_window', 'schedule_type', 'remote_eligible', 'scope', 'primary_objective',
'included_work', 'excluded_work', 'maximum_onsite_expectations', 'expected_duration',
'required_skills', 'required_tools', 'required_certifications', 'required_safety_gear',
'deliverables', 'closeout_conditions', 'buyer_provided_equipment',
'provider_provided_equipment', 'return_shipment_expectations', 'parking_access_notes',
'onsite_restrictions', 'supplemental_instructions', 'scope_clarity_status',
'risk_flags', 'payment_terms', 'vendor_onboarding', 'primary_contact_name',
'primary_contact_phone', 'primary_contact_email', 'backup_contact_name',
'backup_contact_phone', 'backup_contact_email', 'dispatch_contact_name',
'dispatch_contact_phone', 'dispatch_contact_email', 'technical_bridge',
'escalation_contact', 'support_channel', 'support_expected_response_time',
'support_availability_window', 'contact_certified', 'contact_certified_by_id',
'contact_certified_at', 'visibility',
])]
class JobPost extends Model
{
public const SCOPE_CLARITY_STATUSES = [
'clear' => 'Clear',
'needs_review' => 'Needs review',
'broad_scope' => 'Broad scope',
'missing_support' => 'Missing support',
];
protected function casts(): array
{
return [
'starts_at' => 'datetime',
'remote_eligible' => 'boolean',
'risk_flags' => 'array',
'contact_certified' => 'boolean',
'contact_certified_at' => 'datetime',
];
}
@@ -52,4 +74,103 @@ class JobPost extends Model
{
return $this->morphMany(Rating::class, 'rateable');
}
public function scopeSnapshot(): array
{
return [
'primary_objective' => $this->primary_objective,
'included_work' => $this->included_work,
'excluded_work' => $this->excluded_work,
'maximum_onsite_expectations' => $this->maximum_onsite_expectations,
'expected_duration' => $this->expected_duration,
'required_skills' => $this->required_skills,
'required_tools' => $this->required_tools,
'required_certifications' => $this->required_certifications,
'required_safety_gear' => $this->required_safety_gear,
'deliverables' => $this->deliverables,
'closeout_conditions' => $this->closeout_conditions,
'buyer_provided_equipment' => $this->buyer_provided_equipment,
'provider_provided_equipment' => $this->provider_provided_equipment,
'return_shipment_expectations' => $this->return_shipment_expectations,
'parking_access_notes' => $this->parking_access_notes,
'onsite_restrictions' => $this->onsite_restrictions,
'supplemental_instructions' => $this->supplemental_instructions,
];
}
public function contactSnapshot(): array
{
return [
'primary_contact_name' => $this->primary_contact_name,
'primary_contact_phone' => $this->primary_contact_phone,
'primary_contact_email' => $this->primary_contact_email,
'backup_contact_name' => $this->backup_contact_name,
'backup_contact_phone' => $this->backup_contact_phone,
'backup_contact_email' => $this->backup_contact_email,
'dispatch_contact_name' => $this->dispatch_contact_name,
'dispatch_contact_phone' => $this->dispatch_contact_phone,
'dispatch_contact_email' => $this->dispatch_contact_email,
'technical_bridge' => $this->technical_bridge,
'escalation_contact' => $this->escalation_contact,
'support_channel' => $this->support_channel,
'support_expected_response_time' => $this->support_expected_response_time,
'support_availability_window' => $this->support_availability_window,
'contact_certified' => $this->contact_certified,
'contact_certified_at' => $this->contact_certified_at?->toIso8601String(),
];
}
public function computeRiskFlags(): array
{
$flags = [];
if (! $this->primary_objective || ! $this->included_work || ! $this->excluded_work) {
$flags[] = 'missing_scope_boundaries';
}
if (! $this->deliverables || ! $this->closeout_conditions) {
$flags[] = 'unclear_closeout';
}
if (! $this->backup_contact_phone && ! $this->backup_contact_email) {
$flags[] = 'missing_contact_backup';
}
if (! $this->contact_certified) {
$flags[] = 'support_not_certified';
}
if (strlen((string) $this->supplemental_instructions) > 2000) {
$flags[] = 'long_supplemental_instructions';
}
if ($this->return_shipment_expectations) {
$flags[] = 'return_shipment_required';
}
if ($this->starts_at && $this->starts_at->isBefore(now()->addDay())) {
$flags[] = 'compressed_schedule';
}
return array_values(array_unique($flags));
}
public function computedScopeClarityStatus(): string
{
$flags = $this->computeRiskFlags();
if (in_array('missing_scope_boundaries', $flags, true) || in_array('unclear_closeout', $flags, true)) {
return 'needs_review';
}
if (in_array('support_not_certified', $flags, true) || in_array('missing_contact_backup', $flags, true)) {
return 'missing_support';
}
if (in_array('long_supplemental_instructions', $flags, true)) {
return 'broad_scope';
}
return 'clear';
}
}
app/Models/WorkOrder.php
+63 -1
View File
@@ -12,7 +12,8 @@ use Illuminate\Database\Eloquent\Model;
'job_post_id', 'buyer_id', 'provider_id', 'accepted_quote_id', 'status',
'status_history', 'agreed_terms', 'deliverables_checklist', 'scheduled_at',
'appointment_window', 'checklist_items', 'checklist_completed', 'required_evidence',
'evidence_rules', 'change_requests', 'completion_notes',
'evidence_rules', 'scope_snapshot', 'contact_snapshot', 'scope_clarity_status',
'risk_flags', 'change_requests', 'completion_notes',
'en_route_at', 'on_site_at', 'started_at', 'completed_at', 'approved_at', 'closed_at',
])]
class WorkOrder extends Model
@@ -42,6 +43,9 @@ class WorkOrder extends Model
'checklist_items' => 'array',
'checklist_completed' => 'array',
'evidence_rules' => 'array',
'scope_snapshot' => 'array',
'contact_snapshot' => 'array',
'risk_flags' => 'array',
'change_requests' => 'array',
'en_route_at' => 'datetime',
'on_site_at' => 'datetime',
@@ -97,6 +101,16 @@ class WorkOrder extends Model
return $this->morphMany(Rating::class, 'rateable');
}
public function structuredChangeRequests(): HasMany
{
return $this->hasMany(WorkOrderChangeRequest::class);
}
public function contactEvents(): HasMany
{
return $this->hasMany(WorkOrderContactEvent::class);
}
public function canTransitionTo(string $status): bool
{
return in_array($status, self::ALLOWED_TRANSITIONS[$this->status] ?? [], true);
@@ -134,6 +148,54 @@ class WorkOrder extends Model
public function changeRequests(): array
{
$structured = $this->relationLoaded('structuredChangeRequests')
? $this->structuredChangeRequests
: $this->structuredChangeRequests()->latest()->get();
if ($structured->isNotEmpty()) {
return $structured
->map(fn (WorkOrderChangeRequest $request): array => [
'id' => $request->id,
'summary' => $request->summary,
'details' => $request->details,
'reason_code' => $request->reason_code,
'reason_label' => WorkOrderChangeRequest::REASON_CODES[$request->reason_code] ?? $request->reason_code,
'scope_impact' => $request->scope_impact,
'schedule_impact' => $request->schedule_impact,
'terms_impact' => $request->terms_impact,
'requested_by_id' => $request->requester_id,
'requested_by_name' => $request->requester?->name,
'status' => $request->status,
'requested_at' => $request->created_at?->toIso8601String(),
'resolution_notes' => $request->resolution_notes,
])
->values()
->all();
}
return is_array($this->change_requests) ? array_values($this->change_requests) : [];
}
public function scopeSnapshotValue(string $key): ?string
{
$snapshot = is_array($this->scope_snapshot) ? $this->scope_snapshot : [];
return $snapshot[$key] ?? $this->jobPost?->{$key};
}
public function contactSnapshotValue(string $key): ?string
{
$snapshot = is_array($this->contact_snapshot) ? $this->contact_snapshot : [];
return $snapshot[$key] ?? $this->jobPost?->{$key};
}
public function contactFailureCount(): int
{
$events = $this->relationLoaded('contactEvents') ? $this->contactEvents : $this->contactEvents()->get();
return $events
->whereIn('event_type', ['contact_failed', 'support_unavailable', 'site_contact_unavailable'])
->count();
}
}
app/Models/WorkOrderChangeRequest.php
+58
View File
@@ -0,0 +1,58 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable([
'work_order_id',
'requester_id',
'responder_id',
'reason_code',
'summary',
'details',
'scope_impact',
'schedule_impact',
'terms_impact',
'status',
'resolution_notes',
'responded_at',
])]
class WorkOrderChangeRequest extends Model
{
public const REASON_CODES = [
'scope_expansion' => 'Scope expansion',
'missing_scope' => 'Missing or ambiguous scope',
'schedule_change' => 'Schedule change',
'site_condition' => 'Unexpected site condition',
'buyer_request' => 'Buyer-requested change',
'provider_request' => 'Provider-requested change',
'other' => 'Other',
];
public const STATUSES = ['open', 'accepted', 'declined', 'withdrawn'];
protected function casts(): array
{
return [
'responded_at' => 'datetime',
];
}
public function workOrder(): BelongsTo
{
return $this->belongsTo(WorkOrder::class);
}
public function requester(): BelongsTo
{
return $this->belongsTo(User::class, 'requester_id');
}
public function responder(): BelongsTo
{
return $this->belongsTo(User::class, 'responder_id');
}
}
app/Models/WorkOrderContactEvent.php
+43
View File
@@ -0,0 +1,43 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable([
'work_order_id',
'user_id',
'event_type',
'attempted_channel',
'attempted_at',
'result',
'notes',
])]
class WorkOrderContactEvent extends Model
{
public const EVENT_TYPES = [
'contact_failed' => 'Contact failed',
'support_unavailable' => 'Support unavailable',
'site_contact_unavailable' => 'Site contact unavailable',
'contact_reached' => 'Contact reached',
];
protected function casts(): array
{
return [
'attempted_at' => 'datetime',
];
}
public function workOrder(): BelongsTo
{
return $this->belongsTo(WorkOrder::class);
}
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
}