Giter VIP home page Giter VIP logo

on-calls-pre-fill's Introduction


On-calls form pre-filler

Do not count your on-call hours manually again
https://heureka.github.io/on-calls-pre-fill/

About The Project

Once per month developers who has been part of on-call rotation need to count theirs on-call hours manually because reports from opsgenie does not count with country specific holidays. But this tool does. Also it automatically count all on-call hours per team, so each developer does not have to count this by himself.

(back to top)

Usage

This is very easy. Just open https://heureka.github.io/on-calls-pre-fill/


Showcase

(back to top)

New team integration

If your team wants to use this tool, you need to do 3 steps:

  1. export your schedule from Opsgenie (in webcal format)
  2. import schedule from previous step to your google calendar and make it public
  3. add configuration to window.CONFIG

Example:

      window.CONFIG = {
        TEAMS: {
          ONE_ACCOUNT: {
            TITLE: 'One Account',
            CALENDAR_ID: '[email protected]',
            COUNTRY: 'CZ',
            WORKING_HOURS_START: 8, // This has to correspond with the working hours set in opsgenie
            WORKING_HOURS_END: 16, // This has to correspond with the working hours set in opsgenie
          },

How to setup calendar

Built and Deploy

This is single page app (actually just one index.html file) which have all its functionality and configuration bundled in one single file. It leverage power of Google Calendar API to load on-calls rotation calendar exported from Opsgenie.

JavaScript Opsgenie Cloudflare Pages

(back to top)

Local development

You can run this project locally (even if it doesn't make much sense :).

Prequisities

  • Schedule in OpsGenie ๐Ÿ“†
  • Google account ๐Ÿง”โ€โ™‚๏ธ
  • Enabled Google Calendar API ๐Ÿ”‘
  • docker-compose tool ๐Ÿงฐ

Installation

  1. Clone the repo
    git clone https://github.com/heureka/on-calls-pre-fill.git
  2. Enable Google Calendar API:
    • follow instructions on https://support.google.com/googleapi/answer/6158862?hl=en
    • in Client ID configuration add http://127.0.0.1 to Authorized JavaScript origins and to Authorized redirect URIs
    • after you create API Key paste it to API_KEY in index.html
    • find Google Calendar API in list and enable it

      NOTE: don't forget to setup API restrictions to use only Google Calendar API

  3. Run app by docker-compose up

(back to top)

Roadmap

  • Count with holidays
    • Czech
    • Hungarian
    • Slovenian
  • Add Support for automatic deployment
  • Configuration for different working hours start/end
  • Enable google form pre-filing

(back to top)

FAQ

I can't see my on-call hours from previous month, is it bug?

It is how it works. You need to be quick and fill your hours before month ends.

I want new feature, what should I do?

Create new issue

I found bug, what should I do?

Create new issue.

(back to top)

on-calls-pre-fill's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.