zoph for Debian
--------------

The source is downloaded from https://gitlab.com/zoph-project/zoph/

Database.
---------
Until version 0.9.20 zoph used .sql files, which could be fed directly
into dbconfig. Since then it has contained its own installer within
the code, which required the first user after an upgrade to enter the
MySQL database password.
 
Upgrades require examining the source code, in php/migrations there are
a set of routines called to do the database structure changes when
they are required. In summary
 0.9.18 changes the format from MyISAM to InnoDB
 0.9.21 updates the colour scheme
 0.9.22 adds zoph_sets and zoph_photo_sets tables
 1.2 adds a sidecar column to zoph_photos
 1.3 adds colums to people for display_name, full_name, last_name_prefix etc

For compatiblilty with dbconfig these need to be reverse-engineered
and converted into SQL statements, in the debian/sql directory. 

One route, used in conjuncion with understanding the code in
php/migrations is to start a docker instance of the new version, do its
internal database update and use the Admin backup database function to
extract a backup.sql from fresh install, and compare that with zoph.sql
from debian/sql

Once the set of changes have been put into debian/sql the master file
debian/sql/zoph.sql should be updated so fresh installs will have the
initial database populated correctly.


 

 -- John Lines <john@paladyn.org> Mon  6 Feb 10:21:16 GMT 2023

