# Nyx Domain Implementation Map

Generated on May 8, 2026. This document maps the current repository footprint
and Oshun-specific integration points for Nyx.

## Implementation Context

**Nyx** is a Cosmic Observatory Platform that combines interactive star mapping,
high-precision celestial calculations, VR planetarium experiences, AR sky
identification, telescope control, astrophotography tools, and educational
features into a complete astronomy ecosystem. This document describes every
user-facing feature from the perspective of stargazers, educators,
astrophotographers, and telescope operators.

## Status Snapshot

- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Dedicated Oshun domain adapter library present.
- TODO phases: `21`

## Applications

- `apps/nyx/api/` - Api
- `apps/nyx/ar-sky/` - Ar Sky
- `apps/nyx/education/` - Education
- `apps/nyx/mobile/` - Mobile
- `apps/nyx/pipelines/` - Pipelines
- `apps/nyx/star-map/` - Star Map
- `apps/nyx/tools/` - Tools
- `apps/nyx/vr-planetarium/` - Vr Planetarium

## Libraries

- `libs/nyx/analysis/` - Analysis
- `libs/nyx/api-client/` - Api Client
- `libs/nyx/audio/` - Audio
- `libs/nyx/catalogs/` - Catalogs
- `libs/nyx/client/` - Client
- `libs/nyx/client-python/` - Client Python
- `libs/nyx/constants/` - Constants
- `libs/nyx/constellations/` - Constellations
- `libs/nyx/coordinates/` - Coordinates
- `libs/nyx/database/` - Database
- `libs/nyx/docs/` - Docs
- `libs/nyx/education/` - Education
- `libs/nyx/ephemeris/` - Ephemeris
- `libs/nyx/events/` - Events
- `libs/nyx/integrations/` - Integrations
- `libs/nyx/lilith-integration/` - Lilith Integration
- `libs/nyx/mythology/` - Mythology
- `libs/nyx/orbital/` - Orbital
- `libs/nyx/positional/` - Positional
- `libs/nyx/README.md` - README.md
- `libs/nyx/realtime/` - Realtime
- `libs/nyx/renderer/` - Renderer
- `libs/nyx/time/` - Time
- `libs/nyx/time-travel/` - Time Travel
- `libs/nyx/types/` - Types
- `libs/nyx/utils/` - Utils
- `libs/nyx/visualization/` - Visualization
- `libs/nyx/widgets/` - Widgets

## Services

No repository entries discovered.

## OpenAPI And Contract Roots

No OpenAPI or domain-specific API root discovered.

## Existing Standalone Domain Docs

- `docs/domains/nyx/accuracy.md` - Accuracy.md
- `docs/domains/nyx/api/` - Api
- `docs/domains/nyx/architecture.md` - Architecture.md
- `docs/domains/nyx/database.md` - Database.md
- `docs/domains/nyx/developer-guide.md` - Developer Guide.md
- `docs/domains/nyx/features.md` - Features.md
- `docs/domains/nyx/README.md` - README.md
- `docs/domains/nyx/service-catalog.md` - Service Catalog.md
- `docs/domains/nyx/user-guide/` - User Guide
- `docs/domains/nyx/user-stories.md` - User Stories.md

## Test And Verification Evidence

- `testing/e2e/tests/nyx/star-map.browser.e2e.ts`
- `testing/e2e/tests/nyx/star-map.performance.e2e.ts`
- `testing/e2e/tests/nyx/star-map.visual.e2e.ts`

## Oshun Integration Summary

| Reference Scope | Count |
| --------------- | ----- |
| apps/oshun      | 548   |
| libs/oshun      | 221   |

## Oshun-Specific Integration References

- `apps/oshun/admin/.next/server/app/api/admin/workspaces/[workspaceId]/saved-views/route.js`
- `apps/oshun/admin/.next/server/app/inbox/page.js`
- `apps/oshun/admin/.next/server/app/incidents/page.js`
- `apps/oshun/admin/.next/server/app/policy/page.js`
- `apps/oshun/admin/.next/server/app/review/page.js`
- `apps/oshun/admin/.next/static/chunks/app/inbox/page.js`
- `apps/oshun/admin/.next/static/chunks/app/incidents/page.js`
- `apps/oshun/admin/.next/static/chunks/app/policy/page.js`
- `apps/oshun/admin/.next/static/chunks/app/review/page.js`
- `apps/oshun/bff/README.md`
- `apps/oshun/bff/openapi/oshun-bff.openapi.yaml`
- `apps/oshun/bff/src/__tests__/activity-route.test.ts`
- `apps/oshun/bff/src/__tests__/aggregation-response.test.ts`
- `apps/oshun/bff/src/__tests__/continue-route.test.ts`
- `apps/oshun/bff/src/__tests__/contract/shell-bff-contract.test.ts`
- `apps/oshun/bff/src/__tests__/contract/shell-bff-operations-contract.test.ts`
- `apps/oshun/bff/src/__tests__/cross-domain-recommendations-route.test.ts`
- `apps/oshun/bff/src/__tests__/customer-entitlement-feature-exposure.test.ts`
- `apps/oshun/bff/src/__tests__/domain-adapter-fixture.ts`
- `apps/oshun/bff/src/__tests__/domain-service-adapters.test.ts`
- `apps/oshun/bff/src/__tests__/domain-service-discovery.test.ts`
- `apps/oshun/bff/src/__tests__/domains-route.test.ts`
- `apps/oshun/bff/src/__tests__/feature-flags-route.test.ts`
- `apps/oshun/bff/src/__tests__/health-routes.test.ts`
- `apps/oshun/bff/src/__tests__/home-route.test.ts`

Additional references omitted: 744

## Documentation Gaps

- Repository implementation roots are present and reflected above.
- Standalone domain docs exist and were folded into the evidence profile.
- Domain test evidence exists and is listed above.
