Difference between revisions of "ARK2"

From ARK
Jump to: navigation, search
(Supported Platforms)
(Aims)
 
(299 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
This page details the progress on development of ARK 2.0
 
This page details the progress on development of ARK 2.0
  
== Supported Platforms ==
+
== Aims ==
  
ARK will only actively support platforms that are actively supported by their maintainers. ARK may work on earlier versions but this is not guaranteed.
+
The primary aims of ARK2 are:
 +
* Full code re-write to modern standards using modern components
 +
* Separate the ARK Database backend from the ARK Web frontend
 +
* Implement a modern REST API to allow other frontends and apps to access and update the ARK Database
 +
* Simplify the setup and configuration of ARK by moving the config into the database and providing online config tools
 +
* Improve the overall performance and data integrity of ARK
 +
* Make it possible to provide an ARK hosting service
  
* PHP: A minimum of v5.6 will be supported (5.6 is in Security Support, 5.7 in active support, see http://php.net/supported-versions.php), v7 will be supported.
+
Modern frontend
* MySQL/MariaDB v5.5 (lowest supported MySQL)
+
* HTML5
* Postgre and SQLite may be considered later
+
* Bootstrap based
 +
* Twig templates
 +
* Front Controller model
 +
* Config driven pages views
  
== Code Repository ==
+
Modern backend
 +
* Full REST API to access and update all ARK data
 +
* Database abstraction and Object Relational Mapping
 +
* Config driven data schema
 +
* Controlled Vocabularies and Linked Open Data
 +
* User Authentication via internal user/password and external OAuth2 providers (Facebook, Google, etc)
 +
* User Authorisation via Role Based Access Control (RBAC) using hierarchical Roles and Permissions structure
 +
* Field-level data access control
 +
* Data Workflows in conjunction with User Authorisation control
  
Development of ARK 2.0 is occurring in the open on GitHub https://github.com/lparchaeology/ark2
+
== Documentation ==
  
== Framework ==
+
Details of ARK2 can be found in the following sections:
  
It is proposed to implement a new RESTful Request/Response framework using a Front Controller model, based on external components adhering to the [http://www.php-fig.org/psr/ PHP-FIG] standards. This will reduce the amount of code maintained internally, update the code-base to modern web-app design principals, and provide a degree of future-proofing. Choosing a full framework at this point would force refactoring all of the model and view code at the same time, but by initially building our own light-weight controller framework we can migrate the model and view later. Once all parts are migrated, a full framework could be considered if required.
+
* [[ARK2/Design|Design]] - High Level Design Decisions
 
+
* [[ARK2/Technical|Technical]] - Technical details, Development tools and procedures
* [https://getcomposer.org/ Composer] will be used to install external vendor libraries, including the components
+
* [[ARK2/The_ARK_Way|The ARK Way]] - Web Development - The ARK2 Way
* [http://symfony.com/ Symphony] components will be used to build the framework (alternative [http://www.slimframework.com/ Slim]?)
+
* [[ARK2/Install|Install]] - Installation Instructions
 
+
* [[ARK2/Architecture|Architecture]] - System Architecture
Read the following for further info:
+
* [[ARK2/Database|Database]] - Database / ORM details
* http://symfony.com/doc/current/book/http_fundamentals.html
+
* [[ARK2/Cache|Cache]] - Cache details
* http://symfony.com/doc/current/book/from_flat_php_to_symfony2.html
+
* [[ARK2/Model|Model]] - Data model / Schema
* http://symfony.com/doc/current/create_framework/index.html
+
* [[ARK2/View|View]] - Views on the Data Model
 
+
* [[ARK2/Spatial|Spatial]] - Spatial data
The ARK root folder will contain only the index.php file which will act as a dispatcher, receiving all Requests, matching the Route and dispatching them to the correct Controller. Each ARK page type and the api will have a Controller to read the model and construct the view before returning the Response. This will allow future flexibility for new request formats while still being able to support persistent legacy links. It will also allow for database config and user auth driven routing, e.g. one install may only expose the RESTful API, while others may only expose read-only pages.
+
* [[ARK2/Vocabulary|Vocabulary]] - Controlled Vocabularies
 
+
* [[ARK2/Files|File Management]] - File, Image, and other Media Management
Besides the core HTTP and Routing modules, the Security, Translations, Forms, Validation, and Console components should be considered.
+
* [[ARK2/Localization|Localization]] - Internationalization, Localization, and Translation
 
+
* [[ARK2/Security|Security]] - Security, Authentication, Authorisation, User Management
== Configuration ==
+
* [[ARK2/API|API]] - REST API implementation
 
+
* [[ARK2/Frontend|Frontend]] - Web Frontend
Significant changes to the configuration of ARK are being made to move from PHP file based configuration to database based configuration. This section will document these changes.
+
* [[ARK2/Templates|Templates]] - Using Twig for the Web Frontend
 
+
* [[ARK2/Console|Console]] - Admin Consoles
* The config/ folder will contain all user-editable php files required, all other config will be in the database
+
* [[ARK2/Admin|Admin]] - Admin Frontend
* The env_settings.php file is replaced by server.php and paths.php
+
* [[ARK2/Branding|Branding]] - Branding of the ARK Project, Products, and Service
* server.php contains the settings for the database connection and root server path and should be the only file requiring editing for a default ARK install
 
* paths.php contains the settings for the server file paths and should not need editing
 
* To set-up an ARK, copy the config folder from php/arkdb/config to teh root folder and edit as required
 
* preflight_checks.php now defaults to off, so needs to be enabled before running, and then deleted form config afterwards
 
* settings.php has moved from config/ to php/settings/ and no longer requires user editing, all settings are now held in the database and should be configured per the instructions
 
 
 
== Database ==
 
 
 
* Configuration has been moved to the database
 
* A new ADO class has been created to wrap all access to PDO
 
 
 
== Changes ==
 
 
 
Other significant changes are documented here.
 
 
 
 
 
* A number of config global variables have been renamed for consistency
 
** Any var ending in _dir is an absolute filesystem directory path
 
** Any var ending in _path is a URL path relative to the hostname and always starts with a '/'
 
** Neither var ever ends in a separator
 
** $ark_server_path -> $ark_root_dir
 
** $ark_dir -> $ark_root_path and no longer ends in a /
 
** $registered_files_host -> $registered_files_path
 
** $phMagickDir -> $phmagick_file
 
** ark_web_maptemp_dir -> ark_maptemp_path
 
** $ark_lib_dir and $ark_lib_path point to the library folder
 
** $skins_dir and $skins_path point to the skins folder
 
** $skin_dir and $skin_path point to the current skin folder
 
 
 
 
 
* A number of config global variables have been renamed for clarity
 
** $mode -> $search_mode
 
** $ftx_mode -> $search_ftx_mode
 
 
 
 
 
* A number of config global variables have been deleted as they are not used:
 
** $default_year
 
** $conf_non_search_words
 
** $conf_langs
 
** $loaded_map_modules
 
** $default_output_mode
 
 
 
 
 
* The logging globals have been changed
 
** $log, $conf_log_add, $conf_log_edt, $conf_log_del are deleted
 
** $log_ins, $log_upd and $log_del are used instead
 
 
 
 
 
* The $fs_path_sep and $fs_slash have been removed, use PATH_SEPARATOR and DIRECTORY_SEPARATOR constants instead.
 

Latest revision as of 12:34, 7 August 2018

This page details the progress on development of ARK 2.0

Aims

The primary aims of ARK2 are:

  • Full code re-write to modern standards using modern components
  • Separate the ARK Database backend from the ARK Web frontend
  • Implement a modern REST API to allow other frontends and apps to access and update the ARK Database
  • Simplify the setup and configuration of ARK by moving the config into the database and providing online config tools
  • Improve the overall performance and data integrity of ARK
  • Make it possible to provide an ARK hosting service

Modern frontend

  • HTML5
  • Bootstrap based
  • Twig templates
  • Front Controller model
  • Config driven pages views

Modern backend

  • Full REST API to access and update all ARK data
  • Database abstraction and Object Relational Mapping
  • Config driven data schema
  • Controlled Vocabularies and Linked Open Data
  • User Authentication via internal user/password and external OAuth2 providers (Facebook, Google, etc)
  • User Authorisation via Role Based Access Control (RBAC) using hierarchical Roles and Permissions structure
  • Field-level data access control
  • Data Workflows in conjunction with User Authorisation control

Documentation

Details of ARK2 can be found in the following sections: