sepehr
8f96ddfe71
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 2m31s
User said 'I want this to be automatic'. Three gaps were addressed.
Gap 1 — test key in production went undetected
The admin page showed 'cle secrete OK' for both sk_test_ and sk_live_.
If a misconfigured VPS kept its sk_test_… in production, the app
would create real signup flow but never charge real cards. Added
services.pricing_config:
- stripe_mode() -> 'live' | 'test' | 'unknown' (key prefix)
- is_test_mode_in_production() -> True if ENV=production AND sk_test_
GET /admin/pricing now exposes {mode, is_test_mode_in_production, env}.
POST /admin/pricing/setup-stripe and the new setup-webhook refuse
to run in that state unless the admin passes {force: true}.
Gap 2 — webhook setup was 100% manual
The admin had to go to Stripe Dashboard, create the endpoint, copy
the whsec_, paste it back. Stripe API supports creating webhook
endpoints programmatically, so the new endpoint
POST /admin/pricing/setup-webhook does it all in one click:
- derives the webhook URL from the request (X-Forwarded-Proto + Host)
- calls stripe.WebhookEndpoint.create() (or .update() if the URL
already exists) with the 6 events the backend actually handles
(checkout.session.completed, customer.subscription.*, invoice.*)
- persists the returned whsec_ to .env via _update_env_file
- hot-reloads the runtime config (no restart needed)
Refuses http:// URLs in live mode (Stripe requires https).
Gap 3 — obsolete script leaked a test secret
scripts/stripe_setup.py contained a hardcoded sk_test_… in source.
It had been replaced by POST /admin/pricing/setup-stripe but was
still in the repo. Deleted via git rm. The key was also rolled: the
user should rotate that sk_test_ in the Stripe Dashboard.
Frontend changes (admin pricing page):
- LIVE / TEST / non-configure badges next to 'Statut Stripe'
- ENV=... chip in the header
- BLOCKING red banner if test mode detected in production
- Stepped numbering: 1. Produits & prix / 2. Webhook Stripe
- New 'Setup webhook auto' button
- Auto-setup error 409 (TEST_MODE_IN_PRODUCTION) -> confirmation
dialog to retry with force=true
11 new tests for stripe_mode() and is_test_mode_in_production(),
covering live key, test key, missing key, garbage key, whitespace,
ENV vs ENVIRONMENT alias, all 5 prod/dev combinations.
Total: 471 tests pass (was 460), zero regression.
📄 Wordly.art — Document Translation Portal
Wordly.art est une application complète et prête pour la production (SaaS-ready) permettant de traduire des documents bureautiques complexes (Excel, Word, PowerPoint) tout en préservant strictement la mise en page originale, le style, les formules et les médias intégrés.
Ce fichier sert de portail central pour accéder à toutes les documentations techniques, guides d'exploitation, de déploiement et de secours de l'application.
🗺️ Carte de la Documentation
Pour faciliter la navigation, utilisez les liens ci-dessous pour accéder directement aux guides spécialisés :
🚀 Démarrage & Utilisation
- 📥 Guide de démarrage rapide (QUICKSTART.md) : Installation locale et lancement du projet en développement.
- 📖 Guide d'utilisation de l'API (GUIDE_UTILISATION.md) : Exemples de requêtes de traduction, gestion du glossaire et des presets techniques (CVC, IT, Légal, etc.).
- 💡 Fiche de référence rapide (QUICK_REFERENCE.md) : Commandes utiles, ports réseaux, identifiants par défaut et astuces rapides.
🏗️ Architecture & Conception
- 📐 Architecture logicielle (ARCHITECTURE.md) : Choix technologiques, flux de données, gestion du cycle de vie des fichiers, sécurité (HSTS, CSP) et monitoring.
🌐 Déploiement en Production
- 🏢 Guide de Déploiement Général (DEPLOYMENT_GUIDE.md) : Guide standard pour le déploiement de production sous Docker avec reverse-proxy Nginx et SSL.
- ☁️ Déploiement sur IONOS (DEPLOY_IONOS.md) : Instructions spécifiques pour déployer l'infrastructure sur un serveur virtuel IONOS.
🛡️ Sauvegarde, Résilience & Secours (Disaster Recovery)
- 💾 Plan de Reprise d'Activité (DISASTER_RECOVERY.md) : Guide complet du système de sauvegarde automatique vers le NAS via SSH/rsync, monitoring et automatisation du failover.
- 🔄 Procédure de Restauration Simplifiée (PROCEDURE_RESTAURATION.md) : Guide d'urgence pas-à-pas pour restaurer les données sur le serveur actif ou basculer en 20 minutes sur le serveur de secours (
.98).
✨ Fonctionnalités Clés
🔄 Multi-fournisseurs de Traduction
L'application supporte 7 moteurs de traduction, activables à la volée :
- Google Translate (Gratuit, rapide, par défaut)
- DeepL API (Haute qualité pour l'entreprise)
- OpenAI (Modèles GPT-4o, support de la vision)
- DeepSeek, OpenRouter, Minimax, x.ai (Zai) (Modèles de pointe pour traductions complexes)
📁 Traduction Intelligente par Fichier
- Excel (.xlsx) : Conserve la fusion des cellules, les formules, les polices de caractères, les styles de bordures et traduit également le texte contenu dans les images (via modèles vision).
- Word (.docx) : Préserve les en-têtes, pieds de page, tableaux, listes à puces et la mise en forme des paragraphes.
- PowerPoint (.pptx) : Conserve la mise en page des diapositives, les animations et transitions.
🏢 Sécurité & Exploitation (SaaS-Ready)
- 🚦 Limitation de débit (Rate Limiting) : Par IP client avec algorithme Token Bucket stocké dans Redis.
- 🧹 Nettoyage automatique (Auto Cleanup) : Suppression automatique des fichiers temporaires après expiration de la durée de vie (TTL).
- 📊 Monitoring complet : Route
/healthdétaillée et intégration Prometheus + Grafana pour suivre les performances physiques et logicielles.
🛠️ Stack Technique
Backend
- FastAPI (Python 3.11+) : API asynchrone rapide et documentée (Swagger disponible sur
http://localhost:8000/docs). - openpyxl, python-docx, python-pptx : Moteurs de manipulation de documents sans dépendance Microsoft Office.
- Docker / Docker Compose : Isolation complète de l'application, de la base PostgreSQL et du cache Redis.
Frontend
- Next.js 15 (React) & Tailwind CSS : Interface utilisateur moderne, ergonomique et responsive.
- Lucide Icons : Bibliothèque d'icônes vectorielles.
🚀 Lancement Rapide (Mode Dev)
Pour un déploiement complet en production ou homelab, veuillez vous référer aux fichiers de déploiement listés dans la Carte de la Documentation.
# 1. Cloner le projet
git clone https://gitea.parsanet.org/sepehr/office_translator.git /opt/wordly
cd /opt/wordly
# 2. Configurer l'environnement
cp .env.example .env
# Modifiez les variables dans le .env selon vos besoins
# 3. Lancer avec Docker Compose
docker compose up -d --build
- API (Backend) :
http://localhost:8000(Documentation Swagger sur/docs) - Interface Web (Frontend) :
http://localhost:3000