fasto/README.md

Fasto

Fasto is a multi-tenant commercial team management system for tracking sales attendance, seller performance, funnels, lead origins, and external n8n/AI integrations.

Stack

• Frontend: React, TypeScript, Vite, TailwindCSS, Recharts, Lucide React
• Backend: Node.js, Express, MySQL2, Nodemailer
• Database: MySQL 8
• Local runtime: Docker Compose

Local Setup

Copy the environment template and adjust values:

cp .env.example .env

Start the app and database:

docker-compose -f docker-compose.local.yml up -d --build

The app runs at http://localhost:3001.

For frontend-only development:

npm install
npm run dev

The Vite dev server runs at http://localhost:3000 and calls the backend at http://localhost:3001/api.

Notes

• JWT_SECRET is required in production.
• Set CORS_ORIGIN in production if the frontend is served from a different origin.
• Backend startup currently applies non-destructive schema updates for existing deployments.
• See CONTEXT.md for the fuller architecture and project history.