Add cron job functionality and Docker integration

CLAUDE.md

@@ -327,40 +327,57 @@ go run ./cmd/server
 # Run importer (one-time setup)
 go run ./cmd/importer
 
+# Run cron jobs manually
+go run ./cmd/cron -job=alerts          # Check and generate alerts
+go run ./cmd/cron -job=update-prices    # Recalculate all prices
+go run ./cmd/cron -job=reset-counters   # Reset usage counters
+go run ./cmd/cron -job=update-popularity # Update popularity scores
+
 # Build for production
 CGO_ENABLED=0 go build -ldflags="-s -w" -o bin/quoteforge ./cmd/server
+CGO_ENABLED=0 go build -ldflags="-s -w" -o bin/quoteforge-cron ./cmd/cron
 
 # Run tests
 go test ./...
+````
+
+## Cron Jobs
+
+QuoteForge now includes automated cron jobs for maintenance tasks. These can be run using the built-in cron functionality in the Docker container.
+
+### Docker Compose Setup
+
+The Docker setup includes a dedicated cron service that runs the following jobs:
+
+- **Alerts check**: Every hour (0 * * * *)
+- **Price updates**: Daily at 2 AM (0 2 * * *)
+- **Usage counter reset**: Weekly on Sunday at 1 AM (0 1 * * 0)
+- **Popularity score updates**: Daily at 3 AM (0 3 * * *)
+
+### Manual Cron Job Execution
+
+You can also run cron jobs manually using the quoteforge-cron binary:
+
+```bash
+# Check and generate alerts
+go run ./cmd/cron -job=alerts
+
+# Recalculate all prices
+go run ./cmd/cron -job=update-prices
+
+# Reset usage counters
+go run ./cmd/cron -job=reset-counters
+
+# Update popularity scores
+go run ./cmd/cron -job=update-popularity
 ```
 
-## Dependencies (go.mod)
+### Cron Job Details
 
-```go
-module git.mchus.pro/mchus/quoteforge
-
-go 1.22
-
-require (
-    github.com/gin-gonic/gin v1.9.1
-    github.com/go-sql-driver/mysql v1.7.1
-    gorm.io/gorm v1.25.5
-    gorm.io/driver/mysql v1.5.2
-    github.com/xuri/excelize/v2 v2.8.0
-    github.com/golang-jwt/jwt/v5 v5.2.0
-    github.com/google/uuid v1.5.0
-    golang.org/x/crypto v0.17.0
-    gopkg.in/yaml.v3 v3.0.1
-)
-```
-
-## Development Priorities
-
-1. **Phase 1 (MVP):** Project setup, models, component API, basic UI, CSV export
-2. **Phase 2:** JWT auth with roles, pricing admin UI, all price methods
-3. **Phase 3:** Save/load configs, JSON import/export, XLSX export, cron jobs
-4. **Phase 4:** Usage stats, alerts system, dashboard
-5. **Phase 5:** Polish, tests, Docker, documentation
+- **Alerts check**: Generates alerts for components with high demand and stale prices, trending components without prices, and components with no recent quotes
+- **Price updates**: Recalculates prices for all components using configured methods (median, weighted median, average)
+- **Usage counter reset**: Resets weekly and monthly usage counters for components
+- **Popularity score updates**: Recalculates popularity scores based on supplier quote activity
 
 ## Code Style