LanMountainDesktop/PenguinLogisticsOnlineNetworkDistributionSystem

PLONDS Skeleton

Penguin Logistics Online Network Distribution System, or PLONDS, is the standalone update-distribution skeleton for LanMountainDesktop.

This directory is intentionally isolated from the main app and Launcher. It contains only the new distribution protocol, a thin read-only API, and sample S3-style metadata files.

Directory Layout

PenguinLogisticsOnlineNetworkDistributionSystem/
  README.md
  src/
    Plonds.Shared/
    Plonds.Api/
  sample-data/
    meta/
      channels/
        stable/
          windows-x64/
          windows-x86/
          linux-x64/
      distributions/

Projects

• Plonds.Shared provides protocol constants and models.
• Plonds.Core owns hashing, diffing, object-repo generation, manifest generation, signing, and publish orchestration.
• Plonds.Tool is the CI-facing CLI entrypoint. PowerShell should stay as a thin wrapper around this tool.
• Plonds.Api is a thin read-only API that reads metadata from a local folder laid out like S3.

Architecture

PLONDS is intentionally built around a single C# implementation stack so the protocol and publish behavior do not drift across languages.

Host App
  -> checks updates, downloads objects, stages incoming payload
Launcher
  -> verifies signature, applies file map, switches deployment, rolls back

PLONDS.Api
  -> read-only metadata projection for clients
PLONDS.Tool
  -> CI/release command surface
PLONDS.Core
  -> hash/diff/object-repo/sign/publish implementation
PLONDS.Shared
  -> protocol constants and DTOs

Rules for v1:

• Core protocol behavior should live in Plonds.Core, not in PowerShell scripts.
• scripts/*.ps1 may remain only as thin wrappers for GitHub Actions and local convenience.
• Host keeps download responsibility.
• Launcher keeps apply, atomic switch, snapshot, and rollback responsibility.

Storage Layout

The first version keeps one fixed object root:

lanmountain/update/
  repo/sha256/<prefix>/<hash>
  meta/channels/<channel>/<platform>/latest.json
  meta/distributions/<distributionId>.json
  installers/<platform>/<version>/...

Planned but not enabled in v1:

lanmountain/update/repo-compressed/<algo>/<prefix>/<hash>
lanmountain/update/patches/<algo>/<baseHash>/<targetHash>

Public Endpoints

The API base path is /api/plonds/v1.

• GET /healthz
• GET /api/plonds/v1/metadata
• GET /api/plonds/v1/channels/{channel}/{platform}/latest?currentVersion=...
• GET /api/plonds/v1/distributions/{distributionId}

Local Run

dotnet run --project src/Plonds.Api

By default the API reads metadata from sample-data.