# Technical Learnings: OurVend / TCN Ecosystem

## Cloud Infrastructure
- **Platform:** Yunshu Vending Machine Management System (OurVend).
- **Control Panel URL:** `https://dnymer.ourvend.com/` (Ant Design based UI).
- **Credentials:** Username `cc`, Password `ys123456`.
- **Institution:** `cc一级机构` (Primary Institution).
- **Selectors (Playwright Context):** The UI uses Ant Design. Sidebars are `.ant-layout-sider`. Menu items (Machine, Products, Payment) often require a click to expand the sub-menu before the actual target item becomes clickable or visible in the DOM. Use `visible` filters or exact text matches for better reliability.

## Machine Hardware (TCN-CSC-8C V49)
- **OS:** Android-based controller.
- **VMC Interaction:** Likely communicates via Serial/MDB with a lower-level Vending Machine Controller (VMC).
- **Screen:** 49" vertical touchscreen.
- **Cooling:** Integrated compressor, adjustable down to 4°C via `Machine Status` or local technician menu.
- **Connectivity:** 4G module is present. Supports Wi-Fi and Ethernet as failover.

## Integration Logic (Third-Party Payments)
- **The "Justin Chat" Context:** Justin (TCN contact) confirmed that 3rd party payment integration is standard and used by most customers. This suggests the TCN launcher has a native "External Payment" configuration field.
- **Mechanism Theory:** The machine likely calls a configured URL to get a QR code/payment payload and then waits for a server-side "Release Item" command (Remote Vend) or a success callback.
- **Integration Points:**
    - `Payment > Payment`: Currently has a PayPal template.
    - `Remote Track Configuration`: A VIP feature that must be enabled to allow price/stock sync and potentially remote vend triggers.
- **Keywords for Future Research:** `Remote Vend API`, `External Payment Protocol`, `Third-party QR`, `OurVend Callback`.

## Connectivity and Network
- **SIM Cards:** Local SIMs (AR) are necessary due to latency issues with factory roaming SIMs.
- **APN Setup:** Must be done locally on the machine. No remote APN configuration found in the cloud panel.
- **Telemetría:** Reports temperature, door status, drop sensor health, and 4G signal strength.

## Operation & Maintenance
- **Product Catalog:** Products are first added to a global catalog, then mapped to slots (tracks) per machine.
- **Track Management:** Allows cloning track mappings (Product + Price + Capacity) between machines of the same model.
- **Syncing:** Changes made in the cloud are NOT immediate. They require a `Sync` command or the machine to heartbeat back.
- **VIP Pricing:** Most remote management features are labeled as VIP. Justin claims "no need charge" unless it's deep customization, but the panel shows a credit-based system.
