Tunisia SaaS - Système de Facturation Tunisien

Plateforme SaaS complète pour la gestion commerciale en Tunisie, conforme à la réglementation fiscale locale.

🚀 Fonctionnalités

Documents Commerciaux

• Devis : Création, envoi et conversion en factures/BL
• Factures : Standards, proforma, avoirs, acomptes
• Bons de Livraison : Avec suivi et conversion
• Export TEJ : Format XML conforme pour la déclaration fiscale

Gestion des Stocks

• Suivi en temps réel
• Alertes de stock bas
• Mouvements automatiques
• Inventaire et ajustements

Paiements & Trésorerie

• Enregistrement des paiements
• Gestion des chèques (émis/reçus)
• Effets de commerce avec échéanciers
• Relances et soldes clients

Point de Vente (POS)

• Interface rapide pour ventes comptant
• Impression tickets 80mm
• Codes-barres et recherche produits

Conformité Tunisienne

• TVA (19%, 13%, 7%)
• FODEC (1%)
• Timbre fiscal (0.600 TND max)
• Retenue à la source
• Matricule Fiscal, R.C., Code TVA

🛠️ Stack Technique

• Frontend : Next.js 14, React, TypeScript, Tailwind CSS
• Backend : Next.js Server Actions, Prisma ORM
• Base de données : PostgreSQL
• Authentification : NextAuth.js (à implémenter)
• State Management : Zustand, TanStack Query

📦 Installation

# Installer les dépendances
npm install

# Générer le client Prisma
npm run db:generate

# Configurer la base de données
cp .env.example .env
# Éditer .env avec vos paramètres

# Appliquer le schéma
npm run db:push

# Lancer le serveur de développement
npm run dev

🔧 Configuration

Variables d'environnement requises dans .env :

DATABASE_URL="postgresql://user:password@localhost:5432/tunisia_saas"
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"

📁 Structure du Projet

src/
├── app/                    # Next.js App Router
│   ├── (dashboard)/       # Pages dashboard protégées
│   ├── api/               # API routes
│   └── page.tsx           # Landing page
├── components/            # Composants React
│   ├── ui/               # UI components de base
│   ├── dashboard/        # Composants dashboard
│   └── forms/            # Formulaires
├── lib/                  # Utilitaires et logique métier
│   ├── actions/          # Server Actions
│   ├── prisma/           # Client Prisma
│   ├── validations/      # Schémas Zod
│   ├── finance.ts        # Calculs financiers
│   ├── tej-export.ts     # Export TEJ XML
│   └── pdf/              # Génération PDF
├── stores/               # Zustand stores
└── hooks/                # Custom React hooks
prisma/
└── schema.prisma         # Schéma de base de données

🇹🇳 Spécificités Tunisiennes

Taxes Implémentées

• TVA : Taxe sur la Valeur Ajoutée (19% standard, 7% et 13% réduits)
• FODEC : Fonds de Développement de la Compétitivité (1%)
• Timbre Fiscal : 1‰ du montant TTC, plafonné à 0.600 TND
• Retenue à la Source : Variable selon le client (0-15%)

Formats de Documents

• Factures numérotées séquentiellement par année
• Codes QR pour vérification
• Mentions légales obligatoires
• Export XML TEJ pour télédéclaration

📄 Licence

MIT License - voir LICENSE pour plus de détails.

👥 Contribution

Les contributions sont les bienvenues ! Merci de lire CONTRIBUTING.md avant de soumettre une PR.

📞 Support

Pour toute question ou assistance :

• Email: support@tunisia-saas.tn
• Documentation: https://docs.tunisia-saas.tn