dieya-app-portal/README.md

4.2 KiB
Raw Blame History

碟雅产品AI中心

独立的统一应用门户项目,已配置提供的 8 个业务地址。采用原生 HTML、CSS、JavaScript 模块,无第三方依赖、无外部字体或 CDN;不需要 npm install。可独立部署到 Nginx、静态网站托管或现有 Web 服务器。

启动与构建

需要 Node.js 18 或更高版本。在项目目录打开终端:

npm run dev

浏览器访问 http://127.0.0.1:5173 。指定端口:npm run dev -- --port 8080。开发预览服务默认仅监听本机;生产环境请部署构建出的静态文件。

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,运行测试和构建后重新发布。

{
  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,应在配置中更新并重新验证。

集成范围

本项目完成的是应用入口统一,未合并原业务代码、数据库、登录会话或数据权限。所有卡片对能访问门户的人可见;本项目不是访问控制系统。如果后续需要按部门/角色展示卡片,需要增加门户后端或接入现有身份服务,且目标系统仍应自行鉴权。

已验证静态构建、入口映射与筛选逻辑;目标系统的线上可用性和钉钉内免登需在企业实际环境联调。