@theromans/convex-dobty 0.1.0

package/src/data/types.ts

@@ -0,0 +1,183 @@
+/**
+ * Shared TypeScript interfaces for the DOBT+ Excellence Rating model.
+ */
+
+// ── Domain & Dimension ──
+
+export type DomainKey = "KM" | "EK" | "DM";
+
+export interface DomainDef {
+  key: DomainKey;
+  label: string;
+  labelEn: string;
+  dimensions: DimensionDef[];
+  maxScore: number;
+}
+
+export interface DimensionDef {
+  key: string;
+  domain: DomainKey;
+  label: string;
+  labelEn: string;
+  scoringSource: "expert" | "methods" | "systems" | "guidelines";
+  aggregationMethod: "direct" | "sumproduct" | "average";
+  pmNpmSplit: boolean;
+}
+
+// ── Maturity Scale ──
+
+export type MaturityLevel = "informativ" | "steuernd" | "integrativ" | "world_class";
+
+export interface MaturityLevelDef {
+  level: number;
+  key: MaturityLevel;
+  label: string;
+  labelEn: string;
+  min: number;
+  max: number;
+}
+
+// ── Methods / Systems / Guidelines ──
+
+export interface ItemDef {
+  key: string;
+  label: string;
+  labelEn?: string;
+  dimension: string;
+  domain: DomainKey;
+  category: "method" | "system" | "guideline";
+  /** Per-level weights [w1, w2, w3] — determines scoring potential */
+  weights: [number, number, number];
+  /** Which complexity levels this item applies to [commodity, special, big, complex] */
+  complexityRelevance: [number, number, number, number];
+  /** EK PM/NPM classification ("both" = applies to PM and NPM) */
+  pmNpm?: "pm" | "npm" | "both";
+  sortOrder: number;
+}
+
+// ── CVR Weight Tables ──
+
+export type ValueCategory =
+  | "overhead"
+  | "direct_cost"
+  | "additional_business"
+  | "innovation"
+  | "risk";
+
+export const VALUE_CATEGORIES: ValueCategory[] = [
+  "overhead",
+  "direct_cost",
+  "additional_business",
+  "innovation",
+  "risk",
+];
+
+/** Per-dimension CVR weights at World Class level */
+export type CvrWeightRow = Record<ValueCategory, number>;
+
+/** Maps dimension key → World Class CVR weights */
+export type CvrWeightTable = Record<string, CvrWeightRow>;
+
+/** Per-level buildup: maps dimension → level (1-4) → weights */
+export type CvrBuildupTable = Record<string, Record<number, CvrWeightRow>>;
+
+// ── Implementation Factors ──
+
+export type ImplementationFactorTable = Record<string, CvrWeightRow>;
+
+// ── Financial Inputs ──
+
+export interface FinancialInputs {
+  revenue: number;
+  cost_volume: number;
+  manufacturing_costs: number;
+  complexity: 1 | 2 | 3 | 4;
+  headcount_km?: number;
+  direct_material?: number;
+  indirect_material?: number;
+  headcount_ek?: number;
+  headcount_npm?: number;
+}
+
+// ── Sensitivity & Lifetime ──
+
+export interface SensitivityConfig {
+  revenue_to_margin: number;
+  efficiency_to_margin: number;
+  risk_to_margin: number;
+  innovation_to_margin: number;
+  direct_cost_to_margin: number;
+}
+
+export interface LifetimeConfig {
+  year_1: number;
+  year_2: number;
+  year_3: number;
+}
+
+export const DEFAULT_SENSITIVITY: SensitivityConfig = {
+  revenue_to_margin: 0.06,
+  efficiency_to_margin: 0.45,
+  risk_to_margin: 0.25,
+  innovation_to_margin: 0.10,
+  direct_cost_to_margin: 1.00,
+};
+
+export const DEFAULT_LIFETIME: LifetimeConfig = {
+  year_1: 0.10,
+  year_2: 0.35,
+  year_3: 0.55,
+};
+
+// ── Sub-Question Pattern ──
+
+export type SubQuestionKey =
+  | "bekannt"
+  | "in_anwendung"
+  | "definiert"
+  | "verankert"
+  | "schulungen";
+
+/** The 5 sub-questions for each method/system/guideline item */
+export interface Sub5Value {
+  bekannt: boolean;
+  in_anwendung: boolean;
+  definiert: boolean;
+  verankert: string | null;
+  schulungen: boolean;
+}
+
+// ── Answer Schema Types ──
+
+export type AnswerSchema = "sub5" | "scale04" | "numeric" | "dropdown" | "text";
+
+// ── Question Definition (for seeding) ──
+
+export interface QuestionDef {
+  questionKey: string;
+  domain: DomainKey;
+  dimension: string;
+  category: "method" | "system" | "guideline" | "expert" | "stammdaten";
+  itemKey: string;
+  label: string;
+  labelEn?: string;
+  answerSchema: AnswerSchema;
+  options?: unknown;
+  pmNpm?: "pm" | "npm" | "both";
+  sortOrder: number;
+}
+
+// ── Stammdaten (Dropdown Definitions) ──
+
+export interface StammdatenOption {
+  key: string;
+  label: string;
+  labelEn?: string;
+}
+
+export interface StammdatenCategory {
+  key: string;
+  label: string;
+  labelEn?: string;
+  options: StammdatenOption[];
+}