From 3fe7d73eca5b05c7a75ed14819c4a9074fa9c1c8 Mon Sep 17 00:00:00 2001 From: Emeline Date: Tue, 14 Jul 2020 00:23:51 +0200 Subject: [PATCH 1/3] Add AstronoteCahierDesCharges.md --- AstronoteCahierDesCharges.md | 327 +++++++++++++++++++++++++++++++++++ 1 file changed, 327 insertions(+) create mode 100644 AstronoteCahierDesCharges.md diff --git a/AstronoteCahierDesCharges.md b/AstronoteCahierDesCharges.md new file mode 100644 index 0000000..2ad3b80 --- /dev/null +++ b/AstronoteCahierDesCharges.md @@ -0,0 +1,327 @@ +# Astronote Cahier des charges +--- +### SUJET +- **But**: Développer une application mobile crossplatform pour la gestion des notes de frais d'interface à [**enDI**](https://framagit.org/endi/endi) ("**en**treprendre **DI**fféremment") +- **Note**: Publié sous license libre ([GPLv3 License](https://framagit.org/membres-astrolabe/astronote/-/blob/master/LICENSE.txt)) dans un magasin d'application libre + +##### Etapes de travail: +- **Etape 1**: + +Première version simplifiée permettant de créer une note de frais et de rentrer à minima la date, le type de dépense et les charges (montants HT, TTC, TVA) +Stocker les informations en local dans une base de donnée simple (objets typés et des binaires) +Envoie sécurisé des informations collectées vers enDI (des contributions à enDI seront peut-être nécessaires) +- **Etape 2**: + +Système de pièces jointes de justificatifs et amélioration du design graphique +Inclure la prise de photo de la preuve de dépense et l'attacher en tant que pièce justificative +Reconnaissance de caractères optique (OCR) avec remplissage automatique lors de la prise de photo de la pièce justificative +Utilisation de briques logicielles disponibles en libre ou API standard Android permettant l'OCR +- **Environment**: Android / Lineage OS, F-Droid / Play Store, logiciel libre, progiciel métier +--- +## ETAPE 1 +[ ] ==**CONNECTION**== + +Scénario: +1. Un utilisateur passif veut se connecter : il doit le faire via un URL spécifique et des identifiants crées et envoyés auparavant par un administrateur ou un membre de l'équipe d'appui +2. L’utilisateur rempli le formulaire de connexion avec les informations nécessaires (adresse e-mail et mot de passe) et clique sur le bouton de connexion +3. L’utilisateur peut consulter le site d’enDI via l’URL si nécessaire +4. L’utilisateur peut consulter le site d’Astrolabe via l’URL si nécessaire + +L’utilisateur se connecte automatiquement à son compte enDI via une API Rest +Il est nécessaire de faire perdurer une session avec cookie + + +[ ] ==**ACCUEIL**== + +L'accueil permet d’assurer le suivi des notes enregistrées en Brouillon ou en attente de validation +Les notes sont affichées dans un tableau qui permet à l’utilisateur de : +- suivre l’état de ses notes (enregistrées en Brouillon ou en attente de validation) +- voir les informations globales des notes (la date, les montants HT, TVA, TTC, le nombre de kilomètres) +- voir le total des montants HT, de TVA, TTC, nombre de kilomètres des notes +- consulter des notes spécifiques + +Scenario: +1. Une fois l’authentification réussie + Si l’utilisateur est enregistré sur une seule enseigne: il est redirigé vers l’IHM de l’Accueil + Si l’utilisateur est enregistré sur plusieurs enseignes: il est redirigé vers l’IHM de visualisation de choix de l’enseigne sur laquelle il souhaite intervenir puis vers l’IHM de l’Accueil +2. Les notes de dépenses enregistrées en Brouillon ou en attente de validation sont affichées +3. L’utilisateur peut consulter des notes de dépense spécifiques : si tel est le cas, il est renvoyé sur les IHM des notes qu’il souhaite consulter + + +[ ] ==**GESTION D’UNE NOTE DE DÉPENSE**== + +Les dépenses sont séparées en deux sections : les frais liés au fonctionnement de l’enseigne (Frais) et les frais liés directement à l’activité auprès des clients (Achats) +Elles comprennent : +- les dépenses Frais et Achats : la date, le type de dépense, la description, le montant HT, le montant TVA, le total TTC +- les dépenses kilométriques : la date, le type, la prestation, le départ, l’arrivée, le nombre de kilomètres à indemniser + +Seules les dépenses liées au fonctionnement de l'enseigne sont développées/gérées dans cette première étape + +Lorsque l'utilisateur sélectionne une note de dépense spécifique il est redirigé vers l'IHM de la note +Cela permet d'assurer le suivi de : +- l’état de la note de dépense +- les justificatifs présents ou non +- les commentaires enregistrés (incluant : son contenu, le nom de son auteur et sa date d’envoi) +- les dépenses liées à la note + +Scénario: +1. Un utilisateur actif veut consulter une note de dépenses spécifique : il se rend sur l'IHM de l'Accueil et sélectionne la note de dépense qu’il souhaite consulter +2. Le système affiche l’ensemble des informations de la note de dépense + + +[ ] ==**CRÉER UNE NOTES DE DÉPENSES**== + +Scénario: +1. Un utilisateur actif veut créer une note de dépenses : il se rend sur l’IHM de l'Accueil et clique le bouton d’ajout +2. L’utilisateur doit préciser le mois et l’année (le mois et l'année de la date du jour sont proposés par défaut) +3. L’utilisateur peut choisir d’annuler ou valider son action + +Une note de dépense (Expense) est rattachée à une feuille de note de dépense (ExpenseSheet) qui est rattachée à un compte utilisateur (User) et une enseigne (Company) +Il faut donc créer une note de dépense dans une feuille de note de dépense qui doit être créée si elle n'existe pas encore +Une fois la note créée, elle est automatiquement enregistrée en tant que Brouillon + + +[ ] ==**AJOUTER UNE DÉPENSE DE FRAIS (fonctionnement de l'enseigne)**== + +Scénario: +1. Un utilisateur actif veut ajouter une dépense de frais : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite ajouter une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton d’ajout +2. L’utilisateur peut remplir un formulaire de frais généraux avec les informations nécessaires +3. L’utilisateur peut remplir un formulaire de frais téléphoniques avec les informations nécessaires +4. L’utilisateur peut choisir d’enregistrer ou d’annuler les dépenses ajoutées + +- les informations pour le formulaire de frais généraux sont : la date*, la catégorie, le type de frais*, la description, le montant HT* et le montant TVA* +- Les informations pour le formulaire de frais téléphoniques sont : la date*, le type de frais*, le montant HT* et le montant TVA* + +(* = Les informations obligatoires pour la validation des formulaires) + +Si plusieurs taux de TVA doivent être renseignés alors le montant total doit être précisé +Si la TVA n’est pas déductible : la valeur TTC doit être renseignée dans le montant HT et mettre 0 dans le montant TVA +Ces dépenses peut être ajoutées seulement si la note est enregistrée en Brouillon + + +[ ] ==**MODIFIER UNE DÉPENSE DE FRAIS (fonctionnement de l'enseigne)**== + +Scénario: +1. Un utilisateur actif veut modifier une dépense de frais : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite modifier une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de modification +2. L’utilisateur peut remplir un formulaire de frais généraux (prérempli des informations courantes) avec les informations nécessaires +3. L’utilisateur peut remplir un formulaire de frais téléphoniques (prérempli des informations courantes) avec les informations nécessaires +4. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense modifiée + +- les informations pour le formulaire de frais généraux sont : la date*, la catégorie, le type de frais*, la description, le montant HT* et le montant TVA* +- Les informations pour le formulaire de frais téléphoniques sont : la date*, le type de frais*, le montant HT* et le montant TVA* + +(* = Les informations obligatoires pour la validation des formulaires) + +Si plusieurs taux de TVA doivent être renseignés alors le montant total doit être précisé +Si la TVA n’est pas déductible : la valeur TTC doit être renseignée dans le montant HT et mettre 0 dans le montant TVA +Ces dépenses peuvent être modifiées seulement si la note est enregistrée en Brouillon + + +[ ] ==**AJOUTER UNE DÉPENSE KILOMÉTRIQUE (fonctionnement de l'enseigne)**== + +Scénario: +1. Un utilisateur actif veut ajouter une dépense kilométrique : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite ajouter une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton d'ajout +2. L’utilisateur rempli un formulaire de dépense kilométrique avec les informations nécessaires +3. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense + +- les informations pour le formulaire sont : la date*, la catégorie, le type de frais*, le point de départ*, le point d’arrivée*, la prestation, le nombre de kilomètres* + +(* = Les informations obligatoires pour la validation du formulaire) + +Cette dépense peut être ajoutée seulement si la note est enregistrée en Brouillon + + +[ ] ==**MODIFIER UNE DÉPENSE KILOMÉTRIQUE (fonctionnement de l'enseigne)**== + +Scénario: +1. Un utilisateur actif veut modifier une dépense kilométrique : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite modifier la dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de modification +2. L’utilisateur peut remplir un formulaire de dépense kilométrique (prérempli des informations courantes) avec les informations nécessaires +3. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense modifiée. + +- les informations pour le formulaire sont : la date*, la catégorie, le type de frais*, le point de départ*, le point d’arrivée*, la prestation, le nombre de kilomètres* + +(* = Les informations obligatoires pour la validation du formulaire) + +Cette dépense peut être modifiée seulement si la note est enregistrée en Brouillon + + +[ ] ==**SUPPRIMER UNE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut supprimer une dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite supprimer une dépense -> il est redirigé sur l’IHM de la note spécifique et clique sur le bouton de suppression +2. Le système ouvre une pop-up pour s’assurer que l’utilisateur souhaite supprimer la dépense +3. L’utilisateur peut choisir de valider ou d’annuler la suppression + +Une dépense peut être supprimée seulement si la note de dépenses est enregistrée en Brouillon + + +[ ] ==**ENREGISTRER UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif souhaite enregistrer une note de dépenses : il se rend sur l’IHM de l'Accueil, sélectionne la note sur laquelle il souhaite faire l’enregistrement -> il est redirigé sur l’IHM de la note spécifique et clique sur le bouton d'enregistrement +2. L’utilisateur remplis un formulaire avec les informations nécessaires (les commentaires ne sont pas obligatoires) +3. L’utilisateur peut choisir de valider ou d’annuler son action + +Seules les note de dépense à l'état Brouillon peuvent être enregistrées +Les commentaires seront accessibles via l'IHM de l'Accueil une fois enregistrés + + +[ ] ==**SUPPRIMER UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut supprimer une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note qu'il souhaite supprimer -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de suppression +2. Le système ouvre une pop-up pour s’assurer que l’utilisateur souhaite bien supprimer la note +3. L’utilisateur peut choisir de valider ou annuler la suppression + +Seules les note de dépenses à l'état Brouillon peuvent être supprimées +Si la note est en demande de validation, l’utilisateur peut la réenregistrer en tant que Brouillon +Cette action annulera automatiquement la demande de validation et passera la note à l’état de Brouillon + + +[ ] ==**DEMANDER LA VALIDATION D’UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut demander la validation d’une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite demander la validation -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de demande +2. L’utilisateur rempli un formulaire de demande de validation (les commentaires ne sont pas obligatoires) +3. L’utilisateur peut choisir de valider ou d’annuler sa demande + +L’utilisateur ne peut pas valider ou invalider sa demande : seul l’administrateur applique ces actions +Les notes de dépenses possèdent d’autres états mais ils ne sont pas gérés dans l’application + +---------- + +## ETAPE 2 +[ ] ==**JOINDRE UN JUSTIFICATIF A UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut ajouter un justificatif à une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite ajouter un justificatif -> il est redirigé sur l’IHM de la note spécifique, va dans la zone des justificatifs puis clique sur le bouton d’ajout +2. L’utilisateur rempli un formulaire avec les informations nécessaires +3. L’utilisateur peut choisir de valider ou annuler son action + +- les informations nécessaires pour le formulaire de justificatif sont : le type du document*, le choix du fichier (en local)* et sa description* + +(* = Les informations obligatoires pour la validation du formulaire) + +La description par défaut est le nom du fichier +Un justificatif peut être joint peu importe l’état de la note de dépense + + +[ ] ==**SUPPRIMER UN JUSTIFICATIF D’UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut supprimer un justificatif d’une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite supprimer un justificatif -> il est redirigé sur l’IHM de la note spécifique, va dans la zone des justificatifs, sélectionne le fichier et clique sur le bouton de suppression +2. Le système affiche une fenêtre avec les informations du fichier (sa description, son nom, sa taille, la date de son dépôt et la date de sa dernière modification) pour s’assurer que l’utilisateur souhaite bien supprimer le justificatif +3. L’utilisateur peut choisir de valider ou d’annuler la suppression + +Un justificatif peut être supprimé peu importe l’état de la note de dépense + + +[ ] ==**MODIFIER UN JUSTIFICATIF D’UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut modifier un justificatif d’une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite modifier un justificatif -> il est redirigé sur l’IHM de la note spécifique, va dans la zone des justificatifs, sélectionne le fichier et clique sur le bouton de modification +2. Le système affiche une fenêtre avec les informations du fichier (sa description, son nom, sa taille, la date de son dépôt et la date de sa dernière modification) +3. L’utilisateur rempli un formulaire (prérempli des informations courantes, dont le fichier) avec les informations nécessaires +4. L’utilisateur peut choisir de valider ou non sa modification + +- les informations nécessaires pour le formulaire de justificatif sont : le type du document*, le choix du fichier (en local)* et sa description* + +(* = Les informations obligatoires pour la validation du formulaire) + +La description par défaut est le nom du fichier +Un justificatif peut être modifié peu importe l’état de la note de dépense + + +[ ] ==**GÉNÉRER UNE DÉPENSE GRÂCE A L'OCR**== + +Scénario: +1. Un utilisateur actif veut générer une dépense grâce à l'OCR : il se rend sur l’IHM de l'Accueil et selectionne la note dans laquelle il souhaite générer une dépense -> il est redirigé sur l’IHM de la note spécifique et clique sur le bouton de génération +2. L’utilisateur peut choisir de générer une dépense à partir d’une photo existante ou de prendre une photo directement +3. Le système OCR analyse les données à partir de la photo et calcule automatiquement les taux +4. Le système ouvre un formulaire prérempli des informations courantes +5. L’utilisateur peut choisir de modifier le formulaire, valider ou annuler + + +[ ] ==**AJOUTER UNE DÉPENSE D’ACHATS CONCERNANT L’ACTIVITÉ AUPRÈS DES CLIENTS**== + +Scénario: +1. Un utilisateur actif veut ajouter une dépense liées au client : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite ajouter une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton d’ajout +2. L’utilisateur peut remplir un formulaire de frais généraux avec les informations nécessaires +3. L’utilisateur peut remplir un formulaire de frais téléphoniques avec les informations nécessaires +4. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense + +- les informations pour le formulaire de frais généraux sont : la date*, la catégorie, le type de frais*, la description, le montant HT* et le montant TVA*, le client concerné +- Les informations pour le formulaire de frais téléphoniques sont : la date*, le type de frais*, le montant HT* et le montant TVA*, le client concerné + +(* = Les informations obligatoires pour la validation des formulaires) + +Si plusieurs taux de TVA doivent être renseignés alors le montant total doit être précisé +Si la TVA n’est pas déductible : la valeur TTC doit être renseignée dans le montant HT et mettre 0 dans le montant TVA +Ces dépense peuvent être ajoutées seulement si la note est enregistrée en Brouillon + + +[ ] ==**MODIFIER UNE DÉPENSE D’ACHATS CONCERNANT L’ACTIVITÉ AUPRÈS DES CLIENTS**== + +Scénario: +1. Un utilisateur actif veut modifier une dépense liées au client : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite ajouter une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de modification +2. L’utilisateur peut remplir un formulaire de frais généraux (prérempli des informations courantes) avec les informations nécessaires +3. L’utilisateur peut remplir un formulaire de frais téléphoniques (prérempli des informations courantes) avec les informations nécessaires +4. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense modifiée + +- les informations pour le formulaire de frais généraux sont : la date*, la catégorie, le type de frais*, la description, le montant HT* et le montant TVA*, le client concerné +- Les informations pour le formulaire de frais téléphoniques sont : la date*, le type de frais*, le montant HT* et le montant TVA*, le client concerné + +(* = Les informations obligatoires pour la validation des formulaires) + +Si plusieurs taux de TVA doivent être renseignés alors le montant total doit être précisé +Si la TVA n’est pas déductible : la valeur TTC doit être renseignée dans le montant HT et mettre 0 dans le montant TVA +Ces dépenses peuvent être modifiées seulement si la note est enregistrée en Brouillon + + +[ ] ==**AJOUTER UNE DÉPENSE KILOMÉTRIQUE CONCERNANT L’ACTIVITÉ AUPRÈS DES CLIENTS**== + +Scénario: +1. Un utilisateur actif veutajouter une dépense kilométrique : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite modifier une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton d'ajout +2. L’utilisateur rempli un formulaire de dépense kilométrique avec les informations nécessaires +3. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense + +- les informations pour le formulaire sont : la date*, la catégorie, le type de frais*, le point de départ*, le point d’arrivée*, la prestation, le nombre de kilomètres*, le client concernée + +(* = Les informations obligatoires pour la validation du formulaire) + +Cette dépense peut être ajoutée seulement si la note est enregistrée en Brouillon + + +[ ] ==**MODIFIER UNE DÉPENSE KILOMÉTRIQUE CONCERNANT L’ACTIVITÉ AUPRÈS DES CLIENTS**== + +Scénario: +1. Un utilisateur actif veut modifier une dépense kilométrique liée au client : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite modifier une dépense -> il est redirigé sur l’IHM de la note spécifique puis clique sur le bouton de modification +2. L’utilisateur peut remplir un formulaire de dépense kilométrique (prérempli des informations courantes) avec les informations nécessaires +3. L’utilisateur peut choisir d’enregistrer ou d’annuler la dépense modifiée. + +- les informations pour le formulaire sont : la date*, la catégorie, le type de frais*, le point de départ*, le point d’arrivée*, la prestation, le nombre de kilomètres*, le client concernée + +(* = Les informations obligatoires pour la validation du formulaire) + +Cette dépense peut être modifiée seulement si la note est enregistrée en Brouillon + + +[ ] ==**DUPLIQUER UNE DÉPENSE**== + +Scénario: +1. Un utilisateur actif veut dupliquer une dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note dans laquelle il souhaite dupliquer une dépense -> il est redirigé sur l’IHM de la note spécifique et clique sur le bouton pour dupliquer +2. L’utilisateur précise dans un formulaire dans quelle note de dépenses la dépense doit être dupliquée : seules les notes de dépenses enregistrées en Brouillon peuvent être sélectionnées (la note courante est sélectionnée par défaut) +3. L’utilisateur peut choisir de valider ou d’annuler la duplication + +Lorsque l’utilisateur précise dans quelle note de dépenses la dépense doit être dupliquée, les montants HT et TVA de la dépense sont renseignés +Une dépense peut être dupliquée seulement si la note de dépense est enregistrée en Brouillon + + +[ ] ==**DUPLIQUER UNE NOTE DE DÉPENSE**== + +Scénario: +1. Un utilisateur actif souhaite dupliquer une note de dépense : il se rend sur l’IHM de l'Accueil, sélectionne la note qu'il souhaite dupliquer puis clique sur le bouton de duplication +2. L’utilisateur précise le mois et l’année +3. L’utilisateur peut choisir de valider ou d’annuler la duplication + +Une note de dépense peut être dupliquée peu importe son état et la copie est automatiquement enregistrée en Brouillon From 5f12fe2112d8dceeec125f564d707c8872fab15a Mon Sep 17 00:00:00 2001 From: Emeline Date: Tue, 14 Jul 2020 01:14:59 +0200 Subject: [PATCH 2/3] Update AstronoteCahierDesCharges.md --- AstronoteCahierDesCharges.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/AstronoteCahierDesCharges.md b/AstronoteCahierDesCharges.md index 2ad3b80..0a21196 100644 --- a/AstronoteCahierDesCharges.md +++ b/AstronoteCahierDesCharges.md @@ -1,8 +1,8 @@ # Astronote Cahier des charges --- ### SUJET -- **But**: Développer une application mobile crossplatform pour la gestion des notes de frais d'interface à [**enDI**](https://framagit.org/endi/endi) ("**en**treprendre **DI**fféremment") -- **Note**: Publié sous license libre ([GPLv3 License](https://framagit.org/membres-astrolabe/astronote/-/blob/master/LICENSE.txt)) dans un magasin d'application libre +- **But**: Développer une application mobile crossplatform de gestion des notes de frais d'interface à [**enDI**](https://framagit.org/endi/endi) ("**en**treprendre **DI**fféremment") +- **N.B.**: Publiée sous license libre ([GPLv3 License](https://framagit.org/membres-astrolabe/astronote/-/blob/master/LICENSE.txt)) dans un magasin d'application libre. Développée avec Flutter. ##### Etapes de travail: - **Etape 1**: @@ -13,8 +13,8 @@ Envoie sécurisé des informations collectées vers enDI (des contributions à e - **Etape 2**: Système de pièces jointes de justificatifs et amélioration du design graphique -Inclure la prise de photo de la preuve de dépense et l'attacher en tant que pièce justificative -Reconnaissance de caractères optique (OCR) avec remplissage automatique lors de la prise de photo de la pièce justificative +Inclure la prise de photo de la preuve de dépense et l'attacher en tant que pièce justificative +Reconnaissance de caractères optique (OCR) avec remplissage automatique lors de la prise de photo de la pièce justificative Utilisation de briques logicielles disponibles en libre ou API standard Android permettant l'OCR - **Environment**: Android / Lineage OS, F-Droid / Play Store, logiciel libre, progiciel métier --- From 98c0d7d12bd0c1b8cfb8b60ccafabf4a51722de4 Mon Sep 17 00:00:00 2001 From: Emeline Date: Tue, 14 Jul 2020 01:25:57 +0200 Subject: [PATCH 3/3] Update AstronoteSpecification.md --- AstronoteSpecification.md | 52 ++++++++++++++++++++------------------- 1 file changed, 27 insertions(+), 25 deletions(-) diff --git a/AstronoteSpecification.md b/AstronoteSpecification.md index a9db7af..d58ab40 100644 --- a/AstronoteSpecification.md +++ b/AstronoteSpecification.md @@ -39,8 +39,7 @@ Sessions are cookie-based [ ] ==**DASHBOARD**== -Dashboard ensures draft and unvalidated expense reports management, sorted by year and company -Within each year sorted in decending order, expense reports are sorted by month in ascending order +Dashboard ensures draft and unvalidated expense reports management Every expense report in the dashboard features the following parameters: - Expense status (validated, unvalidated or draft) - Expense data (date, charge incl. and excl. taxes, VAT, distance) @@ -57,17 +56,20 @@ Baseline scenario: [ ] ==**MANAGE EXPENSE REPORT**== +Expenses are divided into two sections : costs related to a company (Costs) and the costs related to a customer (Purchases) +Expenses include : +- date, type, description, charge incl. and excl. taxes, VAT +- for mileage expense : date, type, provision, origin, destination, distance + +Only expenses report related to a company will be developed in this step + Expense report dashboard allows user to keep track of: - Expense report status - Supporting document (or lack thereof) - Saved comments (including writer name, writing date and comment content) - Business expenses -Expenses are divided into two sections : costs related to a company (Costs) and the costs related to a customer (Purchases) -Expenses include : -- date, type, description, charge incl. and excl. taxes, VAT -- for mileage expense : date, type, provision, origin, destination, distance - + Baseline scenario: 1. Active user goes to HCI and picks specific expence report 2. All expense report details are displayed @@ -88,7 +90,7 @@ Newly created expense reports are automatically saved as drafts [ ] ==**ADD BUSINESS-RELATED EXPENSE (company)**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to add to. User is redirected to specific expense report HCI, selects "Costs" category and clicks add button +1. Active user goes to HCI and selects expense report to add to. User is redirected to specific expense report HCI and clicks add button 2. User can complete overhead form with appropriate data 3. User can complete line charge form with appropriate data 4. User confirms or cancels expense addition @@ -106,7 +108,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**EDIT BUSINESS-RELATED EXPENSE (company)**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to edit from. User is redirected to specific expense report HCI, selects "Costs" category and clicks specific edit button +1. Active user goes to HCI and selects expense report to edit from. User is redirected to specific expense report HCI and clicks specific edit button 2. User can complete overhead form with appropriate data (fields have current values as default values) 3. User can complete line charge form with appropriate data (fields have current values as default values) 4. User confirms or cancels expense edition @@ -124,7 +126,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**ADD BUSINESS-RELATED TRAVEL EXPENSE (company)**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to add to. User is redirected to specific expense report HCI, selects "Costs" category and clicks add button +1. Active user goes to HCI and selects expense report to add to. User is redirected to specific expense report HCI and clicks add button 2. User completes form with appropriate data 3. User confirms or cancels expense addition @@ -138,7 +140,7 @@ Expense can only be added if expense report is already saved as draft. [ ] ==**EDIT BUSINESS-RELATED TRAVEL EXPENSE (company)**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to edit from. User is redirected to specific expense report HCI, selects "Costs" category and clicks specific edit button +1. Active user goes to HCI and selects expense report to edit from. User is redirected to specific expense report HCI and clicks specific edit button 2. User completes form with appropriate data (fields have current values as default values) 3. User confirms or cancels expense addition @@ -152,7 +154,7 @@ Expense can only be added if expense report is already saved as draft. [ ] ==**DELETE EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to delete expense from. User is redirected to specific expense report HCI, selects "Costs" or "Purchases" category and clicks specific delete button +1. Active user goes to HCI and selects expense report to delete expense from. User is redirected to specific expense report HCI and clicks specific delete button 2. User is prompted for deletion confirmation as safety measure 3. User confirms or cancels deletion @@ -162,7 +164,7 @@ An expense can only be delete if expense report is already saved as draft. [ ] ==**SAVE EXPENSE REPORT**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to save. User is redirected to specific expense and clicks save button +1. Active user goes to HCI and selects expense report to save. User is redirected to specific expense and clicks save button 2. User completes form with appropriate data (comments that are optional) 3. User confirms or cancels @@ -173,7 +175,7 @@ Comments will be displayed in dashboard HCI from then on [ ] ==**DELETE EXPENSE REPORT**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to delete. User is redirected to specific expense report HCI and clicks delete button +1. Active user goes to HCI and selects expense report to delete. User is redirected to specific expense report HCI and clicks delete button 2. User is prompted for deletion confirmation as safety measure 3. User confirms or cancels @@ -184,7 +186,7 @@ If deleted expense report was awaiting validation, it is returned to draft statu [ ] ==**SUBMIT EXPENSE REPORT FOR VALIDATION**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to submit for validation. User is redirected to specific expense report HCI and clicks validate button +1. Active user goes to HCI and selects expense report to submit for validation. User is redirected to specific expense report HCI and clicks validate button 2. User completes form with appropriate data (comment that is optional) 3. User confirms or cancels @@ -197,7 +199,7 @@ Expense reports might have another status but those are not accessible on the us [ ] ==**ATTACH SUPPORTING DOCUMENT TO EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to attach a document in. User is redirected to specific expense report HCI and clicks attach button +1. Active user goes to HCI and selects expense report to attach a document in. User is redirected to specific expense report HCI, browses supporting document files and clicks attach button 2. User completes form with appropriate data 3. User confirms or cancels attachment @@ -212,7 +214,7 @@ Supporting documents can be joined regardless of expense report status [ ] ==**DELETE SUPPORTING DOCUMENT FROM EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to delete a document in. User is redirected to specific expense report HCI, browses supporting document files and clicks file link +1. Active user goes to HCI and selects expense report to delete a document in. User is redirected to specific expense report HCI, browses supporting document files and clicks file link 2. File information is displayed on click (description, file name, file size, upload date, last edit date) 3. User clicks delete button 4. User is prompted for deletion confirmation as safety measure @@ -224,7 +226,7 @@ Supporting documents can be deleted regardless of expense report status [ ] ==**EDIT SUPPORTING DOCUMENT FROM EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to edit a document in. User is redirected to specific expense report HCI, browses supporting document files and clicks file link +1. Active user goes to HCI and selects expense report to edit a document in. User is redirected to specific expense report HCI, browses supporting document files and clicks file link 2. File information is displayed 3. User clicks edit button 4. User completes form with appropriate data (fields have current values as default values, including file) @@ -241,7 +243,7 @@ Supporting documents can be edited regardless of expense report status [ ] ==**GENERATE EXPENSE WITH OCR**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to generate expense in. User is redirected to specific expense report HCI, selects "Costs" or "Purchases" category and clicks generate button +1. Active user goes to HCI and selects expense report to generate expense in. User is redirected to specific expense report HCI and clicks generate button 2. User selects snapshot from gallery or takes snapshot on the spot 3. OCR system parses data from snapshot and automatically compute rates 4. Form loads with parsed data as default value in appropriate fields @@ -251,7 +253,7 @@ Baseline scenario: [ ] ==**ADD CUSTOMER INTERACTION-RELATED EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to add to. User is redirected to specific expense report HCI, selects "Purchases" category and clicks add button +1. Active user goes to HCI and selects and expense report to add to. User is redirected to specific expense report HCI and clicks add button 2. User can complete overhead form with appropriate data 3. User can complete line charge form with appropriate data 4. User confirms or cancels expense addition @@ -269,7 +271,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**EDIT CUSTOMER INTERACTION-RELATED EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to edit from. User is redirected to specific expense report HCI, selects "Purchases" category and clicks specific edit button +1. Active user goes to HCI and selects expense report to edit from. User is redirected to specific expense report HCI and clicks specific edit button 2. User can complete overhead form with appropriate data (fields have current values as default values) 3. User can complete line charge form with appropriate data (fields have current values as default values) 4. User confirms or cancels expense edition @@ -287,7 +289,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**ADD CUSTOMER INTERACTION-RELATED TRAVEL EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to add to. User is redirected to specific expense report HCI, selects "Purchases" category and clicks add button +1. Active user goes to HCI and selects expense report to add to. User is redirected to specific expense report HCI and clicks add button 2. User completes form with appropriate data 3. User confirms or cancels expense addition @@ -301,7 +303,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**EDIT CUSTOMER INTERACTION-RELATED TRAVEL EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to edit from. User is redirected to specific expense report HCI, selects "Purchases" category and clicks specific edit button +1. Active user goes to HCI and selects expense report to edit from. User is redirected to specific expense report HCI and clicks specific edit button 2. User completes form with appropriate data (fields have current values as default values) 3. User confirms or cancels expense edition @@ -315,7 +317,7 @@ Expense can only be added if expense report is already saved as draft [ ] ==**COPY EXPENSE**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to copy expense from. User is redirected to specific expense report HCI, selects "Costs" or "Purchases" category and clicks specific copy button +1. Active user goes to HCI and selects expense report to copy expense from. User is redirected to specific expense report HCI and clicks specific copy button 2. User specifies to which expense report the expense needs to be copied. Only expense reports already saved as drafts can be selected. Default value is current expense report 3. User confirms or cancels copy @@ -326,7 +328,7 @@ An expense can only be copied if expense report is already saved as draft [ ] ==**COPY EXPENSE REPORT**== Baseline scenario: -1. Active user goes to HCI and selects year and expense report to copy. User is redirected to specific expense report HCI and clicks copy button +1. Active user goes to HCI and selects expense report to copy. User is redirected to specific expense report HCI and clicks copy button 2. User specifies month and year 3. User confirms or cancels