78 lines
4.2 KiB
Markdown
78 lines
4.2 KiB
Markdown
# 碟雅产品AI中心
|
||
|
||
独立的统一应用门户项目，已配置提供的 8 个业务地址。采用原生 HTML、CSS、JavaScript 模块，无第三方依赖、无外部字体或 CDN；不需要 npm install。可独立部署到 Nginx、静态网站托管或现有 Web 服务器。
|
||
|
||
## 启动与构建
|
||
|
||
需要 Node.js 18 或更高版本。在项目目录打开终端：
|
||
|
||
```sh
|
||
npm run dev
|
||
```
|
||
|
||
浏览器访问 http://127.0.0.1:5173 。指定端口：`npm run dev -- --port 8080`。开发预览服务默认仅监听本机；生产环境请部署构建出的静态文件。
|
||
|
||
```sh
|
||
npm test
|
||
npm run build
|
||
```
|
||
|
||
将 `dist/` **里面的文件**上传到网站目录即可。无需运行 Node.js 生产服务。文件使用相对路径，支持部署在域名根目录或带结尾 `/` 的子目录。必须通过 HTTP/HTTPS 访问，不支持直接双击 HTML。服务器需为 `.mjs` 配置 JavaScript MIME 类型，参考 `deploy/nginx.conf.example`。
|
||
|
||
## 已集成入口
|
||
|
||
| 应用 | 地址 | 环境 |
|
||
| --- | --- | --- |
|
||
| 碟雅运营AI中心 | https://aiagent.dieya.net.cn/ | 正式 |
|
||
| 碟雅AI中心测试版 | https://aiagent1.dieya.net.cn/ | 测试 |
|
||
| 需求收集 | http://demand.dieya.net.cn/ | 正式 |
|
||
| 财务AI助手测试 | http://finance-test.dieya.net.cn/ | 测试 |
|
||
| 成本识别 | http://cost.dieya.net.cn/ | 正式 |
|
||
| 违禁词助手 | http://prohibite.dieya.net.cn/ | 正式 |
|
||
| 风险预警测试 | http://risk.dieya.net.cn/ | 测试 |
|
||
| 风险预警 | http://risk-prod.dieya.net.cn/ | 正式 |
|
||
|
||
不包含制度小助手。仅加入本次给出地址的 8 个应用，没有猜测截图中其他项目的地址。
|
||
|
||
## 页面功能
|
||
|
||
- 应用卡片点击后在当前窗口进入配置的完整 URL，浏览器或钉钉容器的返回操作可回到门户。
|
||
- 按应用名称、简介或域名搜索；按分类、正式/测试环境筛选。
|
||
- 星标收藏与“我的常用”，保存在当前浏览器的 localStorage，不跨设备同步，也不作为权限依据。
|
||
- 自适应桌面和手机，支持键盘访问；按 `/` 聚焦搜索，按 Escape 清空搜索。
|
||
|
||
## 维护应用
|
||
|
||
修改 `src/apps.mjs` 中的 `applications`，运行测试和构建后重新发布。
|
||
|
||
```js
|
||
{
|
||
id: 'unique-id',
|
||
name: '应用名称',
|
||
shortName: '简称',
|
||
description: '应用说明',
|
||
url: 'http://your-app.example.com/',
|
||
category: 'tools', // ai / tools / risk
|
||
environment: 'production', // production / test
|
||
color: 'blue', // blue / violet / teal / amber
|
||
icon: 'clipboard' // sparkles / clipboard / wallet / scan / text / shield
|
||
}
|
||
```
|
||
|
||
## 接入钉钉
|
||
|
||
1. 确定新门户的正式部署地址。此项目尚未绑定域名或发布到服务器。
|
||
2. 在钉钉开发者后台创建或配置企业内部网页应用，把门户的 URL 配为对应的移动端和电脑端首页，并配置需要的应用可见范围。具体后台字段以企业应用类型为准。
|
||
3. 从钉钉手机端与电脑端打开门户，逐个验证进入目标应用及返回门户的操作。
|
||
4. 目标系统各自维护免登、可信域名、回调地址和服务端权限校验。本门户没有模拟登录、没有采集凭据，也不会把 token 或免登码拼到目标链接。
|
||
5. 特别确认原应用是否依赖从工作台传入的 corpId、应用上下文或特定入口路径。普通域名跳转不会自动恢复这些参数；若依赖，需按目标应用的实际认证方式修改完整入口或做应用启动适配。
|
||
6. 验证全部入口可用后，再由企业管理员决定原工作台入口如何调整。制度小助手保留原独立入口。
|
||
|
||
运营 AI 中心和 AI 中心测试版已按确认的访问地址使用 HTTPS，其余 6 个应用保留原提供的 HTTP 地址。正式发布时请使用实际可用的协议；如果其他目标系统启用 HTTPS，应在配置中更新并重新验证。
|
||
|
||
## 集成范围
|
||
|
||
本项目完成的是应用入口统一，未合并原业务代码、数据库、登录会话或数据权限。所有卡片对能访问门户的人可见；本项目不是访问控制系统。如果后续需要按部门/角色展示卡片，需要增加门户后端或接入现有身份服务，且目标系统仍应自行鉴权。
|
||
|
||
已验证静态构建、入口映射与筛选逻辑；目标系统的线上可用性和钉钉内免登需在企业实际环境联调。
|