Documentation officielle mise à jour — 2026-05-26

SAL SAISS ERP BTP

Système BTP marocain complet : chantiers, budgets, dépenses, caisse, fournisseurs, factures, paiements, matériel, Dossier technique, exports, permissions, monitoring, backups et audit log.

Ouvrir l'applicationPrésentation commerciale
Dernière versionLogo officiel appliquéDossier technique actifModules BTP actifsQA et backups actifs

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 du dossier technique.

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.
Compte propriétaire test : admin@salsaiss.ma / Admin12345

3. Dashboard général

Le dashboard donne une vue rapide :

Cartes KPI

Chantiers, budget total, dépenses, factures impayées, paiements, solde caisse, marge estimée, alertes.

Graphiques

Budget vs réel et dépenses par catégorie.

4. Chaque bouton du menu

Test métier

Checklist pour essayer le système étape par étape.

Dossier technique

Ordres de service, situations, attachements, cautions, avenants, réclamations.

Exports

Télécharger situations, attachements, réclamations en PDF et dépenses en Excel.

Admin système

Contrôle Direction: état, sauvegardes, stockage, base de données.

Paramètres

Identité entreprise utilisée dans les exports PDF et la présentation.

Qualité QA

Tests production, permissions par rôle, rapports avant livraison.

Détail chantier

Vue consolidée d'un seul chantier.

Chantiers

Créer les projets : client, lieu, budget, contrat, référence marché.

Budgets

Ajouter les lignes de budget par chantier.

Dépenses

Saisir les achats et charges chantier.

Fournisseurs

Gérer les entreprises, ICE, téléphone, catégorie.

Factures

Enregistrer les factures fournisseur.

Paiements

Suivre les paiements effectués ou prévus.

Caisse

Entrées et sorties de caisse chantier.

Alertes

Points à surveiller.

Audit log

Journal automatique des actions.

5. Utilisation Dossier technique

  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

RôleUtilisation
DirectionContrôle complet, validation, supervision.
ComptableFournisseurs, factures, paiements, vérification dépenses.
Chef de chantierDépenses chantier et pièces terrain Dossier technique.
Responsable caisseMouvements caisse.
Lecture seuleConsultation sans modification.

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é.

الدليل بالعربية

SAL SAISS هو نظام لتسيير مقاولات البناء: الأوراش، الميزانية، الموردين، المصاريف، الفواتير، الأداءات، الصندوق، ووثائق الصفقات العمومية Dossier technique.

كيف تبدأ؟

  1. افتح الموقع: petvya.com
  2. أدخل البريد الإلكتروني وكلمة المرور.
  3. ادخل إلى لوحة التحكم لمراقبة الأرقام المهمة.
  4. استعمل قائمة Test métier للتجربة خطوة بخطوة.
  5. أنشئ ورش، مورد، ميزانية، مصروف، فاتورة، أداء وحركة صندوق.
  6. استعمل Détail chantier لمراقبة ورش واحد.
  7. استعمل Dossier technique لتتبع أوامر الخدمة، الوضعيات، المرفقات، الضمانات، الملاحق والمطالبات.

معنى الأزرار

8. Captures d'écran expliquées

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

Écran connexion
Dashboard
Centre Dossier technique
Détail chantier
Exports PDF / Excel
Admin système
Documentation propriétaire
Mobile — connexion
Mobile — dashboard
Mobile — Dossier technique
Mobile — documentation

9. Exports PDF / Excel

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

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

Admin système

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

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

Monitoring et maintenance automatique

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

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.

Commande serveur: npm run security:check

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

Backups depuis Admin système

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Page application: Import structuré.

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

Durcissement production final

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

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.

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.

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.

Logo SAL SAISS

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

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

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

مرحلة ما قبل الإنتاج: يمكن الآن إنشاء المستخدمين، تغيير كلمات السر، اختيار وضع 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.

DNSValeur
Domaine final A187.124.159.80
wwwCNAME vers domaine final ou A vers 187.124.159.80
documentationA vers 187.124.159.80

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/.

اختبارات الجودة: قبل تسليم النظام، يجب تشغيل 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.

technical-doc-generator

Documentation technique, API, onboarding.

docs-style / technical-writing

Style, structure et guides utilisateur.

pdf-generator / pdf-tools

Création et manipulation PDF.

demo-video

Préparation de vidéos tutoriel.

sql-toolkit

Schéma, migration et requêtes SQLite.

QA Testing Engine

Tests fonctionnels et stratégie qualité.

node-auto-debugger

Audit Node.js/Express/React.

Vidéos tutoriel

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

Vidéo 1 — Connexion + Dashboard

Connexion propriétaire, dashboard, indicateurs principaux.

Vidéo 2 — Workflow chantier

Chantier, fournisseur, budget, dépense, facture, paiement, caisse et audit.

Vidéo 3 — Dossier technique + Exports + Admin

Modules Dossier technique, exports PDF/Excel et contrôle système.

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

Présentation commerciale

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

Ouvrir la présentation Télécharger le PDF

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

Livraison v1

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

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

Mise à jour SAL SAISS — Pilotage PMI CP / CMI CP — 26/05/2026

Objectif : intégrer dans le Dossier chantier une couche de pilotage opérationnel conforme aux besoins CMI CP : interfaces, risques, décisions, plan analytique, rapprochements, TVA et retenues.

Portée : cette page documente uniquement les modifications SAL SAISS réalisées le 26/05/2026 sur petvya.com. Elle exclut tout autre projet externe.

Phase 1 — Pilotage PMI CP / CMI CP

  • Ajout d’un onglet Pilotage PMI CP / CMI CP dans Dossier chantier.
  • Vues : globale, interfaces, risques, contrat, WBS/périmètre, changements, claims, décisions, CMI CP.
  • KPI cards, bouton unique Ajouter un élément, formulaire progressif et actions par ligne.
  • Masquage des données financières sensibles pour les rôles non autorisés.

Phase 2 — Backend Pilotage

  • Nouvelle route backend /api/pilotage.
  • Tables : project_pilotage_items, project_interfaces, project_risks, project_decisions, analytic_categories, cmi_cp_matrix, monthly_chantier_checklists.
  • Catégories analytiques seedées : MAT, MO, MTR, CAR, ST, TR, FG.
  • Actions contrôlées : soumettre, assigner, valider, refuser, demander correction, clôturer.

Phase 3A — Actions & export

  • Export CSV de la vue Pilotage : /api/pilotage/chantier/:id/export.csv.
  • Actions frontend : exporter la vue, exporter une ligne, modifier une ligne pilotage, assigner un responsable.
  • Les lignes agrégées des modules existants restent en lecture/export pour éviter de casser les workflows.

Phase 3B — Plan analytique CMI CP

  • Ajout non destructif de analytic_category_code sur dépenses, factures, paiements, caisse, achats, stock, pointage, matériel.
  • Backfill historique vérifié : aucune ligne ciblée sans catégorie.
  • Inférence automatique si la catégorie est absente : MAT, MO, MTR, CAR, ST, TR, FG.
  • Sélecteurs et colonnes analytiques ajoutés côté interface.

Phase 3C — Rapprochement CMI CP

  • API /api/pilotage/chantier/:id/reconciliation.
  • Contrôles : demande achat → ligne → BL/réception → facture → paiement.
  • Alertes sur BL sans facture, facture sans BL, paiement sans facture, facture trop payée, incohérences fournisseur/analytique.
  • Tableau d’issues et KPI d’alertes dans l’onglet CMI CP.

Phase 3D — Workflow anomalies

  • Table cmi_reconciliation_actions pour suivre chaque anomalie.
  • Actions : créer tâche Pilotage, assigner, marquer corrigée, valider, justifier.
  • Les anomalies peuvent passer de détectée à en traitement, corrigée, validée ou justifiée avec commentaire Direction.

Phase 4A — TVA CMI CP

  • APIs : /api/pilotage/chantier/:id/tva et export CSV TVA.
  • Suivi TVA collectée, TVA déductible, TVA nette, répartition par taux, alertes TVA.
  • Sources : dépenses, factures fournisseur, factures client.

Phase 4B — Retenues CMI CP

  • Table retention_records.
  • Retenue client, fournisseur et sous-traitant : montant retenu, libéré, restant, échéance, statut, justification.
  • APIs retentions, actions release/status/justify et export CSV.
  • Interface : KPIs, alertes, tableau, actions Libérer / En attente / Justifier.

Validation qualité du 26/05

Éléments QA à nettoyer avant livraison finale

Prochaines étapes recommandées

  1. Phase 4C — Sous-traitants CMI CP : registre sous-traitants, contrats, situations, factures, paiements, retenues, analytique ST, rapprochement contrat → situation → facture → paiement → retenue.
  2. Phase 5 — Pré-livraison : nettoyer QA/demo, créer chantier école CMI CP 2 000 000 DH, scénario démo complet, rapport final PMI CP / CMI CP.

ملخص بالعربية: تمت إضافة طبقة Pilotage PMI CP / CMI CP داخل Dossier chantier مع تتبع الواجهات، المخاطر، القرارات، التصنيف التحليلي، المطابقة، TVA والاحتفاظات. الخطوة المقبلة هي Sous-traitants CMI CP ثم تنظيف ما قبل التسليم.

10. Historique de construction

Dernière mise à jour : assistant propriétaire retiré; priorité aux modules métier BTP, rôles, QA et documentation.
Updated: CMI CP / Pilotage — 2026-05-26