Improving UX by hiding editing buttons for readers of a project

app/activeproject.cpp

@@ -184,6 +184,10 @@ bool ActiveProject::forceLoad( const QString &filePath, bool force )
       CoreUtils::log( QStringLiteral( "Project load" ), QStringLiteral( "Could not find project in local projects: " ) + filePath );
     }
 
+    QString role = MerginProjectMetadata::fromCachedJson( CoreUtils::getProjectMetadataPath( mLocalProject.projectDir ) ).role;
+    qDebug() << "ROLE 1 : " << role;
+    setProjectRole( role );
+
     updateMapTheme();
     updateRecordingLayers();
     updateActiveLayer();
@@ -553,3 +557,18 @@ bool ActiveProject::positionTrackingSupported() const
 
   return mQgsProject->readBoolEntry( QStringLiteral( "Mergin" ), QStringLiteral( "PositionTracking/Enabled" ), false );
 }
+
+QString ActiveProject::projectRole() const
+{
+  return mProjectRole;
+}
+
+void ActiveProject::setProjectRole( const QString &role )
+{
+  if ( mProjectRole != role )
+  {
+    mProjectRole = role;
+
+    emit projectRoleChanged();
+  }
+}

app/activeproject.h

@@ -22,6 +22,7 @@
 #include "localprojectsmanager.h"
 #include "autosynccontroller.h"
 #include "inputmapsettings.h"
+#include "merginapi.h"
 
 /**
  * \brief The ActiveProject class can load a QGIS project and holds its data.
@@ -33,6 +34,7 @@ class ActiveProject: public QObject
     Q_PROPERTY( QgsProject *qgsProject READ qgsProject NOTIFY qgsProjectChanged ) // QgsProject instance of active project, never changes
     Q_PROPERTY( AutosyncController *autosyncController READ autosyncController NOTIFY autosyncControllerChanged )
     Q_PROPERTY( InputMapSettings *mapSettings READ mapSettings WRITE setMapSettings NOTIFY mapSettingsChanged )
+    Q_PROPERTY( QString projectRole READ projectRole WRITE setProjectRole NOTIFY projectRoleChanged )
 
     Q_PROPERTY( QString mapTheme READ mapTheme WRITE setMapTheme NOTIFY mapThemeChanged )
     Q_PROPERTY( bool positionTrackingSupported READ positionTrackingSupported NOTIFY positionTrackingSupportedChanged )
@@ -118,6 +120,23 @@ class ActiveProject: public QObject
 
     bool positionTrackingSupported() const;
 
+    /**
+     * Returns role/permission level of current user for this project
+     */
+    Q_INVOKABLE QString projectRole() const;
+
+    void setProjectRole( const QString &role );
+
+    /**
+     * Calls Mergin API to update current project’s role
+     */
+    void updateUserRoleInActiveProject();
+
+    /**
+     * Update current project’s role
+     */
+    void onProjectRoleUpdated( const QString &projectFullName, const QString &role );
+
   signals:
     void qgsProjectChanged();
     void localProjectChanged( LocalProject project );
@@ -145,6 +164,8 @@ class ActiveProject: public QObject
     // Emited when the app (UI) should show tracking because there is a running tracking service
     void startPositionTracking();
 
+    void projectRoleChanged();
+
   public slots:
     // Reloads project if current project path matches given path (its the same project)
     bool reloadProject( QString projectDir );
@@ -182,10 +203,12 @@ class ActiveProject: public QObject
     LayersProxyModel &mRecordingLayerPM;
     LocalProjectsManager &mLocalProjectsManager;
     InputMapSettings *mMapSettings = nullptr;
+    MerginApi *mMerginApi = nullptr;
 
     std::unique_ptr<AutosyncController> mAutosyncController;
 
     QString mProjectLoadingLog;
+    QString mProjectRole;
 
     /**
     * Reloads project.

app/main.cpp

@@ -495,6 +495,7 @@ int main( int argc, char *argv[] )
 
   ActiveLayer al;
   ActiveProject activeProject( as, al, recordingLpm, localProjectsManager );
+
   std::unique_ptr<VariablesManager> vm( new VariablesManager( ma.get() ) );
   vm->registerInputExpressionFunctions();
 
@@ -569,6 +570,27 @@ int main( int argc, char *argv[] )
     syncManager.syncProject( project, SyncOptions::Authorized, SyncOptions::Retry );
   } );
 
+  QObject::connect( &activeProject, &ActiveProject::projectReloaded, &lambdaContext, [merginApi = ma.get(), &activeProject]()
+  {
+    merginApi->reloadProjectRole( activeProject.projectFullName() );
+  } );
+
+  QObject::connect( ma.get(), &MerginApi::authChanged, &lambdaContext, [merginApi = ma.get(), &activeProject]()
+  {
+    if ( activeProject.isProjectLoaded() )
+    {
+      merginApi->reloadProjectRole( activeProject.projectFullName() );
+    }
+  } );
+
+  QObject::connect( ma.get(), &MerginApi::projectRoleUpdated, &activeProject, [&activeProject]( const QString & projectFullName, const QString & role )
+  {
+    if ( projectFullName == activeProject.projectFullName() )
+    {
+      activeProject.setProjectRole( role );
+    }
+  } );
+
   QObject::connect( ma.get(), &MerginApi::notifyInfo, &lambdaContext, [&notificationModel]( const QString & message )
   {
     notificationModel.addInfo( message );

app/qml/form/MMFormPage.qml

@@ -201,7 +201,7 @@ Page {
 
   footer: MMComponents.MMToolbar {
 
-    visible: !root.layerIsReadOnly
+    visible: !root.layerIsReadOnly && __activeProject.projectRole !== "reader"
 
     ObjectModel {
       id: readStateButtons
@@ -231,7 +231,7 @@ Page {
         id: editGeometry
         text: qsTr( "Edit geometry" )
         iconSource: __style.editIcon
-        visible: root.layerIsSpatial
+        visible: root.layerIsSpatial && __activeProject.projectRole !== "reader"
         onClicked: root.editGeometryRequested( root.controller.featureLayerPair )
       }
     }

app/qml/form/MMPreviewDrawer.qml

@@ -295,7 +295,7 @@ Item {
     property bool isHTMLType: root.controller.type === MM.AttributePreviewController.HTML
     property bool isEmptyType: root.controller.type === MM.AttributePreviewController.Empty
 
-    property bool showEditButton: !root.layerIsReadOnly
+    property bool showEditButton: !root.layerIsReadOnly && __activeProject.projectRole !== "reader"
     property bool showStakeoutButton: __inputUtils.isPointLayerFeature( controller.featureLayerPair )
     property bool showButtons: showEditButton || showStakeoutButton
 

app/qml/form/components/MMFeaturesListPageDrawer.qml

@@ -103,6 +103,7 @@ Drawer {
         }
 
         text: qsTr( "Add feature" )
+        visible: __activeProject.projectRole !== "reader"
 
         onClicked: root.buttonClicked()
       }

app/qml/layers/MMFeaturesListPage.qml

@@ -89,7 +89,7 @@ MMComponents.MMPage {
       anchors.bottom: parent.bottom
       anchors.bottomMargin: root.hasToolbar ? __style.margin20 : ( __style.safeAreaBottom + __style.margin8 )
 
-      visible: __inputUtils.isNoGeometryLayer( root.selectedLayer ) && !root.layerIsReadOnly
+      visible: __inputUtils.isNoGeometryLayer( root.selectedLayer ) && !root.layerIsReadOnly && __activeProject.projectRole !== "reader"
 
       text: qsTr("Add feature")
 

app/qml/main.qml

@@ -276,6 +276,7 @@ ApplicationWindow {
       MMToolbarButton {
         text: qsTr("Add")
         iconSource: __style.addIcon
+        visible: __activeProject.projectRole !== "reader"
         onClicked: {
           if ( __recordingLayersModel.rowCount() > 0 ) {
             stateManager.state = "map"

app/test/testmerginapi.cpp

@@ -2942,3 +2942,31 @@ void TestMerginApi::testParseVersion()
   QCOMPARE( major, 2024 );
   QCOMPARE( minor, 4 );
 }
+
+void TestMerginApi::testUpdateProjectMetadataRole()
+{
+  QString projectName = "testUpdateProjectMetadataRole";
+
+  createRemoteProject( mApiExtra, mWorkspaceName, projectName, mTestDataPath + "/" + TEST_PROJECT_NAME + "/" );
+  downloadRemoteProject( mApi, mWorkspaceName, projectName );
+
+  LocalProject projectInfo = mApi->localProjectsManager().projectFromMerginName( mWorkspaceName, projectName );
+  QVERIFY( projectInfo.isValid() );
+  QString projectDir = projectInfo.projectDir;
+
+  // Test 1: Initial role should be 'owner'
+  QString cachedRole = mApi->getCachedProjectRole( MerginApi::getFullProjectName( mWorkspaceName, projectName ) );
+  QCOMPARE( cachedRole, QString( "owner" ) );
+
+  // Test 2: Update cached role to 'reader'
+  QString newRole = "reader";
+  bool updateSuccess = mApi->updateCachedProjectRole( MerginApi::getFullProjectName( mWorkspaceName, projectName ), newRole );
+  QVERIFY( updateSuccess );
+
+  // Verify role was updated in cache
+  cachedRole = mApi->getCachedProjectRole( MerginApi::getFullProjectName( mWorkspaceName, projectName ) );
+  QCOMPARE( cachedRole, newRole );
+
+  // Clean up
+  deleteRemoteProjectNow( mApi, mWorkspaceName, projectName );
+}

app/test/testmerginapi.h

@@ -79,6 +79,7 @@ class TestMerginApi: public QObject
     void testSynchronizationViaManager();
     void testAutosync();
     void testAutosyncFailure();
+    void testUpdateProjectMetadataRole();
 
     void testRegisterAndDelete();
     void testCreateWorkspace();

core/coreutils.cpp

@@ -335,3 +335,11 @@ QString CoreUtils::bytesToHumanSize( double bytes )
     return QString::number( bytes / 1024.0 / 1024.0 / 1024.0 / 1024.0, 'f', precision ) + " TB";
   }
 }
+
+QString CoreUtils::getProjectMetadataPath( QString projectDir )
+{
+  if ( projectDir.isEmpty() )
+    return QString();
+
+  return projectDir + "/.mergin/mergin.json";
+}

core/coreutils.h

@@ -125,6 +125,11 @@ class CoreUtils
      */
     static QString bytesToHumanSize( double bytes );
 
+    /**
+     * Returns path to project metadata file for a given project directory
+     */
+    static QString getProjectMetadataPath( QString projectDir );
+
   private:
     static QString sLogFile;
     static int CHECKSUM_CHUNK_SIZE;

core/merginapi.cpp

@@ -3449,6 +3449,45 @@ bool MerginApi::writeData( const QByteArray &data, const QString &path )
   return true;
 }
 
+bool MerginApi::updateCachedProjectRole( const QString &projectFullName, const QString &newRole )
+{
+  LocalProject project = mLocalProjects.projectFromMerginName( projectFullName );
+  if ( !project.isValid() )
+  {
+    return false;
+  }
+
+  QString metadataPath = project.projectDir + "/" + sMetadataFile;
+
+  QFile file( metadataPath );
+  if ( !file.open( QIODevice::ReadOnly ) )
+  {
+    return false;
+  }
+
+  QByteArray data = file.readAll();
+  file.close();
+
+  QJsonDocument doc = QJsonDocument::fromJson( data );
+  if ( !doc.isObject() )
+  {
+    return false;
+  }
+
+  QJsonObject obj = doc.object();
+  obj["role"] = newRole;
+  doc.setObject( obj );
+
+  if ( !file.open( QIODevice::WriteOnly ) )
+  {
+    return false;
+  }
+
+  bool success = ( file.write( doc.toJson() ) != -1 );
+  file.close();
+
+  return success;
+}
 
 void MerginApi::createPathIfNotExists( const QString &filePath )
 {
@@ -3945,3 +3984,66 @@ DownloadQueueItem::DownloadQueueItem( const QString &fp, qint64 s, int v, qint64
   tempFileName = CoreUtils::uuidWithoutBraces( QUuid::createUuid() );
 }
 
+void MerginApi::reloadProjectRole( const QString &projectFullName )
+{
+  if ( projectFullName.isEmpty() )
+  {
+    return;
+  }
+
+  QNetworkReply *reply = getProjectInfo( projectFullName );
+  if ( !reply )
+    return;
+
+  reply->request().setAttribute( static_cast<QNetworkRequest::Attribute>( AttrProjectFullName ), projectFullName );
+  connect( reply, &QNetworkReply::finished, this, &MerginApi::reloadProjectRoleReplyFinished );
+}
+
+void MerginApi::reloadProjectRoleReplyFinished()
+{
+  QNetworkReply *r = qobject_cast<QNetworkReply *>( sender() );
+  Q_ASSERT( r );
+
+  QString projectFullName = r->request().attribute( static_cast<QNetworkRequest::Attribute>( AttrProjectFullName ) ).toString();
+  QString cachedRole = MerginApi::getCachedProjectRole( projectFullName );
+
+  if ( r->error() == QNetworkReply::NoError )
+  {
+    QByteArray data = r->readAll();
+    MerginProjectMetadata serverProject = MerginProjectMetadata::fromJson( data );
+    QString role = serverProject.role;
+
+    if ( role != cachedRole )
+    {
+      if ( updateCachedProjectRole( projectFullName, role ) )
+      {
+        emit projectRoleUpdated( projectFullName, role );
+      }
+      else
+      {
+        CoreUtils::log( "metadata", QString( "Failed to update cached role for project %1" ).arg( projectFullName ) );
+      }
+    }
+  }
+  else
+  {
+    emit projectRoleUpdated( projectFullName, cachedRole );
+  }
+
+  r->deleteLater();
+}
+
+QString MerginApi::getCachedProjectRole( const QString &projectFullName ) const
+{
+  if ( projectFullName.isEmpty() )
+    return QString();
+
+  QString projectDir = mLocalProjects.projectFromMerginName( projectFullName ).projectDir;
+
+  if ( projectDir.isEmpty() )
+    return QString();
+
+  MerginProjectMetadata cachedProjectMetadata = MerginProjectMetadata::fromCachedJson( projectDir + "/" + sMetadataFile );
+
+  return cachedProjectMetadata.role;
+}

core/merginapi.h

@@ -573,6 +573,11 @@ class MerginApi: public QObject
      */
     bool apiSupportsWorkspaces();
 
+    /**
+     * Reloads project metadata role by fetching latest information from server.
+     */
+    Q_INVOKABLE void reloadProjectRole( const QString &projectFullName );
+
   signals:
     void apiSupportsSubscriptionsChanged();
     void supportsSelectiveSyncChanged();
@@ -650,6 +655,7 @@ class MerginApi: public QObject
     void apiSupportsWorkspacesChanged();
 
     void serverWasUpgraded();
+    void projectRoleUpdated( const QString &projectFullName, const QString &role );
 
   private slots:
     void listProjectsReplyFinished( QString requestId );
@@ -789,6 +795,12 @@ class MerginApi: public QObject
 
     bool projectFileHasBeenUpdated( const ProjectDiff &diff );
 
+    void reloadProjectRoleReplyFinished();
+
+    bool updateCachedProjectRole( const QString &projectFullName, const QString &newRole );
+
+    QString getCachedProjectRole( const QString &projectFullName ) const;
+
     QNetworkAccessManager mManager;
     QString mApiRoot;
     LocalProjectsManager &mLocalProjects;
@@ -804,7 +816,7 @@ class MerginApi: public QObject
       AttrProjectFullName = QNetworkRequest::User,
       AttrTempFileName    = QNetworkRequest::User + 1,
       AttrWorkspaceName   = QNetworkRequest::User + 2,
-      AttrAcceptFlag      = QNetworkRequest::User + 3,
+      AttrAcceptFlag      = QNetworkRequest::User + 3
     };
 
     Transactions mTransactionalStatus; //projectFullname -> transactionStatus