Кормушка: последняя выдача, кнопка Пожертвовать, DONATE_SETUP

- feed_service: сохранение last_dispense_at при успешной выдаче (MQTT/ESPHome)
- API /feed/info: last_dispense_at, donate_url
- FeedCard: отображение времени выдачи, кнопка Пожертвовать (всегда как заглушка)
- general.donate_url в конфиге и настройках
- docs/DONATE_SETUP.md — подсказки по Boosty, DonationAlerts, Ko-fi
- docs/FEED_LAST_DISPENSE.md — время последней выдачи

Made-with: Cursor

Author: gfer

app/app_config/default_config.yaml

@@ -8,6 +8,8 @@ general:
   contributor_password: ""
   # Ссылка на установку BirdNET (BirdNET-Pi, BirdNET-Go). Пусто — иконка BirdNET не показывается.
   birdnet_url: ""
+  # Ссылка на страницу пожертвований (Ko-fi, Buy Me a Coffee и т.д.). Пусто — кнопка не показывается.
+  donate_url: ""
 
 # Video/Audio processor settings
 processor:

app/ui/locales/en.json

@@ -113,6 +113,8 @@
     "mqttHaDiscoveryHint": "Publish configs so HA auto-discovers Last Species, Bird at Feeder, etc.",
     "birdnetUrl": "BirdNET installation URL",
     "birdnetUrlHint": "URL to BirdNET-Pi/Go. Empty — icon hidden.",
+    "donateUrl": "Donation page URL",
+    "donateUrlHint": "Boosty, DonationAlerts (RU). Ko-fi, Buy Me a Coffee. Button always visible as placeholder.",
     "go2rtcUrl": "Go2RTC URL",
     "go2rtcUrlHint": "Host: http://IP:1984",
     "go2rtcUser": "Go2RTC login",
@@ -425,7 +427,10 @@
     "feederControl": "Feeder Control",
     "dispenseFeed": "Dispense Feed",
     "dispensing": "Dispensing...",
-    "feedDispensed": "Feed dispensed"
+    "feedDispensed": "Feed dispensed",
+    "lastDispense": "Last dispense",
+    "donate": "Donate",
+    "donatePlaceholder": "Donate (set URL in Settings)"
   },
   "speciesSummary": {
     "totalDetectionStats": "Total Detection Stats",

app/ui/locales/ru.json

@@ -113,6 +113,8 @@
     "mqttHaDiscoveryHint": "Публиковать config для автообнаружения HA (Last Species, Bird at Feeder и др.)",
     "birdnetUrl": "Ссылка на BirdNET",
     "birdnetUrlHint": "URL установки BirdNET-Pi/Go. Пусто — иконка не показывается.",
+    "donateUrl": "Ссылка на пожертвования",
+    "donateUrlHint": "Boosty, DonationAlerts, DONAT24 (РФ). Ko-fi, Buy Me a Coffee — за рубежом. Кнопка всегда видна как заглушка.",
     "go2rtcUrl": "Go2RTC URL",
     "go2rtcUrlHint": "Хост: http://IP:1984",
     "go2rtcUser": "Go2RTC логин",
@@ -425,7 +427,10 @@
     "feederControl": "Управление кормушкой",
     "dispenseFeed": "Выдать корм",
     "dispensing": "Выдача...",
-    "feedDispensed": "Корм выдан"
+    "feedDispensed": "Корм выдан",
+    "lastDispense": "Последняя выдача",
+    "donate": "Пожертвовать",
+    "donatePlaceholder": "Пожертвовать (укажите ссылку в Настройках)"
   },
   "speciesSummary": {
     "totalDetectionStats": "Статистика обнаружений",

app/ui/src/api/api.tsx

@@ -259,6 +259,14 @@ export const fetchStatus = async (): Promise<{
   return response.data;
 };
 
+export const fetchFeedInfo = async (): Promise<{
+  last_dispense_at: string | null;
+  donate_url: string | null;
+}> => {
+  const response = await axios.get(`${BASE_API_URL}/feed/info`);
+  return response.data;
+};
+
 export const dispenseFeed = async (): Promise<{ success: boolean; message?: string }> => {
   try {
     const response = await axios.post(`${BASE_API_URL}/feed/dispense`, {}, {

app/ui/src/components/FeedCard.tsx

@@ -3,18 +3,43 @@ import Paper from '@mui/material/Paper';
 import Stack from '@mui/material/Stack';
 import Typography from '@mui/material/Typography';
 import RestaurantIcon from '@mui/icons-material/Restaurant';
+import FavoriteBorderIcon from '@mui/icons-material/FavoriteBorder';
 import { useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Link } from 'react-router-dom';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { dispenseFeed, fetchFeedInfo } from '../api/api';
 import { useProtectedArea } from '../contexts/ProtectedAreaContext';
-import { dispenseFeed } from '../api/api';
+
+function formatLastDispense(iso: string | null): string | null {
+  if (!iso) return null;
+  try {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime())) return null;
+    return d.toLocaleString(undefined, {
+      day: 'numeric',
+      month: 'short',
+      hour: '2-digit',
+      minute: '2-digit',
+    });
+  } catch {
+    return null;
+  }
+}
 
 export const FeedCard = () => {
   const { t } = useTranslation();
+  const queryClient = useQueryClient();
   const { isAdmin } = useProtectedArea();
   const [loading, setLoading] = useState(false);
   const [message, setMessage] = useState<{ text: string; success: boolean } | null>(null);
 
+  const { data: feedInfo } = useQuery({
+    queryKey: ['feed-info'],
+    queryFn: fetchFeedInfo,
+    staleTime: 1000 * 30, // 30 sec
+  });
+
   const handleDispense = async () => {
     if (!isAdmin) return;
     setLoading(true);
@@ -25,8 +50,14 @@ export const FeedCard = () => {
       text: result.success ? t('feed.feedDispensed') : result.message || t('common.error'),
       success: result.success,
     });
+    if (result.success) {
+      queryClient.invalidateQueries({ queryKey: ['feed-info'] });
+    }
   };
 
+  const lastDispenseStr = formatLastDispense(feedInfo?.last_dispense_at ?? null);
+  const donateUrl = feedInfo?.donate_url;
+
   return (
     <Paper sx={{ padding: 2, height: '100%' }}>
       <Stack spacing={2}>
@@ -48,11 +79,28 @@ export const FeedCard = () => {
         >
           {loading ? t('feed.dispensing') : t('feed.dispenseFeed')}
         </Button>
+        {lastDispenseStr && (
+          <Typography variant="caption" color="text.secondary">
+            {t('feed.lastDispense')}: {lastDispenseStr}
+          </Typography>
+        )}
         {message && (
           <Typography variant="body2" color={message.success ? 'success.main' : 'error.main'}>
             {message.text}
           </Typography>
         )}
+        <Button
+          size="small"
+          variant="outlined"
+          startIcon={<FavoriteBorderIcon />}
+          href={donateUrl || undefined}
+          target={donateUrl ? '_blank' : undefined}
+          rel={donateUrl ? 'noopener noreferrer' : undefined}
+          disabled={!donateUrl}
+          title={!donateUrl ? t('feed.donatePlaceholder') : undefined}
+        >
+          {donateUrl ? t('feed.donate') : t('feed.donatePlaceholder')}
+        </Button>
       </Stack>
     </Paper>
   );

app/ui/src/pages/Settings/SettingsForm.tsx

@@ -358,6 +358,20 @@ export const SettingsForm = ({
             )}
           </form.Field>
         </Grid>
+        <Grid size={{ xs: 12, sm: 6 }}>
+          <form.Field name="general.donate_url">
+            {(field) => (
+              <TextField
+                fullWidth
+                value={field.state.value ?? ''}
+                onChange={(e) => field.handleChange(e.target.value)}
+                label={t('settings.donateUrl')}
+                placeholder="https://ko-fi.com/..."
+                helperText={t('settings.donateUrlHint')}
+              />
+            )}
+          </form.Field>
+        </Grid>
         <Grid size={{ xs: 12 }}>
           <form.Field name="video.go2rtc_url">
             {(field) => (

app/ui/src/types.ts

@@ -100,6 +100,7 @@ export interface Settings {
     notification_excluded_species: string[];
     settings_password?: string;
     birdnet_url?: string; // URL to BirdNET installation; empty = no icon in UI
+    donate_url?: string; // Donation page (Ko-fi, etc.); empty = no button
   };
   processor: {
     tracker: string; // Path to tracker config, e.g., "bytetrack.yaml"

app/web/routes/ui_routes.py

@@ -25,7 +25,7 @@
 )
 from app_config.app_config import app_config
 from app_config.cameras import get_valid_cameras, cameras_for_api
-from services.feed_service import dispense_feed, check_mqtt_connected, check_esphome_reachable
+from services.feed_service import dispense_feed, get_last_dispense, check_mqtt_connected, check_esphome_reachable
 from services.visit_processor import VisitProcessor
 from services.report_service import get_monthly_report_data, build_monthly_report
 from services.xeno_canto_service import fetch_recordings, _search_term_from_species_name
@@ -179,6 +179,17 @@ def status_debug():
             'api_url_base_configured': bool(os.environ.get('API_URL_BASE', '').strip()),
         }
 
+    @app.route('/api/ui/feed/info', methods=['GET'])
+    def feed_info():
+        """Last dispense time and donate URL. No auth required."""
+        from app_config.app_config import app_config
+        app_config.reload()
+        donate_url = (app_config.get('general.donate_url') or '').strip()
+        return {
+            'last_dispense_at': get_last_dispense(),
+            'donate_url': donate_url or None,
+        }, 200
+
     @app.route('/api/ui/feed/dispense', methods=['POST'])
     def feed_dispense():
         if not settings_check_access():

app/web/services/feed_service.py

@@ -1,6 +1,9 @@
 """Feed control service: MQTT or ESPHome for feeder dispense."""
+import json
 import logging
 import os
+from datetime import datetime, timezone
+from pathlib import Path
 from urllib.parse import quote
 
 import paho.mqtt.client as mqtt
@@ -10,6 +13,39 @@
 
 logger = logging.getLogger(__name__)
 
+_FEED_LAST_FILE = 'feed_last_dispense.json'
+
+
+def _feed_data_path():
+    """Path to feed state file in DATA_DIR."""
+    data_dir = os.environ.get('DATA_DIR') or os.path.join(
+        os.path.dirname(os.path.dirname(__file__)), '..', 'data'
+    )
+    return Path(data_dir) / _FEED_LAST_FILE
+
+
+def _save_last_dispense():
+    """Save current UTC timestamp when feed was dispensed."""
+    try:
+        path = _feed_data_path()
+        path.parent.mkdir(parents=True, exist_ok=True)
+        now = datetime.now(timezone.utc)
+        path.write_text(json.dumps({'last_dispense_at': now.isoformat()}), encoding='utf-8')
+    except OSError as e:
+        logger.warning('Could not save last dispense time: %s', e)
+
+
+def get_last_dispense():
+    """Return last dispense ISO timestamp or None."""
+    try:
+        path = _feed_data_path()
+        if not path.exists():
+            return None
+        data = json.loads(path.read_text(encoding='utf-8'))
+        return data.get('last_dispense_at')
+    except (OSError, json.JSONDecodeError, KeyError):
+        return None
+
 _mqtt_client = None
 
 
@@ -100,6 +136,7 @@ def dispense_feed():
             time.sleep(duration)
             client.publish(topic, 'OFF', qos=1)
             logger.info('Feed dispensed via MQTT (relay %ds)', duration)
+            _save_last_dispense()
             return True, 'Feed dispensed'
         except Exception as e:
             logger.error('MQTT feed failed: %s', e)
@@ -131,6 +168,7 @@ def dispense_feed():
                     f"{url.rstrip('/')}/switch/{entity_path}/turn_off", timeout=5
                 )
                 logger.info('Feed dispensed via ESPHome (switch %ds)', duration)
+            _save_last_dispense()
             return True, 'Feed dispensed'
         except Exception as e:
             logger.error('ESPHome feed failed: %s', e)

docs/CONFIGURATION.md

@@ -34,6 +34,9 @@
 | `enable_notifications` | Включить уведомления (глобально) |
 | `settings_password` | Пароль для доступа к настройкам. Пусто — без пароля |
 | `notification_excluded_species` | Виды, исключённые из уведомлений |
+| `donate_url` | Ссылка на страницу пожертвований. Пусто — кнопка-заглушка. |
+
+**Платформы для РФ:** [Boosty](https://boosty.to), [DonationAlerts](https://donationalerts.com), [DONAT24](https://donat24.ru). За рубежом: Ko-fi, Buy Me a Coffee, GitHub Sponsors.
 
 ---