business-as-code 2.3.0 → 2.4.0

package/dist/entities/organization.js

@@ -0,0 +1,816 @@
+/**
+ * Organization Entity Types (Nouns)
+ *
+ * Organizational hierarchy: Organization, Department, Team, Position, Role.
+ *
+ * Uses digital-workers Worker type for position holders.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Organization
+// =============================================================================
+/**
+ * Organization entity
+ *
+ * Represents the top-level organizational structure.
+ */
+export const Organization = {
+    singular: 'organization',
+    plural: 'organizations',
+    description: 'The top-level organizational structure',
+    properties: {
+        // Identity
+        name: {
+            type: 'string',
+            description: 'Organization name',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Organization description',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Organization type',
+            examples: ['functional', 'divisional', 'matrix', 'flat', 'holacracy'],
+        },
+        // Settings
+        fiscalYearStart: {
+            type: 'string',
+            optional: true,
+            description: 'Fiscal year start month (e.g., "January", "April")',
+        },
+        defaultCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Default currency code',
+            examples: ['USD', 'EUR', 'GBP'],
+        },
+        defaultTimezone: {
+            type: 'string',
+            optional: true,
+            description: 'Default timezone',
+        },
+        // Size
+        departmentCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of departments',
+        },
+        teamCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of teams',
+        },
+        positionCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of positions',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Organization status',
+            examples: ['active', 'restructuring', 'archived'],
+        },
+    },
+    relationships: {
+        business: {
+            type: 'Business',
+            description: 'Parent business',
+        },
+        departments: {
+            type: 'Department[]',
+            description: 'Departments',
+        },
+        teams: {
+            type: 'Team[]',
+            description: 'All teams',
+        },
+        positions: {
+            type: 'Position[]',
+            description: 'All positions',
+        },
+        roles: {
+            type: 'Role[]',
+            description: 'Defined roles',
+        },
+    },
+    actions: ['create', 'update', 'restructure', 'merge', 'split', 'archive'],
+    events: ['created', 'updated', 'restructured', 'merged', 'split', 'archived'],
+};
+// =============================================================================
+// Department
+// =============================================================================
+/**
+ * Department entity
+ *
+ * Represents a functional department or division.
+ */
+export const Department = {
+    singular: 'department',
+    plural: 'departments',
+    description: 'A functional department or division',
+    properties: {
+        // Identity
+        name: {
+            type: 'string',
+            description: 'Department name',
+        },
+        code: {
+            type: 'string',
+            optional: true,
+            description: 'Department code (e.g., "ENG", "MKT")',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Department description',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Department type',
+            examples: [
+                'engineering',
+                'product',
+                'design',
+                'marketing',
+                'sales',
+                'operations',
+                'finance',
+                'hr',
+                'legal',
+                'support',
+            ],
+        },
+        // Budget
+        budget: {
+            type: 'number',
+            optional: true,
+            description: 'Annual budget',
+        },
+        budgetCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Budget currency',
+        },
+        budgetPeriod: {
+            type: 'string',
+            optional: true,
+            description: 'Budget period',
+            examples: ['monthly', 'quarterly', 'yearly'],
+        },
+        // Size
+        headcount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of employees',
+        },
+        teamCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of teams',
+        },
+        // Hierarchy
+        level: {
+            type: 'number',
+            optional: true,
+            description: 'Organizational level (1 = top)',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Department status',
+            examples: ['active', 'forming', 'restructuring', 'dissolved'],
+        },
+    },
+    relationships: {
+        organization: {
+            type: 'Organization',
+            description: 'Parent organization',
+        },
+        parent: {
+            type: 'Department',
+            required: false,
+            description: 'Parent department (for sub-departments)',
+        },
+        children: {
+            type: 'Department[]',
+            description: 'Sub-departments',
+        },
+        head: {
+            type: 'Position',
+            required: false,
+            description: 'Department head position',
+        },
+        teams: {
+            type: 'Team[]',
+            description: 'Teams in this department',
+        },
+        goals: {
+            type: 'Goal[]',
+            description: 'Department goals',
+        },
+        budgets: {
+            type: 'Budget[]',
+            description: 'Budget allocations',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'rename',
+        'setBudget',
+        'addTeam',
+        'removeTeam',
+        'setHead',
+        'merge',
+        'split',
+        'dissolve',
+        'archive',
+    ],
+    events: [
+        'created',
+        'updated',
+        'renamed',
+        'budgetSet',
+        'teamAdded',
+        'teamRemoved',
+        'headChanged',
+        'merged',
+        'split',
+        'dissolved',
+        'archived',
+    ],
+};
+// =============================================================================
+// Team
+// =============================================================================
+/**
+ * Team entity
+ *
+ * Represents a working team within a department.
+ */
+export const Team = {
+    singular: 'team',
+    plural: 'teams',
+    description: 'A working team within a department',
+    properties: {
+        // Identity
+        name: {
+            type: 'string',
+            description: 'Team name',
+        },
+        code: {
+            type: 'string',
+            optional: true,
+            description: 'Team code',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Team description',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Team type',
+            examples: ['product', 'platform', 'growth', 'infrastructure', 'support', 'project', 'tiger'],
+        },
+        methodology: {
+            type: 'string',
+            optional: true,
+            description: 'Working methodology',
+            examples: ['scrum', 'kanban', 'scrumban', 'waterfall', 'hybrid'],
+        },
+        // Size
+        capacity: {
+            type: 'number',
+            optional: true,
+            description: 'Team capacity (FTE)',
+        },
+        headcount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of members',
+        },
+        // Communication
+        slackChannel: {
+            type: 'string',
+            optional: true,
+            description: 'Slack channel',
+        },
+        email: {
+            type: 'string',
+            optional: true,
+            description: 'Team email',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Team status',
+            examples: ['active', 'forming', 'storming', 'norming', 'performing', 'adjourning'],
+        },
+    },
+    relationships: {
+        department: {
+            type: 'Department',
+            description: 'Parent department',
+        },
+        lead: {
+            type: 'Position',
+            required: false,
+            description: 'Team lead position',
+        },
+        positions: {
+            type: 'Position[]',
+            description: 'Team positions',
+        },
+        projects: {
+            type: 'Project[]',
+            description: 'Active projects',
+        },
+        workflows: {
+            type: 'Workflow[]',
+            description: 'Team workflows',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'rename',
+        'setLead',
+        'addMember',
+        'removeMember',
+        'setCapacity',
+        'assignProject',
+        'unassignProject',
+        'archive',
+    ],
+    events: [
+        'created',
+        'updated',
+        'renamed',
+        'leadChanged',
+        'memberAdded',
+        'memberRemoved',
+        'capacityChanged',
+        'projectAssigned',
+        'projectUnassigned',
+        'archived',
+    ],
+};
+// =============================================================================
+// Position
+// =============================================================================
+/**
+ * Position entity
+ *
+ * Represents a position/job within the organization.
+ */
+export const Position = {
+    singular: 'position',
+    plural: 'positions',
+    description: 'A position or job within the organization',
+    properties: {
+        // Identity
+        title: {
+            type: 'string',
+            description: 'Position title',
+        },
+        code: {
+            type: 'string',
+            optional: true,
+            description: 'Position code',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Position description',
+        },
+        // Classification
+        level: {
+            type: 'string',
+            optional: true,
+            description: 'Job level',
+            examples: [
+                'intern',
+                'junior',
+                'mid',
+                'senior',
+                'staff',
+                'principal',
+                'director',
+                'vp',
+                'c-level',
+            ],
+        },
+        track: {
+            type: 'string',
+            optional: true,
+            description: 'Career track',
+            examples: ['individual-contributor', 'management', 'executive'],
+        },
+        grade: {
+            type: 'string',
+            optional: true,
+            description: 'Pay grade',
+        },
+        // Type
+        employmentType: {
+            type: 'string',
+            optional: true,
+            description: 'Employment type',
+            examples: ['full-time', 'part-time', 'contract', 'intern', 'advisor'],
+        },
+        workLocation: {
+            type: 'string',
+            optional: true,
+            description: 'Work location type',
+            examples: ['remote', 'office', 'hybrid'],
+        },
+        // Compensation
+        salaryMin: {
+            type: 'number',
+            optional: true,
+            description: 'Minimum salary',
+        },
+        salaryMax: {
+            type: 'number',
+            optional: true,
+            description: 'Maximum salary',
+        },
+        salaryCurrency: {
+            type: 'string',
+            optional: true,
+            description: 'Salary currency',
+        },
+        equityMin: {
+            type: 'number',
+            optional: true,
+            description: 'Minimum equity percentage',
+        },
+        equityMax: {
+            type: 'number',
+            optional: true,
+            description: 'Maximum equity percentage',
+        },
+        // Capacity
+        fte: {
+            type: 'number',
+            optional: true,
+            description: 'Full-time equivalent (0-1)',
+        },
+        // Requirements
+        requirements: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Position requirements',
+        },
+        skills: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Required skills',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Position status',
+            examples: ['open', 'filled', 'frozen', 'eliminated'],
+        },
+    },
+    relationships: {
+        team: {
+            type: 'Team',
+            description: 'Parent team',
+        },
+        role: {
+            type: 'Role',
+            description: 'Assigned role',
+        },
+        reportsTo: {
+            type: 'Position',
+            required: false,
+            description: 'Reports to position',
+        },
+        directReports: {
+            type: 'Position[]',
+            description: 'Direct reports',
+        },
+        holder: {
+            type: 'Worker',
+            required: false,
+            description: 'Current position holder',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'open',
+        'fill',
+        'freeze',
+        'eliminate',
+        'transfer',
+        'promote',
+        'setCompensation',
+        'archive',
+    ],
+    events: [
+        'created',
+        'updated',
+        'opened',
+        'filled',
+        'frozen',
+        'eliminated',
+        'transferred',
+        'promoted',
+        'compensationChanged',
+        'archived',
+    ],
+};
+// =============================================================================
+// Role
+// =============================================================================
+/**
+ * Role entity
+ *
+ * Represents a role with permissions and capabilities.
+ */
+export const Role = {
+    singular: 'role',
+    plural: 'roles',
+    description: 'A role with permissions and capabilities',
+    properties: {
+        // Identity
+        name: {
+            type: 'string',
+            description: 'Role name',
+        },
+        code: {
+            type: 'string',
+            optional: true,
+            description: 'Role code',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Role description',
+        },
+        // Type
+        type: {
+            type: 'string',
+            optional: true,
+            description: 'Role type',
+            examples: ['executive', 'manager', 'lead', 'contributor', 'specialist', 'support'],
+        },
+        // Permissions
+        permissions: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Granted permissions',
+        },
+        capabilities: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Role capabilities',
+        },
+        // Approval
+        approvalLevel: {
+            type: 'number',
+            optional: true,
+            description: 'Approval authority level',
+        },
+        approvalLimit: {
+            type: 'number',
+            optional: true,
+            description: 'Approval spending limit',
+        },
+        // Hierarchy
+        level: {
+            type: 'number',
+            optional: true,
+            description: 'Role hierarchy level',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Role status',
+            examples: ['active', 'deprecated'],
+        },
+    },
+    relationships: {
+        organization: {
+            type: 'Organization',
+            description: 'Parent organization',
+        },
+        parent: {
+            type: 'Role',
+            required: false,
+            description: 'Parent role (inherits permissions)',
+        },
+        children: {
+            type: 'Role[]',
+            description: 'Child roles',
+        },
+        positions: {
+            type: 'Position[]',
+            description: 'Positions with this role',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'grantPermission',
+        'revokePermission',
+        'setApprovalLimit',
+        'deprecate',
+        'archive',
+    ],
+    events: [
+        'created',
+        'updated',
+        'permissionGranted',
+        'permissionRevoked',
+        'approvalLimitChanged',
+        'deprecated',
+        'archived',
+    ],
+};
+// =============================================================================
+// Worker
+// =============================================================================
+/**
+ * Worker entity
+ *
+ * Represents a human employee or AI agent that fills a position.
+ */
+export const Worker = {
+    singular: 'worker',
+    plural: 'workers',
+    description: 'A human employee or AI agent that fills a position',
+    properties: {
+        // Identity
+        name: {
+            type: 'string',
+            description: 'Worker name',
+        },
+        email: {
+            type: 'string',
+            optional: true,
+            description: 'Email address',
+        },
+        avatarUrl: {
+            type: 'url',
+            optional: true,
+            description: 'Avatar URL',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Worker type',
+            examples: ['human', 'agent'],
+        },
+        // Human-specific
+        firstName: {
+            type: 'string',
+            optional: true,
+            description: 'First name',
+        },
+        lastName: {
+            type: 'string',
+            optional: true,
+            description: 'Last name',
+        },
+        phone: {
+            type: 'string',
+            optional: true,
+            description: 'Phone number',
+        },
+        location: {
+            type: 'string',
+            optional: true,
+            description: 'Work location',
+        },
+        timezone: {
+            type: 'string',
+            optional: true,
+            description: 'Timezone',
+        },
+        startDate: {
+            type: 'date',
+            optional: true,
+            description: 'Start date',
+        },
+        // Agent-specific
+        agentId: {
+            type: 'string',
+            optional: true,
+            description: 'AI agent identifier',
+        },
+        modelId: {
+            type: 'string',
+            optional: true,
+            description: 'AI model identifier',
+        },
+        capabilities: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Agent capabilities',
+        },
+        // Availability
+        availability: {
+            type: 'string',
+            optional: true,
+            description: 'Availability status',
+            examples: ['available', 'busy', 'away', 'offline'],
+        },
+        capacity: {
+            type: 'number',
+            optional: true,
+            description: 'Available capacity (0-1)',
+        },
+        // Status
+        status: {
+            type: 'string',
+            optional: true,
+            description: 'Worker status',
+            examples: ['active', 'onboarding', 'on-leave', 'offboarding', 'inactive'],
+        },
+    },
+    relationships: {
+        position: {
+            type: 'Position',
+            required: false,
+            description: 'Current position',
+        },
+        manager: {
+            type: 'Worker',
+            required: false,
+            description: 'Direct manager',
+        },
+        directReports: {
+            type: 'Worker[]',
+            description: 'Direct reports',
+        },
+        tasks: {
+            type: 'Task[]',
+            description: 'Assigned tasks',
+        },
+    },
+    actions: [
+        'create',
+        'update',
+        'onboard',
+        'assign',
+        'reassign',
+        'setAvailability',
+        'promote',
+        'transfer',
+        'offboard',
+        'archive',
+    ],
+    events: [
+        'created',
+        'updated',
+        'onboarded',
+        'assigned',
+        'reassigned',
+        'availabilityChanged',
+        'promoted',
+        'transferred',
+        'offboarded',
+        'archived',
+    ],
+};
+// =============================================================================
+// Exports
+// =============================================================================
+export const OrganizationEntities = {
+    Organization,
+    Department,
+    Team,
+    Position,
+    Role,
+    Worker,
+};
+export const OrganizationCategories = {
+    structure: ['Organization', 'Department', 'Team'],
+    people: ['Position', 'Role', 'Worker'],
+};
+//# sourceMappingURL=organization.js.map