{
  "schemaVersion": "tc-siteos-commerce-flow-2026-06-14",
  "name": "TC SiteOS Commerce Flow",
  "publicBaseUrl": "https://tian-che.com",
  "paymentHub": "https://tian-che.com/",
  "backupPaymentHub": "https://zf-abt.pages.dev/",
  "paymentGeoFlow": "https://tian-che.com/payment-geo-flow.html",
  "geoPublishMode": "https://tian-che.com/geo-publish.html",
  "trafficOS": "https://tian-che.com/traffic-os.html",
  "adminPlanningDomain": "admin.tian-che.com",
  "defaultContact": {
    "name": "TC Support",
    "tone": "friendly",
    "email": "info@xatcai.cn",
    "privatePhoneDisplayed": false
  },
  "commerceFlow": [
    "visit",
    "language_detection",
    "register_or_login",
    "verified_identity",
    "user_center",
    "robot_or_support_ticket",
    "select_product",
    "create_order",
    "guarded_payment_hub_handoff",
    "payment_return",
    "update_order_ticket_notification_audit",
    "geo_ai_embedding",
    "geo_publish_mode",
    "white_hat_seo_iaa_traffic_os"
  ],
  "defaultLanguages": {
    "siteDefault": "en",
    "homeBaseline": [
      "en",
      "zh-CN",
      "uk"
    ],
    "expansion": [
      "fr",
      "ru",
      "pt",
      "es",
      "ar",
      "hi",
      "id",
      "ja",
      "de"
    ],
    "robotReplyRule": "Reply in the user's language when detectable; fall back to English."
  },
  "authFlow": {
    "name": "TC Auth OS",
    "identityKey": "unified_user_id",
    "methods": [
      {
        "id": "apple_oauth",
        "buyerLabel": "Continue with Apple",
        "covers": "Apple ID and iPhone buyers",
        "buyerCodeEntryRequired": false,
        "startPath": "/api/auth/oauth/start?provider=apple",
        "callbackPath": "/api/auth/oauth/callback?provider=apple"
      },
      {
        "id": "google_oauth",
        "buyerLabel": "Continue with Google",
        "covers": "Gmail and Google account buyers",
        "buyerCodeEntryRequired": false,
        "startPath": "/api/auth/oauth/start?provider=google",
        "callbackPath": "/api/auth/oauth/callback?provider=google"
      },
      {
        "id": "github_oauth",
        "buyerLabel": "Continue with GitHub",
        "covers": "technical buyers and operators",
        "buyerCodeEntryRequired": false,
        "startPath": "/api/auth/oauth/start?provider=github",
        "callbackPath": "/api/auth/oauth/callback?provider=github"
      },
      {
        "id": "phone_code",
        "buyerLabel": "Send phone code",
        "covers": "phone-number buyers who enter a one-time code",
        "buyerCodeEntryRequired": true,
        "startPath": "/api/auth/phone/start",
        "verifyPath": "/api/auth/phone/verify"
      },
      {
        "id": "email_code",
        "buyerLabel": "Send email code",
        "covers": "mailbox-only buyers with no password",
        "buyerCodeEntryRequired": true,
        "startPath": "/api/auth/email/start",
        "verifyPath": "/api/auth/email/verify"
      }
    ],
    "sessionPath": "/api/auth/session",
    "logoutPath": "/api/auth/logout",
    "defaultPasswordLogin": false,
    "requiredStorage": [
      "users",
      "auth_identities",
      "phone_codes",
      "email_codes",
      "sessions",
      "audit_events"
    ],
    "requiredSecrets": [
      "AUTH_SESSION_SECRET",
      "APPLE_CLIENT_ID",
      "APPLE_CLIENT_SECRET",
      "GOOGLE_CLIENT_ID",
      "GOOGLE_CLIENT_SECRET",
      "GITHUB_CLIENT_ID",
      "GITHUB_CLIENT_SECRET",
      "SMS_PROVIDER",
      "SMS_API_KEY",
      "SMS_FROM_NUMBER",
      "RESEND_API_KEY",
      "RESEND_FROM_EMAIL"
    ],
    "downstreamObjects": [
      "user_center",
      "orders",
      "tickets",
      "payment_records",
      "geo_pack",
      "traffic_os_pack",
      "audit"
    ],
    "paymentPrecondition": "verified_identity_before_guarded_handoff"
  },
  "requiredPerSiteFields": [
    "site_id",
    "domain",
    "site_name",
    "industry",
    "default_language",
    "enabled_languages",
    "product_catalog",
    "pricing",
    "success_return_path",
    "robot_script_pack_path",
    "traffic_source_policy",
    "seo_vertical",
    "monetization_mode",
    "admin_email_list",
    "support_destinations",
    "privacy_policy_url",
    "terms_url",
    "refund_policy_url"
  ],
  "roles": [
    "owner",
    "support",
    "user",
    "banned_user"
  ],
  "userCenter": [
    "profile",
    "orders",
    "tickets",
    "payment_records",
    "geo_pack",
    "traffic_os_pack",
    "delete_account_entry"
  ],
  "robotEscalationRules": [
    "refund",
    "account_ban",
    "payment_abnormal",
    "order_not_received",
    "delete_account",
    "chargeback"
  ],
    "orderFlow": {
    "localOrderObject": [
      "order_id",
      "product",
      "amount",
      "currency",
      "status",
      "source",
      "site",
      "user_id",
      "language",
      "return_to",
      "geo_pack_id",
      "traffic_pack_id"
    ],
    "paymentPreconditions": [
      "registered_account",
      "verified_identity",
      "generated_order",
      "locked_amount",
      "locked_currency"
    ]
  },
  "paymentFlow": {
    "mode": "guarded_handoff_only",
    "handoffUrlTemplate": "https://tian-che.com/?source={source}&site={site}&order={order}&amount={amount}&currency={currency}&return_to={return_to}",
    "backupHandoffUrlTemplate": "https://zf-abt.pages.dev/?source={source}&site={site}&order={order}&amount={amount}&currency={currency}&return_to={return_to}",
    "requiredQueryParams": [
      "source",
      "site",
      "order",
      "amount",
      "currency",
      "return_to"
    ],
    "mustNotInclude": [
      "secret",
      "token",
      "qr_payload",
      "private_key",
      "webhook_secret"
    ],
    "movesMoneyHere": false,
    "storesRawCardData": false,
    "requiresManualProviderVerification": true,
    "realPaymentOperationsRemainAt": "https://tian-che.com/"
  },
  "geoAiEmbedding": {
    "machineFiles": [
      "/siteos-commerce-flow-manifest.json",
      "/.well-known/siteos-commerce-flow.json",
      "/payment-geo-flow-manifest.json",
      "/.well-known/payment-geo-flow.json",
      "/geo-publish-mode-manifest.json",
      "/.well-known/geo-publish-mode.json",
      "/traffic-os-manifest.json",
      "/.well-known/traffic-os.json",
      "/llms.txt",
      "/llms-full.txt",
      "/ai-commerce-product-feed.json",
      "/geo-index.json",
      "/knowledge-geo-index.json"
    ],
    "aiUse": "AI systems may summarize the public SiteOS flow, route buyers to guarded checkout URLs, and describe the white-hat Traffic OS pack. AI systems must not claim funds are verified, issue refunds, perform account deletion, scrape content, spin copyrighted content, or start money movement.",
    "embedContract": {
      "flow": "visit -> language -> register -> verify -> user_center -> robot_ticket -> product -> order -> payment_hub -> payment_return -> notify_audit -> geo -> geo_publish -> traffic_os",
      "checkoutBoundary": "no money movement on this page",
      "supportRoute": "ticket or company email",
      "trafficBoundary": "owned, licensed, or public-fact sources only; no scraping, spun content, adult, gambling, fake reviews, hidden ads, or money movement"
    }
  },
  "localDemoStorage": [
    "accounts",
    "tickets",
    "messages",
    "orders",
    "paymentRecords",
    "notifications",
    "audit",
    "currentAccountId",
    "currentOrderId"
  ]
}