wiki:Documentation
Last modified 7 months ago

  1. Documentation technique
    1. Infrastructure logicielle d'AlternC
      1. - Les logicels utilisés par Alternc
      2. - Module
      3. - Plugins
    2. Documentation Technique
    3. Gestion du développement
      1. - Principes de développement
      2. - Les outils
      3. - Le code

Documentation technique

Infrastructure logicielle d'AlternC

AlternC est essentiellement developpe en PHP4 (70%), Shell-script (5%), Perl (5%) et il y a aussi beaucoup de travail de Configuration et Administration d'effectue (20%), cette derniere partie consiste notemment a la creation des paquets debian d'AlternC, partie importante de part le choix de rendre AlternC facilement installable...

AlternC utilise une suite logicielle libre pour les services web utilises (mail,web,ml...). Ces logiciels sont pilotes par un bureau virtuel, qui se doit d'etre facilement adaptable aux besoins, securise, et fiable. Pour cela, on utilise un developpement en 4 couches :

  1. Couche Systeme d'exploitation (contient les fichiers de configuration, les paquets Debian des serveurs mysql, ldap, apache etc.). Par definition, on ne developpera presque rien de cette couche, car elle repose essentiellement sur des paquets Debian standard, qui pourront donc profiter des mises-a-jour Debian de securite entre autres. Les seuls developpements effectues sur cette couche concernent les fichiers de configuration de ces logiciels
  2. Couche Pilotage de l'OS. Cette couche consiste en un certain nombre de programmes ecrits en C ou en shell-script situes dans /usr/lib/alternc, pour lesquels php ne suffit pas car il ne dispose pas de droits suffisants. Il s'agit par exemple du pilotage des listes de diffusion, de la creation de dossiers ayant des droits particuliers (mail, web etc.) de la gestion des quotas systeme etc. Ces programmes en C sont eventuellement suid root. les parametres de php interdisent aux utilisateurs le lancement de ces programmes, seul le bureau virtuel le peut.
  3. Couche Classes PHP. Cette couche regroupe les modules de pilotage des services fournis, sous forme de classes php. Les fichiers, situes dans /var/alternc/bureau/class sont nommes m_"nom de la classe".php et sont inclus par le fichier config.php. Chaque classe s'occupe d'un service particulier en entier, et fait appel, si besoin, aux programmes en C de pilotage de l'OS et a d'autres classes. Voir la documentation sur les modules et [Classes PHP] de la documentation.
  4. Couche presentation en HTML/PHP. Cette couche contient plein de fichiers en HTML avec le minimum possible de php. elle doit pouvoir etre modifiee facilement pour coller au fonctionnement de chaque hebergeur, ainsi qu'a la charte graphique de celui-ci.

- Les logicels utilisés par Alternc

- Module

- Plugins

Documentation Technique

Gestion du développement

- Principes de développement

- Les outils

- Le code

Voir aussi  La documentation docbook Pour ceux qui maîtrisent DocBook? et SVN, nous proposons aussi une documentation au format DocBook? accessible sur le serveur source:alternc-doc/trunk.