#538 Work-item sources: aggregate GitHub assignments, then Planner and kanban boards
–
- github
- github/openchronology/timeline-app
- github/openchronology/timeline-app#538
- issue
- state:open
- label:enhancement
Part of #533. OpenChronology as an **aggregator** of the events that work tools already create: GitHub issue and pull request assignments first, then Microsoft Planner and kanban boards. It mirrors them read-only; it is not a time tracker. Depends on ongoing durations (#537): an open work item is a duration that ends now. ## Model The same pattern as the [syslog receiver](docs/syslog.md), the [journald follower](docs/journald.md) and [`och-import-logs`](docs/log-import.md): an API key, routing rules to timelines, and a live path plus a backfill path. | Source event | On the timeline | | --- | --- | | Issue or PR opened | A duration from its creation, ongoing | | Closed or merged | The duration gets a fixed end | | Reopened | The end becomes ongoing again | | Assigned or unassigned | A moment, and an assignee tag on the duration | | Labels, milestone, repository | Tags | | Linked issues, "closes #n" | Relationships | Each work item keeps a stable ID derived from its source (`github:owner/repo#412`), so redelivered webhooks and re-runs of the backfill update rather than duplicate. ## GitHub, first - **Live:** a webhook receiver (`issues`, `pull_request` and `issue_comment` events if wanted), checking `X-Hub-Signature-256`, routing by repository. - **Backfill:** an importer that reads a repository's issues and PRs, and their timeline events, through the REST API with a token, with `--since` and `--dry-run` like `och-import-logs`. - **Gantt view:** check that separating by the assignee tag, plus relationships, gives a usable per-person chart before adding any new view. ## Later sources, same mapping - **Microsoft Planner:** tasks through Microsoft Graph (created, assigned, percent complete, completed), using change notifications for live updates. - **Kanban boards:** for example GitHub Projects, Trello or Jira. A card's time in each column becomes a duration, and a column move becomes a moment. ## Privacy Assignments name people, so this mirrors personal data from another service. The docs should say what is copied, and deleting or unassigning at the source should be reflected. https://github.com/circagraph/timeline-app/issues/538
Related
- #533 gantt chart / employee task action tracking integration
- #537 Ongoing durations: an end that is "now"
- #542 Mirror GitHub issues and pull requests into timelines (#538)
- #543 Mirror releases, milestones and time in board columns from GitHub (#538)
- #544 Ship the GitHub receiver and och-import-github in every server package (#538)
- #545 Let events carry tags of up to 128 characters
- #546 Mirror Forgejo and Gitea, and commits, branches and forks (#538)
- #547 Mirror GitLab projects: issues, merge requests and commits (#538)
- #557 Forge importer: a default view separating each branch, from its creation to its merge
- #559 Open mirrored repositories in a view of their branches
- #568 Mirror Trello, Jira, Planner and OpenProject into timelines
- #569 Plan work as a Gantt chart: forge due dates, roadmaps and Microsoft Project files
- #570 Measures: typed quantities on moments and durations, totalled in every summary
- Merge pull request #544 from openchronology/feature/github-packaging
- Merge pull request #547 from openchronology/feature/gitlab
- Plan repositories' work as a Gantt chart
- Mirror GitHub issues and pull requests into timelines
- Merge pull request #543 from openchronology/feature/github-milestones-releases
- Merge pull request #542 from openchronology/feature/github-source
- Merge pull request #546 from openchronology/feature/forges
- List och-import-github in the lockfiles
- Let events carry tags of up to 128 characters
- Mirror Trello, Jira, Planner and OpenProject into timelines
- Import Microsoft Project plans as Gantt charts