**Ceci est une ancienne révision du document !**
Inscription dans le SI de FDN
- Pour l'instant, il faut remplir le formulaire d'adhésion à FDN, comme si on adhérait, sauf qu'en fait non, c'est juste pour rentrer dans le SI sans se faire suer à changer le code pour l'instant :) Pensez bien à renseigner la partie prélèvement, il y en aura besoin pour prélever le coût des lignes
- Il faut alors envoyer en même temps à Benjamin-, domi, lulu, ou spyou:
- le login adhacc-XXX obtenu
- Un trigramme (i.e. 3 lettres) que FDN utilisera partout dans son SI, le FAI local peut choisir ce qu'il préfère tant que c'est pas déjà pris :)
- une paire login / password pour chacun des membres du FAI local qui sera responsable de saisir des commandes de lignes pour leurs adhérent: à donner au format htpasswd
- le choix entre tarification “marque blanche” ou “collecte groupée”
- qui va alors mettre à jour
- le cgi
- l'authen (passwd, group)
- le subs.cfg
- le subs/subs.cfg (oui, c'est pervers, il y a un deuxième fichier)
- la config apache (mapper le groupe sur le cgi)
- vérifier la grille tarifaire associée au compte
Authentification des lignes ADSL
Les logins seront de la forme bob.sinclair/monsuperfai@fdn.nerim
- Soit le FAI a son propre serveur radius, et FDN délègue les authentifications (il faut que le serveur ait une bonne disponibilité, sinon les adhérents ne peuvent plus se connecter !)
- Soit le FAI préfère que FDN héberge l'authentification
Éligibilité des lignes
Une interface en JSON a été développée: on lui envoie un numéro de téléphone + code postal, et il renvoie la liste des options possibles et autres infos : https://vador.fdn.fr/souscription/eligibilite.cgi avec en paramètre
- ?etape=eligibilite&tel=0123456789&cp=12345&tarif=blanche pour le tarif “marque blanche”;
- ou ?etape=eligibilite&tel=0123456789&cp=12345&tarif=collecte pour le tarif “collecte seule”.
(Note: ne rassemblez pas l'URL, pour éviter que les moteurs de recherche du monde entier commencent à tous tester en permanence l'éligibilité de la ligne 0123456789…)
Commande de ligne
Un formulaire dédié pour chaque asso permet de commander une ligne en un coup: https://vador.fdn.fr/souscription/subs-XXX.cgi où XXX est le trigramme choisi . Le principe, c'est
- Le FAI local doit vérifier l'éligibilité de la ligne à l'aide du JSON ou autre.
- Le FAI local reçoit et traite les papiers de l'adhérent comme il entend (automatisé ou non).
- Un des membres du bureau du FAI saisit les informations sur un formulaire, c'est là que les paires login/mdp htpasswd vont servir. C'est un CGI tout bête qui fonctionne en GET ou en POST, comme on préfère, cf le formulaire html. Attention, à l'adresse mail seront envoyés les mails standard de FDN, et notamment l'identifiant de commande qui permet d'accéder à toutes les infos de toutes les lignes du FAI local, donc il ne faut pas mettre l'adresse email de l'adhérent.
- La commande atterrit chez FDN pour validation.
Suivi de ligne
Pour l'instant, l'interface /adherents habituelle. Plus tard peut-être des interfaces sans mise en page pour parser facilement.
Facturation lignes ADSL
Du point de vue de FDN, un FAI est une ligne dans le SI FDN, qui a pleinggg de lignes ADSL, et est donc facturé pour elles (et devra les facturer à ses adhérents s'il veut pas couler). La facturation peut se faire par prélèvement, donc même si le FAI n'adhère pas à FDN, il doit alors envoyer l'autorisation de prélèvement générée lors de l'inscription. La facturation peut aussi se faire par factures, c'est juste plus pénible pour un peu tout le monde.
- Pour les tarifs voire la page Tarification
Outils
Début de commencement de Spécifications SI
Aquilenet fournit quelques outils et formulaires sur
git clone http://git.aquilenet.fr/tools.git
pour la partie web,
git clone http://git.aquilenet.fr/tools-dolibarr.git
pour la partie dolibarr,
http://tools.aquilenet.fr/formulaires/
pour les formulaires,
git clone http://git.aquilenet.fr/adherents.git
pour l'intranet réservé aux adhérents.
projet “out of the box”
git clone https://git.gitorious.org/si-fai/si-fai.git
Patches welcome!