v1.8.3: добавлены docstrings и комментарии по AGENTS.md ко всем ключевым файлам

py_service/app/routers/service_pages.py

@@ -1293,6 +1293,7 @@ BOT_SERVICE_URL = "http://127.0.0.1:8002"
 
 
 async def _proxy(method: str, path: str, body=None):
+    """Прокси запросов от service portal к max_bot API."""
     async with httpx.AsyncClient() as client:
         if body is not None:
             resp = await client.request(method, f"{BOT_SERVICE_URL}{path}", json=body)
@@ -1431,11 +1432,13 @@ async def proxy_bot_conversation_logs(conv_id: int, user: dict = Depends(get_cur
 
 @router.delete("/api/bot/conversations/{conv_id}")
 async def proxy_delete_conversation(conv_id: int, request: Request, user: dict = Depends(require_role("owner"))):
+    """Удаление диалога (каскадно: сообщения + логи). Доступно только owner."""
     return await _proxy("DELETE", f"/api/bot/conversations/{conv_id}")
 
 
 @router.delete("/api/bot/users/{user_id}")
 async def proxy_delete_bot_user(user_id: int, request: Request, user: dict = Depends(require_role("owner"))):
+    """Удаление пользователя бота (каскадно: диалоги + сообщения + логи). Заявки остаются. Доступно только owner."""
     return await _proxy("DELETE", f"/api/bot/users/{user_id}")