Migration from 2.0 to 3.0

Migration from version 2.0 to 3.0

Version 3.0 introduces substantial structural, technical, and functional updates to the HMC FAIR Data Dashboard. Users upgrading from version 2.0 should follow these guidelines to ensure a smooth transition:

1. System and framework updates

Upgraded to Dash 3 (#144 ); update Plotly and Bootstrap dependencies to latest compatible versions. Review any Navbar or layout code, as component behavior has changed.

2. Database migration

fuji_score table now stores all metric data in JSON; migrate existing records accordingly.
Updated queries now correctly handle datasets linked to multiple centers, research fields, or publishers (#61 , #66 , #137 ).

3. FAIR metrics update

Integrated F-UJI metrics 0.8 with new metrics A1.1 and A1.2 (#145 , #150 ). Re-harvest F-UJI data for full compatibility.

4. Interface and visualization changes

Corrected average scoring logic in sunburst plots (#155 ).
Unified color schemes (#146 ).
Added F-UJI disclaimer box (#132 ).
Removed numbers from center list (#129 ).
Replaced Twitter X icon with Bluesky (#134 ).

5. Licensing and compliance

Completed license audit (#154 ).
Removed banner images (#136 ) and fixed license references (#135 ).

6. Documentation and metadata

Documentation fully upgraded (#28 , #29 ) using Next 15 / Nextra 4 / React 19. Repository structure has changed accordingly.
Added documentation version-switching menu.
Integrated Somesy metadata pipeline (#105 ).
Expanded README.md “How to Contribute” section (#141 ).

7. Migration Recommendations

Version 3.0 of HMC FAIR Data Dashboard is mainly depended on version 3.0 of HMC Toolbox for Data Mining.
It is strongly recommended to perform a fresh installation of version 3.0 rather than an in-place upgrade from version 2.0.
Ensure all dependencies are updated to compatible versions as specified in the version 3.0 documentation.
Review and test all custom queries and visualizations to ensure compatibility with the new data structures and metrics.
Re-harvest F-UJI data to align with the updated metrics and database schema.
Consult the detailed change logs for comprehensive information on all modifications and enhancements.
Refer to the installation instructions for guidance on setting up version 3.0.

8. Support

For assistance during the migration process, please contact the development team via the issue tracker on our GitLab repository or refer to us via email (hmc-matter@helmholtz-berlin.de) for support.