Differences

This shows you the differences between two versions of the page.

--- medal-data-integration-details [2022/01/10 10:56] – arnaud_poletto
+++ medal-data-integration-details [2022/01/10 14:56] (current) – removed arnaud_poletto
@@ Line 1: / Line 1: @@
-===== medAL-data Integration details ======
-In this section we summarize the components that have been integrated into medAL-data's Laravel web server.
-===== Back-end Changes =====
-The back-end changes consists of the following additions:
-  - Model and Controller for Health Facilities and Devices
-  - ''Laravel Passport'' plugin
-  - New service classes to perform the business logic for:
-    - Algorithms
-    - Devices
-    - Health Facilities
-  - ''AuthDeviceController'' which is the controller used for most of the Passport-protected API routes for devices.
-==== Passport Installation ====
-In order to install passport, we had to make slight changes to the laravel version currently used by this server. Originally, the ''composer.json'' file had the following version:
-<code>
- "require": {
-...
-        "laravel/framework": "6.0.*",
-...
-    },
-</code>
-Which we changed to:
-<code>
-"require": {
-    ....
-        "laravel/framework": "^6.20.26",
-    ...
-    },
-</code>
-for the passport installation to work properly.
-After changing the ''composer.json'', we run ''composer update'' followed by ''composer require laravel/passport'' which successfully installed passport's back-end routes. The routes used for Passport are then registered in the ''AuthServiceProvider.php'' provider class where we only used the routes necessary for our desired functionality.
-==== Database Migrations ====
-The new migrations are the following:
-  - New nullable columns are added to the pre-existing ''health_facilities'' table that are used to manage health facilities. Moreover, a name column has been added (as the pre-existing was unconventionally called ''facility_name'').
-  - The ''devices'' table and ''device_types'' table have been created to store device information.
-  - The health_facility_accesses table has been created to store all the algorithm versions metadata that have been assigned to health facilities.
-  - The ''version_jsons'' table has been created to store the version's json files that are then fetched by the devices.
-==== Services ====
-  * The ''DeviceService'' class is used to make the link between a Device model and Passport's Client model, which represent OAuth clients. This service is also used to resolve a Device model from a token that is part of the request.
-  * The ''HealthFacilityService'' class is used to assign and unassign devices.
-  * The ''AlgorithmService'' class is used to fetch algorithms and versions from the medAL-//creator// server and assign versions to health facilities.
-For more information, the service classes are properly commented in ''App/Http/Services''.
-==== Controllers ====
-The newly controllers are the following:
-  * The ''DeviceController'' handles requests for creating editing and deleting devices.
-  * The ''HealthFacilityController'' handles request for creating, editing and deleting health facilities. Additionally, it handles algorithm related-requests and assignment/unassignment of devices.
-  * The ''Api\AuthDeviceController'' handles requests coming from authenticated devices to fetch their health facility information, upload their device information and get their algorithm versions.
-==== Middlewares and Policies ====
-The ''DeviceController'' and ''HealthFacilityController'' are guarded by the ''web'' and ''auth'' and ''permission'':
-  - middleware (only users with the ''Logistician'' role hold these permissions). Additionally, handles authorize slug requests depending on policies that only allow a user to modify its own resources. The ''Api\AuthDeviceController'' handlers are guarded by the ''auth:api'' middleware which is followed by the ''device.resolve'' middleware which translates each request with a token to the corresponding device model and adds a timestamp to the ''last_seen'' column of the ''devices'' table.
-==== Requests and Resources ====
-For creating and editing devices and health facilities, custom request classes have been created to validate the request. Moreover, when returning device models to the front-end it is first converted to a Device resource which omits some fields and translates others for the user.
-==== Roles ====
-The ''Logistician'' role has been added with has permissions to reset its own password, view its user information, manage health facilities and devices.
-===== Front-end Changes =====
-The existing front-end has been extended with two new dashboard accessible to logistician users, Devices and Health Facilities. Both dashboard are made of reactive vue components.
-==== Upgrade Laravel-Mix ====
-The version of Laravel mix previously declared in ''package.json'' was making the node compilation failed (on heroku) so it has been changed to : ''"laravel-mix": "^5.0.1",''
-after which the command ''npm install'' is run to update the dependencies.