# xinxin-ca-web

**Repository Path**: chen_jialin123/xinxin-ca-web

## Basic Information

- **Project Name**: xinxin-ca-web
- **Description**: xinxinca-web
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Xinxin CA Web

电子签名系统前端项目，基于 Vue Vben Admin 5.x 改造，面向 CA 证书、电子印章、签章、验签、时间戳、审计日志等业务场景。

后端仓库位于相邻目录 `D:\Project\ca-ehs\xinxin-ca`，是 Java 17 + Spring Boot 3.5 + Spring Cloud
Alibaba 的 Maven 多模块项目。前端默认通过 `http://127.0.0.1:48080/admin-api` 访问后端聚合服务。

## 技术栈

- Vue 3
- TypeScript
- Vite
- pnpm workspace
- Turbo
- Ant Design Vue
- Pinia
- Vue Router
- Vue Vben Admin monorepo

## 环境要求

| 工具      | 版本                             |
|---------|--------------------------------|
| Node.js | `^22.18.0` 或 `^24.0.0`         |
| pnpm    | `>= 11.0.0`，当前锁定 `pnpm@11.2.2` |

项目启用了 `only-allow pnpm`，请使用 pnpm 安装依赖和运行脚本。

## 快速开始

```bash
pnpm install
pnpm dev:antd
```

默认开发端口来自 `apps/web-antd/.env.development`：

```bash
VITE_PORT=5666
VITE_BASE_URL=http://127.0.0.1:48080
VITE_GLOB_API_URL=/admin-api
```

启动后访问：

```text
http://localhost:5666
```

默认登录账号配置在 `apps/web-antd/.env.development`：

```bash
VITE_APP_DEFAULT_USERNAME=admin
VITE_APP_DEFAULT_PASSWORD=admin123
```

## 常用命令

| 命令                | 说明                     |
|-------------------|------------------------|
| `pnpm install`    | 安装依赖                   |
| `pnpm dev:antd`   | 启动 Ant Design Vue 版本应用 |
| `pnpm build:antd` | 构建 Ant Design Vue 版本应用 |
| `pnpm check:type` | TypeScript 类型检查        |
| `pnpm lint`       | 运行 lint                |
| `pnpm format`     | 格式化代码                  |
| `pnpm test:unit`  | 运行单元测试                 |
| `pnpm clean`      | 清理构建/缓存产物              |

## 项目结构

```text
xinxin-ca-web
├─ apps/
│  └─ web-antd/              # 主前端应用
│     ├─ src/
│     │  ├─ api/             # 接口封装
│     │  ├─ views/           # 页面
│     │  ├─ router/          # 路由
│     │  ├─ store/           # 状态管理
│     │  ├─ layouts/         # 布局与登录视觉
│     │  ├─ components/      # 应用级组件
│     │  └─ utils/           # 工具函数
│     ├─ .env                # 应用通用环境变量
│     ├─ .env.development    # 开发环境变量
│     └─ vite.config.ts      # Vite 配置
├─ packages/                 # Vben workspace 共享包
├─ internal/                 # 构建、lint、tsconfig 等内部配置
├─ scripts/                  # 工程脚本
├─ docs/                     # 文档站相关内容
├─ package.json              # 根脚本和 workspace 管理
└─ pnpm-workspace.yaml       # workspace 与依赖 catalog
```

## CA 业务模块

CA 相关接口集中在：

```text
apps/web-antd/src/api/ca
├─ apply/       # CA 信息申请
├─ audit/       # 审计日志
├─ cert/        # 证书申请、签发、吊销、续期等
├─ info/        # CA 信息管理
├─ provider/    # 第三方 CA 服务商与证书操作
├─ seal/        # 电子印章、授权、模板、策略、生命周期
├─ sign/        # PDF/OFD 签章
├─ timestamp/   # 时间戳
└─ verify/      # 验签与验章
```

CA 页面集中在：

```text
apps/web-antd/src/views/ca
├─ audit/        # 审计日志
├─ certificate/  # 证书管理
├─ provider/     # CA 服务商与第三方证书操作
├─ seal/         # 印章中心
├─ timestamp/    # 时间戳
└─ verify/       # 验签验章
```

后端对应模块在 `D:\Project\ca-ehs\xinxin-ca\xinxin-module-ca`，核心后端入口包括：

- `xinxin-module-ca-server/src/main/java/cn/start/xinxin/module/ca/CaServerApplication.java`
- `xinxin-module-ca-server/src/main/java/cn/start/xinxin/module/ca/controller/admin`
- `xinxin-module-ca-server/src/main/java/cn/start/xinxin/module/ca/service`
- `xinxin-module-ca-api/src/main/java/cn/start/xinxin/module/ca`

## 后端联调

推荐使用后端聚合启动模块：

```bash
cd D:\Project\ca-ehs\xinxin-ca
mvn -pl xinxin-server -am spring-boot:run
```

前端开发环境默认访问：

```text
http://127.0.0.1:48080/admin-api
```

如果改为独立启动 CA 服务，后端 CA `local` profile 端口为 `48083`。此时需要根据网关、代理或后端暴露路径同步调整
`apps/web-antd/.env.development` 中的 `VITE_BASE_URL` / `VITE_GLOB_API_URL`。

后端本地配置通常依赖：

- MySQL: `127.0.0.1:3306/ruoyi-vue-pro`
- Redis: `127.0.0.1:6379`
- Nacos: `127.0.0.1:8848`

## 环境变量说明

| 变量                            | 说明                      |
|-------------------------------|-------------------------|
| `VITE_APP_TITLE`              | 应用标题，当前为电子签名系统          |
| `VITE_APP_NAMESPACE`          | 本地缓存、store 等命名空间        |
| `VITE_PORT`                   | Vite 开发端口，当前为 `5666`    |
| `VITE_BASE_URL`               | 后端服务根地址                 |
| `VITE_GLOB_API_URL`           | API 前缀，当前为 `/admin-api` |
| `VITE_UPLOAD_TYPE`            | 文件上传方式，`server` 表示经后端上传 |
| `VITE_APP_TENANT_ENABLE`      | 租户开关                    |
| `VITE_APP_CAPTCHA_ENABLE`     | 验证码开关                   |
| `VITE_APP_API_ENCRYPT_ENABLE` | API 加解密开关               |

## 开发约定

- 新接口优先放在 `apps/web-antd/src/api/<module>`，页面通过 API 层调用后端。
- CA 页面按业务域放在 `apps/web-antd/src/views/ca/<domain>`。
- 共享 UI、请求、权限、状态等能力优先复用 `packages/` 下的 Vben workspace 包。
- 菜单和权限通常由后端系统模块下发，新增页面后需要同步检查后端菜单 SQL 或管理端菜单配置。
- 修改环境变量后需要重启 Vite dev server。

## 构建

```bash
pnpm build:antd
```

构建产物由 `apps/web-antd` 的 Vite 配置生成，部署时需确保后端 API 地址、前端 base path、网关转发规则一致。