@lark-apaas/coding-template-nestjs-react-fullstack 0.1.36-alpha.20260903095202 → 0.1.36-alpha.20260903185731

package/template/package.json

@@ -4,8 +4,8 @@
   "private": true,
   "flags": {
     "supportBusinessUser": true,
+    "businessUiFromMarket": true,
     "supportScrollReveal": true,
-    "supportTiptapAndStreamdown": true,
     "customToaster": true
   },
   "scripts": {
@@ -19,16 +19,12 @@
     "build:server": "NODE_ENV=production nest build",
     "build:client": "NODE_ENV=production vite build --config vite.config.ts",
     "start": "NODE_ENV=production node main.js",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:e2e": "jest --config test/e2e/jest.config.js",
     "eslint": "eslint . --quiet",
     "stylelint": "stylelint client/src/**/*.css --quiet",
     "type:check": "concurrently -n \"server,client\" -c \"blue,green\" \"npm run type:check:server\" \"npm run type:check:client\"",
     "type:check:client": "tsc --noEmit --project tsconfig.app.json",
     "type:check:server": "tsc --noEmit --project tsconfig.node.json",
     "lint": "node ./scripts/lint.js",
-    "format": "prettier --write \"{server,client,test}/**/*.{js,ts,tsx,json,md}\"",
     "precommit": "node scripts/hooks/run-precommit.js",
     "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi"
   },
@@ -41,7 +37,6 @@
     "@nestjs/core": "^10.4.20",
     "@nestjs/platform-express": "^10.4.20",
     "@nestjs/swagger": "^7.4.2",
-    "@tanstack/react-form": "^1.27.6",
     "@tanstack/react-query": "^5.90.12",
     "axios": "^1.12.2",
     "cache-manager": "^6.4.3",
@@ -56,17 +51,11 @@
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@dnd-kit/core": "^6.3.1",
-    "@dnd-kit/modifiers": "^9.0.0",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@headlessui/react": "^2.2.9",
-    "@heroicons/react": "^2.2.0",
     "@hookform/resolvers": "^5.2.2",
     "@lark-apaas/client-toolkit": "^1.2.69",
-    "@lark-apaas/coding-preset-vite-react": "1.0.22-alpha.20260903092505",
+    "@lark-apaas/coding-preset-vite-react": "^1.0.21",
     "@lark-apaas/fullstack-presets": "^1.1.0",
     "@nestjs/cli": "^10.4.9",
-    "@nestjs/testing": "^10.4.20",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-aspect-ratio": "^1.1.7",
@@ -93,33 +82,13 @@
     "@radix-ui/react-toggle": "^1.1.10",
     "@radix-ui/react-toggle-group": "^1.1.11",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@reduxjs/toolkit": "^2.9.0",
-    "@shikijs/langs": "^3.21.0",
-    "@shikijs/themes": "^3.21.0",
     "@swc/cli": "^0.5.2",
     "@swc/core": "^1.16.1",
     "@tailwindcss/postcss": "^4.1.13",
     "@tailwindcss/typography": "^0.5.19",
-    "@tiptap/core": "^3.14.0",
-    "@tiptap/extension-code-block": "^3.15.3",
-    "@tiptap/extension-code-block-lowlight": "^3.14.0",
-    "@tiptap/extension-color": "^3.14.0",
-    "@tiptap/extension-highlight": "^3.14.0",
-    "@tiptap/extension-image": "^3.14.0",
-    "@tiptap/extension-link": "^3.14.0",
-    "@tiptap/extension-placeholder": "^3.14.0",
-    "@tiptap/extension-task-item": "^3.15.3",
-    "@tiptap/extension-task-list": "^3.15.3",
-    "@tiptap/extension-text-align": "^3.14.0",
-    "@tiptap/extension-text-style": "^3.14.0",
-    "@tiptap/extension-underline": "^3.14.0",
-    "@tiptap/pm": "^3.15.3",
-    "@tiptap/react": "^3.14.0",
-    "@tiptap/starter-kit": "^3.14.0",
     "@types/crypto-js": "^4.2.2",
     "@types/express": "^5.0.3",
     "@types/hbs": "^4.0.5",
-    "@types/jest": "^29.5.14",
     "@types/node": "^22.18.6",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
@@ -127,79 +96,47 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "~2.0.1",
     "cmdk": "^1.1.1",
-    "cobe": "^0.6.5",
     "concurrently": "^9.2.1",
-    "css-loader": "^7.1.2",
     "date-fns": "^4.1.0",
     "echarts": "~5.6.0",
     "echarts-for-react": "~3.0.2",
     "embla-carousel-react": "^8.6.0",
-    "es-toolkit": "^1.43.0",
     "eslint": "^9.35.0",
-    "eslint-config-prettier": "^9.1.2",
-    "form-data": "^4.0.4",
     "framer-motion": "~11.13.5",
     "gsap": "^3.13.0",
-    "html2canvas": "^1.4.1",
     "input-otp": "^1.4.2",
-    "jest": "^29.7.0",
-    "js-base64": "^3.7.8",
-    "jspdf": "^3.0.3",
     "lodash": "^4.17.21",
     "lucide-react": "^0.554.0",
     "nanoid": "^5.1.6",
     "next-themes": "^0.4.6",
-    "pinyin-pro": "^3.27.0",
     "postcss": "^8.5.6",
     "postcss-import": "^16.1.1",
-    "postcss-loader": "^8.2.0",
-    "prettier": "^3.6.2",
-    "qrcode.react": "^4.2.0",
-    "radix-ui": "^1.4.3",
     "react": "^19.2.0",
-    "react-countup": "^6.5.3",
     "react-day-picker": "^9.11.1",
     "react-dom": "^19.2.0",
-    "react-dropzone": "^14.3.5",
     "react-error-boundary": "^6.0.0",
     "react-hook-form": "^7.65.0",
-    "react-redux": "^9.2.0",
-    "react-refresh": "^0.17.0",
+    "react-markdown": "^10.1.0",
     "react-resizable-panels": "^3.0.6",
     "react-router-dom": "^6.30.1",
     "recharts": "^2.15.4",
+    "remark-gfm": "^4.0.1",
     "rxjs": "^7.8.2",
-    "shiki": "^3.21.0",
     "sonner": "^2.0.7",
-    "streamdown": "^1.6.10",
-    "style-loader": "^4.0.0",
     "stylelint": "^16.11.0",
     "tailwind-merge": "~3.4.0",
     "tailwindcss": "^4.1.13",
-    "ts-jest": "^29.4.3",
-    "ts-node": "^10.9.2",
     "tw-animate-css": "^1.3.8",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.44.0",
     "uuid": "11.0.5",
     "vaul": "^1.1.2",
     "vite": "^8",
-    "xlsx": "^0.18.5",
-    "xlsx-js-style": "^1.2.0",
-    "zod": "^3.25.76",
-    "zustand": "~5.0.8"
+    "zod": "^3.25.76"
   },
   "overrides": {
     "dayjs": "^1.11.15"
   },
-  "jest": {
-    "preset": "ts-jest",
-    "testEnvironment": "node",
-    "testMatch": [
-      "<rootDir>/server/**/*.spec.ts",
-      "<rootDir>/test/unit/**/*.spec.ts"
-    ]
-  },
   "engines": {
     "node": ">=22.0.0",
     "npm": ">=10.0.0"

package/template/client/src/components/business-ui/README.md

@@ -1,519 +0,0 @@
-# 业务组件文档
-
-本文档包含用户选择、部门选择、群组选择、用户展示等业务组件的使用说明。
-
----
-
-## 目录
-
-- [类型统一规范](#类型统一规范)
-- [UserSelect 用户选择组件](#userselect-用户选择组件)
-- [DepartmentSelect 部门选择组件](#departmentselect-部门选择组件)
-- [ChatSelect 群组选择组件](#chatselect-群组选择组件)
-- [UserDisplay 用户展示组件](#userdisplay-用户展示组件)
-- [UserProfile 用户详情组件](#userprofile-用户详情组件)
-
----
-
-## 类型统一规范
-
-### 部门类型
-
-```typescript
-/** 部门数据结构 */
-interface Department {
-  /** 唯一标识：用于 key/去重/选中判断，内部对应 departmentID */
-  id: string;
-  /** 展示名称：内部优先 zh_cn，其次 en_us */
-  name: string;
-}
-```
-
-### 群组类型
-
-```typescript
-/** 群组数据结构 */
-interface Chat {
-  /** 唯一标识：对应 chatID */
-  id: string;
-  /** 群组名称：内部优先 zh_cn，其次 en_us */
-  name: string;
-  /** 头像：URL 或 16 进制 RGB 颜色 */
-  avatar: string;
-}
-```
-
----
-
-## UserSelect 用户选择组件
-
-**组件路径**：`@/components/business-ui/user-select`
-
-### 功能概述
-
-- 用户字段选择组件，用于表单中录入"人员"字段
-- 通过触发器打开弹层，弹层内置搜索功能（始终可用）
-- 仅支持 **ID 模式**：`value/onChange` 只使用用户 `user_id`（string）
-- 组件在 UI 上可展示用户信息（头像/名称），但对外值仅返回/接收 `id`
-- 组件自带用户检索能力，无需额外传搜索接口/数据源
-
-### 类型定义
-
-```typescript
-
-/** 触发器类型 */
-type TriggerType = 'button' | 'search' | 'custom';
-
-/** 单选模式 Props */
-interface UserSelectSingleProps {
-  /** 当前选中的用户 ID，空值为 null */
-  value: string | null;
-  /** 选中变化回调 */
-  onChange: (value: string | null) => void;
-  /** 是否多选，单选时为 false 或不传 */
-  multiple?: false;
-  /** 触发器类型，仅影响样式，不影响搜索功能 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-/** 多选模式 Props */
-interface UserSelectMultipleProps {
-  /** 当前选中的用户 ID 列表，空值为 [] */
-  value: string[];
-  /** 选中变化回调 */
-  onChange: (value: string[]) => void;
-  /** 是否多选，多选时为 true */
-  multiple: true;
-  /** 触发器类型 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-type UserSelectProps = UserSelectSingleProps | UserSelectMultipleProps;
-```
-
-### Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` | `string \| null` / `string[]` | - | **必填**。单选传 `string \| null`（用户 ID），多选传 `string[]` |
-| `onChange` | `function` | - | **必填**。值变化回调，返回值形态与 `value` 匹配 |
-| `multiple` | `boolean` | `false` | 是否多选 |
-| `triggerType` | `'button' \| 'search' \| 'custom'` | `'button'` | 触发器类型，仅影响样式 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `placeholder` | `string` | `'请选择'` | 占位文本 |
-
-### 受控规范
-
-> ⚠️ **强约束**
-
-1. **必须受控**：始终传 `value` + `onChange`
-2. **禁止传**：`undefined` / `User` 对象 / 其他类型
-3. **空值规则**：
-   - 单选清空：`null`
-   - 多选清空：`[]`
-
-### 使用示例
-
-```tsx
-import { useState } from 'react';
-import { UserSelect } from '@/components/business-ui/user-select';
-
-// 单选
-function SingleSelectExample() {
-  const [userId, setUserId] = useState<string | null>(null);
-
-  return (
-    <UserSelect
-      value={userId}
-      onChange={setUserId}
-      placeholder="请选择用户"
-    />
-  );
-}
-
-// 多选
-function MultipleSelectExample() {
-  const [userIds, setUserIds] = useState<string[]>([]);
-
-  return (
-    <UserSelect
-      multiple
-      value={userIds}
-      onChange={setUserIds}
-      placeholder="请选择用户"
-      getOptionDisabled={(user) => user.id === 'disabled-id'}
-    />
-  );
-}
-```
-
----
-
-## DepartmentSelect 部门选择组件
-
-**组件路径**：`@/components/business-ui/department-select`
-
-### 功能概述
-
-- 部门字段选择组件，用于表单中录入"部门/组织"字段
-- 通过触发器打开弹层，弹层内置搜索功能（始终可用）
-- 仅支持**对象模式**（不支持传 ID/string）
-- 选择后自动回显已选部门信息：部门名称（多选以 tag 形式展示）
-- 组件自带部门检索能力，无需额外传搜索接口/数据源
-
-### 类型定义
-
-```typescript
-
-/** 触发器类型 */
-type TriggerType = 'button' | 'search' | 'custom';
-
-/** 单选模式 Props */
-interface DepartmentSelectSingleProps {
-  /** 当前选中的部门 */
-  value: Department | null;
-  /** 选中变化回调 */
-  onChange: (value: Department | null) => void;
-  /** 是否多选，单选时为 false 或不传 */
-  multiple?: false;
-  /** 触发器类型，仅影响样式，不影响搜索功能 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-  /** 判断选项是否禁用 */
-  getOptionDisabled?: (department: Department) => boolean;
-}
-
-/** 多选模式 Props */
-interface DepartmentSelectMultipleProps {
-  /** 当前选中的部门列表 */
-  value: Department[];
-  /** 选中变化回调 */
-  onChange: (value: Department[]) => void;
-  /** 是否多选，多选时为 true */
-  multiple: true;
-  /** 触发器类型 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-  /** 判断选项是否禁用 */
-  getOptionDisabled?: (department: Department) => boolean;
-}
-
-type DepartmentSelectProps = DepartmentSelectSingleProps | DepartmentSelectMultipleProps;
-```
-
-### Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` | `Department \| null` / `Department[]` | - | **必填**。单选传 `Department \| null`，多选传 `Department[]` |
-| `onChange` | `function` | - | **必填**。值变化回调，返回值形态与 `value` 匹配 |
-| `multiple` | `boolean` | `false` | 是否多选 |
-| `triggerType` | `'button' \| 'search' \| 'custom'` | `'button'` | 触发器类型，仅影响样式 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `placeholder` | `string` | `'请选择部门'` | 占位文本 |
-| `getOptionDisabled` | `(department: Department) => boolean` | - | 判断选项是否禁用，被禁用的已选项 tag 不显示删除按钮 |
-
-### 受控规范
-
-> ⚠️ **强约束**
-
-1. **必须受控**：始终传 `value` + `onChange`
-2. **禁止传**：`undefined` / `string` / `string[]`
-3. **空值规则**：
-   - 单选清空：`null`
-   - 多选清空：`[]`
-
-### 使用示例
-
-```tsx
-import { useState } from 'react';
-import { DepartmentSelect, type Department } from '@/components/business-ui/department-select';
-
-// 单选
-function SingleSelectExample() {
-  const [department, setDepartment] = useState<Department | null>(null);
-
-  return (
-    <DepartmentSelect
-      value={department}
-      onChange={setDepartment}
-      placeholder="请选择部门"
-    />
-  );
-}
-
-// 多选
-function MultipleSelectExample() {
-  const [departments, setDepartments] = useState<Department[]>([]);
-
-  return (
-    <DepartmentSelect
-      multiple
-      value={departments}
-      onChange={setDepartments}
-      placeholder="请选择部门"
-    />
-  );
-}
-```
-
----
-
-## ChatSelect 群组选择组件
-
-**组件路径**：`@/components/business-ui/chat-select`
-
-### 功能概述
-
-- 群组字段选择组件，用于表单中录入"群组"字段
-- 通过触发器打开弹层，弹层内置搜索功能（始终可用）
-- **仅支持 ID 模式**：`value/onChange` 只使用群组 `chatID`（string），该 ID 为飞书群聊 ID
-- 组件在 UI 上可展示群组信息（头像/名称），但对外值仅返回/接收 `chatID`
-- 选择后自动回显已选群组信息：群头像 + 群名称（多选以 tag 形式展示）
-- 组件自带群组检索能力，无需额外传搜索接口/数据源
-
-### 类型定义
-
-```typescript
-/** 触发器类型 */
-type TriggerType = 'button' | 'search' | 'custom';
-
-/** 单选模式 Props */
-interface ChatSelectSingleProps {
-  /** 当前选中的群组 ID，空值为 null */
-  value: string | null;
-  /** 选中变化回调 */
-  onChange: (value: string | null) => void;
-  /** 是否多选，单选时为 false 或不传 */
-  multiple?: false;
-  /** 触发器类型，仅影响样式，不影响搜索功能 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-/** 多选模式 Props */
-interface ChatSelectMultipleProps {
-  /** 当前选中的群组 ID 列表，空值为 [] */
-  value: string[];
-  /** 选中变化回调 */
-  onChange: (value: string[]) => void;
-  /** 是否多选，多选时为 true */
-  multiple: true;
-  /** 触发器类型 */
-  triggerType?: TriggerType;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 占位文本 */
-  placeholder?: string;
-}
-
-type ChatSelectProps = ChatSelectSingleProps | ChatSelectMultipleProps;
-```
-
-### Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` | `string \| null` / `string[]` | - | **必填**。单选传 `string \| null`（群组 ID），多选传 `string[]` |
-| `onChange` | `function` | - | **必填**。值变化回调，返回值形态与 `value` 匹配 |
-| `multiple` | `boolean` | `false` | 是否多选 |
-| `triggerType` | `'button' \| 'search' \| 'custom'` | `'button'` | 触发器类型，仅影响样式 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `placeholder` | `string` | `'请选择'` | 占位文本 |
-| `getOptionDisabled` | `(chat) => boolean` | - | 判断选项是否禁用 |
-
-### 受控规范
-
-> ⚠️ **强约束**
-
-1. **必须受控**：始终传 `value` + `onChange`
-2. **禁止传**：`undefined` / 群组对象 / 其他类型
-3. **空值规则**：
-   - 单选清空：`null`
-   - 多选清空：`[]`
-
-### 使用示例
-
-```tsx
-import { useState } from 'react';
-import { ChatSelect } from '@/components/business-ui/chat-select';
-
-// 单选
-function SingleSelectExample() {
-  const [chatId, setChatId] = useState<string | null>(null);
-
-  return (
-    <ChatSelect
-      value={chatId}
-      onChange={setChatId}
-      placeholder="请选择群组"
-    />
-  );
-}
-
-// 多选
-function MultipleSelectExample() {
-  const [chatIds, setChatIds] = useState<string[]>([]);
-
-  return (
-    <ChatSelect
-      multiple
-      value={chatIds}
-      onChange={setChatIds}
-      placeholder="请选择群组"
-      getOptionDisabled={(chat) => chat.id === 'disabled-id'}
-    />
-  );
-}
-```
-
----
-
-## UserDisplay 用户展示组件
-
-**组件路径**：`@/components/business-ui/user-display`
-
-### 功能概述
-
-- 用于所有用户信息的展示场景
-- 显示用户**头像**和**姓名**
-- 支持单用户和多用户展示
-- 点击用户会弹出 `UserProfile` 卡片
-- 当没有用户的 name 和 avatar 时，只要确保传递了 `user_id` 即可，组件会自动查询用户信息
-
-> ⚠️ **注意**：当不传递 `showLabel` 时，组件会同时展示用户头像和姓名。如果只需要头像，需要传递 `showLabel={false}`
-
-### 类型定义
-
-```typescript
-
-/** 头像尺寸 */
-type AvatarSize = 'small' | 'medium' | 'large';
-
-/** UserDisplay Props */
-interface IUserDisplayProps {
-  /** 用户 ID */
-  value?: string[];
-  /** 头像尺寸 */
-  size?: AvatarSize;
-  /** 自定义样式类名 */
-  className?: string;
-  /** 自定义内联样式 */
-  style?: React.CSSProperties;
-  /** 是否显示用户姓名，默认 true。设为 false 则只展示头像 */
-  showLabel?: boolean;
-}
-```
-
-### Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` |  `string[]` | - | 用户 ID 数组 |
-| `size` | `'small' \| 'medium' \| 'large'` | `'medium'` | 头像尺寸 |
-| `className` | `string` | - | 自定义样式类名 |
-| `style` | `React.CSSProperties` | - | 自定义内联样式 |
-| `showLabel` | `boolean` | `true` | 是否显示用户姓名，设为 `false` 只展示头像 |
-
-### 使用示例
-
-```tsx
-import { UserDisplay } from '@/components/business-ui/user-display';
-
-// 单用户展示 - 使用 ID
-function SingleUserExample() {
-  return (
-    <UserDisplay
-      value={["user-123"]}
-      size="small"
-    />
-  );
-}
-
-// 多用户展示 - 使用 ID 数组
-function MultipleUsersExample() {
-  const userIds: string[] = ['1', '2', '3'];
-
-  return (
-    <UserDisplay
-      value={userIds}
-      size="medium"
-      className="project-members"
-    />
-  );
-}
-
-// 仅展示头像
-function AvatarOnlyExample() {
-  return (
-    <UserDisplay
-      value={["user-123"]}
-      showLabel={false}
-    />
-  );
-}
-```
-
-### 最佳实践
-
-- 根据展示场景选择合适的组件尺寸
-- 对于用户信息`user_id`，**禁止直接展示文本**，总是使用 `UserDisplay` 组件展示
-- 对于需要显示完整用户详情的场景，使用 `UserProfile` 组件
-
----
-
-## UserProfile 用户详情组件
-
-**组件路径**：`@/components/business-ui/user-profile/user-profile`
-
-### 功能概述
-
-- 用于显示用户详细信息卡片
-- 支持两种显示模式：简单信息卡片和飞书官方用户卡片
-- 自动处理用户状态和类型标识
-- 提供邮箱链接功能
-- 支持错误重试机制
-
-### 类型定义
-
-```typescript
-/** UserProfile Props */
-interface UserProfileProps {
-  /** 用户 ID*/
-  value?: string;
-}
-```
-
-### Props 说明
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `value` | `string` | - | 用户 ID |
-
-### 使用示例
-
-```tsx
-import { UserProfile } from '@/components/business-ui/user-profile/user-profile';
-
-// 基础用法 - 使用字符串 ID
-function BasicExample() {
-  return <UserProfile value="user-123" />;
-}
-```