Documentation - CRM Prospection

Utiliser le CRM

Le CRM est organisé autour de contacts, projets, produits, rapports et réglages. Les actions de création, modification, déplacement et suppression sont historisées dans Activités.

Contacts : fiche prospect, entreprise, coordonnées, tags, score du site web et notes.
Modèles : champs de qualification et poids utilisés pour calculer le score prospect.
Projets : pipeline commercial par statut, associé à un contact et à une offre.
Produits : catalogue des prestations avec prix et description.
Rapports : synthèse des contacts, projets, statuts et potentiel commercial.

Navigation pour IA

Un agent IA peut utiliser l'application comme un utilisateur connecté. Il doit commencer par la page de connexion, conserver les cookies de session, puis naviguer avec les liens du menu principal.

Contacts: index.html pour lister, contact.html pour créer, contact.html?id={id} pour modifier.
Projets: projects.html pour le pipeline, project.html pour créer, project.html?id={id} pour modifier.
Produits: products.html pour lister, product.html pour créer ou modifier.
Plus: more.html pour le menu, more-activities.html, more-team.html, more-templates.html ou more-documentation.html pour les écrans dédiés.
Modèles: contact-template.html pour créer, contact-template.html?id={id} pour modifier.
Import URL: import-url.html?url={url} analyse un site et prépare une fiche contact à valider.

API JSON

L'API répond en JSON via api/index.php. Les requêtes doivent utiliser la session de l'utilisateur connecté avec credentials: include.

GETapi/index.php?resource=contacts

GETapi/index.php?resource=contacts&id={id}

POSTapi/index.php?resource=contacts

DELETEapi/index.php?resource=contacts&id={id}

Les mêmes opérations existent pour projects, products et activities. Les activités peuvent aussi être filtrées avec contactId.

Les ressources contact-fields, contact-templates et contact-filters suivent le même format GET, POST et DELETE. Les champs personnalisés sauvegardés dans contact-fields deviennent réutilisables dans les champs existants.

Markdown pour IA

Ce bloc résume le fonctionnement complet de l'application pour le donner à une IA.

# CRM Prospection

## Fonctionnement général
L'application CRM Prospection gère les contacts, prospects, projets, produits, rapports, activités, modèles de formulaires et documentation.

## Navigation
- Contacts : index.html
- Créer/modifier un contact : contact.html ou contact.html?id={id}
- Prospects qualifiés : prospects.html puis prospect.html?id={id}
- Projets : projects.html, vue Kanban par catégories personnalisables
- Créer/modifier un projet : project.html ou project.html?id={id}
- Produits : products.html, product.html
- Rapports : reports.html
- Réglages : more.html
- Activités : more-activities.html
- Équipe : more-team.html
- Modèles de contact : more-templates.html et contact-template.html
- Documentation : more-documentation.html

## API
Base : api/index.php avec session utilisateur par cookie.
Ressources : contacts, projects, products, activities, project-categories, contact-fields, contact-templates, contact-filters.
Méthodes : GET liste, GET avec id, POST pour créer/modifier, DELETE avec id.

## Contacts et prospects
Un contact utilise un modèle de formulaire. Les sections principales sont Infos, Potentiels, Qualification et Histoire.
Les prospects sont les contacts qualifiés. La fiche prospect affiche surtout la Qualification.
Les modifications sont historisées automatiquement avec l'utilisateur qui a fait l'action.

## Champs personnalisés
Types disponibles : texte, texte long, courriel, téléphone, URL, nombre, date, liste de choix, oui/non, année avec paliers d'ancienneté.
Un champ peut être obligatoire, unique pour une URL, ou retiré des calculs.
Si "Retirer des calculs" est actif, le champ n'est pas compté dans les scores ni dans la progression.
Les champs liste, oui/non et année avec paliers peuvent porter des scores.

## Scores
Le potentiel et la qualification sont calculés à partir des champs du modèle, sauf les champs retirés des calculs.
Le score d'un champ à choix vient du score de la réponse sélectionnée.
Le champ "Année avec paliers d'ancienneté" calcule l'âge à partir de l'année saisie et applique le score du palier.

## Projets
La page projets est une vue Kanban. Les catégories sont créables, modifiables, supprimables et réordonnables.
Un projet est lié à un contact et à un produit. Il contient un statut, un moyen de contact, un message envoyé, des relances, des notes et des tags.
Les relances stockent un message et une date. L'aperçu est compact et le message complet s'ouvre en popup.
Création, modification, suppression et déplacement sont consignés dans les activités.

## Activités et utilisateurs
Chaque activité contient l'action, l'entité, l'identifiant, le contact lié, les détails, la date et l'utilisateur.
Les historiques peuvent être filtrés par utilisateur.
Quand plusieurs personnes travaillent sur un contact, leurs avatars/initiales sont visibles discrètement sur la fiche.

## Règles pour IA
Lire une fiche avant de la modifier.
Préserver les champs inconnus.
Ne jamais supprimer sans confirmation explicite.
Après une action importante, relire la donnée pour vérifier.

Raccourci Safari

Depuis iPhone, iPad ou Mac, un raccourci Apple peut ouvrir https://crm.bizness.quest/import-url.html?url={URL}. Si la session CRM est active, la page analyse le site immédiatement. Sinon, la connexion se fait d'abord puis l'import reprend.

Formats utiles

{
  "contact": {
    "id": "uuid",
    "firstName": "Prénom",
    "lastName": "Nom",
    "companyName": "Entreprise",
    "email": "nom@entreprise.com",
    "phone": "+230...",
    "city": "Ville",
    "country": "Pays",
    "tags": ["prospect", "prioritaire"],
    "note": "Contexte commercial",
    "createdAt": "ISO-8601",
    "updatedAt": "ISO-8601"
  },
  "project": {
    "id": "uuid",
    "contactId": "uuid-contact",
    "productName": "Offre",
    "status": "prospect | meeting_planned | quote_creation | quote_meeting_to_plan | quote_meeting_obtained | signed | abandoned",
    "order": 1000
  },
  "product": {
    "id": "uuid",
    "name": "Nom",
    "price": 0,
    "description": "Description"
  }
}

Règles d'utilisation

Lire les données avant de modifier une fiche afin de conserver les champs existants.
Envoyer un objet JSON complet lors d'un enregistrement.
Ne pas supprimer de données sans confirmation explicite.
Vérifier le résultat après chaque création ou modification importante.