{
  "id": "3DARCH-FT-22",
  "type": "Feature",
  "title": "Speak with push-to-talk and spatial cues",
  "epic_id": "3DARCH-EP-5",
  "description": "Enable a participant to hold a voice control, grant microphone access, stream speech to the current-floor context, see who is speaking, and hear volume reflect speaker distance.",
  "user_problem": "Participants need hands-busy voice communication with visible speaking state and spatial listening cues.",
  "expected_value": "Adds immediate spoken coordination while preserving floor isolation and distance-aware feedback.",
  "scope": "Includes push-to-talk capture, permission feedback, current-floor relay, speaking indicators, distance-based volume, and explicit playback recovery.",
  "exclusions": [
    "Direct messaging, persistence, history, recording, transcription, and cross-floor communication are excluded."
  ],
  "acceptance_outcomes": [
    "Voice capture starts only while the configured push-to-talk action is active.",
    "Microphone denial or unsupported capture produces clear user feedback.",
    "Voice traffic remains isolated to the current floor.",
    "A speaking indicator identifies active speakers.",
    "Playback volume decreases to silence outside the approved proximity range.",
    "Playback can recover after browser autoplay restrictions through an explicit user action."
  ],
  "status": "IN_BACKLOG",
  "status_source": "EXACT",
  "blocked": false,
  "blocked_reason": null,
  "owner": "3D Architecture Wizzard team",
  "dependencies": [
    "3DARCH-FT-18",
    "3DARCH-FT-20"
  ],
  "risks": [
    "Voice is relayed floor-wide, does not reach silence outside the nominal range, and lacks complete autoplay recovery."
  ],
  "required_tasks": [],
  "approval": {
    "approved_for_solution": false,
    "approved_for_solution_by": null,
    "approved_for_solution_at": null,
    "conditions": [],
    "evidence_url": null,
    "approved_for_implementation": false,
    "approved_for_implementation_by": null,
    "approved_for_implementation_at": null,
    "implementation_conditions": [],
    "implementation_evidence_url": null
  },
  "catalogue_decision": {
    "decision": "Approved for documentation",
    "decided_by": "Linas",
    "decided_at": "2026-09-02T10:40:43.220Z",
    "evidence_url": "https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201",
    "conditions": [
      "Documentation approval does not grant Approved for Solution or implementation approval."
    ]
  },
  "sources": [
    {
      "label": "Discord – Scope – Linas: original Feature request",
      "url": "https://discord.com/channels/1518726359512387766/1543925247361814568/1544647879111483562"
    },
    {
      "label": "Discord – Scope – Linas: proceed with documented mapping",
      "url": "https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201"
    }
  ],
  "legacy_revision": "c0ced47ecaf4426f47e5c2e4868677f7144b951a",
  "legacy_evidence": [
    {
      "path": "apps/nebula/src/hooks/useVoiceChat.ts",
      "url": "https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/hooks/useVoiceChat.ts"
    },
    {
      "path": "apps/nebula/src/components/VoiceIndicator.tsx",
      "url": "https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/VoiceIndicator.tsx"
    },
    {
      "path": "apps/singularity/src/socket-server/voice-handler.ts",
      "url": "https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/socket-server/voice-handler.ts"
    },
    {
      "path": "packages/utils/constants/src/chat.ts",
      "url": "https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/packages/utils/constants/src/chat.ts"
    },
    {
      "path": "packages/utils/constants/src/controls.ts",
      "url": "https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/packages/utils/constants/src/controls.ts"
    }
  ],
  "architecture_traceability": {
    "requirements": [],
    "readiness": "Not started"
  },
  "release_evidence": [],
  "last_transition": {
    "event": "Catalogue registration",
    "from": null,
    "to": "IN_BACKLOG",
    "at": "2026-09-02T10:40:43.220Z",
    "actor": "Linas",
    "authority": "Human project team member",
    "reason": "The Feature catalogue was accepted for governed documentation and retained in the backlog.",
    "conditions": [
      "Registration records the accepted documentation boundary only.",
      "No solution or implementation approval is granted."
    ],
    "evidence_url": "https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201"
  }
}