プロジェクト

全般

プロフィール

概要

# VoiceEdit — macOS 音声編集アプリ 実装計画

**プロジェクトルート:** `/Users/fujisaki/VoiceEdit` (現在空ディレクトリ、greenfield)

---

## Context

### なぜ作るか
macOS には GarageBand のような重厚な DAW と、QuickTime のような録音専用ツールはあるが、その中間 — **「ポッドキャストやボイスメモを素早く編集して書き出すための軽量ネイティブアプリ」** — の選択肢が薄い。Audacity はクロスプラットフォームゆえに UI が古く、Sonoma 以降のネイティブな操作感とも乖離している。VoiceEdit はこのギャップを埋める。

### 達成したいこと
- **対象ユーザー:** ポッドキャスター、社内研修動画のナレーション担当、ボイスメモを編集して共有したい個人。
- **コア体験:** ファイルをドラッグ → 波形が即座に出る → リージョン選択して Delete / Split / フェード → エクスポート、までを 5 操作以内で完結。
- **非機能要件:**
  - macOS 14 Sonoma 以降、Apple Silicon と Intel の両方で動作。
  - 1 時間の WAV/MP3 を開いて 1 秒以内に波形プレビュー(ピーク事前計算 + ディスクキャッシュ)。
  - 非破壊編集(元ファイルは触らない、編集は EDL として保持)。
  - サンドボックス有効、セキュリティスコープ付きブックマークでファイル再オープン対応。
- **スコープに含む:** 読込/再生/波形/トリム/カット/結合/分割/並べ替え/音量/フェード/EQ/リバーブ/ノイズ除去/エクスポート(WAV/AIFF/M4A AAC/ALAC/FLAC)、入力のみ Ogg Vorbis/Opus/MP3 デコード。
- **スコープ外 (v2 以降):** マルチトラックミキシング、MIDI、リアルタイムオートメーション、録音機能、Ogg/Opus エクスポート。

### 技術選定の根拠
- **Swift + SwiftUI ネイティブ:** macOS 14 で `Canvas`、`@Observable`、`ScrollView` の制御 API が成熟。
- **XcodeGen:** `project.pbxproj` を Git に入れずに済み、設定を `project.yml` 一本で管理可能。
- **AVFoundation + AVAudioEngine:** Apple 純正で M4A/AAC/ALAC/WAV/AIFF/FLAC(Sonoma+ ネイティブ) を網羅。`AVAudioUnitEQ`/`AVAudioUnitReverb` 標準提供。
- **SFBAudioEngine (SPM):** Ogg Vorbis/Opus、MP3 のデコードを補う。`AudioDecoder` 経由で PCM を取り、`AVAudioPCMBuffer` に変換して AVAudioEngine に流す。

---

## 1. XcodeGen `project.yml` 構成

**ファイル:** `/Users/fujisaki/VoiceEdit/project.yml`

```yaml
name: VoiceEdit
options:
  bundleIdPrefix: com.fujisaki.voiceedit
  deploymentTarget:
    macOS: "14.0" 
  developmentLanguage: ja
  createIntermediateGroups: true
  generateEmptyDirectories: true
  groupSortPosition: top

settings:
  base:
    SWIFT_VERSION: "5.10" 
    MACOSX_DEPLOYMENT_TARGET: "14.0" 
    ENABLE_HARDENED_RUNTIME: YES
    CODE_SIGN_STYLE: Automatic
    DEAD_CODE_STRIPPING: YES
    SWIFT_STRICT_CONCURRENCY: complete
    GENERATE_INFOPLIST_FILE: NO
    INFOPLIST_FILE: VoiceEdit/Resources/Info.plist
    CODE_SIGN_ENTITLEMENTS: VoiceEdit/Resources/VoiceEdit.entitlements
    CURRENT_PROJECT_VERSION: 1
    MARKETING_VERSION: "0.1.0" 

packages:
  SFBAudioEngine:
    url: https://github.com/sbooth/SFBAudioEngine
    from: "0.6.0"   # 実装着手時に最新タグへ更新

targets:
  VoiceEdit:
    type: application
    platform: macOS
    sources:
      - path: VoiceEdit
        excludes: ["**/.DS_Store"]
    resources:
      - VoiceEdit/Resources/Assets.xcassets
    dependencies:
      - package: SFBAudioEngine
        product: SFBAudioEngine
    info:
      path: VoiceEdit/Resources/Info.plist
      properties:
        CFBundleDisplayName: VoiceEdit
        CFBundleShortVersionString: $(MARKETING_VERSION)
        CFBundleVersion: $(CURRENT_PROJECT_VERSION)
        LSMinimumSystemVersion: $(MACOSX_DEPLOYMENT_TARGET)
        NSHighResolutionCapable: true
        CFBundleDocumentTypes:
          - CFBundleTypeName: Audio File
            CFBundleTypeRole: Editor
            LSItemContentTypes:
              - public.audio
              - public.mp3
              - com.apple.m4a-audio
              - org.xiph.flac
              - org.xiph.ogg
              - public.aifc-audio
              - public.aiff-audio
              - com.microsoft.waveform-audio
        UTImportedTypeDeclarations:
          - UTTypeIdentifier: org.xiph.flac
            UTTypeDescription: FLAC Audio
            UTTypeConformsTo: [public.audio]
            UTTypeTagSpecification:
              public.filename-extension: [flac]
              public.mime-type: [audio/flac]
          - UTTypeIdentifier: org.xiph.ogg
            UTTypeDescription: Ogg Audio
            UTTypeConformsTo: [public.audio]
            UTTypeTagSpecification:
              public.filename-extension: [ogg, oga, opus]
              public.mime-type: [audio/ogg, audio/opus]
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.fujisaki.voiceedit

  VoiceEditTests:
    type: bundle.unit-test
    platform: macOS
    sources: [VoiceEditTests]
    dependencies:
      - target: VoiceEdit
```

### Entitlements
**ファイル:** `/Users/fujisaki/VoiceEdit/VoiceEdit/Resources/VoiceEdit.entitlements`

| Key | Value | 理由 |
|---|---|---|
| `com.apple.security.app-sandbox` | `YES` | App Store 配布視野、現代的な安全性 |
| `com.apple.security.files.user-selected.read-write` | `YES` | ユーザーが開いたファイルを編集・上書き |
| `com.apple.security.files.bookmarks.app-scope` | `YES` | セキュリティスコープブックマーク永続化 |

> サンドボックスは最初から有効化(後付けは困難)。

---

## 2. ファイル / モジュール構成

```
/Users/fujisaki/VoiceEdit/
├── project.yml
├── .gitignore                         # *.xcodeproj, build/, .DS_Store, .swiftpm
├── README.md
├── VoiceEdit/
│   ├── App/
│   │   ├── VoiceEditApp.swift         # @main, WindowGroup
│   │   └── AppCommands.swift          # File/Edit/Effects メニュー、Undo/Redo
│   ├── Models/
│   │   ├── Project.swift              # tracks, sampleRate, channelLayout, metadata
│   │   ├── Track.swift                # 順序付きクリップコレクション
│   │   ├── Clip.swift                 # 非破壊単位: source + in/out + gain + fade + effects
│   │   ├── SourceAsset.swift          # 元ファイル参照 (bookmark, URL, frames, sampleRate)
│   │   ├── EffectChain.swift          # [EffectDescriptor] 保持
│   │   ├── EffectDescriptor.swift     # enum: .eq / .reverb / .noiseReduction
│   │   ├── TimeRange.swift            # フレーム/秒変換
│   │   └── ProjectCodable.swift       # JSON ↔ Project (.voiceedit 拡張子)
│   ├── Audio/
│   │   ├── Engine/
│   │   │   ├── PlaybackEngine.swift   # AVAudioEngine ラッパ
│   │   │   ├── PlayerScheduler.swift  # クリップ列を scheduleBuffer で並べる
│   │   │   ├── EffectGraph.swift      # Player → EQ → Reverb → MainMixer
│   │   │   └── TransportState.swift   # @Observable: isPlaying, currentFrame
│   │   ├── Decoding/
│   │   │   ├── AudioDecoder.swift     # protocol: open(url) -> PCMBufferStream
│   │   │   ├── AVFoundationDecoder.swift   # WAV/AIFF/M4A/AAC/ALAC/FLAC
│   │   │   ├── SFBDecoder.swift       # MP3/Ogg Vorbis/Opus
│   │   │   └── DecoderFactory.swift   # UTI で振り分け
│   │   ├── Waveform/
│   │   │   ├── WaveformPeakStore.swift   # LRU + disk cache
│   │   │   ├── WaveformGenerator.swift   # vDSP でチャンクピーク計算
│   │   │   ├── PeakChunk.swift        # min/max ペア
│   │   │   └── WaveformCacheDirectory.swift  # ~/Library/Caches/VoiceEdit/peaks/
│   │   ├── Effects/
│   │   │   ├── EQProcessor.swift      # AVAudioUnitEQ 10 バンド
│   │   │   ├── ReverbProcessor.swift  # AVAudioUnitReverb プリセット + wet/dry
│   │   │   ├── NoiseReducer.swift     # オフライン: プロファイル取得 → 減算
│   │   │   ├── SpectralSubtractor.swift  # vDSP.DFT, Hann window, 75% overlap
│   │   │   ├── GainProcessor.swift    # dB → linear, vDSP_vsmul
│   │   │   └── FadeProcessor.swift    # 線形/対数フェードカーブ
│   │   ├── Editing/
│   │   │   ├── EditCommand.swift      # protocol: apply -> InverseCommand
│   │   │   ├── TrimCommand.swift
│   │   │   ├── SplitCommand.swift
│   │   │   ├── DeleteRangeCommand.swift
│   │   │   ├── MoveClipCommand.swift
│   │   │   ├── SetGainCommand.swift
│   │   │   ├── SetFadeCommand.swift
│   │   │   └── ApplyEffectCommand.swift
│   │   └── Export/
│   │       ├── ExportService.swift    # オーケストレーション + Progress
│   │       ├── OfflineRenderer.swift  # AVAudioEngine manualRenderingMode
│   │       ├── ExportFormat.swift     # enum: .wav / .aiff / .m4aAAC(bitrate) / .alac / .flac
│   │       └── AssetWriterEncoder.swift  # AVAssetWriter for M4A/AAC/ALAC
│   ├── ViewModels/
│   │   ├── ProjectViewModel.swift     # @Observable: project + selection + transport
│   │   ├── TimelineViewModel.swift    # scroll, zoom, selection range
│   │   ├── ClipViewModel.swift
│   │   ├── InspectorViewModel.swift
│   │   ├── ExportViewModel.swift
│   │   └── EffectPanelViewModel.swift
│   ├── Views/
│   │   ├── MainWindow.swift           # NavigationSplitView (Sidebar | Timeline | Inspector)
│   │   ├── Timeline/
│   │   │   ├── TimelineView.swift     # ScrollView + ルーラー + レーン + 再生ヘッド
│   │   │   ├── RulerView.swift        # 時間目盛
│   │   │   ├── ClipLaneView.swift     # クリップ横並びレイアウト
│   │   │   ├── ClipView.swift         # 個別クリップ (背景 + 波形 + ハンドル)
│   │   │   ├── WaveformView.swift     # Canvas でピーク描画
│   │   │   ├── PlayheadView.swift     # 再生位置の縦線
│   │   │   └── SelectionOverlay.swift # ドラッグ範囲選択
│   │   ├── Inspector/
│   │   │   ├── InspectorPanel.swift   # タブ: Clip / Effects / Export
│   │   │   ├── ClipInfoView.swift
│   │   │   ├── GainFadeView.swift
│   │   │   ├── EQEditorView.swift
│   │   │   ├── ReverbEditorView.swift
│   │   │   └── NoiseReductionView.swift
│   │   ├── Toolbar/
│   │   │   ├── TransportToolbar.swift # 再生/停止/ループ/タイムコード
│   │   │   └── EditToolbar.swift      # Split / Delete / Trim / Join
│   │   ├── Dialogs/
│   │   │   ├── ImportDropZone.swift   # NSItemProvider 受信
│   │   │   ├── ExportSheet.swift      # フォーマット選択
│   │   │   └── ErrorAlert.swift
│   │   └── Common/
│   │       ├── DBSlider.swift         # -∞..+12dB 対数スライダー
│   │       └── TimeCodeField.swift    # HH:MM:SS.mmm 入力
│   ├── Utilities/
│   │   ├── SecurityScopedBookmark.swift  # URL ↔ Data
│   │   ├── Logging.swift                 # os.Logger サブシステム
│   │   ├── Concurrency/
│   │   │   ├── AsyncSerialQueue.swift    # actor ベース逐次実行
│   │   │   └── ProgressReporting.swift
│   │   ├── DSP/
│   │   │   ├── FFTContext.swift          # vDSP.DFT ラッパ
│   │   │   ├── WindowFunctions.swift     # Hann / Hamming
│   │   │   └── BufferConversions.swift   # interleaved ↔ planar
│   │   └── Math/
│   │       ├── DecibelConversion.swift
│   │       └── Interpolation.swift
│   └── Resources/
│       ├── Info.plist
│       ├── VoiceEdit.entitlements
│       └── Assets.xcassets/
│           ├── AppIcon.appiconset/
│           └── AccentColor.colorset/
└── VoiceEditTests/
    ├── ClipEditingTests.swift            # Split/Trim/Delete のフレーム精度
    ├── EffectChainCodableTests.swift     # JSON ラウンドトリップ
    ├── WaveformPeakTests.swift           # サイン波でピーク値検証
    ├── SpectralSubtractionTests.swift    # SNR 改善 assert
    ├── ExportRoundTripTests.swift        # WAV ビット完全性
    └── UndoRedoTests.swift               # コマンド対称性
```

---

## 3. 非破壊編集モデル

```swift
struct SourceAsset: Identifiable, Codable, Hashable {
    let id: UUID
    let bookmark: Data            // セキュリティスコープ付き
    let originalURL: URL
    let totalFrames: Int64
    let sampleRate: Double
    let channelCount: UInt32
    let formatDescription: String // "MP3 320kbps" 等
    let contentHash: String       // SHA-256, ピークキャッシュキー
}

struct Clip: Identifiable, Codable, Equatable {
    let id: UUID
    var sourceAssetID: UUID
    var inFrame: Int64
    var outFrame: Int64           // exclusive
    var gainDB: Float             // -inf..+12
    var fadeInFrames: Int64
    var fadeOutFrames: Int64
    var effectChain: EffectChain
    var name: String
}

enum EffectDescriptor: Codable, Equatable {
    case eq(bands: [EQBand])
    case reverb(preset: ReverbPreset, wetDryMix: Float)
    case noiseReduction(profile: NoiseProfile, strengthDB: Float)
}

struct Project: Codable {
    var id: UUID
    var name: String
    var sampleRate: Double         // 44100/48000
    var sources: [UUID: SourceAsset]
    var track: Track               // v1 は単一トラック
}
```

### 編集操作のセマンティクス

| 操作 | 実装 |
|---|---|
| トリム | `clip.inFrame`/`clip.outFrame` を変更 |
| 範囲削除 | 該当クリップを境界で Split → 中央クリップを remove |
| 分割 | Clip を 2 つに複製、境界で in/out 調整 |
| 結合 | 隣接が同 SourceAsset & 連続フレーム & 同パラメータなら統合 |
| 並べ替え | `track.clips` 配列入れ替え |
| 音量 | `gainDB` 変更 |
| フェード | `fadeInFrames`/`fadeOutFrames` 変更 |
| エフェクト | `effectChain.descriptors` 操作 |

元ファイルは一切書き換えず、`Project` 構造だけが変わる。エクスポート時に `OfflineRenderer` が EDL を解釈して PCM を生成。

---

## 4. 再生エンジン (AVAudioEngine)

### ノードグラフ
```
PlayerNode(scheduleBuffer queue) ──► EQ ──► Reverb ──► MainMixer ──► OutputNode
       (NR / Gain / Fade は事前にバッファへ焼き込み)
```

### 設計判断
- **1 つの PlayerNode に `scheduleBuffer(at:options:completionHandler:)` でクリップ列を順次キュー**。メモリ節約とシーク容易性。
- **NR/Gain/Fade はクリップ単位**で時系列依存があるため、scheduleBuffer 前に Float32 バッファへ焼き込む。
- **EQ/Reverb はプロジェクト共通**として 1 セットの AudioUnit を通す(クリップ単位 EQ/Reverb は v2)。

### 主要 API
```swift
@MainActor @Observable
final class PlaybackEngine {
    private let engine = AVAudioEngine()
    private let player = AVAudioPlayerNode()
    private let eq = AVAudioUnitEQ(numberOfBands: 10)
    private let reverb = AVAudioUnitReverb()
    var transport = TransportState()

    func prepare(project: Project) throws
    func play(from frame: Int64) async throws
    func pause()
    func stop()
    func seek(to frame: Int64) async throws  // stop → reschedule from frame
    func updateEQ(_ params: EQParams)
    func updateReverb(_ params: ReverbParams)
}
```

### 再生ヘッド更新
`AVAudioPlayerNode.lastRenderTime` を `Timer.publish(every: 1/60)` で `@Observable` に反映。SwiftUI 側は `transport.currentFrame` を監視するのみ。

### バッファ供給
`PlayerScheduler` が各クリップを Decoder → Gain/Fade/NR 適用 → `AVAudioPCMBuffer` 化 → `player.scheduleBuffer`。大きなクリップは 1〜数秒チャンクで pull モデル供給。

---

## 5. 波形描画

### 方針
1. インポート直後にバックグラウンドでピーク事前計算 → ディスクキャッシュ → メモリ LRU
2. SwiftUI `Canvas` は当該レンジのピークを描画するだけ

### ピーク計算
```swift
struct PeakChunk { let min: Float; let max: Float }

actor WaveformGenerator {
    /// samplesPerPeak: 例 256 (44.1kHz で 5.8ms 解像度)
    func generate(asset: SourceAsset, samplesPerPeak: Int) async throws -> [PeakChunk]
}
```
- AVAudioFile から 65,536 フレームずつ読み、`vDSP_minv`/`vDSP_maxv` で min/max
- 結果は `~/Library/Caches/VoiceEdit/peaks/<contentHash>_<samplesPerPeak>.peaks` に `[Int16(min*32767), Int16(max*32767)]` 連続バイナリで保存

### ズーム対応
- 複数解像度キャッシュ (`samplesPerPeak = 64, 256, 1024, 4096`)
- `pixelsPerSecond` から最適解像度を選択
- 不足解像度は要求時にバックグラウンド生成

### 描画
```swift
Canvas { ctx, size in
    var path = Path()
    for (i, p) in peaks.enumerated() {
        let x = CGFloat(i) * size.width / CGFloat(peaks.count)
        let yMid = size.height / 2
        path.move(to: .init(x: x, y: yMid + CGFloat(p.min) * yMid))
        path.addLine(to: .init(x: x, y: yMid + CGFloat(p.max) * yMid))
    }
    ctx.stroke(path, with: .color(.accentColor), lineWidth: 1)
}
```

---

## 6. ノイズリダクション (スペクトル減算)

### アルゴリズム
1. **プロファイル取得:** 無音範囲を選択 → STFT してフレーム平均パワースペクトル `N(f)` を算出
2. **適用 (オフライン):** 各 STFT フレーム `Y(f)` について
   `|X(f)|² = max(|Y(f)|² − α · N(f), β · |Y(f)|²)`
   - α = 過剰減算係数 (1.5〜2.5、UI スライダー)
   - β = スペクトルフロア (0.01〜0.05、ミュージカルノイズ抑制)
   - 位相は `Y(f)` を流用
3. **iSTFT** で時間領域に戻す

### 実装
```swift
final class SpectralSubtractor {
    let fftSize: Int = 2048          // 44.1kHz で 46ms 窓
    let hopSize: Int = 512           // 75% overlap
    let window: [Float]              // Hann
    private let fft: vDSP.DFT<Float> // forward/inverse

    func process(input: AVAudioPCMBuffer,
                 noiseProfile: NoiseProfile,
                 oversubtraction: Float,
                 floor: Float) -> AVAudioPCMBuffer
}

struct NoiseProfile: Codable {
    let fftSize: Int
    let powerSpectrum: [Float]       // 長さ fftSize/2 + 1
    let sampleRate: Double
}
```
- 4096 サイズ FFT × 75% オーバーラップで 1 時間ぶんでも Apple Silicon で数〜十数秒
- `Progress` で進捗報告
- マルチチャンネルはチャンネル独立処理 (v1)

### UI フロー
Inspector → Noise Reduction タブ:
1. タイムラインで範囲選択
2. 「Capture Noise Profile」ボタン → 取得・保存
3. 「Strength」スライダー (0..1, 内部で α = 1 + strength * 1.5)
4. 「Apply to Clip」→ `ApplyEffectCommand` 発行、`effectChain` に追加

---

## 7. エクスポート

| フォーマット | ライタ | 備考 |
|---|---|---|
| WAV (PCM 16/24/32) | `AVAudioFile` (`kAudioFormatLinearPCM`) | 深度選択可 |
| AIFF | `AVAudioFile` (`kAudioFileAIFFType`) | 同上 |
| FLAC | `AVAudioFile` (`kAudioFormatFLAC`) | macOS 14 ネイティブ |
| ALAC | `AVAssetWriter` (`kAudioFormatAppleLossless`) | M4A コンテナ |
| AAC (M4A) | `AVAssetWriter` (`kAudioFormatMPEG4AAC`, `AVEncoderBitRateKey`) | 64/128/192/256/320 kbps |

Ogg Vorbis/Opus エクスポートは v1 非対応 (要件は入力のみ)。UI ではグレーアウト。

### オフラインレンダラー
```swift
final class OfflineRenderer {
    func render(project: Project,
                outputFormat: AVAudioFormat,
                onProgress: @escaping (Progress) -> Void) async throws -> AVAudioFile
    // 内部:
    // 1. AVAudioEngine を manualRenderingMode (.offline) で起動
    // 2. PlayerNode + EQ + Reverb を本番と同じ構成で接続
    // 3. クリップ列を 1 秒チャンクずつ schedule
    // 4. engine.renderOffline(_:to:) ループで output を集める
    // 5. AVAudioFile or AVAssetWriter に書き込む
}
```
**`AVAudioEngine.enableManualRenderingMode(_:format:maximumFrameCount:)`** で同じノードグラフをオフラインに切り替えるため、再生プレビューと書き出し結果のサウンドが完全一致する。

### 保存ダイアログ
`NSSavePanel` + `UTType` で拡張子フィルタ。サンドボックス下でも書き込み権限取得可能。

---

## 8. Undo / Redo (NSUndoManager)

```swift
protocol EditCommand {
    var actionName: String { get }
    @discardableResult
    func apply(to project: inout Project) -> any EditCommand   // 逆コマンドを返す
}

@MainActor @Observable
final class ProjectViewModel {
    var project: Project
    let undoManager: UndoManager

    func execute(_ command: any EditCommand) {
        let inverse = command.apply(to: &project)
        undoManager.registerUndo(withTarget: self) { [inverse] vm in
            vm.execute(inverse)
        }
        undoManager.setActionName(command.actionName)
    }
}
```
- `MainWindow.swift` で `.environment(\.undoManager, vm.undoManager)` を設定 → `⌘Z`/`⇧⌘Z` 自動配線
- 複合操作(範囲削除 = Split + Split + Remove)は `beginUndoGrouping`/`endUndoGrouping` でまとめる

---

## 9. セキュリティスコープ付きブックマーク

```swift
enum SecurityScopedBookmark {
    static func make(from url: URL) throws -> Data {
        try url.bookmarkData(options: .withSecurityScope,
                             includingResourceValuesForKeys: nil,
                             relativeTo: nil)
    }

    static func resolve(_ data: Data) throws -> (url: URL, isStale: Bool) {
        var isStale = false
        let url = try URL(resolvingBookmarkData: data,
                          options: .withSecurityScope,
                          relativeTo: nil,
                          bookmarkDataIsStale: &isStale)
        return (url, isStale)
    }

    /// RAII 的にスコープ付きアクセスをラップ
    static func withAccess<T>(_ data: Data, _ body: (URL) throws -> T) throws -> T {
        let (url, _) = try resolve(data)
        guard url.startAccessingSecurityScopedResource() else {
            throw VoiceEditError.bookmarkAccessDenied(url)
        }
        defer { url.stopAccessingSecurityScopedResource() }
        return try body(url)
    }
}
```
- デコーダ・波形ジェネレータは必ず `withAccess` 内でファイルを開く
- `isStale == true` なら `NSOpenPanel` で再選択を促す
- ピークキャッシュは `contentHash` キーなので、移動後も同一内容なら再計算不要

---

## 10. 検証手順

### 10-1. セットアップ
```bash
brew install xcodegen
cd /Users/fujisaki/VoiceEdit
xcodegen generate
open VoiceEdit.xcodeproj
```

### 10-2. ビルド検証
1. Xcode で `VoiceEdit` スキーム選択、ターゲット「My Mac」
2. `⌘B` で Build → 警告ゼロ
3. `⌘U` で `VoiceEditTests` 全緑
4. Universal Binary (`arm64;x86_64`) を確認

### 10-3. 機能チェックリスト

| # | シナリオ | 期待 |
|---|---|---|
| 1 | 起動 → 空プロジェクト | クラッシュなし |
| 2 | WAV をドラッグ&ドロップ | 1 秒以内に波形表示・再生可 |
| 3 | MP3 (CBR/VBR) 読込 | SFBDecoder 経由で再生 |
| 4 | Ogg Vorbis 読込 | 同上 |
| 5 | Opus 読込 | 同上 |
| 6 | FLAC 読込 | AVFoundation ネイティブで再生 |
| 7 | M4A AAC / ALAC 読込 | 同上 |
| 8 | AIFF 読込 | 同上 |
| 9 | 範囲選択 → Delete | 区間が消え波形が詰まる |
| 10 | Split → 中央 Delete | 9 と同結果(対称性確認) |
| 11 | 3 ファイル連続ドロップ → 並べ替え | 順序変更が再生順に反映 |
| 12 | Gain -6dB | 音量半減、書き出しでも同じ |
| 13 | フェードイン 2 秒 | 立ち上がりスムーズ |
| 14 | EQ 100Hz を -12dB | 低音減衰(聴感 + スペクトラム比較) |
| 15 | Reverb Cathedral wet=50% | 残響付与 |
| 16 | NR 強度 0.8 適用 | ホワイトノイズ低減 |
| 17 | `⌘Z` 連打 | 全操作が逆順 undo |
| 18 | `⇧⌘Z` 連打 | redo で全操作再適用 |
| 19 | 終了 → 再起動 → プロジェクト開く | ブックマークでファイル再オープン |
| 20 | ファイル移動 → 再起動 | `isStale` 警告で再選択 |
| 21 | エクスポート WAV 16bit 44.1kHz | QuickTime 再生可、サンプル数 EDL 一致 |
| 22 | エクスポート M4A AAC 256kbps | Music.app 再生可、ビットレート確認 |
| 23 | エクスポート FLAC | `afinfo` で形式確認 |
| 24 | エクスポート ALAC | 同上 |
| 25 | エクスポート進捗バー | スムーズ進行、キャンセル可 |
| 26 | 1 時間 MP3 読込 | 波形完成 3 秒以内、メモリ < 500MB |
| 27 | サンドボックス確認 | `codesign -d --entitlements - VoiceEdit.app` で sandbox=YES |

### 10-4. 自動テスト
```bash
xcodebuild test \
  -project /Users/fujisaki/VoiceEdit/VoiceEdit.xcodeproj \
  -scheme VoiceEdit \
  -destination 'platform=macOS'
```
- `ClipEditingTests`: Split → Join で復元(フレーム精度)
- `WaveformPeakTests`: 1kHz サイン波で ±1.0 近傍
- `SpectralSubtractionTests`: ホワイトノイズ + サイン波で SNR +10dB 改善
- `ExportRoundTripTests`: WAV ビット完全性
- `UndoRedoTests`: ランダム 100 操作 → 100 回 undo で初期状態

### 10-5. プロファイリング
- Instruments **Time Profiler**: 波形生成が CPU バウンド
- **Allocations**: 10 分連続再生でメモリ flat
- **Audio System Trace**: glitch ゼロ

---

## Critical Files

- `/Users/fujisaki/VoiceEdit/project.yml` — XcodeGen の単一の真実源
- `/Users/fujisaki/VoiceEdit/VoiceEdit/Audio/Engine/PlaybackEngine.swift` — AVAudioEngine 中核
- `/Users/fujisaki/VoiceEdit/VoiceEdit/Audio/Export/OfflineRenderer.swift` — 再生と書き出しのサウンド同一性を保証
- `/Users/fujisaki/VoiceEdit/VoiceEdit/Models/Clip.swift` — 非破壊編集データモデルの中心
- `/Users/fujisaki/VoiceEdit/VoiceEdit/Audio/Effects/SpectralSubtractor.swift` — ノイズ除去 DSP コア

---

## 実装着手順序の目安(一気に作る前提でも、コミット単位の指針)

1. `project.yml` / Entitlements / Info.plist / `.gitignore` 作成 → `xcodegen generate` でビルド可能な空アプリ
2. `Models/*` 全部とテスト
3. `SecurityScopedBookmark` + `AVFoundationDecoder` + `SFBDecoder` + `DecoderFactory`
4. `WaveformGenerator` + `WaveformPeakStore` + テスト
5. `PlaybackEngine` + `PlayerScheduler` + `EffectGraph` + `TransportState`
6. `Views/MainWindow` + `TimelineView` + `WaveformView` + `TransportToolbar` で最初の再生確認
7. `Editing/*` 全コマンド + `ProjectViewModel.execute` + Undo/Redo
8. `EQProcessor` / `ReverbProcessor` + Inspector の各エディタ
9. `GainProcessor` / `FadeProcessor` + Gain/Fade UI
10. `SpectralSubtractor` / `NoiseReducer` + Noise Reduction UI
11. `OfflineRenderer` + `AssetWriterEncoder` + `ExportSheet`
12. `ProjectCodable` で `.voiceedit` 保存/読込
13. アイコン、最終ポリッシュ、Instruments で性能確認

時間管理

  • 予定工数: 0:00時間
  • 作業時間: 16:00時間

詳細 | レポート

メンバー

Manager: 藤崎

Developer: 藤崎

Reporter: 藤崎

Redmine Appliance - Powered by TurnKey Linux