Metadata-Version: 2.4
Name: gescokit
Version: 1.0.0
Summary: Boite à outils modulaire pour la gestion commerciale
Author-email: Cédrick COPOL <support@emc2-informatique.com>
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: IfxPy
Requires-Dist: pandas
Requires-Dist: typer>=0.9.0
Requires-Dist: pydantic<3.0
Requires-Dist: requests
Requires-Dist: rich
Requires-Dist: structlog
Requires-Dist: pyyaml
Requires-Dist: posix_ipc
Requires-Dist: trogon
Provides-Extra: etiquettes
Requires-Dist: pypdf; extra == "etiquettes"

# Gescokit – Commande `adelya`

**Gescokit** est une boîte à outils modulaire pour la gestion commerciale.  
Le module `adelya` permet d'interagir avec l'API CRM Adelya pour retrouver des membres fidélité ou des événements marketing.

---

## 🚀 Installation

Assurez-vous d'utiliser Python **3.11.x** :

```bash
python --version
```

Installez le projet en mode développement :

```bash
pip install -e .
```

---

## ⚙️ Configuration

Créez un fichier de configuration `config_crm.json`, par exemple dans :

```bash
gescokit/crm/adelya/data/config_crm.json
```

### Exemple de contenu :

```json
{
  "nom": "CDI",
  "https": "1",
  "login": "KEY-lERSUEnSE;API_EMC2_PROD_YRCI",
  "password": "xXXXYxxxxIUUU",
  "url": "asp.adelya.com/apiv1/webapi.do?clientId=YR_CDI_EMC2",
  "timeout": 5,
  "idmagasin": "0",
  "debug": false,
  "country": "GP"
}
```

⚠️ Le champ `login` **doit contenir deux éléments** séparés par `;`  
⚠️ Le champ `url` **doit contenir** `clientId=`

---

## 🧪 Utilisation de la commande `adelya`

### 1. Recherche par numéro de carte

```bash
adelya fidMember_by_cardnumber 10456701
```

### 2. Recherche par téléphone mobile

```bash
adelya fidMember_by_mobile +590690123456
```

### 3. Recherche par code interne (ex. code client GCV)

```bash
adelya fidMember_by_code C00123
```

### 4. Recherche d’un événement publicitaire via une facture

```bash
adelya adEvent_by_numfac FB20241234
```

---

## 🧩 Options supplémentaires

- `--config` ou `-f` : chemin personnalisé vers le fichier `config_crm.json`
- `--country` ou `-c` : surcharge du pays (utile en développement multi-site)

Exemple :

```bash
adelya fidMember_by_cardnumber 10456701 -f ./test_config.json -c MQ
```

---

## 📦 Développement

Les validations de configuration sont gérées via [Pydantic](https://docs.pydantic.dev/), et la CLI via [Typer](https://typer.tiangolo.com/).

---

## 📜 Licence

Projet interne – tous droits réservés.
```

---

