docs: publish legacy feature catalogue

2026-09-03 08:14:14 +00:00
parent 94ffd5d4cf
commit 3a2e19fc52
139 changed files with 8681 additions and 203 deletions
@@ -0,0 +1,107 @@
+{
+  "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"
+  }
+}