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 جاهز للعرض والتجربة، وباقي فقط الدومين الحقيقي، المستخدمين الحقيقيين، كلمات السر النهائية ومعلومات الشركة.

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.