Merge pull request 'corrections et questions' (#1) from viennet/DocScoDoc:entreprises into master

Reviewed-on: https://scodoc.org/git/arthur.zhu/DocScoDoc/pulls/1

docs/RelationsEntreprises.md

@@ -9,9 +9,9 @@ Les utilisateurs interrogés insistent sur leur souhait d'avoir une interface si
 
 L'application, intégrée à ScoDoc, fournira:
 - Saisie et gestion des entreprises
-- Saisie et gestion des offres de stage ou/et apprentissage
+- Saisie et gestion des offres de stage et d'apprentissage
 - Envoi des offres aux responsables de formations
-- Historique a propos des entreprises
+- Historique à propos des entreprises
 - Historique des modifications des fiches entreprises
 - Journal de bord des étudiants pour suivre les candidatures
 
@@ -19,7 +19,7 @@ L'application, intégrée à ScoDoc, fournira:
 ## Les utilisateurs
 
 - le pôle des relations extérieures (le responsable, l'assistant, les chargés de relations entreprises)
-- les secrétariat pédagogiques
+- les secrétariats pédagogiques
 - les responsables de stage
 - les responsables de formations
 
@@ -28,18 +28,26 @@ Des actions et visibilités différentes selon le rôle de l'utilisateur (voir s
 
 ## Les entreprises
 
-Les entreprises possèderont chacune une fiche entreprise avec toutes leurs informations.
+Les entreprises possèderont chacune une fiche avec toutes leurs informations.
+
+Lorsqu'un utilisateur souhaite indiquer une relation avec une entreprise ou 
+a été contacté par une entreprise, il pourra saisir les informations de
+l'entreprise dans la base si elle n'existe pas encore.
+XXX et si l'entreprise existe mais que l'utilisateur veut ajouter ou corriger
+des infos ? Ou ajouter un "correspondant" ?
 
-Un utilisateur possède une relation avec une entreprise ou a été contacté par une entreprise, il pourra saisir les informations de l'entreprise dans la base si elle n'existe pas encore.
 
 ### Données sur l'entreprise:
 
 - SIRET
 - Nom
 - Adresse, Code postal, Ville, Pays
-- Elements de contacts (nom, prenom, numéro de téléphone, email)
+- Élements de contact (nom, prénom, numéro de téléphone, email)
 
-Les entreprises sont identifiés par leur SIRET (unique) pour éviter les duplications et doivent toujours posséder des élements de contact sinon inexploitable par les utilisateurs.
+XXX ces élements de contacts sont associés à une personne ou un service (par exemple
+"ressources humaine") au sein de l'entreprise. Il y en aura donc un nombre variable.
+
+Les entreprises sont identifiés par leur SIRET (unique) pour éviter les duplications et doivent toujours posséder des éléments de contact sinon inexploitable par les utilisateurs.
 
 Les entreprises possède un SIRET pour chaque établissement de l'entreprise ce qui le rend unique, je pense donc que le SIRET est un bon moyen d'identifier une entreprise, peut-être mettre le SIREN aussi?
 
@@ -50,25 +58,25 @@ TODO: distinguer SIRET et SIREN, pour les grandes entreprises multi-sites voir h
 Une entreprise peut avoir plusieurs éléments de contact, il peut s'agir d'une personne physique, du service ressources humaines d'une entreprise ou d'un autre service selon la situation.
 
 Un historique sur l'entreprise pour pouvoir savoir quel étudiant a déjà réalisé un stage ou un contrat d'alternance au sein de l'entreprise avec:
-- identifiant de l'étudiant INE ou ScoDoc id (etudid)
+- identifiant de l'étudiant INE ou ScoDoc id (`etudid`)
 - type de contrat
 - date début et fin
 - formation de l'étudiant (texte)
-- formation de l'étudiant: identifiant ScoDoc (formsemestre_id)
+- formation de l'étudiant: identifiant ScoDoc (`formsemestre_id`)
 
 Un historique sur les modifications faites sur chaque fiche entreprise :
 - modification adresse
 - ajout/modification/suppression contact
 - ajout/modification/suppression offre
 
-L'ajout d'entreprise envoie un mail d'alerte au pole des relations exterieures.
+L'ajout d'entreprise envoie un mail d'alerte au pole des relations extérieures.
 
 
 ## Les offres
 
 Une entreprise peut proposer des offres.
 
-Un utilisateur recoit une offre d'une entreprise, il peut saisir l'offre dans la base qui sera ensuite affiché sur la fiche entreprise de celle ci. L'offre pourra ensuite etre validé ou non par un responsable de formation s'il pense que les missions sont adéquates à la formation.
+Un utilisateur reçoit une offre d'une entreprise, il peut saisir l'offre dans la base qui sera ensuite affiché sur la fiche entreprise de celle ci. L'offre pourra ensuite être validé ou non par un responsable de formation s'il pense que les missions sont adéquates à la formation.
 
 ### Données sur les offres:
 
@@ -78,23 +86,23 @@ Un utilisateur recoit une offre d'une entreprise, il peut saisir l'offre dans la
 - Missions
 - Durée
 
-Chaque offre est reliée a une entreprise.
+Chaque offre est reliée à une entreprise.
 
 Les utilisateurs ont la possibilité d'envoyer les offres aux responsables de formations par la suite les responsables de formations diffusent l'offre au sein de leur formation.
-Les responsables de formations ne sont reliés a aucun objet. Les utilisateurs envoient l'offre aux responsables de formations s'ils pensent que l'offre correspond bien à la formation.
+Les responsables de formations ne sont reliés à aucun objet. Les utilisateurs envoient l'offre aux responsables de formations s'ils pensent que l'offre correspond bien à la formation.
 
-L'ajout d'une offre envoie un mail d'alerte au responsable du pole des relations exterieures.
+L'ajout d'une offre envoie un mail d'alerte au responsable du pole des relations extérieures.
 
 
 ## Journal de bord
 
-Journal de bord pour les étudiants afin de suivre leurs candidatures dans les offres envoyés préalablement par son responsable de formation.
+Journal de bord pour les étudiants afin de suivre leurs candidatures dans les offres envoyées préalablement par son responsable de formation.
 
 Sur le journal de bord apparaîtra les offres que la responsable de formation a reçu et valider puis envoyer à ces étudiants. Les étudiants doit pouvoir saisir un commentaire s'il n'a candidaté a l'offre ou indiquer qu'il a candidater.
 
 Les utilisateurs pourront avoir accès a ces journaux de bord pour constater l'avancée et l'implication des étudiants dans leurs candidatures.
 
-Les étudiants accèdent au journal de bord en se connectant avec leur compte personnel et peuvent commenter chaque offre de stage/alternance en appuyant sur un bouton?
+Les étudiants accèdent au journal de bord en se connectant avec leur compte personnel et peuvent commenter chaque offre de stage/alternance.
 
 Possibilités:
 - Oui, j'ai candidaté (quand)
@@ -102,22 +110,25 @@ Possibilités:
 
 
 Permettre aux entreprises d'avoir accès au bordereau de stage afin qu'il puisse le remplir (s'il compte déjà prendre un stagiaire) ou de proposer une offre de stage.
-
+XXX définir ce qu'est un "bordereau de stage". Sera-t-il généré par
+l'application ?
+XXX accès des entreprises: avec quel compte (identifiant). Quand et par qui ce
+compte est-il créé ?
 
 ## Rôles et actions associées
 
 2 rôles avec des droits différents.
 
 Utilisateur possédant un rôle avec visibilité totale et toutes les actions possibles sur la base:
-- le pôle des relations extérieures avec le responsable, son assistant et les chargés de relations entreprises
-- personnel du CRIT?
+    - le pôle des relations extérieures avec le responsable, son assistant et les chargés de relations entreprises;
+    - administrateur informatique.
 
 Utilisateur possédant un rôle avec seulement une visibilité sur la base selon le département dont il appartient :
-- les reponsables de formations
-- les secrétariat pédagogiques
-- les chefs de département
-- directeur de l'IUT
-- le responsable administratif
+    - les reponsables de formations
+    - les secrétariat pédagogiques
+    - les chefs de département
+    - directeur de l'IUT XXX pas accès complet ??
+    - le responsable administratif
 
 
 ## Processus
@@ -192,7 +203,7 @@ Liste des principaux processus métiers identifiés: à préciser et compléter
 
 ### Envoie d'une offre aux étudiants par le responsable de formation
  - Acteurs: le responsable de formation.
- - Quand: après avoir reçu une offre de la part du pôle des relations extérieurs
+ - Quand: après avoir reçu une offre de la part du pôle des relations extérieures
  - Action: envoie d'une offre aux étudiants d'une formation
  - Déclenche: notification aux étudiants, ajout de l'offre dans le journal de bord des étudiants afin qu'il puisse candidater et commenter leur candidature
  - Remarques: le responsable peut envoyer l'offre à tous ces élèves ou cibler les élèves.
@@ -222,10 +233,17 @@ Réfléchir à l'utilisation (ou non) d'un accès à l'annuaire LDAP de l'établ
 
 ## Idées
 
-Possibilité aux entreprises de saisir leurs offres avec validation par le pôle des relations exterieurs.
+Possibilité aux entreprises de saisir leurs offres avec validation par le pôle des relations extérieures.
 
 Possibilité d'importer des données déjà existantes (Excel).
 
+## Architecture de l'application
+
+ - Module ScoDoc (blueprint) offrant pages pour les personnels et API.
+
+ - Module étudiant: séparé, interfacé via API (à définir plus tard)
+
+ - Module entreprises: séparé, interfacé via API: à définir (plus tard ?)
 
 ## Questions
 
@@ -233,6 +251,10 @@ Comment gérer l’envoi des offres par les responsables de formations aux étud
 
 ???
 
-Quels données sur les offres?
+Quels données sur les offres? XXX entreprise + descriptif (texte ou pdf) + autre
+données à préciser ?? 
+
+Les informations du bordereau de stage doivent être sur la fiche entreprise? XXX
+à mon avis oui, liste des bordereaux accessibles aux personnes autorisées depuis
+la fiche entreprise
 
-Les informations du bordereau de stage doivent être sur la fiche entreprise?