# Technical Learnings: OurVend / TCN Ecosystem

Generated from TECHNICAL_LEARNINGS.md

    # 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.