Openapi

openapi: 3.0.0 info: title: Order Service API version: 1.0.0 paths: /orders: get: summary: List orders ...

`に変換し、Mermaid.jsでレンダリングします。 **対応図:** - flowchart / graph - sequenceDiagram - classDiagram - stateDiagram - erDiagram - gantt - xychart-beta **非対応:** - radarChart（xychart-betaで代替） ### XSSサニタイゼーションセキュリティテストケース等で危険なHTMLタグが含まれるMarkdownファイルを処理する際、自動的にXSS対策を行います。 **エスケープ対象のタグ:** - `` - JavaScriptコード実行 - `` - エラーハンドラによるコード実行 - `` - 外部コンテンツ埋め込み - `

` - 外部リソース埋め込み - `

` - 外部オブジェクト埋め込み **処理例:** 入力（Markdownテーブル内）: ```markdown | File name with script | ".pdf" | Rejected by validation | ``` 出力（HTMLテーブル内）: ```html "<script>alert('XSS')</script>.pdf" ``` **動作:** 1. MarkdownをHTMLに変換 2. 危険なHTMLタグを検出（正規表現） 3. `html.escape()`でHTMLエンティティに変換 4. 安全なHTMLとして出力 **注意事項:** - Mermaid図内の`

`、コードブロック内の`

`等、正当なHTMLタグはエスケープされません
- セキュリティテストケースの内容が安全にテキストとして表示されます
- ブラウザでXSSエラーが発生することなくHTMLを開けます

## 出力ファイル

```
reports/
└── 00_summary/
    └── full-report.html   # 統合HTMLレポート (約450KB)
```

## 使用例

### 例1: HTML形式で基本コンパイル

```bash
# コマンド形式
/compile-report

# または直接実行
source .venv/bin/activate && python scripts/compile_report.py \
  --input-dir ./reports \
  --output ./reports/00_summary/full-report.html
```

### 例2: Nextra形式で静的サイト生成

```bash
# Step 1: 変換
python scripts/convert_to_nextra.py --input ./reports --output ./reports/nextra-site

# Step 2: ビルド
cd reports/nextra-site
npm install  # 初回のみ
npx next build

# Step 3: 確認
npx serve out/
```

### 例3: HTMLをカスタムタイトルとダークテーマで生成

```bash
source .venv/bin/activate && python scripts/compile_report.py \
  --input-dir ./reports \
  --output ./reports/00_summary/full-report.html \
  --title "My Project Report" \
  --theme dark
```

### 例4: ブラウザで開く

```bash
# HTML
open reports/00_summary/full-report.html

# Nextra（ローカル開発サーバー）
cd reports/nextra-site && npx next dev
# → http://localhost:3000 を開く

# Nextra（ビルド済みサイト）
cd reports/nextra-site && npx serve out/
# → http://localhost:3000 を開く
```

## トラブルシューティング

### Mermaid図が表示されない

1. ブラウザのコンソールでエラーを確認
2. `/fix-mermaid`で構文エラーをチェック
3. 予約語（BOX等）を使用していないか確認

### GraphDBビューアが表示されない

1. `reports/graph/visualizations/graph.html`の存在を確認
2. `/visualize-graph`を実行してファイルを生成

### 日本語が文字化けする

1. HTMLファイルがUTF-8で保存されているか確認
2. ブラウザのエンコーディング設定を確認

### XSSエラーが表示される

HTMLを開いた際にXSSエラーが表示される場合：

1. **原因**: セキュリティテストケース等に含まれる`