docs: publish legacy feature catalogue
Build and publish 3D Architecture Wizzard documentation / build (pull_request) Successful in 22s

This commit is contained in:
2026-09-03 08:14:14 +00:00
parent 94ffd5d4cf
commit 3a2e19fc52
139 changed files with 8681 additions and 203 deletions
@@ -0,0 +1,85 @@
---
title: "3DARCH-FT-10 — First-entry avatar onboarding"
description: "Enable a first-time user to preview, rotate, zoom, choose, and persist an in-world avatar before entering the workplace."
---
# First-entry avatar onboarding
| Feature | Parent Epic | Delivery status | Status source | Owner | Approved for Solution |
|---|---|---|---|---|---|
| `3DARCH-FT-10` | [3DARCH-EP-2 — Secure Access and Personal Setup](../../3darch-ep-2.md) | `IN_BACKLOG` | `EXACT` | 3D Architecture Wizzard team | No |
## Description
Enable a first-time user to preview, rotate, zoom, choose, and persist an in-world avatar before entering the workplace.
## User or operator problem
First-time users need to choose an embodied workplace identity before entering the shared environment.
## Expected value
Ensures every new participant enters with a persisted, recognizable in-world representation.
## Scope
Includes first-entry gating, avatar preview controls, selection persistence, onboarding completion, and entry with the selected avatar.
### Exclusions
- Administrator access, account recovery, display-name editing, and unwired self-service logout are excluded.
## Acceptance outcomes
- [ ] An unonboarded user cannot enter the workplace before completing avatar selection.
- [ ] Available avatars can be previewed from multiple viewing angles.
- [ ] Confirmation persists the avatar and onboarding completion.
- [ ] The selected avatar appears when the user enters.
## Dependencies
- [3DARCH-FT-9 — Enterprise sign-in and session continuity](./3darch-ft-9.md)
## Risks
- Reselecting the existing avatar can fail to mark onboarding complete.
## Human approval
Linas approved this Feature for documentation on 2026-09-02T10:40:43.220Z. It is **not Approved for Solution** and has no implementation approval.
- [Documentation decision](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Delivery status evidence
The Feature was separately registered at `IN_BACKLOG` as an accepted catalogue boundary. This records backlog retention, not design or delivery progress.
- Event: Catalogue registration
- Actor and authority: Linas — Human project team member
- Reason: The Feature catalogue was accepted for governed documentation and retained in the backlog.
- [Status evidence](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Architecture traceability
- Requirements: none derived.
- Readiness: Not started.
Architecture solution work must not begin until a separate human **Approved for Solution** decision is recorded.
## Tasks
[Review the Tasks group](./3darch-ft-10/tasks.md). No canonical implementation Tasks have been defined.
## Original source
- [Discord – Scope – Linas: original Feature request](https://discord.com/channels/1518726359512387766/1543925247361814568/1544647879111483562)
- [Discord – Scope – Linas: proceed with documented mapping](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
### Legacy implementation evidence
The Feature boundary was mined from legacy revision `c0ced47ecaf4426f47e5c2e4868677f7144b951a`.
- [`apps/nebula/src/App.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/App.tsx)
- [`apps/nebula/src/components/CharacterSelection/CharacterSelection.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/CharacterSelection/CharacterSelection.tsx)
- [`apps/singularity/src/routes/auth.routes.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/routes/auth.routes.ts)
- [`apps/nebula/src/test/components/CharacterSelection.test.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/test/components/CharacterSelection.test.tsx)
@@ -0,0 +1,8 @@
---
title: "3DARCH-FT-10 Tasks"
description: "Review canonical implementation Tasks governed beneath 3DARCH-FT-10."
---
# Review 3DARCH-FT-10 Tasks
No canonical implementation Tasks have been defined for [3DARCH-FT-10](../3darch-ft-10.md). Architecture must first receive a separate human **Approved for Solution** decision, derive requirements and readiness evidence, and then register any resulting Tasks through Scope governance.
@@ -0,0 +1,85 @@
---
title: "3DARCH-FT-11 — Review profile and change workplace appearance"
description: "Enable a returning user to review the enterprise identity represented in the workplace and replace the visible avatar without repeating onboarding."
---
# Review profile and change workplace appearance
| Feature | Parent Epic | Delivery status | Status source | Owner | Approved for Solution |
|---|---|---|---|---|---|
| `3DARCH-FT-11` | [3DARCH-EP-2 — Secure Access and Personal Setup](../../3darch-ep-2.md) | `IN_BACKLOG` | `EXACT` | 3D Architecture Wizzard team | No |
## Description
Enable a returning user to review the enterprise identity represented in the workplace and replace the visible avatar without repeating onboarding.
## User or operator problem
Returning users need to inspect their enterprise identity and change the avatar coworkers see.
## Expected value
Lets users keep their visible workplace representation current without repeating onboarding.
## Scope
Includes profile identity display, reopening avatar selection, persistence of the replacement, and propagation to other participants.
### Exclusions
- Administrator access, account recovery, display-name editing, and unwired self-service logout are excluded.
## Acceptance outcomes
- [ ] Settings display the authenticated profile identity.
- [ ] The user can reopen avatar selection from the profile area.
- [ ] A changed avatar persists and is rendered to other participants.
## Dependencies
- [3DARCH-FT-9 — Enterprise sign-in and session continuity](./3darch-ft-9.md)
- [3DARCH-FT-10 — First-entry avatar onboarding](./3darch-ft-10.md)
## Risks
- Unavailable avatar assets or delayed propagation can produce inconsistent identity across clients.
## Human approval
Linas approved this Feature for documentation on 2026-09-02T10:40:43.220Z. It is **not Approved for Solution** and has no implementation approval.
- [Documentation decision](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Delivery status evidence
The Feature was separately registered at `IN_BACKLOG` as an accepted catalogue boundary. This records backlog retention, not design or delivery progress.
- Event: Catalogue registration
- Actor and authority: Linas — Human project team member
- Reason: The Feature catalogue was accepted for governed documentation and retained in the backlog.
- [Status evidence](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Architecture traceability
- Requirements: none derived.
- Readiness: Not started.
Architecture solution work must not begin until a separate human **Approved for Solution** decision is recorded.
## Tasks
[Review the Tasks group](./3darch-ft-11/tasks.md). No canonical implementation Tasks have been defined.
## Original source
- [Discord – Scope – Linas: original Feature request](https://discord.com/channels/1518726359512387766/1543925247361814568/1544647879111483562)
- [Discord – Scope – Linas: proceed with documented mapping](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
### Legacy implementation evidence
The Feature boundary was mined from legacy revision `c0ced47ecaf4426f47e5c2e4868677f7144b951a`.
- [`apps/nebula/src/components/SettingsModal/parts/Profile/Profile.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/SettingsModal/parts/Profile/Profile.tsx)
- [`apps/nebula/src/components/CharacterSelection/CharacterSelection.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/CharacterSelection/CharacterSelection.tsx)
- [`apps/nebula/src/components/Player.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/Player.tsx)
- [`apps/singularity/src/routes/auth.routes.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/routes/auth.routes.ts)
@@ -0,0 +1,8 @@
---
title: "3DARCH-FT-11 Tasks"
description: "Review canonical implementation Tasks governed beneath 3DARCH-FT-11."
---
# Review 3DARCH-FT-11 Tasks
No canonical implementation Tasks have been defined for [3DARCH-FT-11](../3darch-ft-11.md). Architecture must first receive a separate human **Approved for Solution** decision, derive requirements and readiness evidence, and then register any resulting Tasks through Scope governance.
@@ -0,0 +1,86 @@
---
title: "3DARCH-FT-12 — Discover and retain personal controls"
description: "Enable a user to learn the workplace controls, prevent movement controls from interfering with text/settings interaction, and retain mouse sensitivity across visits."
---
# Discover and retain personal controls
| Feature | Parent Epic | Delivery status | Status source | Owner | Approved for Solution |
|---|---|---|---|---|---|
| `3DARCH-FT-12` | [3DARCH-EP-2 — Secure Access and Personal Setup](../../3darch-ep-2.md) | `IN_BACKLOG` | `EXACT` | 3D Architecture Wizzard team | No |
## Description
Enable a user to learn the workplace controls, prevent movement controls from interfering with text/settings interaction, and retain mouse sensitivity across visits.
## User or operator problem
Users need discoverable controls that do not interfere with typing and settings, with sensitivity retained across visits.
## Expected value
Improves control discoverability and preserves a usable personal interaction setup.
## Scope
Includes the controls guide, movement suppression during text/settings input, mouse-sensitivity adjustment, persistence, and save-failure feedback.
### Exclusions
- Administrator access, account recovery, display-name editing, and unwired self-service logout are excluded.
## Acceptance outcomes
- [ ] A visible controls guide explains supported keyboard actions.
- [ ] Typing or using settings does not trigger movement actions.
- [ ] Mouse sensitivity can be adjusted and restored in a later session.
- [ ] Save failures are surfaced rather than silently discarded.
## Dependencies
- [3DARCH-FT-9 — Enterprise sign-in and session continuity](./3darch-ft-9.md)
## Risks
- Settings persistence failures can leave the displayed sensitivity different from the retained value.
## Human approval
Linas approved this Feature for documentation on 2026-09-02T10:40:43.220Z. It is **not Approved for Solution** and has no implementation approval.
- [Documentation decision](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Delivery status evidence
The Feature was separately registered at `IN_BACKLOG` as an accepted catalogue boundary. This records backlog retention, not design or delivery progress.
- Event: Catalogue registration
- Actor and authority: Linas — Human project team member
- Reason: The Feature catalogue was accepted for governed documentation and retained in the backlog.
- [Status evidence](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Architecture traceability
- Requirements: none derived.
- Readiness: Not started.
Architecture solution work must not begin until a separate human **Approved for Solution** decision is recorded.
## Tasks
[Review the Tasks group](./3darch-ft-12/tasks.md). No canonical implementation Tasks have been defined.
## Original source
- [Discord – Scope – Linas: original Feature request](https://discord.com/channels/1518726359512387766/1543925247361814568/1544647879111483562)
- [Discord – Scope – Linas: proceed with documented mapping](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
### Legacy implementation evidence
The Feature boundary was mined from legacy revision `c0ced47ecaf4426f47e5c2e4868677f7144b951a`.
- [`apps/nebula/src/components/ControlsLayout.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/ControlsLayout.tsx)
- [`apps/nebula/src/components/SettingsModal/parts/Controls/Controls.tsx`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/components/SettingsModal/parts/Controls/Controls.tsx)
- [`apps/nebula/src/stores/settingsStore.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/stores/settingsStore.ts)
- [`apps/nebula/src/hooks/usePlayerCamera.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/hooks/usePlayerCamera.ts)
- [`apps/singularity/src/routes/auth.routes.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/routes/auth.routes.ts)
@@ -0,0 +1,8 @@
---
title: "3DARCH-FT-12 Tasks"
description: "Review canonical implementation Tasks governed beneath 3DARCH-FT-12."
---
# Review 3DARCH-FT-12 Tasks
No canonical implementation Tasks have been defined for [3DARCH-FT-12](../3darch-ft-12.md). Architecture must first receive a separate human **Approved for Solution** decision, derive requirements and readiness evidence, and then register any resulting Tasks through Scope governance.
@@ -0,0 +1,86 @@
---
title: "3DARCH-FT-9 — Enterprise sign-in and session continuity"
description: "Enable a user to enter through enterprise SSO, remain signed in through token refresh, and return to sign-in when the session cannot be recovered."
---
# Enterprise sign-in and session continuity
| Feature | Parent Epic | Delivery status | Status source | Owner | Approved for Solution |
|---|---|---|---|---|---|
| `3DARCH-FT-9` | [3DARCH-EP-2 — Secure Access and Personal Setup](../../3darch-ep-2.md) | `IN_BACKLOG` | `EXACT` | 3D Architecture Wizzard team | No |
## Description
Enable a user to enter through enterprise SSO, remain signed in through token refresh, and return to sign-in when the session cannot be recovered.
## User or operator problem
Enterprise users need trusted access that survives normal token expiry without separate workplace credentials.
## Expected value
Provides secure session continuity and a single enterprise identity boundary for protected HTTP and real-time access.
## Scope
Includes enterprise OIDC redirect/callback, user upsert, protected cookies, token refresh, request recovery, and authenticated socket admission.
### Exclusions
- Administrator access, account recovery, display-name editing, and unwired self-service logout are excluded.
## Acceptance outcomes
- [ ] Successful SSO creates or updates the user and returns the user to the workplace.
- [ ] Access and refresh credentials remain in protected cookies.
- [ ] Expired access is refreshed once and queued requests resume after recovery.
- [ ] Authenticated real-time connections reject invalid or duplicate sessions safely.
## Dependencies
- [3DARCH-FT-8 — Package, deploy, and health-check workplace services](../../3darch-ep-1/features/3darch-ft-8.md)
## Risks
- Duplicate-session handling redirects to a hard-coded legacy location and self-service sign-out is not wired in the client.
## Human approval
Linas approved this Feature for documentation on 2026-09-02T10:40:43.220Z. It is **not Approved for Solution** and has no implementation approval.
- [Documentation decision](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Delivery status evidence
The Feature was separately registered at `IN_BACKLOG` as an accepted catalogue boundary. This records backlog retention, not design or delivery progress.
- Event: Catalogue registration
- Actor and authority: Linas — Human project team member
- Reason: The Feature catalogue was accepted for governed documentation and retained in the backlog.
- [Status evidence](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
## Architecture traceability
- Requirements: none derived.
- Readiness: Not started.
Architecture solution work must not begin until a separate human **Approved for Solution** decision is recorded.
## Tasks
[Review the Tasks group](./3darch-ft-9/tasks.md). No canonical implementation Tasks have been defined.
## Original source
- [Discord – Scope – Linas: original Feature request](https://discord.com/channels/1518726359512387766/1543925247361814568/1544647879111483562)
- [Discord – Scope – Linas: proceed with documented mapping](https://discord.com/channels/1518726359512387766/1543925247361814568/1544658325738885201)
### Legacy implementation evidence
The Feature boundary was mined from legacy revision `c0ced47ecaf4426f47e5c2e4868677f7144b951a`.
- [`apps/singularity/src/routes/auth.routes.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/routes/auth.routes.ts)
- [`apps/singularity/src/config/auth.config.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/config/auth.config.ts)
- [`apps/nebula/src/hooks/useAuthRefresh.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/hooks/useAuthRefresh.ts)
- [`apps/nebula/src/api.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/nebula/src/api.ts)
- [`apps/singularity/src/socket-server/index.ts`](https://gitea.lego-cloud.eu/corp-v1-3darch-legacy/corp-v1-3darch-legacy/src/commit/c0ced47ecaf4426f47e5c2e4868677f7144b951a/apps/singularity/src/socket-server/index.ts)
@@ -0,0 +1,8 @@
---
title: "3DARCH-FT-9 Tasks"
description: "Review canonical implementation Tasks governed beneath 3DARCH-FT-9."
---
# Review 3DARCH-FT-9 Tasks
No canonical implementation Tasks have been defined for [3DARCH-FT-9](../3darch-ft-9.md). Architecture must first receive a separate human **Approved for Solution** decision, derive requirements and readiness evidence, and then register any resulting Tasks through Scope governance.