Release v1.15.3 Patches and Performance (2022/2/26)

Performance Improvements

• Limit query results listed in tables to 500, plus JS notification that full list exceeds this number
• Tuning SQL queries (modified functions to enable bulk insert/update/delete)

Developer Updates

• Auth0-PHP SDK Updated to version 8.0
• Auth0 configuration updates (disable fixed length access token, fix some other exceptions)

Bugfixes

• Last login for users was not working before - now integrated with Auth0 so it works again
• Sign Contract tab did not activate when user pressed sign. Fixed.
• Stock Overview was not working if the organization had no outgoing locations that were not LOST or SCRAP. Fixed.

Hotfix Release v1.15.2 (2021/12/6)

Reset Tokens functionality: The previous release removed the ability of coordinators to give zero tokens to beneficiaries. It came to our attention that this was being used by some of our users as a reset, which they could no longer do with the previous update. Fixed.

Release v1.15.1 Upgrade to MySQL 8.0 and PHP 7.4, plus multiple user-requested UX updates (2021/11/30)

Features

• Zero Item Counts For Boxes: Useful for users that 0 counts for boxes for bulk items, or when new boxes come in that have yet to be counted. Requested by Hermine and LNOB.
• Improved Beneficiary Page Performance: Massively shrinks the load time for the Beneficiaries page by limiting returned records to 500. This has been an ongoing issue in performance due to the fact that pagination was not part of the original design of the app. This will be fixed in Boxtribute 2.0.
• Bulk Remove Tags: Previously, users could apply new tags to beneficiaries, but had to remove tags from beneficiaries one by one. This update allows the user to do so by creating a Remove Tag option in the Beneficiaries bulk edit menu.
• Validate give All Tokens to Beneficiaries: Previously, because there is a default token amount set for beneficiaries in base settings, users were confused when selecting the Give Tokens to All button caused the function to be executed without specifying the number of tokens. This release adds a validation to check the number of tokens given prior to executing that command.
• BUGFIX: Reactivating beneficiaries: Previously, reactivating beneficiaries who were dependents in a family created issues in editing family structures. This is now fixed with a prompt that forces the user to reactivate a family head before reactivating dependent family members.

Infrastructure

• Upgraded PHP from 7.2 to 7.4
• Upgraded MySQL from 5.2 to 8.0. This was a breaking change so required careful testing on our part.
• Aligned Unique Box Generation Logic between this codebase and that of Boxtribute 2.0, in preparation for its future production release.

Hotfix Release v1.14.2 (2021/9/27)

Fixes an issue where after the v1.14.0 release, users had to re-login to the app every time they scanned a box.

This was because we were using an Auth0 rule to raise errors, then redirecting to the login page, which prevented those errors from being correctly displayed. To resolve this, altered the login callback logic and fixed the error handling for expired users.

Release v1.14.0: New Authentication and Basic Authorization with Auth0 (2021/9/18)

Auth0 Integration

• Full integration with Auth0 for authentication and basic authorization using EU tenant servers across the all stages of the SDLC (development, staging, production)
• Create New User user flow in app syncs with Auth0 service
• Addition of base_id and organisation_id identifiers to the user's JWT to facilitate easy access controls down the line
• Integrated Auth0 errors into Sentry reporting
• App internal password change rules manually replicate that of Auth0 settings - changing the requirements down the line will mean that needs to be refactored. Hopefully migration of the user self-management module will happen before then.
• Added testing for Auth0 service on 1) correct login redirect, 2) unauthenticated user access controls, and 3) user database synchronization between app and Auth0

Others

• Added validation to emails to check that the domain exists in DNS records, as well as a "type your email twice" solution
• Fix for failing Cypress tests

Release v1.13.0 - Navigation UI Improvements and SPHERE-compliant Product Categories (2021/5/9)

Features

• Clearer Menu Titles and Information Hierarchy in Navigation: Reorganized menu so that the most important sections are at the top (e.g., in Inventory the first call-to-action is Print Box Labels, which was formerly called Generate QR Codes)
• Clearer Instructions and Hints For First-time Users: Added instructional content about how users should a) make new box labels and scan the QR codes to save box information, and b) create families and designate a beneficiary as a family head.
• Improved UI in Beneficiary Details: Users can now more quickly see key biographical information (age, gender) for a beneficiary when looking at beneficiary details, and more intuitively view related family members
• SPHERE-compliant Product Categories: We've added global product categories Water and Shelter to all organizations, and merged the Dry Food and Fresh Food categories into Food & Kitchen to make it possible for organizations to align their reporting with SPHERE minimum humanitarian standards. The four key lifesaving areas identified by SPHERE are: (1) water supply, sanitation and hygiene promotion (WASH); (2) food security and nutrition; (3) shelter and settlement, and (4) health.
• BUGFIX - Login error message with unrecognized email: Previously, if a user tried to login with an invalid email due to typos or similar reasons, the error shown was: This email either does not have an active account associated with it, or access has expired. Contact your coordinator to enable your account. This led to some confusion with both users and coordinators about what to do next. Now, trying to login with an invalid email shows the error message: There is no user with that email address in our systems. Check your spelling and try again.
• BUGFIX - Menu mouseover highlights for smaller screens: For users using the app with smaller screens where the navigation drawer can be expanded or hidden based on user input, there was a display issue where menu items would be blanked out instead of highlighted upon mouseover. This has now been fixed.

Bugfix Release v1.12.5 (2021/1/30)

This release adds additional Sentry logging to the login page, and resolves a bug where beneficiaries with tags could not be deleted by the user.

Patch Release v1.12.4 (2020/12/8)

This release resolves some issues around QR label generation and improves the performance of the Manage Beneficaries page.

• QR Label Generation: We received a report of an issue that sometimes when a large number of labels were created, sometimes spotty internet would interrupt the generation of one label, then causing the entire set of labels to fail. Resolved so that in the case where spotty internet interferes with label generation, all labels that were successfully created previously will still load for the user.
• Manage Beneficiaries Performance: Back-end SQL has been refactored and optimized to support the loading of large numbers of beneficiaries to be around 2x faster than before.

Maintenance release v1.12.3

Added more app engine logging to people.php, and removed the option to scale instances as it did not materially improve performance.

Release v1.12.2 (2020/10/29)

Hotfix release.

• Bugfix: Updated CircleCI composer and Cypress tests 2.5 and 5.2 to resolve build test failures
• Performance fix: Upgrade production performance by allocating more resources to the production instance