# ngportal **Repository Path**: kingecg/ngportal ## Basic Information - **Project Name**: ngportal - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-31 - **Last Updated**: 2026-02-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Angular 19 Web UI Portal Framework 这是一个基于 Angular 19 和 ng-zorro-antd 构建的插件化 Web UI Portal 框架,支持动态加载第三方 UI 插件,提供完整的前后端分离架构。 ## 特性 - 🚀 **Angular 19** - 最新版 Angular 框架 - 🎨 **ng-zorro-antd v19.3.x** - 企业级 UI 组件库 - 🔌 **插件化架构** - 支持动态加载第三方 UI 插件 - 🛡️ **安全沙箱** - 插件运行在隔离的环境中 - 📦 **完整皮肤系统** - 支持亮色/暗色主题切换和自定义皮肤 - 🧪 **单元测试覆盖** - 使用 Angular TestBed 进行测试 - 🐳 **Docker 支持** - 完整的容器化部署方案 ## 项目结构 ``` src/ ├── app/ │ ├── core/ # 核心模块 │ │ ├── services/ # 核心服务 │ │ ├── guards/ # 路由守卫 │ │ └── interceptors/ # HTTP 拦截器 │ ├── modules/ # 功能模块 │ ├── components/ # 共享组件 │ ├── models/ # 数据模型 │ └── utils/ # 工具函数 ├── assets/ │ ├── plugins/ # 动态插件存储目录 │ └── schemas/ # JSON Schema 验证文件 └── styles/ ├── _variables.scss # 皮肤变量定义 └── _mixins.scss # 样式混入定义 ``` ## 快速开始 ### 前提条件 - Node.js 18+ 和 npm 10+ - Angular CLI 19+ ### 安装依赖 ```bash npm install ``` ### 启动开发服务器 ```bash ng serve ``` 打开浏览器访问 `http://localhost:4200/` ### 构建项目 ```bash ng build ``` 构建产物将输出到 `dist/ngportal` 目录 ### 运行单元测试 ```bash ng test ``` ## 插件开发指南 ### 1. 创建插件清单 创建 `plugin-manifest.json` 文件: ```json { "id": "my-plugin", "name": "我的插件", "version": "1.0.0", "entryPoint": "index.html", "routePath": "/my-plugin", "permissions": ["read"] } ``` ### 2. 实现插件界面 创建标准的 HTML/JavaScript 应用,通过 PostMessage API 与主应用通信。 ### 3. 打包插件 将插件文件打包为 ZIP 格式,包含: - plugin-manifest.json - 静态资源文件 ### 4. 部署插件 通过门户的上传界面部署插件,系统将自动验证和激活插件。 ## 皮肤系统 ### 主题切换 框架支持亮色和暗色主题切换,所有组件自动适配主题颜色。 ### 自定义皮肤 通过修改以下文件自定义皮肤: 1. `src/styles/_variables.scss` - 定义颜色、字体、间距等变量 2. `src/styles/_mixins.scss` - 定义可复用的样式混入 3. `src/styles.scss` - 全局样式配置 ### CSS 变量 框架使用 CSS 变量实现动态主题,支持以下变量: ```css :root { --primary-color: #1890ff; --bg-color-body: #f5f5f5; --text-color-primary: #333; /* ... 更多变量 */ } ``` ## 核心服务 ### PluginManagerService 管理插件的加载、卸载和生命周期。 ### PluginRegistryService 注册、存储和查询插件信息。 ### PluginCommunicationService 处理主应用与插件之间的安全通信。 ## 部署 ### Docker 部署 ```bash docker-compose up -d ``` ### 生产环境配置 1. 配置环境变量 2. 设置反向代理 3. 启用 HTTPS 4. 配置插件存储目录 ## 贡献指南 欢迎提交 Issue 和 Pull Request 来改进这个项目。 ## 许可证 MIT License ## 相关链接 - [Angular 官方文档](https://angular.dev) - [ng-zorro-antd 文档](https://ng.ant.design) - [Angular CLI](https://angular.dev/tools/cli)