# patent-web

**Repository Path**: Miri66/patent-web

## Basic Information

- **Project Name**: patent-web
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT-0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# patent-web — 知识产权智能检索评估平台前端

基于 **Vue 3 + Element Plus + Vite** 的知识产权智能检索评估平台前端，对接 `patent-server` 微服务后端（网关统一入口）。

- 技术栈：Vue 3（`<script setup>` 组合式 API）+ Element Plus + Vue Router + Pinia + Axios + ECharts
- 样式规范：每个组件使用 `<style scoped>` 传统 CSS，专业蓝主题（主色 `#1e40af`）
- 接口策略：**已实现的后端接口全部走真实接口（经网关 8090）**；后端未实现的接口使用前端 mock（集中在 `src/api/mock/`，页面与代码中有明确标注）

## 快速开始

```bash
cd ~/patent-web
npm install        # 已安装可跳过
npm run dev        # http://localhost:5173
```

已创建联调测试账号（走真实注册接口写入数据库）：

| 账号 | 密码 | 角色 |
|---|---|---|
| `frontend_test` | `test123456` | 专利申请人（APPLICANT） |

> 注册入口（`/register`）可自助创建 APPLICANT / AGENT / ADMIN 三种角色账号。

## 前后端链路

```
浏览器 → Vite DevServer(:5173) /api 代理 → Gateway(:8090) → 各微服务
```

- 所有请求统一走网关：`vite.config.js` 中将 `/api` 代理到 `http://localhost:8090`（`src/api/request.js` baseURL 为 `/api`）
- 登录返回 JWT（1 小时有效），前端存 `localStorage('patent-token')`，请求拦截器自动注入 `Authorization` 头
- 统一响应体 `ResponseResult{code, message, data}`：`code=200` 取 `data`；`401` 清登录态跳登录页；其余弹错误提示
- 文件下载（档案 Excel/PDF、年费 Excel）以 `responseType: 'blob'` 处理二进制流

## ⚠️ 后端需要补的两件事（前端已按此约定实现）

### 1. 网关路由（gateway-service application.yml 目前只有 user/application/notification 三条）

补充以下路由（仅配置参考，未改动你的后端代码）：

```yaml
spring.cloud.gateway.server.webflux.routes:
  - id: patent_route
    uri: lb://patent-service
    predicates:
      - Path=/patent/**,/manage/patent/**,/monitor/**,/riskTask/**
  - id: ai_route
    uri: lb://ai-service
    predicates:
      - Path=/ai/**,/analyze/**,/chatCheckAi/**
  - id: archive_route
    uri: lb://archive-service
    predicates:
      - Path=/archive/**
  - id: evaluation_route          # application-service 的评估回调接口（若 Feign 直调可去掉）
    uri: lb://application-service
    predicates:
      - Path=/evaluation/**
```

### 2. 网关权限表 url_perms（AuthFilter 按表驱动，新路径不补记录会被 403 拦截）

当前表里只有 `/user/login/**`、`/user/register/**` 免登录和 `/user/info`、`/application/**` 等记录。
新接入路径需插入记录（`pid=1` 需登录、`required_roles=NULL` 不限角色）：

```sql
INSERT INTO url_perms (pid, uri, required_roles) VALUES
  (1, '/patent/**',            NULL),
  (1, '/manage/patent/**',     NULL),
  (1, '/monitor/**',           NULL),
  (1, '/riskTask/**',          NULL),
  (1, '/application/list/**',  NULL),
  (1, '/application/detail/**',NULL),
  (1, '/ai/**',                NULL),
  (1, '/analyze/**',           NULL),
  (1, '/archive/**',           NULL),
  (1, '/notification/**',      NULL),
  (1, '/evaluation/**',        NULL);
-- 如需按角色隔离，例如死信管理仅管理员：
-- INSERT INTO url_perms (pid, uri, required_roles) VALUES (1, '/notification/log/**', 'ADMIN');
```

## 页面清单与角色权限

| 页面 | 路由 | 接口来源 |
|---|---|---|
| 登录 / 注册 | `/login` `/register` | 真实（/user/**） |
| 工作台 | `/dashboard` | 真实（检索总量/年费/未读通知）+ 静态架构展示 |
| 专利检索 | `/patent/search` | 真实（/patent/retrieve + 检索历史） |
| 专利详情 | `/patent/detail/:id` | 真实（基础/全文详情 + 同族） |
| 申报评估（核心） | `/evaluation/apply` | 真实（/application/apply 上传 → submit → /ai/evaluation-task 轮询 → agentOutputs 报告渲染） |
| 申报管理 | `/evaluation/list` | 真实（`/application/list` 分页列表 + `/application/detail/{id}` 详情 + 评估任务查询 + 代理人审核 reviewReport） |
| 侵权风险筛查 | `/infringement` | 真实（提交 `/manage/patent/infringementScreening` + 任务列表 `/riskTask/list` + 详情轮询 `/riskTask/detail/{id}`，result 为 Agent 输出的 Markdown 报告） |
| 档案管理 | `/archive` | 真实（检索 + Excel/PDF 导出） |
| 年费管理 | `/fee` | 真实（列表/缴费/导出/手动触发计划提醒逾期） |
| 消息中心 | `/notification` | 真实（列表/已读） |
| 竞争对手监控 | `/monitor` | 创建/暂停/删除真实；列表与命中历史 **MOCK** |
| 专利组合分析 | `/portfolio` | 全 **MOCK**（后端未实现） |
| 专利数据管理 | `/admin/patent-data` | 真实（单条录入 /manage/patent/create、批量导入 import、按号查询）—— AGENT/ADMIN |
| 统计分析 | `/admin/stats` | 效率分析真实（/analyze/efficiencyAnalysis）；资产分析/年费风险/监控命中 **MOCK** —— AGENT/ADMIN |
| 死信管理 | `/admin/deadletter` | 真实（/notification/log/fail + retry）—— ADMIN |
| 个人中心 | `/profile` | 真实（/user/info、infoUpdata、modifySelfPwd） |

角色菜单：APPLICANT（申请人）看业务菜单；AGENT（代理人）多"专利数据管理/统计分析"与审核操作；ADMIN（管理员）再多"死信管理"与年费手动触发。

## Mock 接口清单（后端补齐后替换）

| Mock 文件 | 模拟内容 | 对应后端缺失 |
|---|---|---|
| `src/api/mock/monitor.js` | 监控任务列表 / 命中历史 | patent-service 仅有创建/暂停/删除 |
| `src/api/mock/portfolio.js` | 专利组合 CRUD / AI 分析 / 价值评估 / 对比 | 组合分析服务未实现 |
| `src/api/mock/stats.js` | 资产综合分析 / 年费风险预警 / 监控命中分析 | SQL 专项报表接口未实现 |

> 原有的 `mock/application.js`（申报列表）与 `mock/infringement.js`（侵权筛查结果）已在后端补充 `/application/list`、`/application/detail/{id}`、`/riskTask/list`、`/riskTask/detail/{id}` 后移除，页面已切换为真实接口。

替换方式：后端接口就绪后，在对应页面把 `import ... from '@/api/mock/xxx'` 换成真实 API 模块并调整字段映射即可。

## 已知对接细节（与后端实现严格对齐）

- 申报保存 `/application/apply` 为 multipart：**附图 drawingImages 必传 1-10 张**（后端 @Size 校验），前端已做前置提示
- 评估任务无 SSE，前端按 **3 秒轮询** `GET /ai/evaluation-task?applicationId=`，SUCCESS 后解析 `agentOutputs`（JSON 数组）渲染四维评分/相似专利/风险清单/申报书初稿
- 申报列表 `GET /application/list?page=&size=` 返回当前用户数据（IPage 结构），无关键词/状态筛选参数，前端筛选为当前页内过滤
- 侵权筛查任务为异步：PARSING → SCREENING → SUCCESS/FAILED，`/riskTask/detail/{id}` 的 `result` 为 Agent 输出的 Markdown 报告文本，前端原文渲染
- 监控暂停/删除接口的 body 是**裸 Long**（非 JSON 对象），前端已按此传参
- 检索历史后端自动记录（Redis search:history:{userId}，最近 20 条），前端只做展示/回填/清空
- 检索法律状态取值为中文：`有效 / 审中 / 失效`（ES Keyword 精确匹配）
- 申报状态机（后端 ApplicationStatus 枚举）：DRAFT→SUBMITTED→EVALUATING→EVALUATED→(EVALUATED_CONFIRMED)→UNDER_REVIEW→UNDER_EXAMINATION→GRANTED/REJECTED→ARCHIVED