@tailor-platform/erp-kit 0.5.0 → 0.6.0

package/src/modules/manufacturing/testing/fixtures.ts

@@ -0,0 +1,402 @@
+import type {
+  WorkCenter,
+  Routing,
+  RoutingOperation,
+  BillOfMaterial,
+  BillOfMaterialLine,
+  ProductionOrder,
+  ProductionOrderMaterialRequirement,
+  ProductionOrderBomSnapshot,
+  ProductionOrderRoutingSnapshot,
+  ProductionOrderCostBaseline,
+  WorkOrder,
+  WorkOrderExecutionEvent,
+  ManufacturingCostSummary,
+  ManufacturingCostLine,
+  CostVarianceLine,
+  ManufacturingCostSettlementRecord,
+  Schema,
+} from "../lib/types";
+
+// WorkCenter fixtures
+export const baseDraftWorkCenter = {
+  id: "work-center-1",
+  code: "WC-001",
+  companyId: "company-1",
+  siteId: "site-1",
+  status: "DRAFT",
+  capacityAssumptions: 100,
+  laborRate: 25.0,
+  machineRate: 50.0,
+  calendarReference: "cal-standard",
+  overheadAbsorptionMethod: null,
+  overheadAbsorptionCurrency: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies WorkCenter<Schema>;
+
+export const baseActiveWorkCenter = {
+  ...baseDraftWorkCenter,
+  id: "work-center-2",
+  code: "WC-002",
+  status: "ACTIVE",
+} as const satisfies WorkCenter<Schema>;
+
+export const baseInactiveWorkCenter = {
+  ...baseDraftWorkCenter,
+  id: "work-center-3",
+  code: "WC-003",
+  status: "INACTIVE",
+} as const satisfies WorkCenter<Schema>;
+
+// Routing fixtures
+export const baseDraftRouting = {
+  id: "routing-1",
+  parentItemId: "item-1",
+  companyId: "company-1",
+  siteId: null,
+  revisionNumber: "R1",
+  status: "DRAFT",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies Routing<Schema>;
+
+export const baseActiveRouting = {
+  ...baseDraftRouting,
+  id: "routing-2",
+  revisionNumber: "R2",
+  status: "ACTIVE",
+} as const satisfies Routing<Schema>;
+
+export const baseInactiveRouting = {
+  ...baseDraftRouting,
+  id: "routing-3",
+  revisionNumber: "R3",
+  status: "INACTIVE",
+} as const satisfies Routing<Schema>;
+
+// RoutingOperation fixtures
+export const baseRoutingOperation = {
+  id: "operation-1",
+  routingId: "routing-1",
+  sequenceNumber: 10,
+  operationDescription: "Assembly step",
+  workCenterId: "work-center-2",
+  standardSetupTime: 30,
+  standardRunTime: 60,
+  operatorInstructions: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies RoutingOperation<Schema>;
+
+export const baseRoutingOperation2 = {
+  ...baseRoutingOperation,
+  id: "operation-2",
+  sequenceNumber: 20,
+  operationDescription: "Quality check",
+  standardSetupTime: 10,
+  standardRunTime: 15,
+} as const satisfies RoutingOperation<Schema>;
+
+// BillOfMaterial fixtures
+export const baseDraftBom = {
+  id: "bom-1",
+  parentItemId: "item-1",
+  companyId: "company-1",
+  siteId: null,
+  bomType: "MANUFACTURE",
+  effectivityStartDate: null,
+  effectivityEndDate: null,
+  defaultSelection: true,
+  revisionNumber: "V1",
+  status: "DRAFT",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies BillOfMaterial<Schema>;
+
+export const baseActiveBom = {
+  ...baseDraftBom,
+  id: "bom-2",
+  revisionNumber: "V2",
+  status: "ACTIVE",
+} as const satisfies BillOfMaterial<Schema>;
+
+export const baseInactiveBom = {
+  ...baseDraftBom,
+  id: "bom-3",
+  revisionNumber: "V3",
+  status: "INACTIVE",
+} as const satisfies BillOfMaterial<Schema>;
+
+// BillOfMaterialLine fixtures
+export const baseBomLine = {
+  id: "bom-line-1",
+  billOfMaterialId: "bom-1",
+  itemId: "item-2",
+  requiredQuantity: 2.0,
+  unitOfMeasure: "EA",
+  scrapAssumption: 5.0,
+  isSubassembly: false,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies BillOfMaterialLine<Schema>;
+
+export const baseBomLine2 = {
+  ...baseBomLine,
+  id: "bom-line-2",
+  itemId: "item-3",
+  requiredQuantity: 1.0,
+  scrapAssumption: null,
+} as const satisfies BillOfMaterialLine<Schema>;
+
+// ProductionOrder fixtures
+export const baseDraftProductionOrder = {
+  id: "production-order-1",
+  orderedItemId: "item-1",
+  companyId: "company-1",
+  siteId: "site-1",
+  plannedQuantity: 100,
+  plannedStartDate: new Date("2024-03-01T00:00:00.000Z"),
+  plannedEndDate: new Date("2024-03-15T00:00:00.000Z"),
+  selectedBomVersionId: null,
+  selectedRoutingRevisionId: null,
+  status: "DRAFT",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseReleasedProductionOrder = {
+  ...baseDraftProductionOrder,
+  id: "production-order-2",
+  selectedBomVersionId: "bom-2",
+  selectedRoutingRevisionId: "routing-2",
+  status: "RELEASED",
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseInProgressProductionOrder = {
+  ...baseReleasedProductionOrder,
+  id: "production-order-3",
+  status: "IN_PROGRESS",
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseCompletedProductionOrder = {
+  ...baseReleasedProductionOrder,
+  id: "production-order-4",
+  status: "COMPLETED",
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseTechCompleteProductionOrder = {
+  ...baseReleasedProductionOrder,
+  id: "production-order-5",
+  status: "TECHNICALLY_COMPLETE",
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseClosedProductionOrder = {
+  ...baseReleasedProductionOrder,
+  id: "production-order-6",
+  status: "CLOSED",
+} as const satisfies ProductionOrder<Schema>;
+
+export const baseCancelledProductionOrder = {
+  ...baseDraftProductionOrder,
+  id: "production-order-7",
+  status: "CANCELLED",
+} as const satisfies ProductionOrder<Schema>;
+
+// ProductionOrderMaterialRequirement fixtures
+export const baseMaterialRequirement = {
+  id: "material-req-1",
+  productionOrderId: "production-order-2",
+  itemId: "item-2",
+  requiredQuantity: 200,
+  unitOfMeasure: "EA",
+  plannedUnitCost: 10.0,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ProductionOrderMaterialRequirement<Schema>;
+
+// ProductionOrderBomSnapshot fixtures
+export const baseBomSnapshot = {
+  id: "bom-snapshot-1",
+  productionOrderId: "production-order-2",
+  parentItemId: "item-1",
+  bomType: "MANUFACTURE",
+  snapshotData: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ProductionOrderBomSnapshot<Schema>;
+
+// ProductionOrderRoutingSnapshot fixtures
+export const baseRoutingSnapshot = {
+  id: "routing-snapshot-1",
+  productionOrderId: "production-order-2",
+  routingId: "routing-2",
+  snapshotData: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ProductionOrderRoutingSnapshot<Schema>;
+
+// ProductionOrderCostBaseline fixtures
+export const baseCostBaseline = {
+  id: "cost-baseline-1",
+  productionOrderId: "production-order-2",
+  plannedMaterialCost: 2000,
+  plannedLaborCost: 500,
+  plannedMachineCost: 1000,
+  plannedOverheadCost: 300,
+  currencyCode: "USD",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ProductionOrderCostBaseline<Schema>;
+
+// WorkOrder fixtures
+export const basePendingWorkOrder = {
+  id: "work-order-1",
+  productionOrderId: "production-order-2",
+  routingOperationSequenceNumber: 10,
+  workCenterId: "work-center-2",
+  plannedQuantity: 100,
+  completedQuantity: 0,
+  scrapQuantity: 0,
+  actualSetupTime: 0,
+  actualRunTime: 0,
+  actualStartDate: null,
+  pauseReason: null,
+  executionNotes: null,
+  status: "PENDING",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies WorkOrder<Schema>;
+
+export const baseInProgressWorkOrder = {
+  ...basePendingWorkOrder,
+  id: "work-order-2",
+  status: "IN_PROGRESS",
+  actualStartDate: new Date("2024-03-01T08:00:00.000Z"),
+  completedQuantity: 50,
+  actualSetupTime: 30,
+  actualRunTime: 120,
+} as const satisfies WorkOrder<Schema>;
+
+export const basePausedWorkOrder = {
+  ...baseInProgressWorkOrder,
+  id: "work-order-3",
+  status: "PAUSED",
+  pauseReason: "Machine maintenance",
+} as const satisfies WorkOrder<Schema>;
+
+export const baseCompleteWorkOrder = {
+  ...baseInProgressWorkOrder,
+  id: "work-order-4",
+  status: "COMPLETE",
+  completedQuantity: 100,
+  actualRunTime: 240,
+} as const satisfies WorkOrder<Schema>;
+
+export const baseCancelledWorkOrder = {
+  ...basePendingWorkOrder,
+  id: "work-order-5",
+  status: "CANCELLED",
+} as const satisfies WorkOrder<Schema>;
+
+// WorkOrderExecutionEvent fixtures
+export const baseStartedEvent = {
+  id: "event-1",
+  workOrderId: "work-order-2",
+  eventType: "STARTED",
+  timestamp: new Date("2024-03-01T08:00:00.000Z"),
+  quantity: null,
+  timeValue: null,
+  scrapValue: null,
+  notes: null,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies WorkOrderExecutionEvent<Schema>;
+
+export const baseProgressEvent = {
+  ...baseStartedEvent,
+  id: "event-2",
+  eventType: "PROGRESS_REPORTED",
+  timestamp: new Date("2024-03-01T10:00:00.000Z"),
+  quantity: 25,
+  timeValue: 60,
+  scrapValue: 2,
+} as const satisfies WorkOrderExecutionEvent<Schema>;
+
+// ManufacturingCostSummary fixtures
+export const baseCollectingCostSummary = {
+  id: "cost-summary-1",
+  productionOrderId: "production-order-2",
+  plannedMaterialCost: 2000,
+  plannedLaborCost: 500,
+  plannedMachineCost: 1000,
+  plannedOverheadCost: 300,
+  actualMaterialCost: 0,
+  actualLaborCost: 0,
+  actualMachineCost: 0,
+  actualOverheadCost: 0,
+  currencyCode: "USD",
+  reviewedDate: null,
+  reviewerNotes: null,
+  status: "COLLECTING",
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ManufacturingCostSummary<Schema>;
+
+export const basePendingReviewCostSummary = {
+  ...baseCollectingCostSummary,
+  id: "cost-summary-2",
+  actualMaterialCost: 2100,
+  actualLaborCost: 480,
+  actualMachineCost: 1050,
+  actualOverheadCost: 50,
+  status: "PENDING_VARIANCE_REVIEW",
+} as const satisfies ManufacturingCostSummary<Schema>;
+
+export const baseReviewedCostSummary = {
+  ...basePendingReviewCostSummary,
+  id: "cost-summary-3",
+  status: "VARIANCE_REVIEWED",
+  reviewedDate: new Date("2024-04-01T00:00:00.000Z"),
+  reviewerNotes: "Variances within acceptable range",
+} as const satisfies ManufacturingCostSummary<Schema>;
+
+export const baseSettledCostSummary = {
+  ...baseReviewedCostSummary,
+  id: "cost-summary-4",
+  status: "SETTLED",
+} as const satisfies ManufacturingCostSummary<Schema>;
+
+// ManufacturingCostLine fixtures
+export const baseCostLine = {
+  id: "cost-line-1",
+  costSummaryId: "cost-summary-1",
+  costType: "MATERIAL",
+  plannedAmount: 2000,
+  actualAmount: 0,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ManufacturingCostLine<Schema>;
+
+// CostVarianceLine fixtures
+export const baseVarianceLine = {
+  id: "variance-line-1",
+  costSummaryId: "cost-summary-3",
+  varianceType: "MATERIAL_PRICE",
+  amount: 100,
+  accountReference: "acct-5001",
+  variancePercentage: 5.0,
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies CostVarianceLine<Schema>;
+
+// ManufacturingCostSettlementRecord fixtures
+export const baseSettlementRecord = {
+  id: "settlement-1",
+  costSummaryId: "cost-summary-4",
+  settlementDate: new Date("2024-04-15T00:00:00.000Z"),
+  settlementReference: "SETTLE-2024-001",
+  acknowledgedDate: new Date("2024-04-15T00:00:00.000Z"),
+  createdAt: new Date("2024-01-01T00:00:00.000Z"),
+  updatedAt: null,
+} as const satisfies ManufacturingCostSettlementRecord<Schema>;

package/templates/scaffold/app/backend/package.json

@@ -10,7 +10,11 @@
     "lint:fix": "eslint --cache --fix .",
     "seed": "node --env-file-if-exists=.env seed/exec.mjs",
     "seed:reset": "node --env-file-if-exists=.env seed/exec.mjs --truncate --yes",
-    "typecheck": "tsc --noEmit"
+    "test": "vitest run --project unit",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "typecheck": "tsc --noEmit",
+    "gql-tada:check": "gql-tada check"
   },
   "dependencies": {
     "@tailor-platform/erp-kit": "workspace:*",
@@ -24,7 +28,10 @@
     "eslint": "10.0.3",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import-x": "4.16.2",
+    "gql.tada": "1.9.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.57.0"
+    "typescript-eslint": "8.57.0",
+    "urql": "5.0.1",
+    "vitest": "4.0.18"
   }
 }

package/templates/scaffold/app/backend/src/tests/utils/graphql-client.ts

@@ -0,0 +1,66 @@
+import { initGraphQLTada } from "gql.tada";
+import { createClient, Client, fetchExchange } from "urql";
+import type { OperationResult } from "urql";
+
+import type { introspection } from "../../../../frontend/src/graphql/generated/graphql-env.d";
+
+export const graphql = initGraphQLTada<{
+  introspection: introspection;
+  scalars: {
+    DateTime: string;
+    Date: string;
+    Time: string;
+  };
+}>();
+
+export type { FragmentOf, ResultOf, VariablesOf } from "gql.tada";
+
+export function createGraphQLClient(appUrl: string, token: string): Client {
+  const endpoint = new URL("/query", appUrl).href;
+
+  const client = createClient({
+    url: endpoint,
+    exchanges: [fetchExchange],
+    requestPolicy: "network-only",
+    preferGetMethod: false,
+    fetchOptions: () => ({
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+    }),
+  });
+
+  const wrapToPromise = <T extends OperationResult>(originalToPromise: () => Promise<T>) => {
+    return async (): Promise<T> => {
+      const result = await originalToPromise();
+      if (result.error) {
+        throw result.error;
+      }
+      return result;
+    };
+  };
+
+  return {
+    ...client,
+    mutation: <Data = unknown, Variables extends Record<string, unknown> = Record<string, unknown>>(
+      query: string,
+      variables?: Variables,
+    ) => {
+      const original = client.mutation<Data, Variables>(query, variables!);
+      return Object.assign(original, {
+        toPromise: wrapToPromise(original.toPromise.bind(original)),
+      });
+    },
+    query: <Data = unknown, Variables extends Record<string, unknown> = Record<string, unknown>>(
+      query: string,
+      variables?: Variables,
+    ) => {
+      const original = client.query<Data, Variables>(query, variables!);
+      return Object.assign(original, {
+        toPromise: wrapToPromise(original.toPromise.bind(original)),
+      });
+    },
+  } as Client;
+}

package/templates/scaffold/app/backend/src/tests/utils/setup.ts

@@ -0,0 +1,21 @@
+import type { TestProject } from "vitest/node";
+import { show, listMachineUsers, getMachineUserToken } from "@tailor-platform/sdk/cli";
+
+declare module "vitest" {
+  export interface ProvidedContext {
+    url: string;
+    token: string;
+  }
+}
+
+export async function setup(project: TestProject) {
+  const app = await show();
+  const url = app.url;
+
+  const machineUsers = await listMachineUsers();
+  const tokens = await getMachineUserToken({ name: machineUsers[0].name });
+  const token = tokens.accessToken;
+
+  project.provide("url", url);
+  project.provide("token", token);
+}

package/templates/scaffold/app/backend/tsconfig.json

@@ -10,10 +10,17 @@
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
-    "types": ["node", "@tailor-platform/function-types"],
+    "types": ["node", "@tailor-platform/function-types", "vitest/globals"],
     "paths": {
       "@/*": ["./src/*"]
-    }
+    },
+    "plugins": [
+      {
+        "name": "gql.tada/ts-plugin",
+        "schema": "../frontend/src/graphql/generated/schema.graphql",
+        "tadaOutputLocation": "../frontend/src/graphql/generated/graphql-env.d.ts"
+      }
+    ]
   },
   "include": ["**/*.ts"]
 }

package/templates/scaffold/app/backend/vitest.config.ts

@@ -0,0 +1,35 @@
+import path from "path";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+  test: {
+    watch: false,
+    passWithNoTests: true,
+    projects: [
+      {
+        extends: true,
+        test: {
+          name: "unit",
+          environment: "node",
+          include: ["./src/resolvers/**/*.test.ts"],
+          testTimeout: 30_000,
+        },
+      },
+      {
+        extends: true,
+        test: {
+          name: "integration",
+          environment: "node",
+          include: ["./src/tests/**/*.test.ts"],
+          globalSetup: ["./src/tests/utils/setup.ts"],
+          testTimeout: 60_000,
+        },
+      },
+    ],
+  },
+});

package/templates/scaffold/app/frontend/package.json

@@ -10,7 +10,7 @@
     "gql-tada:check": "gql-tada check -c tsconfig.app.json",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc -b"
   },
   "dependencies": {
     "@hookform/resolvers": "5.2.2",
@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
-    "@rolldown/plugin-babel": "0.2.1",
+    "@rolldown/plugin-babel": "0.2.2",
     "@tailor-platform/app-shell-vite-plugin": "0.1.0",
     "@tailwindcss/vite": "4.2.1",
     "@types/node": "25.5.0",

package/templates/scaffold/module/__dot__gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.eslintcache
+.tailor-sdk/

package/templates/scaffold/module/eslint.config.js

@@ -0,0 +1,31 @@
+import eslint from "@eslint/js";
+import { defineConfig, globalIgnores } from "eslint/config";
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import importX from "eslint-plugin-import-x";
+import tseslint from "typescript-eslint";
+
+export default defineConfig([
+  globalIgnores([".tailor-sdk/", "seed/", "generated/", "tailor.d.ts"]),
+  {
+    files: ["**/*.ts"],
+    extends: [
+      eslint.configs.recommended,
+      tseslint.configs.recommendedTypeChecked,
+      tseslint.configs.stylisticTypeChecked,
+      importX.flatConfigs.recommended,
+      importX.flatConfigs.typescript,
+    ],
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    settings: {
+      "import-x/resolver-next": [createTypeScriptImportResolver()],
+    },
+    rules: {
+      "import-x/order": "error",
+    },
+  },
+]);

package/templates/scaffold/module/generated/kysely-tailordb.ts

@@ -0,0 +1,3 @@
+// Stub generated by scaffold template.
+// Overwritten when running `tailor-sdk generate`.
+export type DB = Record<string, never>;

package/templates/scaffold/module/lib/types.ts

@@ -1,9 +1,4 @@
+import type { InferSchema } from "@tailor-platform/erp-kit/module";
 import type { DB } from "../generated/kysely-tailordb";
-import type {
-  InferSchema,
-  Selectable,
-  Insertable,
-  Updateable,
-} from "@tailor-platform/erp-kit/module";
 
 export type Schema = InferSchema<DB>;

package/templates/scaffold/module/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "template-module",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "generate": "tailor-sdk generate",
+    "lint": "eslint --cache .",
+    "lint:fix": "eslint --cache --fix .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@tailor-platform/erp-kit": "workspace:*",
+    "@tailor-platform/sdk": "1.25.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@tailor-platform/function-types": "0.8.2",
+    "@types/node": "24.12.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "10.0.3",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-import-x": "4.16.2",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.57.0"
+  }
+}

package/templates/scaffold/module/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "types": ["node", "@tailor-platform/function-types"]
+  },
+  "include": ["**/*.ts"]
+}