Comment utiliser SAL SAISS étape par étape

1. Guide propriétaire — à quoi sert le système ?

SAL SAISS aide le propriétaire ou directeur à contrôler l'argent chantier : budget prévu, dépenses réelles, fournisseurs, factures, paiements, caisse et pièces CCAG-T.

• Voir la santé générale de l'entreprise depuis le dashboard.
• Créer et suivre chaque chantier.
• Contrôler les dépenses avant validation.
• Suivre les factures fournisseur et paiements.
• Garder une trace automatique dans l'audit log.
• Préparer les documents marchés publics CCAG-T.

2. Connexion

Adresse application : https://petvya.com

1. Ouvrir le lien.
2. Entrer l'email.
3. Entrer le mot de passe.
4. Cliquer sur Entrer.

3. Dashboard général

Le dashboard donne une vue rapide :

4. Chaque bouton du menu

5. Utilisation CCAG-T

1. Choisir le chantier public.
2. Créer un ordre de service si reçu.
3. Ajouter les attachements pour quantités exécutées.
4. Créer la situation mensuelle.
5. Suivre cautions, avenants et réclamations.

6. Rôles et contrôle

7. Workflow complet pour tester sans rien connaître

1. Se connecter comme Direction.
2. Ouvrir Test métier et lire les étapes.
3. Créer un chantier.
4. Ajouter un fournisseur.
5. Ajouter une ligne budget.
6. Créer une dépense.
7. Créer une facture.
8. Ajouter un paiement.
9. Ajouter un mouvement caisse.
10. Ouvrir Détail chantier pour contrôler.
11. Ouvrir Audit log pour vérifier la traçabilité.

8. Captures d'écran expliquées

Les captures seront ajoutées ici et mises à jour après chaque étape.

9. Exports PDF / Excel

Le bouton Exports sert à télécharger les documents hors système.

• Situation PDF : document de situation de travaux.
• Attachement PDF : document quantité / prix / montant.
• Réclamation PDF : document de demande ou contestation.
• Dépenses Excel : fichier Excel de toutes les dépenses ou par chantier.

التصدير: زر Exports يسمح بتحميل الوضعيات والمرفقات والمطالبات PDF، وتحميل المصاريف Excel.

Admin système

Cette section est réservée à la Direction. Elle sert à contrôler l'état technique du système.

• Voir la taille de la base de données.
• Voir la taille des fichiers uploadés.
• Voir les derniers backups.
• Créer un backup manuel immédiatement.

إدارة النظام: هذه الصفحة خاصة بالإدارة فقط، وتستعمل لمراقبة قاعدة البيانات، الملفات، والنسخ الاحتياطية.

Monitoring et maintenance automatique

SAL SAISS contrôle automatiquement la santé du système chaque heure.

• Application et API
• Documentation
• PDF commercial
• Service API
• Timer backup
• Nginx
• Nombre de backups

Page application: Monitoring.

المراقبة: النظام يدير فحص تلقائي كل ساعة للتطبيق، API، الوثائق، النسخ الاحتياطية و Nginx.

Sécurité livraison et restauration backup

SAL SAISS dispose maintenant d'une protection login, de headers sécurité et d'un test de restauration backup.

• Rate-limit sur connexion.
• Headers sécurité API et Nginx.
• Test automatique de restauration SQLite.
• Rapports dans reports/restore-tests/.

Commande serveur: npm run security:check

الأمان والاسترجاع: تمت إضافة حماية لمحاولات الدخول، headers أمنية، واختبار للتأكد من أن النسخ الاحتياطية قابلة للاسترجاع.

Backups depuis Admin système

La Direction peut maintenant contrôler les sauvegardes directement depuis l’interface.

• Tester : vérifie l’intégrité du backup.
• Dry-run : simule la restauration sans modifier les données.
• Télécharger : récupère le fichier SQLite sécurisé.

La restauration réelle reste volontairement protégée côté serveur pour éviter une erreur humaine.

النسخ الاحتياطية: يمكن للمدير اختبار النسخة، تجربة الاسترجاع بدون تغيير البيانات، وتحميل النسخة. الاسترجاع الحقيقي يبقى محمي على السيرفر.

Pack propriétaire final

Un pack propriétaire a été préparé pour présenter SAL SAISS, organiser la démonstration client et préparer la migration vers le domaine réel.

• Fiche accès et responsabilités.
• Checklist démonstration client.
• Message commercial prêt à envoyer.
• Procédure domaine réel.
• Résumé sécurité, backup et monitoring.

Dossier serveur: delivery/SAL-SAISS-v1-owner-pack/

Télécharger le PDF propriétaire final

حزمة المالك: تم تجهيز ملف خاص بصاحب المشروع فيه الولوج، المسؤوليات، خطوات العرض على العميل، رسالة تجارية، وطريقة ربط الدومين الحقيقي.

Pack média propriétaire

Un pack média court est prêt pour WhatsApp, Telegram ou démonstration rapide.

• Captures écran finales desktop et mobile.
• Fiche visuelle courte SAL SAISS.
• Miniature du PDF propriétaire.
• Message court prêt à envoyer.

Voir la fiche visuelle

Voir la miniature PDF

حزمة الميديا: صور نهائية، ورقة قصيرة، صورة مصغرة للـ PDF، ورسالة جاهزة للإرسال عبر واتساب أو تيليغرام.

Pack répétition démo propriétaire

Un pack de démonstration commerciale est prêt pour présenter SAL SAISS en 20 à 25 minutes.

• Checklist minute par minute.
• Script d'appel client.
• Réponses aux objections.
• Message de suivi après démo.
• Visuel et teaser vidéo court.

Voir le visuel démo

Voir le teaser vidéo

حزمة العرض: فيها برنامج العرض بالدقائق، سكريبت المكالمة، أجوبة الاعتراضات، ورسالة المتابعة بعد العرض.

Release Candidate finale v1

SAL SAISS v1 est gelé comme Release Candidate finale sur le domaine temporaire.

• Index final des livrables.
• Pack propriétaire.
• Pack média.
• Pack démo.
• Kit migration domaine réel.
• Rapports QA, monitoring et restauration.

Bloqué seulement par: domaine réel, vrais utilisateurs, mots de passe définitifs et informations légales société.

النسخة النهائية المرشحة: SAL SAISS جاهز للعرض والتجربة، وباقي فقط الدومين الحقيقي، المستخدمين الحقيقيين، كلمات السر النهائية ومعلومات الشركة.

Préparation données client réelles

En attendant le domaine final, les données client peuvent déjà être préparées pour accélérer la mise en production.

• Formulaire société.
• Formulaire utilisateurs réels.
• Formulaire chantier pilote.
• Formulaire fournisseurs de départ.
• Templates CSV utilisateurs, fournisseurs, chantier et budget.
• Checklist avant migration finale.

Dossier serveur: delivery/SAL-SAISS-v1-client-onboarding/

تحضير معلومات العميل: يمكن تجهيز معلومات الشركة، المستخدمين، أول ورش، الموردين والميزانية قبل شراء الدومين النهائي.

Questionnaire client structuré

Un questionnaire prêt à envoyer permet de collecter les informations nécessaires avant la livraison client réelle.

• Questionnaire français complet.
• Questionnaire arabe simplifié.
• Message WhatsApp court.
• Tableaux CSV de collecte.
• Plan d'import sécurisé.

Dossier serveur: delivery/SAL-SAISS-v1-client-questionnaire/

استمارة العميل: تم تجهيز أسئلة بالعربية والفرنسية لجمع الدومين، معلومات الشركة، المستخدمين، أول ورش والموردين.

Contrôles client-ready

Une nouvelle page Direction vérifie si SAL SAISS peut être considéré comme prêt pour livraison client réelle.

• Domaine réel configuré.
• Informations légales société complètes.
• Comptes démo remplacés.
• Responsable Direction et Comptable actifs.
• Chantier pilote et fournisseurs présents.

Page application: Client-ready.

جاهزية العميل: صفحة داخل الإدارة كتوضح شنو باقي قبل التسليم الحقيقي: الدومين، معلومات الشركة، المستخدمين الحقيقيين وكلمات السر.

Mode collecte assistée

Une page Direction permet maintenant de cocher les données client reçues et de générer un rapport prêt pour migration.

• Stockage des éléments de collecte.
• Valeurs et notes par élément.
• Rapport collecting_client_data ou ready_for_migration.
• Préparation avant migration domaine réel.

Page application: Collecte client.

جمع معلومات العميل: صفحة إدارية لتحديد المعلومات التي وصلتنا وتوليد تقرير الجاهزية للهجرة للدومين الحقيقي.

Import assisté contrôlé

Une page Direction permet de prévisualiser les données collectées puis d’appliquer un import limité après confirmation forte.

• Preview société.
• Preview chantier pilote.
• Alertes pré-import.
• Backup automatique avant import.
• Confirmation exacte: IMPORT CLIENT.

Page application: Import assisté.

الإدخال المساعد: يعرض البيانات قبل إدخالها، يطلب تأكيد قوي، ويأخذ نسخة احتياطية قبل أي تعديل.

Import structuré avancé

Les utilisateurs et fournisseurs peuvent maintenant être préparés ligne par ligne avec validation stricte avant insertion.

• Tables structurées utilisateurs/fournisseurs.
• Validation emails, rôles, doublons et codes fournisseurs.
• Rapport d’erreurs avant import.
• Backup automatique avant insertion.
• Confirmation exacte: IMPORT STRUCTURE.

Page application: Import structuré.

إدخال منظم: المستخدمون والموردون كسطور منظمة مع فحص الأخطاء قبل الإدخال، ونسخة احتياطية قبل التنفيذ.

Durcissement production final

SAL SAISS a reçu un durcissement production avant migration vers domaine réel.

• Correction Express trust proxy pour le rate-limit.
• Mot de passe non pré-rempli dans l’écran login.
• Permissions SQLite/backups renforcées.
• npm audit: 0 vulnérabilité.
• Headers sécurité et TLS vérifiés.

Rapports serveur: reports/security/

تقوية الإنتاج: تم إصلاح trust proxy، إزالة كلمة السر من شاشة الدخول، فحص npm audit، وتقوية صلاحيات قاعدة البيانات والنسخ الاحتياطية.

Release Candidate finale durcie

Une nouvelle RC finale durcie regroupe tous les livrables, correctifs sécurité, rapports et outils de préparation client.

• Index global final durci.
• Statut officiel final.
• Rapport de vérification RC durcie.
• Packs propriétaire, média, démo.
• Migration domaine réel.
• Collecte/import données client.

Statut: ready_waiting_domain_and_client_data.

النسخة النهائية المحصنة: SAL SAISS جاهز تقنياً وينتظر فقط الدومين الحقيقي ومعلومات العميل الحقيقية.

Mode attente active / migration réelle

SAL SAISS est maintenant verrouillé en mode prêt techniquement, en attente du vrai domaine et des données client réelles.

• Messages client prêts à envoyer.
• Runbook si domaine fourni.
• Runbook si domaine absent.
• Statut opérationnel: ready_waiting_domain_and_client_data.

Décision: ne plus ajouter de fonctionnalités avant migration réelle.

انتظار نشط: SAL SAISS جاهز تقنياً وينتظر الدومين الحقيقي ومعلومات العميل. لا نضيف ميزات جديدة قبل التسليم الحقيقي.

Marque et paramètres entreprise

SAL SAISS possède maintenant un logo officiel et une page de paramètres entreprise.

• Page application: Paramètres
• Utilisation: modifier nom société, ICE, RC, téléphone, email, site web, logo et couleurs.
• Les exports PDF utilisent ces informations automatiquement.

العلامة التجارية: تمت إضافة شعار رسمي وصفحة إعدادات الشركة. هذه المعلومات تظهر في وثائق PDF.

Pré-production: utilisateurs, mots de passe et nettoyage

SAL SAISS possède maintenant des outils de stabilisation avant livraison client.

• Paramètres: choisir mode Démo ou Production.
• Utilisateurs: créer, activer/désactiver et réinitialiser les mots de passe.
• Mot de passe: chaque utilisateur peut changer son accès.
• Admin système: nettoyer les données QA après backup automatique.

مرحلة ما قبل الإنتاج: يمكن الآن إنشاء المستخدمين، تغيير كلمات السر، اختيار وضع Demo أو Production، وتنظيف بيانات الاختبار بعد إنشاء نسخة احتياطية.

Migration vers domaine réel

SAL SAISS est actuellement sur le domaine temporaire petvya.com. Quand le domaine final est acheté, il faut pointer DNS vers le VPS.

Après propagation DNS: installer Nginx, SSL, mettre à jour Paramètres, puis lancer QA final.

الدومين الحقيقي: منين تشري الدومين النهائي، خاص DNS يشير للسيرفر 187.124.159.80، ثم نركبو SSL ونشغلو الاختبارات النهائية.

Qualité QA — comment contrôler avant livraison

Avant de présenter SAL SAISS à un client, lancer les tests qualité:

1. Ouvrir le serveur.
2. Aller dans le dossier projet.
3. Lancer npm run qa.
4. Vérifier que le résultat affiche PASS.

Les rapports sont générés dans reports/qa/.

• production-smoke-report.md: santé générale production.
• permission-matrix-report.md: contrôle des droits par rôle.

اختبارات الجودة: قبل تسليم النظام، يجب تشغيل npm run qa للتأكد من تسجيل الدخول، الصلاحيات، التصدير، والوظائف الأساسية.

10. Skills activés pour construire SAL SAISS

Les compétences suivantes sont installées pour accélérer le développement, la documentation, les tests et les exports.

Vidéos tutoriel

Ces vidéos montrent SAL SAISS étape par étape pour une personne qui découvre le système.

الفيديوهات: هذه الفيديوهات تشرح النظام خطوة بخطوة: الدخول، لوحة التحكم، دورة الورش، CCAG-T، التصدير والإدارة.

Présentation commerciale

Une page commerciale complète est disponible pour présenter SAL SAISS à un client ou partenaire.

العرض التجاري: صفحة جاهزة لتقديم SAL SAISS للزبناء مع PDF قابل للتحميل.

Livraison v1

SAL SAISS est préparé en mode production avec statut ready.

• Données QA nettoyées après backup.
• Dossier livraison créé: delivery/SAL-SAISS-v1/
• Rapports QA inclus.
• PDF commercial inclus.

التسليم v1: تم تنظيف بيانات الاختبار، تفعيل وضع production، وتجهيز ملف التسليم.

10. Historique de construction

• Step 10 : audit MVP en ligne.
• Step 11 : page Test métier.
• Step 12 : modules CCAG-T de base.
• Step 13 : UX métier, listes déroulantes, filtres, détail chantier.
• Step documentation : création du centre documentation propriétaire.
• Step skills : installation des skills projet nécessaires.
• Step 14 : exports PDF / Excel.
• Step 15 : sécurité légère, backups automatiques et page Admin système.
• Step 16 : tests QA production et matrice permissions.
• Step 17 : vidéos tutoriel FR/AR intégrées dans la documentation.
• Step 18 : page commerciale, offre MVP, PDF et checklist démo client.
• Step 19 : logo officiel, paramètres entreprise et intégration PDF.
• Step 20 : stabilisation pré-production, utilisateurs, mots de passe et nettoyage QA.
• Step 21 : livraison v1, nettoyage QA, mode production ready et archive livraison.
• Step 22 : kit migration domaine réel, scripts Nginx/SSL et runbook DNS.
• Step 23 : monitoring automatique, rapports santé et page Monitoring.
• Step 24 : sécurité login, headers HTTP et test restauration backup.
• Step 25 : interface backups admin, test, téléchargement et dry-run restauration.
• Step 26 : pack propriétaire final, checklist démo et procédure domaine réel.
• Step 27 : PDF propriétaire premium unique prêt à envoyer.
• Step 28 : pack média propriétaire, captures finales et message court.
• Step 29 : pack répétition démo propriétaire et teaser vidéo.
• Step 30 : gel Release Candidate finale v1 et index global.
• Step 31 : préparation données client réelles et onboarding.
• Step 32 : questionnaire client structuré et plan d’import sécurisé.
• Step 33 : contrôles internes client-ready et statut waiting_client_data.
• Step 34 : mode collecte assistée et rapport prêt migration.
• Step 35 : import assisté contrôlé avec backup et confirmation forte.
• Step 36 : import structuré utilisateurs/fournisseurs avec validation stricte.
• Step 37 : durcissement production, audit dépendances et checklist serveur.
• Step 38 : Release Candidate finale durcie avec SHA256.
• Step 39 : mode attente active / migration réelle.