update

docs/ADMIN_API.md

@@ -100,6 +100,56 @@ curl -X POST http://localhost:5001/api/admin/send-test-email \
 
 ---
 
+### Send Newsletter to All Subscribers
+
+Send newsletter to all active subscribers in the database.
+
+```http
+POST /api/admin/send-newsletter
+```
+
+**Request Body** (optional):
+```json
+{
+  "max_articles": 10
+}
+```
+
+**Parameters**:
+- `max_articles` (integer, optional): Number of articles to include (1-50, default: 10)
+
+**Response**:
+```json
+{
+  "success": true,
+  "message": "Newsletter sent successfully to 45 subscribers",
+  "subscriber_count": 45,
+  "max_articles": 10,
+  "output": "... sender output ...",
+  "errors": ""
+}
+```
+
+**Example**:
+```bash
+# Send newsletter to all subscribers
+curl -X POST http://localhost:5001/api/admin/send-newsletter \
+  -H "Content-Type: application/json"
+
+# Send with custom article count
+curl -X POST http://localhost:5001/api/admin/send-newsletter \
+  -H "Content-Type: application/json" \
+  -d '{"max_articles": 15}'
+```
+
+**Notes**:
+- Only sends to subscribers with `status: 'active'`
+- Returns error if no active subscribers found
+- Includes tracking pixels and click tracking
+- May take several minutes for large subscriber lists
+
+---
+
 ### Get System Statistics
 
 Get overview statistics of the system.
@@ -156,12 +206,32 @@ curl -X POST http://localhost:5001/api/admin/trigger-crawl \
 sleep 30
 curl http://localhost:5001/api/admin/stats
 
-# 4. Send test email
+# 4. Send test email to yourself
 curl -X POST http://localhost:5001/api/admin/send-test-email \
   -H "Content-Type: application/json" \
   -d '{"email": "your-email@example.com"}'
 ```
 
+### Send Newsletter to All Subscribers
+
+```bash
+# 1. Check subscriber count
+curl http://localhost:5001/api/admin/stats | jq '.subscribers'
+
+# 2. Crawl fresh articles
+curl -X POST http://localhost:5001/api/admin/trigger-crawl \
+  -H "Content-Type: application/json" \
+  -d '{"max_articles": 10}'
+
+# 3. Wait for crawl to complete
+sleep 60
+
+# 4. Send newsletter to all active subscribers
+curl -X POST http://localhost:5001/api/admin/send-newsletter \
+  -H "Content-Type: application/json" \
+  -d '{"max_articles": 10}'
+```
+
 ### Quick Test Newsletter
 
 ```bash
@@ -180,6 +250,28 @@ curl -X POST http://localhost:5001/api/admin/trigger-crawl \
   -d '{"max_articles": 20}'
 ```
 
+### Daily Newsletter Workflow
+
+```bash
+# Complete daily workflow (can be automated with cron)
+
+# 1. Crawl today's articles
+curl -X POST http://localhost:5001/api/admin/trigger-crawl \
+  -H "Content-Type: application/json" \
+  -d '{"max_articles": 15}'
+
+# 2. Wait for crawl and AI processing
+sleep 120
+
+# 3. Send to all subscribers
+curl -X POST http://localhost:5001/api/admin/send-newsletter \
+  -H "Content-Type: application/json" \
+  -d '{"max_articles": 10}'
+
+# 4. Check results
+curl http://localhost:5001/api/admin/stats
+```
+
 ---
 
 ## Error Responses