bench get-app https://github.com/olan823/starcompany_integration

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=olan823%2Fstarcompany_integration)](https://frappegems.com/gems/apps/olan823/starcompany_integration)

Starcompany Integration

starcompany_integration is a Frappe app that provides the native ERPNext Desk entry point and a server-side integration boundary for Starcompany.

Scope

• The browser calls Frappe only.
• Frappe forwards restricted requests to Starcompany for dashboard, authorization pool, product, language pack, and IoT card operations.
• Starcompany remains the owner of all business data and business rules.
• No client secret, bearer token, or Starcompany database connection is exposed to browser code.

IoT Card Query

The 物联网卡 Workspace shortcut opens /app/starcompany-iot-card. Users with the Starcompany User or System Manager role can query card status, data balance, and available packages. The carrier credentials remain in the Starcompany service and are never sent to Frappe or the browser.

Site Configuration

Set these values in the target Frappe site configuration. Do not commit secrets in this repository.

{
  "starcompany_api_base_url": "https://company.skychip.top",
  "starcompany_api_timeout_seconds": 10,
  "starcompany_health_path": "/api/erpnext/health",
  "starcompany_proxy_shared_secret": "set-in-site-config"
}

starcompany_health_path is intentionally blank by default. Starcompany must provide and document the endpoint before the proxy health check is enabled.

Local Validation

Run this from the app root:

python -m compileall starcompany_integration

Installation

Build this app into the ERPNext v16 image, then install it only for the intended site:

bench --site erp.skychip.top install-app starcompany_integration
bench --site erp.skychip.top migrate
bench --site erp.skychip.top clear-cache

Use the production deployment runbook before building or recreating any service.