Merge pull request #1332 from Tria-plc/freight/feat/foreign-investors

Freight/feat/foreign investors

apps/edr-freight-web/backoffice/src/components/customers/badges.tsx

@@ -114,6 +114,36 @@ export function CompanyNationalityBadge({
   );
 }
 
+/**
+ * The company's registration was typed, not fetched from eTrade — nothing in it
+ * has been checked against a licence. Loud on purpose: it is the one thing a
+ * reviewer must not miss about this customer. Two kinds of company land here
+ * for different reasons, and the badge names which.
+ */
+export function ManualRegistrationBadge({
+  cooperative,
+  investorLicence,
+}: {
+  cooperative?: boolean | null;
+  investorLicence?: boolean | null;
+}) {
+  if (!cooperative && !investorLicence) return null;
+  return (
+    <Badge
+      color="orange"
+      variant="light"
+      size="sm"
+      radius="md"
+      fw={600}
+      style={badgeStyle}
+    >
+      {cooperative
+        ? "Manual entry · co-operative"
+        : "Manual entry · investment licence"}
+    </Badge>
+  );
+}
+
 /**
  * Profile chips for a company row: one chip per role (Importer / Exporter / …)
  * carrying its reference code, colored by the profile's status (green active,

apps/edr-freight-web/backoffice/src/components/customers/index.ts

@@ -4,6 +4,7 @@ export {
   CompanyStatusBadge,
   CompanyTypeBadge,
   InvoiceStatusBadge,
+  ManualRegistrationBadge,
   PaymentStatusBadge,
   ProfileApprovalActions,
   ProfileChips,

apps/edr-freight-web/backoffice/src/pages/customers/CustomerDetailPage.tsx

@@ -50,6 +50,7 @@ import {
   CompanyTimeline,
   CompanyTypeBadge,
   InvoiceStatusBadge,
+  ManualRegistrationBadge,
   PaymentStatusBadge,
   PersonCard,
   ProfileApprovalActions,
@@ -744,6 +745,10 @@ export default function CustomerDetailPage() {
             ) : (
               <CompanyStatusBadge status={company.status} />
             )}
+            <ManualRegistrationBadge
+              cooperative={company.cooperative}
+              investorLicence={company.investorLicence}
+            />
             <ChangeRequestPendingBadge companyId={company.id} />
           </Group>
         }
@@ -792,6 +797,25 @@ export default function CustomerDetailPage() {
               </Alert>
             )}
 
+            {/* Nothing below came from eTrade for these customers. A
+                co-operative holds no trade licence at all; a foreign investor's
+                comes from the Investment Commission, not the trade registry.
+                Either way every registration field was typed, and the reviewer
+                is the only check there is. */}
+            {(company.cooperative || company.investorLicence) && (
+              <Alert
+                color="orange"
+                variant="light"
+                radius="md"
+                icon={<AlertTriangle size={18} />}
+                title="Registration entered by hand — not verified against eTrade"
+              >
+                {company.cooperative
+                  ? "This company onboarded as a co-operative union or farm, which holds no trade licence, so eTrade had no record to look its TIN up in. The company name, registration and address below are the customer's own statement. Check them against the Co-operative Registration Certificate on the Documents tab before approving."
+                  : "This company onboarded on a foreign investment licence, so we could not look its TIN up on eTrade. The company name, registration and address below are the customer's own statement. Check them against the Investment Licence on the Documents tab before approving."}
+              </Alert>
+            )}
+
             <ChangeRequestReview company={company} />
 
             <KpiStrip
@@ -861,7 +885,9 @@ export default function CustomerDetailPage() {
                           value={
                             company.cooperative
                               ? "Co-operative union / farm (no trade licence)"
-                              : "eTrade trade licence"
+                              : company.investorLicence
+                                ? "Foreign investment licence — typed by the customer, not from eTrade"
+                                : "eTrade trade licence"
                           }
                         />
                         <InfoField label="Address" value={company.address} />

apps/edr-freight-web/backoffice/src/pages/customers/CustomersPage.tsx

@@ -28,6 +28,7 @@ import { useNavigate } from "react-router-dom";
 import {
   CompanyNationalityBadge,
   CompanyStatusBadge,
+  ManualRegistrationBadge,
   ProfileChips,
   formatDate,
 } from "@/components/customers";
@@ -142,6 +143,10 @@ export default function CustomersPage() {
                     {c.name}
                   </Text>
                   <CompanyNationalityBadge nationality={c.nationality} />
+                  <ManualRegistrationBadge
+                    cooperative={c.cooperative}
+                    investorLicence={c.investorLicence}
+                  />
                 </Group>
                 <Text size="xs" c="dimmed">
                   TIN {c.tin}

apps/edr-freight-web/backoffice/src/types/customer.ts

@@ -234,6 +234,13 @@ export interface Company {
    * manager to check the owner against, and it holds no freight-forwarder role.
    */
   cooperative?: boolean;
+  /**
+   * A foreign investor on an Ethiopian Investment Commission licence: eTrade
+   * holds no record for its TIN, so every registration field below was typed by
+   * the customer and verified by nobody. The reviewer is the check — compare
+   * them against the investment licence on the Documents tab.
+   */
+  investorLicence?: boolean;
   address?: string | null;
   phone?: string | null;
   email?: string | null;