Documentation DrogPulseAI

DrogPulseAI est une application mobile de gestion de contacts professionnels développée spécifiquement pour les professionnels du secteur de la quincaillerie. Son slogan "Le rythme intelligent de votre quincaillerie" illustre sa mission : connecter, anticiper et optimiser les relations professionnelles.

L'application est structurée selon une architecture en trois couches :

1. Application Android native (frontend)
2. API REST en PHP (backend)
3. Base de données MySQL (stockage)

Fonctionnalités principales

Parcours utilisateur

L'architecture de DrogPulseAI suit le modèle client-serveur, avec une séparation claire entre les trois couches principales. Cette organisation assure une maintenance facilitée et une évolutivité optimale.

Structure du projet

app/
├── build.gradle.kts           # Configuration Gradle
├── src/main/
    ├── java/com/drogpulseai/  # Code source Java
    │   ├── activities/        # Écrans de l'application
    │   ├── adapters/          # Adaptateurs pour RecyclerView
    │   ├── api/               # Configuration API
    │   ├── models/            # Modèles de données
    │   └── utils/             # Utilitaires
    ├── res/                   # Ressources
    └── AndroidManifest.xml    # Configuration Android

Composants principaux

Écrans de l'application

Structure des fichiers

api/
├── auth/                 # Authentification
│   ├── login.php
│   └── register.php
├── contacts/             # Gestion des contacts
│   ├── list.php
│   ├── search.php
│   ├── create.php
│   ├── update.php
│   ├── delete.php
│   └── details.php
├── config/               # Configuration
│   └── database.php
└── utils/                # Utilitaires
    └── response.php

Endpoints API

Format des réponses

{
    "success": true/false,
    "message": "Message informatif",
    "data": { /* Données optionnelles */ }
}

Schéma de la base de données

Scripts SQL des tables

Table users

CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `nom` varchar(100) NOT NULL,
  `prenom` varchar(100) NOT NULL,
  `telephone` varchar(20) NOT NULL,
  `latitude` double NOT NULL,
  `longitude` double NOT NULL,
  `email` varchar(100) NOT NULL UNIQUE,
  `password` varchar(255) NOT NULL,
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
);

Table contacts

CREATE TABLE `contacts` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `nom` varchar(100) NOT NULL,
  `prenom` varchar(100) NOT NULL,
  `telephone` varchar(20) NOT NULL,
  `email` varchar(100) NULL,
  `notes` text NULL,
  `latitude` double NOT NULL,
  `longitude` double NOT NULL,
  `user_id` int(11) NOT NULL,
  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  FOREIGN KEY (`user_id`) REFERENCES `users` (`id`) ON DELETE CASCADE
);

Prérequis

Déploiement du Backend

CREATE DATABASE drogpulseai;
USE drogpulseai;

-- Exécuter ensuite les scripts de création des tables

Déploiement de l'Application

private static final String BASE_URL = "http://votre-serveur.com/drogpulseai/api/";

Création d'un compte

1. Lancer l'application DrogPulseAI
2. Cliquer sur "S'inscrire"
3. Remplir le formulaire avec les informations requises
4. Accepter les permissions de localisation
5. Valider l'inscription

Gestion des contacts

Mesures de sécurité

Optimisations de performance

Procédures de maintenance

Évolutions possibles