diff --git a/package.json b/package.json index 3d621a7b..b903391f 100644 --- a/package.json +++ b/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", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 3097382e..b7693e5c 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -83,6 +83,9 @@ dependencies: '@types/arr-diff': specifier: ^4.0.3 version: 4.0.3 + '@types/big.js': + specifier: ^6.2.2 + version: 6.2.2 '@types/emscripten': specifier: ^1.39.10 version: 1.39.13 @@ -149,6 +152,9 @@ dependencies: bcryptjs: specifier: ^2.4.3 version: 2.4.3 + big.js: + specifier: ^6.2.2 + version: 6.2.2 change-case: specifier: ^4.1.2 version: 4.1.2 @@ -5054,6 +5060,10 @@ packages: resolution: {integrity: sha512-LiMQ6EOPob/4yUL66SZzu6Yh77cbzJFYll+ZfaPiPPFswtIlA/Fs1MzdKYA7JApHU49zQTbJGX3PDmCpIdDBRQ==} dev: true + /@types/big.js@6.2.2: + resolution: {integrity: sha512-e2cOW9YlVzFY2iScnGBBkplKsrn2CsObHQ2Hiw4V1sSyiGbgWL8IyqE3zFi1Pt5o1pdAtYkDAIsF3KKUPjdzaA==} + dev: false + /@types/chai-subset@1.3.3: resolution: {integrity: sha512-frBecisrNGz+F4T6bcc+NLeolfiojh5FxW2klu669+8BARtyQv2C/GkNW6FUodVe4BroGMP/wER/YDGc7rEllw==} dependencies: @@ -5138,7 +5148,7 @@ packages: /@types/lodash-es@4.17.10: resolution: {integrity: sha512-YJP+w/2khSBwbUSFdGsSqmDvmnN3cCKoPOL7Zjle6s30ZtemkkqhjVfFqGwPN7ASil5VyjE2GtyU/yqYY6mC0A==} dependencies: - '@types/lodash': 4.14.200 + '@types/lodash': 4.14.192 dev: false /@types/lodash.defaultsdeep@4.6.9: @@ -5161,7 +5171,6 @@ packages: /@types/lodash@4.14.192: resolution: {integrity: sha512-km+Vyn3BYm5ytMO13k9KTp27O75rbQ0NFw+U//g+PX7VZyjCioXaRFisqSIJRECljcTv73G3i6BpglNGHgUQ5A==} - dev: true /@types/lodash@4.14.200: resolution: {integrity: sha512-YI/M/4HRImtNf3pJgbF+W6FrXovqj+T+/HpENLTooK9PnkacBsDpeP3IpHab40CClUfhNmdM2WTNP2sa2dni5Q==} @@ -6249,7 +6258,7 @@ packages: /@vueuse/shared@10.0.0(vue@3.3.4): resolution: {integrity: sha512-Zh3LgJqvUBWVY3SiMvXanTcfAneGbt63QPczBRDNgQ6jd/ehodO9a1lCFzaA6SWJJoI+ugVTjHFYJdoR656DVQ==} dependencies: - vue-demi: 0.14.5(vue@3.3.4) + vue-demi: 0.14.10(vue@3.3.4) transitivePeerDependencies: - '@vue/composition-api' - vue @@ -6596,6 +6605,10 @@ packages: resolution: {integrity: sha512-V/Hy/X9Vt7f3BbPJEi8BdVFMByHi+jNXrYkW3huaybV/kQ0KJg0Y6PkEMbn+zeT+i+SiKZ/HMqJGIIt4LZDqNQ==} dev: false + /big.js@6.2.2: + resolution: {integrity: sha512-y/ie+Faknx7sZA5MfGA2xKlu0GDv8RWrXGsmlteyJQ2lvoKv9GBK/fpRMc2qlSoBAgNxrixICFCBefIq8WCQpQ==} + dev: false + /binary-extensions@2.2.0: resolution: {integrity: sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==} engines: {node: '>=8'} @@ -10122,6 +10135,7 @@ packages: /jsesc@2.5.2: resolution: {integrity: sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==} engines: {node: '>=4'} + hasBin: true /jsesc@3.0.2: resolution: {integrity: sha512-xKqzzWXDttJuOcawBt4KnKHHIf5oQ/Cxax+0PWFG+DFDgHNAdi+TXECADI+RYiFUMmx8792xsMbbgXj4CwnP4g==} diff --git a/src/tools/index.ts b/src/tools/index.ts index 045252ff..67f50943 100644 --- a/src/tools/index.ts +++ b/src/tools/index.ts @@ -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, ], }, { diff --git a/src/tools/sla-calculator/index.ts b/src/tools/sla-calculator/index.ts new file mode 100644 index 00000000..da347ff5 --- /dev/null +++ b/src/tools/sla-calculator/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'), +}); diff --git a/src/tools/sla-calculator/sla-calculator.service.test.ts b/src/tools/sla-calculator/sla-calculator.service.test.ts new file mode 100644 index 00000000..f681bff1 --- /dev/null +++ b/src/tools/sla-calculator/sla-calculator.service.test.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, + }); + }); + }); +}); diff --git a/src/tools/sla-calculator/sla-calculator.service.ts b/src/tools/sla-calculator/sla-calculator.service.ts new file mode 100644 index 00000000..a4ff3732 --- /dev/null +++ b/src/tools/sla-calculator/sla-calculator.service.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(), + }; +} diff --git a/src/tools/sla-calculator/sla-calculator.vue b/src/tools/sla-calculator/sla-calculator.vue new file mode 100644 index 00000000..cb46bf58 --- /dev/null +++ b/src/tools/sla-calculator/sla-calculator.vue @@ -0,0 +1,179 @@ + + +