ALPHA-Z · Documentation

文档与组件维护

ALPHA-Z 的领域分层、品牌配置与演示数据维护方式。

目录与分层

Fumadocs 内容放在 components/docs/content,由 meta.json 维护导航。产品依据为 docs/量枢智能项目功能介绍.md;原始交付资料保留历史目录,不批量重命名。

继续使用现有八个领域:agent、platform、news、user、token、chat、admin、workflow。

  • lib/<域>:类型、领域样本、getter 与纯计算,不放 React 和 UI 样式。
  • hooks/:领域取数、缓存与状态派生,是业务组件的数据入口。
  • components/<域>:业务组件自行取数,页面只编排布局和少量 UI 状态。
  • components/ui:HeroUI 及现有共享组件,不引入第二套组件库。

Agent 列表、详情和模拟跟单共用同一领域来源;公告属于 news;真实与演示账户属于 user,二者记录不得混合。

品牌与导航

品牌显示配置在 config/main.ts 的 APP_CONFIG。移动端固定首页、跟单、Agent、公告、我的五个入口,二级功能由我的页面与桌面侧栏进入。

主题默认浅色,保留用户已存偏好及暗色。界面文案使用 next-intl;业务样本内容可使用来源文本。交易数字使用公共格式化方法。

兼容性约束

品牌展示不等于协议迁移。不得为改名修改账户 salt、签名原文、合约地址和 ABI、稳定 Agent ID、存储键、查询键或 API 路径。AI Token 的符号和地址以当前 Bank 部署配置为准。

产品不再提供平台积分;中心化交易授权、公告发布后台等未接入能力,不应通过按钮或文案表现为已上线。

验证

pnpm typecheck
pnpm lint
pnpm build

界面改动须同时检查浅色和暗色、手机和平板/桌面、直接访问详情与无效 ID。验收不得发送真实交易、执行充值或调用付费模型;资金实测需单独确认。