Merge branch 'feat/sla-computer' into chore/all-my-stuffs

# Conflicts:
#	components.d.ts
#	package.json
#	pnpm-lock.yaml
#	src/tools/index.ts

Author: sharevb

package.json

@@ -79,6 +79,7 @@
     "@tiptap/starter-kit": "2.1.6",
     "@tiptap/vue-3": "2.0.3",
     "@types/emscripten": "^1.39.10",
+    "@types/big.js": "^6.2.2",
     "@types/figlet": "^1.5.8",
     "@types/markdown-it": "^13.0.7",
     "@types/potrace": "^2.1.5",
@@ -95,6 +96,7 @@
     "@zxing/library": "^0.21.0",
     "arr-diff": "^4.0.0",
     "bcryptjs": "^2.4.3",
+    "big.js": "^6.2.2",
     "change-case": "^4.1.2",
     "chatgpt-prompt-splitter": "^1.0.5",
     "chinesegen": "^0.3.3",

pnpm-lock.yaml

@@ -4,6 +4,7 @@ import { tool as basicAuthGenerator } from './basic-auth-generator';
 import { tool as dnsQueries } from './dns-queries';
 import { tool as icoConverter } from './ico-converter';
 import { tool as jsonEditor } from './json-editor';
+import { tool as slaCalculator } from './sla-calculator';
 import { tool as emailNormalizer } from './email-normalizer';
 import { tool as bounceParser } from './bounce-parser';
 import { tool as codeHighlighter } from './code-highlighter';
@@ -358,6 +359,8 @@ export const toolsByCategory: ToolCategory[] = [
       durationCalculator,
       dateDurationCalculator,
       benchmarkBuilder,
+      benchmarkBuilder,
+      slaCalculator,
     ],
   },
   {

src/tools/index.ts

@@ -0,0 +1,12 @@
+import { Clock } from '@vicons/tabler';
+import { defineTool } from '../tool';
+
+export const tool = defineTool({
+  name: 'SLA calculator',
+  path: '/sla-calculator',
+  description: 'Service Level Agreement Calcultator',
+  keywords: ['sla', 'service', 'level', 'agreement', 'calculator'],
+  component: () => import('./sla-calculator.vue'),
+  icon: Clock,
+  createdAt: new Date('2024-05-11'),
+});

src/tools/sla-calculator/index.ts

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+import { downTimeToSLA, slaToDowntimes } from './sla-calculator.service';
+
+describe('sla-calculator', () => {
+  describe('downTimeToSLA', () => {
+    it('compute correct values', () => {
+      expect(downTimeToSLA({
+        downTimeSeconds: 100,
+        mondayHours: 16,
+        tuesdayHours: 6,
+        wednesdayHours: 4,
+        thursdayHours: 24,
+        fridayHours: 21,
+        saturdayHours: 16,
+        sundayHours: 13,
+      })).to.deep.eq({
+        slaForDay: null,
+        slaForMonth: 99.99361155031703,
+        slaForQuarter: 99.99787051677234,
+        slaForWeek: 99.97222222222223,
+        slaForYear: 99.99946762919309,
+      });
+      expect(downTimeToSLA({
+        downTimeSeconds: 86400 / 10000,
+      })).to.deep.eq({
+        slaForDay: 99.99,
+        slaForMonth: 99.99967145115916,
+        slaForQuarter: 99.99989048371972,
+        slaForWeek: 99.99857142857142,
+        slaForYear: 99.99997262092992,
+      });
+      expect(downTimeToSLA({
+        downTimeSeconds: 86400 / 2,
+      })).to.deep.eq({
+        slaForDay: 50,
+        slaForMonth: 98.35725579580689,
+        slaForQuarter: 99.45241859860229,
+        slaForWeek: 92.85714285714286,
+        slaForYear: 99.86310464965058,
+      });
+    });
+  });
+  describe('slaToDowntimes', () => {
+    it('compute correct values', () => {
+      expect(slaToDowntimes({
+        targetSLA: 99,
+        mondayHours: 9,
+        tuesdayHours: 24,
+        wednesdayHours: 10,
+        thursdayHours: 8,
+        fridayHours: 3,
+        saturdayHours: 24,
+        sundayHours: 4,
+      })).to.deep.eq({
+        secondsPerDay: null,
+        secondsPerMonth: 12835.665,
+        secondsPerQuarter: 38506.995,
+        secondsPerWeek: 2952,
+        secondsPerYear: 154027.98,
+      });
+      expect(slaToDowntimes({
+        targetSLA: 99.99,
+      })).to.deep.eq({
+        secondsPerDay: 8.64,
+        secondsPerMonth: 262.9746,
+        secondsPerQuarter: 788.9238,
+        secondsPerWeek: 60.48,
+        secondsPerYear: 3155.6952,
+      });
+      expect(slaToDowntimes({
+        targetSLA: 99,
+      })).to.deep.eq({
+        secondsPerDay: 864,
+        secondsPerMonth: 26297.46,
+        secondsPerQuarter: 78892.38,
+        secondsPerWeek: 6048,
+        secondsPerYear: 315569.52,
+      });
+    });
+  });
+});

src/tools/sla-calculator/sla-calculator.service.test.ts

@@ -0,0 +1,126 @@
+import Big from 'big.js';
+
+const hoursDay = Big('24');
+const daysWeek = Big('7');
+const monthsYear = Big('12');
+const daysYear = Big('365.2425');
+const weeksYear = daysYear.div(daysWeek);
+const daysMonth = daysYear.div(monthsYear);
+const weeksMonth = daysMonth.div(daysWeek);
+
+interface DaysHours {
+  mondayHours?: number
+  tuesdayHours?: number
+  wednesdayHours?: number
+  thursdayHours?: number
+  fridayHours?: number
+  saturdayHours?: number
+  sundayHours?: number
+}
+
+function prepareDurations({
+  mondayHours = 24,
+  tuesdayHours = 24,
+  wednesdayHours = 24,
+  thursdayHours = 24,
+  fridayHours = 24,
+  saturdayHours = 24,
+  sundayHours = 24,
+}: DaysHours) {
+  const durHoursWeek = Big(mondayHours).plus(tuesdayHours).plus(wednesdayHours).plus(thursdayHours).plus(fridayHours).plus(saturdayHours).plus(sundayHours);
+  const durSecondsWeek = durHoursWeek.mul('3600');
+  const durSecondsDay = durSecondsWeek.div(daysWeek);
+  const durSecondsMonth = durSecondsWeek.mul(weeksMonth);
+  const durSecondsQuarter = durSecondsMonth.mul('3');
+  const durSecondsYear = durSecondsWeek.mul(weeksYear);
+  const fullWeekHours = daysWeek.mul(hoursDay);
+
+  return {
+    durHoursWeek,
+    durSecondsWeek,
+    durSecondsDay,
+    durSecondsMonth,
+    durSecondsQuarter,
+    durSecondsYear,
+    fullWeekHours,
+  };
+}
+
+export function downTimeToSLA({
+  downTimeSeconds,
+  mondayHours = 24,
+  tuesdayHours = 24,
+  wednesdayHours = 24,
+  thursdayHours = 24,
+  fridayHours = 24,
+  saturdayHours = 24,
+  sundayHours = 24,
+}: {
+  downTimeSeconds: number
+} & DaysHours) {
+  const {
+    durHoursWeek,
+    durSecondsWeek,
+    durSecondsDay,
+    durSecondsMonth,
+    durSecondsQuarter,
+    durSecondsYear,
+    fullWeekHours,
+  } = prepareDurations({
+    mondayHours, tuesdayHours, wednesdayHours, thursdayHours, fridayHours, saturdayHours, sundayHours,
+  });
+
+  const one = Big('1');
+  const hundred = Big('100');
+  const downTimeSecondsBig = Big(downTimeSeconds);
+
+  return {
+    slaForDay: fullWeekHours.eq(durHoursWeek) ? one.minus(downTimeSecondsBig.div(durSecondsDay)).mul(hundred).toNumber() : null,
+    slaForWeek: one.minus(downTimeSecondsBig.div(durSecondsWeek)).mul(hundred).toNumber(),
+    slaForMonth: one.minus(downTimeSecondsBig.div(durSecondsMonth)).mul(hundred).toNumber(),
+    slaForQuarter: one.minus(downTimeSecondsBig.div(durSecondsQuarter)).mul(hundred).toNumber(),
+    slaForYear: one.minus(downTimeSecondsBig.div(durSecondsYear)).mul(hundred).toNumber(),
+  };
+}
+
+export function slaToDowntimes({
+  targetSLA,
+  mondayHours = 24,
+  tuesdayHours = 24,
+  wednesdayHours = 24,
+  thursdayHours = 24,
+  fridayHours = 24,
+  saturdayHours = 24,
+  sundayHours = 24,
+}: {
+  targetSLA: number
+  mondayHours?: number
+  tuesdayHours?: number
+  wednesdayHours?: number
+  thursdayHours?: number
+  fridayHours?: number
+  saturdayHours?: number
+  sundayHours?: number
+}) {
+  const {
+    durHoursWeek,
+    durSecondsWeek,
+    durSecondsDay,
+    durSecondsMonth,
+    durSecondsQuarter,
+    durSecondsYear,
+    fullWeekHours,
+  } = prepareDurations({
+    mondayHours, tuesdayHours, wednesdayHours, thursdayHours, fridayHours, saturdayHours, sundayHours,
+  });
+
+  const allowedDowntime = Big('1').minus(Big(targetSLA).div('100'));
+
+  return {
+    secondsPerDay: fullWeekHours.eq(durHoursWeek) ? allowedDowntime.mul(durSecondsDay).toNumber() : null,
+    secondsPerWeek: allowedDowntime.mul(durSecondsWeek).toNumber(),
+    secondsPerMonth: allowedDowntime.mul(durSecondsMonth).toNumber(),
+    secondsPerQuarter: allowedDowntime.mul(durSecondsQuarter).toNumber(),
+    secondsPerYear: allowedDowntime.mul(durSecondsYear).toNumber(),
+  };
+}