Vendor and Procurement Management

// Vendor Evaluation Scoring Matrix
interface VendorEvaluation {
  vendorName: string;
  categories: {
    category: string;
    weight: number; // 1-5 importance
    criteria: {
      name: string;
      score: number; // 1-5
      notes: string;
    }[];
  }[];
  totalScore: number;
  recommendation: 'select' | 'shortlist' | 'reject';
}

function calculateVendorScore(evaluation: VendorEvaluation): number {
  let weightedSum = 0;
  let totalWeight = 0;

  for (const category of evaluation.categories) {
    const categoryAvg = category.criteria.reduce((sum, c) => sum + c.score, 0) / category.criteria.length;
    weightedSum += categoryAvg * category.weight;
    totalWeight += category.weight;
  }

  return Math.round((weightedSum / totalWeight) * 100) / 100;
}

// Example vendor comparison
const vendorComparison: VendorEvaluation[] = [
  {
    vendorName: 'Vendor A - Stripe',
    categories: [
      {
        category: 'Functionality',
        weight: 5,
        criteria: [
          { name: 'Payment methods supported', score: 5, notes: 'Cards, wallets, bank transfers, BNPL' },
          { name: 'International support', score: 5, notes: '46 countries, 135+ currencies' },
          { name: 'Subscription billing', score: 5, notes: 'Full-featured recurring billing' },
          { name: 'Fraud detection', score: 4, notes: 'Stripe Radar included' },
        ]
      },
      {
        category: 'Technical Integration',
        weight: 4,
        criteria: [
          { name: 'API quality', score: 5, notes: 'Best-in-class documentation and SDKs' },
          { name: 'Webhook reliability', score: 5, notes: 'Reliable with retry logic' },
          { name: 'Testing tools', score: 5, notes: 'Test mode, CLI, fixtures' },
        ]
      },
      {
        category: 'Pricing',
        weight: 3,
        criteria: [
          { name: 'Transaction fees', score: 3, notes: '2.9% + 30c per transaction' },
          { name: 'Volume discounts', score: 4, notes: 'Available above $1M/year' },
        ]
      },
      {
        category: 'Support & Reliability',
        weight: 4,
        criteria: [
          { name: 'Uptime SLA', score: 5, notes: '99.99% uptime' },
          { name: 'Support quality', score: 4, notes: '24/7 for premium plans' },
          { name: 'Vendor stability', score: 5, notes: 'Public company, strong financials' },
        ]
      }
    ],
    totalScore: 0,
    recommendation: 'select'
  }
];

// Contract types
type ContractType = {
  name: string;
  riskAllocation: string;
  bestFor: string;
  pmConsideration: string;
};

const contractTypes: ContractType[] = [
  {
    name: 'Fixed Price',
    riskAllocation: 'Vendor bears cost overrun risk',
    bestFor: 'Well-defined scope, clear deliverables',
    pmConsideration: 'Requires detailed requirements upfront. Change orders are expensive.'
  },
  {
    name: 'Time & Materials (T&M)',
    riskAllocation: 'Buyer bears cost overrun risk',
    bestFor: 'Evolving scope, R&D work, staff augmentation',
    pmConsideration: 'Need strong oversight. Set budget ceilings and review milestones.'
  },
  {
    name: 'Cost-Reimbursable',
    riskAllocation: 'Buyer bears most risk',
    bestFor: 'Highly uncertain scope (research, innovation)',
    pmConsideration: 'Audit costs regularly. Set not-to-exceed limits.'
  }
];