@hed-hog/operations 0.0.2 → 0.0.285

package/hedhog/table/operations_task.yaml

@@ -0,0 +1,60 @@
+columns:
+  - type: pk
+  - name: project_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_project
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: assignee_employee_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_employee
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: external_reference
+    type: varchar
+    length: 80
+    isNullable: true
+  - name: title
+    type: varchar
+    length: 180
+  - name: description
+    type: text
+    isNullable: true
+  - name: status
+    type: enum
+    values: [backlog, todo, in_progress, review, done, canceled]
+    default: backlog
+  - name: priority
+    type: enum
+    values: [low, medium, high, urgent]
+    default: medium
+  - name: estimated_hours
+    type: decimal
+    precision: 6
+    scale: 2
+    isNullable: true
+  - name: due_date
+    type: date
+    isNullable: true
+  - name: completed_at
+    type: datetime
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [project_id]
+  - columns: [assignee_employee_id]
+  - columns: [status]
+  - columns: [priority]
+  - columns: [due_date]
+  - columns: [deleted_at]

package/hedhog/table/operations_timesheet.yaml

@@ -0,0 +1,49 @@
+columns:
+  - type: pk
+  - name: employee_id
+    type: fk
+    references:
+      table: operations_employee
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: approver_employee_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_employee
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: cycle_start_date
+    type: date
+  - name: cycle_end_date
+    type: date
+  - name: status
+    type: enum
+    values: [draft, submitted, approved, rejected]
+    default: draft
+  - name: submitted_at
+    type: datetime
+    isNullable: true
+  - name: reviewed_at
+    type: datetime
+    isNullable: true
+  - name: notes
+    type: text
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [employee_id]
+  - columns: [approver_employee_id]
+  - columns: [status]
+  - columns: [cycle_start_date]
+  - columns: [cycle_end_date]
+  - columns: [employee_id, cycle_start_date, cycle_end_date]
+    isUnique: true
+  - columns: [deleted_at]

package/hedhog/table/operations_timesheet_entry.yaml

@@ -0,0 +1,51 @@
+columns:
+  - type: pk
+  - name: timesheet_id
+    type: fk
+    references:
+      table: operations_timesheet
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: project_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_project
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: task_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_task
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: work_date
+    type: date
+  - name: hours
+    type: decimal
+    precision: 6
+    scale: 2
+  - name: description
+    type: text
+    isNullable: true
+  - name: approval_status
+    type: enum
+    values: [pending, approved, rejected]
+    default: pending
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [timesheet_id]
+  - columns: [project_id]
+  - columns: [task_id]
+  - columns: [work_date]
+  - columns: [approval_status]
+  - columns: [deleted_at]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/operations",
-  "version": "0.0.2",
+  "version": "0.0.285",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,10 +9,10 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api": "0.0.4",
-    "@hed-hog/api-locale": "0.0.13",
     "@hed-hog/api-prisma": "0.0.5",
     "@hed-hog/api-types": "0.0.1",
+    "@hed-hog/api-locale": "0.0.13",
+    "@hed-hog/api": "0.0.4",
     "@hed-hog/api-pagination": "0.0.6"
   },
   "exports": {

package/src/index.ts

@@ -1 +1,2 @@
-export * from './operations.module';
+export * from './operations.module';
+export * from './operations.service';

package/src/language/en.json

@@ -1,8 +1,8 @@
-{
-  "HomePage": {
-    "title": "Operations",
-    "description": "Manage your operations.",
-    "breadcrumbHome": "Home",
-    "breadcrumbCurrent": "Operations"
-  }
-}
+{
+  "HomePage": {
+    "title": "Operations",
+    "description": "Manage your operations.",
+    "breadcrumbHome": "Home",
+    "breadcrumbCurrent": "Operations"
+  }
+}

package/src/language/pt.json

@@ -1,8 +1,8 @@
-{
-  "HomePage": {
-    "title": "Operations",
-    "description": "Gerencie seu operations.",
-    "breadcrumbHome": "Inicio",
-    "breadcrumbCurrent": "Operations"
-  }
-}
+{
+  "HomePage": {
+    "title": "Operations",
+    "description": "Gerencie seu operations.",
+    "breadcrumbHome": "Inicio",
+    "breadcrumbCurrent": "Operations"
+  }
+}

package/src/operations-data.controller.ts

@@ -0,0 +1,54 @@
+import { Role } from '@hed-hog/api';
+import { Controller, Get, Param, ParseIntPipe } from '@nestjs/common';
+import { OperationsService } from './operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsDataController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get()
+  getDashboard() {
+    return this.operationsService.getDashboard();
+  }
+
+  @Get('contracts')
+  listContracts() {
+    return this.operationsService.listContracts();
+  }
+
+  @Get('contracts/:id')
+  getContract(@Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getContractById(id);
+  }
+
+  @Get('projects')
+  listProjects() {
+    return this.operationsService.listProjects();
+  }
+
+  @Get('projects/:id')
+  getProject(@Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getProjectById(id);
+  }
+
+  @Get('allocations')
+  listAllocations() {
+    return this.operationsService.listAllocations();
+  }
+
+  @Get('tasks')
+  listTasks() {
+    return this.operationsService.listTasks();
+  }
+
+  @Get('timesheets')
+  listTimesheets() {
+    return this.operationsService.listTimesheets();
+  }
+
+  @Get('approvals')
+  listApprovals() {
+    return this.operationsService.listApprovals();
+  }
+}

package/src/operations-growth.controller.ts

@@ -0,0 +1,44 @@
+import { Role } from '@hed-hog/api';
+import { Controller, Get } from '@nestjs/common';
+import { OperationsService } from './operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsGrowthController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('growth')
+  getGrowthDashboard() {
+    return this.operationsService.getGrowthDashboard();
+  }
+
+  @Get('evaluations')
+  listEvaluations() {
+    return this.operationsService.listEvaluations();
+  }
+
+  @Get('goals')
+  listGoals() {
+    return this.operationsService.listGoals();
+  }
+
+  @Get('certifications')
+  listCertifications() {
+    return this.operationsService.listCertifications();
+  }
+
+  @Get('rewards')
+  listRewards() {
+    return this.operationsService.listRewards();
+  }
+
+  @Get('career')
+  listCareerPaths() {
+    return this.operationsService.listCareerPaths();
+  }
+
+  @Get('manager')
+  getManagerOverview() {
+    return this.operationsService.getManagerOverview();
+  }
+}

package/src/operations.module.ts

@@ -1,15 +1,21 @@
-import { forwardRef, Module } from '@nestjs/common';
-import { ConfigModule } from '@nestjs/config';
-import { LocaleModule } from '@hed-hog/api-locale';
-import { PaginationModule } from '@hed-hog/api-pagination';
-import { PrismaModule } from '@hed-hog/api-prisma';
-
-@Module({
-  imports: [
-    ConfigModule.forRoot(),
-    forwardRef(() => PaginationModule),
-    forwardRef(() => PrismaModule),
-    forwardRef(() => LocaleModule)
-  ]
-})
-export class OperationsModule {}
+import { LocaleModule } from '@hed-hog/api-locale';
+import { PaginationModule } from '@hed-hog/api-pagination';
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { forwardRef, Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { OperationsDataController } from './operations-data.controller';
+import { OperationsGrowthController } from './operations-growth.controller';
+import { OperationsService } from './operations.service';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot(),
+    forwardRef(() => PaginationModule),
+    forwardRef(() => PrismaModule),
+    forwardRef(() => LocaleModule),
+  ],
+  controllers: [OperationsDataController, OperationsGrowthController],
+  providers: [OperationsService],
+  exports: [OperationsService],
+})
+export class OperationsModule {}

package/src/operations.service.ts

@@ -0,0 +1,137 @@
+import { Injectable } from '@nestjs/common';
+
+const operationalCollections = {
+  contracts: [
+    { id: 1, code: 'CTR-001', name: 'Northwind Retainer', status: 'active' },
+    { id: 2, code: 'CTR-002', name: 'BluePeak Migration', status: 'renewal' },
+  ],
+  projects: [
+    { id: 1, code: 'PRJ-OPS-1', name: 'Phoenix Platform Rollout', status: 'active' },
+    { id: 2, code: 'PRJ-OPS-2', name: 'Northwind Service Desk', status: 'at_risk' },
+  ],
+  allocations: [
+    { id: 1, employeeId: 1, projectId: 1, weeklyHours: 30, allocationPercent: 75 },
+    { id: 2, employeeId: 2, projectId: 2, weeklyHours: 20, allocationPercent: 50 },
+  ],
+  tasks: [
+    { id: 1, title: 'Deploy onboarding workflow', status: 'review' },
+    { id: 2, title: 'Refine support KPI dashboard', status: 'in_progress' },
+  ],
+  timesheets: [
+    { id: 1, employeeId: 1, status: 'submitted', cycleStartDate: '2026-03-09' },
+    { id: 2, employeeId: 2, status: 'approved', cycleStartDate: '2026-03-09' },
+  ],
+  approvals: [
+    { id: 1, employeeId: 1, status: 'pending', hours: 8 },
+    { id: 2, employeeId: 3, status: 'pending', hours: 6.5 },
+  ],
+};
+
+const growthCollections = {
+  growth: {
+    topSignals: ['score_events', 'career_tracks', 'goals', 'recognitions'],
+    note: 'Foundation endpoint for the employee growth dashboard.',
+  },
+  evaluations: [
+    { id: 1, employeeId: 1, cycle: '2026 H1 Growth Cycle', status: 'finalized', generatedScore: 84 },
+    { id: 2, employeeId: 2, cycle: '2026 Delivery Sprint Review', status: 'submitted', generatedScore: 72 },
+  ],
+  goals: [
+    { id: 1, employeeId: 1, title: 'Reduce rework under 5%', status: 'active', progressPercent: 68 },
+    { id: 2, employeeId: 2, title: 'Close Scrum certification', status: 'at_risk', progressPercent: 35 },
+  ],
+  certifications: [
+    { id: 1, slug: 'scrum-master-foundations', status: 'achieved' },
+    { id: 2, slug: 'advanced-quality-assurance', status: 'planned' },
+  ],
+  rewards: [
+    { id: 1, employeeId: 1, rewardType: 'bonus', status: 'granted' },
+    { id: 2, employeeId: 3, rewardType: 'recognition', status: 'granted' },
+  ],
+  career: [
+    { id: 1, track: 'Delivery', currentLevel: 'Consultant', nextLevel: 'Senior Consultant' },
+    { id: 2, track: 'Specialist', currentLevel: 'Specialist II', nextLevel: 'Principal Specialist' },
+  ],
+  manager: {
+    summary: {
+      promotionEligible: 2,
+      goalsAtRisk: 3,
+      pendingCertifications: 4,
+    },
+  },
+};
+
+@Injectable()
+export class OperationsService {
+  // TODO: Replace static collections with Prisma queries after the first schema apply.
+  // TODO: Promotion must not be derived from score alone; score remains only a support signal.
+  // TODO: Certifications are supporting evidence and do not guarantee promotion on their own.
+  // TODO: Future readiness logic must consider individual, team, and org impact, plus time operating at the next level and calibration outcomes.
+  getDashboard() {
+    return {
+      module: 'operations',
+      operationalCollections,
+      growthCollections,
+    };
+  }
+
+  listContracts() {
+    return operationalCollections.contracts;
+  }
+
+  getContractById(id: number) {
+    return operationalCollections.contracts.find((item) => item.id === id) ?? null;
+  }
+
+  listProjects() {
+    return operationalCollections.projects;
+  }
+
+  getProjectById(id: number) {
+    return operationalCollections.projects.find((item) => item.id === id) ?? null;
+  }
+
+  listAllocations() {
+    return operationalCollections.allocations;
+  }
+
+  listTasks() {
+    return operationalCollections.tasks;
+  }
+
+  listTimesheets() {
+    return operationalCollections.timesheets;
+  }
+
+  listApprovals() {
+    return operationalCollections.approvals;
+  }
+
+  getGrowthDashboard() {
+    return growthCollections.growth;
+  }
+
+  listEvaluations() {
+    return growthCollections.evaluations;
+  }
+
+  listGoals() {
+    return growthCollections.goals;
+  }
+
+  listCertifications() {
+    return growthCollections.certifications;
+  }
+
+  listRewards() {
+    return growthCollections.rewards;
+  }
+
+  listCareerPaths() {
+    return growthCollections.career;
+  }
+
+  getManagerOverview() {
+    return growthCollections.manager;
+  }
+}