diff --git a/docs/easycozy/commands.md b/docs/easycozy/commands.md index 3e4bc3c0311e3934f9f61c71dfcaeba7eadb1218..ac3da7766bacfc5360f171366cdd92e783e5b084 100644 --- a/docs/easycozy/commands.md +++ b/docs/easycozy/commands.md @@ -1,17 +1,19 @@ -Here are common commands use on dev environment. +# Easy Cozy commands -# App +This section includes all common commands used on dev environment. -## Install a specific version of an app +## App + +### Install a specific version of an app ```bash $ cd /easy-cozy $ docker-compose exec cozy ./cozy apps update home --domain "[name].cozy.self-data.alpha.grandlyon.com" git://github.com/doubleface/cozy-collect.git#build-debug ``` -# Konnector +## Konnector -## Install a specific version of a konnector +### Install a specific version of a konnector ```bash $ cd /easy-cozy @@ -23,7 +25,7 @@ $ docker-compose exec cozy ./cozy konnectors install grdfgrandlyon --domain "[na grdfgrandlyon (0.1.5-a3f6f05d9fde7c705b811658b3ce3667a9d7d0b5) has been installed on [name].cozy.self-data.alpha.grandlyon.com ``` -## Update the version of a konnector +### Update the version of a konnector ```bash $ cd /easy-cozy @@ -31,7 +33,7 @@ $ cd /easy-cozy $ docker-compose exec cozy ./cozy konnectors update grdfgrandlyon --domain "[name].cozy.self-data.alpha.grandlyon.com" grdfgrandlyon has been upgraded to 0.1.5-d4bbe7350ecf13d13734f559c538e3c0ee8dc7ae ``` -## Run a konnector from the stack +### Run a konnector from the stack ```bash $ cd /root/easy-cozy @@ -39,9 +41,9 @@ $ cd /root/easy-cozy $ docker-compose exec cozy ./cozy konnectors run grdfgrandlyon --domain "[name].cozy.self-data.alpha.grandlyon.com" ``` -# Instance +## Instance -## Set log level to debug for an instance +### Set log level to debug for an instance ```bash $ cd /root/easy-cozy @@ -50,16 +52,16 @@ $ docker-compose exec cozy ./cozy instances debug --domain "[name].cozy.self-dat ``` -# Stack +## Stack -## Check stack version +### Check stack version ```bash $ cd /easy-cozy $ docker-compose exec cozy ./cozy version ``` -## Update stack version +### Update stack version Update version in the Dockerfile on gitlab. @@ -83,4 +85,5 @@ Update version in the Dockerfile on gitlab. !!! info "Error encounter" Docker container was not launched, when consulting logs we can see the folowing error > ./cozy: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.32' not found (required by ./cozy) + We have replaced debian:stable-slim with unbuntu:20.10 as installer for our docker build: [https://forge.grandlyon.com/pocs/cozy/easy-cozy/-/commit/48a30a03f209169e0f1ebb0d106bb4361e7cd167](https://forge.grandlyon.com/pocs/cozy/easy-cozy/-/commit/48a30a03f209169e0f1ebb0d106bb4361e7cd167) diff --git a/docs/easycozy/scripts.md b/docs/easycozy/scripts.md index b8388bfcd4918a02f0dc30faf32d380a4ff1b85b..91766c9b973179cb552a8cceaf41e8d3fabafae7 100644 --- a/docs/easycozy/scripts.md +++ b/docs/easycozy/scripts.md @@ -1,32 +1,33 @@ # Easy Cozy scripts -Easy cozy project comes with 2 main scripts: +Easy cozy project comes with 2 main scripts: + - create-instance.sh: used to create an instance for a user - remove-instance.sh: used to remove an instance for a specific user In addition of these scripts we have added custom scripts for some specific needs. All these scripts are available in the "admin_scripts" folder -# Scripts for instances +## Scripts for instances | Scripts | Args | Description | |-------------------|-------------------|----------------------------------------------------------| -| reset_instance.sh | instance_url | Remove and recreate again the instance for a given user | +| reset_instance.sh | instance_username | Remove and recreate again the instance for a given user | -# Scripts for applications +## Scripts for applications | Scripts | Args | Description | |--------------------------|-------------------|-------------------------------------------------------------------------------| | update_all_ecolyo_dev.sh | none | update Ecolyo with last version from build-dev branch on all instances | -| update_ecolyo_master.sh | instance_url | update Ecolyo with last version from build branch on a specific instance | -| update_ecolyo_dev.sh | instance_url | update Ecolyo with last version from build-dev branch on a specific instance | -| update_ecolyo_test.sh | instance_url | update Ecolyo with last version from build-test branch on a specific instance | -| update_pilote_master.sh | instance_url | update Pilote with last version from build-dev branch on a specific instance | -| update_pilote_dev.sh | instance_url | update PIlote with last version from build-test branch on a specific instance | +| update_ecolyo_master.sh | instance_username | update Ecolyo with last version from build branch on a specific instance | +| update_ecolyo_dev.sh | instance_username | update Ecolyo with last version from build-dev branch on a specific instance | +| update_ecolyo_test.sh | instance_username | update Ecolyo with last version from build-test branch on a specific instance | +| update_pilote_master.sh | instance_username | update Pilote with last version from build-dev branch on a specific instance | +| update_pilote_dev.sh | instance_username | update PIlote with last version from build-test branch on a specific instance | -# Scripts for konnectors +## Scripts for konnectors | Scripts | Args | Description | |---------------------------------|-------------------|----------------------------------------------------------------------------------------| -| update_enedis_konnector_prod.sh | instance_url | update Enedis konnector with last version from build branch on a specific instance | -| update_enedis_konnector_dev.sh | instance_url | update Enedis konnector with last version from build-dev branch on a specific instance | +| update_enedis_konnector_prod.sh | instance_username | update Enedis konnector with last version from build branch on a specific instance | +| update_enedis_konnector_dev.sh | instance_username | update Enedis konnector with last version from build-dev branch on a specific instance | diff --git a/docs/ecolyo/project_architecture/architecture.md b/docs/ecolyo/project_architecture/architecture.md index 26f2105bdccaf37c202519169b1d4bf3c8336fc3..8943d8a1544e8a66a0cbcc7e61f3cd1eff3d0372 100644 --- a/docs/ecolyo/project_architecture/architecture.md +++ b/docs/ecolyo/project_architecture/architecture.md @@ -1,84 +1,7 @@ -## Libraries +# Architecture -For this project, we use the libraries below: +## Principle diagram -###React +The principle diagram below describes the responsibilities of each application brick. -Library to create user interfaces. -Design simple views for each state in your application, and React will efficiently update and render just the right components when your data changes. - -Build encapsulated components that manage their own state, then compose them to make complex UIs. - -Since component logic is written in JavaScript instead of templates, you can easily pass rich data through your app and keep state out of the DOM - -###React Redux - -It is a predictable state container. - -It is implemented for a better management of the states because it allows to centralize all the states and the logic of the application. -It lets a react component read data from a Redux store, and dispatch actions to the store to update data. - -###Axios - -HTTP client library - -It allows to send HTTP request and manage the responses. - -###Lodash - -javascript utility library - -Lodash'modular method are great for: - -- Iterating arrays, objects, & strings -- Manipulating & testing values -- Creating composite functions - -###Moment - -Date library to parse, validate, manipulate, and display dates and times in JavaScript. - -###Luxon - -Wrapper for Javascript dates and times. - -###Jest - -Testing library - -It allows to evaluate functionnalities of an app to ensure that the product is defect-free in order to produce the quality product. - -###Enzyme - -Testing utility for React - -It makes it easier to test your React Components' output. You can also manipulate, traverse, and in some ways simulate runtime given the output. - -###Sass - -CSS preprocessor - -It allows us to easily manage large CSS files and split across different files. -It allows us to create variables, nested rules, mixins, functions, and do mathematical calculations. - -###Material UI - -It allows to create react component that implements Google's material design - -###D3 - -It allows to manipulate documents based on data. -It combines visualization components and a data-driven approach to DOM manipulation. - -###React-swipeable-views - -It is a React component to make swipeable views - -###React-lottie - -Lottie Animation View for React. -It allows app to use animations easily. - -###Husky - -It is used to improve your commit. + diff --git a/docs/ecolyo/project_architecture/cozy.md b/docs/ecolyo/project_architecture/cozy.md deleted file mode 100644 index 2f4f692dba5c6228a0130fccce621b4c7e2d7452..0000000000000000000000000000000000000000 --- a/docs/ecolyo/project_architecture/cozy.md +++ /dev/null @@ -1,2 +0,0 @@ -!!! info "" - :construction: Section under Construction :construction: \ No newline at end of file diff --git a/docs/ecolyo/project_architecture/libraries.md b/docs/ecolyo/project_architecture/libraries.md new file mode 100644 index 0000000000000000000000000000000000000000..227c6e9615e03088c8b3f95b345277decaee028f --- /dev/null +++ b/docs/ecolyo/project_architecture/libraries.md @@ -0,0 +1,84 @@ +# Libraries + +For this project, we use the libraries below: + +## React + +Library to create user interfaces. +Design simple views for each state in your application, and React will efficiently update and render just the right components when your data changes. + +Build encapsulated components that manage their own state, then compose them to make complex UIs. + +Since component logic is written in JavaScript instead of templates, you can easily pass rich data through your app and keep state out of the DOM + +## React Redux + +It is a predictable state container. + +It is implemented for a better management of the states because it allows to centralize all the states and the logic of the application. +It lets a react component read data from a Redux store, and dispatch actions to the store to update data. + +## Axios + +HTTP client library + +It allows to send HTTP request and manage the responses. + +## Lodash + +javascript utility library + +Lodash'modular method are great for: + +- Iterating arrays, objects, & strings +- Manipulating & testing values +- Creating composite functions + +## Moment + +Date library to parse, validate, manipulate, and display dates and times in JavaScript. + +## Luxon + +Wrapper for Javascript dates and times. + +## Jest + +Testing library + +It allows to evaluate functionnalities of an app to ensure that the product is defect-free in order to produce the quality product. + +## Enzyme + +Testing utility for React + +It makes it easier to test your React Components' output. You can also manipulate, traverse, and in some ways simulate runtime given the output. + +## Sass + +CSS preprocessor + +It allows us to easily manage large CSS files and split across different files. +It allows us to create variables, nested rules, mixins, functions, and do mathematical calculations. + +## Material UI + +It allows to create react component that implements Google's material design + +## D3 + +It allows to manipulate documents based on data. +It combines visualization components and a data-driven approach to DOM manipulation. + +##React-swipeable-views + +It is a React component to make swipeable views + +## React-lottie + +Lottie Animation View for React. +It allows app to use animations easily. + +## Husky + +It is used to improve your commit. diff --git a/docs/img/architecture/cozy-architecture-principles.png b/docs/img/architecture/cozy-architecture-principles.png new file mode 100644 index 0000000000000000000000000000000000000000..30b67b9cadc17cc4e223c4b9a63c5eef860b6420 Binary files /dev/null and b/docs/img/architecture/cozy-architecture-principles.png differ diff --git a/docs/ecolyo/konnectors/egl.md b/docs/konnectors/egl.md similarity index 100% rename from docs/ecolyo/konnectors/egl.md rename to docs/konnectors/egl.md diff --git a/docs/ecolyo/konnectors/enedis.md b/docs/konnectors/enedis.md similarity index 100% rename from docs/ecolyo/konnectors/enedis.md rename to docs/konnectors/enedis.md diff --git a/docs/ecolyo/konnectors/grdf.md b/docs/konnectors/grdf.md similarity index 100% rename from docs/ecolyo/konnectors/grdf.md rename to docs/konnectors/grdf.md diff --git a/mkdocs.yml b/mkdocs.yml index 3a3a1a51b651b22f562468af578f58c4d3c626ce..8a682782d3df81277f1718e843f3767a00644bf4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -5,94 +5,93 @@ repo_name: "Clone the Project" repo_url: "https://forge.grandlyon.com/web-et-numerique/llle_project/self-data-technical-doc" theme: - name: "material" - # logo: 'img/self_data_grdlyon.png' - favicon: "img/self_data_grdlyon.png" - palette: - primary: "white" - accent: "red" + name: "material" + # logo: 'img/self_data_grdlyon.png' + favicon: "img/self_data_grdlyon.png" + palette: + primary: "white" + accent: "red" markdown_extensions: - - admonition - - plantuml_markdown: - server: http://www.plantuml.com/plantuml - - attr_list - - pymdownx.emoji + - admonition + - plantuml_markdown: + server: http://www.plantuml.com/plantuml + - attr_list + - pymdownx.emoji extra_css: - - "stylesheets/extra.css" + - "stylesheets/extra.css" nav: - - Home: index.md - - Easy Cozy: - - Scripts: easycozy/scripts.md - - Commands: easycozy/commands.md - - Pilote: - - Pilote - TS - Back: - - Index: pilote/Pilote - TS - Back/index.md - - Application: - - Deploy: pilote/Pilote - TS - Back/application/deploy.md - - Functionalities: - - Routes: pilote/Pilote - TS - Back/functionalities/routes.md - - Getting Started: - - Launch the application on local: pilote/Pilote - TS - Back/getting_started/launch_local_application.md - - Setup your environment: pilote/Pilote - TS - Back/getting_started/setup_your_environment.md - - Project Architecture: pilote/Pilote - TS - Back/project_architecture/architecture.md - - Pilote - TS - Front: - - Index: pilote/Pilote - TS - Front/index.md - - Application: - - Deploy: pilote/Pilote - TS - Front/application/deploy.md - - Functionalities: - - Routes: pilote/Pilote - TS - Front/functionalities/functions.md - - Getting Started: - - Launch the application on local: pilote/Pilote - TS - Front/getting_started/launch_local_application.md - - Pilote - Usager: - - Application: - - Deploy: pilote/Pilote - Usager/application/deploy.md - - Doctypes: pilote/Pilote - Usager/application/doctypes.md - - Gitflow: pilote/Pilote - Usager/application/gitflow.md - - Scaffolding: pilote/Pilote - Usager/application/scaffolding.md - - Services: pilote/Pilote - Usager/application/services.md - - Store: pilote/Pilote - Usager/application/store.md - - Functionalities: - - Appointments: pilote/Pilote - Usager/functionalities/appointments.md - - Contact: pilote/Pilote - Usager/functionalities/contact.md - - Document: pilote/Pilote - Usager/functionalities/document.md - - Settings: pilote/Pilote - Usager/functionalities/setting.md - - Getting Started: - - Launch local doctypes: pilote/Pilote - Usager/getting_started/launch_local_doctypes.md - - Launch local services: pilote/Pilote - Usager/getting_started/launch_local_services.md - - Ecolyo: - - Introduction: ecolyo/index.md - - Getting started: - - Setup your environment: ecolyo/getting_started/setup_your_environment.md - - Launch the application on local: ecolyo/getting_started/launch_local_application.md - - Launch a konnector on local: ecolyo/getting_started/launch_local_konnector.md - - Project Architecture: - - Architecture: ecolyo/project_architecture/architecture.md - - Cozy: ecolyo/project_architecture/cozy.md - - Environments: ecolyo/project_architecture/environments.md - - DocTypes: ecolyo/project_architecture/doctypes.md - - Application: - - Description: ecolyo/application/description.md - - Scaffolding: ecolyo/application/scaffolding.md - - Services: ecolyo/application/services.md - - Gitflow: ecolyo/application/gitflow.md - - Deploy: ecolyo/application/deploy.md - - Konnectors: - - Enedis: ecolyo/konnectors/enedis.md - - GRDF: ecolyo/konnectors/grdf.md - - Eau du Grand Lyon: ecolyo/konnectors/egl.md - - Functionalities: - - Initialization: ecolyo/functionalities/initialization.md - - Consumption: ecolyo/functionalities/consumption.md - - Ecogesture: ecolyo/functionalities/ecogesture.md - - Challenge: ecolyo/functionalities/challenge.md - - Analysis: ecolyo/functionalities/analysis.md - - Profile Type: ecolyo/functionalities/profile_type.md - - Proxy: - - Description: proxy/description.md - - Monitoring: proxy/monitoring.md - - Use cases: - - Enedis: proxy/use_cases/enedis.md - - Grdf Adict: proxy/use_cases/grdfadict.md + - Home: index.md + - Easy Cozy: + - Scripts: easycozy/scripts.md + - Commands: easycozy/commands.md + - Ecolyo: + - Introduction: ecolyo/index.md + - Getting started: + - Setup your environment: ecolyo/getting_started/setup_your_environment.md + - Launch the application on local: ecolyo/getting_started/launch_local_application.md + - Launch a konnector on local: ecolyo/getting_started/launch_local_konnector.md + - Project Architecture: + - Architecture: ecolyo/project_architecture/architecture.md + - Libraries: ecolyo/project_architecture/libraries.md + - Environments: ecolyo/project_architecture/environments.md + - DocTypes: ecolyo/project_architecture/doctypes.md + - Application: + - Description: ecolyo/application/description.md + - Scaffolding: ecolyo/application/scaffolding.md + - Services: ecolyo/application/services.md + - Gitflow: ecolyo/application/gitflow.md + - Deploy: ecolyo/application/deploy.md + - Functionalities: + - Initialization: ecolyo/functionalities/initialization.md + - Consumption: ecolyo/functionalities/consumption.md + - Ecogesture: ecolyo/functionalities/ecogesture.md + - Challenge: ecolyo/functionalities/challenge.md + - Profile Type: ecolyo/functionalities/profile_type.md + - Pilote: + - Pilote - TS - Back: + - Index: pilote/Pilote - TS - Back/index.md + - Application: + - Deploy: pilote/Pilote - TS - Back/application/deploy.md + - Functionalities: + - Routes: pilote/Pilote - TS - Back/functionalities/routes.md + - Getting Started: + - Launch the application on local: pilote/Pilote - TS - Back/getting_started/launch_local_application.md + - Setup your environment: pilote/Pilote - TS - Back/getting_started/setup_your_environment.md + - Project Architecture: pilote/Pilote - TS - Back/project_architecture/architecture.md + - Pilote - TS - Front: + - Index: pilote/Pilote - TS - Front/index.md + - Application: + - Deploy: pilote/Pilote - TS - Front/application/deploy.md + - Functionalities: + - Routes: pilote/Pilote - TS - Front/functionalities/functions.md + - Getting Started: + - Launch the application on local: pilote/Pilote - TS - Front/getting_started/launch_local_application.md + - Pilote - Usager: + - Application: + - Deploy: pilote/Pilote - Usager/application/deploy.md + - Doctypes: pilote/Pilote - Usager/application/doctypes.md + - Gitflow: pilote/Pilote - Usager/application/gitflow.md + - Scaffolding: pilote/Pilote - Usager/application/scaffolding.md + - Services: pilote/Pilote - Usager/application/services.md + - Store: pilote/Pilote - Usager/application/store.md + - Functionalities: + - Appointments: pilote/Pilote - Usager/functionalities/appointments.md + - Contact: pilote/Pilote - Usager/functionalities/contact.md + - Document: pilote/Pilote - Usager/functionalities/document.md + - Settings: pilote/Pilote - Usager/functionalities/setting.md + - Getting Started: + - Launch local doctypes: pilote/Pilote - Usager/getting_started/launch_local_doctypes.md + - Launch local services: pilote/Pilote - Usager/getting_started/launch_local_services.md + - Konnectors: + - Enedis: konnectors/enedis.md + - GRDF: konnectors/grdf.md + - Eau du Grand Lyon: konnectors/egl.md + - Proxy: + - Description: proxy/description.md + - Monitoring: proxy/monitoring.md + - Use cases: + - Enedis: proxy/use_cases/enedis.md + - Grdf Adict: proxy/use_cases/grdfadict.md