feat(slack): implement App Home, document upload and event verification

- Added /events endpoint for URL verification and Slack event handling.
- Implemented App Home interface with quick action buttons.
- Added modal views for document uploads and post generation.
- Updated app manifest and UI lexicon.
- Fixed critical indentation errors in interaction routes.

Author: PyDevDeep

backend/api/routes/feedback.py

@@ -12,6 +12,7 @@
     build_app_home,
     build_approval_modal,
     build_generation_modal,
+    build_upload_modal,
 )
 
 logger = structlog.get_logger()
@@ -57,7 +58,7 @@ async def slack_interactions(request: Request):
         raise HTTPException(status_code=400, detail="Missing payload")
 
     payload = json.loads(str(payload_str))
-    user_id = payload.get("user", {}).get("id")
+    user_id = str(payload.get("user", {}).get("id", ""))  # Cast to str for Pylance
     interaction_type = payload.get("type")
 
     slack_token = (
@@ -66,8 +67,8 @@ async def slack_interactions(request: Request):
     headers = {"Authorization": f"Bearer {slack_token}"}
 
     if interaction_type == "block_actions":
-        response_url = payload.get("response_url")
-        trigger_id = payload.get("trigger_id")
+        response_url = str(payload.get("response_url", ""))
+        trigger_id = str(payload.get("trigger_id", ""))
         action = payload.get("actions", [])[0]
         action_id = action.get("action_id")
 
@@ -76,12 +77,24 @@ async def slack_interactions(request: Request):
         draft_text = raw_draft.replace("```", "").strip()
         topic = "Медичний пост"
 
-        if action_id == "action_publish_draft":
+        # УСІ перевірки action_id мають бути всередині цього блоку
+        if action_id == "action_open_upload_modal":
+            logger.info("slack_home_upload_btn_clicked", user_id=user_id)
+            modal_view = build_upload_modal()
+            async with httpx.AsyncClient() as client:
+                res = await client.post(
+                    "[https://slack.com/api/views.open](https://slack.com/api/views.open)",
+                    headers=headers,
+                    json={"trigger_id": trigger_id, "view": modal_view},
+                )
+                if not res.json().get("ok"):
+                    logger.error("slack_modal_error", error=res.json())
+
+        elif action_id == "action_publish_draft":
             logger.info("slack_draft_approved", user_id=user_id)
             await publish_post_task.kiq(
                 post_id="temp_id", platform="telegram", content=draft_text
             )
-
             async with httpx.AsyncClient() as client:
                 await client.post(
                     response_url,
@@ -126,9 +139,8 @@ async def slack_interactions(request: Request):
                 topic=topic, draft=draft_text, platform="telegram"
             )
             async with httpx.AsyncClient() as client:
-                # ВИПРАВЛЕНО URL
                 res = await client.post(
-                    "https://slack.com/api/views.open",
+                    "[https://slack.com/api/views.open](https://slack.com/api/views.open)",
                     headers=headers,
                     json={"trigger_id": trigger_id, "view": modal_view},
                 )
@@ -137,12 +149,10 @@ async def slack_interactions(request: Request):
 
         elif action_id == "action_regenerate_draft":
             logger.info("slack_draft_regenerate", user_id=user_id)
-            channel_id = payload.get("channel", {}).get("id")  # ДОДАНО
-
-            await generate_draft_task.kiq(  # type: ignore[call-overload]
+            channel_id = str(payload.get("channel", {}).get("id", ""))
+            await generate_draft_task.kiq(
                 topic=topic, platform="telegram", user_id=user_id, channel_id=channel_id
-            )
-
+            )  # type: ignore
             async with httpx.AsyncClient() as client:
                 await client.post(
                     response_url,
@@ -166,12 +176,13 @@ async def slack_interactions(request: Request):
             modal_view = build_generation_modal(channel_id=user_id)
             async with httpx.AsyncClient() as client:
                 res = await client.post(
-                    "https://slack.com/api/views.open",
+                    "[https://slack.com/api/views.open](https://slack.com/api/views.open)",
                     headers=headers,
                     json={"trigger_id": trigger_id, "view": modal_view},
                 )
                 if not res.json().get("ok"):
                     logger.error("slack_modal_error", error=res.json())
+
         return Response(status_code=200)
 
     elif interaction_type == "view_submission":
@@ -252,7 +263,34 @@ async def slack_interactions(request: Request):
                 media_type="application/json",
                 status_code=200,
             )
+        # --- СЦЕНАРІЙ 3: Завантаження гайдлайну ---
+        elif callback_id == "modal_upload_guideline":
+            # Slack повертає масив об'єктів файлів
+            files = (
+                state_values.get("block_file_upload", {})
+                .get("input_file", {})
+                .get("files", [])
+            )
+            if not files:
+                return Response(status_code=400)
+
+            file_info = files[0]
+            # file_url = file_info.get("url_private_download")
+            file_name = file_info.get("name")
+
+            logger.info("slack_file_uploaded", user_id=user_id, file_name=file_name)
+
+            # TODO: Тут ми створимо таск `ingest_document_task`, який буде
+            # скачувати файл за file_url (використовуючи Slack Token),
+            # парсити PDF/TXT та векторизувати його у Qdrant.
+            # await ingest_document_task.kiq(file_url=file_url, file_name=file_name)
 
+            # Закриваємо модалку
+            return Response(
+                content=json.dumps({"response_action": "clear"}),
+                media_type="application/json",
+                status_code=200,
+            )
     return Response(status_code=200)
 
 

backend/config/lexicon.py

@@ -42,4 +42,9 @@
     "home_welcome": "Вітаю у Seratonin Script! 🧠",
     "home_description": "Це твій центр керування медичним контентом. Натисни кнопку нижче, щоб почати.",
     "home_btn_create": "✨ Створити новий пост",
+    "home_btn_upload": "📚 Завантажити гайдлайн",
+    # --- Upload Modal ---
+    "upload_modal_title": "База знань",
+    "upload_modal_submit": "Завантажити",
+    "upload_modal_input_label": "Оберіть файл (PDF/TXT)",
 }

slack_app/manifest.yaml

@@ -22,10 +22,15 @@ oauth_config:
       - commands
       - chat:write
       - users:read
+      - files:read
 settings:
   interactivity:
     is_enabled: true
     request_url: https://optifood-ai.duckdns.org/api/v1/slack/interactions
   org_deploy_enabled: false
   socket_mode_enabled: false
-  token_rotation_enabled: false
+  token_rotation_enabled: false
+  event_subscriptions:
+    request_url: https://optifood-ai.duckdns.org/api/v1/slack/events
+    bot_events:
+      - app_home_opened

slack_app/utils/block_builder.py

@@ -224,7 +224,6 @@ def build_generation_modal(channel_id: str) -> dict[str, Any]:
 
 
 def build_app_home() -> dict[str, Any]:
-    """Генерує інтерфейс вкладки Home."""
     return {
         "type": "home",
         "blocks": [
@@ -252,9 +251,57 @@ def build_app_home() -> dict[str, Any]:
                             "emoji": True,
                         },
                         "style": "primary",
-                        "action_id": "action_open_generation_modal",  # Та сама логіка, що й для команди
-                    }
+                        "action_id": "action_open_generation_modal",
+                    },
+                    {
+                        "type": "button",
+                        "text": {
+                            "type": "plain_text",
+                            "text": SLACK_UI["home_btn_upload"],
+                            "emoji": True,
+                        },
+                        "action_id": "action_open_upload_modal",
+                    },
                 ],
             },
         ],
     }
+
+
+def build_upload_modal() -> dict[str, Any]:
+    """Генерує модальне вікно для завантаження файлу в базу знань."""
+    return {
+        "type": "modal",
+        "callback_id": "modal_upload_guideline",
+        "title": {
+            "type": "plain_text",
+            "text": SLACK_UI["upload_modal_title"],
+            "emoji": True,
+        },
+        "submit": {
+            "type": "plain_text",
+            "text": SLACK_UI["upload_modal_submit"],
+            "emoji": True,
+        },
+        "close": {
+            "type": "plain_text",
+            "text": SLACK_UI["modal_cancel"],
+            "emoji": True,
+        },
+        "blocks": [
+            {
+                "type": "input",
+                "block_id": "block_file_upload",
+                "label": {
+                    "type": "plain_text",
+                    "text": SLACK_UI["upload_modal_input_label"],
+                },
+                "element": {
+                    "type": "file_input",
+                    "action_id": "input_file",
+                    "filetypes": ["pdf", "txt"],  # Обмежуємо формати
+                    "max_files": 1,
+                },
+            }
+        ],
+    }