business-as-code 2.1.3 → 2.3.0

package/src/entities/organization.js

@@ -1,806 +0,0 @@
-/**
- * Organization Entity Types (Nouns)
- *
- * Organizational hierarchy: Organization, Department, Team, Position, Role.
- *
- * @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'],
-};