システム要件

• オペレーティングシステム: Windows または Linux
• Python 3.11+
• GUI に PySide6
• オンライン機能にインターネット接続

カスタムエンティティ

エンティティは PANO のコアデータ構造です。各エンティティは、特定のプロパティと動作を持つ情報を表します。カスタムエンティティを作成するには:

1. entities フォルダに新しいファイルを作成 (例: entities/phone_number.py)
2. エンティティクラスを実装:

from dataclasses import dataclass
from typing import ClassVar, Dict, Any
from .base import Entity

@dataclass
class PhoneNumber(Entity):
    name: ClassVar[str] = "Phone Number"
    description: ClassVar[str] = "A phone number entity with country code and validation"
    
    def init_properties(self):
        """Initialize phone number properties"""
        self.setup_properties({
            "number": str,
            "country_code": str,
            "carrier": str,
            "type": str,  # mobile, landline, etc.
            "verified": bool
        })
    
    def update_label(self):
        """Update the display label"""
        self.label = self.format_label(["country_code", "number"])

カスタムトランスフォーム

トランスフォームは、エンティティを処理して新しい洞察や関係を生成する操作です。カスタムトランスフォームを作成するには:

1. transforms フォルダに新しいファイルを作成 (例: transforms/phone_lookup.py)
2. トランスフォームクラスを実装:

from dataclasses import dataclass
from typing import ClassVar, List
from .base import Transform
from entities.base import Entity
from entities.phone_number import PhoneNumber
from entities.location import Location
from ui.managers.status_manager import StatusManager

@dataclass
class PhoneLookup(Transform):
    name: ClassVar[str] = "Phone Number Lookup"
    description: ClassVar[str] = "Lookup phone number details and location"
    input_types: ClassVar[List[str]] = ["PhoneNumber"]
    output_types: ClassVar[List[str]] = ["Location"]
    
    async def run(self, entity: PhoneNumber, graph) -> List[Entity]:
        if not isinstance(entity, PhoneNumber):
            return []
            
        status = StatusManager.get()
        operation_id = status.start_loading("Phone Lookup")
        
        try:
            # Your phone number lookup logic here
            # Example: query an API for phone number details
            location = Location(properties={
                "country": "Example Country",
                "region": "Example Region",
                "carrier": "Example Carrier",
                "source": "PhoneLookup transform"
            })
            
            return [location]
            
        except Exception as e:
            status.set_text(f"Error during phone lookup: {str(e)}")
            return []
            
        finally:
            status.stop_loading(operation_id)

カスタムヘルパー

ヘルパーは、専用の UI インターフェースを通じて追加の調査機能を提供する特殊なツールです。カスタムヘルパーを作成するには:

1. helpers フォルダに新しいファイルを作成 (例: helpers/data_analyzer.py)
2. ヘルパークラスを実装:

from PySide6.QtWidgets import (
    QWidget, QVBoxLayout, QHBoxLayout, QPushButton,
    QTextEdit, QLabel, QComboBox
)
from .base import BaseHelper
from qasync import asyncSlot