2024.2.0

FMTM 2024.2.0: Mobile Mapper Experience

🌟 New Features

• Significant improvements to the mobile experience.

  • Geolocation and orientation of the user on the map.
  • Downloading basemaps into offline storage in your browser, enabling offline navigation.
    

• Add comments to tasks.
  

• Add instructions to projects.
  

• Review state integration for validators.
  

🛠️ Improvements

• Editing of an uploaded or drawn project AOI.

• Mobile layout for various components.

• Edit existing ODK form & validate.

• Improved documentation for backup and restore of production FMTM data.

• Project creation ODK form upload: replace radiobutton with checkbox for better user experience.
  

• Performance and maintainability improvements by using raw SQL queries.

🐛 Bugs Fixed

• Refinements to splitting algorithm to handle edge cases.
• Use centroids for geometry division amongst tasks, to ensure all are uploaded to ODK Central (if they fall on boundaries).
• Profile image not updating in user profile after login.
• Page crashes in various scenarios, in different web browsers.
• Determine login state on first page load, to invalidate user session if required.

Technical Summary

What's Changed

• Return db user instead of Auth User in me endpoint. by @Sujanadh in #1247
• Feat review status modal by @NSUWAL123 in #1246
• Fix project buttons by @NSUWAL123 in #1332
• Hotfix use centroids to determine extract tasks split by @spwoodcock in #1336
• fix vectorLayer: remove hover effect code leading screen blank issue by @NSUWAL123 in #1338
• docs: add manjitapandey as a contributor for bug by @allcontributors in #1347
• feat: navigation WIP by @varun2948 in #1361
• Resolved issues on project summaries with no centroids by @Sujanadh in #1359
• Fix blank space input validation by @NSUWAL123 in #1362
• feat uploadArea: edit AOI btn add by @NSUWAL123 in #1346
• Fix UI bugs enhancements by @NSUWAL123 in #1363
• Implemented raw sql replacing sqlalchemy in me endpoint by @Sujanadh in #1334
• fix createProject: radiobutton replace with checkbox to change formWa… by @NSUWAL123 in #1366
• fix uploadArea: invalid geojson error handling by @NSUWAL123 in #1369
• Api to update the review state of submission by @Sujanadh in #1350
• Feat project details geolocation integration by @NSUWAL123 in #1370
• Updated the version of fmtm-splitter -> 1.2.1 by @Sujanadh in #1375
• Profile Image Not Updating in User Login by @Sujanadh in #1373
• Feat task comments integration by @NSUWAL123 in #1352
• Update submission in s3 even after review state is updated by @Sujanadh in #1379
• Feat project details geolocation integration by @NSUWAL123 in #1374
• Handle geo orientation crash on Firefox and Safari by @NSUWAL123 in #1381
• Toggleable debug console on mobile in local/dev/stage by @spwoodcock in #1371
• Separate endpoint to check the validity of login cookies. by @Sujanadh in #1380
• Fix comments intructions UI enhancement by @NSUWAL123 in #1384
• Fix popup offscreen by @NSUWAL123 in #1385
• Feat reviewstate api integration by @NSUWAL123 in #1376
• Fix update form validation by @NSUWAL123 in #1389
• Fix taskpopup aoi by @NSUWAL123 in #1392
• Separate response for comment and task status history by @Sujanadh in #1391
• OPFS-based offline-first PMTile basemaps by @spwoodcock in #1395
• Test project details mobile by @NSUWAL123 in #1396

Full Changelog: 2024.1.0...2024.2.0

2024.1.0

INTRODUCTION

Hello everyone!

With the first release of the year, we are thrilled to present you with the Beta Release of FMTM which incorporates many refinements.

UI/UX Enhancements

Redesign of UI for easier usage and better engagement
The user interface for project creation, project pages, and submission pages has been revamped to enhance the overall user experience.

NEW FEATURES

VIEW PROJECT SUMMARY
The infographics page has been added for project managers to track the status of the project.
The submissions are visualised in the form of various charts and graphs. You can filter submissions by submission date. . Visualise charts on project progress, number of tasks mapped and validated per project infographics for better visualisation. .

VIEW SUBMISSIONS
The list of individual submissions in a project can be viewed in a tabular view.

REGISTER YOUR ORGANIZATION
You can register your organization and create your own projects.

EDIT PROJECT DETAILS
You can update your survey form in a project and modify basic project details to realign with your needs.

INTEGRATION OF BACKEND MODULARIZED CODE

• Refinement of our backend module code that underpins FMTM.
• Integration of osm-rawdata, which uses HOT's raw-data-api service underneath.
• Minor improvements of fmtm-splitter to account for railways and airstrips as linear splitting features.
• Replacing HTTP BasicAuth in ODK Central connections from osm-fieldwork with session token authentication.

BUG FIXES:

• Optimization of task splitting algorithm: Split tasks based on polygon and line features for eg: split road network for road survey
• Project creation workflow has been made simpler and smoother with introduction of better UI/UX improvements and setup processes.

Upcoming Features:

We are planning to incorporate user roles and permissions for the next release with many more functionalities and bug fixes.

Stay tuned!

New Contributors

• @cordovez made their first contribution in #1116
• @Prajwalism made their first contribution in #1260
• @manjitapandey made their first contribution in #1320

Full Changelog: 0.1.0...2024.3.0

Your contributions will undoubtedly enhance the project, and we're excited to have you on board. 🤝

v0.1.0

Field Mapping Tasking Manager v1.0 - "First Release 🚀 2023"

Release Date: November 7, 2023

Introduction
We are pleased to present our first consolidated release note for "Field Mapping Tasking Manager". Although this isn't our first deployment, we have gathered the key changes and updates made in previous deployments into this comprehensive release note.

It's wonderful to have a dedicated and expanding team 🌟 working on the development of Field Mapping Tasking Manager.

@spwoodcock as Tech Lead for FMTM
@susmina94 as Project Manager

@varun2948 as Senior Frontend Developer
@nrjadkry as Senior Backend Developer

@robsavoye as Senior Tech Lead at HOT

They have been unwavering in their commitment to the development, playing integral roles in its success.
Together, as a team, everybody's collective efforts are greatly appreciated. 🚀👥🌟

In the ~2 months since the beta release, we have the following updates:

🌟 New Features:

1. Upgraded database management capabilities

• Finalising the first version of the database schema.
• Automated schema migrations on FMTM startup.
• New migration files are located in src/backend/migrations.

2. Added frontend and backend test cases for the following functionalities:

• Project creation with various parameters.
• ODK Central project creation.
• Converting database project objects to application-specific representations.
• Uploading custom data extracts for project tasks.

3. Download imageries from different sources such as (ESRI, Google, OSM, Bing, Topo) in different output formats: (PMTiles, OSMAnd, MBTiles)
   You may use these files as offline basemaps in ODKCollect or any other supported medium.

4. FMTM also supports input of custom TMS url and its conversion into the different file formats (PMTiles, OSMAnd, MBTiles)

5. You can now view the clusters for each project location on map interface

🐛 Bug Fixes:

1. Optimized Mobile UI for Project Info, Home and Organization page

2. FMTM uses osm-rawdata instead of osm-fieldwork for extracting OSM data extracts

🛠️ Improvements/Enhancements:

1. Introduced a user-friendly UI workflow for creating projects.

Features already included in the beta release:

• Login to FMTM via OSM account

• Create new projects which include:

• Upload/draw custom AOI

• Use XLSforms compatible with ODK

• Upload custom/OSM data extracts

• Split project area into tasks via three different algorithms:

  • Divide as square,
  • Choose area as task,
  • Use splitting algorithm

• Create and register new organization

We are excited about this release and look forward to your feedback and further improvements in future versions.

NEW CONTRIBUTORS

@Sujanadh @JoltCode @NSUWAL123
Your contributions will undoubtedly enhance the project, and we're excited to have you on board. 🤝