Skip to content

AlexVWeb/cotis

Repository files navigation

🪙 Cotis (Beta)

Cotis est une plateforme de gestion financière intuitive conçue spécifiquement pour les micro-entrepreneurs (auto-entrepreneurs). Elle simplifie le suivi des revenus, le calcul des cotisations sociales et la surveillance des seuils fiscaux.


✨ Fonctionnalités Clés

  • 📦 Gestion des Transactions : Enregistrez vos ventes, prestations de services et activités libérales.
  • 🧮 Moteur de Calcul URSSAF : Estimation automatique de vos cotisations en temps réel (taux standard, ACRE, versement libératoire).
  • 📊 Dashboard "Net Pocket" : Visualisez instantanément ce qu'il vous reste réellement après prélèvements.
  • 🚨 Moniteur de Seuils : Jauges visuelles pour les plafonds de franchise de TVA (39 100 € / 91 900 €) et de la Micro-Entreprise.
  • 📅 Gestion de Périodicité : Support des déclarations mensuelles et trimestrielles.
  • 📄 Assistant à la Déclaration : Récapitulatif précis des chiffres à reporter sur le site de l'URSSAF.
  • 💾 Export de Données : Exportez vos données en format CSV ou JSON.
  • 🔒 Sécurité Moderne : Authentification fluide avec support de l'authentification à deux facteurs (2FA).

🛠️ Stack Technique

📂 Structure du Projet

  • app/ : Pages et layouts (App Router Next.js)
  • components/ : Composants React réutilisables (UI shadcn, features, etc.)
  • lib/ : Utilitaires, hooks, configuration de base de données (Prisma) et logique métier partagée
  • actions/ : Server Actions pour la mutation de données
  • prisma/ : Schéma de base de données et migrations
  • public/ : Assets statiques

🚀 Installation

Prérequis

Étapes d'installation

  1. Cloner le projet :

    git clone https://github.com/votre-repo/cotis.git
    cd cotis
  2. Installer les dépendances :

    bun install
  3. Configurer l'environnement : Créez un fichier .env à la racine et configurez les variables nécessaires (voir section configuration).

  4. Initialiser la base de données :

    bunx prisma db push
  5. Lancer le serveur de développement :

    bun run dev

Accédez à l'application via http://localhost:3000.

📜 Scripts Disponibles

  • bun run dev : Lance le serveur de développement
  • bun run build : Compile l'application pour la production
  • bun run start : Lance l'application en production
  • bun run lint : Vérifie le code avec ESLint
  • bun run format:write : Formate le code avec Prettier
  • bun test : Lance les tests unitaires

⚙️ Configuration (.env)

Variable Description
DATABASE_URL Chemin vers la base SQLite (ex: file:./dev.db)
BETTER_AUTH_SECRET Secret pour l'authentification
BETTER_AUTH_URL URL de base de l'app (ex: http://localhost:3000)

🧪 Tests

Pour lancer la suite de tests avec Vitest :

bun test
# ou pour le mode watch
bun run vitest

🗺️ Roadmap

Consultez le fichier roadmap.md pour suivre l'évolution des fonctionnalités.


📄 Licence

Projet privé - Tous droits réservés.

About

Cotis est une plateforme de gestion financière intuitive conçue spécifiquement pour les micro-entrepreneurs (auto-entrepreneurs). Elle simplifie le suivi des revenus, le calcul des cotisations sociales et la surveillance des seuils fiscaux.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors