Added display of use-stats to the "About" window.

Added display of total active use time, total number of new sessions, and number of files opened from file system.
This required breaking out a few primate members of InterSpecUser and InterSpecApp.
Also added note that these statics are kept locally and not telemetered anywhere.

Author: wcjohns

InterSpec/InterSpecApp.h

@@ -103,6 +103,8 @@ class InterSpecApp : public Wt::WApplication
 
   InterSpec *viewer();
 
+  boost::posix_time::time_duration activeTimeInCurrentSession() const;
+  
 
   //userNameFromOS(): Caution, will return 'apache' if being served, from
   //  an apache server, 'mobile' if on a iOS device, or blank upon failure.

InterSpec/InterSpecUser.h

@@ -205,6 +205,29 @@ class InterSpecUser
 
   const std::string &userName() const;
 
+  /** The number of new InterSpec sessions that has been created for this user. */
+  int accessCount() const;
+  
+  /** Approximate total amount of time user has actively used the app before the current session.
+   
+   Counts time between user generated events in the app, but only if less than 5 minutes between interactions.
+   See #InterSpecApp::notify for implementation of when time is added.
+   
+   This value is only incremented #InterSpecApp::prepareForEndOfSession, so it does not include time from the current session.
+   */
+  boost::posix_time::time_duration totalTimeInApp() const;
+  
+  /** Approximate number of spectrum files opened.
+   
+   The count is only incremented if #SpecMeasManager::checkIfPreviouslyOpened is called after opening a file, which is only
+   called some of the time from #SpecMeasManager::displayFile, specifically I think only when files are opened from the
+   filesystem.
+   */
+  int numSpectraFilesOpened() const;
+  
+  /** The UTC time when this user was first created in the database. */
+  boost::posix_time::ptime firstAccessUTC() const;
+  
   //userFromViewer: a simple helper function to return the user from a
   //  spectrum viewer pointer; necessary to break a "Member access into
   //  incomplete type 'InterSpec'" issue.

src/InterSpecApp.cpp

@@ -900,6 +900,11 @@ InterSpec *InterSpecApp::viewer()
 }//InterSpec* viewer()
 
 
+boost::posix_time::time_duration InterSpecApp::activeTimeInCurrentSession() const
+{
+  return m_activeTimeInSession;
+}
+
 #if( BUILD_AS_ELECTRON_APP || BUILD_AS_OSX_APP || ANDROID || IOS )
 std::string InterSpecApp::externalToken()
 {

src/InterSpecUser.cpp

@@ -1399,6 +1399,31 @@ const std::string &InterSpecUser::userName() const
   return m_userName;
 }
 
+
+int InterSpecUser::accessCount() const
+{
+  return m_accessCount;
+}
+
+
+boost::posix_time::time_duration InterSpecUser::totalTimeInApp() const
+{
+  return m_totalTimeInApp;
+}
+
+
+int InterSpecUser::numSpectraFilesOpened() const
+{
+  return m_spectraFilesOpened;
+}
+
+
+boost::posix_time::ptime InterSpecUser::firstAccessUTC() const
+{
+  return m_firstAccessUTC;
+}
+
+
 Wt::Dbo::ptr<InterSpecUser> &InterSpecUser::userFromViewer( InterSpec *viewer )
 {
   static Dbo::ptr<InterSpecUser> dummy;

src/LicenseAndDisclaimersWindow.cpp

@@ -35,6 +35,7 @@
 #include <Wt/WAnimation>
 #include <Wt/WPushButton>
 #include <Wt/WGridLayout>
+#include <Wt/WEnvironment>
 #include <Wt/WApplication>
 #include <Wt/WStackedWidget>
 #include <Wt/WContainerWidget>
@@ -44,10 +45,12 @@
 #include <Wt/WServer>
 #endif
 
+#include "SpecUtils/DateTime.h"
 #include "InterSpec/InterSpec.h"
 #include "InterSpec/AuxWindow.h"
 #include "SpecUtils/Filesystem.h"
 #include "InterSpec/InterSpecApp.h"
+#include "InterSpec/PhysicalUnits.h"
 #include "InterSpec/UseInfoWindow.h"
 #include "InterSpec/LicenseAndDisclaimersWindow.h"
 
@@ -354,6 +357,40 @@ void LicenseAndDisclaimersWindow::dataStorageCreator( Wt::WContainerWidget *pare
     SpecUtils::ireplace_all( staticdir, "/", "\\" );
 #endif
 
+    
+#if( USE_DB_TO_STORE_SPECTRA )
+    bool displayStats = false;
+    string totalUserTime, totalFilesOpened, totalSessions, firstAccess;
+    
+    InterSpec *viewer = InterSpec::instance();
+    Dbo::ptr<InterSpecUser> user = ((app && viewer) ? viewer->m_user : Dbo::ptr<InterSpecUser>());
+    if( user )
+    {
+      try
+      {
+        totalSessions = std::to_string( user->accessCount() );
+        totalFilesOpened = std::to_string( user->numSpectraFilesOpened() );
+        boost::posix_time::time_duration totaltime = user->totalTimeInApp();
+        // Note that if user has multiple sessions going, this next line wont be exactly correct, but close enough.
+        totaltime += app->activeTimeInCurrentSession();
+        totalUserTime = PhysicalUnits::printToBestTimeUnits( totaltime.total_seconds() );
+        
+        const WDateTime utcStartTime = WDateTime::fromPosixTime( user->firstAccessUTC() );
+        const int offset = app->environment().timeZoneOffset();
+        firstAccess = utcStartTime.addSecs(60*offset).toString( "dd-MMM-yyyy" ).toUTF8();
+        
+        // The alternative of using WLocalDateTime leaves the time in UTC...
+        //const WLocalDateTime localStartTime = utcStartTime.toLocalTime();
+        //firstAccess = localStartTime.toString("dd-MMM-yyyy").toUTF8();
+        
+        displayStats = true;
+      }catch(...)
+      {
+        // Dont expect this to ever really happen.
+      }//try / catch
+    }//if( app && viewer && viewer->m_user )
+#endif
+    
     auto server = WServer::instance();
     const int httpPort = server ? server->httpPort() : 0;
 
@@ -380,6 +417,49 @@ void LicenseAndDisclaimersWindow::dataStorageCreator( Wt::WContainerWidget *pare
     "<div style=\"" + style + "\">http://127.0.0.1:" + std::to_string(httpPort) + "</div>"
     "</p>"
     ;
+    
+#if( USE_DB_TO_STORE_SPECTRA )
+    if( displayStats )
+    {
+      contents += "<div style=\"margin-top: 10px\"><p>"
+      "You have actively used InterSpec for approximately "
+      + totalUserTime + ", to open " + totalFilesOpened
+      + " files, over " + totalSessions + " sessions since " + firstAccess + "."
+      "</p></div>";
+    }//if( displayStats )
+#endif //if( USE_DB_TO_STORE_SPECTRA )
+    
+    
+#if( BUILD_FOR_WEB_DEPLOYMENT )
+    // Statement here would depend on web-server policies
+#else
+    contents +=
+    "<div style=\"margin-top: 10px\"><p>"
+    "InterSpec does not send or receive data external to your device"
+#if( USE_GOOGLE_MAP )
+    ", except when the Google Maps feature is used"
+#endif
+    "."
+    
+#if( USE_DB_TO_STORE_SPECTRA )
+    "<br />InterSpec does locally"
+    " store preferences, spectra you load, saved app states, and use"
+    " statistics."
+    " This information does not leave your device, and can be deleted by removing the user data"
+    " directory shown above."
+#endif
+    
+#if( USE_GOOGLE_MAP )
+    "<br />When the Google Maps feature is used, the spectrum file location information is sent to"
+    " Google in order to receive maps of the relevant location."
+#endif
+    "</p></div>";
+    
+#endif //#if( BUILD_FOR_WEB_DEPLOYMENT ) / else
+
+    
+    
+    
   }else
   {
     contents = "Error retrieving directory data";