https://github.com/tiger-githubb/fillengine
https://github.com/tiger-githubb/fillengine
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tiger-githubb/fillengine
- Owner: tiger-githubb
- Created: 2025-07-01T22:00:42.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-08-24T14:25:48.000Z (6 months ago)
- Last Synced: 2025-08-24T19:35:51.547Z (6 months ago)
- Language: JavaScript
- Size: 252 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# đ Auto-Fill Forms Extension
Extension Chrome moderne pour le remplissage automatique intelligent de formulaires web, en particulier Google Forms. Maintenant avec support de données CSV personnalisées !
## ⚠Fonctionnalités
- đŻ **Remplissage intelligent** : DĂ©tection automatique des champs de formulaire
- ïżœ **Support Google Forms** : OptimisĂ© pour les formulaires Google
- ïżœ **DonnĂ©es CSV** : Chargez vos propres donnĂ©es depuis un fichier CSV
- ïżœ **Configuration flexible** : Adaptation automatique selon le type de page
- đ **Statistiques dĂ©taillĂ©es** : Rapport complet du remplissage
- đš **Interface moderne** : Design Ă©purĂ© et intuitif
## đ NouveautĂ©s v2.0
- â
**Suppression des données en dur** : Plus de données codées dans l'extension
- â
**Upload CSV** : Chargez vos données personnelles via un fichier CSV
- â
**Sécurité améliorée** : Vos données restent locales
- â
**Flexibilité maximale** : Utilisez l'extension avec n'importe quelles données
- â
**Validation avancée** : Vérification automatique du format CSV
## đŠ Installation
1. Téléchargez ou clonez ce projet
2. Ouvrez Chrome et accédez à `chrome://extensions/`
3. Activez le "Mode développeur"
4. Cliquez sur "Charger l'extension non empaquetée"
5. Sélectionnez le dossier de l'extension
## đŻ Utilisation
### 1. Préparer vos données
1. Créez un fichier CSV avec vos données personnelles
2. Utilisez le fichier `example_data.csv` comme modĂšle
3. Consultez le `CSV_GUIDE.md` pour les détails complets
### 2. Charger les données
1. Cliquez sur l'icĂŽne de l'extension dans Chrome
2. Cliquez sur "đ Charger donnĂ©es CSV"
3. Sélectionnez votre fichier CSV
4. Attendez la confirmation de chargement
### 3. Remplir un formulaire
1. Naviguez vers le formulaire web
2. Cliquez sur l'icĂŽne de l'extension
3. Cliquez sur "Remplir le formulaire"
4. Consultez les statistiques de remplissage
## ïżœ Structure du projet
```
extension/
âââ manifest.json # Configuration de l'extension
âââ background.js # Script d'arriĂšre-plan
âââ content.js # Script de contenu principal
âââ popup.html # Interface utilisateur
âââ popup.js # Logique de l'interface
âââ example_data.csv # Exemple de donnĂ©es CSV
âââ CSV_GUIDE.md # Guide dĂ©taillĂ© du format CSV
âââ README.md # Ce fichier
âââ public/
âââ icons/ # IcĂŽnes de l'extension
âââ icon16.png
âââ icon32.png
âââ icon48.png
âââ icon128.png
```
## đ§ Configuration CSV
### Format requis
Votre fichier CSV doit contenir 38 colonnes spécifiques. Consultez `CSV_GUIDE.md` pour la liste complÚte.
### Exemple minimal
```csv
lastName,firstName,fullName,gender,sex,email,phone,mobile,birthPlace,birthCountry,residence,residenceCountry,nationality,address,idNumber,passportNumber,cniNumber,fatherName,motherName,usualLanguage,motherLanguage,profession,company,academicReason,disabilities,birthDate,idExpirationDate,idIssuanceDate,examSubjects,idType,examTypes,hasDisabilities,agreement,termsAccepted,preferredLanguage,hasExperience,needsAccommodation,isFirstTime
DUPONT,Jean,"Jean DUPONT",Masculin,Homme,jean.dupont@email.com,0123456789,0123456789,Paris,France,Lyon,France,Française,"123 Rue Example, Lyon",FR123456789,FR123456789,FR123456789,Pierre DUPONT,Marie MARTIN,Français,Français,Développeur,TechCorp,Académique,Aucun,1985-03-15,2030-12-31,2020-01-01,Tous,CNI,"CE,CO",Aucun,true,true,Français,true,false,true
```
newField: "New Value",
},
};
```
### Step 2: Add Field Mappings
## đš Interface utilisateur
L'extension propose une interface moderne avec :
- **Section upload** : Zone de glisser-déposer pour les fichiers CSV
- **Status en temps réel** : Indication du statut de chargement
- **Bouton de remplissage** : Action principale avec feedback visuel
- **Statistiques détaillées** : Rapport complet avec métriques
- **Résultats détaillés** : Liste des champs traités
## đ Types de champs supportĂ©s
- â
**Champs texte** : input[type="text"], textarea
- â
**Emails** : input[type="email"]
- â
**Téléphones** : input[type="tel"]
- â
**Dates** : input[type="date"]
- â
**Sélections** : select, dropdown
- â
**Boutons radio** : input[type="radio"], role="radio"
- â
**Cases Ă cocher** : input[type="checkbox"], role="checkbox"
## đ Sites supportĂ©s
- **Google Forms** : Support complet avec sélecteurs optimisés
- **Formulaires génériques** : Détection automatique des champs
- **Pages locales** : Mode test pour le développement
## ïżœ DĂ©veloppement
### Structure du code
- `content.js` : Logique principale de détection et remplissage
- `popup.js` : Interface utilisateur et gestion CSV
- `background.js` : Gestion des permissions et communication
### Classes principales
- `FormDetector` : Détection des éléments de formulaire
- `FieldMatcher` : Correspondance intelligente des champs
- `FieldFiller` : Remplissage des différents types de champs
- `FormAutoFiller` : Orchestration principale
## ïżœ SĂ©curitĂ© et confidentialitĂ©
- â
**Données locales** : Aucune transmission de données
- â
**Permissions minimales** : AccĂšs uniquement aux onglets actifs
- â
**Code open source** : Transparence totale
- â
**Pas de tracking** : Aucune collecte de données
## đ DĂ©pannage
### ProblĂšmes courants
1. **Champs non remplis** :
- Vérifiez que votre CSV est correctement formaté
- Consultez la console pour les erreurs
2. **CSV non reconnu** :
- Vérifiez le nombre de colonnes (37 requis)
- Utilisez l'exemple fourni comme base
3. **Formulaire non détecté** :
- Actualisez la page
- Vérifiez que la page contient des formulaires
### Debug
Ouvrez la console développeur (F12) pour voir les logs détaillés :
- `[AutoFill]` : Messages de l'extension
- Statistiques de détection
- Erreurs de remplissage
## đ MĂ©triques
L'extension fournit des statistiques complĂštes :
- **Questions détectées** : Nombre total de champs trouvés
- **Champs remplis** : Nombre de champs complétés avec succÚs
- **Taux de réussite** : Pourcentage de réussite global
- **Détails par champ** : Statut individuel de chaque champ
## đ€ Contribution
Les contributions sont les bienvenues ! N'hésitez pas à :
1. Signaler des bugs
2. Proposer des améliorations
3. Soumettre des pull requests
4. Améliorer la documentation
## đ Licence
Ce projet est distribué sous licence MIT. Voir le fichier LICENSE pour plus de détails.
## đ Support
Pour obtenir de l'aide :
1. Consultez ce README et le `CSV_GUIDE.md`
2. Vérifiez les issues existantes
3. Créez une nouvelle issue si nécessaire
4. Incluez les logs de la console pour les bugs
---
**DĂ©veloppĂ© avec â€ïž pour simplifier le remplissage de formulaires web**
```