TMF-1946: create a tempo events example plugin (#2)

.gitignore

@@ -0,0 +1,52 @@
+BuildInfo.java
+
+
+# Idea #
+########
+# Do not commit IntelliJ files
+*.iml
+*.iws
+*.ipr
+.idea/
+target/
+resources/build/
+.jar
+
+
+# Packages #
+############
+# it's better to unpack these files and commit the raw source
+# git has its own built in compression methods
+*.7z
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.zip
+
+# Logs and databases #
+######################
+*.log
+#*.sql
+*.sqlite
+
+# OS generated files #
+######################
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+Icon?
+ehthumbs.db
+Thumbs.db
+
+# Cloud #
+#########
+dockertag
+build/dist
+tempo-cloud-migration/build/dist
+classpath-list
+.git-history

README.md

@@ -0,0 +1,62 @@
+# JIRA Plugin for showcasing how to listen to Tempo Events
+
+# Listening to events
+
+[Writing JIRA event listeners with the atlassian-event library](https://developer.atlassian.com/server/jira/platform/writing-jira-event-listeners-with-the-atlassian-event-library)
+
+# Root event class
+
+All public Tempo events implements this :
+
+    com.tempoplugin.platform.api.event.Event
+
+Although this is helpful for discovering Tempo events, we do recommend that you listen to other 
+fine-grained events (see the list below).
+
+Most of the Tempo events have base classes that you can listen without the distinction of the nature 
+of the event. For example, listening to `AccountEvent`, you will receive events like 
+`AccountChangedEvent`, `AccountCreatedEvent`, `AccountDeletedEvent`, etc. 
+
+Keep in mind that if for example you listen to `AccountEvent` __and__ `AccountChangedEvent`, both 
+listening methods will be called.
+
+# List of Tempo events
+
+Class [hierarchy](doc/tempo-events.png) of the event classes.
+
+## Tempo Accounts
+
+### Acount
+![Account](doc/tempo-events-account.svg)
+
+### Category
+![Category](doc/tempo-events-category.svg)
+
+### Customer
+![Customer](doc/tempo-events-customer.svg)
+
+## Tempo Budgets
+
+### Folio
+![Folio](doc/tempo-events-folio.svg)
+
+### Portfolio
+![Portfolio](doc/tempo-events-portfolio.svg)
+
+### Expenditure
+![Expenditure](doc/tempo-events-expenditure.svg)
+
+## Tempo Planner
+
+### Allocation
+![Allocation](doc/tempo-events-allocation.svg)
+
+## Tempo Teams
+
+### Team
+![Team](doc/tempo-events-team.svg)
+
+## Tempo Timesheets
+
+### Approval
+![Approval](doc/tempo-events-timesheet-approval.svg)