# 🧭 Premiers Pas avec N3WT-SCHOOL

Bienvenue dans **N3WT-SCHOOL** !
Ce guide rapide vous accompagnera dans les premières étapes de configuration de votre instance afin de la rendre pleinement opérationnelle pour votre établissement.

## ✅ Étapes à suivre :

1. **Configurer la signature électronique des documents via Docuseal**
2. **Activer l'envoi d'e-mails depuis la plateforme**

---

## ✍️ 1. Configuration de la signature électronique (Docuseal)

Afin de permettre la signature électronique des documents administratifs (inscriptions, conventions, etc.), N3WT-SCHOOL s'appuie sur [**Docuseal**](https://docuseal.com), un service sécurisé de signature électronique.

### Étapes :

1. Connectez-vous ou créez un compte sur Docuseal :
   👉 [https://docuseal.com/sign_in](https://docuseal.com/sign_in)

2. Une fois connecté, accédez à la section API :
   👉 [https://console.docuseal.com/api](https://console.docuseal.com/api)

3. Copiez votre **X-Auth-Token** personnel.
   Ce jeton permettra à N3WT-SCHOOL de se connecter à votre compte Docuseal.

4. **Envoyez votre X-Auth-Token à l'équipe N3WT-SCHOOL** pour qu'un administrateur puisse finaliser la configuration :
   ✉️ Contact : [contact@n3wtschool.com](mailto:contact@n3wtschool.com)

> ⚠️ Cette opération doit impérativement être réalisée par un administrateur N3WT-SCHOOL.
> Ne partagez pas ce token en dehors de ce cadre.

---

## 📧 2. Configuration de l'envoi d’e-mails

L’envoi de mails depuis N3WT-SCHOOL est requis pour :

- Notifications aux étudiants
- Accusés de réception
- Envoi de documents (factures, conventions…)

Vous devrez renseigner les informations de votre fournisseur SMTP dans **Paramètres > E-mail** de l’application.

### Informations requises :

- Hôte SMTP
- Port SMTP
- Type de sécurité (TLS / SSL)
- Adresse e-mail (utilisateur SMTP)
- Mot de passe ou **mot de passe applicatif**

---

## 🔐 Mot de passe applicatif (Gmail, Outlook, etc.)

Certains fournisseurs (notamment **Gmail**, **Yahoo**, **iCloud**) ne permettent pas d’utiliser directement votre mot de passe personnel pour des applications tierces.
Vous devez créer un **mot de passe applicatif**.

### Exemple : Créer un mot de passe applicatif avec Gmail

1. Connectez-vous à [votre compte Google](https://myaccount.google.com)
2. Allez dans **Sécurité > Validation en 2 étapes**
3. Activez la validation en 2 étapes si ce n’est pas déjà fait
4. Ensuite, allez dans **Mots de passe des applications**
5. Sélectionnez une application (ex. : "Autre (personnalisée)") et nommez-la "N3WT-SCHOOL"
6. Copiez le mot de passe généré et utilisez-le comme **mot de passe SMTP**

> 📎 Vous pouvez consulter l’aide officielle de Google ici :
> [Créer un mot de passe d’application – Google](https://support.google.com/accounts/answer/185833)

---

## 🗂️ Configuration SMTP — Fournisseurs courants

| Fournisseur       | SMTP Host           | Port TLS | Port SSL | Sécurité | Lien aide SMTP                                                               |
| ----------------- | ------------------- | -------- | -------- | -------- | ---------------------------------------------------------------------------- |
| Gmail             | smtp.gmail.com      | 587      | 465      | TLS/SSL  | [Aide SMTP Gmail](https://support.google.com/mail/answer/7126229?hl=fr)      |
| Outlook / Hotmail | smtp.office365.com  | 587      | —        | TLS      | [Aide SMTP Outlook](https://support.microsoft.com/fr-fr/office)              |
| Yahoo Mail        | smtp.mail.yahoo.com | 587      | 465      | TLS/SSL  | [Aide SMTP Yahoo](https://help.yahoo.com/kb/SLN4724.html)                    |
| iCloud Mail       | smtp.mail.me.com    | 587      | 465      | TLS/SSL  | [Aide iCloud SMTP](https://support.apple.com/fr-fr/HT202304)                 |
| OVH               | ssl0.ovh.net        | 587      | 465      | TLS/SSL  | [Aide OVH SMTP](https://help.ovhcloud.com/csm/fr-email-general-settings)     |
| Infomaniak        | mail.infomaniak.com | 587      | 465      | TLS/SSL  | [Aide SMTP Infomaniak](https://www.infomaniak.com/fr/support/faq/1817)       |
| Gandi             | mail.gandi.net      | 587      | 465      | TLS/SSL  | [Aide SMTP Gandi](https://docs.gandi.net/fr/mail/faq/envoyer_des_mails.html) |

> 📝 Si votre fournisseur ne figure pas dans cette liste, n'hésitez pas à contacter votre fournisseur de mail pour obtenir ces informations.

---

## 🎉 Vous êtes prêt·e !

Une fois ces deux configurations effectuées, votre instance N3WT-SCHOOL est prête à fonctionner pleinement.
Vous pourrez ensuite ajouter vos formations, étudiants, documents et automatiser toute votre gestion scolaire.
