> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artstarex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ArtStar 平台架构设计

> ArtStar 总体架构分层解析：前端交互、后端服务与链上执行的协同闭环

## 概述

ArtStar 的架构设计围绕一个核心目标展开：让艺术品 RWA 的发行、申购、合规、同步和后续流通，能够在前端、后端和链上之间形成稳定闭环

这个架构不是单纯的 DApp，也不是传统 Web2 平台，而是一个“前端负责体验、后端负责聚合、链上负责结算”的混合型产品架构

## 总体架构分层

<Card title="三层协同架构" icon="layer-group">
  ArtStar 的系统被抽象为以下三个核心层级：
</Card>

<Columns>
  <Column>
    <Card title="前端交互层" icon="desktop">
      将复杂的链上和后端状态组织成用户可理解的产品流程 \*
      展示项目、资产、市场信息 \* 处理钱包连接与签名登录 \* 承接 KYC
      流程与状态引导 \* 发起链上授权与申购交易 \* 展示用户资产与行为数据
    </Card>
  </Column>

  <Column>
    <Card title="后端服务层" icon="server">
      承担“状态聚合”和“业务编排”职责，补齐链上能力 \* 用户资料与会话管理 \* KYC
      异步回调处理 \* 邀请、返佣、积分流水聚合 \* 链上事件同步与索引 \*
      提供前端查询接口
    </Card>
  </Column>

  <Column>
    <Card title="链上执行层" icon="link">
      负责平台最关键的可信执行逻辑与资产结算 \* 稳定币授权与扣款 \* 资产份额铸造
      (Mint) \* 发售状态与白名单控制 \* 流动性池初始化 \* 资产的最终真相源
    </Card>
  </Column>
</Columns>

## 数据流链路说明

一个典型的申购流程会经历以下完整的交互链路：

<Steps>
  <Step title="钱包接入">用户在前端连接钱包</Step>
  <Step title="身份认证">前端发起签名登录并获取后端会话</Step>

  <Step title="状态聚合">
    前端同时读取用户 KYC 状态、白名单状态和资产发售状态
  </Step>

  <Step title="授权扣款">用户完成稳定币授权 (Approve)</Step>
  <Step title="执行购买">用户发起申购 (Mint / Purchase) 交易</Step>

  <Step title="链上同步">
    链上交易确认后，事件被异步同步到后端进行解析与记录
  </Step>

  <Step title="UI 刷新">
    前端根据链上结果和后端聚合数据，刷新页面展示最新状态
  </Step>
</Steps>

## 架构设计原则

<Callout type="warning" title="前端不保存业务最终真相">
  前端可以缓存和展示状态，但最终真相应来自链上合约和后端数据库，而不是本地内存
</Callout>

<Callout type="danger" title="后端负责聚合，不篡改链上结论">
  后端可以增强查询和校验体验，但不能替代链上对资产行为的最终判定
</Callout>

<Callout type="info" title="合规能力必须前置">
  KYC、白名单和网络检查等逻辑，应在用户点击交易前完成，以减少无效交易和失败体验
</Callout>

<Callout type="check" title="状态同步必须可追踪">
  无论是购买记录、KYC
  状态、返佣结果还是积分变动，都必须具备可查询、可对账和可解释能力
</Callout>

***

ArtStar 的架构设计本质上是在平衡三件事：链上的可信执行、后端的状态聚合，以及前端的低门槛交互体验。只有三层协同，艺术品 RWA 才能真正变成可用的产品