rust-port/wifi-densepose-rs/docs/ddd/domain-model.md
Purpose: Raw CSI data acquisition and preprocessing
Aggregates:
CsiFrame: Raw CSI measurement from WiFi hardwareProcessedSignal: Cleaned and feature-extracted signalValue Objects:
Amplitude: Signal strength measurementsPhase: Phase angle measurementsSubcarrierData: Per-subcarrier informationTimestamp: Measurement timingDomain Services:
CsiProcessor: Preprocesses raw CSI dataPhaseSanitizer: Unwraps and cleans phase dataFeatureExtractor: Extracts signal featuresPurpose: Human pose estimation from processed signals
Aggregates:
PoseEstimate: Complete DensePose outputInferenceSession: Neural network session stateValue Objects:
BodyPart: Labeled body segment (torso, arms, legs, etc.)UVCoordinate: Surface mapping coordinateKeypoint: Body joint positionConfidence: Prediction confidence scoreDomain Services:
ModalityTranslator: CSI → visual feature translationDensePoseHead: Body part segmentation and UV regressionPurpose: Real-time data delivery to clients
Aggregates:
Session: Client connection with historyStreamConfig: Client streaming preferencesValue Objects:
WebSocketMessage: Typed message payloadConnectionState: Active/idle/disconnectedDomain Services:
StreamManager: Manages client connectionsBroadcastService: Pushes updates to subscribersPurpose: Persistence and retrieval
Aggregates:
Recording: Captured CSI sessionModelArtifact: Neural network weightsRepositories:
SessionRepository: Session CRUD operationsRecordingRepository: Recording storageModelRepository: Model managementPurpose: Physical device management
Aggregates:
Device: WiFi router/receiverAntenna: Individual antenna configurationDomain Services:
DeviceManager: Device discovery and controlCsiExtractor: Raw CSI extraction┌─────────────────────────────────────────────────────────────┐
│ WiFi-DensePose │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ │
│ │ Hardware │────▶│ Signal │────▶│ Pose │ │
│ │ Domain │ │ Domain │ │ Domain │ │
│ └──────────────┘ └──────────────┘ └─────────────┘ │
│ │ │ │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Storage Domain │ │
│ └──────────────────────────────────────────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Streaming Domain │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
| Term | Definition |
|---|---|
| CSI | Channel State Information - WiFi signal properties |
| Subcarrier | Individual frequency component in OFDM |
| Phase Unwrapping | Correcting 2π phase discontinuities |
| DensePose | Dense human pose estimation with UV mapping |
| Modality Translation | Converting CSI features to visual features |
| Body Part | One of 15 labeled human body segments |
| UV Mapping | 2D surface parameterization of 3D body |