PolyhydraGames.CDN 1.0.3.208

Polyhydra CDN & Retro Media Engine

The primary backend service for the Polyhydra CDN ecosystem, consolidating media management, automated indexing, and retro-gaming metadata enrichment.

Tags

• api
• api-cdn
• dotnet
• cdn
• docs
• testing

Related Repos

• Media-Metadata
• API.VideoGames
• Api.RetroAchievements
• Api.Streaming
• core.ffmpeg

Project Structure

• WebAPI (src/WebAPI): Consolidated service for media clips, CDN indexing, and the RetroAchievements proxy.
• RetroMedia Library (src/Api.RetroMedia): Core business logic, parsers, and platform rules.
• UI & Tools: WPF and Core conversion utilities.

Documentation

Comprehensive feature and infrastructure documentation can be found in the docs/features directory:

• System Overview
• Folder Structure & Mapping
• WebAPI Features
• RetroMedia Library
• RetroAchievements Integration
• Infrastructure & Deployment

Getting Started

Local Development

The project uses the modern .slnx solution format.

# Open the solution in VS 2022 or Rider
PolyhydraGames.Api.CDN.slnx

Running the API

cd src/WebAPI
dotnet run

Swagger UI will be available at: http://localhost:5000/swagger

Testing

The project uses NUnit for unit testing. Some tests require a mock CDN directory structure.

# Run all tests
dotnet test

Local CDN fallback for development and validation

When the expected CDN mount paths (for example /mnt/syn2/cdn/roms) are not available on a local workstation, use deterministic fixture or temporary-root validation instead of guessing at live CDN state. Local validation should point the Cdn configuration at a known fixture tree or a disposable temp directory that contains the required gamelist.xml and media samples for the test being exercised.

Required Cdn values for local runs are:

• RootPath: root of the local or fixture CDN tree.
• RetroPath: retro-media subpath when the code path expects one; keep it aligned with the fixture layout.
• ArchiveRoot: writable archive/temp location for archive-related tests or local runs.
• BaseUrl: base URL used when generated links are asserted or smoke-tested.

RetroAchievements (RaUser/RaKey) credentials are only required for live RA/online smoke paths. Do not add or invent secrets for deterministic local tests; remote CDN and RA checks should remain smoke-only and should be documented as such in the validation handoff.

If the intended mount path, runtime host, or credential boundary differs from the existing docs, block and add an explicit note rather than guessing. The setup/readiness rule is: deterministic fixture/temp-root tests prove local behavior; live CDN/RA checks only prove connectivity and current external availability.

Documentation

XML documentation is enabled for the core library. Build the project to generate the .xml documentation file.

Configuration

Configure the Cdn section in appsettings.json or Environment Variables:

"Cdn": {
  "RootPath": "/path/to/cdn",
  "ArchiveRoot": "/var/lib/polyhydra/cdn-archive",
  "ScanIntervalMinutes": 60,
  "BaseUrl": "https://your-cdn-url.com",
  "RaUser": "RA_USERNAME",
  "RaKey": "RA_API_KEY"
}