https://github.com/patrickjaja/forecast.it.fill

https://github.com/patrickjaja/forecast.it.fill

Last synced: 10 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/patrickjaja/forecast.it.fill
• Owner: patrickjaja
• License: mit
• Created: 2021-07-01T18:52:28.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-09-17T20:50:56.000Z (over 1 year ago)
• Last Synced: 2024-09-18T01:42:36.436Z (over 1 year ago)
• Language: PHP
• Size: 339 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 23
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![Minimum PHP version: 8.0.0](https://img.shields.io/badge/php-8.0%2B-blue.svg)](https://github.com/patrickjaja/forecast.it.fill)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/patrickjaja/forecast.it.fill/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/patrickjaja/forecast.it.fill?branch=master)

[![Scrutinizer Code Coverage](https://scrutinizer-ci.com/g/patrickjaja/forecast.it.fill/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/patrickjaja/forecast.it.fill?branch=master)

[![Tests](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phptests.yml/badge.svg)](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phptests.yml)

[![phpstan level5](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phpstan.yml/badge.svg)](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phpstan.yml)

[![Arkitect](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phparkitect.yml/badge.svg)](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phparkitect.yml)

[![Deptrac](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phpdeptrac.yml/badge.svg)](https://github.com/patrickjaja/forecast.it.fill/actions/workflows/phpdeptrac.yml)

Forecast.it activity automation process

==========================

This project is used to fill your forecast.it timesheets in a comfortable way.

Enable and configure plugins on your needs and enjoy newly acquired free time.

## Documentation

## Introduction

This is a side project I've been working on.

With this application, you can automate your time accounting and have clear fair transparent bills etc for your clients. This project is something I've been working on in my free time so I cannot be sure that everything will work out correctly. But I'll appreciate you if can report any issue.

### ⚡ supported activity sources

 - [jira](src/ForecastAutomation/JiraClient/Shared/Plugin/JiraActivityPlugin.php)

   (will create an activity entry if you [comment](src/ForecastAutomation/JiraClient/Business/JiraCollector.php#L41) a ticket)

 - [gitlab](src/ForecastAutomation/GitlabClient/Shared/Plugin/GitlabActivityPlugin.php)

   (will create an activity if you [comment or approve](src/ForecastAutomation/GitlabClient/Shared/Plugin/GitlabActivityPlugin.php#L25) a MR by consuming gitlab event api)

 - [mattermost](src/ForecastAutomation/MattermostClient/Shared/Plugin/MattermostActivityPlugin.php)

   (will create an activity if you [direct message](src/ForecastAutomation/MattermostClient/Business/MattermostApi.php#L112) a text that [contains a ticketnumber](src/ForecastAutomation/MattermostClient/Shared/Plugin/MattermostActivityPlugin.php#L53))

 - [periodical activity](src/ForecastAutomation/PeriodicalActivity/Shared/Plugin/PeriodicalActivityDataImportConsoleCommandPlugin.php)

   (will create weekly repeating activities based on [configuration](.env.dist#L29))

### ✨ How to use

 - run `composer run import` at the end of the day (date('Y-m-d 00:00') used by default) to fill your forecast.it timesheet with your [enabled activity plugins](src/ForecastAutomation/Activity/ActivityDependencyProvider.php)

### ⚙️ setup

 - `composer install`

 - create `http-client.local.json` (to get forecast_ids via `forecast_api.http`)

 - create `.env` with your configuration

 - docker-compose -f .docker/docker-compose.yml up -d

 - php bin/console forecast:import:activity

 - php bin/console queue:client:consumer projektron.send.activity.queue

### ✌️ ToDo:

- https://github.com/patrickjaja/forecast.it.fill/issues