PART 01 — システム基本設計書
システム概要・アーキテクチャ方針で定義すべきこと

import platform
import subprocess
import json
import os

def collect_system_info() -> dict:
    """
    実機のOS・ハードウェア・Python環境情報を収集して返す。
    設計書の「環境設計」セクション作成に活用できる。
    """
    info = {}

    # ── OS情報 ─────────────────────────────────────
    info["os"] = {
        "system":   platform.system(),          # Windows / Linux / Darwin
        "release":  platform.release(),         # カーネルバージョン
        "version":  platform.version(),         # 詳細バージョン
        "machine":  platform.machine(),         # x86_64 / aarch64 など
        "node":     platform.node(),            # ホスト名
    }

    # ── Python環境 ─────────────────────────────────
    info["python"] = {
        "version":  platform.python_version(),  # 3.12.x
        "compiler": platform.python_compiler(),
    }

    # ── CPU情報（Linux / macOS） ───────────────────
    if platform.system() != "Windows":
        try:
            result = subprocess.run(
                ["nproc"], capture_output=True, text=True, timeout=5
            )
            info["cpu_cores"] = result.stdout.strip()
        except FileNotFoundError:
            # macOS では nproc がない場合がある
            result = subprocess.run(
                ["sysctl", "-n", "hw.logicalcpu"],
                capture_output=True, text=True, timeout=5
            )
            info["cpu_cores"] = result.stdout.strip()

    # ── メモリ情報（Linux） ─────────────────────────
    if platform.system() == "Linux":
        try:
            with open("/proc/meminfo") as f:
                for line in f:
                    if line.startswith("MemTotal:"):
                        kb = int(line.split()[1])
                        info["memory_gb"] = round(kb / 1024 / 1024, 1)
                        break
        except OSError:
            info["memory_gb"] = "N/A"

    # ── ディスク使用状況 ────────────────────────────
    usage = os.statvfs("/") if platform.system() != "Windows" else None
    if usage:
        total_gb = round(usage.f_frsize * usage.f_blocks / 1024**3, 1)
        free_gb  = round(usage.f_frsize * usage.f_bfree  / 1024**3, 1)
        info["disk"] = {"total_gb": total_gb, "free_gb": free_gb}

    return info


if __name__ == "__main__":
    data = collect_system_info()
    print(json.dumps(data, ensure_ascii=False, indent=2))

import subprocess
import json

def collect_installed_packages() -> list[dict]:
    """
    pip でインストール済みパッケージ一覧を取得する。
    設計書の「技術スタック」記述の素材として活用できる。
    """
    result = subprocess.run(
        ["pip", "list", "--format=json"],
        capture_output=True, text=True, timeout=30
    )
    packages = json.loads(result.stdout)
    # 代表的なパッケージだけ抽出する場合
    important_keywords = [
        "django", "flask", "fastapi", "sqlalchemy",
        "requests", "numpy", "pandas", "psycopg2",
        "boto3", "redis", "celery"
    ]
    filtered = [
        p for p in packages
        if any(kw in p["name"].lower() for kw in important_keywords)
    ]
    return filtered


def collect_java_version() -> str:
    """Java バージョンを取得する（java コマンドが存在する場合）"""
    try:
        result = subprocess.run(
            ["java", "-version"],
            capture_output=True, text=True, timeout=10
        )
        # java -version は stderr に出力する
        return result.stderr.split("\n")[0]
    except FileNotFoundError:
        return "Java not found"


def collect_node_version() -> str:
    """Node.js バージョンを取得する"""
    try:
        result = subprocess.run(
            ["node", "--version"],
            capture_output=True, text=True, timeout=10
        )
        return result.stdout.strip()
    except FileNotFoundError:
        return "Node.js not found"


if __name__ == "__main__":
    print("=== 主要Pythonパッケージ ===")
    for pkg in collect_installed_packages():
        print(f"  {pkg['name']} {pkg['version']}")

    print("\n=== ランタイム ===")
    print("Java:", collect_java_version())
    print("Node:", collect_node_version())