nex_design_system/docs/11-project-adoption.md

1.4 KiB
Raw Permalink Blame History

11. Project Adoption

1. 新项目

  1. 读取 nex.config.yaml;
  2. 按默认 stack 和 project.type 初始化技术骨架;
  3. 建立一份项目级 UI 规范,明确品牌方向、主题、布局/导航、组件使用约定、关键页面模式和特殊交互;
  4. 先复用 NEX 的通用原则,不要为项目创建重复的 NEX 组件包;
  5. 普通开发直接按 Agent 轻量流程推进。

2. 已有项目

  1. 识别当前技术栈、项目 UI 规范、主题/Token 来源和共享组件;
  2. 保留已验证成熟的设计和交互;
  3. 将项目差异视为项目适配,不机械迁移到 NEX 示例;
  4. 仅记录会影响后续开发的关键差异,不做大规模审计报告;
  5. 用户明确提出全局规范整理时,才制定单独计划。

3. 符合性映射(可选)

如果需要记录项目与 NEX 的关系,可在一份现有 UI 规范中加入简短映射:

  • ADOPTED:直接采用 NEX 原则;
  • ADAPTED:采用项目成熟实现;
  • DEFERRED:暂不处理;
  • NOT_APPLICABLE:项目不存在此类场景。

不要求每个新项目生成完整矩阵或长期维护逐条审计台账。

4. 冲突

NEX 原则与项目视觉选择冲突时,优先保留合理的项目设计;NEX 对一致性、组件复用、语义清晰和可用性的约束仍然适用。涉及用户目标不明确的产品决策时,提出一个关键问题,不要自行扩展范围。