CashChangerSimulator.Device
0.0.1-pre
dotnet add package CashChangerSimulator.Device --version 0.0.1-pre
NuGet\Install-Package CashChangerSimulator.Device -Version 0.0.1-pre
<PackageReference Include="CashChangerSimulator.Device" Version="0.0.1-pre" />
<PackageVersion Include="CashChangerSimulator.Device" Version="0.0.1-pre" />
<PackageReference Include="CashChangerSimulator.Device" />
paket add CashChangerSimulator.Device --version 0.0.1-pre
#r "nuget: CashChangerSimulator.Device, 0.0.1-pre"
#:package CashChangerSimulator.Device@0.0.1-pre
#addin nuget:?package=CashChangerSimulator.Device&version=0.0.1-pre&prerelease
#tool nuget:?package=CashChangerSimulator.Device&version=0.0.1-pre&prerelease
CashChanger Simulator - Core
This repository contains the core logic and hardware device emulation for the CashChanger Simulator. It is designed as a modular foundational component that powers various user interfaces.
📦 Repositories in this Project
This project is split into several modular repositories:
- CashChangerSimulator.Core: Platform-independent core logic, managers, and shared models.
- CashChangerSimulator.Device.Virtual: Platform-independent device simulation logic and controllers.
- CashChangerSimulator.Device.PosForDotNet: Windows-specific POS for .NET (UPOS) adapter layer.
🚀 Live Demo / Simulator API
The Virtual Cash Changer API is available on Google Cloud Run for testing without local setup:
- Base URL: https://cash-changer-api-904915502524.asia-northeast1.run.app
- Interactive Documentation (Scalar): View API Reference
Key Features (Platform-Independent Core)
- Decoupled Architecture: Strictly separates business logic (
Core), simulation logic (Device.Virtual), and hardware interface adapters (Device.PosForDotNet). - UPOS Compliant Behavior: Emulates
DispenseChange,DispenseCash, and the full deposit cycle through a virtual device layer. - Multi-Platform Ready: The Core and Virtual Device projects have zero dependency on Windows-specific libraries, enabling use in Web APIs, CLIs, or Linux environments.
- Inventory & Transaction Logic: Robust state management for cash inventory and deposit tracking using platform-independent types.
Setup
Prerequisites
- .NET 10.0 SDK
Build
# Build the core library and device simulator
dotnet build
Publishing for Local Use (NuGet)
To use these libraries in your UI projects, pack and publish them to a local NuGet source:
./scripts/publish_local.ps1
Documentation
For more detailed information, please refer to the documents in the docs/ directory:
- Architecture Overview: High-level system design.
- UPOS Compliance Mapping: Status of UPOS interface implementation.
- OPOS Compliance Mapping: Mapping of OPOS error codes and result codes.
For the Japanese version, see README_JP.md.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- CashChangerSimulator.Core (>= 0.0.1-pre)
- R3 (>= 1.3.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|