diff --git a/README.md b/README.md
index 8deb2af337986c414e0099ad2e5de02a5ee8d155..ee9feb336195afa851199999b8ed5f8d67cdf8ab 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,10 @@
## Commands
-* `py -m pip install mkdocs` - Install mkdocs
-* `mkdocs serve` - Start the live-reloading docs server.
-* `mkdocs build` - Build the documentation site.
-* `mkdocs help` - Print this help message.
+- `py -m pip install mkdocs` - Install mkdocs
+- `mkdocs serve` - Start the live-reloading docs server.
+- `mkdocs build` - Build the documentation site.
+- `mkdocs help` - Print this help message.
## Mkdocs packages
@@ -13,96 +13,98 @@
py -m pip install plantuml-markdown
## Setting files hierarchy
+
inside mkdocs.yml, configure the md files hierarchy
nav:
- - Home: index.md
- - Easy Cozy:
- - Configuration: easycozy/config.md
- - Commands: easycozy/commands.md
- - Known errors: easycozy/known_errors.md
- - Scripts: easycozy/scripts.md
- - Tips: easycozy/tips.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
- - Remote DocTypes: ecolyo/project_architecture/remote_doctypes.md
- - Application:
- - Description: ecolyo/application/description.md
- - Redux: ecolyo/application/redux.md
- - Scaffolding: ecolyo/application/scaffolding.md
- - Services: ecolyo/application/services.md
- - Gitflow: ecolyo/application/gitflow.md
- - Deploy: ecolyo/application/deploy.md
- - Mail: ecolyo/application/mail.md
- - Services:
- - Description: ecolyo/services/index.md
- - Monthly report notification: ecolyo/services/monthly_report_notification.md
- - Aggregator usage events: ecolyo/services/aggregator_usage_events.md
- - Consumption Alert: ecolyo/services/consumption_alert.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
- - Analysis: ecolyo/functionalities/analysis.md
- - Usage events tracking: ecolyo/functionalities/usage_events_tracking.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:
- - Introduction: konnectors/index.md
- - 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
+- Home: index.md
+- Easy Cozy:
+ - Configuration: easycozy/config.md
+ - Commands: easycozy/commands.md
+ - Known errors: easycozy/known_errors.md
+ - Scripts: easycozy/scripts.md
+ - Tips: easycozy/tips.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
+ - Remote DocTypes: ecolyo/project_architecture/remote_doctypes.md
+ - Application:
+ - Description: ecolyo/application/description.md
+ - Redux: ecolyo/application/redux.md
+ - Scaffolding: ecolyo/application/scaffolding.md
+ - Services: ecolyo/application/services.md
+ - Gitflow: ecolyo/application/gitflow.md
+ - Deploy: ecolyo/application/deploy.md
+ - Mail: ecolyo/application/mail.md
+ - Services:
+ - Description: ecolyo/services/index.md
+ - Monthly report notification: ecolyo/services/monthly_report_notification.md
+ - Aggregator usage events: ecolyo/services/aggregator_usage_events.md
+ - Consumption Alert: ecolyo/services/consumption_alert.md
+ - Functionalities:
+ - Initialization: ecolyo/functionalities/initialization.md
+ - Onboarding: ecolyo/functionalities/onboarding.md
+ - Consumption: ecolyo/functionalities/consumption.md
+ - Ecogesture: ecolyo/functionalities/ecogesture.md
+ - Challenge: ecolyo/functionalities/challenge.md
+ - Profile Type: ecolyo/functionalities/profile_type.md
+ - Analysis: ecolyo/functionalities/analysis.md
+ - Usage events tracking: ecolyo/functionalities/usage_events_tracking.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:
+ - Introduction: konnectors/index.md
+ - 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
## Project layout
diff --git a/docs/ecolyo/functionalities/onboarding.md b/docs/ecolyo/functionalities/onboarding.md
new file mode 100644
index 0000000000000000000000000000000000000000..e6559482dff03c0aa911359ebf31058cce0d4749
--- /dev/null
+++ b/docs/ecolyo/functionalities/onboarding.md
@@ -0,0 +1,20 @@
+This section explains the way we handle onboarding the application.
+
+## Description
+
+When the user connects for the first time to Ecolyo, onboarding screens will be displayed.
+!!! note "First connection"
+ The first connection is define by the **isFirstConnection** boolean contains in the **profile** doctype.
+
+### GCU screen
+
+First of all, we display the GCU screen, which allows user to read the General Condition of Use and the Legal Notive. The user should consent to all the terms to go further in the application.
+!!! note "About terms"
+ More details are available on the (term section)[/ecolyo/functionalities/terms.md].
+
+### Welcome modal
+
+After GCU screen we display a welcome modal to inform user about further steps needed to use Ecolyo (connection to partners to retrieve the data, ...).
+We store in user's profile a boolean _onboarding.isWelcomeSeen_ that allows the app to know is the modal has already be seen. If the modal has been seen we will never display it again.
+
+When user close this modal, the **welcome mail** is sent to the user.
diff --git a/mkdocs.yml b/mkdocs.yml
index ae0a53500763e0dbc1b7629916e9f1eef40bf67c..3f4eba778d0e21fa9568bb7043b22788405e480c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -58,6 +58,7 @@ nav:
- Enedis Halfhour Monthly Analysis: ecolyo/services/enedis_halfhour_monthly_analysis.md
- Functionalities:
- Initialization: ecolyo/functionalities/initialization.md
+ - Onboarding: ecolyo/functionalities/onboarding.md
- Consumption: ecolyo/functionalities/consumption.md
- Ecogesture: ecolyo/functionalities/ecogesture.md
- Challenge: ecolyo/functionalities/challenge.md
@@ -66,20 +67,20 @@ nav:
- Usage events tracking: ecolyo/functionalities/usage_events_tracking.md
- Feedback: ecolyo/functionalities/feedback.md
- Terms: ecolyo/functionalities/terms.md
- - Ecolyo-Agent:
+ - Ecolyo-Agent:
- Introduction: ecolyo/ecolyo-agent/introduction.md
- Getting started:
- - Setup your environment: ecolyo/ecolyo-agent/getting_started/setup_your_environment.md
- - Launch the application on local: ecolyo/ecolyo-agent/getting_started/launch_local_application.md
- - Libraries: ecolyo/ecolyo-agent/getting_started/libraries.md
+ - Setup your environment: ecolyo/ecolyo-agent/getting_started/setup_your_environment.md
+ - Launch the application on local: ecolyo/ecolyo-agent/getting_started/launch_local_application.md
+ - Libraries: ecolyo/ecolyo-agent/getting_started/libraries.md
- Functionalities:
- - General: ecolyo/ecolyo-agent/functionalities/general.md
- - Authentification: ecolyo/ecolyo-agent/functionalities/authentification.md
- - Routes: ecolyo/ecolyo-agent/functionalities/routes.md
+ - General: ecolyo/ecolyo-agent/functionalities/general.md
+ - Authentification: ecolyo/ecolyo-agent/functionalities/authentification.md
+ - Routes: ecolyo/ecolyo-agent/functionalities/routes.md
- Development:
- - Deploy: ecolyo/ecolyo-agent/development/deploy.md
- - Handle assets: ecolyo/ecolyo-agent/development/handle_assets.md
- - Backup: ecolyo/ecolyo-agent/development/backup.md
+ - Deploy: ecolyo/ecolyo-agent/development/deploy.md
+ - Handle assets: ecolyo/ecolyo-agent/development/handle_assets.md
+ - Backup: ecolyo/ecolyo-agent/development/backup.md
- Pilote:
- Pilote - TS - Back:
- Index: pilote/Pilote - TS - Back/index.md