job_email_tracker

# Job Tracker

Useful for job seekers that get too many emails. A Drupal module suite that imports job-related emails from Gmail and displays them in an interactive dashboard, using Claude AI to analyze and summarize emails.

## Modules Included
- **Gmail Importer** - Connects to Gmail via OAuth, analyses emails with Claude AI
and saves job-related emails as Drupal nodes
- **Job Dashboard** - Interactive React-based dashboard for viewing and managing
imported job emails

## Requirements
- Drupal 10 or 11
- Gmail OAuth credentials (Google Cloud Console - Web Application type)
- Anthropic API key with purchased credits

## Anthropic API Credits
This module uses the Anthropic Claude API to analyse emails. You will need to:
1. Create an account at https://console.anthropic.com
2. Add a payment method and purchase credits
3. Even a small amount ($5-10) will process hundreds of emails
4. The module uses `claude-haiku-4-5` which is the most cost-effective model
5. Without credits the email analysis will fail silently and fall back to keyword matching

## Gmail OAuth Setup
1. Go to https://console.cloud.google.com
2. Create a new project
3. Enable the Gmail API
4. Create OAuth credentials - choose **Web Application** type (not Desktop)
5. Add your site URL as an Authorised redirect URI:
`https://yoursite.com/admin/config/services/gmail-importer/oauth`

## Private File System
Requires private file system configured in settings.php:
```php
$settings['file_private_path'] = '/path/to/private/files';
```

## Installation
1. Copy the `job_dashboard` and gmail_importer folders to your `web/modules/custom/` directory
2. Enable both modules:
`drush en gmail_importer job_dashboard`
3. Configure Gmail Importer at: /admin/config/services/gmail-importer
4. Add your OAuth Client ID and Secret
5. Add your Anthropic API key
6. Click Save & Authorize Gmail
7. Run the import — a link will appear on your front page automatically

## Content Types
Automatically installs the `email_record` content type with fields:
- Subject, Sender, Date, Body
- AI Summary (generated by Claude)
- Immediate Action flag
- Gmail ID (for duplicate detection)
- Read/Unread status
- Job Status

## Rate Limiting
The module processes emails in batches using Drupal's Batch API to avoid
hitting Anthropic API rate limits. If you experience rate limit errors,
check your Anthropic plan tier at console.anthropic.com.

## Notes
- Only emails identified as job-related are saved as nodes
- Duplicate emails are automatically skipped using Gmail message IDs
- The module falls back to keyword matching if the Claude API is unavailable
- A link to the dashboard and import button appears automatically on the front page