ESLink Nexus Core

ESLink Nexus Core 是面向多业务项目复用的前端核心运行时框架。

目标：

• 统一登录、菜单、路由、权限、守卫、401 失效处理的核心能力
• 让业务项目只做项目适配（接口、字段映射、主题、页面组件）
• 让核心升级可控、可回滚、可追溯

一、架构定位

三层职责固定：

1. RBAC 控制面：统一账号、角色、菜单、权限码、数据边界、业主单位配置发布
2. Nexus Core 运行面：认证编排、权限上下文、路由装配、守卫策略、请求中间层
3. 业务应用层：业务页面、业务 API、业务样式和模块功能

核心原则：

• 核心不反向依赖业务
• 外部差异通过 Adapter/Strategy/Hook 注入
• 先稳边界与契约，再扩功能
• eslink-central 仅用于复盘借鉴，不作为代码迁移源

二、当前阶段

当前仓库已完成阶段 6（多项目复制接入），当前状态：

• 阶段 0/1（复盘冻结 + 契约冻结）已完成
• 阶段 2（状态机 + runtime 编排 + 契约校验 + 最小降级）已完成
• 阶段 3（Adapter/Strategy/Hook 扩展模型）已完成
• 阶段 4（首个试点项目适配验证）已完成
• 阶段 5（质量门禁与发布机制）已完成
• 阶段 6（多项目复制接入）已完成
• Core V1 阶段 0~6 全部闭环完成

三、核心文档目录

• docs/core-v1/coding-standards.md：编码规范 V1（冻结版）
• docs/core-v1/architecture-blueprint.md：Core V1 架构蓝图（冻结版）
• docs/core-v1/reference-review-eslink-central.md：eslink-central 复盘参考（仅借鉴）
• docs/core-v1/build-roadmap.md：从零建设路线图
• docs/core-v1/stage-0-1-task-plan.md：阶段 0/1 执行任务清单（冻结版）
• docs/core-v1/stage-0-gate-pass-record.md：阶段0 Gate 通过记录（S0-T01 ~ S0-T06）
• docs/core-v1/contract-terminology-v1.md：契约术语清单 V1（S1-T01 冻结版）
• docs/core-v1/stage-1-s1-t01-pass-record.md：阶段1 S1-T01 通过记录
• docs/core-v1/core-config-v1.md：CoreConfig v1 字段冻结规范（S1-T02）
• docs/core-v1/stage-1-s1-t02-pass-record.md：阶段1 S1-T02 通过记录
• docs/core-v1/auth-permission-context-v1.md：AuthContext / PermissionContext v1 冻结规范（S1-T03）
• docs/core-v1/stage-1-s1-t03-pass-record.md：阶段1 S1-T03 通过记录
• docs/core-v1/manifest-v1.md：Manifest v1 冻结规范（S1-T04）
• docs/core-v1/stage-1-s1-t04-pass-record.md：阶段1 S1-T04 通过记录
• docs/core-v1/guard-error-v1.md：GuardDecision / NexusError v1 冻结规范（S1-T05）
• docs/core-v1/stage-1-s1-t05-pass-record.md：阶段1 S1-T05 通过记录
• docs/core-v1/version-handshake-v1.md：版本握手策略 v1（S1-T06）
• docs/core-v1/stage-1-s1-t06-pass-record.md：阶段1 S1-T06 通过记录
• docs/core-v1/contract-validation-failure-v1.md：契约校验与失败策略 v1（S1-T07）
• docs/core-v1/stage-1-s1-t07-pass-record.md：阶段1 S1-T07 通过记录
• docs/core-v1/adapter-minimal-sample-v1.md：最小 Adapter 接入样例 v1（S1-T08）
• docs/core-v1/stage-1-s1-t08-pass-record.md：阶段1 S1-T08 通过记录
• docs/core-v1/stage-1-gate-pass-record.md：阶段1 Gate 通过记录（S1-T01 ~ S1-T09）
• docs/core-v1/stage-2-task-plan.md：阶段2 执行任务清单（S2-T01 ~ S2-T06）
• docs/core-v1/stage-2-gate-pass-record.md：阶段2 Gate 通过记录（S2-T01 ~ S2-T06）
• docs/core-v1/stage-3-task-plan.md：阶段3 执行任务清单（S3-T01 ~ S3-T06）
• docs/core-v1/stage-3-gate-pass-record.md：阶段3 Gate 通过记录（S3-T01 ~ S3-T06）
• docs/core-v1/stage-4-task-plan.md：阶段4 执行任务清单（S4-T01 ~ S4-T06）
• docs/core-v1/stage-4-pilot-adapter-validation.md：阶段4 试点 Adapter 验证记录
• docs/core-v1/stage-4-gate-pass-record.md：阶段4 Gate 通过记录（S4-T01 ~ S4-T06）
• docs/core-v1/stage-5-task-plan.md：阶段5 执行任务清单（S5-T01 ~ S5-T07）
• docs/core-v1/stage-5-quality-release-governance.md：阶段5 质量与发布治理规范
• docs/core-v1/stage-5-regression-suite-spec.md：阶段5 最小回归集规范
• docs/core-v1/stage-5-compatibility-matrix.md：阶段5 兼容矩阵规范
• docs/core-v1/stage-5-gate-pass-record.md：阶段5 Gate 通过记录（S5-T01 ~ S5-T07）
• docs/core-v1/stage-6-task-plan.md：阶段6 执行任务清单（S6-T01 ~ S6-T06）
• docs/core-v1/stage-6-multi-project-onboarding.md：阶段6 多项目接入手册
• docs/core-v1/stage-6-troubleshooting-guide.md：阶段6 故障排查手册
• docs/core-v1/stage-6-upgrade-guide.md：阶段6 升级指南
• docs/core-v1/stage-6-gate-pass-record.md：阶段6 Gate 通过记录（S6-T01 ~ S6-T06）
• docs/core-v1/sensitive-term-banlist-v1.md：敏感词禁用清单 V1（严格模式）
• docs/core-v1/sensitive-term-neutral-dictionary-v1.md：敏感词中性替代字典 V1（严格模式）
• docs/release/templates/release-note-template.md：Release Note 模板
• docs/release/templates/migration-guide-template.md：Migration Guide 模板
• docs/release/templates/rollback-playbook-template.md：Rollback Playbook 模板
• docs/release/npm-manual-publish-sop.md：npm 手动发布标准流程（SOP）

四、执行层目录

• AGENTS.md：人类与 AI 开发执行约束
• handbook/AGENTS.md：开发者手册独占区执行约束
• .github/pull_request_template.md：PR 强制检查模板
• .github/workflows/quality-gates.yml：CI 质量门禁
• scripts/ci/check-frozen-docs.sh：冻结文档与规则基线检查
• scripts/ci/check-handbook-boundary.sh：handbook 独占区边界与结构检查
• scripts/ci/check-handbook-site-integrity.mjs：handbook 站点完整性检查（锚点/折叠/复制按钮/资源路径）
• scripts/ci/run-project-gates.sh：项目脚本门禁（lint/typecheck/test/build/contract:check）
• docs/adr/README.md：ADR 流程说明
• docs/adr/template.md：ADR 模板
• docs/adr/0001-governance-baseline.md：治理基线 ADR

五、本地检查

bash scripts/ci/check-frozen-docs.sh
bash scripts/ci/check-handbook-boundary.sh
node scripts/ci/check-handbook-site-integrity.mjs
bash scripts/ci/run-project-gates.sh

六、开发者手册网页（本地）

宿主项目可通过 Vite 开发插件访问手册网页，默认路径：/_nexus/docs。

接入示例：

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import { nexusDocsPlugin } from '@broke_wire/eslink-nexus-core/vite'

export default defineConfig({
  plugins: [vue(), nexusDocsPlugin({ route: '/_nexus/docs' })],
})

说明：

1. 插件为 serve-only（仅开发环境生效）。
2. 生产构建自动忽略手册网页资源。
3. 手册页面内置教学资源入口（/_nexus/docs/resources/*）。