<template>
  <div class="help-content">
    <div class="content-header">
      <h2>平台对接概述与集成逻辑</h2>
    </div>
    
    <p class="intro">
      本节帮助开发者快速梳理统一认证平台与业务系统的对接流程，包括应用创建、用户同步策略以及账号映射规则。
    </p>

    <div class="section">
      <h3>1. 核心对接流程</h3>
      <ol>
        <li><strong>创建应用：</strong> 首先需要在本平台创建一个应用，获取 App ID 和 Secret。</li>
        <li><strong>用户同步（初始化）：</strong> 
          <ul>
            <li>将现有业务系统的用户数据同步到本平台（映射表），可以省去后续逐个初始化的烦恼。</li>
            <li>建议在系统上线前进行一次全量同步。</li>
          </ul>
        </li>
        <li><strong>统一认证登录与账号自动创建：</strong>
          <ul>
            <li>当用户通过统一认证平台登录您的业务系统时，如果您的系统中尚无该用户信息（例如新注册用户）：
              <p>您可以直接在业务系统中创建一个无权限的初始账号，完成“自动注册”。</p>
            </li>
            <li><strong>场景示例：</strong> 用户在统一认证平台已有账号（或通过短信注册），但在您的业务平台数据库中不存在（即该平台还没有这个手机号码或映射账号数据）。
              <ul>
                 <li>此时，您可以通过接口获取用户信息。</li>
                 <li>开发者可以先创建该用户（相当于同步到您的平台来）。</li>
              </ul>
            </li>
          </ul>
        </li>
      </ol>
    </div>

    <div class="section">
      <h3>2. 账号同步与映射规则</h3>
      <p>在使用账号同步功能时，请注意以下关键规则：</p>
      <ul>
        <li><strong>手机号码（唯一标识）：</strong> 用户的手机号码是统一认证平台的核心标识，<strong>同步后不能修改</strong>。</li>
        <li><strong>可修改字段：</strong> 您只能修改用户的 <strong>映射账号</strong> (Mapped Account/ID) 和 <strong>邮箱</strong>。这允许您在业务系统账号变更时更新映射关系。</li>
      </ul>
    </div>

    <div class="section">
      <h3>3. 用户管理数据说明</h3>
      <ul>
        <li><strong>姓名与英文名：</strong> 在“用户管理”中维护的姓名和英文名称字段，<strong>不与特定应用的账号映射强行关联</strong>。</li>
        <li><strong>设计目的：</strong> 这部分是为了方便平台数据初始化和展示，方便管理员识别用户身份，而不作为业务系统的强校验字段。</li>
      </ul>
    </div>
  </div>
</template>

<script setup lang="ts">
</script>

<style scoped>
@import './help.css';
</style>
