@lovrabet/cli 1.1.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@lovrabet/cli",
+  "version": "1.1.0",
+  "license": "MIT",
+  "bin": {
+    "lovrabet": "lib/cli.js"
+  },
+  "type": "module",
+  "module": "lib/cli.js",
+  "main": "lib/cli.js",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf lib && tsc && javascript-obfuscator lib --output lib",
+    "start": "tsc --watch",
+    "sync-template": "node scripts/sync-template.js",
+    "release": "bun run build && bun pm version patch && git push && git push origin --tag && bun publish"
+  },
+  "files": [
+    "lib",
+    "templates"
+  ],
+  "dependencies": {
+    "@types/winston": "^2.4.4",
+    "execa": "^9.6.0",
+    "ink": "^6.2.3",
+    "ink-spinner": "^5.0.0",
+    "javascript-obfuscator": "^4.1.1",
+    "listr": "^0.14.3",
+    "meow": "^13.2.0",
+    "prettier": "^3.6.2",
+    "react": "^19.1.1",
+    "winston": "^3.17.0"
+  },
+  "devDependencies": {
+    "@types/listr": "^0.14.9",
+    "@types/react": "^19.1.12",
+    "typescript": "latest"
+  }
+}

package/templates/README.md

@@ -0,0 +1,115 @@
+# Lovrabet CLI 模板说明
+
+此目录包含 Lovrabet CLI 工具的模板文件。
+
+## 目录结构
+
+```
+templates/
+├── README.md           # 本说明文档
+├── pages/              # 页面模板，用于 `lovrabet add page` 命令
+│   ├── blank/          # 简单空白页面模板
+│   └── hello-world/    # 功能丰富的演示页面模板
+└── projects/           # 项目模板，用于 `lovrabet create project` 命令
+    └── sub-app-react-demo/  # Git 子模块，指向主模板仓库
+```
+
+## 页面模板
+
+### 可用占位符标签
+
+创建页面模板（`.tsx.tpl` 文件）时，可以使用以下占位符标签，它们会被自动替换：
+
+| 标签 | 说明 | 示例 |
+|-----|------|------|
+| `{ComponentName}` | PascalCase 组件名 | `UserProfile` |
+| `{DisplayTitle}` | 人类可读的标题 | `User Profile` |
+| `{PageName}` | 原始的 kebab-case 页面名 | `user-profile` |
+| `{TemplateName}` | 使用的模板名称 | `blank` |
+| `{CreatedAt}` | 创建时的 ISO 时间戳 | `2024-09-14T15:30:45.123Z` |
+| `{CreatedDate}` | 创建日期 | `2024-09-14` |
+| `{CreatedTime}` | 创建时间 | `15:30:45` |
+
+### 模板文件命名
+
+- 模板文件应使用 `.tpl` 扩展名（如 `index.tsx.tpl`）
+- 生成时会自动移除 `.tpl` 扩展名
+- CLI 会处理所有文本文件（`.tsx`, `.ts`, `.jsx`, `.js`, `.json`, `.md`, `.css`, `.scss`, `.tpl`）
+
+### 模板使用示例
+
+```tsx
+/**
+ * Generated by Lovrabet CLI
+ * Template: {TemplateName}
+ * Created: {CreatedAt}
+ * Page: {PageName}
+ */
+import React from "react";
+
+function {ComponentName}() {
+  return <div>{DisplayTitle} 页面</div>;
+}
+
+export default {ComponentName};
+```
+
+### 添加新页面模板
+
+1. 在 `templates/pages/` 下创建新目录（如 `templates/pages/my-template/`）
+2. 添加带 `.tpl` 扩展名的模板文件
+3. 使用上述文档化的占位符标签
+4. 无需修改 CLI 代码 - 任何新模板都会自动工作！
+
+## 项目模板
+
+### Git 子模块同步
+
+`projects/sub-app-react-demo/` 目录是一个 Git 子模块，指向：
+**仓库地址**: https://github.com/lovrabet-ai/sub-app-react-demo
+
+#### 开发者：同步模板
+
+更新项目模板到最新版本：
+
+```bash
+# 方法一：使用内置同步脚本
+npm run sync
+
+# 方法二：手动 git 子模块命令
+git submodule update --remote --merge
+git add templates/projects/sub-app-react-demo
+git commit -m "Update project template to latest version"
+```
+
+#### 初始设置（新克隆时）
+
+```bash
+# 初始化并更新所有子模块
+git submodule update --init --recursive
+```
+
+### 模板结构
+
+项目模板应维护以下结构：
+- 标准的 React + Vite 设置
+- Ant Design 集成
+- icestark 微前端配置
+- 页面管理的路由配置
+
+## 贡献指南
+
+添加新模板时：
+
+1. **页面模板**：放置在 `templates/pages/[template-name]/` 中
+2. **使用占位符标签**：遵循文档化的标签系统
+3. **文件扩展名**：需要处理的模板文件使用 `.tpl`
+4. **本地测试**：提交前使用新模板生成页面进行测试
+5. **更新此 README**：记录任何新功能或标签
+
+## 注意事项
+
+- 模板在页面/项目生成过程中被复制和处理
+- CLI 使用 `TemplateReplacer` 工具进行标签替换
+- 生成的文件包含显示生成元数据的头部注释
+- 所有模板支持国际化并可根据需要扩展

package/templates/generate-api/api.ts.tpl

@@ -0,0 +1,42 @@
+/**
+ * Generated by Lovrabet CLI
+ * Created: {CreatedAt}
+ *
+ * 这个文件包含了项目的模型配置，并自动注册到 SDK 中
+ * CLI 工具会自动维护这个文件，通常不需要手动修改
+ */
+
+import { registerModels, CONFIG_NAMES, type ModelsConfig } from "@lovrabet/sdk";
+
+export const LOVRABET_APP_CODE = "{AppCode}";
+
+/**
+ * 项目的模型配置
+ * 包含所有数据表的映射关系
+ */
+export const LOVRABET_MODELS_CONFIG: ModelsConfig = {
+  appCode: LOVRABET_APP_CODE,
+  models: {{ModelConfigs}}
+} as const;
+
+/**
+ * 自动注册配置
+ * 配置名称: {ConfigName}
+ */
+registerModels(LOVRABET_MODELS_CONFIG, {ConfigName});
+
+/**
+ * 如果需要支持多项目或多环境，可以注册额外的配置：
+ *
+ * // 开发环境配置
+ * registerModels({
+ *   appCode: 'app-dev-123',
+ *   models: { ... }
+ * }, 'dev');
+ *
+ * // 其他项目配置
+ * registerModels({
+ *   appCode: 'other-project',
+ *   models: { ... }
+ * }, 'project-b');
+ */

package/templates/generate-api/client.ts.tpl

@@ -0,0 +1,64 @@
+/**
+ * Lovrabet SDK 客户端实例
+ * Generated by Lovrabet CLI
+ * Created: {CreatedAt}
+ *
+ * 这个文件负责创建和导出统一的客户端实例，供整个应用使用
+ * 通过导入 './api' 文件来自动执行配置注册
+ */
+
+import { createClient } from "@lovrabet/sdk";
+import "./{ApiFileName}"; // 导入配置文件，执行 registerModels() 注册
+
+/**
+ * 主要的客户端实例
+ * 使用配置名称 '{ConfigName}' 创建客户端
+ */
+export const lovrabetClient = createClient({ClientConfigParam});
+
+/**
+ * 使用示例：
+ *
+ * // 在组件中使用
+ * import { lovrabetClient } from '@/api/client';
+ *
+ * // 获取数据列表
+ * const data = await lovrabetClient.models.{ExampleModelName}.getList({
+ *   currentPage: 1,
+ *   pageSize: 20
+ * });
+ *
+ * // 获取单条记录
+ * const record = await lovrabetClient.models.{ExampleModelName}.getOne('123');
+ *
+ * // 创建新记录
+ * const newRecord = await lovrabetClient.models.{ExampleModelName}.create({
+ *   // 记录数据
+ * });
+ */
+
+/**
+ * 其他创建客户端的方式（根据需要选择）：
+ *
+ * 1. 使用默认配置（无参数调用）：
+ * export const lovrabetClient = createClient();
+ *
+ * 2. 使用其他已注册的配置：
+ * export const devClient = createClient('dev');
+ * export const prodClient = createClient('prod');
+ *
+ * 3. 直接传入配置对象：
+ * import { LOVRABET_MODELS_CONFIG } from './api';
+ * export const lovrabetClient = createClient(LOVRABET_MODELS_CONFIG);
+ *
+ * 4. 通过 ClientConfig 指定配置名和其他选项：
+ * export const lovrabetClient = createClient({
+ *   apiConfigName: 'default',
+ *   token: 'custom-token',
+ *   env: 'daily'
+ * });
+ *
+ * 5. 多项目支持示例：
+ * export const projectAClient = createClient('project-a');
+ * export const projectBClient = createClient('project-b');
+ */

package/templates/pages/blank/index.tsx.tpl

@@ -0,0 +1,13 @@
+/**
+ * Generated by Lovrabet CLI
+ * Template: {TemplateName}
+ * Created: {CreatedAt}
+ * Page: {PageName}
+ */
+import React from "react";
+
+function {ComponentName}() {
+  return <div style={{ padding: "24px" }}>{DisplayTitle} 页面</div>;
+}
+
+export default {ComponentName};

package/templates/pages/sdk-fetch/index.tsx.tpl

@@ -0,0 +1,82 @@
+/**
+ * Generated by Lovrabet CLI
+ * Template: {TemplateName}
+ * Created: {CreatedAt}
+ * Page: {PageName}
+ */
+import React, { useState, useEffect } from "react";
+import { Card, Button, Space, Typography, Alert } from "antd";
+import { ReloadOutlined, ApiOutlined } from "@ant-design/icons";
+import { lovrabetClient } from "../../api/client";
+
+const { Title, Paragraph, Text } = Typography;
+
+function {ComponentName}() {
+  const [loading, setLoading] = useState(false);
+  const [data, setData] = useState<any[]>([]);
+
+  // SDK 调用示例
+  const fetchData = async () => {
+    setLoading(true);
+    try {
+      // TODO: 替换为实际的模型名称
+      const response = await lovrabetClient.models.YourModel.getList({
+        currentPage: 1,
+        pageSize: 10,
+      });
+      setData(response.tableData || []);
+    } catch (error) {
+      console.error("获取数据失败:", error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div style={{ padding: "24px" }}>
+      <Title level={2}>
+        <ApiOutlined /> {DisplayTitle}
+      </Title>
+      <Paragraph style={{ color: "#666", marginBottom: 24 }}>
+        使用 lovrabetClient 调用 SDK 的示例页面
+      </Paragraph>
+
+      <Space direction="vertical" size="large" style={{ width: "100%" }}>
+        <Alert
+          message="SDK 调用示例"
+          description={
+            <div style={{ margin: "8px 0" }}>
+              <Text code>lovrabetClient.models.YourModel.getList()</Text> - 获取数据列表
+              <br />
+              <Text code>lovrabetClient.models.YourModel.create()</Text> - 创建数据
+              <br />
+              <Text code>lovrabetClient.models.YourModel.update()</Text> - 更新数据
+              <br />
+              <Text code>lovrabetClient.models.YourModel.delete()</Text> - 删除数据
+            </div>
+          }
+          type="info"
+          showIcon
+        />
+
+        <Card title="基础操作" size="small">
+          <Space>
+            <Button
+              type="primary"
+              icon={<ReloadOutlined />}
+              loading={loading}
+              onClick={fetchData}
+            >
+              获取数据
+            </Button>
+            <Text type="secondary">数据条数: {data.length}</Text>
+          </Space>
+        </Card>
+
+        {/* 可以在这里添加更多功能 */}
+      </Space>
+    </div>
+  );
+}
+
+export default {ComponentName};

package/templates/projects/sub-app-react-demo/.prettierrc

@@ -0,0 +1 @@
+{}

package/templates/projects/sub-app-react-demo/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
+}

package/templates/projects/sub-app-react-demo/.vscode/settings.json

@@ -0,0 +1,57 @@
+{
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact"
+  ],
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[javascript]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[javascriptreact]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.tabSize": 2
+  },
+  "[css]": {
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit"
+    },
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[scss]": {
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit"
+    },
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[shellscript]": {
+    "editor.defaultFormatter": "foxundermoon.shell-format"
+  },
+  "[properties]": {
+    "editor.defaultFormatter": "foxundermoon.shell-format"
+  },
+  "[dotenv]": {
+    "editor.defaultFormatter": "foxundermoon.shell-format"
+  },
+  "[ignore]": {
+    "editor.defaultFormatter": "foxundermoon.shell-format"
+  },
+  "cSpell.words": ["dbtable", "lovrabet", "lovrabetrc"]
+}

package/templates/projects/sub-app-react-demo/CHANGELOG.md

@@ -0,0 +1,37 @@
+# 更新记录
+
+## 2025-09-14
+
+### 🔧 实现自动路由生成
+
+引入 `vite-plugin-pages` 插件，基于文件系统自动生成路由配置。
+
+**变更**：
+
+- 新增 `vite-plugin-pages` 依赖
+- 路由配置改用虚拟模块 `~react-pages`
+- `HelloWorld.tsx` → `index.tsx` 作为默认首页
+
+**使用**：
+
+- `src/pages/index.tsx` → `/`
+- `src/pages/table-display.tsx` → `/table-display`
+- `src/pages/chart-fetch/index.tsx` → `/chart-fetch` (目录结构)
+
+支持文件和目录两种结构，新增页面只需在 `src/pages/` 下创建文件，无需手动配置路由。
+
+## 2025-09-12
+
+### 全面切换www.lovrabet.com域名
+
+Lovrabet启用新品牌域名 Lovrabet.com，并为了简化API架构，我们将原有的 `smartapi/dbapi` 双调用方式统一为单一 api 接口，同时迁移域名并简化URL路径结构。
+
+快速替换指南：
+
+将所有的
+`https://api.yuntooai.com/smartapi/runtime/[tenantCode]/`
+`https://api.yuntooai.com/dbapi/runtime/[tenantCode]/`
+批量替换为
+`https://runtime.lovrabet.com/api/`
+
+详情可查看 [Lovrabet API 地址规则变更通知](./docs/API_RULE_CHANGE.md)

package/templates/projects/sub-app-react-demo/README.md

@@ -0,0 +1,209 @@
+[📝 项目更新记录 CHANGELOG](./CHANGELOG.md)
+
+注意：本项目会阶段性更新，如果git pull以后无法运行，可以删除 node_modules之后重新 npm install
+
+# Lovrabet SDK React 演示项目
+
+项目展示了如何在现代 React 应用中集成 Lovrabet SDK，以及如何使用 icestark 微前端方案嵌入到 Lovrabet 主应用中。
+
+## 技术栈
+
+- **@lovrabet/sdk** - Lovrabet 官方 SDK，支持现代化客户端实例管理
+- **React 18** - 稳定的 React 版本，支持并发特性
+- **TypeScript** - 类型安全的 JavaScript 超集
+- **React Router v6** - 现代化的路由解决方案
+- **Ant Design v5** - 企业级 UI 设计语言
+- **Vite v7** - 下一代前端构建工具
+- **icestark** - 阿里飞冰微前端框架
+- **ECharts** - 数据可视化图表库
+
+## 项目结构
+
+```
+├── src/
+│   ├── api/            # SDK 配置和客户端
+│   │   ├── api.ts      # CLI 生成的 SDK 配置文件
+│   │   └── client.ts   # SDK 客户端实例
+│   ├── components/     # 通用组件
+│   │   ├── ApiUrlDisplay.tsx  # API URL 展示组件
+│   │   └── PageHeader.tsx     # 页面头部组件
+│   ├── layouts/        # 布局组件
+│   │   └── MainLayout.tsx
+│   ├── pages/          # 页面组件（基于文件系统自动路由）
+│   │   ├── index.tsx           # 首页 - 项目概述（/ 路由）
+│   │   ├── sdk-demo/           # SDK 演示页面
+│   │   │   └── index.tsx       # SDK 调用演示（/sdk-demo 路由）
+│   │   ├── table-display.tsx   # 表格展示（/table-display 路由）
+│   │   ├── chart-fetch/        # 图表页面目录
+│   │   │   └── index.tsx       # 图表展示（/chart-fetch 路由）
+│   │   └── dashboard/          # 仪表板页面
+│   │       └── index.tsx       # 数据看板（/dashboard 路由）
+│   ├── router/         # 路由配置（自动生成）
+│   │   └── index.tsx
+│   ├── utils/          # 工具函数
+│   │   └── api.ts      # API 请求封装
+│   ├── main.tsx        # 微前端应用入口
+│   ├── style.css       # 全局样式
+│   └── vite-env.d.ts   # Vite 类型定义
+├── docs/               # 项目文档
+│   └── API_RULE_CHANGE.md  # API 变更指南
+├── vite.config.ts      # Vite 配置文件（含微前端配置）
+├── tsconfig.json       # TypeScript 配置
+├── CHANGELOG.md        # 更新记录
+└── package.json        # 项目依赖
+```
+
+## 功能特性
+
+- 🎯 **SDK 调用演示** - 展示 @lovrabet/sdk 的核心 CRUD 操作方法
+- 🏠 **项目概述页** - 清晰介绍项目目的、功能和技术栈
+- 📊 **数据图表** - 真实API调用的 ECharts 饼图，展示字段类型分布
+- 📋 **数据表格** - 支持分页、排序、筛选的动态数据表格
+- 📈 **仪表板展示** - 静态数据可视化演示页面
+- 🚀 **自动路由生成** - 基于文件系统的约定式路由，零配置开发
+- 🔌 **微前端支持** - 通过 icestark 实现与主应用的无缝集成
+- 📱 **响应式设计** - 支持桌面端和移动端，自适应布局
+- 🎨 **现代化 UI** - 基于 Ant Design v5 的美观界面
+- ⚡ **极速构建** - Vite v7 + ES Modules，开发体验极佳
+- 🧩 **组件复用** - 抽取通用组件如 PageHeader，提高代码复用性
+
+## 快速开始
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 开发模式
+
+```bash
+npm run start
+```
+
+应用将在 `https://dev.lovrabet.com:5173` 启动（配置了HTTPS证书）
+说明：https://dev.lovrabet.com:${port} port不限5173端口，任意端口号都支持跨域
+
+### 微前端核心配置
+
+项目包含完整的微前端配置 (`vite.config.ts`)：
+
+- **icestark 集成**: 通过 `vite-plugin-index-html` 实现微前端打包
+- **外部依赖**: React、ReactDOM、Ant Design 通过 CDN 加载
+- **ES Modules 输出**: 支持主应用动态加载
+- **HTTPS 支持**: 开发环境配置 HTTPS 证书，解决跨域问题
+- **路径别名**: `@` 指向 `src` 目录
+
+### 构建生产版本
+
+```bash
+npm run build
+```
+
+### 预览生产版本
+
+```bash
+npm run preview
+```
+
+## 开发指南
+
+### SDK 集成使用
+
+项目展示了如何正确集成和使用 @lovrabet/sdk：
+
+1. **SDK 配置文件** (`src/api/api.ts`)：
+   - 通过 Lovrabet CLI 自动生成
+   - 包含应用代码和模型配置
+   - 自动注册到 SDK 的配置管理器
+
+2. **客户端实例** (`src/api/client.ts`)：
+   - 导入配置文件执行注册
+   - 使用 `createClient()` 创建客户端实例
+   - 导出供整个应用使用
+
+3. **SDK 调用示例** (`src/pages/sdk-demo/index.tsx`)：
+   - 展示 `getList()` 获取数据列表
+   - 展示 `create()` 创建新数据
+   - 包含完整的错误处理
+
+**典型使用模式**：
+
+```typescript
+// 获取数据列表
+const data = await lovrabetClient.models.Requirements.getList({
+  currentPage: 1,
+  pageSize: 20,
+});
+
+// 创建新数据
+await lovrabetClient.models.Requirements.create({
+  title: "需求标题",
+  description: "需求描述",
+});
+```
+
+### 微前端集成要点
+
+1. **入口文件配置** (`src/main.tsx`)：
+   - 导出 `mount` 和 `unmount` 生命周期函数
+   - 使用 `isInIcestark()` 判断运行环境
+   - 支持接收主应用传递的 `customProps`
+
+2. **自动路由配置** (`src/router/index.tsx`)：
+   - 使用 `vite-plugin-pages` 实现基于文件系统的约定式路由
+   - 使用 `getBasename()` 获取动态 basename
+   - 支持微应用内部路由跳转和嵌套路由
+
+3. **构建配置** (`vite.config.ts`)：
+   - 使用 `vite-plugin-pages` 实现自动路由生成
+   - 使用 `vite-plugin-index-html` 插件支持微前端打包
+   - 配置 ES modules 输出格式，支持 Tree Shaking
+   - 外部化公共依赖减小包体积，CDN 友好
+   - HTTPS 开发环境，解决跨域问题
+
+### 约定式路由使用指南
+
+基于 `vite-plugin-pages` 的文件系统路由，支持以下约定：
+
+**文件路由映射**：
+
+- `src/pages/index.tsx` → `/` （首页 - 项目概述）
+- `src/pages/sdk-demo/index.tsx` → `/sdk-demo` （SDK 调用演示）
+- `src/pages/table-display.tsx` → `/table-display` （数据表格展示）
+- `src/pages/chart-fetch/index.tsx` → `/chart-fetch` （图表数据获取）
+- `src/pages/dashboard/index.tsx` → `/dashboard` （数据可视化仪表板）
+
+**动态路由**：
+
+- `src/pages/[id].tsx` → `/:id`
+- `src/pages/user/[userId]/profile.tsx` → `/user/:userId/profile`
+
+**嵌套路由**：
+
+- 使用目录结构创建嵌套路由
+- 支持 `layout.tsx` 文件作为嵌套布局
+
+**新增页面**：
+只需在 `src/pages/` 目录下创建 `.tsx` 文件，路由会自动生成，无需手动配置。
+
+### 样式规范
+
+- 优先使用 Ant Design 组件
+- 自定义样式使用 CSS 或 styled-components
+- 响应式设计支持移动端
+
+## 部署
+
+项目使用 Vite 构建，可以部署到任何静态文件服务器：
+
+- Vercel
+- Netlify
+- GitHub Pages
+- 阿里云 OSS
+- 腾讯云 COS
+
+## 文档链接
+
+- [开发者手册 quick-start](./docs/quick-start.md)
+- [更新记录 CHANGELOG](./CHANGELOG.md)