# polyv-web-interactions-sdk-ui

**Repository Path**: polyv_ef/polyv-web-interactions-sdk-ui

## Basic Information

- **Project Name**: polyv-web-interactions-sdk-ui
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-09
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# interactions-receive-sdk (V2)

## 介绍

- 保利威互动接收端 SDK（V2），包含多个互动模块的 UI 组件（如：问卷、抽奖、签到、投票、答题卡、优惠券、公告等）。
- 本开源项目需要搭配对应的逻辑层 SDK（`@polyv/*-sdk`）一起使用，例如：`@polyv/lottery-sdk`、`@polyv/questionnaire-sdk`、`@polyv/answer-card-sdk`、`@polyv/check-in-sdk`、`@polyv/coupon-sdk`、`@polyv/lucky-lottery-sdk`、`@polyv/vote-sdk`、`@polyv/bulletin-sdk`。

## 项目说明

本项目基于 `Vite + Vue 2.7 + TypeScript + pnpm` 实现的 monorepo 架构。

> 注意：部分类型推导需要配套 SDK 的 `peerDependencies`。请参考各 `@polyv/*-sdk` 包的 `package.json`，按需将对应依赖安装到项目的 `devDependencies` 中。

## 项目运行

项目使用 [pnpm](https://pnpm.io/zh/9.x/cli/add) 作为包管理器，运行前请确保 `node` 版本 `>= 20.10.0`，`pnpm` 版本 `>= 7.29.0`。

请检查项目 `package.json`，确保已经安装了需要的 `@polyv/*-sdk` 依赖。

在项目根目录使用 `pnpm` 来执行以下命令：

```sh
pnpm install
pnpm dev
```

启动后，在浏览器访问 `http://localhost:25050/`。在 `demo` 目录中复制 `.env.example` 为 `.env.local`，填写保利威账号相关信息后刷新页面即可进入对应的 demo。

## 构建发布

进入到需要构建的目录，执行以下命令：

```sh
# 构建 UI 组件包（示例：问卷接收端）
cd packages/questionnaire/ui-receive && pnpm run build

# 构建 UI 组件包（示例：抽奖发起端）
cd packages/lottery/ui-launch && pnpm run build

# 构建共享 UI 组件
cd packages/_shared/ui-shared && pnpm run build
```

## 目录说明

项目根目录说明

| 路径 | 说明 |
| :--------- | :----- |
| packages/ | monorepo 包目录 |
| demo/ | 互动接收端 Demo |
| package.json | 根项目配置文件 |
| pnpm-workspace.yaml | pnpm workspace 配置 |
| tsconfig.base.json | TypeScript 基础配置 |

`packages` 目录说明

| 路径 | 说明 | 单元测试框架 | 运行测试命令 |
| :------------- | :--------- | :--------- | :--------- |
| packages/_shared/ui-shared | UI 共享组件和工具函数 | - | - |
| packages/*/ui-receive | 各互动模块接收端 UI 组件 | - | - |
| packages/*/ui-launch | 部分互动模块发起端 UI 组件 | - | - |
| packages/*/demo | 模块示例项目 | - | - |

## 相关链接

- [保利威官网](https://www.polyv.net/)
- [保利威开发者中心](https://dev.polyv.net/)