Pour les développeurs

Workly est une application Next.js 16 (App Router, React 19, TypeScript) avec une base SQLite (better-sqlite3, Drizzle ORM, migrations SQL versionnées), Better Auth pour les comptes, Tailwind CSS 4 et des composants shadcn/ui. Deux processus de fond (worker et worker-modules) traitent le mail, les notifications, l’IA et la vidéo.

Lancer en local

npm ci
cp .env.example .env            # puis renseigner DATA_DIR, BETTER_AUTH_SECRET, SECRETS_KEYS
npm run db:migrate
npm run comptes -- lien-configuration
npm run dev                      # http://localhost:3100

Vérifier avant de livrer

npm run verifier     # types, lint, tests, build autonome
npm run mcp:check    # catalogue MCP à jour

Structure du dépôt

• src/app : routes (pages publiques, /[espace]/…, API) ; src/components : interface ; src/server : contexte, droits, dépôts et services ; src/lib : utilitaires partagés (temps, i18n, documentation).
• drizzle : migrations SQL ; scripts : CLI (comptes, migration, workers, sauvegarde) ; tests : Vitest ; deploy : unités systemd et scripts de la plateforme.
• AGENTS.md : règles à lire avant toute modification ; docs/ : cahier des charges, décisions techniques et guides par module.

Déploiement

La production tourne sur le VPS du propriétaire derrière sa plateforme personnelle : la branche main est déployée dans un conteneur qui récupère un artefact Next compilé sur le Mac et vérifie que les empreintes de toutes les sources correspondent au dépôt. Une différence refuse le build et conserve la version active. La base, les secrets et les workers restent sur l’hôte.