Cron Scheduler: Pubblicazione Infinita
Il Motore di ArtiFlow
Il Cron Scheduler è il cuore pulsante di ArtiFlow. Mentre tu dormi, lui scrive. Mentre tu lavori, lui pubblica. 24/7 content production.
Un sistema di automazione intelligente che genera idee, scrive articoli e pubblica contenuti senza intervento umano.
⚡ Cron Architecture
System Overview
Cron Job → API Endpoint → Firebase → AI Engine → Content Generation Flow: 1. External cron triggers /api/cron 2. Validates auth and user context 3. Reads user config from Firebase 4. Executes scheduled jobs (ideas + writing) 5. Updates timestamps and status 6. Returns execution results Result: Continuous content pipeline
🔄 External Trigger
Cron-job.org o sistema simile che chiama l'endpoint ogni X minuti.
🧠 Smart Scheduler
Logica intelligente che decide quando eseguire job basandosi su giorni, orari e frequenza.
✍️ Content Engine
AI writing engine che genera idee e articoli di qualità.
⚙️ Configuration Deep Dive
📊 Database Structure
Configurazione salvata in Firebase:
Path: users/{uid}/config/agente
Document Structure:
{
"cron_scheduler": {
"generic": {
"ideas": {
"enabled": true,
"days": ["Mon", "Wed", "Fri"],
"workHours": {
"start": "09:00",
"end": "18:00"
},
"frequency": "120",
"last_run": "2026-01-15T10:30:00Z"
},
"writing": {
"enabled": true,
"days": ["Tue", "Thu"],
"workHours": {
"start": "10:00",
"end": "17:00"
},
"frequency": "180",
"last_run": "2026-01-15T11:00:00Z"
}
}
}
}🎯 Parameter Explanation
🚀 Production Setup
🌐 Cron-job.org Configuration
Setup per production environment:
Cron-job.org Setup:
1. Create new cron job
2. URL: https://yourdomain.com/api/cron
3. Method: GET
4. Headers:
Authorization: Bearer {CRON_SECRET}
x-user-id: {USER_ID}
5. Schedule: */15 * * * * (every 15 minutes)
6. Notifications: On failure
7. Timeout: 60 seconds
Status: Active ✅🔧 Environment Variables
Variabili necessarie in .env.local:
.env.local Configuration: CRON_SECRET=your-super-secure-secret-key FIREBASE_API_KEY=your-firebase-api-key FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com FIREBASE_PROJECT_ID=your-project-id FIREBASE_STORAGE_BUCKET=your-project.appspot.com FIREBASE_MESSAGING_SENDER_ID=123456789 FIREBASE_APP_ID=1:123456789:web:abcdef Security: Never commit to Git! 🔐
📈 Advanced Scheduling Strategies
🎯 High-Frequency Strategy
Ideas: Every 2 hours (8x/day) ├── Days: Mon, Wed, Fri, Sat, Sun ├── Hours: 08:00 - 22:00 └── Expected: 40 ideas/week Writing: Every 3 hours (6x/day) ├── Days: Tue, Thu, Sat ├── Hours: 09:00 - 18:00 └── Expected: 18 articles/week Total: 58 pieces of content/week
⚡ Burst Strategy
Ideas: Every 30 min (32x/day) ├── Days: Mon-Fri ├── Hours: 09:00 - 17:00 └── Expected: 160 ideas/week Writing: Every 60 min (8x/day) ├── Days: Mon, Wed, Fri ├── Hours: 10:00 - 16:00 └── Expected: 24 articles/week Total: 184 pieces/week (aggressive)
🔍 Monitoring & Analytics
Performance Metrics
Uptime
Avg response time
Articles/week
Error rate
⚠️ Troubleshooting Guide
❌ Cron Not Executing
Check: CRON_SECRET, x-user-id header, URL accessibility, firewall.
⚠️ Jobs Not Running
Check: enabled=true, correct days, workHours, frequency, last_run timestamp.
🔄 Rate Limiting
Check: API rate limits, Firebase quotas, external service limits.
✅ Performance Issues
Check: Database queries, AI response times, network latency.
🎯 Best Practices
🔐 Security
- • Use strong CRON_SECRET
- • Rotate secrets monthly
- • Monitor access logs
- • HTTPS only
⚡ Performance
- • Optimize Firebase queries
- • Cache AI responses
- • Monitor response times
- • Set appropriate timeouts
📊 Reliability
- • Retry failed jobs
- • Log all executions
- • Alert on failures
- • Backup configurations
🔄 Scalability
- • Load balance multiple servers
- • Queue system for high volume
- • Database sharding
- • CDN for static assets