wikiDevOrga
ORGANISATION GENERALE DU LOGICIEL
Organisation des fichiers
généralités
Paroiciel v11 est développé en php5, html5, css3 et utilise la base de données mysql v5.
Pour bien comprendre l'organisation du logiciel, il suffit de regarder l'organisation du répertoire qui contient le logiciel. Celui-ci contient les sous répertoires suivants :
organisation des répertoires du logiciel
| Répertoire | Explications | |
| html | Ce répertoire contient l'ensemble des fichiers php qui permettent l'affichage et le traitement des informations (saisies et impressions). En règle générale, ces fichiers produisent des fichiers html. Il contient aussi plusieurs sous répertoires : | |
| ajax | contient des fichiers php qui réalisent les traitements côté serveur destinées à rafraichir les pages côté client. | |
| css | contient les fichiers de formatage des données (seuls paroiciel.css et paroiciel_print.css sont utilisés). | |
| images | contient les images nécessaires au bon fonctionnement du site. | |
| js | contient les fichiers javascript utilisés par les fichiers html (voir ci-dessous pour une explication plus complète) | |
| template | contient les modèles (templates) html qui sont utilisés par les fichiers php pour construire les pages html finales. | |
| php | contient les classes et les bibliothèques utilisées par les fichiers php. Il est divisé en deux sous répertoires : | |
| locale | qui permettra, à terme, la traduction de Paroiciel en plusieurs langues. | |
| shared | qui contient les classes d'abstraction des données (classes) et les classes générales (services). | |
| Ce sous répertoire contient le modèle des fichiers qui permettront l'impression des états | ||
| sql | contient les scripts de création de la structure de la base de données | |
codification des noms de fichiers
L'ensemble de ces fichiers obéit à une certaine codification en ce qui concerne leur nom.
Ils commencent par une lettre qui identifie la grande famille de fonctions à laquelle ils appartiennent :
| Lettre | Explication |
|---|---|
| P | gestion des foyers et des personnes |
| A | gestion de l'agenda |
| E | gestion des équipes |
| T | gestion des listes paramétrables |
| Z | gestion des données générales |
Fonctionnement général
Le logiciel fonctionne, en règle générale de la manière suivante :
- Le fichier .php situé dans le dossier html construit une page html (souvent un formulaire) à partir du template correspondant (fichier .tpl situé dans le répertoire html/template). Ceci permet que la présentation et le traitement des données soient bien séparées.
- La page html utilise les feuilles de style situées dans le fichier paroiciel.css
- La page html utilise les scripts situés dans html/js (paroiciel.js et fichier .js spécifique à la page)
- lors de sa validation, le formulaire envoie les données au même fichier .php que celui qui l'a constitué. Le fichier .php dépouille les dpnnées qu'il a reçues et opère les traitements nécessaire. Il constitue une nouvelle page html ou opère une redirection vers un autre fichier .php.
Related
