Merge pull request #93 from bscott/v0.5.5

v0.5.5 - Pushover Notifications, BDT Currency, and Cancellation Reminders

Author: bscott

.beads/issues.jsonl

@@ -1,2 +1,9 @@
+{"id":"subtrackr-xyz-1fb","title":"Implement cancellation date email notifications (#88)","description":"Add email notification option for X days before cancellation date. User wants reminders to cancel subscriptions before renewal. Fits with Pushover notifications already added in v0.5.5.","status":"closed","priority":2,"issue_type":"feature","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:32:20.604827-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:42:20.912338-08:00","closed_at":"2026-02-01T18:42:20.912338-08:00","close_reason":"Issue #88 implementation complete: cancellation date notifications fully implemented"}
+{"id":"subtrackr-xyz-255","title":"Add cancellation reminder fields to models","description":"Add CancellationReminders and CancellationReminderDays to NotificationSettings. Add LastCancellationReminderSent and LastCancellationReminderDate to Subscription model. Files: internal/models/settings.go, internal/models/subscription.go","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.632633-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:42:20.925084-08:00","closed_at":"2026-02-01T18:42:20.925084-08:00","close_reason":"Issue #88 implementation complete: cancellation date notifications fully implemented"}
 {"id":"subtrackr-xyz-3gh","title":"Fix Tab and PWA icon missing (#84)","description":"Tab favicon and PWA icon are not displaying in Firefox and Safari. Need to configure proper favicon/manifest icons.","status":"closed","priority":2,"issue_type":"bug","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-01-22T18:21:09.631203-08:00","created_by":"Brian Scott","updated_at":"2026-01-22T18:26:02.363767-08:00","closed_at":"2026-01-22T18:26:02.363767-08:00","close_reason":"Implemented in v0.5.3"}
+{"id":"subtrackr-xyz-4ma","title":"Add repository method for upcoming cancellations","description":"Add GetUpcomingCancellations(days int) method to query subscriptions with cancellation dates approaching. File: internal/repository/subscription.go","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.768444-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:42:20.95075-08:00","closed_at":"2026-02-01T18:42:20.95075-08:00","close_reason":"Issue #88 implementation complete: cancellation date notifications fully implemented"}
+{"id":"subtrackr-xyz-5ls","title":"Add cancellation reminder service methods","description":"Add GetSubscriptionsNeedingCancellationReminders(), SendCancellationReminder() to subscription, email, and pushover services. Files: internal/service/subscription.go, email.go, pushover.go","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.827689-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:40:33.13865-08:00","closed_at":"2026-02-01T18:40:33.13865-08:00","close_reason":"Added SendCancellationReminder methods to email and pushover services","dependencies":[{"issue_id":"subtrackr-xyz-5ls","depends_on_id":"subtrackr-xyz-255","type":"blocks","created_at":"2026-02-01T18:33:58.079731-08:00","created_by":"Brian Scott"},{"issue_id":"subtrackr-xyz-5ls","depends_on_id":"subtrackr-xyz-4ma","type":"blocks","created_at":"2026-02-01T18:33:58.148998-08:00","created_by":"Brian Scott"}]}
+{"id":"subtrackr-xyz-8gh","title":"Add cancellation reminder settings UI","description":"Add settings handlers and UI for cancellation reminder preferences. Files: internal/handlers/settings.go, templates/settings.html","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.941374-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:42:16.382596-08:00","closed_at":"2026-02-01T18:42:16.382596-08:00","close_reason":"Added cancellation reminder settings UI to handlers and template","dependencies":[{"issue_id":"subtrackr-xyz-8gh","depends_on_id":"subtrackr-xyz-uzq","type":"blocks","created_at":"2026-02-01T18:33:58.280161-08:00","created_by":"Brian Scott"}]}
+{"id":"subtrackr-xyz-lw5","title":"Add database migration for cancellation tracking","description":"Create migration to add last_cancellation_reminder_sent and last_cancellation_reminder_date columns to subscriptions table. File: internal/database/migrations.go","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.709756-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:42:20.938383-08:00","closed_at":"2026-02-01T18:42:20.938383-08:00","close_reason":"Issue #88 implementation complete: cancellation date notifications fully implemented","dependencies":[{"issue_id":"subtrackr-xyz-lw5","depends_on_id":"subtrackr-xyz-255","type":"blocks","created_at":"2026-02-01T18:33:57.997065-08:00","created_by":"Brian Scott"}]}
 {"id":"subtrackr-xyz-tqp","title":"Remember sorting preference (#85)","description":"Persist user's subscription list sort preference to localStorage so it remembers their choice between sessions","status":"closed","priority":2,"issue_type":"feature","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-01-22T18:21:09.459913-08:00","created_by":"Brian Scott","updated_at":"2026-01-22T18:26:02.362337-08:00","closed_at":"2026-01-22T18:26:02.362337-08:00","close_reason":"Implemented in v0.5.3"}
+{"id":"subtrackr-xyz-uzq","title":"Add cancellation reminder scheduler","description":"Add checkAndSendCancellationReminders() function and integrate with daily scheduler. File: cmd/server/main.go","status":"closed","priority":2,"issue_type":"task","owner":"191290+bscott@users.noreply.github.com","created_at":"2026-02-01T18:33:40.884483-08:00","created_by":"Brian Scott","updated_at":"2026-02-01T18:41:11.679802-08:00","closed_at":"2026-02-01T18:41:11.679802-08:00","close_reason":"Added cancellation reminder scheduler and checker functions to main.go","dependencies":[{"issue_id":"subtrackr-xyz-uzq","depends_on_id":"subtrackr-xyz-5ls","type":"blocks","created_at":"2026-02-01T18:33:58.214037-08:00","created_by":"Brian Scott"}]}

AGENTS.md

@@ -44,7 +44,7 @@ subtrackr-xyz/
 
 #### 2. Handlers (`internal/handlers/`)
 - **subscription.go**: CRUD operations for subscriptions
-- **settings.go**: SMTP config, notifications, API keys, currency, dark mode
+- **settings.go**: SMTP config, Pushover config, notifications, API keys, currency, dark mode
 - **category.go**: Category management
 
 #### 3. Services (`internal/service/`)
@@ -53,13 +53,16 @@ subtrackr-xyz/
 - **settings.go**: Settings management
 - **category.go**: Category operations
 - **currency.go**: Currency conversion (Fixer.io integration)
+- **email.go**: Email notification service (SMTP)
+- **pushover.go**: Pushover notification service
 
 #### 4. Models (`internal/models/`)
 - GORM models:
   - `Subscription`: Main subscription entity
   - `Category`: Subscription categories
   - `Settings`: Application settings (key-value store)
   - `SMTPConfig`: Email configuration
+  - `PushoverConfig`: Pushover notification configuration
   - `APIKey`: API authentication keys
   - `ExchangeRate`: Currency exchange rates
 
@@ -122,12 +125,20 @@ subtrackr-xyz/
    - Renewal reminders
    - High cost alerts
 
-3. **Currency Support**
-   - USD, EUR, GBP, JPY, RUB, SEK, PLN, INR
+3. **Pushover Notifications**
+   - Pushover API integration for mobile push notifications
+   - User Key and Application Token configuration
+   - Renewal reminders (same settings as email)
+   - High cost alerts (same threshold as email)
+   - Works alongside email notifications
+
+4. **Currency Support**
+   - USD, EUR, GBP, JPY, RUB, SEK, PLN, INR, CHF, BRL, COP, BDT
    - Optional Fixer.io integration for real-time rates
    - Automatic conversion display
+   - BDT (Bangladeshi Taka) with ৳ symbol
 
-4. **API Access**
+5. **API Access**
    - API key authentication
    - RESTful endpoints
    - JSON responses
@@ -218,9 +229,19 @@ This project uses versioned branches for releases. See `CLAUDE.md` for the compl
 4. Update date calculation logic if needed
 
 #### Adding a New Currency
-1. Update currency service with new symbol
-2. Add to currency selection in settings template
-3. Update exchange rate handling if using Fixer.io
+1. Add currency code to `SupportedCurrencies` in `internal/service/currency.go`
+2. Add currency symbol mapping in `GetCurrencySymbol()` in `internal/service/settings.go`
+3. Add currency option to currency selection in `templates/settings.html`
+4. Update exchange rate handling if using Fixer.io
+
+#### Adding a New Notification Method
+1. Create notification config model in `internal/models/settings.go`
+2. Create notification service in `internal/service/` (e.g., `pushover.go`)
+3. Add config save/get methods to `SettingsService`
+4. Add handlers in `internal/handlers/settings.go`
+5. Add UI in `templates/settings.html`
+6. Update subscription handler to send notifications
+7. Update renewal reminder scheduler in `cmd/server/main.go`
 
 ### Environment Variables
 

README.md

@@ -51,9 +51,10 @@ Themes persist across all pages and are saved per user. Change themes anytime fr
 - 📅 **Calendar View**: Visual calendar showing all subscription renewal dates with iCal export
 - 📈 **Analytics**: Visualize spending by category and track savings
 - 🔔 **Email Notifications**: Get reminders before subscriptions renew
+- 📱 **Pushover Notifications**: Receive push notifications on your mobile device
 - 📤 **Data Export**: Export your data as CSV, JSON, or iCal format
 - 🎨 **Beautiful Themes**: 5 stunning themes including a festive Christmas theme with snowfall animation
-- 🌍 **Multi-Currency Support**: Support for USD, EUR, GBP, JPY, RUB, SEK, PLN, and INR (with optional real-time conversion)
+- 🌍 **Multi-Currency Support**: Support for USD, EUR, GBP, JPY, RUB, SEK, PLN, INR, CHF, BRL, COP, and BDT (with optional real-time conversion)
 - 🐳 **Docker Ready**: Easy deployment with Docker
 - 🔒 **Self-Hosted**: Your data stays on your server
 - 📱 **Mobile Responsive**: Optimized mobile experience with hamburger menu navigation
@@ -251,7 +252,7 @@ SubTrackr supports automatic currency conversion using Fixer.io exchange rates:
 
 **Note:** The free Fixer.io plan only allows EUR as the base currency. SubTrackr automatically handles cross-rate calculations (e.g., USD→INR goes through EUR) so all currency conversions work correctly regardless of this limitation.
 
-**Supported currencies:** USD, EUR, GBP, JPY, RUB, SEK, PLN, INR
+**Supported currencies:** USD, EUR, GBP, JPY, RUB, SEK, PLN, INR, CHF, BRL, COP, BDT
 
 ### Email Notifications (SMTP)
 
@@ -265,6 +266,27 @@ Configure SMTP settings in the web interface:
 3. Test connection
 4. Enable renewal reminders
 
+### Pushover Notifications
+
+Receive push notifications on your mobile device via Pushover:
+
+1. **Get your Pushover credentials**:
+   - Sign up at [pushover.net](https://pushover.net/) (free account)
+   - Get your User Key from the dashboard
+   - Create an application at [pushover.net/apps/build](https://pushover.net/apps/build) to get an Application Token
+
+2. **Configure in SubTrackr**:
+   - Navigate to Settings → Pushover Notifications
+   - Enter your User Key and Application Token
+   - Click "Test Connection" to verify configuration
+   - Save settings
+
+3. **Notification Types**:
+   - **Renewal Reminders**: Get notified before subscriptions renew (uses the same reminder days setting as email)
+   - **High Cost Alerts**: Receive alerts when adding expensive subscriptions (uses the same threshold as email alerts)
+
+**Note**: Pushover notifications work alongside email notifications. Both will be sent when enabled, giving you multiple ways to stay informed about your subscriptions.
+
 ### Data Persistence
 
 **Important**: Always mount a volume to `/app/data` to persist your database!