Ziply address availability

NumberSearch.DataAccess/InternetBundle.sql

@@ -0,0 +1,17 @@
+-- Fiber internet contract terms and the phone bundle discount, in support of https://acceleratenetworks.com/Internet.
+-- Run this against the PostgresqlProd database with psql before deploying. Safe to run again.
+
+-- Stop at the first failed statement, however this file is run, so a failed CREATE never falls through to a later DROP.
+\set ON_ERROR_STOP on
+
+-- The contract term (2, 3 or 5 years) chosen for fiber internet on an order, 0 when the order has no fiber internet.
+ALTER TABLE public."Orders"
+    ADD COLUMN IF NOT EXISTS "InternetTermYears" integer NOT NULL DEFAULT 0,
+    -- The listed service address the fiber was qualified at, and the provider's building key, which survives re-importing the building lists.
+    ADD COLUMN IF NOT EXISTS "InternetServiceAddress" text NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS "InternetBuildingKey" text NOT NULL DEFAULT '';
+
+-- The Partner coupon now also takes $15/mo off each fiber internet connection, see InternetBundle.cs.
+UPDATE public."Coupons"
+SET "Description" = '5G service and fiber internet at partner pricing.'
+WHERE "CouponId" = '245e1c8a-0208-4016-acd1-a36f45315e88';

NumberSearch.DataAccess/Models/InternetBundle.cs

@@ -0,0 +1,100 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace NumberSearch.DataAccess
+{
+    /// <summary>
+    /// Fiber internet is $15/mo less per connection when it's bundled with phone service, or when the Partner coupon is applied.
+    /// </summary>
+    public static class InternetBundle
+    {
+        public static readonly Guid FiberInternet300ServiceId = new("cbcf5128-5164-40de-8dff-e71d0f152cab");
+        public static readonly Guid FiberInternet1GServiceId = new("708c3885-6dab-4a60-9e42-05cf13530076");
+        public static readonly Guid StandardLinesServiceId = new("16e2c639-445b-4ae6-9925-07300318206b");
+        public static readonly Guid ConcurrentSeatsServiceId = new("48eb4627-8692-4a3b-8be1-be64bbeea534");
+        public static readonly Guid PartnerCouponId = new("245e1c8a-0208-4016-acd1-a36f45315e88");
+
+        public const int DiscountPerConnection = 15;
+        public const string Name = "Fiber + Phone Bundle";
+        public const string Description = "$15/mo off fiber internet when bundled with phone service.";
+        public const string PartnerDescription = "$15/mo off fiber internet at partner pricing.";
+
+        /// <summary>
+        /// The contract terms fiber internet can be sold on, in years.
+        /// </summary>
+        public static readonly int[] TermYears = [2, 3, 5];
+
+        public static bool IsFiberInternet(Guid serviceId) => serviceId == FiberInternet300ServiceId || serviceId == FiberInternet1GServiceId;
+
+        /// <summary>
+        /// The speed in Mbps a building must be listed at to sell this fiber tier, or 0 when the service isn't fiber internet.
+        /// </summary>
+        public static int RequiredMbps(Guid serviceId) => serviceId == FiberInternet1GServiceId ? 1000 : serviceId == FiberInternet300ServiceId ? 300 : 0;
+
+        /// <summary>
+        /// Whether a fiber tier can be sold at a listed address: only WFI Sellable buildings listed at or above the tier's speed,
+        /// with a building key so Cart/Add can re-qualify the building.
+        /// </summary>
+        public static bool CanSellAt(Guid serviceId, ServiceAddress address) =>
+            IsFiberInternet(serviceId) && address.Product is "WFI" && address.Status is "Sellable" && !string.IsNullOrWhiteSpace(address.BuildingKey)
+            && ServiceAddress.ParseMbps(address.MaxSpeed) >= RequiredMbps(serviceId);
+
+        /// <summary>
+        /// The listed row a fiber tier can be sold at, or null. Both the Internet page and Cart/Add ask "can any of these rows sell this tier",
+        /// so they agree however many rows a building has and whatever order they come back in.
+        /// </summary>
+        public static ServiceAddress? QualifyingAddress(Guid serviceId, IEnumerable<ServiceAddress> addresses) =>
+            addresses.Where(x => CanSellAt(serviceId, x)).OrderByDescending(x => ServiceAddress.ParseMbps(x.MaxSpeed)).FirstOrDefault();
+
+        public static bool IsPhoneService(Guid serviceId) => serviceId == StandardLinesServiceId || serviceId == ConcurrentSeatsServiceId;
+
+        /// <summary>
+        /// The invoice notes for a fiber internet line, with the contract term and the address it was qualified at.
+        /// </summary>
+        public static string FiberNotes(int termYears, string serviceAddress, string description)
+        {
+            var term = termYears > 0 ? $"{termYears} year term. " : string.Empty;
+            var address = string.IsNullOrWhiteSpace(serviceAddress) ? string.Empty : $"Service address: {serviceAddress}. ";
+            return $"{term}{address}{description}";
+        }
+
+        /// <summary>
+        /// The parts of a product order the bundle depends on, so the Ops site's own ProductOrder model can use the same rules.
+        /// </summary>
+        public readonly record struct Line(Guid ServiceId, long Quantity, Guid? CouponId);
+
+        public static Line[] ToLines(IEnumerable<ProductOrder> productOrders) => [.. productOrders.Select(x => new Line(x.ServiceId, x.Quantity, x.CouponId))];
+
+        /// <summary>
+        /// The number of fiber internet connections in the cart.
+        /// </summary>
+        public static int FiberConnections(IEnumerable<ProductOrder> productOrders) => FiberConnections(ToLines(productOrders));
+
+        public static int FiberConnections(IEnumerable<Line> lines) =>
+            (int)lines.Where(x => IsFiberInternet(x.ServiceId)).Sum(x => Math.Max(x.Quantity, 0));
+
+        /// <summary>
+        /// Whether the bundle discount comes from the Partner coupon rather than phone service.
+        /// </summary>
+        public static bool IsPartnerOnly(IEnumerable<ProductOrder> productOrders) => IsPartnerOnly(ToLines(productOrders));
+
+        public static bool IsPartnerOnly(IEnumerable<Line> lines) => !HasPhoneService(lines) && HasPartnerCoupon(lines);
+
+        /// <summary>
+        /// The total monthly bundle discount in dollars, as a positive number. Applied once per fiber connection no matter how many phone services or coupons qualify it.
+        /// </summary>
+        public static int Discount(IEnumerable<ProductOrder> productOrders) => Discount(ToLines(productOrders));
+
+        public static int Discount(IEnumerable<Line> lines)
+        {
+            var all = lines as ICollection<Line> ?? [.. lines];
+            return HasPhoneService(all) || HasPartnerCoupon(all) ? FiberConnections(all) * DiscountPerConnection : 0;
+        }
+
+        private static bool HasPhoneService(IEnumerable<Line> lines) => lines.Any(x => IsPhoneService(x.ServiceId) && x.Quantity > 0);
+
+        // Coupons don't carry a meaningful quantity, so any Partner coupon line qualifies, unlike phone service which must have at least one line or seat.
+        private static bool HasPartnerCoupon(IEnumerable<Line> lines) => lines.Any(x => x.CouponId == PartnerCouponId);
+    }
+}