shoc-backend/SeaHaven.DataServices/Models/VendorCompanyRosterModels.cs
Alexandre Brandizzi 11a355bb7a feat(vendor-roster): additive PATCH endpoint for technician adds (SH-250, SH-246)
PATCH /api/vendor-company-roster/{companyId} inserts the submitted
technicians and optionally updates company fields. Technicians absent
from the payload are never removed or deactivated, so the Add Vendor
flow can no longer soft-delete an existing roster via the full-snapshot
PUT. Stale rowVersion still 409s; unknown company 404s. POST (create)
and PUT (reconcile) behaviour is unchanged.
2026-08-18 12:14:12 -03:00

99 lines
3.9 KiB
C#

using Data.SeaHavenIndustries;
namespace SeaHaven.DataServices.Models
{
public sealed class VendorCompanyRosterReadModel
{
public int CompanyId { get; set; }
public string Name { get; set; } = string.Empty;
public string? CompanyPhone { get; set; }
public string? Email { get; set; }
public string? Address { get; set; }
public string? City { get; set; }
public string? State { get; set; }
public string? Zip { get; set; }
public string? GoogleMapsUrl { get; set; }
public string? Notes { get; set; }
public byte[]? RowVersion { get; set; }
public List<VendorRosterTechnicianReadModel> Technicians { get; set; } = new();
}
public sealed class VendorRosterTechnicianReadModel
{
public int Id { get; set; }
public string? ContactName { get; set; }
public string? Phone { get; set; }
public string? Email { get; set; }
public string? PreferredContact { get; set; }
public string? TradeSpecialties { get; set; }
public bool IsActive { get; set; }
public int TotalJobs { get; set; }
}
public sealed class VendorCompanyRosterWriteModel
{
public int CompanyId { get; set; }
public byte[]? RowVersion { get; set; }
public string Name { get; set; } = string.Empty;
public string? CompanyPhone { get; set; }
public string? Email { get; set; }
public string? Address { get; set; }
public string? City { get; set; }
public string? State { get; set; }
public string? Zip { get; set; }
public string? GoogleMapsUrl { get; set; }
public string? Notes { get; set; }
public string? ActorUserId { get; set; }
public List<RosterTechnicianWriteModel> Technicians { get; set; } = new();
}
public sealed class RosterTechnicianWriteModel
{
public int? Id { get; set; }
public string? ContactName { get; set; }
public string? Phone { get; set; }
public string? Email { get; set; }
public string? PreferredContact { get; set; }
public string? TradeSpecialties { get; set; }
public bool IsActive { get; set; } = true;
}
// Additive roster update (SH-250): AddTechnicians rows are inserted and nothing
// is ever removed. CompanyFields carries optional company-level updates where a
// null property means "leave unchanged".
public sealed class VendorCompanyRosterAddWriteModel
{
public int CompanyId { get; set; }
public byte[]? RowVersion { get; set; }
public string? ActorUserId { get; set; }
public VendorRosterCompanyFieldsWriteModel? CompanyFields { get; set; }
public List<RosterTechnicianWriteModel> AddTechnicians { get; set; } = new();
}
public sealed class VendorRosterCompanyFieldsWriteModel
{
public string? Name { get; set; }
public string? CompanyPhone { get; set; }
public string? Email { get; set; }
public string? Address { get; set; }
public string? City { get; set; }
public string? State { get; set; }
public string? Zip { get; set; }
public string? GoogleMapsUrl { get; set; }
public string? Notes { get; set; }
}
// Raised by the roster data service when a technician removed from the snapshot
// still has open linked work orders, so the whole reconcile must fail. Carries the
// blocking work orders so the API can surface a stable 409 without leaking internals.
public sealed class VendorRosterConflictException : Exception
{
public IReadOnlyList<LinkedWorkOrderInfo> BlockedWorkOrders { get; }
public VendorRosterConflictException(string message, IReadOnlyList<LinkedWorkOrderInfo> blockedWorkOrders)
: base(message)
{
BlockedWorkOrders = blockedWorkOrders;
}
}
}