Displaying a QR code in the EditItemDialog containing the full data of the current item as a string.

.gitignore

@@ -0,0 +1,83 @@
+# This file is used to ignore files which are generated
+# ----------------------------------------------------------------------------
+
+*~
+*.autosave
+*.a
+*.core
+*.moc
+*.o
+*.obj
+*.orig
+*.rej
+*.so
+*.so.*
+*_pch.h.cpp
+*_resource.rc
+*.qm
+.#*
+*.*#
+core
+!core/
+tags
+.DS_Store
+.directory
+*.debug
+Makefile*
+*.prl
+*.app
+moc_*.cpp
+ui_*.h
+qrc_*.cpp
+Thumbs.db
+*.res
+*.rc
+/.qmake.cache
+/.qmake.stash
+
+# qtcreator generated files
+*.pro.user*
+*.qbs.user*
+CMakeLists.txt.user*
+
+# xemacs temporary files
+*.flc
+
+# Vim temporary files
+.*.swp
+
+# Visual Studio generated files
+*.ib_pdb_index
+*.idb
+*.ilk
+*.pdb
+*.sln
+*.suo
+*.vcproj
+*vcproj.*.*.user
+*.ncb
+*.sdf
+*.opensdf
+*.vcxproj
+*vcxproj.*
+
+# MinGW generated files
+*.Debug
+*.Release
+
+# Python byte code
+*.pyc
+
+# Binaries
+# --------
+*.dll
+*.exe
+
+# Directories with generated files
+.moc/
+.obj/
+.pch/
+.rcc/
+.uic/
+/build*/
+_build*/

CMakeLists.txt

@@ -0,0 +1,93 @@
+cmake_minimum_required(VERSION 3.16)
+
+set(TARGET_APP "GenericQtClient-Widgets")
+project(${TARGET_APP} VERSION 0.2.0 LANGUAGES CXX)
+
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets LinguistTools)
+find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets LinguistTools)
+
+set(TS_FILES ${TARGET_APP}_en_US.ts)
+
+set(PROJECT_SOURCES
+    main.cpp
+    mainwindow.cpp
+    mainwindow.h
+    mainwindow.ui
+    ${TS_FILES}
+)
+
+if(${QT_VERSION_MAJOR} GREATER_EQUAL 6)
+    qt_add_executable(${TARGET_APP}
+        MANUAL_FINALIZATION
+        ${PROJECT_SOURCES}
+        utils/messagehandler.h
+        assets/icons.qrc
+        dialogs/abstractdialog.h dialogs/abstractdialog.cpp
+        dialogs/newitemdialog.h dialogs/newitemdialog.cpp
+        dialogs/edititemdialog.h dialogs/edititemdialog.cpp
+        views/itemdetailmapper.h views/itemdetailmapper.cpp
+    )
+# Define target properties for Android with Qt 6 as:
+#    set_property(TARGET ${TARGET_APP} APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR
+#                 ${CMAKE_CURRENT_SOURCE_DIR}/android)
+# For more information, see https://doc.qt.io/qt-6/qt-add-executable.html#target-creation
+
+# qt_create_translation(QM_FILES ${CMAKE_SOURCE_DIR} ${TS_FILES})
+
+else()
+    if(ANDROID)
+        add_library(${TARGET_APP} SHARED
+            ${PROJECT_SOURCES}
+        )
+    # Define properties for Android with Qt 5 after find_package() calls as:
+    #    set(ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android")
+else()
+    add_executable(${TARGET_APP}
+        ${PROJECT_SOURCES}
+    )
+endif()
+
+qt5_create_translation(QM_FILES ${CMAKE_SOURCE_DIR} ${TS_FILES})
+endif()
+
+include_directories(${CMAKE_CURRENT_BINARY_DIR})
+
+target_link_libraries(${TARGET_APP} PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)
+
+target_include_directories(${TARGET_APP} PRIVATE ${CORE_LIB_DIR}/)
+target_link_libraries(${TARGET_APP} PRIVATE GenericCore)
+target_include_directories(${TARGET_APP} PRIVATE ${QR_LIB_DIR}/src)
+target_link_libraries(${TARGET_APP} PRIVATE qrcode)
+
+
+# Qt for iOS sets MACOSX_BUNDLE_GUI_IDENTIFIER automatically since Qt 6.1.
+# If you are developing for iOS or macOS you should consider setting an
+# explicit, fixed bundle identifier manually though.
+if(${QT_VERSION} VERSION_LESS 6.1.0)
+    set(BUNDLE_ID_OPTION MACOSX_BUNDLE_GUI_IDENTIFIER com.example.${TARGET_APP})
+endif()
+set_target_properties(${TARGET_APP} PROPERTIES
+    ${BUNDLE_ID_OPTION}
+    MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
+    MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
+    MACOSX_BUNDLE TRUE
+    WIN32_EXECUTABLE TRUE
+)
+
+include(GNUInstallDirs)
+install(TARGETS ${TARGET_APP}
+    BUNDLE DESTINATION .
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+)
+
+if(QT_VERSION_MAJOR EQUAL 6)
+    qt_finalize_executable(${TARGET_APP})
+endif()

GenericQtClient-Widgets_en_US.ts

@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE TS>
+<TS version="2.1" language="en_US"></TS>

assets/icons.qrc

@@ -0,0 +1,7 @@
+<RCC>
+    <qresource prefix="/">
+        <file>software-application.png</file>
+        <file>feature.png</file>
+        <file>no-picture-taking.png</file>
+    </qresource>
+</RCC>

assets/urls.txt

@@ -0,0 +1,5 @@
+software-application.png:
+https://www.flaticon.com/free-icon/software-application_5063917 
+
+feature.png:
+https://www.flaticon.com/free-icon/feature_1085784

dialogs/abstractdialog.cpp

@@ -0,0 +1,51 @@
+#include "abstractdialog.h"
+
+#include <QDialogButtonBox>
+#include <QGuiApplication>
+#include <QLabel>
+#include <QScreen>
+#include <QVBoxLayout>
+
+AbstractDialog::AbstractDialog(QDialogButtonBox::StandardButtons buttons, QWidget* parent)
+    : QDialog(parent) {
+  setWindowTitle(tr("Dialog does what?..."));
+  setModal(true);
+
+  m_buttonBox = new QDialogButtonBox(buttons, this);
+  connect(m_buttonBox, &QDialogButtonBox::accepted, this, &AbstractDialog::accept);
+  connect(m_buttonBox, &QDialogButtonBox::rejected, this, &AbstractDialog::reject);
+
+  m_contentContainer = new QLabel("content", this);
+
+  m_outerLayout = new QVBoxLayout;
+  m_outerLayout->addWidget(m_contentContainer);
+  m_outerLayout->addWidget(m_buttonBox);
+
+  setLayout(m_outerLayout);
+}
+
+void AbstractDialog::show() {
+  centerInParent();
+  QWidget::show();
+}
+
+void AbstractDialog::accept() { QDialog::accept(); }
+
+void AbstractDialog::reject() { QDialog::reject(); }
+
+void AbstractDialog::centerInParent() {
+  // BUG the centering in the parent doesn't work the first time (and the later ones seem off too)
+  QWidget* parent = parentWidget();
+
+  if (parent) {
+    auto parentRect = parent->geometry();
+    move(parentRect.center() - rect().center());
+  } else {
+    QRect screenGeometry = QGuiApplication::screens().at(0)->geometry();
+    int x                = (screenGeometry.width() - width()) / 2;
+    int y                = (screenGeometry.height() - height()) / 2;
+    move(x, y);
+  }
+}
+
+void AbstractDialog::closeEvent(QCloseEvent* event) { QWidget::closeEvent(event); }

dialogs/abstractdialog.h

@@ -0,0 +1,33 @@
+#ifndef ABSTRACTDIALOG_H
+#define ABSTRACTDIALOG_H
+
+#include <QDialog>
+#include <QDialogButtonBox>
+
+class QGridLayout;
+class QVBoxLayout;
+
+class AbstractDialog : public QDialog {
+  Q_OBJECT
+ public:
+  AbstractDialog(QDialogButtonBox::StandardButtons buttons, QWidget* parent = nullptr);
+  virtual void createContent() = 0;
+
+  /// QDialog interface
+ public slots:
+  void show();
+  void accept() override;
+  void reject() override;
+
+ protected:
+  void centerInParent();
+
+ protected:
+  QWidget* m_contentContainer;
+  QVBoxLayout* m_outerLayout;
+  QDialogButtonBox* m_buttonBox = nullptr;
+
+  void closeEvent(QCloseEvent* event) override;
+};
+
+#endif  // ABSTRACTDIALOG_H

dialogs/edititemdialog.cpp

@@ -0,0 +1,57 @@
+#include "edititemdialog.h"
+
+#include <QDialogButtonBox>
+#include <QLabel>
+#include <QVBoxLayout>
+
+#include "../views/itemdetailmapper.h"
+
+EditItemDialog::EditItemDialog(QTableView* tableView, QWidget* parent)
+    : AbstractDialog(QDialogButtonBox::Close, parent)
+    , m_tableView(tableView)
+    , m_qrCodeDisplay(new QLabel("QR Code")) {}
+
+void EditItemDialog::createContent() {
+  if (m_contentContainer) {
+    delete m_contentContainer;
+  }
+
+  setWindowTitle(tr("Edit item..."));
+
+  m_contentContainer       = new QWidget(this);
+  QHBoxLayout* innerLayout = new QHBoxLayout(this);
+  m_contentContainer->setLayout(innerLayout);
+
+  m_detailMapper = new ItemDetailMapper(this);
+  m_detailMapper->setModelMappings(m_tableView);
+  innerLayout->addWidget(m_detailMapper);
+
+  updateQRCode();
+  connect(m_detailMapper, &ItemDetailMapper::contentChanged, this, &EditItemDialog::updateQRCode);
+  innerLayout->addWidget(m_qrCodeDisplay);
+
+  m_outerLayout->insertWidget(0, m_contentContainer);
+}
+
+void EditItemDialog::accept() {
+  m_detailMapper->submit();
+  QDialog::accept();
+}
+
+void EditItemDialog::reject() {
+  m_detailMapper->revert();
+  QDialog::reject();
+}
+
+void EditItemDialog::updateQRCode(const QString text) {
+  QImage unscaledImage;
+  if (text.isEmpty()) {
+    unscaledImage = QImage("://no-picture-taking.png");
+  } else {
+    unscaledImage = m_generator.generateQr(text);
+  }
+  QImage image = unscaledImage.scaled(250, 250);
+
+  m_qrCodeDisplay->setPixmap(QPixmap::fromImage(image));
+  m_qrCodeDisplay->setToolTip(text);
+}

dialogs/edititemdialog.h

@@ -0,0 +1,53 @@
+#ifndef EDITITEMDIALOG_H
+#define EDITITEMDIALOG_H
+
+#include "QrCodeGenerator.h"
+#include "abstractdialog.h"
+
+class QDoubleSpinBox;
+class QLineEdit;
+class QSpinBox;
+class QLabel;
+class QTableView;
+
+class ItemDetailMapper;
+
+class EditItemDialog : public AbstractDialog {
+  Q_OBJECT
+ public:
+  EditItemDialog(QTableView* tableView, QWidget* parent = nullptr);
+
+  /// AbstractDialog interface
+  void createContent() override;
+
+ public slots:
+  void accept() override;
+  void reject() override;
+
+ private slots:
+  void updateQRCode(const QString text = "");
+
+ private:
+  QTableView* m_tableView = nullptr;
+  ItemDetailMapper* m_detailMapper;
+
+  QLabel* m_nameLabel   = nullptr;
+  QLineEdit* m_nameEdit = nullptr;
+
+  QLabel* m_descriptionLabel   = nullptr;
+  QLineEdit* m_descriptionEdit = nullptr;
+
+  QLabel* m_infoLabel   = nullptr;
+  QLineEdit* m_infoEdit = nullptr;
+
+  QLabel* m_amountLabel = nullptr;
+  QSpinBox* m_amountBox = nullptr;
+
+  QLabel* m_factorLabel       = nullptr;
+  QDoubleSpinBox* m_factorBox = nullptr;
+
+  QLabel* m_qrCodeDisplay = nullptr;
+  QrCodeGenerator m_generator;
+};
+
+#endif  // EDITITEMDIALOG_H

dialogs/newitemdialog.cpp

@@ -0,0 +1,81 @@
+#include "newitemdialog.h"
+
+#include <QGridLayout>
+#include <QJsonArray>
+#include <QJsonObject>
+#include <QLabel>
+#include <QLineEdit>
+#include <QSpinBox>
+#include "formats/jsonparser.h"
+#include "model/metadata.h"
+
+NewItemDialog::NewItemDialog(QWidget* parent)
+    : AbstractDialog(QDialogButtonBox::Ok | QDialogButtonBox::Cancel, parent) {}
+
+void NewItemDialog::createContent() {
+  if (m_contentContainer) {
+    delete m_contentContainer;
+  }
+
+  setWindowTitle(tr("New item..."));
+
+  m_contentContainer = new QWidget(this);
+
+  // REFACTOR use a data structure for input widgets which can be iterated through
+  //        using a factory which iterates through the roles from metadata.h
+  //        and create the input widgets based on the data type of this role
+  m_nameLabel = new QLabel("&Name");
+  m_nameEdit  = new QLineEdit();
+  m_nameLabel->setBuddy(m_nameEdit);
+
+  m_descriptionLabel = new QLabel("&Description");
+  m_descriptionEdit  = new QLineEdit();
+  m_descriptionLabel->setBuddy(m_descriptionEdit);
+
+  m_infoLabel = new QLabel("&Info");
+  m_infoEdit  = new QLineEdit();
+  m_infoLabel->setBuddy(m_infoEdit);
+
+  m_amountLabel = new QLabel("&Amount");
+  m_amountBox   = new QSpinBox();
+  m_amountBox->setMaximum(1000);
+  m_amountLabel->setBuddy(m_amountBox);
+
+  m_factorLabel = new QLabel("&Factor");
+  m_factorBox   = new QDoubleSpinBox();
+  m_factorBox->setMaximum(1000);
+  m_factorLabel->setBuddy(m_factorBox);
+
+  QGridLayout* layout = new QGridLayout();
+  layout->addWidget(m_nameLabel, 0, 0, 1, 1);
+  layout->addWidget(m_nameEdit, 0, 1, 1, 1);
+  layout->addWidget(m_descriptionLabel, 1, 0, 1, 1);
+  layout->addWidget(m_descriptionEdit, 1, 1, 1, 1);
+  layout->addWidget(m_infoLabel, 2, 0, 1, 1);
+  layout->addWidget(m_infoEdit, 2, 1, 1, 1);
+  layout->addWidget(m_amountLabel, 3, 0, 1, 1);
+  layout->addWidget(m_amountBox, 3, 1, 1, 1);
+  layout->addWidget(m_factorLabel, 4, 0, 1, 1);
+  layout->addWidget(m_factorBox, 4, 1, 1, 1);
+
+  m_contentContainer->setLayout(layout);
+
+  m_outerLayout->insertWidget(0, m_contentContainer);
+}
+
+void NewItemDialog::accept() {
+  QHash<int, QVariant> itemValues;
+  // TODO (after refactoring data structure for input widgets) use iteration through the relevant
+  //    roles and their input widgets
+  itemValues.insert(NameRole, m_nameEdit->text());
+  itemValues.insert(DescriptionRole, m_descriptionEdit->text());
+  itemValues.insert(InfoRole, m_infoEdit->text());
+  itemValues.insert(AmountRole, m_amountBox->value());
+  itemValues.insert(FactorRole, m_factorBox->value());
+
+  const QByteArray jsonDoc = JsonParser::itemValuesListToJson({itemValues}, ITEM_KEY_STRING);
+  emit addItems(jsonDoc);
+
+  // resetContent();
+  AbstractDialog::accept();
+}

dialogs/newitemdialog.h

@@ -0,0 +1,43 @@
+#ifndef NEWITEMDIALOG_H
+#define NEWITEMDIALOG_H
+
+#include "abstractdialog.h"
+
+class QDoubleSpinBox;
+class QLineEdit;
+class QSpinBox;
+class QLabel;
+
+class NewItemDialog : public AbstractDialog {
+  Q_OBJECT
+
+ public:
+  NewItemDialog(QWidget* parent = nullptr);
+
+  void createContent() override;
+
+ signals:
+  void addItems(const QByteArray& jsonDoc);
+
+ public slots:
+  void accept() override;
+  // void reject() override;
+
+ private:
+  QLabel* m_nameLabel   = nullptr;
+  QLineEdit* m_nameEdit = nullptr;
+
+  QLabel* m_descriptionLabel   = nullptr;
+  QLineEdit* m_descriptionEdit = nullptr;
+
+  QLabel* m_infoLabel   = nullptr;
+  QLineEdit* m_infoEdit = nullptr;
+
+  QLabel* m_amountLabel = nullptr;
+  QSpinBox* m_amountBox = nullptr;
+
+  QLabel* m_factorLabel       = nullptr;
+  QDoubleSpinBox* m_factorBox = nullptr;
+};
+
+#endif  // NEWITEMDIALOG_H

main.cpp

@@ -0,0 +1,29 @@
+#include "mainwindow.h"
+
+#include <QApplication>
+#include <QLocale>
+#include <QTranslator>
+
+#ifdef QT_DEBUG
+#include "utils/messagehandler.h"
+#endif
+
+int main(int argc, char* argv[]) {
+#ifdef QT_DEBUG
+  qInstallMessageHandler(consoleHandlerColoredVerboseInDarkTheme);
+#endif
+  QApplication a(argc, argv);
+
+  QTranslator translator;
+  const QStringList uiLanguages = QLocale::system().uiLanguages();
+  for (const QString& locale : uiLanguages) {
+    const QString baseName = "GenericWidgets_" + QLocale(locale).name();
+    if (translator.load(":/i18n/" + baseName)) {
+      a.installTranslator(&translator);
+      break;
+    }
+  }
+  MainWindow w;
+  w.show();
+  return a.exec();
+}

mainwindow.cpp

@@ -0,0 +1,470 @@
+#include "mainwindow.h"
+#include "./ui_mainwindow.h"
+
+#include <QCloseEvent>
+#include <QFileDialog>
+#include <QInputDialog>
+#include <QMessageBox>
+#include <QStandardPaths>
+#include <QUndoStack>
+#include <QUndoView>
+
+#include "../../ApplicationConfig.h"
+#include "data/settingshandler.h"
+#include "dialogs/edititemdialog.h"
+#include "dialogs/newitemdialog.h"
+#include "genericcore.h"
+#include "model/generalsortfiltermodel.h"
+#include "model/tablemodel.h"
+
+static QStandardPaths::StandardLocation standardLocation = QStandardPaths::HomeLocation;
+static QString updateTextClean = "Do you want to update the application now?";
+static QString updateTextDirty = "Do you want to save the tasks & update the application now?";
+
+MainWindow::MainWindow(QWidget* parent)
+    : QMainWindow(parent)
+    , ui(new Ui::MainWindow) {
+  ui->setupUi(this);
+
+  m_core = std::make_unique<GenericCore>();
+
+  setWindowTitle(QCoreApplication::applicationName() + " [*]");
+
+  /// application icon
+  const QString iconString = "://feature.png";
+#ifdef QT_DEBUG
+  QPixmap pixmap       = QPixmap(iconString);
+  QTransform transform = QTransform();
+  transform.rotate(180);
+  QPixmap rotated = pixmap.transformed(transform);
+  setWindowIcon(QIcon(rotated));
+#else
+  setWindowIcon(QIcon(iconString));
+#endif
+
+  const QVariantMap settings = SettingsHandler::getSettings("GUI");
+  restoreGeometry(settings.value("geometry").toByteArray());
+  restoreState(settings.value("windowState").toByteArray());
+
+  // m_tableModel = m_core->getModel();
+  // ui->tableView->setModel(m_tableModel.get());
+  m_proxyModel = m_core->getSortFilterModel();
+  ui->tableView->setModel((QAbstractItemModel*)m_proxyModel.get());
+  ui->tableView->setSortingEnabled(true);
+
+  createActions();
+  createHelpMenu();
+  createGuiDialogs();
+
+  connect(m_core.get(), &GenericCore::displayStatusMessage, this,
+          &MainWindow::displayStatusMessage);
+  connect(this, &MainWindow::displayStatusMessage, this, &MainWindow::showStatusMessage);
+  connect(this, &MainWindow::checkForUpdates, this,
+          &MainWindow::on_actionCheck_for_update_triggered, Qt::QueuedConnection);
+
+  // connect(ui->tableView->selectionModel(), &QItemSelectionModel::selectionChanged, this,
+  //         &MainWindow::onSelectionChanged);
+  connect(ui->tableView->selectionModel(), &QItemSelectionModel::currentChanged, this,
+          &MainWindow::onCurrentChanged);
+
+  onSelectionChanged(QItemSelection(), QItemSelection());
+  onCurrentChanged(QModelIndex(), QModelIndex());
+}
+
+MainWindow::~MainWindow() { delete ui; }
+
+void MainWindow::closeEvent(QCloseEvent* event) {
+  if (isWindowModified()) {
+    QMessageBox msgBox;
+    msgBox.setWindowTitle(windowTitle() + " - Save dialog");
+    msgBox.setText("The document has been modified.");
+    msgBox.setInformativeText("Do you want to save your changes?");
+    msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
+    msgBox.setDefaultButton(QMessageBox::Save);
+    int ret = msgBox.exec();
+
+    switch (ret) {
+      case QMessageBox::Save:
+        emit saveItems();
+        event->accept();
+        break;
+      case QMessageBox::Discard:
+        event->accept();
+        break;
+      case QMessageBox::Cancel:
+        event->ignore();
+        break;
+      default:
+        /// should never be reached
+        qCritical() << "unexpected switch case in closeEvent:" << ret;
+        event->ignore();
+        break;
+    }
+  } else {
+    event->accept();
+  }
+
+  if (event->isAccepted()) {
+    qInfo() << "Saving GUI settings...";
+    SettingsHandler::saveSettings({{"geometry", saveGeometry()}, {"windowState", saveState()}},
+                                  "GUI");
+  }
+}
+
+void MainWindow::showStatusMessage(const QString text) {
+  qInfo() << text;
+  ui->statusbar->showMessage(text);
+}
+
+void MainWindow::onCurrentChanged(const QModelIndex& current, const QModelIndex& previous) {
+  // Q_UNUSED(current);
+  Q_UNUSED(previous);
+
+  // QItemSelection localSelection = ui->tableView->selectionModel()->selection();
+  if (current == QModelIndex()) {
+    // qDebug() << "Nothing selected. Disabling delete action";
+    m_deleteItemAct->setEnabled(false);
+  } else {
+    // qDebug() << "Something selected. Enabling delete action";
+    m_deleteItemAct->setEnabled(true);
+  }
+}
+
+void MainWindow::onSelectionChanged(const QItemSelection& selected,
+                                    const QItemSelection& deselected) {
+  Q_UNUSED(selected);
+  Q_UNUSED(deselected);
+
+  QItemSelection localSelection = ui->tableView->selectionModel()->selection();
+  if (localSelection.empty()) {
+    // qDebug() << "Nothing selected. Disabling delete action";
+    m_deleteItemAct->setEnabled(false);
+  } else {
+    // qDebug() << "Something selected. Enabling delete action";
+    m_deleteItemAct->setEnabled(true);
+  }
+}
+
+void MainWindow::onAboutClicked() {
+  const QString applicationName = APPLICATION_NAME;
+  const QString titlePrefix     = tr("About ");
+  const QString aboutText =
+      tr(QString("<b>%1 v%2</b> is a template for Qt applications."
+                 "<br><br><a href=\"https://working-copy.org/\">Working-Copy_Collective website</a>"
+                 "<br><br><a href=\"mailto:support@working-copy.org\">Mail to support</a>"
+                 "<br><br>It uses the <a href=\"https://qt.io\">Qt Framework</a>.")
+             .arg(applicationName)
+             .arg(APPLICATION_VERSION)
+             .toLatin1());
+  QMessageBox::about(this, titlePrefix + applicationName, aboutText);
+}
+
+void MainWindow::on_actionCheck_for_update_triggered() {
+  showStatusMessage("Checking for update...");
+  const bool updateAvailable = m_core->isApplicationUpdateAvailable();
+  if (updateAvailable) {
+    const QString text = isWindowModified() ? updateTextDirty : updateTextClean;
+    const QMessageBox::StandardButton clickedButton = QMessageBox::question(
+        this, tr("Update available."), text, QMessageBox::Yes | QMessageBox::No, QMessageBox::Yes);
+    if (clickedButton == QMessageBox::Yes) {
+      m_core->triggerApplicationUpdate(true);
+      close();
+    }
+  }
+}
+
+void MainWindow::on_pushButton_clicked() {
+  const QString prefix("Backend provided by: ");
+  ui->label->setText(prefix + m_core->toString());
+}
+
+void MainWindow::openNewItemDialog() {
+  showStatusMessage(tr("Invoked 'Edit|New Item'"));
+  m_newItemDialog->show();
+}
+
+void MainWindow::openEditItemDialog() {
+  showStatusMessage(tr("Invoked 'Edit|Edit Item'"));
+  m_editItemDialog->show();
+}
+
+void MainWindow::deleteCurrentItem() {
+  showStatusMessage(tr("Invoked 'Edit|Delete Item'"));
+  // QItemSelection localSelection  = ui->tableView->selectionModel()->selection();
+  const QModelIndex currentIndex = ui->tableView->selectionModel()->currentIndex();
+  if (currentIndex == QModelIndex()) {
+    qDebug() << "No current item. Nothing to remove.";
+  } else {
+    m_proxyModel->removeRows(currentIndex.row(), 1);
+  }
+}
+
+void MainWindow::deleteSelectedtItems() {
+  showStatusMessage(tr("Invoked 'Edit|Delete Item'"));
+  QItemSelection localSelection = ui->tableView->selectionModel()->selection();
+  if (localSelection.empty()) {
+    qDebug() << "No items selected. Nothing to remove.";
+  } else {
+    for (QList<QItemSelectionRange>::reverse_iterator iter = localSelection.rbegin(),
+                                                      rend = localSelection.rend();
+         iter != rend; ++iter) {
+      // qInfo() << "iter:" << *iter;
+      // const QModelIndex parentIndex = iter->parent();
+      const int topRow    = iter->top();
+      const int bottomRow = iter->bottom();
+      const int nRows     = bottomRow - topRow + 1;
+      m_proxyModel->removeRows(topRow, nRows);
+    }
+  }
+}
+
+void MainWindow::onCleanStateChanged(bool clean) {
+  qInfo() << "Slot onCleanStateChanged triggered: clean:" << clean;
+  setWindowModified(!clean);
+  if (!clean) {
+    ui->statusbar->clearMessage();
+  }
+}
+
+void MainWindow::onShowUndoViewToggled(bool checked) {
+  //  qInfo() << "Slot onShowUndoViewToggled toggled: checked:" << checked;
+  //  m_undoView->setVisible(checked);
+
+  /// workaround until m_showUndoViewAction is checkable
+  qInfo() << "Slot onShowUndoViewToggled triggered, toggleing undo view...";
+  Q_UNUSED(checked);
+  if (m_modelUndoView->isVisible()) {
+    m_modelUndoView->setVisible(false);
+
+  } else {
+    m_modelUndoView->setVisible(true);
+  }
+}
+
+void MainWindow::saveItems() {
+  showStatusMessage(tr("Invoked 'File|Save'"));
+  m_core->saveItems();
+}
+
+void MainWindow::importCSV() {
+  showStatusMessage(tr("Invoked 'File|Import CSV'"));
+  const QString csvFilePath = QFileDialog::getOpenFileName(
+      this, tr("Import CSV"), QStandardPaths::standardLocations(standardLocation).first(),
+      tr("CSV Files (*.csv)"));
+  if (QFileInfo::exists(csvFilePath)) {
+    m_core->importCSVFile(csvFilePath);
+    showStatusMessage(tr("Imported CSV file."));
+  } else {
+    qWarning() << "Selected CSV file path doesn't exist. Doing nothing...";
+    showStatusMessage(tr("Could't find CSV file!"));
+  }
+}
+
+void MainWindow::exportCSV() {
+  showStatusMessage(tr("Invoked 'File|Export'"));
+  const QString filter   = tr("CSV Files (*.csv)");
+  const QString location = QStandardPaths::standardLocations(standardLocation).first();
+  QFileDialog dialog(this, "Export CSV File", location, "Comma-separated file (*.csv)");
+  dialog.setDefaultSuffix(".csv");
+  dialog.setAcceptMode(QFileDialog::AcceptSave);
+  if (dialog.exec()) {
+    const QString csvFilePath = dialog.selectedFiles().first();
+    const bool successful     = m_core->exportCSVFile(csvFilePath);
+    if (successful) {
+      const QString message = QString(tr("CSV exported to: %1")).arg(csvFilePath);
+      showStatusMessage(message);
+    }
+  } else {
+    qWarning() << "Selected CSV file path doesn't exist. Doing nothing...";
+  }
+}
+
+void MainWindow::findItems() {
+  showStatusMessage(tr("Invoked 'Edit|Find items'"));
+
+  bool ok;
+  QString text = QInputDialog::getText(this, tr("Find items"), tr("Enter the text to search for:"),
+                                       QLineEdit::Normal, "", &ok);
+  if (ok && !text.isEmpty()) {
+    const QItemSelection itemsToSelect = m_proxyModel->findItems(text);
+    if (itemsToSelect.empty()) {
+      ui->tableView->setCurrentIndex(QModelIndex());
+      ui->tableView->selectionModel()->select(QModelIndex(), QItemSelectionModel::ClearAndSelect);
+    } else {
+      ui->tableView->setCurrentIndex(itemsToSelect.first().topLeft());
+      ui->tableView->selectionModel()->select(itemsToSelect, QItemSelectionModel::ClearAndSelect);
+    }
+  }
+}
+
+void MainWindow::createActions() {
+  // TODO add generic menu actions (file/new, edit/cut, ...)
+  createFileActions();
+  createUndoActions();
+  createEditActions();
+}
+
+void MainWindow::createFileActions() {
+  m_newFileAct = make_unique<QAction>(tr("&New File"), this);
+  m_newFileAct->setShortcut(QKeySequence(Qt::CTRL | Qt::SHIFT | Qt::Key_N));
+  m_newFileAct->setStatusTip(tr("Create a new file"));
+  // connect(m_newAct, &QAction::triggered, this, &MainWindow::newFile);
+  m_newFileAct->setEnabled(false);
+  ui->menu_File->addAction(m_newFileAct.get());
+
+  m_openAct = make_unique<QAction>(tr("&Open..."), this);
+  m_openAct->setShortcuts(QKeySequence::Open);
+  m_openAct->setStatusTip(tr("Open an existing file"));
+  // connect(m_openAct, &QAction::triggered, this, &MainWindow::open);
+  m_openAct->setEnabled(false);
+  ui->menu_File->addAction(m_openAct.get());
+
+  m_saveAct = make_unique<QAction>(tr("&Save"), this);
+  m_saveAct->setShortcuts(QKeySequence::Save);
+  m_saveAct->setStatusTip(tr("Save the document to disk"));
+  connect(m_saveAct.get(), &QAction::triggered, this, &MainWindow::saveItems);
+  ui->menu_File->addAction(m_saveAct.get());
+
+  ui->menu_File->addSeparator();
+
+  m_importAct = make_unique<QAction>(tr("&Import CSV..."), this);
+  m_importAct->setStatusTip(tr("Import an existing CSV file"));
+  connect(m_importAct.get(), &QAction::triggered, this, &MainWindow::importCSV);
+  ui->menu_File->addAction(m_importAct.get());
+
+  m_exportAct = make_unique<QAction>(tr("&Export CSV..."), this);
+  m_exportAct->setStatusTip(tr("Export content to a CSV document to disk"));
+  connect(m_exportAct.get(), &QAction::triggered, this, &MainWindow::exportCSV);
+  ui->menu_File->addAction(m_exportAct.get());
+
+  ui->menu_File->addSeparator();
+
+  m_printAct = make_unique<QAction>(tr("&Print..."), this);
+  m_printAct->setShortcuts(QKeySequence::Print);
+  m_printAct->setStatusTip(tr("Print the document"));
+  // connect(m_printAct, &QAction::triggered, this, &MainWindow::print);
+  m_printAct->setEnabled(false);
+  ui->menu_File->addAction(m_printAct.get());
+
+  ui->menu_File->addSeparator();
+
+  m_exitAct = make_unique<QAction>(tr("E&xit"), this);
+  m_exitAct->setShortcuts(QKeySequence::Quit);
+  m_exitAct->setStatusTip(tr("Exit the application"));
+  connect(m_exitAct.get(), &QAction::triggered, this, &QWidget::close);
+  ui->menu_File->addAction(m_exitAct.get());
+}
+
+void MainWindow::createUndoActions() {
+  if (!m_core) {
+    qCritical() << "No core instance set, aborting...";
+    return;
+  }
+  m_modelUndoStack = m_core->getModelUndoStack();
+
+  connect(m_modelUndoStack, &QUndoStack::cleanChanged, this, &MainWindow::onCleanStateChanged);
+
+  m_undoAct.reset(m_modelUndoStack->createUndoAction(this, tr("&Undo")));
+  m_undoAct->setShortcuts(QKeySequence::Undo);
+  m_undoAct->setStatusTip(tr("Undo the last operation"));
+  ui->menu_Edit->addAction(m_undoAct.get());
+
+  m_redoAct.reset(m_modelUndoStack->createRedoAction(this, tr("&Redo")));
+  m_redoAct->setShortcuts(QKeySequence::Redo);
+  m_redoAct->setStatusTip(tr("Redo the last operation"));
+  ui->menu_Edit->addAction(m_redoAct.get());
+
+  m_modelUndoView = make_unique<QUndoView>(m_modelUndoStack);
+  m_modelUndoView->setWindowTitle(tr("Undo list"));
+  m_modelUndoView->setAttribute(Qt::WA_QuitOnClose, false);
+  m_modelUndoView->setMinimumSize(450, 600);
+  m_showModelUndoViewAct = make_unique<QAction>(tr("Show undo/redo window"), this);
+  m_showModelUndoViewAct->setStatusTip(tr("Opens a window displaying the items on the undo stack"));
+
+  // TODO showUndoViewAction should be checkable
+  //  m_showUndoViewAction->setCheckable(true);
+  //  connect(m_showUndoViewAction, &QAction::toggled, this, &MainWindow::onShowUndoViewToggled);
+  connect(m_showModelUndoViewAct.get(), &QAction::triggered, this,
+          &MainWindow::onShowUndoViewToggled);
+  ui->menu_View->addAction(m_showModelUndoViewAct.get());
+}
+
+void MainWindow::createEditActions() {
+  m_cutAct = make_unique<QAction>(tr("Cu&t"), this);
+  m_cutAct->setShortcuts(QKeySequence::Cut);
+  m_cutAct->setStatusTip(
+      tr("Cut the current selection's contents to the "
+         "clipboard"));
+  // connect(m_cutAct, &QAction::triggered, this, &MainWindow::cut);
+  m_cutAct->setEnabled(false);
+  ui->menu_Edit->addAction(m_cutAct.get());
+
+  m_copyAct = make_unique<QAction>(tr("&Copy"), this);
+  m_copyAct->setShortcuts(QKeySequence::Copy);
+  m_copyAct->setStatusTip(
+      tr("Copy the current selection's contents to the "
+         "clipboard"));
+  // connect(m_copyAct, &QAction::triggered, this, &MainWindow::copy);
+  m_copyAct->setEnabled(false);
+  ui->menu_Edit->addAction(m_copyAct.get());
+
+  m_pasteAct = make_unique<QAction>(tr("&Paste"), this);
+  m_pasteAct->setShortcuts(QKeySequence::Paste);
+  m_pasteAct->setStatusTip(
+      tr("Paste the clipboard's contents into the current "
+         "selection"));
+  // connect(m_pasteAct, &QAction::triggered, this, &MainWindow::paste);
+  m_pasteAct->setEnabled(false);
+  ui->menu_Edit->addAction(m_pasteAct.get());
+
+  ui->menu_Edit->addSeparator();
+
+  m_openNewItemDialogAct = make_unique<QAction>(tr("&New item"), this);
+  m_openNewItemDialogAct->setShortcut(QKeySequence::New);
+  m_openNewItemDialogAct->setStatusTip(tr("Opens a dialog to add a new item"));
+  connect(m_openNewItemDialogAct.get(), &QAction::triggered, this, &MainWindow::openNewItemDialog);
+  ui->menu_Edit->addAction(m_openNewItemDialogAct.get());
+
+  m_openEditItemDialogAct = make_unique<QAction>(tr("&Edit item"), this);
+  m_openEditItemDialogAct->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_E));
+  m_openEditItemDialogAct->setStatusTip(tr("Opens a edit dialog for the current item"));
+  connect(m_openEditItemDialogAct.get(), &QAction::triggered, this,
+          &MainWindow::openEditItemDialog);
+  ui->menu_Edit->addAction(m_openEditItemDialogAct.get());
+
+  m_deleteItemAct = make_unique<QAction>(tr("&Delete item(s)"), this);
+  m_deleteItemAct->setShortcuts(QKeySequence::Delete);
+  m_deleteItemAct->setStatusTip(tr("Delete currently selected item(s)"));
+  // connect(m_deleteItemAct.get(), &QAction::triggered, this, &MainWindow::deleteSelectedtItems);
+  connect(m_deleteItemAct.get(), &QAction::triggered, this, &MainWindow::deleteCurrentItem);
+  ui->menu_Edit->addAction(m_deleteItemAct.get());
+
+  ui->menu_Edit->addSeparator();
+
+  m_findItemAct = make_unique<QAction>(tr("&Find item(s)"), this);
+  m_findItemAct->setShortcuts(QKeySequence::Find);
+  m_findItemAct->setStatusTip(tr("Opens a dialog to find item(s) by containing text"));
+  connect(m_findItemAct.get(), &QAction::triggered, this, &MainWindow::findItems);
+  ui->menu_Edit->addAction(m_findItemAct.get());
+}
+
+void MainWindow::createHelpMenu() {
+  QMenu* helpMenu = ui->menu_Help;
+  helpMenu->addSeparator();
+  QAction* aboutAct = helpMenu->addAction(tr("&About"), this, &MainWindow::onAboutClicked);
+  aboutAct->setStatusTip(tr("Show the application's About box"));
+
+  QAction* aboutQtAct = helpMenu->addAction(tr("About &Qt"), qApp, &QApplication::aboutQt);
+  aboutQtAct->setStatusTip(tr("Show the Qt library's About box"));
+}
+
+void MainWindow::createGuiDialogs() {
+  /// new item dialog
+  m_newItemDialog = make_unique<NewItemDialog>(this);
+  m_newItemDialog->createContent();
+  connect(m_newItemDialog.get(), &NewItemDialog::addItems, m_proxyModel.get(),
+          &GeneralSortFilterModel::appendItems);
+  /// edit item dialog
+  m_editItemDialog = make_unique<EditItemDialog>(ui->tableView, this);
+  m_editItemDialog->createContent();
+}

mainwindow.h

@@ -0,0 +1,107 @@
+#ifndef MAINWINDOW_H
+#define MAINWINDOW_H
+
+#include <QItemSelection>
+#include <QMainWindow>
+
+QT_BEGIN_NAMESPACE
+
+class QUndoStack;
+
+class QUndoView;
+namespace Ui {
+class MainWindow;
+}
+QT_END_NAMESPACE
+
+class GenericCore;
+class TableModel;
+class GeneralSortFilterModel;
+class NewItemDialog;
+class EditItemDialog;
+
+using namespace std;
+
+class MainWindow : public QMainWindow {
+  Q_OBJECT
+
+ public:
+  MainWindow(QWidget* parent = nullptr);
+  ~MainWindow();
+
+ signals:
+  void displayStatusMessage(QString message);
+  void checkForUpdates();
+
+ protected:
+  void closeEvent(QCloseEvent* event) override;
+
+ private slots:
+  void showStatusMessage(const QString text);
+  void onCurrentChanged(const QModelIndex& current, const QModelIndex& previous);
+  void onSelectionChanged(const QItemSelection& selected, const QItemSelection& deselected);
+
+  void onAboutClicked();
+  void on_actionCheck_for_update_triggered();
+
+  void on_pushButton_clicked();
+
+  /// slots for menu actions
+  void openNewItemDialog();
+  void openEditItemDialog();
+  void deleteCurrentItem();
+  void deleteSelectedtItems();
+
+  void onCleanStateChanged(bool clean);
+  void onShowUndoViewToggled(bool checked);
+
+  /// 'File' slots
+  void saveItems();
+  void importCSV();
+  void exportCSV();
+
+  /// 'Edit' slots
+  void findItems();
+
+ private:
+  Ui::MainWindow* ui;
+
+  unique_ptr<GenericCore> m_core;
+  shared_ptr<GeneralSortFilterModel> m_proxyModel;
+  QUndoStack* m_modelUndoStack;
+  unique_ptr<QUndoView> m_modelUndoView;
+
+  /// File actions
+  unique_ptr<QAction> m_newFileAct;
+  unique_ptr<QAction> m_openAct;
+  unique_ptr<QAction> m_saveAct;
+  unique_ptr<QAction> m_importAct;
+  unique_ptr<QAction> m_exportAct;
+  unique_ptr<QAction> m_printAct;
+  unique_ptr<QAction> m_exitAct;
+  /// Edit actions
+  unique_ptr<QAction> m_undoAct;
+  unique_ptr<QAction> m_redoAct;
+  unique_ptr<QAction> m_cutAct;
+  unique_ptr<QAction> m_copyAct;
+  unique_ptr<QAction> m_pasteAct;
+  unique_ptr<QAction> m_openNewItemDialogAct;
+  unique_ptr<QAction> m_openEditItemDialogAct;
+  unique_ptr<QAction> m_deleteItemAct;
+  unique_ptr<QAction> m_findItemAct;
+  /// View actions
+  unique_ptr<QAction> m_showModelUndoViewAct;
+
+  /// Dialogs
+  unique_ptr<NewItemDialog> m_newItemDialog;
+  unique_ptr<EditItemDialog> m_editItemDialog;
+
+  /// Setup functions
+  void createActions();
+  void createFileActions();
+  void createUndoActions();
+  void createEditActions();
+  void createHelpMenu();
+  void createGuiDialogs();
+};
+#endif  // MAINWINDOW_H

mainwindow.ui

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MainWindow</class>
+ <widget class="QMainWindow" name="MainWindow">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>800</width>
+    <height>600</height>
+   </rect>
+  </property>
+  <property name="windowTitle">
+   <string>GenericQtClient</string>
+  </property>
+  <widget class="QWidget" name="centralwidget">
+   <layout class="QVBoxLayout" name="verticalLayout">
+    <item>
+     <widget class="QTableView" name="tableView"/>
+    </item>
+    <item>
+     <widget class="QLabel" name="label">
+      <property name="text">
+       <string>Push the button!</string>
+      </property>
+     </widget>
+    </item>
+    <item>
+     <widget class="QPushButton" name="pushButton">
+      <property name="text">
+       <string>Button</string>
+      </property>
+     </widget>
+    </item>
+   </layout>
+  </widget>
+  <widget class="QMenuBar" name="menubar">
+   <property name="geometry">
+    <rect>
+     <x>0</x>
+     <y>0</y>
+     <width>800</width>
+     <height>25</height>
+    </rect>
+   </property>
+   <widget class="QMenu" name="menu_File">
+    <property name="title">
+     <string>&amp;File</string>
+    </property>
+   </widget>
+   <widget class="QMenu" name="menu_Edit">
+    <property name="title">
+     <string>&amp;Edit</string>
+    </property>
+   </widget>
+   <widget class="QMenu" name="menu_View">
+    <property name="title">
+     <string>&amp;View</string>
+    </property>
+   </widget>
+   <widget class="QMenu" name="menu_Help">
+    <property name="title">
+     <string>&amp;Help</string>
+    </property>
+    <addaction name="actionCheck_for_update"/>
+   </widget>
+   <addaction name="menu_File"/>
+   <addaction name="menu_Edit"/>
+   <addaction name="menu_View"/>
+   <addaction name="menu_Help"/>
+  </widget>
+  <widget class="QStatusBar" name="statusbar"/>
+  <action name="actionCheck_for_update">
+   <property name="text">
+    <string>Check for &amp;update</string>
+   </property>
+  </action>
+ </widget>
+ <resources/>
+ <connections/>
+ <slots>
+  <slot>onPushButtonClicked()</slot>
+ </slots>
+</ui>

utils/messagehandler.h

@@ -0,0 +1,164 @@
+#ifndef MESSAGEHANDLER_H
+#define MESSAGEHANDLER_H
+/**
+ * Color and formatting codes
+ * @see: http://misc.flogisoft.com/bash/tip_colors_and_formatting
+ */
+
+#include <QObject>
+
+//  qSetMessagePattern("%{file}(%{line}): %{message}");
+//  qSetMessagePattern("%{type}(%{line}):\t%{message}");
+//  qSetMessagePattern("%{type}%{file}(%{line}):\t%{message}");
+
+void consoleHandlerColoredVerbose(QtMsgType type,
+                                  const QMessageLogContext& context,
+                                  const QString& msg) {
+  QByteArray localMsg = msg.toLocal8Bit();
+  switch (type) {
+    case QtDebugMsg:
+      //      fprintf(stderr, "\033[1;30mDebug: (%s:%u, %s) \t%s\n\033[0m", context.file,
+      //      context.line, context.function, localMsg.constData());  // bold
+      fprintf(stderr, "\033[107;30mDebug: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtInfoMsg:
+      fprintf(stderr, "\033[107;32mInfo:  (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtWarningMsg:
+      fprintf(stderr, "\033[43;30mWarning: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtCriticalMsg:
+      fprintf(stderr, "\033[41;30mCritical: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtFatalMsg:
+      fprintf(stderr, "\033[41;30mFatal: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      abort();
+  }
+}
+
+void consoleHandlerColoredVerboseInDarkTheme(QtMsgType type,
+                                             const QMessageLogContext& context,
+                                             const QString& msg) {
+  QByteArray localMsg = msg.toLocal8Bit();
+  switch (type) {
+    case QtDebugMsg:
+      //      fprintf(stderr, "\033[1;30mDebug: (%s:%u, %s) \t%s\n\033[0m", context.file,
+      //      context.line, context.function, localMsg.constData());  // bold
+      fprintf(stderr, "\033[107;37mDebug: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtInfoMsg:
+      fprintf(stderr, "\033[107;32mInfo:  (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtWarningMsg:
+      fprintf(stderr, "\033[43;30mWarning: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtCriticalMsg:
+      fprintf(stderr, "\033[41;30mCritical: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      break;
+    case QtFatalMsg:
+      fprintf(stderr, "\033[41;30mFatal: (%s:%u, %s) \t%s\n\033[0m", context.file, context.line,
+              context.function, localMsg.constData());
+      abort();
+  }
+}
+
+void consoleHandlerColored(QtMsgType type, const QMessageLogContext& context, const QString& msg) {
+  QByteArray localMsg = msg.toLocal8Bit();
+  switch (type) {
+    case QtDebugMsg:
+      fprintf(stderr, "\033[1;30mDebug: (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtInfoMsg:
+      fprintf(stderr, "\033[0;30mInfo:  (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtWarningMsg:
+      fprintf(stderr, "\033[1;33mWarning: (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtCriticalMsg:
+      fprintf(stderr, "\033[31mCritical: (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      break;
+    case QtFatalMsg:
+      fprintf(stderr, "\033[31mFatal: (%s:%u) \t%s\n\033[0m", context.file, context.line,
+              localMsg.constData());
+      abort();
+  }
+}
+
+void myMessageOutput(QtMsgType type, const QMessageLogContext& context, const QString& msg) {
+  QByteArray localMsg = msg.toLocal8Bit();
+  switch (type) {
+    case QtDebugMsg:
+      fprintf(stderr, "Debug: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line,
+              context.function);
+      break;
+    case QtInfoMsg:
+      fprintf(stderr, "Info: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line,
+              context.function);
+      break;
+    case QtWarningMsg:
+      fprintf(stderr, "Warning: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line,
+              context.function);
+      break;
+    case QtCriticalMsg:
+      fprintf(stderr, "Critical: %s (%s:%u, %s)\n", localMsg.constData(), context.file,
+              context.line, context.function);
+      break;
+    case QtFatalMsg:
+      fprintf(stderr, "Fatal: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line,
+              context.function);
+      abort();
+  }
+}
+
+#ifdef Q_OS_ANDROID
+#include <android/log.h>
+
+const char* const applicationName = "Pensieve";
+void androidMessageHandler(QtMsgType type, const QMessageLogContext& context, const QString& msg) {
+  QString report = msg;
+  if (context.file && !QString(context.file).isEmpty()) {
+    report += " in file ";
+    report += QString(context.file);
+    report += " line ";
+    report += QString::number(context.line);
+  }
+  if (context.function && !QString(context.function).isEmpty()) {
+    report += +" function ";
+    report += QString(context.function);
+  }
+  const char* const local = report.toLocal8Bit().constData();
+  switch (type) {
+    case QtDebugMsg:
+      __android_log_write(ANDROID_LOG_DEBUG, applicationName, local);
+      break;
+    case QtInfoMsg:
+      __android_log_write(ANDROID_LOG_INFO, applicationName, local);
+      break;
+    case QtWarningMsg:
+      __android_log_write(ANDROID_LOG_WARN, applicationName, local);
+      break;
+    case QtCriticalMsg:
+      __android_log_write(ANDROID_LOG_ERROR, applicationName, local);
+      break;
+    case QtFatalMsg:
+    default:
+      __android_log_write(ANDROID_LOG_FATAL, applicationName, local);
+      abort();
+  }
+}
+#endif
+
+#endif  // MESSAGEHANDLER_H

views/itemdetailmapper.cpp

@@ -0,0 +1,160 @@
+#include "itemdetailmapper.h"
+
+#include <QAbstractItemModel>
+#include <QDataWidgetMapper>
+#include <QGridLayout>
+#include <QJsonArray>
+#include <QJsonObject>
+#include <QLabel>
+#include <QLineEdit>
+#include <QPushButton>
+#include <QSpinBox>
+#include <QTableView>
+#include "model/metadata.h"
+
+ItemDetailMapper::ItemDetailMapper(QWidget* parent)
+    : QWidget{parent} {
+  /// model mapping
+  m_mapper = std::make_unique<QDataWidgetMapper>(this);
+  /// BUG: If multiple columns are changed not all changes are applied.
+  ///     Multiple changes are set individually by calling setData().
+  ///     Probably due to a conflicting dataChanged signal for too many roles&columns the data of
+  ///     the remaining columns is reset before setData is called.
+  ///     And a manual submit would also create multiple undo steps anyway.
+  /// Workaround: ManualSubmit -> AutoSubmit
+  // m_mapper->setSubmitPolicy(QDataWidgetMapper::ManualSubmit);
+  m_mapper->setSubmitPolicy(QDataWidgetMapper::AutoSubmit);
+
+  /// model mapping buttons
+  m_nextButton     = new QPushButton(tr("Ne&xt"));
+  m_previousButton = new QPushButton(tr("&Previous"));
+
+  connect(m_previousButton, &QAbstractButton::clicked, this, &ItemDetailMapper::toPrevious);
+  connect(m_nextButton, &QAbstractButton::clicked, this, &ItemDetailMapper::toNext);
+
+  /// the individual widgets
+  // REFACTOR deduce label names and types from meta data & use a factory
+  m_nameLabel = new QLabel("&Name");
+  m_nameEdit  = new QLineEdit();
+  m_nameLabel->setBuddy(m_nameEdit);
+
+  m_descriptionLabel = new QLabel("&Description");
+  m_descriptionEdit  = new QLineEdit();
+  m_descriptionLabel->setBuddy(m_descriptionEdit);
+
+  m_infoLabel = new QLabel("&Info");
+  m_infoEdit  = new QLineEdit();
+  m_infoLabel->setBuddy(m_infoEdit);
+
+  m_amountLabel = new QLabel("&Amount");
+  m_amountBox   = new QSpinBox();
+  m_amountBox->setMaximum(1000);
+  m_amountLabel->setBuddy(m_amountBox);
+
+  m_factorLabel = new QLabel("&Factor");
+  m_factorBox   = new QDoubleSpinBox();
+  m_factorBox->setMaximum(1000);
+  m_factorLabel->setBuddy(m_factorBox);
+
+  QGridLayout* layout = new QGridLayout();
+  layout->addWidget(m_nameLabel, 0, 0, 1, 1);
+  layout->addWidget(m_nameEdit, 0, 1, 1, 1);
+  layout->addWidget(m_descriptionLabel, 1, 0, 1, 1);
+  layout->addWidget(m_descriptionEdit, 1, 1, 1, 1);
+  layout->addWidget(m_infoLabel, 2, 0, 1, 1);
+  layout->addWidget(m_infoEdit, 2, 1, 1, 1);
+  layout->addWidget(m_amountLabel, 3, 0, 1, 1);
+  layout->addWidget(m_amountBox, 3, 1, 1, 1);
+  layout->addWidget(m_factorLabel, 4, 0, 1, 1);
+  layout->addWidget(m_factorBox, 4, 1, 1, 1);
+
+  layout->addWidget(m_previousButton, 5, 0, 1, 1);
+  layout->addWidget(m_nextButton, 5, 1, 1, 1);
+
+  setLayout(layout);
+}
+
+void ItemDetailMapper::setModelMappings(QTableView* tableView) {
+  qDebug() << "Setting model...";
+  m_tableView      = tableView;
+  m_model          = tableView->model();
+  m_selectionModel = tableView->selectionModel();
+
+  m_mapper->setModel(m_model);
+  m_mapper->addMapping(m_nameEdit, 0);
+  m_mapper->addMapping(m_descriptionEdit, 1);
+  m_mapper->addMapping(m_infoEdit, 2);
+  m_mapper->addMapping(m_amountBox, 3);
+  m_mapper->addMapping(m_factorBox, 4);
+
+  m_mapper->setCurrentIndex(m_selectionModel->currentIndex().row());
+
+  connect(m_model, &QAbstractItemModel::rowsInserted, this, &ItemDetailMapper::rowsInserted);
+  connect(m_model, &QAbstractItemModel::rowsRemoved, this, &ItemDetailMapper::rowsRemoved);
+  connect(m_selectionModel, &QItemSelectionModel::currentChanged, this,
+          &ItemDetailMapper::onCurrentIndexChanged);
+
+  updateButtons(m_selectionModel->currentIndex().row());
+}
+
+bool ItemDetailMapper::submit() { return m_mapper->submit(); }
+
+void ItemDetailMapper::revert() { m_mapper->revert(); }
+
+void ItemDetailMapper::onCurrentIndexChanged(const QModelIndex& current,
+                                             const QModelIndex& /*previous*/) {
+  if (!isEnabled()) {
+    setEnabled(true);
+  }
+  m_mapper->setCurrentModelIndex(current);
+  updateButtons(current.row());
+  emitContentChanged(current);
+}
+
+void ItemDetailMapper::rowsInserted(const QModelIndex& parent, int start, int end) {
+  updateButtons(m_mapper->currentIndex());
+}
+
+void ItemDetailMapper::rowsRemoved(const QModelIndex& parent, int start, int end) {
+  if (m_model->rowCount() == 0) {
+    setEnabled(false);
+
+    m_nameEdit->clear();
+    m_descriptionEdit->clear();
+    m_infoEdit->clear();
+    m_amountBox->clear();
+    m_factorBox->clear();
+  }
+
+  updateButtons(m_mapper->currentIndex());
+}
+
+void ItemDetailMapper::toPrevious() {
+  int currentRow            = m_selectionModel->currentIndex().row();
+  QModelIndex previousIndex = m_selectionModel->currentIndex().siblingAtRow(currentRow - 1);
+  if (previousIndex.isValid()) {
+    m_selectionModel->setCurrentIndex(previousIndex, QItemSelectionModel::ClearAndSelect);
+  }
+}
+
+void ItemDetailMapper::toNext() {
+  int currentRow        = m_selectionModel->currentIndex().row();
+  QModelIndex nextIndex = m_selectionModel->currentIndex().siblingAtRow(currentRow + 1);
+  if (nextIndex.isValid()) {
+    m_selectionModel->setCurrentIndex(nextIndex, QItemSelectionModel::ClearAndSelect);
+  }
+}
+
+void ItemDetailMapper::updateButtons(int row) {
+  m_previousButton->setEnabled(row > 0);
+  m_nextButton->setEnabled(row < m_model->rowCount() - 1);
+}
+
+void ItemDetailMapper::emitContentChanged(const QModelIndex& currentIndex) {
+  // BUG QR-Code isn't updated after changes through the ItemDetailMapper #18
+  QString toStringText = "";
+  if (currentIndex.isValid()) {
+    toStringText = currentIndex.data(ToStringRole).toString();
+  }
+  emit contentChanged(toStringText);
+}

views/itemdetailmapper.h

@@ -0,0 +1,67 @@
+#ifndef ITEMDETAILMAPPER_H
+#define ITEMDETAILMAPPER_H
+
+#include <QDataWidgetMapper>
+#include <QWidget>
+
+class QLabel;
+class QLineEdit;
+class QDoubleSpinBox;
+class QSpinBox;
+class QPushButton;
+class QAbstractItemModel;
+class QItemSelectionModel;
+class QTableView;
+
+class ItemDetailMapper : public QWidget {
+  Q_OBJECT
+ public:
+  explicit ItemDetailMapper(QWidget* parent = nullptr);
+
+  void setModelMappings(QTableView* tableView);
+
+  bool submit();
+  void revert();
+
+ signals:
+  void contentChanged(const QString text);
+
+ private slots:
+  void onCurrentIndexChanged(const QModelIndex& current, const QModelIndex& previous);
+  void rowsInserted(const QModelIndex& parent, int start, int end);
+  void rowsRemoved(const QModelIndex& parent, int start, int end);
+  void toPrevious();
+  void toNext();
+  void updateButtons(int row);
+  void emitContentChanged(const QModelIndex& currentIndex);
+
+ private:
+  /// *** members ***
+  /// Model stuff
+  QTableView* m_tableView               = nullptr;
+  QAbstractItemModel* m_model           = nullptr;
+  QItemSelectionModel* m_selectionModel = nullptr;
+
+  std::unique_ptr<QDataWidgetMapper> m_mapper;
+
+  /// GUI elements
+  QLabel* m_nameLabel   = nullptr;
+  QLineEdit* m_nameEdit = nullptr;
+
+  QLabel* m_descriptionLabel   = nullptr;
+  QLineEdit* m_descriptionEdit = nullptr;
+
+  QLabel* m_infoLabel   = nullptr;
+  QLineEdit* m_infoEdit = nullptr;
+
+  QLabel* m_amountLabel = nullptr;
+  QSpinBox* m_amountBox = nullptr;
+
+  QLabel* m_factorLabel       = nullptr;
+  QDoubleSpinBox* m_factorBox = nullptr;
+
+  QPushButton* m_nextButton;
+  QPushButton* m_previousButton;
+};
+
+#endif  // ITEMDETAILMAPPER_H