#
# $Id$
# $HeadURL$
#

----------
Notations:
----------
<project> = guez (default), ahtc, qatar, l400p2
<SVC> = asm, avm, exm, ism, opm, ppm, flm, pdm, whg, gna, rep, aes...

------------------
HOW TO USE:
------------------
make <project>-db:
------------------
Executes all the files <project>_<SVC>_values.sql from <build>/bin/test/
When a certain file <project>_<SVC>_values.sql is missing, it executes insert_<SVC>_values.sql (fallback)
The order in which the files are executed is given by the dependencies (foreign keys) between schemas.
Types and templates are in separate files, for ease of maintenance.
Additionally, these files are executed:
<project>_ppm_values_types.sql
<project>_ppm_values_templates.sql
<project>_pdm_values_translation.sql
<project>_avm_values_frequencysets.sql
<project>_flm_symbols.sql
<project>_update_flm_used_by.sql
insert_opm_values_initial.sql (contains user Organisator for first login)
-----------------------
make <project>-test-db:
-----------------------
Executes files from <build>/bin/test/:
test_exm_exercise.sql (creates users and schemas for exercises 35, 42, grants)
Then: (if one file is missing, it goes to fallback file (insert_<SVC>_values*.sql),
if that is missing too, it writes in Output "File is missing" - as info, not an error)
<project>_asm_values.sql
<project>_asm_values_test.sql (TODO: do not overlap ids in these 2 files)
<project>_pdm_values.sql
<project>_pdm_values_translation.sql
insert_exm_values.sql
insert_opm_values_initial.sql (contains user Organisator for first login)
<project>_opm_values.sql
<project>_opm_values_test.sql
<project>_flm_values.sql
<project>_flm_values_test.sql
<project>_ism_values_test.sql
<project>_avm_values.sql
<project>_avm_values_frequencysets.sql
<project>_ism_values_test.sql
<project>_whg_values.sql
<project>_ppm_values_types.sql
<project>_ppm_values_templates.sql
<project>_flm_symbols.sql
<project>_flm_update_used_by.sql
All files <project>_<SVC>_values_ex_35.sql
          <project>_<SVC>_values_ex_42.sql

-----------------------
 Specific project files:
+------------------+
| Project GUEZ:    |
+------------------+
make db ( = make guez-db)
-----------------------
guez_asm_values.sql
guez_avm_values.sql
guez_avm_values_frequencysets.sql
guez_flm_symbols.sql
guez_update_flm_used_by.sql
guez_ism_values.sql
guez_opm_values.sql
guez_pdm_values.sql
guez_pdm_values_translation.sql
guez_ppm_values_types.sql
guez_ppm_values_templates.sql
guez_whg_values.sql
--------------------------------
make test-db ( = make guez-test-db)
--------------------------------
guez_avm_values_test.sql
guez_ppm_values_ex_42.sql
guez_ppm_values_ex_35.sql
guez_rep_values_ex_42.sql
guez_aes_values_ex_42.sql
guez_aes_values_ex_35.sql

+------------------+
| Project AHTC:    |
+------------------+
make ahtc-db
------------
ahtc_asm_values.sql
ahtc_avm_values.sql
ahtc_opm_values.sql
ahtc_ppm_values_types.sql
ahtc_ppm_values_templates.sql
ahtc_pdm_values.sql
ahtc_flm_symbols.sql
-----------------
make ahtc-test-db
-----------------
ahtc_avm_values_test.sql
ahtc_ppm_values_ex_35.sql
ahtc_ppm_values_ex_42.sql

+------------------+
|  Project L400P2: |
+------------------+
make l400p2-db
--------------
l400p2_asm_values.sql
l400p2_avm_values.sql
l400p2_opm_values.sql
l400p2_ppm_values_types.sql
l400p2_ppm_values_templates.sql
l400p2_pdm_values.sql
l400p2_flm_symbols.sql
-------------------
make l400p2-test-db
-------------------
l400p2_ppm_values_ex_35.sql
l400p2_ppm_values_ex_42.sql

+------------------+
| Project QATAR:   |
+------------------+
make qatar-db
-------------
qatar_asm_values.sql
qatar_avm_values.sql
qatar_opm_values_initial.sql
qatar_opm_values.sql
qatar_pdm_values.sql
qatar_ppm_values_types.sql
qatar_flm_symbols.sql
------------------
make qatar-test-db
------------------
qatar_ism_values_test.sql
qatar_opm_values_test.sql
qatar_ppm_values_ex_35.sql
qatar_ppm_values_ex_42.sql

----------------------------------------------------------------
Fallback files (when files for a specific project do not exist):
----------------------------------------------------------------
insert_exm_values.sql
insert_asm_values.sql
insert_avm_values.sql
insert_gna_values.sql
insert_opm_values_initial.sql
insert_pdm_values.sql
insert_pdm_values_mil.sql
insert_ppm_values_types.sql
insert_flm_values.sql

--------------------------------------------------------------------------
Fallback files TEST (when files for a specific project_test do not exist):
--------------------------------------------------------------------------
test_exm_exercise.sql
insert_ism_values_test.sql
insert_opm_values_test.sql
insert_asm_values_test.sql
insert_ppm_values_ex_35.sql
insert_ppm_values_ex_42.sql
insert_flm_values_test.sql
insert_oss_values_ex_35.sql
insert_oss_values_ex_42.sql

-------------
Common files:
-------------
Scripts:
--------
create_excon_db.py
test_scenario_definitions.py
test_scenario_participant_positions.py
test_scenario_participant_state.py

Database initialization:
------------------------
create_views.sql
check_connections.sql
init_db_procedures.sql
init_db_users_grants.sql
init_db_schemas.sql
update_flm_used_by.sql
update_images_opm.sql

Database updates:
-----------------
guez_db_update.sql
ahtc_db_update.sql
