# ESLinkNexusCore

**Repository Path**: FYML/eslink-nexus-core

## Basic Information

- **Project Name**: ESLinkNexusCore
- **Description**: 面向多业务项目复用的前端核心运行时框架
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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
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`。

接入示例：

```ts
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/*`）。