cloudcc-cli 2.2.5 → 2.2.7

package/bin/cc.js

@@ -2,7 +2,6 @@
 const chalk = require("chalk")
 
 let argvs = process.argv.splice(2);
-
 let action = argvs[0]
 // 处理版本查询命令
 if (action === '-version' || action === '-v' || action === '--version' || action === '--v') {
@@ -27,8 +26,14 @@ if (!type) {
     return;
 }
 const cc = require("./index")
-
 try {
+    if (action === "doc") {
+        if (!cc[type]) {
+            throw new Error(`doc 不支持的类型: ${type}`);
+        }
+        cc[type]("doc", argvs);
+        return;
+    }
     cc[argvs[1]](argvs[0], argvs);
 } catch (e) {
     console.error()

package/bin/index.js

@@ -30,4 +30,8 @@ cc.fields = require("../src/fields/index")
 
 cc.approval = require("../src/approval/index")
 
+cc.menu = require("../src/menu/index")
+
+cc.application = require("../src/application/index")
+
 module.exports = cc;

package/java/com/cloudcc/core/BaseException.java

@@ -0,0 +1,100 @@
+package com.cloudcc.core;
+
+import java.io.PrintStream;
+import java.io.PrintWriter;
+import java.util.ArrayList;
+import java.util.List;
+
+public class BaseException extends Exception {
+    private static final long serialVersionUID = -960185495264426709L;
+    public static final long ERROR_PAGE = 1L;
+    public static final long RETURN_PAGE = 2L;
+    public static final long RETURN_BYPAGE = 3L;
+    private Throwable rootCause = null;
+    private List exceptions = new ArrayList();
+    private List messageArgs = new ArrayList();
+    private String messageKey = null;
+    private long displayType = 1L;
+    private String returnForward = null;
+
+    protected BaseException() {
+    }
+
+    protected BaseException(String errmsg) {
+        super(errmsg);
+        this.messageArgs.add(errmsg);
+    }
+
+    protected BaseException(Throwable cause) {
+        super(cause);
+        this.rootCause = cause;
+    }
+
+    protected BaseException(String errmsg, Throwable cause) {
+        super(errmsg, cause);
+        this.messageArgs.add(errmsg);
+        this.rootCause = cause;
+    }
+
+    protected BaseException(List args) {
+        this.messageArgs = args;
+    }
+
+    protected BaseException(String msgKey, List args) {
+        this.messageKey = msgKey;
+        this.messageArgs = args;
+    }
+
+    public void printStackTrace(PrintWriter writer) {
+        super.printStackTrace(writer);
+        if (this.getRootCause() != null) {
+            this.getRootCause().printStackTrace(writer);
+        }
+
+        writer.flush();
+    }
+
+    public void printStackTrace(PrintStream outStream) {
+        this.printStackTrace(new PrintWriter(outStream));
+    }
+
+    public void printStackTrace() {
+        this.printStackTrace(System.err);
+    }
+
+    public Throwable getRootCause() {
+        return this.rootCause;
+    }
+
+    public String getMessageKey() {
+        return this.messageKey;
+    }
+
+    public List getExceptions() {
+        return this.exceptions;
+    }
+
+    public void addException(BaseException ex) {
+        this.exceptions.add(ex);
+    }
+
+    public List getMessageArgs() {
+        return this.messageArgs;
+    }
+
+    public long getDisplayType() {
+        return this.displayType;
+    }
+
+    public void setDisplayType(long displayType) {
+        this.displayType = displayType;
+    }
+
+    public String getReturnForward() {
+        return this.returnForward;
+    }
+
+    public void setReturnForward(String returnForward) {
+        this.returnForward = returnForward;
+    }
+}

package/java/com/cloudcc/core/BusiException.java

@@ -0,0 +1,43 @@
+package com.cloudcc.core;
+
+import java.util.List;
+
+public class BusiException extends BaseException {
+    private static final long serialVersionUID = -4060192906349249047L;
+
+    public BusiException() {
+    }
+
+    public BusiException(String errmsg) {
+        super(errmsg);
+    }
+
+    public BusiException(Throwable cause) {
+        super(cause);
+    }
+
+    public BusiException(String errmsg, Throwable cause) {
+        super(errmsg, cause);
+    }
+
+    public String toString() {
+        StringBuffer sb = new StringBuffer();
+        List messageArgs = this.getMessageArgs();
+
+        for(int i = 0; i < messageArgs.size(); ++i) {
+            sb.append("\t").append((String)messageArgs.get(i)).append("\n");
+        }
+
+        sb.append("\n\n");
+        Throwable t = this.getRootCause();
+        if (t != null) {
+            StackTraceElement[] ste = t.getStackTrace();
+
+            for(int i = 0; i < ste.length; ++i) {
+                sb.append("\t").append(ste[i]).append("\n");
+            }
+        }
+
+        return sb.toString();
+    }
+}

package/java/com/cloudcc/core/CCService.java

@@ -607,5 +607,7 @@ public class CCService {
 	public String process(String processType, String tid, String touserId, String comments, String appPath) {
 		return null;
 	}
-
+	public ServiceResult update(List<CCObject> ccobjs) throws BusiException {
+		return null;
+	}
 }

package/java/com/cloudcc/core/StringUtils.java

@@ -0,0 +1,7 @@
+package com.cloudcc.core;
+
+public class StringUtils {
+    public static boolean isNotNullAndEmpty(Object s){
+        return s != null && !s.equals("");
+    }
+}

package/java/com/cloudcc/core/TimeUtil.java

@@ -2,10 +2,43 @@
 package com.cloudcc.core;
 
 import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.TimeZone;
 
 public class TimeUtil {
+    private static final TimeZone DEFAULT_TIMEZONE = TimeZone.getDefault();
+    private static final boolean isChinastandardTimeZone=true;
 
     public static SimpleDateFormat getSimpleDateFormat(String string, UserInfo userInfo) {
         return new SimpleDateFormat(string);
     }
+    public static Date getNowDate(UserInfo userInfo) {
+        return parseDate(new Date(), userInfo);
+    }
+    public static Date parseDate(Date date, UserInfo userInfo) {
+        TimeZone userTZ = getUserTimeZone(userInfo);
+        return parseDate(date, userTZ);
+    }
+    public static Date parseDate(Date date, TimeZone tz) {
+        if (isChinastandardTimeZone) {
+            if ((long)tz.getRawOffset() == 28800000L) {
+                return date;
+            } else {
+                long offset = (long)tz.getRawOffset() - 28800000L;
+                return new Date(date.getTime() + offset);
+            }
+        } else {
+            long offset = (long)(tz.getRawOffset() - DEFAULT_TIMEZONE.getRawOffset());
+            return new Date(date.getTime() + offset);
+        }
+    }
+
+    public static TimeZone getUserTimeZone(UserInfo userInfo) {
+        if (userInfo != null && StringUtils.isNotNullAndEmpty(userInfo.getTimeZone())) {
+            String timeZoneId = userInfo.getTimeZone();
+            return !timeZoneId.startsWith("+") && !timeZoneId.startsWith("-") ? TimeZone.getTimeZone(timeZoneId) : TimeZone.getTimeZone("GMT" + timeZoneId);
+        } else {
+            return TimeZone.getTimeZone("GMT+08:00");
+        }
+    }
 }

package/java/com/cloudcc/core/UserInfo.java

@@ -3,6 +3,15 @@ package com.cloudcc.core;
 public class UserInfo extends CCObject {
 	// 绑定信息
 	public String binding;
+	private String timeZone;
+
+	public String getTimeZone() {
+		return timeZone;
+	}
+
+	public void setTimeZone(String timeZone) {
+		this.timeZone = timeZone;
+	}
 
 	// 获取用户ID
 	public String getUserId() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -16,6 +16,8 @@
     "cc-mcp": "bin/mcp.js"
   },
   "scripts": {
+    "test-cli-one": "node --test test/application.cli.test.js",
+    "test-cli-all": "node --test ",
     "cc-pull": "git fetch --tags -f && git pull",
     "publish-lib": "npm publish --registry https://registry.npmjs.org && git add . && git commit -m 'update' && git push && curl https://npmmirror.com/sync/cloudcc-cli",
     "package-jar": "mvn clean && mvn package",
@@ -43,5 +45,9 @@
     "vue-custom-element": "^3.3.0",
     "vue-template-compiler": "^2.6.14",
     "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "sass": "^1.98.0",
+    "sass-loader": "^16.0.7"
   }
 }

package/pom.xml

@@ -4,7 +4,7 @@
 
     <groupId>com.cloudcc.core</groupId>
     <artifactId>ccopenapi</artifactId>
-    <version>0.0.3</version>
+    <version>0.0.4</version>
     <packaging>jar</packaging>
     <name>ccopenapi</name>
     <dependencies>

package/skill/BACKEND_CODE.md

@@ -0,0 +1,114 @@
+## 覆盖范围
+
+本篇聚焦 CloudCC 后端 Java 侧二开资产（通过 `cc` 命令）：
+
+- 自定义类（Class）
+- 定时类（Scheduled Class / Timer）
+- 触发器（Trigger）
+
+并给出“创建 → 拉取 → 编辑 → 发布”的闭环流程。
+
+---
+
+## 目录结构（以本仓库约定为准）
+
+创建后通常会生成在以下目录（项目根下）：
+
+- `classes/{ClassName}/...`
+- `schedule/{ScheduleName}/...`
+- `triggers/{objectName}/{triggerName}/...`
+
+---
+
+## 源码同步边界（必须理解）
+
+该项目使用“片段同步”策略：
+
+- **自定义类 / 定时类 / 触发器**：只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
+
+这意味着：
+
+- 你可以在片段外保留模板、import、类结构等；真正可同步的业务逻辑写在片段内。
+- 拉取会覆盖片段区域，因此片段内不要放本地专用逻辑（如临时调试代码）。
+
+---
+
+## 自定义类（Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create classes <ClassName>
+```
+
+### 拉取 / 发布（片段同步）
+
+```bash
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 定时类（Scheduled Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+---
+
+## 触发器（Trigger）
+
+### 创建（关键入参）
+
+触发器的 CLI 创建参数是一个 JSON 对象（需要 `encodeURI` 后作为单参传入）：
+
+```bash
+cc create triggers <encodedJson>
+```
+
+JSON 字段（示例）：
+
+- `name`: 触发器名（Java 命名规范）
+- `schemetableName`: 对象表名（如从对象列表拿到）
+- `targetObjectId`: 目标对象 ID
+- `triggerTime`: 触发时机（beforeInsert/afterUpdate/.../approval 等）
+
+示例（macOS/zsh，注意引号与编码）：
+
+```bash
+cc create triggers "$(node -e 'console.log(encodeURI(JSON.stringify({name:\"MyTrigger\",schemetableName:\"account\",targetObjectId:\"a01...\",triggerTime:\"beforeInsert\"})))')"
+```
+
+### 拉取 / 发布
+
+```bash
+# namePath 形如：objectName/triggerName（注意 objectName 通常为小写目录）
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 推荐工作流（AI 执行顺序）
+
+当需求涉及后端逻辑时，建议 AI 按以下顺序执行：
+
+1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
+2. 创建类/触发器/定时器骨架（create_*）
+3. 拉取线上版本（pull_*）对齐基线（如是增量改造）
+4. 编写片段内业务逻辑（注意批量与幂等）
+5. 发布（publish_*）
+6. 回归验证：单条、批量、权限、异常分支
+

package/skill/CLI_CHEATSHEET.md

@@ -0,0 +1,90 @@
+## CLI 入口速查（本仓库已定义）
+
+`package.json` 中定义的 bin：
+
+- `cc`：主入口（支持 `create` / `get` / `pull` / `publish` / `doc` 等）
+- `cloudccCreate`：创建模板项目（内部调用 `src/project/create.js`）
+- `cloudccBuild`：组件发布/构建相关（内部调用 `src/plugin/publish.js`）
+
+---
+
+## 常用 CLI 命令速查（按开发流程分组）
+
+### 项目与文档
+
+```bash
+# 版本
+cc -v
+
+# 创建模板项目
+cc create project <projectName>
+
+# 输出项目文档（纯 CLI 文档）
+cc doc project overview
+cc doc project key-guide
+```
+
+### 对象与字段
+
+```bash
+# 创建自定义对象
+cc create object <projectPath> <label>
+
+# 查询对象列表（输出 JSON）
+# type 可选：standard / custom / both（默认：both）
+cc get object <projectPath> [type]
+
+# 查询对象字段（输出 JSON）
+cc get fields <projectPath> <objprefix>
+
+# 创建字段（字段类型决定参数个数）
+cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
+```
+
+### 菜单与应用
+
+```bash
+# 创建菜单（标签页）
+cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+
+# 创建应用
+cc create application <projectPath> <appName> <appCode> [menuIds]
+```
+
+### 自定义类（classes）
+
+```bash
+cc create classes <ClassName>
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+### 定时类（schedule）
+
+```bash
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+### 触发器（triggers）
+
+```bash
+# 创建：参数是一个 JSON（需 encodeURI 后作为单个参数传入）
+cc create triggers <encodedJson>
+
+# 拉取/发布：namePath 形如 objectName/triggerName
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+### 自定义组件（plugin / plugins）
+
+```bash
+# 创建（生成到 plugins/<pluginName>/）
+cc create plugin <pluginName>
+
+# 发布（编译并上传）
+cc publish plugin <pluginName>
+```
+

package/skill/INSTALL_AND_BOOTSTRAP.md

@@ -0,0 +1,59 @@
+## 目标
+
+让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli` 的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
+
+---
+
+## 安装 cloudcc-cli
+
+### 全局安装
+
+```bash
+# Windows
+npm i -g cloudcc-cli
+
+# macOS（通常需要 sudo）
+sudo npm i -g cloudcc-cli
+```
+
+### 验证版本
+
+```bash
+cc -v
+```
+
+> 说明：`cc` 是该 CLI 的统一入口命令之一（见本仓库 `package.json` 的 bin 配置）。
+
+---
+
+## 创建 CloudCC 模板项目
+
+在你的工作目录下执行：
+
+```bash
+cc create project demo1
+cd demo1
+npm i
+npm run serve
+```
+
+如果能在本地启动并访问页面，说明前端开发链路可用。
+
+---
+
+## 配置开发者密钥与安全标记
+
+### 在 CloudCC CRM 后台获取
+
+你需要一个具备“代码管理/开发者权限”的账号。
+
+- **开发者密钥（CloudCCDev）**：在 CRM 后台「连接的应用程序」中新建后获取并复制。
+- **安全标记（safetyMark）**：在个人设置中重置安全标记后，通过邮箱获取。
+
+### 写入项目的 `cloudcc-cli.config.js`
+
+模板项目根目录通常会有 `cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
+
+- **多环境**：用 `use` 字段选择当前环境（如 `dev/uat/prod`）。
+- **不要提交真实密钥到 Git**：建议 `.gitignore` 忽略配置文件，或用本地私密文件方式管理。
+

package/skill/OBJECTS_AND_FIELDS.md

@@ -0,0 +1,120 @@
+## 覆盖范围
+
+本篇聚焦用 `cloudcc-cli` 的 `cc` 命令完成：
+
+- 创建自定义对象（Custom Object）
+- 查询对象列表
+- 查询对象字段
+- 为对象创建字段（支持多字段类型）
+-（可选）创建菜单、创建应用（把对象挂到导航中）
+
+---
+
+## 自定义对象（Custom Object）
+
+### 你需要准备什么信息
+
+- **对象显示标签（label）**：例如“客户”“合同”“付款计划”
+- **项目路径（projectPath）**：模板项目根目录
+
+### CLI 命令（项目已有实现）
+
+```bash
+cc create object <projectPath> <label>
+```
+
+示例：
+
+```bash
+cc create object . 客户
+```
+
+---
+
+## 查询对象列表
+
+### CLI 命令（输出 JSON）
+
+```bash
+# type 可选：standard / custom / both（默认：both）
+cc get object <projectPath> [type]
+```
+
+示例：
+
+```bash
+cc get object . both
+```
+
+用途：
+
+- 获取对象 `objprefix` / 对象 `id`（后续创建字段、触发器会用到）
+
+---
+
+## 查询对象字段列表
+
+### CLI 命令（输出 JSON）
+
+```bash
+cc get fields <projectPath> <objprefix>
+```
+
+示例：
+
+```bash
+cc get fields . a01
+```
+
+用途：
+
+- 在创建字段前，先确认是否已存在同名/同含义字段，避免重复与冲突。
+
+---
+
+## 创建字段（Field）
+
+### CLI 命令形态（项目已有实现）
+
+字段创建命令由工具根据字段类型拼装，典型形态：
+
+```bash
+cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
+```
+
+### 字段类型选择建议（常用）
+
+- **S**：文本（最常用）
+- **N**：数字
+- **D / F**：日期 / 日期时间
+- **B**：复选框
+- **L / Q**：选项列表（单选/多选）
+- **Y / MR / M**：关系字段（查找/查找多选/主详）
+- **E / H / U**：邮箱/电话/URL
+
+---
+
+## 菜单与应用（让对象可访问）
+
+### 创建菜单（CLI）
+
+```bash
+cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+```
+
+示例：
+
+```bash
+cc create menu object . <objectId> "我的对象菜单"
+```
+
+### 创建应用（CLI）
+
+```bash
+cc create application <projectPath> <appName> <appCode> [menuIds]
+```
+
+说明：
+
+- `menuIds`：可选，多个用逗号分隔；系统会确保默认菜单 `acf000001` 被包含。
+