totask2 Überblick

totask2 ist eine "Ausrede" um einen wieder einmal willkürlich ausgewählten Software-Stack auszuprobieren.

totask2 erlaubt eine Erfassung von (Arbeits-) Zeiten zu Projekttasks. Daher verwaltet das Programm Entitäten wie Projekt, Task und Arbeitszeit (WorkEntry) und Taskzuordnung zu Usern (TaskAssignment).

springmvc als serverseitiges Java Web Framework.

SpringMVC Web Anwendungen werden natürlich in Java programmiert. Im vorliegenden Fall bereits mit Java 8 da ich dabei Closures nutzen wollte. Als Templating Engine für HTML wird dabei thymeleaf verwendet.

Logging erfolgt mit logback/slf4j, optional in die cloud auf loggly.com,

Unit Tests mit junit. Der REST Teil wird über wagger zur Verfügung gestellt, alternativ erfolgen Tests der REST Aufrufe über Postman

Client Seitig benutze ich bootstrap für css, bootstrapvalidator für einige Client seitige Prüfungen, jquery als JavaScript Library, dazu datatables als Datagrid. Ein Chart wird mit Charts.js clientseitig erstellt, ein Gantt Chart mit ganttView. Für die kompfortable Auswahl von Usern benutze ich das autocomplete plugin, um Suchvorschläge on the fly per REST/json vom Server zu holen. Für die UI Zuordnung Projektleiter zu Projekt kommt das Control selectize.js zum Einsatz.

Für Reporting wird JasperReports genutzt um Excel und PDF Auswertungen zu generieren.

Versionierung ist mit git gelöst. Das Repository ist auf github gehostet.

Datenhaltung wird mit der integrierten h2 in-Memory Datenbank gelöst, zumindest während der Entwicklung. Eine separate qa Datenbank wird mit dem QA Profil angesprochen, deren Tabellenstruktur (DDLs) wird mit "Migrations" durch flyway gepflegt. Einige Tabellen/Daten sind historisiert, dies wird mit hibernate-envers realisiert.

Dieser Artikel und weitere Dokumentation ist mit asciidoc Markup erstellt. Einige Diagramme sind mit plantuml erstellt und generiert. Ein nettes Gimmick: github kann asciidoc Documente "on the fly" direkt aus dem Repository im Browser als Html rendern. Live zu sehen unter https://github.com/man-at-home/totask2/blob/master/src/docs/totask2.article.asciidoc

Für das Build Management nutze ich gradle, mit einigen Plugins wie asciidoctor. Diverse Build-Server laufen in der Cloud, auf openshift jenkins, dazu travis-ci, codeship, circleci sowie shippable

Qualitätsanalyse erfolgt mit diversen Tools die im Build oder in der IDE eingebunden sind: CheckStyle, FindBugs, PMD, jDepend, jacoco. Zudem als Analysewerkzeug SonarQube. Zusätzlich triggert der travis-ci Server eine cloud-basierte Codeprüfung auf an coverity.com Auf veraltete Libraries prüft versioneye.

Experimentell ist selenium als Web Test Tool.

Als "echter" Appserver für das Deployment fungiert der WildFly Application Server von redhat - sowohl lokal installiert als auch in der cloud.

Metriken sind mit boot-actuator und mit dropwizard metrics bereitgestellt, derzeit als REST Endpoint. Optionales weiteres Performance Monitoring erfolgt mit newrelic. Dazu ist der lokale wildfly Server instrumentiert und schickt Informationen an newrelic.

Hosting der Anwendung in der cloud erfolgt mit openShift in einer WildFly Cardridge, zudem automatisiert (und immer Aktualisiert über den codeship ci-server) auf einen dyno in der heroku cloud.

Das Monitoring der bei heroku laufenden Anwendung erfolgt mit monitor.us, die neben Web Charts und Alert E-Mails auch android und iphone apps herfür bereitstellen.

Ebenfalls zur Überwachung sowie zur Erfassung und Auswertung oben beschriebenen Metriken erfolgt mit circonus.com[Circonus]. Aktiviert sind zudem AlertSite (mit der Besonderheit der Ausführung von soapUI Tests gegen totask2), ruxit, anturis und pingdom, die jeweils die Verfügbarkeit der totask2 Webseiten von verschiedenen Standorten weltweit prüfen als weitere Server Überwachung.

Weitere Auswertung können mit dem Analytic Provider keen.io erfolgen. Dazu ist ein entsprechender Service in totask2 implementiert, der Kennzahlen an keen.io schicken kann.

Als Kommunikation (mit mir selber: "ha ha") generieren Codeänderungen (github) und Blob-Einträge (wordpress) twitter tweets auf @totask2tweeter, diese werden auch weitergeleitet an einen slack Chat Account, ebenso wie weitere Informationen (z.B. von den Build Servern).

hier kurze Blicke auf die laufende Anwendung:

Eine Liste mit allen verwalteten Projekten:

editierbar das Projekt, inklusive Projektleiterselektion mit Ajax-Control selectize.js

die geplante Projektlaufzeit (je Task und Assignment) als Gantt-Diagramm:

Die eigentliche Stundenerfassung für "normale" Nutzer:

Diverse Client Seitige (JavaScript/jquery) Funktionalitäten:

Eingaben lassen sich als Excel Report herunterladen (Reporting Tool Jasper Reports ist integriert):

Die Zeiteingaben führen "on the fly" zur graphischen Rückmeldung als Balkendiagramm (chart.js):

Die Benutzereingabe nutzt ein "autocomplete" ajax Control von jquery-ui:

Login Seite (integriert mit spring-security):

Einblicke in die Entwicklung von totask2:

eclipse / springIDE

Für die REST Datenquellen stellt swagger-ui einen automatische generierten Client zur Verfügung:

PlantUML ermgöglicht das einfache Einbetten von UML Diagrammen in die javadoc-Dokumentation:

Den Inhalt der Datenbank H2 kann man mit der mitgelieferten Console einsehen und ändern:

Tests mit junit 4:

experimentelle Selenium Tests:

git Repository und Versionierung:

diverse qa tools (findBugs, checkstyle, PMD) prüfen den Code statisch, hier als Beispiel checkstyle:

das Ganze dann auch auswertbar mit Trends in einem SonarQube Server aufbereitet.

Option zur Logauswertung (direct in der cloud).

lokale Alternative dazu wäre die Kombi aus logstash, elasticsearch und kibana.

Monitoring der lokalen Wildfly Instanz mit newrelic.

dev docs and basic user docs

Details hoffentlich bald im blog https://totask2.wordpress.com/