@objectstack/platform-objects 9.11.0 → 10.2.0

package/dist/identity/index.js

@@ -378,6 +378,19 @@ var SysUser = data.ObjectSchema.create({
       required: false,
       group: "Profile"
     }),
+    // ── Organization ─────────────────────────────────────────────
+    manager_id: data.Field.lookup("sys_user", {
+      label: "Manager",
+      required: false,
+      group: "Organization",
+      description: "This user's direct manager. Forms the reporting chain the `own_and_reports` hierarchy scope walks (ADR-0057 / @objectstack/security-enterprise)."
+    }),
+    primary_business_unit_id: data.Field.lookup("sys_business_unit", {
+      label: "Primary Business Unit",
+      required: false,
+      group: "Organization",
+      description: "The user's primary business unit \u2014 a denormalised projection of sys_business_unit_member.is_primary, maintained by plugin-sharing (ADR-0057 addendum D12). Lets a user-lookup filter candidates by business unit without traversing the membership junction. Do not edit directly; set it via business-unit membership."
+    }),
     // ── System (auto-managed, hidden from create/edit forms) ─────
     id: data.Field.text({
       label: "User ID",
@@ -1158,7 +1171,10 @@ var SysMember = data.ObjectSchema.create({
     }),
     organization_id: data.Field.lookup("sys_organization", {
       label: "Organization",
-      required: true
+      // Optional: single-tenant has no sys_organization row and no auto-stamp
+      // (org-scoping is multi-tenant-only). Multi-tenant: OrgScopingPlugin stamps it
+      // and tenant-isolation RLS hides null-org rows (fail-closed). ADR-0057 addendum.
+      required: false
     }),
     user_id: data.Field.lookup("sys_user", {
       label: "User",
@@ -1345,7 +1361,10 @@ var SysInvitation = data.ObjectSchema.create({
     }),
     organization_id: data.Field.lookup("sys_organization", {
       label: "Organization",
-      required: true
+      // Optional: single-tenant has no sys_organization row and no auto-stamp
+      // (org-scoping is multi-tenant-only). Multi-tenant: OrgScopingPlugin stamps it
+      // and tenant-isolation RLS hides null-org rows (fail-closed). ADR-0057 addendum.
+      required: false
     }),
     email: data.Field.email({
       label: "Email",
@@ -1505,8 +1524,13 @@ var SysTeam = data.ObjectSchema.create({
     }),
     organization_id: data.Field.lookup("sys_organization", {
       label: "Organization",
-      required: true,
-      description: "Parent organization for this team",
+      // Optional: single-tenant deployments have no organization row (org-scoping
+      // is multi-tenant-only, nothing auto-stamps one) — requiring it would make
+      // the object uncreatable single-tenant. In multi-tenant, OrgScopingPlugin
+      // auto-stamps this from the active tenant and tenant-isolation RLS hides any
+      // null-org row (fail-closed). ADR-0057 addendum.
+      required: false,
+      description: "Parent organization for this team. Null in single-tenant; auto-stamped in multi-tenant.",
       group: "Identity"
     }),
     // ── System ───────────────────────────────────────────────────
@@ -1635,24 +1659,42 @@ var SysTeamMember = data.ObjectSchema.create({
     mru: false
   }
 });
-var SysDepartment = data.ObjectSchema.create({
-  name: "sys_department",
-  label: "Department",
-  pluralLabel: "Departments",
+var SysBusinessUnit = data.ObjectSchema.create({
+  name: "sys_business_unit",
+  label: "Business Unit",
+  pluralLabel: "Business Units",
   icon: "building",
   isSystem: true,
   managedBy: "platform",
-  description: "Hierarchical org-skeleton node (department / division / business unit / office).",
+  description: "Canonical Business Unit tree \u2014 hierarchical org/data-partition node (company / division / department / region / office). ADR-0057 D2.",
   displayNameField: "name",
   titleFormat: "{name}",
-  compactLayout: ["name", "kind", "parent_department_id", "manager_user_id"],
+  compactLayout: ["name", "kind", "parent_business_unit_id", "manager_user_id"],
   listViews: {
+    // Org chart — the hierarchy view. Surfaces the self-referencing
+    // `parent_business_unit_id` tree (ADR-0057 D2) as an indented, expand/
+    // collapse tree-grid. Listed first so it's the default tab; the grids
+    // below stay for search / filter / bulk edit.
+    org_chart: {
+      type: "tree",
+      name: "org_chart",
+      label: "Org Chart",
+      data: { provider: "object", object: "sys_business_unit" },
+      columns: ["name", "kind", "manager_user_id", "active"],
+      tree: {
+        parentField: "parent_business_unit_id",
+        labelField: "name",
+        fields: ["kind", "manager_user_id", "active"],
+        defaultExpandedDepth: 1
+      },
+      sort: [{ field: "name", order: "asc" }]
+    },
     active: {
       type: "grid",
       name: "active",
       label: "Active",
-      data: { provider: "object", object: "sys_department" },
-      columns: ["name", "code", "kind", "parent_department_id", "manager_user_id", "effective_from"],
+      data: { provider: "object", object: "sys_business_unit" },
+      columns: ["name", "code", "kind", "parent_business_unit_id", "manager_user_id", "effective_from"],
       filter: [{ field: "active", operator: "equals", value: true }],
       sort: [{ field: "name", order: "asc" }],
       pagination: { pageSize: 100 }
@@ -1661,7 +1703,7 @@ var SysDepartment = data.ObjectSchema.create({
       type: "grid",
       name: "inactive",
       label: "Inactive",
-      data: { provider: "object", object: "sys_department" },
+      data: { provider: "object", object: "sys_business_unit" },
       columns: ["name", "code", "kind", "effective_to"],
       filter: [{ field: "active", operator: "equals", value: false }],
       sort: [{ field: "effective_to", order: "desc" }],
@@ -1671,8 +1713,8 @@ var SysDepartment = data.ObjectSchema.create({
       type: "grid",
       name: "by_kind",
       label: "By Kind",
-      data: { provider: "object", object: "sys_department" },
-      columns: ["kind", "name", "code", "parent_department_id", "manager_user_id", "active"],
+      data: { provider: "object", object: "sys_business_unit" },
+      columns: ["kind", "name", "code", "parent_business_unit_id", "manager_user_id", "active"],
       sort: [{ field: "kind", order: "asc" }, { field: "name", order: "asc" }],
       grouping: { fields: [{ field: "kind", order: "asc", collapsed: false }] },
       pagination: { pageSize: 100 }
@@ -1681,8 +1723,8 @@ var SysDepartment = data.ObjectSchema.create({
       type: "grid",
       name: "all_departments",
       label: "All",
-      data: { provider: "object", object: "sys_department" },
-      columns: ["name", "code", "kind", "parent_department_id", "manager_user_id", "active"],
+      data: { provider: "object", object: "sys_business_unit" },
+      columns: ["name", "code", "kind", "parent_business_unit_id", "manager_user_id", "active"],
       sort: [{ field: "name", order: "asc" }],
       pagination: { pageSize: 100 }
     }
@@ -1705,7 +1747,7 @@ var SysDepartment = data.ObjectSchema.create({
       group: "Identity"
     }),
     kind: data.Field.select(
-      ["company", "division", "department", "team", "office", "cost_center"],
+      ["company", "division", "department", "office", "cost_center"],
       {
         label: "Kind",
         required: true,
@@ -1715,23 +1757,28 @@ var SysDepartment = data.ObjectSchema.create({
       }
     ),
     // ── Hierarchy ────────────────────────────────────────────────
-    parent_department_id: data.Field.lookup("sys_department", {
-      label: "Parent Department",
+    parent_business_unit_id: data.Field.lookup("sys_business_unit", {
+      label: "Parent Business Unit",
       required: false,
       description: "Self-reference for the org tree. Null = root of tenant.",
       group: "Hierarchy"
     }),
     organization_id: data.Field.lookup("sys_organization", {
       label: "Organization",
-      required: true,
-      description: "Tenant scope.",
+      // Optional: single-tenant deployments have no organization row (org-scoping
+      // is multi-tenant-only, nothing auto-stamps one) — requiring it would make
+      // the object uncreatable single-tenant. In multi-tenant, OrgScopingPlugin
+      // auto-stamps this from the active tenant and tenant-isolation RLS hides any
+      // null-org row (fail-closed). ADR-0057 addendum.
+      required: false,
+      description: "Tenant scope. Null in single-tenant; auto-stamped in multi-tenant.",
       group: "Hierarchy"
     }),
     // ── Leadership ───────────────────────────────────────────────
     manager_user_id: data.Field.lookup("sys_user", {
-      label: "Department Head",
+      label: "Business Unit Head",
       required: false,
-      description: "User responsible for this org unit (department head / lead).",
+      description: "User responsible for this org unit (business unit head / lead).",
       group: "Leadership"
     }),
     // ── Lifecycle ────────────────────────────────────────────────
@@ -1745,13 +1792,13 @@ var SysDepartment = data.ObjectSchema.create({
     effective_from: data.Field.datetime({
       label: "Effective From",
       required: false,
-      description: "When this department came into existence (HRIS sync).",
+      description: "When this business unit came into existence (HRIS sync).",
       group: "Lifecycle"
     }),
     effective_to: data.Field.datetime({
       label: "Effective To",
       required: false,
-      description: "When this department was retired (HRIS sync).",
+      description: "When this business unit was retired (HRIS sync).",
       group: "Lifecycle"
     }),
     external_ref: data.Field.text({
@@ -1763,7 +1810,7 @@ var SysDepartment = data.ObjectSchema.create({
     }),
     // ── System ───────────────────────────────────────────────────
     id: data.Field.text({
-      label: "Department ID",
+      label: "Business Unit ID",
       required: true,
       readonly: true,
       group: "System"
@@ -1783,7 +1830,7 @@ var SysDepartment = data.ObjectSchema.create({
   },
   indexes: [
     { fields: ["organization_id"] },
-    { fields: ["parent_department_id"] },
+    { fields: ["parent_business_unit_id"] },
     { fields: ["code", "organization_id"], unique: true },
     { fields: ["active"] }
   ],
@@ -1796,16 +1843,16 @@ var SysDepartment = data.ObjectSchema.create({
     mru: false
   }
 });
-var SysDepartmentMember = data.ObjectSchema.create({
-  name: "sys_department_member",
-  label: "Department Member",
-  pluralLabel: "Department Members",
+var SysBusinessUnitMember = data.ObjectSchema.create({
+  name: "sys_business_unit_member",
+  label: "Business Unit Member",
+  pluralLabel: "Business Unit Members",
   icon: "user-cog",
   isSystem: true,
   managedBy: "platform",
-  description: "User assignment to a department (matrix-org friendly, effective-dated).",
-  titleFormat: "{user_id} in {department_id}",
-  compactLayout: ["user_id", "department_id", "role_in_department", "is_primary"],
+  description: "User assignment to a business unit (matrix-org friendly, effective-dated).",
+  titleFormat: "{user_id} in {business_unit_id}",
+  compactLayout: ["user_id", "business_unit_id", "role_in_business_unit", "is_primary"],
   fields: {
     id: data.Field.text({
       label: "Member ID",
@@ -1813,8 +1860,8 @@ var SysDepartmentMember = data.ObjectSchema.create({
       readonly: true,
       group: "System"
     }),
-    department_id: data.Field.lookup("sys_department", {
-      label: "Department",
+    business_unit_id: data.Field.lookup("sys_business_unit", {
+      label: "Business Unit",
       required: true,
       group: "Assignment"
     }),
@@ -1823,10 +1870,10 @@ var SysDepartmentMember = data.ObjectSchema.create({
       required: true,
       group: "Assignment"
     }),
-    role_in_department: data.Field.select(
+    role_in_business_unit: data.Field.select(
       ["member", "lead", "deputy"],
       {
-        label: "Role in Department",
+        label: "Role in Business Unit",
         required: false,
         defaultValue: "member",
         description: "`lead` is the day-to-day head; `deputy` may stand in for the lead in approval routing.",
@@ -1837,7 +1884,7 @@ var SysDepartmentMember = data.ObjectSchema.create({
       label: "Primary Assignment",
       required: false,
       defaultValue: true,
-      description: "When the user is in multiple departments, this marks the canonical one for reporting.",
+      description: "When the user is in multiple business units, this marks the canonical one for reporting.",
       group: "Assignment"
     }),
     effective_from: data.Field.datetime({
@@ -1864,7 +1911,7 @@ var SysDepartmentMember = data.ObjectSchema.create({
     })
   },
   indexes: [
-    { fields: ["department_id", "user_id"], unique: true },
+    { fields: ["business_unit_id", "user_id"], unique: true },
     { fields: ["user_id"] },
     { fields: ["is_primary"] }
   ],
@@ -3112,8 +3159,8 @@ var SysJwks = data.ObjectSchema.create({
 
 exports.SysAccount = SysAccount;
 exports.SysApiKey = SysApiKey;
-exports.SysDepartment = SysDepartment;
-exports.SysDepartmentMember = SysDepartmentMember;
+exports.SysBusinessUnit = SysBusinessUnit;
+exports.SysBusinessUnitMember = SysBusinessUnitMember;
 exports.SysDeviceCode = SysDeviceCode;
 exports.SysInvitation = SysInvitation;
 exports.SysJwks = SysJwks;