Assistant d'installation de Loxya

Attention
Cette page s'adresse aux administrateurs qui ont accès en ligne de commande au serveur où Loxya est installé. Pour installer Loxya, veuillez d'abord suivre les instructions de la page "installation" de la documentation (étape préalable à ce qui suit).

Une fois que le code source de Loxya est présent sur votre serveur, ouvrez un terminal connecté à ce serveur, placé à la racine du dossier contenant les fichies du logiciel, et lancez la commande suivante :

./bin/console install

Cet assistant est disponible en Français et en Anglais. La langue utilisée par défaut est celle définie par les variables d'environnement LANG ou LC_ALL, mais il sera toujours possible de la changer, si besoin, dès la 3ème question posée par l'assistant (voir ci-dessous).

Important
Veuillez vous assurer que les dossiers /data, /src/var/* et /src/App/Config sont accessibles en écriture par l'utilisateur système du serveur web ET par l'utilisateur qui exécute la commande. Sinon, une erreur se produira.

Bon à savoir
Quand vous effectuez une mise à jour de Loxya, les informations sont pré-remplies avec les valeurs du fichier settings.json existant.

L'assistant d'installation comporte 8 étapes, que voici en détail.

Paramètres de base du logiciel

• URL de l'application
  Il s'agit de l'adresse web racine de votre instance de Loxya.
• Pays d'utilisation principal
  Cela permettra à Loxya de s'adapter à votre pays.
• Langue par défaut
  La langue que Loxya utilisera par défaut, quand l'utilisateur n'a pas encore fait son choix.
  Si vous changez la langue à ce moment-là, l'assistant changera de langue également.
• Mode d'utilisation
  • Location de matériel
    Facturation systématique, tous les événements pourront être facturés.
  • Location + prêt de matériel
    Facturation au cas par cas, le choix pourra être fait pour chaque événement individuellement, grâce à un bouton "facturable" permettant d'activer ou désactiver la facturation.
  • Prêt de matériel
    Pas de facturation du tout ; aucune facture ne pourra être créée, le matériel n'a pas de tarif de location, et les tarifs dégressifs ne sont pas utilisés.
• Devise
  La monnaie à utiliser pour afficher les montants, prix et tarifs dans le logiciel.

Votre organisation

Toutes ces informations sont indispensables pour que Loxya puisse générer des documents (bons de sortie, devis, factures...) au nom de votre entreprise, association ou institution.

Note
Les informations demandées à cette étape peuvent varier en fonction du mode d'utilisation que vous avez choisi à l'étape précédente, et du pays choisi ci-dessous.

• Raison sociale de l'organisation
  Le nom de votre structure (entreprise, association, institution...)
• Pays de l'organisation
  Le pays dans lequel se trouve votre activité principale.
• Numéro de SIRET / d'identification
  Le numéro qui permet d'identifier votre entreprise dans le pays sélectionné ci-dessus.
• Forme juridique
  Le type de votre organisation. Les choix proposés dépendent du pays choisi ci-dessus.
• Capital social
  Si le type de votre structure implique d'avoir un capital social, vous pouvez indiquer son montant ici.
• Ville du registre du commerce de l'organisation
  Pour faire apparaître la ville du R.C.S. qui a enregistré votre structure.
• Code APE
  le code APE (NAF) de votre organisation, si vous souhaitez le faire apparaître dans les documents.
• Êtes-vous assujetti à la TVA ?
  Si oui, le numéro est demandé ci-dessous.
• Numéro de TVA
  Le numéro de T.V.A. intracommunautaire de votre organisation (demandé ou non, selon les choix précédents).
• Option pour le paiement de la TVA d'après les débits ?
  Si vous avez opté pour le paiement de la T.V.A. d'après les débits plutôt qu'à l'encaissement, vous pouvez mettre "oui".
• Numéro et rue
  Adresse de votre structure.
• Complément d'adresse
• Code postal
• Ville
• Numéro de téléphone de l'organisation
• Adresse e-mail de l'organisation

Configuration de la base de données

Ici, il s'agit de renseigner les informations de connexion au serveur MySQL et à la base de données.

• Hôte de la base de données
  Le nom du serveur hôte MySQL. Si vous installez Loxya sur un serveur local, ça sera sûrement "localhost".
• Nom d'utilisateur
  Le nom de l'utilisateur MySQL qui a accès à la base de données. Nous vous déconseillons d'utiliser l'utilisateur "root" pour des raisons de sécurité, sauf sur un serveur local où ça reste acceptable.
• Mot de passe
  Le mot de passe de l'utilisateur MySQL qui a été renseigné ci-dessus.
• Nom de la base de données
  Le nom de la base de données dédiée à Loxya, où seront stockées toutes ses données.
• Préfixe des tables
  Un éventuel préfixe à ajouter aux noms des tables de la BDD (optionnel, à laisser vide en général).
  N'oubliez pas d'ajouter un caractère séparateur (par exemple _ ou -) à la fin du préfixe si vous en utilisez un.

Note
Si vous n'avez pas entré les bonnes informations de connexion (ou que la base de données n'existe pas), un message d'erreur apparaître et vous ne pourrez pas aller plus loin. L'assistant revient alors à la première question de cette étape, et il vous suffit alors de corriger les informations fournies.

Paramètres des devis

• Durée de validité par défaut des devis
  Il s'agit du nombre de jours à utiliser par défaut pour calculer la date d'expiration des devis générés par Loxya. Cette valeur peut bien sûr être modifiée pour chaque devis séparément, au moment de leur création.

Paramètres de facturation

Si la facture est prise en charge par Loxya pour le pays de votre organisation (choisi à l'étape "Votre organisation" ci-dessus), alors vous pouvez renseigner les informations suivantes :

• Adresse électronique d'envoi des e-factures
  Il s'agit de l'adresse de routage de la facturation électronique. Cette information dépend bien sûr du pays de votre organisation, et ne doit être modifiée que si vous savez ce que vous faites. Pour plus d'informations, n'hésitez pas à nous contacter.
• Délai de paiement par défaut
  Le délai en jours à utiliser pour calculer la date d'échéance par défaut des factures (avant qu'une facture soit considérée comme étant "en retard"). Bien sûr, cette valeur peut être choisie au cas par cas, pour chaque facture au moment de sa création.
• Moyens de paiement acceptés
  Choisissez les moyens de paiements que vous acceptez, parmi "Espèces", "Carte bancaire", "Chèque", ou "Virement bancaire". Pour choisir, utilisez la barre d'espace de votre clavier.
• IBAN du compte bancaire
  Renseignez le numéro de compte bancaire à afficher sur les devis et factures pour que vos clients puissent vous payer par virement.
• BIC / SWIFT
  Le numéro BIC ou SWIFT du compte bancaire à afficher sur les documents.
• Nom du titulaire du compte
  Le nom qui apparaît sur le Relevé d'Identité Bancaire (RIB) du compte bancaire de votre organisation.

Paramètres de l'application

Ici, vous paramétrez le comportement général de Loxya. Vous pouvez activer ou désactiver certaines fonctionnalités pour l'adapter précisément à votre utilisation.

• Choix de la politique de retour du matériel
  Ici, vous pouvez définir le comportement du calcul des disponibilités en temps réel de Loxya.
  Vous pouvez consulter cet article de blog pour en savoir plus.
  • Clôture automatique : L'événement ou la réservation se termine à la date prévue, même sans inventaire de retour. Quand la date de fin de mobilisation d'un événement ou d'une réservation est passée, Loxya considère que le matériel est retourné en stock, même si vous ne faites pas d'inventaire de retour.
  • Clôture manuelle : L'événement ou la réservation reste actif jusqu'à ce qu'inventaire soit créé manuellement. Quand la date de fin de mobilisation d'un événement ou d'une réservation est passée, Loxya considère que le matériel est toujours indisponible, jusqu'à ce qu'un inventaire de retour soit validé. Cela permet également d'afficher les retards.
• Paramètres avancés
  Si vous savez ce que vous faites, vous pouvez choisir "oui" à cette question, et voir le détail ci-dessous.

Paramètres avancés

• Jeton de sécurité
  Si vous souhaitez changer le token de sécurité, ou en spécifier un personnalisé, vous pouvez le faire ici. À noter que cela aura pour conséquence de déconnecter tous les utilisateurs qui sont actuellement connectés au logiciel.
• Activer CORS (Cross Origin Resource Sharing)
  Par défaut, il est recommandé de laisse ce paramètre sur "Non", à moins de savoir ce que vous faites. En général, cela est utile uniquement en environnement de développement.
• Durée des sessions
  Durée maximale de la session (en heures) avant que les utilisateurs ne doive se reconnecter.
• Nombre d'éléments par page
  Le nombre maximum d'éléments qui peuvent être affichés dans les pages de listings.
• Mode de génération des codes-barres
  • Automatique : Loxya génère le contenu des codes-barres de chaque matériel.
  • Manuel : vous pourrez spécifier le contenu des codes-barres, mais l'utilisation d'un scanner de code-barres qui est capable d'insérer un préfixe et un suffixe sera requise.
• Format des codes-barres générés par Loxya
  Choisissez le type de code-barres que Loxya devra prendre en charge : QR-code, PDF 417, Code 39 ou Code 128.

Note
À partir de ce moment-là, toutes les informations renseignées seront stockées dans le fichier src/App/Config/settings.json (voir annexes). Vous pouvez éventuellement modifier ce fichier "à la main", mais il est fortement conseillé de plutôt utiliser la la commande ./bin/console install pour cela.

Mise à jour de la base de données

Ici, vous n'avez rien de spécial à faire. Quand vous appuyez sur la touche Entrée du clavier, l'assistant lance les migrations de la base de données, pour installer toute la structure de la base de données (ou pour la modifier selon la dernière version, s'il s'agit d'une mise à jour).

Premier utilisateur

Dans cette étape, il vous faut définir les informations du tout premier utilisateur de Loxya, qui aura les droits "administration", c'est à dire tous les droits.

• Prénom
  Indiquez le prénom du premier utilisateur administrateur.
• Nom
  Indiquez le nom de famille du premier utilisateur administrateur.
• Identifiant
  Le pseudo qui permettra au premier utilisateur administrateur de se connecter à Loxya.
• Mot de passe
  Le mot de passe qui va avec. Ne le perdez pas, car les administrateurs ne peuvent pas réinitialiser leur mot de passe.
• Adresse e-mail
  L'adresse e-mail de l'utilisateur admin, qui pourra aussi être utilisée pour se connecter.

Terminé !

Et voilà, l'installation de Loxya est terminée. En cliquant sur le bouton "Démarrer", vous pourrez entrer vos identifiants (ceux que vous avez donné à l'étape 6) pour vous connecter et commencer à utiliser l'application !!