diff --git a/.gitignore b/.gitignore index f53d388..67b9ae0 100644 --- a/.gitignore +++ b/.gitignore @@ -22,11 +22,13 @@ htmlcov/ node_modules/ dist/ build/ +target/ .next/ coverage/ *.tsbuildinfo .env .env.* +!.env.example # ---- importer:本地数据、产物与大文件(不进 Git) ---- /importer/output/ diff --git a/README.md b/README.md index 0b4d33d..05f93f0 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,13 @@ | 目录 | 项目 | 状态 | 说明 | |---|---|---|---| | `importer/` | 单词导入 | 已有 | 从 Lexis 导出词书与词条,建库并导入 SQLite/PostgreSQL/MySQL | -| `frontend/` | 单词管理前端 | 占位 | 待定技术栈 | -| `backend/` | 单词管理后端 | 占位 | 待定技术栈 | +| `backend/` | 管理后台后端 | 已有 | Spring Boot 3 + MyBatis-Plus,只读查询 MySQL `word_market` | +| `frontend/` | 管理后台前端 | 已有 | Vue 3 + Vite + TypeScript + Element Plus + ECharts | ## 快速开始 +### 1. 导入数据 + 单词导入流程见 [`importer/README.md`](importer/README.md)。命令需在 `importer/` 目录下执行: ```powershell @@ -17,6 +19,38 @@ cd importer python run.py ``` +### 2. 启动后端 + +准备数据库连接、管理员账号和 JWT 密钥(见 [`backend/README.md`](backend/README.md)): + +```powershell +cd backend +$env:DB_USERNAME = 'your_user' +$env:DB_PASSWORD = 'your_password' +$env:ADMIN_USERNAME = 'admin' +$env:ADMIN_PASSWORD_HASH = '$2a$10$...' +$env:JWT_SECRET = 'at-least-32-bytes-random-secret' +mvn spring-boot:run +``` + +默认监听 `http://127.0.0.1:8080`。 + +### 3. 启动前端 + +```powershell +cd frontend +npm install +npm run dev +``` + +默认地址 `http://127.0.0.1:5173`,开发服务器代理 `/api` 到后端。 + +## 管理后台 + +只读管理后台覆盖六个模块:概览、词书、词条、词根词族、近反义词、数据质量。所有接口仅执行 `SELECT`,应用层启用只读事务,建议数据库侧使用只读账号。 + +生产部署方式为后端可执行 jar + 前端 `dist` 静态资源,由 Nginx 托管并反向代理 `/api`。 + ## 数据与产物 `importer/` 下的数据与研究产物不纳入 Git(见 `.gitignore`),仅保留在本机: @@ -30,6 +64,8 @@ Git 只跟踪源码、文档与配置。 ## 文档 +- 管理后端:[`backend/README.md`](backend/README.md) +- 管理前端:[`frontend/README.md`](frontend/README.md) - 导入流程与算法:[`importer/README.md`](importer/README.md) - 数据实体关系模型:[`importer/docs/DATA-MODEL.md`](importer/docs/DATA-MODEL.md) - ZPK 解密内容分析:[`importer/docs/zpk-decrypted-content-analysis.md`](importer/docs/zpk-decrypted-content-analysis.md) diff --git a/backend/.env.example b/backend/.env.example new file mode 100644 index 0000000..8208502 --- /dev/null +++ b/backend/.env.example @@ -0,0 +1,18 @@ +# 复制为 .env 或直接在运行环境中设置;不要提交真实值。 +DB_URL=jdbc:mysql://s1.void01.com:3306/word_market?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true&connectTimeout=10000&socketTimeout=30000 +DB_USERNAME=your_read_only_user +DB_PASSWORD=your_password +DB_POOL_SIZE=15 + +ADMIN_USERNAME=admin +# BCrypt 哈希,可用 htpasswd 生成:htpasswd -bnBC 10 "" 'your-password' | tr -d ':\n' +ADMIN_PASSWORD_HASH=$2a$10$replace_with_a_real_bcrypt_hash +JWT_SECRET=replace_with_a_random_secret_at_least_32_characters +ADMIN_TOKEN_TTL_HOURS=8 + +CORS_ALLOWED_ORIGINS=http://localhost:5173,http://127.0.0.1:5173 +COVER_BASE_URL=https://static.beingfine.cn +CACHE_TTL_MINUTES=10 +CACHE_MAXIMUM_SIZE=200 +KNOWN_MISSING_ZPK_KEYS=0_53785_101_1775241011 +SERVER_PORT=8080 diff --git a/backend/README.md b/backend/README.md index 58ebe97..ee8a462 100644 --- a/backend/README.md +++ b/backend/README.md @@ -1,7 +1,116 @@ -# backend — 单词管理后端 +# backend — 词库只读管理后端 -占位目录,技术栈待定。 +Spring Boot 3.3 + Java 17 + MyBatis-Plus,只读连接 MySQL `word_market`,为 `frontend/` 提供查询接口。 -用途:为 `frontend` 提供词书、词条及关联数据的查询与编辑接口,数据来源为 `importer` 生成的数据库。 +## 只读约束 -后续确定技术栈与目录结构后在此实现。 +- 所有业务接口只执行 `SELECT`,代码中不存在任何写 Mapper。 +- 所有 Service 标注 `@Transactional(readOnly = true)`。 +- HikariCP 设置 `read-only: true`。 +- 数据库侧建议使用仅具备 `SELECT` 权限的账号;创建只读账号属于运维动作,需要单独确认后执行。 + +## 环境要求 + +- JDK 17 +- Maven 3.9+ +- 可访问的 MySQL `word_market` 数据库 + +## 配置 + +复制 `.env.example` 或参考 `src/main/resources/application.example.yml`。所有敏感值通过环境变量注入,仓库不保存真实凭据。 + +| 变量 | 必填 | 说明 | +|---|---|---| +| `DB_URL` | 否 | JDBC 地址,默认 `jdbc:mysql://s1.void01.com:3306/word_market?...` | +| `DB_USERNAME` | 是 | 数据库用户名 | +| `DB_PASSWORD` | 是 | 数据库密码 | +| `DB_POOL_SIZE` | 否 | Hikari 最大连接数,默认 15 | +| `ADMIN_USERNAME` | 是 | 管理员用户名 | +| `ADMIN_PASSWORD_HASH` | 是 | 管理员密码的 BCrypt 哈希 | +| `JWT_SECRET` | 是 | HS256 签名密钥,至少 32 字节 | +| `ADMIN_TOKEN_TTL_HOURS` | 否 | token 有效期,默认 8 小时 | +| `CORS_ALLOWED_ORIGINS` | 否 | 逗号分隔的前端来源,默认 `http://localhost:5173,http://127.0.0.1:5173` | +| `COVER_BASE_URL` | 否 | 封面 CDN 前缀,默认 `https://static.beingfine.cn` | +| `CACHE_TTL_MINUTES` | 否 | 聚合缓存时长,默认 10 分钟 | +| `CACHE_MAXIMUM_SIZE` | 否 | 聚合缓存条目上限,默认 200 | +| `KNOWN_MISSING_ZPK_KEYS` | 否 | 已知缺失的 zpk 文件键,逗号分隔 | +| `SERVER_PORT` | 否 | 服务端口,默认 8080 | + +缺少 `ADMIN_USERNAME`、`ADMIN_PASSWORD_HASH` 或 `JWT_SECRET` 时应用会拒绝启动并输出缺失项;`JWT_SECRET` 少于 32 字节同样拒绝启动。 + +生成 BCrypt 哈希: + +```bash +htpasswd -bnBC 10 "" 'your-password' | tr -d ':\n' +# 或 +python -c "import bcrypt; print(bcrypt.hashpw(b'your-password', bcrypt.gensalt()).decode())" +``` + +## 启动 + +```bash +cd backend +mvn spring-boot:run +``` + +或构建后运行: + +```bash +mvn -DskipTests package +java -jar target/word-market-admin-0.1.0.jar +``` + +## API + +统一前缀 `/api`,响应结构 `{ code, message, data }`;分页为 `{ items, total, page, size }`;数值 ID 以字符串返回。 + +| 模块 | 接口 | +|---|---| +| 认证 | `POST /api/auth/login` | +| 概览 | `GET /api/dashboard/summary`、`/exam-distribution`、`/book-size-top`、`/pos-distribution` | +| 词书 | `GET /api/books`、`/api/books/{id}`、`/api/books/{id}/entries`、`/api/exams` | +| 词条 | `GET /api/entries`、`/api/entries/{id}`、`/{id}/senses`、`/phrases`、`/examples`、`/confusables`、`/variants`、`/books` | +| 词根词族 | `GET /api/morphemes`、`/api/morphemes/{id}`、`/api/cards`、`/api/cards/{id}`、`/api/families`、`/api/families/{id}`、`/api/families/{id}/tree` | +| 近反义词 | `GET /api/synonyms`、`/api/synonyms/{wordId}`、`/api/synonyms/group-size-distribution` | +| 数据质量 | `GET /api/quality/summary`、`/declared-vs-actual`、`/missing-references`、`/cross-domain-coverage` | + +概览与质量聚合接口支持 `?refresh=true` 跳过缓存并重新计算。分页默认每页 20 条,最大 100 条。 + +## 测试 + +```bash +cd backend +mvn test +``` + +覆盖分页边界、认证成功/失败、404、空状态与缓存刷新行为。 + +## 部署 + +后端产出可执行 jar,前端由 Nginx 托管并反向代理 `/api`。示例: + +```nginx +server { + listen 80; + server_name example.com; + root /srv/word-market/frontend/dist; + index index.html; + + location / { + try_files $uri $uri/ /index.html; + } + + location /api/ { + proxy_pass http://127.0.0.1:8080; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_read_timeout 60s; + } +} +``` + +生产环境必须使用 HTTPS,并按需收紧 `CORS_ALLOWED_ORIGINS`。 + +## 已知数据异常 + +`KNOWN_MISSING_ZPK_KEYS` 默认登记 `0_53785_101_1775241011`,对应 importer 导出时缺失的一个 zpk 文件。数据质量模块会列出仍引用该文件键的词书关联;如后续补齐文件或更换数据快照,调整该配置即可。 diff --git a/backend/pom.xml b/backend/pom.xml new file mode 100644 index 0000000..9b9ff09 --- /dev/null +++ b/backend/pom.xml @@ -0,0 +1,94 @@ + + + 4.0.0 + + + org.springframework.boot + spring-boot-starter-parent + 3.3.5 + + + + com.wordmarket + word-market-admin + 0.1.0 + word-market-admin + 只读词库管理后台 + + + 17 + 3.5.7 + 0.12.6 + + + + + org.springframework.boot + spring-boot-starter-web + + + org.springframework.boot + spring-boot-starter-security + + + org.springframework.boot + spring-boot-starter-validation + + + org.springframework.boot + spring-boot-starter-cache + + + com.github.ben-manes.caffeine + caffeine + + + com.baomidou + mybatis-plus-spring-boot3-starter + ${mybatis-plus.version} + + + com.mysql + mysql-connector-j + runtime + + + io.jsonwebtoken + jjwt-api + ${jjwt.version} + + + io.jsonwebtoken + jjwt-impl + ${jjwt.version} + runtime + + + io.jsonwebtoken + jjwt-jackson + ${jjwt.version} + runtime + + + org.springframework.boot + spring-boot-starter-test + test + + + org.springframework.security + spring-security-test + test + + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + diff --git a/backend/src/main/java/com/wordmarket/admin/AdminApplication.java b/backend/src/main/java/com/wordmarket/admin/AdminApplication.java new file mode 100644 index 0000000..e4d8a6b --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/AdminApplication.java @@ -0,0 +1,17 @@ +package com.wordmarket.admin; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.security.servlet.UserDetailsServiceAutoConfiguration; +import org.springframework.boot.context.properties.ConfigurationPropertiesScan; +import org.springframework.cache.annotation.EnableCaching; + +@SpringBootApplication(exclude = UserDetailsServiceAutoConfiguration.class) +@ConfigurationPropertiesScan +@EnableCaching +public class AdminApplication { + + public static void main(String[] args) { + SpringApplication.run(AdminApplication.class, args); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/ApiResponse.java b/backend/src/main/java/com/wordmarket/admin/common/ApiResponse.java new file mode 100644 index 0000000..9bf1938 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/ApiResponse.java @@ -0,0 +1,12 @@ +package com.wordmarket.admin.common; + +public record ApiResponse(int code, String message, T data) { + + public static ApiResponse ok(T data) { + return new ApiResponse<>(0, "ok", data); + } + + public static ApiResponse error(int code, String message) { + return new ApiResponse<>(code, message, null); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/BizException.java b/backend/src/main/java/com/wordmarket/admin/common/BizException.java new file mode 100644 index 0000000..ffe6b64 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/BizException.java @@ -0,0 +1,29 @@ +package com.wordmarket.admin.common; + +import org.springframework.http.HttpStatus; + +public class BizException extends RuntimeException { + + private final HttpStatus status; + + public BizException(HttpStatus status, String message) { + super(message); + this.status = status; + } + + public HttpStatus getStatus() { + return status; + } + + public static BizException badRequest(String message) { + return new BizException(HttpStatus.BAD_REQUEST, message); + } + + public static BizException unauthorized(String message) { + return new BizException(HttpStatus.UNAUTHORIZED, message); + } + + public static BizException notFound(String message) { + return new BizException(HttpStatus.NOT_FOUND, message); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/GlobalExceptionHandler.java b/backend/src/main/java/com/wordmarket/admin/common/GlobalExceptionHandler.java new file mode 100644 index 0000000..c4c3317 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/GlobalExceptionHandler.java @@ -0,0 +1,45 @@ +package com.wordmarket.admin.common; + +import jakarta.validation.ConstraintViolationException; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.http.ResponseEntity; +import org.springframework.http.converter.HttpMessageNotReadableException; +import org.springframework.validation.FieldError; +import org.springframework.web.bind.MethodArgumentNotValidException; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; +import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException; + +@RestControllerAdvice +public class GlobalExceptionHandler { + + private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class); + + @ExceptionHandler(BizException.class) + public ResponseEntity> handleBiz(BizException ex) { + return ResponseEntity.status(ex.getStatus()) + .body(ApiResponse.error(ex.getStatus().value(), ex.getMessage())); + } + + @ExceptionHandler(MethodArgumentNotValidException.class) + public ResponseEntity> handleValidation(MethodArgumentNotValidException ex) { + FieldError fieldError = ex.getBindingResult().getFieldError(); + String message = fieldError == null + ? "请求参数不合法" + : "缺少或非法字段: " + fieldError.getField(); + return ResponseEntity.badRequest().body(ApiResponse.error(400, message)); + } + + @ExceptionHandler({ConstraintViolationException.class, MethodArgumentTypeMismatchException.class, + HttpMessageNotReadableException.class}) + public ResponseEntity> handleBadRequest(Exception ex) { + return ResponseEntity.badRequest().body(ApiResponse.error(400, "请求参数不合法")); + } + + @ExceptionHandler(Exception.class) + public ResponseEntity> handleUnexpected(Exception ex) { + log.error("Unhandled exception", ex); + return ResponseEntity.internalServerError().body(ApiResponse.error(500, "服务暂时不可用")); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/Items.java b/backend/src/main/java/com/wordmarket/admin/common/Items.java new file mode 100644 index 0000000..e956cd7 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/Items.java @@ -0,0 +1,10 @@ +package com.wordmarket.admin.common; + +import java.util.List; + +public record Items(List items) { + + public static Items of(List items) { + return new Items<>(items); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/PageResult.java b/backend/src/main/java/com/wordmarket/admin/common/PageResult.java new file mode 100644 index 0000000..95447d0 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/PageResult.java @@ -0,0 +1,10 @@ +package com.wordmarket.admin.common; + +import java.util.List; + +public record PageResult(List items, long total, int page, int size) { + + public static PageResult of(List items, long total, int page, int size) { + return new PageResult<>(items, total, page, size); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/Pages.java b/backend/src/main/java/com/wordmarket/admin/common/Pages.java new file mode 100644 index 0000000..df604e4 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/Pages.java @@ -0,0 +1,26 @@ +package com.wordmarket.admin.common; + +public final class Pages { + + private static final int DEFAULT_SIZE = 20; + private static final int MAX_SIZE = 100; + + private Pages() { + } + + public static int page(Integer page) { + return page == null || page < 1 ? 1 : page; + } + + public static int size(Integer size) { + if (size == null || size < 1) { + return DEFAULT_SIZE; + } + return Math.min(size, MAX_SIZE); + } + + public static int offset(int page, int size) { + long offset = (long) (page - 1) * size; + return (int) Math.min(offset, Integer.MAX_VALUE); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/common/RequestLogFilter.java b/backend/src/main/java/com/wordmarket/admin/common/RequestLogFilter.java new file mode 100644 index 0000000..8178f58 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/common/RequestLogFilter.java @@ -0,0 +1,34 @@ +package com.wordmarket.admin.common; + +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.Ordered; +import org.springframework.core.annotation.Order; +import org.springframework.stereotype.Component; +import org.springframework.web.filter.OncePerRequestFilter; + +import java.io.IOException; + +@Component +@Order(Ordered.HIGHEST_PRECEDENCE) +public class RequestLogFilter extends OncePerRequestFilter { + + private static final Logger log = LoggerFactory.getLogger(RequestLogFilter.class); + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, + FilterChain filterChain) throws ServletException, IOException { + long started = System.currentTimeMillis(); + try { + filterChain.doFilter(request, response); + } finally { + long elapsed = System.currentTimeMillis() - started; + log.info("{} {} -> {} ({} ms)", request.getMethod(), request.getRequestURI(), + response.getStatus(), elapsed); + } + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/config/AdminProperties.java b/backend/src/main/java/com/wordmarket/admin/config/AdminProperties.java new file mode 100644 index 0000000..8182db6 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/config/AdminProperties.java @@ -0,0 +1,76 @@ +package com.wordmarket.admin.config; + +import org.springframework.beans.factory.InitializingBean; +import org.springframework.boot.context.properties.ConfigurationProperties; + +import java.util.ArrayList; +import java.util.List; + +@ConfigurationProperties(prefix = "admin") +public class AdminProperties implements InitializingBean { + + private String username; + private String passwordHash; + private String jwtSecret; + private int tokenTtlHours = 8; + + @Override + public void afterPropertiesSet() { + List missing = new ArrayList<>(); + if (isBlank(username)) { + missing.add("ADMIN_USERNAME / admin.username"); + } + if (isBlank(passwordHash)) { + missing.add("ADMIN_PASSWORD_HASH / admin.password-hash"); + } + if (isBlank(jwtSecret)) { + missing.add("JWT_SECRET / admin.jwt-secret"); + } + if (!missing.isEmpty()) { + throw new IllegalStateException("缺少管理员配置: " + String.join(", ", missing)); + } + if (jwtSecret.getBytes(java.nio.charset.StandardCharsets.UTF_8).length < 32) { + throw new IllegalStateException("JWT_SECRET 至少需要 32 字节(当前 " + + jwtSecret.getBytes(java.nio.charset.StandardCharsets.UTF_8).length + " 字节)"); + } + if (tokenTtlHours <= 0) { + throw new IllegalStateException("ADMIN_TOKEN_TTL_HOURS 必须大于 0"); + } + } + + private static boolean isBlank(String value) { + return value == null || value.isBlank(); + } + + public String getUsername() { + return username; + } + + public void setUsername(String username) { + this.username = username; + } + + public String getPasswordHash() { + return passwordHash; + } + + public void setPasswordHash(String passwordHash) { + this.passwordHash = passwordHash; + } + + public String getJwtSecret() { + return jwtSecret; + } + + public void setJwtSecret(String jwtSecret) { + this.jwtSecret = jwtSecret; + } + + public int getTokenTtlHours() { + return tokenTtlHours; + } + + public void setTokenTtlHours(int tokenTtlHours) { + this.tokenTtlHours = tokenTtlHours; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/config/AppProperties.java b/backend/src/main/java/com/wordmarket/admin/config/AppProperties.java new file mode 100644 index 0000000..6e3ddf0 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/config/AppProperties.java @@ -0,0 +1,77 @@ +package com.wordmarket.admin.config; + +import org.springframework.boot.context.properties.ConfigurationProperties; + +@ConfigurationProperties(prefix = "app") +public class AppProperties { + + private final Cors cors = new Cors(); + private final Cache cache = new Cache(); + private final Quality quality = new Quality(); + private String coverBaseUrl = "https://static.beingfine.cn"; + + public static class Cors { + private String allowedOrigins = "http://localhost:5173"; + + public String getAllowedOrigins() { + return allowedOrigins; + } + + public void setAllowedOrigins(String allowedOrigins) { + this.allowedOrigins = allowedOrigins; + } + } + + public static class Cache { + private long ttlMinutes = 10; + private long maximumSize = 200; + + public long getTtlMinutes() { + return ttlMinutes; + } + + public void setTtlMinutes(long ttlMinutes) { + this.ttlMinutes = ttlMinutes; + } + + public long getMaximumSize() { + return maximumSize; + } + + public void setMaximumSize(long maximumSize) { + this.maximumSize = maximumSize; + } + } + + public static class Quality { + private String knownMissingZpkKeys = ""; + + public String getKnownMissingZpkKeys() { + return knownMissingZpkKeys; + } + + public void setKnownMissingZpkKeys(String knownMissingZpkKeys) { + this.knownMissingZpkKeys = knownMissingZpkKeys; + } + } + + public Cors getCors() { + return cors; + } + + public Cache getCache() { + return cache; + } + + public Quality getQuality() { + return quality; + } + + public String getCoverBaseUrl() { + return coverBaseUrl; + } + + public void setCoverBaseUrl(String coverBaseUrl) { + this.coverBaseUrl = coverBaseUrl; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/config/CacheConfig.java b/backend/src/main/java/com/wordmarket/admin/config/CacheConfig.java new file mode 100644 index 0000000..84d9adc --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/config/CacheConfig.java @@ -0,0 +1,20 @@ +package com.wordmarket.admin.config; + +import com.github.benmanes.caffeine.cache.Cache; +import com.github.benmanes.caffeine.cache.Caffeine; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import java.time.Duration; + +@Configuration +public class CacheConfig { + + @Bean + public Cache caffeineAggregateCache(AppProperties properties) { + return Caffeine.newBuilder() + .expireAfterWrite(Duration.ofMinutes(properties.getCache().getTtlMinutes())) + .maximumSize(properties.getCache().getMaximumSize()) + .build(); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/config/MybatisPlusConfig.java b/backend/src/main/java/com/wordmarket/admin/config/MybatisPlusConfig.java new file mode 100644 index 0000000..dc9e6d7 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/config/MybatisPlusConfig.java @@ -0,0 +1,20 @@ +package com.wordmarket.admin.config; + +import com.baomidou.mybatisplus.annotation.DbType; +import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; +import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +public class MybatisPlusConfig { + + @Bean + public MybatisPlusInterceptor mybatisPlusInterceptor() { + MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); + PaginationInnerInterceptor pagination = new PaginationInnerInterceptor(DbType.MYSQL); + pagination.setMaxLimit(100L); + interceptor.addInnerInterceptor(pagination); + return interceptor; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/config/SecurityConfig.java b/backend/src/main/java/com/wordmarket/admin/config/SecurityConfig.java new file mode 100644 index 0000000..ea6c4bc --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/config/SecurityConfig.java @@ -0,0 +1,79 @@ +package com.wordmarket.admin.config; + +import com.wordmarket.admin.security.JwtAuthFilter; +import com.wordmarket.admin.security.RestAuthEntryPoint; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.http.HttpMethod; +import org.springframework.security.config.Customizer; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; +import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer; +import org.springframework.security.config.http.SessionCreationPolicy; +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.security.web.SecurityFilterChain; +import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; +import org.springframework.web.cors.CorsConfiguration; +import org.springframework.web.cors.CorsConfigurationSource; +import org.springframework.web.cors.UrlBasedCorsConfigurationSource; + +import java.util.Arrays; +import java.util.List; + +@Configuration +@EnableWebSecurity +public class SecurityConfig { + + private final JwtAuthFilter jwtAuthFilter; + private final RestAuthEntryPoint restAuthEntryPoint; + private final AppProperties appProperties; + + public SecurityConfig(JwtAuthFilter jwtAuthFilter, RestAuthEntryPoint restAuthEntryPoint, + AppProperties appProperties) { + this.jwtAuthFilter = jwtAuthFilter; + this.restAuthEntryPoint = restAuthEntryPoint; + this.appProperties = appProperties; + } + + @Bean + public PasswordEncoder passwordEncoder() { + return new BCryptPasswordEncoder(); + } + + @Bean + public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { + return http + .csrf(AbstractHttpConfigurer::disable) + .cors(Customizer.withDefaults()) + .sessionManagement(session -> + session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)) + .authorizeHttpRequests(authorize -> authorize + .requestMatchers(HttpMethod.OPTIONS, "/**").permitAll() + .requestMatchers("/api/auth/login", "/error").permitAll() + .anyRequest().authenticated()) + .exceptionHandling(handling -> + handling.authenticationEntryPoint(restAuthEntryPoint)) + .addFilterBefore(jwtAuthFilter, UsernamePasswordAuthenticationFilter.class) + .httpBasic(AbstractHttpConfigurer::disable) + .formLogin(AbstractHttpConfigurer::disable) + .logout(AbstractHttpConfigurer::disable) + .build(); + } + + @Bean + public CorsConfigurationSource corsConfigurationSource() { + CorsConfiguration configuration = new CorsConfiguration(); + List origins = Arrays.stream(appProperties.getCors().getAllowedOrigins().split(",")) + .map(String::trim) + .filter(value -> !value.isEmpty()) + .toList(); + configuration.setAllowedOrigins(origins); + configuration.setAllowedMethods(List.of("GET", "POST", "OPTIONS")); + configuration.setAllowedHeaders(List.of("Authorization", "Content-Type")); + configuration.setMaxAge(3600L); + UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); + source.registerCorsConfiguration("/api/**", configuration); + return source; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/AuthController.java b/backend/src/main/java/com/wordmarket/admin/controller/AuthController.java new file mode 100644 index 0000000..09c463d --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/AuthController.java @@ -0,0 +1,27 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.dto.AuthDtos.LoginRequest; +import com.wordmarket.admin.dto.AuthDtos.LoginResponse; +import com.wordmarket.admin.service.AuthService; +import jakarta.validation.Valid; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/api/auth") +public class AuthController { + + private final AuthService authService; + + public AuthController(AuthService authService) { + this.authService = authService; + } + + @PostMapping("/login") + public ApiResponse login(@Valid @RequestBody LoginRequest request) { + return ApiResponse.ok(authService.login(request)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/BookController.java b/backend/src/main/java/com/wordmarket/admin/controller/BookController.java new file mode 100644 index 0000000..e5cf355 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/BookController.java @@ -0,0 +1,58 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.Items; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.BookDtos.BookDetail; +import com.wordmarket.admin.dto.BookDtos.BookEntryItem; +import com.wordmarket.admin.dto.BookDtos.BookListItem; +import com.wordmarket.admin.dto.BookDtos.ExamOption; +import com.wordmarket.admin.service.BookService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequestMapping("/api") +public class BookController { + + private final BookService bookService; + + public BookController(BookService bookService) { + this.bookService = bookService; + } + + @GetMapping("/books") + public ApiResponse> list( + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size, + @RequestParam(required = false) Long examId, + @RequestParam(required = false) String keyword, + @RequestParam(required = false) Boolean hasFile) { + return ApiResponse.ok(bookService.list(page, size, examId, keyword, hasFile)); + } + + @GetMapping("/books/{id}") + public ApiResponse detail(@PathVariable long id) { + return ApiResponse.ok(bookService.detail(id)); + } + + @GetMapping("/books/{id}/entries") + public ApiResponse> entries( + @PathVariable long id, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size, + @RequestParam(required = false) String keyword) { + return ApiResponse.ok(bookService.entries(id, page, size, keyword)); + } + + @GetMapping("/exams") + public ApiResponse> exams() { + List options = bookService.exams(); + return ApiResponse.ok(Items.of(options)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/DashboardController.java b/backend/src/main/java/com/wordmarket/admin/controller/DashboardController.java new file mode 100644 index 0000000..c8f3fd9 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/DashboardController.java @@ -0,0 +1,48 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.Items; +import com.wordmarket.admin.dto.DashboardDtos.ExamStat; +import com.wordmarket.admin.dto.DashboardDtos.PosStat; +import com.wordmarket.admin.dto.DashboardDtos.Summary; +import com.wordmarket.admin.dto.DashboardDtos.TopBook; +import com.wordmarket.admin.service.DashboardService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/api/dashboard") +public class DashboardController { + + private final DashboardService dashboardService; + + public DashboardController(DashboardService dashboardService) { + this.dashboardService = dashboardService; + } + + @GetMapping("/summary") + public ApiResponse summary( + @RequestParam(defaultValue = "false") boolean refresh) { + return ApiResponse.ok(dashboardService.summary(refresh)); + } + + @GetMapping("/exam-distribution") + public ApiResponse> examDistribution( + @RequestParam(defaultValue = "false") boolean refresh) { + return ApiResponse.ok(Items.of(dashboardService.examDistribution(refresh))); + } + + @GetMapping("/book-size-top") + public ApiResponse> bookSizeTop( + @RequestParam(defaultValue = "false") boolean refresh) { + return ApiResponse.ok(Items.of(dashboardService.topBooks(refresh))); + } + + @GetMapping("/pos-distribution") + public ApiResponse> posDistribution( + @RequestParam(defaultValue = "false") boolean refresh) { + return ApiResponse.ok(Items.of(dashboardService.posDistribution(refresh))); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/EntryController.java b/backend/src/main/java/com/wordmarket/admin/controller/EntryController.java new file mode 100644 index 0000000..0af36e3 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/EntryController.java @@ -0,0 +1,87 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.Items; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.EntryDtos.ConfusableItem; +import com.wordmarket.admin.dto.EntryDtos.EntryBookItem; +import com.wordmarket.admin.dto.EntryDtos.EntryDetail; +import com.wordmarket.admin.dto.EntryDtos.EntryListItem; +import com.wordmarket.admin.dto.EntryDtos.ExampleGroupItem; +import com.wordmarket.admin.dto.EntryDtos.PhraseItem; +import com.wordmarket.admin.dto.EntryDtos.SenseItem; +import com.wordmarket.admin.dto.EntryDtos.SpellingVariantItem; +import com.wordmarket.admin.service.EntryService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequestMapping("/api/entries") +public class EntryController { + + private final EntryService entryService; + + public EntryController(EntryService entryService) { + this.entryService = entryService; + } + + @GetMapping + public ApiResponse> list( + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size, + @RequestParam(required = false) String keyword) { + return ApiResponse.ok(entryService.list(page, size, keyword)); + } + + @GetMapping("/{id}") + public ApiResponse detail(@PathVariable long id) { + return ApiResponse.ok(entryService.detail(id)); + } + + @GetMapping("/{id}/senses") + public ApiResponse> senses(@PathVariable long id) { + List items = entryService.senses(id); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/{id}/phrases") + public ApiResponse> phrases( + @PathVariable long id, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(entryService.phrases(id, page, size)); + } + + @GetMapping("/{id}/examples") + public ApiResponse> examples( + @PathVariable long id, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(entryService.examples(id, page, size)); + } + + @GetMapping("/{id}/confusables") + public ApiResponse> confusables(@PathVariable long id) { + List items = entryService.confusables(id); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/{id}/variants") + public ApiResponse> variants(@PathVariable long id) { + List items = entryService.spellingVariants(id); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/{id}/books") + public ApiResponse> books( + @PathVariable long id, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(entryService.books(id, page, size)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/MorphologyController.java b/backend/src/main/java/com/wordmarket/admin/controller/MorphologyController.java new file mode 100644 index 0000000..3523f33 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/MorphologyController.java @@ -0,0 +1,77 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.MorphologyDtos.CardDetail; +import com.wordmarket.admin.dto.MorphologyDtos.CardItem; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyDetail; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyItem; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeDetail; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeItem; +import com.wordmarket.admin.dto.MorphologyDtos.TreePage; +import com.wordmarket.admin.service.MorphologyService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequestMapping("/api") +public class MorphologyController { + + private final MorphologyService morphologyService; + + public MorphologyController(MorphologyService morphologyService) { + this.morphologyService = morphologyService; + } + + @GetMapping("/morphemes") + public ApiResponse> morphemes( + @RequestParam(required = false) String type, + @RequestParam(required = false) String keyword, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(morphologyService.morphemes(type, keyword, page, size)); + } + + @GetMapping("/morphemes/{id}") + public ApiResponse morpheme(@PathVariable long id) { + return ApiResponse.ok(morphologyService.morpheme(id)); + } + + @GetMapping("/cards") + public ApiResponse> cards( + @RequestParam(required = false) String keyword, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(morphologyService.cards(keyword, page, size)); + } + + @GetMapping("/cards/{id}") + public ApiResponse card(@PathVariable long id) { + return ApiResponse.ok(morphologyService.card(id)); + } + + @GetMapping("/families") + public ApiResponse> families( + @RequestParam(required = false) String keyword, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(morphologyService.families(keyword, page, size)); + } + + @GetMapping("/families/{id}") + public ApiResponse family(@PathVariable long id) { + return ApiResponse.ok(morphologyService.family(id)); + } + + @GetMapping("/families/{id}/tree") + public ApiResponse tree( + @PathVariable long id, + @RequestParam(required = false) String nodeType, + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size) { + return ApiResponse.ok(morphologyService.tree(id, nodeType, page, size)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/QualityController.java b/backend/src/main/java/com/wordmarket/admin/controller/QualityController.java new file mode 100644 index 0000000..966b2be --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/QualityController.java @@ -0,0 +1,53 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.Items; +import com.wordmarket.admin.dto.QualityDtos.Coverage; +import com.wordmarket.admin.dto.QualityDtos.DeclaredDiff; +import com.wordmarket.admin.dto.QualityDtos.MissingReference; +import com.wordmarket.admin.dto.QualityDtos.QualitySummary; +import com.wordmarket.admin.service.QualityService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequestMapping("/api/quality") +public class QualityController { + + private final QualityService qualityService; + + public QualityController(QualityService qualityService) { + this.qualityService = qualityService; + } + + @GetMapping("/summary") + public ApiResponse summary( + @RequestParam(defaultValue = "false") boolean refresh) { + return ApiResponse.ok(qualityService.summary(refresh)); + } + + @GetMapping("/declared-vs-actual") + public ApiResponse> declaredVsActual( + @RequestParam(defaultValue = "false") boolean refresh) { + List items = qualityService.declaredVsActual(refresh); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/missing-references") + public ApiResponse> missingReferences( + @RequestParam(defaultValue = "false") boolean refresh) { + List items = qualityService.missingReferences(refresh); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/cross-domain-coverage") + public ApiResponse> crossDomainCoverage( + @RequestParam(defaultValue = "false") boolean refresh) { + List items = qualityService.crossDomainCoverage(refresh); + return ApiResponse.ok(Items.of(items)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/controller/SynonymController.java b/backend/src/main/java/com/wordmarket/admin/controller/SynonymController.java new file mode 100644 index 0000000..1315038 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/controller/SynonymController.java @@ -0,0 +1,46 @@ +package com.wordmarket.admin.controller; + +import com.wordmarket.admin.common.ApiResponse; +import com.wordmarket.admin.common.Items; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.SynonymDtos.SizeBucket; +import com.wordmarket.admin.dto.SynonymDtos.WordDetail; +import com.wordmarket.admin.dto.SynonymDtos.WordItem; +import com.wordmarket.admin.service.SynonymService; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequestMapping("/api/synonyms") +public class SynonymController { + + private final SynonymService synonymService; + + public SynonymController(SynonymService synonymService) { + this.synonymService = synonymService; + } + + @GetMapping + public ApiResponse> list( + @RequestParam(required = false) Integer page, + @RequestParam(required = false) Integer size, + @RequestParam(required = false) String keyword) { + return ApiResponse.ok(synonymService.list(page, size, keyword)); + } + + @GetMapping("/group-size-distribution") + public ApiResponse> distribution() { + List items = synonymService.groupSizeDistribution(); + return ApiResponse.ok(Items.of(items)); + } + + @GetMapping("/{wordId}") + public ApiResponse detail(@PathVariable long wordId) { + return ApiResponse.ok(synonymService.detail(wordId)); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/AuthDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/AuthDtos.java new file mode 100644 index 0000000..e887a1a --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/AuthDtos.java @@ -0,0 +1,16 @@ +package com.wordmarket.admin.dto; + +import jakarta.validation.constraints.NotBlank; + +public final class AuthDtos { + + private AuthDtos() { + } + + public record LoginRequest(@NotBlank(message = "用户名不能为空") String username, + @NotBlank(message = "密码不能为空") String password) { + } + + public record LoginResponse(String token, String expiresAt, String username) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/BookDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/BookDtos.java new file mode 100644 index 0000000..9395695 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/BookDtos.java @@ -0,0 +1,31 @@ +package com.wordmarket.admin.dto; + +public final class BookDtos { + + private BookDtos() { + } + + public record ExamOption(String id, String code, String name) { + } + + public record BookListItem(String id, String code, String name, String examId, String examName, + Long declared, long actual, boolean hasFile, String coverPath) { + } + + public record BookDetail(String id, String code, String name, String description, String examId, + String examName, Long declared, long actual, Integer contentVersion, + Integer schemaVersion, String coverPath, String packageUrl, boolean hasFile, + Long sortAt, String labels, boolean mismatch) { + } + + public record BookDetailRow(String id, String code, String name, String description, String examId, + String examName, Long declared, long actual, Integer contentVersion, + Integer schemaVersion, String coverPath, String packageUrl, + boolean hasFile, Long sortAt, String labels) { + } + + public record BookEntryItem(String entryId, String displayWord, String headwordText, + Integer seqBook, Integer seqAz, Integer seqFreq, String headword, + String indexWord) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/DashboardDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/DashboardDtos.java new file mode 100644 index 0000000..480192d --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/DashboardDtos.java @@ -0,0 +1,32 @@ +package com.wordmarket.admin.dto; + +import java.util.List; + +public final class DashboardDtos { + + private DashboardDtos() { + } + + public record Kpi(String key, String label, long value, String note, String tone) { + } + + public record QualityItem(String key, String label, long value, String unit, String level, + String target) { + } + + public record CoverageItem(String name, long hit, long total, double pct) { + } + + public record Summary(List kpis, List quality, List coverage) { + } + + public record ExamStat(String name, String code, long books, long entries) { + } + + public record TopBook(String id, String name, String code, String exam, Long declared, + long actual, String coverPath) { + } + + public record PosStat(String name, long value) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/EntryDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/EntryDtos.java new file mode 100644 index 0000000..a3ee72c --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/EntryDtos.java @@ -0,0 +1,111 @@ +package com.wordmarket.admin.dto; + +import java.util.List; + +public final class EntryDtos { + + private EntryDtos() { + } + + public record ExamRef(String id, String code, String name) { + } + + public record EntryListItem(String id, String headword, String indexWord, String pronunciation, + String definition, long senseCount, long bookCount) { + } + + public record EntryDetail(String id, String headword, String indexWord, String usPronunciation, + String ukPronunciation, String definitionText, String dataVersion, + String bookExamId, String bookExamName, Integer occurrenceCount, + boolean hasListeningExamples, String sourceZpkKey) { + } + + public record SenseRelation(String type, Integer position, String targetMeaningId, + String targetEntryId) { + } + + public record SenseItem(String senseId, Integer senseNo, String partOfSpeech, String glossZh, + List exams, List relations) { + } + + public record PhraseOrder(String examId, String examName, Integer groupType, Integer position) { + } + + public record PhraseItem(String id, String textEn, String textZh, Integer groupType, + String meaningId, List exams, List orders) { + } + + public record ExampleSentenceItem(String id, String textEn, String textZh, String sourceTitle, + String audioUrl, boolean listening) { + } + + public record ExampleUsageItem(String id, String patternId, String patternText, Integer position, + List sentences) { + } + + public record ExampleGroupItem(String id, Integer groupKind, String partOfSpeech, + String entryKindCode, String headForm, String definitionEn, + String definitionZh, List exams, + List usages, + List directSentences, long sentenceCount) { + } + + public record ConfusableItem(String id, String wordText, String glossZh, Integer posCode, + String spellingFlag, Integer position) { + } + + public record SpellingVariantItem(Integer position, String variant) { + } + + public record EntryBookItem(String bookId, String bookName, String bookCode, String displayWord, + Integer seqBook) { + } + + public record SenseExamRow(String senseId, String id, String code, String name) { + } + + public record SenseRelationRow(String senseId, String type, Integer position, String targetMeaningId, + String targetEntryId) { + } + + public record GroupExamRow(String groupId, String id, String code, String name) { + } + + public record UsageRow(String id, String groupId, String patternId, String patternText, + Integer position) { + } + + public record SentenceRow(String id, String groupId, String usageId, String textEn, String textZh, + String sourceTitle, String audioUrl, boolean listening) { + } + + public record PhraseExamRow(String phraseId, String id, String code, String name) { + } + + public record PhraseOrderRow(String examId, String examName, Integer groupType, Integer position, + String phraseId) { + } + + public record SenseRow(String senseId, Integer senseNo, String partOfSpeech, String glossZh) { + } + + public record PhraseRow(String id, String textEn, String textZh, Integer groupType, + String meaningId) { + } + + public record ExampleGroupRow(String id, Integer groupKind, String partOfSpeech, + String entryKindCode, String headForm, String definitionEn, + String definitionZh) { + } + + public record ConfusableRow(String id, String wordText, String glossZh, Integer posCode, + String spellingFlag, Integer position) { + } + + public record VariantRow(Integer position, String variant) { + } + + public record EntryBookRow(String bookId, String bookName, String bookCode, String displayWord, + Integer seqBook) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/MorphologyDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/MorphologyDtos.java new file mode 100644 index 0000000..59dafa0 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/MorphologyDtos.java @@ -0,0 +1,109 @@ +package com.wordmarket.admin.dto; + +import java.util.List; + +public final class MorphologyDtos { + + private MorphologyDtos() { + } + + public record ExamRef(String id, String code, String name) { + } + + public record MorphemeItem(String id, String type, String form, String displayText, String meaningEn, + String meaningZh, String note) { + } + + public record CardBrief(String id, String word, String memoryNote, String exampleText) { + } + + public record CardRow(String id, String word, String highlightedWord, String memoryNote, + String exampleText, boolean hidden, String prefixMorphemeId, + String rootMorphemeId, String suffixMorphemeId, String defaultFamilyRef) { + } + + public record CardItemRow(String id, String word, String memoryNote, String highlightedWord) { + } + + public record FamilyRow(String id, String word, String topFamilyId, String topWord, + String interpretation, Integer groupLevel1, Integer groupLevel2, + Integer groupLevel3) { + } + + public record FamilyLinkRow(String id, Integer groupNo, String familyRef, boolean hidden) { + } + + public record MorphemeDetail(String id, String type, String form, String displayText, + String meaningEn, String meaningZh, String note, + List cards, long cardCount) { + } + + public record CardItem(String id, String word, String memoryNote, String highlightedWord, + List exams) { + } + + public record CardFamilyLink(String linkId, Integer groupNo, String familyRef, boolean hidden) { + } + + public record CardDetail(String id, String word, String highlightedWord, String memoryNote, + String exampleText, boolean hidden, String prefixMorphemeId, String prefixForm, + String rootMorphemeId, String rootForm, String suffixMorphemeId, + String suffixForm, String defaultFamilyRef, List exams, + List familyLinks) { + } + + public record FamilyItem(String id, String word, String topFamilyId, String topWord, + String interpretation, Integer groupLevel1, Integer groupLevel2, + Integer groupLevel3, List exams) { + } + + public record FamilyVariantItem(String id, String variantWord, String interpretation, + long memberCount) { + } + + public record FamilyMemberItem(String familyEntryId, String word, Integer position) { + } + + public record MiniGroupItem(String id, Integer size, List members) { + } + + public record FamilyDetail(String id, String word, String topFamilyId, String topWord, + String interpretation, Integer groupLevel1, Integer groupLevel2, + Integer groupLevel3, List exams, + List variants, List miniGroups) { + } + + public record TreeNode(String nodeType, String id, String label, String subtitle, long memberCount, + boolean leaf) { + } + + public record TreePage(List nodes, long total, int page, int size) { + } + + public record LinkExamRow(String cardId, String id, String code, String name) { + } + + public record FamilyExamRow(String familyEntryId, String id, String code, String name) { + } + + public record MorphemeRefRow(String id, String form, String type, String meaningZh) { + } + + public record FamilyWordRow(String id, String word, String interpretation) { + } + + public record VariantRow(String id, String variantWord, String interpretation, long memberCount) { + } + + public record MiniGroupRow(String id, Integer size) { + } + + public record MemberRow(String familyEntryId, String word, Integer position) { + } + + public record CountRow(long count) { + } + + public record TreeCounts(long variantCount, long groupCount) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/QualityDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/QualityDtos.java new file mode 100644 index 0000000..901e3c1 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/QualityDtos.java @@ -0,0 +1,36 @@ +package com.wordmarket.admin.dto; + +import java.util.List; + +public final class QualityDtos { + + private QualityDtos() { + } + + public record SummaryItem(String key, String label, long value, String unit, String level, + String description) { + } + + public record QualitySummary(List items) { + } + + public record DeclaredDiff(String bookId, String bookName, String bookCode, String examName, + long declared, long actual, long diff) { + } + + public record MissingReference(String type, String identifier, String source, String detail, + String bookId) { + } + + public record Coverage(String key, String name, long hit, long total, double pct) { + } + + public record MissingBook(String bookId, String bookCode, String bookName) { + } + + public record MissingZpk(String sourceKey, long rowCount, String bookIds) { + } + + public record CountPair(long total, long hit) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/dto/SynonymDtos.java b/backend/src/main/java/com/wordmarket/admin/dto/SynonymDtos.java new file mode 100644 index 0000000..2b5ab26 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/dto/SynonymDtos.java @@ -0,0 +1,55 @@ +package com.wordmarket.admin.dto; + +import java.util.List; + +public final class SynonymDtos { + + private SynonymDtos() { + } + + public record WordItem(String wordId, String word, long senseCount, boolean hasRelation) { + } + + public record WordRow(String wordId, String word) { + } + + public record SenseRow(String senseId, String partOfSpeech, String glossZh) { + } + + public record MemberItem(String wordId, String word, Integer position) { + } + + public record GroupItem(String examId, String examName, String canonicalWordId, String canonicalWord, + Integer memberCount, List members, boolean truncated) { + } + + public record AntonymItem(String examId, String examName, List words) { + } + + public record SenseItem(String senseId, String partOfSpeech, String glossZh, List groups, + List antonyms) { + } + + public record WordDetail(String wordId, String word, List senses) { + } + + public record SizeBucket(String label, long count, double pct) { + } + + public record GroupRow(String senseId, String examId, String examName, String canonicalWordId, + String canonicalWord, Integer memberCount) { + } + + public record MemberRow(String senseId, String examId, String wordId, String word, Integer position) { + } + + public record AntonymRow(String senseId, String examId, String examName, String wordId, String word, + Integer position) { + } + + public record ExamRow(String examId, String examName) { + } + + public record BucketRow(String label, long count) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/BookMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/BookMapper.java new file mode 100644 index 0000000..a84988c --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/BookMapper.java @@ -0,0 +1,129 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.BookDtos.BookDetailRow; +import com.wordmarket.admin.dto.BookDtos.BookEntryItem; +import com.wordmarket.admin.dto.BookDtos.BookListItem; +import com.wordmarket.admin.dto.BookDtos.ExamOption; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Param; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface BookMapper { + + @Select(""" + + """) + long countBooks(@Param("examId") Long examId, @Param("keyword") String keyword, + @Param("hasFile") Boolean hasFile); + + @Select(""" + + """) + List listBooks(@Param("examId") Long examId, @Param("keyword") String keyword, + @Param("hasFile") Boolean hasFile, @Param("offset") int offset, + @Param("limit") int limit); + + @Select(""" + SELECT b.book_id AS id, + b.book_code AS code, + b.book_name AS name, + b.description, + b.exam_id AS exam_id, + e.exam_name_zh AS exam_name, + b.declared_entry_count AS declared, + (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) AS actual, + b.content_version, + b.schema_version, + b.cover_url AS cover_path, + b.package_url, + b.has_wordbook_file AS has_file, + b.sort_at, + b.labels + FROM book b + LEFT JOIN exam e ON e.exam_id = b.exam_id + WHERE b.book_id = #{id} + """) + BookDetailRow findBook(@Param("id") long id); + + @Select(""" + + """) + long countBookEntries(@Param("bookId") long bookId, @Param("keyword") String keyword); + + @Select(""" + + """) + List listBookEntries(@Param("bookId") long bookId, + @Param("keyword") String keyword, + @Param("offset") int offset, @Param("limit") int limit); + + @Select(""" + SELECT exam_id AS id, exam_code AS code, exam_name_zh AS name + FROM exam + WHERE is_pseudo = 0 + ORDER BY exam_id + """) + List listExams(); +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/DashboardMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/DashboardMapper.java new file mode 100644 index 0000000..042d4fc --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/DashboardMapper.java @@ -0,0 +1,87 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.DashboardDtos.ExamStat; +import com.wordmarket.admin.dto.DashboardDtos.PosStat; +import com.wordmarket.admin.dto.DashboardDtos.TopBook; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface DashboardMapper { + + @Select("SELECT COUNT(*) FROM book") + long countBooks(); + + @Select("SELECT COUNT(*) FROM book WHERE has_wordbook_file = 0") + long countBooksWithoutFile(); + + @Select("SELECT COUNT(*) FROM word_entry") + long countEntries(); + + @Select("SELECT COUNT(DISTINCT index_word) FROM word_entry") + long countIndexWords(); + + @Select("SELECT COUNT(*) FROM book_entry") + long countBookEntries(); + + @Select("SELECT COUNT(*) FROM example_sentence") + long countExampleSentences(); + + @Select("SELECT COUNT(*) FROM example_usage") + long countExampleUsages(); + + @Select("SELECT COUNT(*) FROM word_family") + long countFamilies(); + + @Select("SELECT COUNT(DISTINCT top_family_id) FROM word_family") + long countTopFamilies(); + + @Select("SELECT COUNT(*) FROM synonym_word") + long countSynonymWords(); + + @Select("SELECT COUNT(*) FROM synonym_sense") + long countSynonymSenses(); + + @Select(""" + + """) + List examDistribution(); + + @Select(""" + SELECT b.book_id AS id, + b.book_name AS name, + b.book_code AS code, + e.exam_name_zh AS exam, + b.declared_entry_count AS declared, + (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) AS actual, + b.cover_url AS cover_path + FROM book b + LEFT JOIN exam e ON e.exam_id = b.exam_id + ORDER BY actual DESC, b.book_id + LIMIT 10 + """) + List topBooks(); + + @Select(""" + SELECT COALESCE(NULLIF(part_of_speech, ''), '未标注') AS name, + COUNT(*) AS value + FROM word_sense + GROUP BY part_of_speech + ORDER BY value DESC, name + LIMIT 10 + """) + List posDistribution(); +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/EntryMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/EntryMapper.java new file mode 100644 index 0000000..40f53e8 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/EntryMapper.java @@ -0,0 +1,232 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.EntryDtos.ConfusableRow; +import com.wordmarket.admin.dto.EntryDtos.EntryBookRow; +import com.wordmarket.admin.dto.EntryDtos.EntryDetail; +import com.wordmarket.admin.dto.EntryDtos.EntryListItem; +import com.wordmarket.admin.dto.EntryDtos.ExampleGroupRow; +import com.wordmarket.admin.dto.EntryDtos.GroupExamRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseExamRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseOrderRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseRow; +import com.wordmarket.admin.dto.EntryDtos.SenseExamRow; +import com.wordmarket.admin.dto.EntryDtos.SenseRelationRow; +import com.wordmarket.admin.dto.EntryDtos.SenseRow; +import com.wordmarket.admin.dto.EntryDtos.SentenceRow; +import com.wordmarket.admin.dto.EntryDtos.UsageRow; +import com.wordmarket.admin.dto.EntryDtos.VariantRow; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Param; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface EntryMapper { + + @Select(""" + + """) + long countEntries(@Param("keyword") String keyword); + + @Select(""" + + """) + List listEntries(@Param("keyword") String keyword, @Param("offset") int offset, + @Param("limit") int limit); + + @Select(""" + SELECT e.entry_id AS id, + e.headword, + e.index_word, + e.us_pronunciation, + e.uk_pronunciation, + e.definition_text, + e.data_version, + e.book_exam_id AS book_exam_id, + ex.exam_name_zh AS book_exam_name, + e.occurrence_count, + e.has_listening_examples, + e.source_zpk_key + FROM word_entry e + LEFT JOIN exam ex ON ex.exam_id = e.book_exam_id + WHERE e.entry_id = #{id} + """) + EntryDetail findEntry(@Param("id") long id); + + @Select(""" + SELECT sense_id, sense_no, part_of_speech, gloss_zh + FROM word_sense + WHERE entry_id = #{entryId} + ORDER BY sense_no, sense_id + """) + List listSenses(@Param("entryId") long entryId); + + @Select(""" + + """) + List listSenseExams(@Param("ids") List ids); + + @Select(""" + + """) + List listSenseRelations(@Param("ids") List ids); + + @Select("SELECT COUNT(*) FROM phrase WHERE entry_id = #{entryId}") + long countPhrases(@Param("entryId") long entryId); + + @Select(""" + SELECT phrase_id AS id, text_en, text_zh, group_type, meaning_id + FROM phrase + WHERE entry_id = #{entryId} + ORDER BY phrase_id + LIMIT #{limit} OFFSET #{offset} + """) + List listPhrases(@Param("entryId") long entryId, @Param("offset") int offset, + @Param("limit") int limit); + + @Select(""" + + """) + List listPhraseExams(@Param("ids") List ids); + + @Select(""" + SELECT p.exam_id, ex.exam_name_zh AS exam_name, p.group_type, p.position, p.phrase_id + FROM phrase_exam_order p + JOIN exam ex ON ex.exam_id = p.exam_id + WHERE p.entry_id = #{entryId} + ORDER BY p.exam_id, p.group_type, p.position + """) + List listPhraseOrders(@Param("entryId") long entryId); + + @Select("SELECT COUNT(*) FROM example_group WHERE entry_id = #{entryId}") + long countExampleGroups(@Param("entryId") long entryId); + + @Select(""" + SELECT example_group_id AS id, group_kind, part_of_speech, entry_kind_code, head_form, + definition_en, definition_zh + FROM example_group + WHERE entry_id = #{entryId} + ORDER BY group_kind, example_group_id + LIMIT #{limit} OFFSET #{offset} + """) + List listExampleGroups(@Param("entryId") long entryId, + @Param("offset") int offset, @Param("limit") int limit); + + @Select(""" + + """) + List listExampleGroupExams(@Param("ids") List ids); + + @Select(""" + + """) + List listExampleUsages(@Param("ids") List ids); + + @Select(""" + + """) + List listExampleSentences(@Param("ids") List ids); + + @Select(""" + SELECT confusable_id AS id, word_text, gloss_zh, pos_code, spelling_flag, position + FROM confusable_word + WHERE entry_id = #{entryId} + ORDER BY position, confusable_id + """) + List listConfusables(@Param("entryId") long entryId); + + @Select(""" + SELECT position, variant + FROM word_spelling_variant + WHERE entry_id = #{entryId} + ORDER BY position + """) + List listSpellingVariants(@Param("entryId") long entryId); + + @Select("SELECT COUNT(*) FROM book_entry WHERE entry_id = #{entryId}") + long countEntryBooks(@Param("entryId") long entryId); + + @Select(""" + SELECT be.book_id AS book_id, b.book_name, b.book_code, be.display_word, be.seq_book + FROM book_entry be + JOIN book b ON b.book_id = be.book_id + WHERE be.entry_id = #{entryId} + ORDER BY b.book_id + LIMIT #{limit} OFFSET #{offset} + """) + List listEntryBooks(@Param("entryId") long entryId, @Param("offset") int offset, + @Param("limit") int limit); +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/MorphologyMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/MorphologyMapper.java new file mode 100644 index 0000000..7291f66 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/MorphologyMapper.java @@ -0,0 +1,326 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.MorphologyDtos.CardBrief; +import com.wordmarket.admin.dto.MorphologyDtos.CardRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyExamRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyLinkRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyWordRow; +import com.wordmarket.admin.dto.MorphologyDtos.LinkExamRow; +import com.wordmarket.admin.dto.MorphologyDtos.MemberRow; +import com.wordmarket.admin.dto.MorphologyDtos.MiniGroupRow; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeItem; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeRefRow; +import com.wordmarket.admin.dto.MorphologyDtos.TreeNode; +import com.wordmarket.admin.dto.MorphologyDtos.TreeCounts; +import com.wordmarket.admin.dto.MorphologyDtos.VariantRow; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Param; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface MorphologyMapper { + + @Select(""" + + """) + long countMorphemes(@Param("type") String type, @Param("keyword") String keyword); + + @Select(""" + + """) + List listMorphemes(@Param("type") String type, @Param("keyword") String keyword, + @Param("offset") int offset, @Param("limit") int limit); + + @Select(""" + SELECT morpheme_id AS id, morpheme_type AS type, form, display_text, meaning_en, meaning_zh, + note + FROM morpheme + WHERE morpheme_id = #{id} + """) + MorphemeItem findMorpheme(@Param("id") long id); + + @Select(""" + SELECT COUNT(*) FROM card + WHERE prefix_morpheme_id = #{id} OR root_morpheme_id = #{id} OR suffix_morpheme_id = #{id} + """) + long countCardsByMorpheme(@Param("id") long id); + + @Select(""" + SELECT card_id AS id, word, memory_note, example_text + FROM card + WHERE prefix_morpheme_id = #{id} OR root_morpheme_id = #{id} OR suffix_morpheme_id = #{id} + ORDER BY card_id + LIMIT 100 + """) + List listCardsByMorpheme(@Param("id") long id); + + @Select(""" + + """) + long countCards(@Param("keyword") String keyword); + + @Select(""" + + """) + List listCards(@Param("keyword") String keyword, + @Param("offset") int offset, + @Param("limit") int limit); + + @Select(""" + SELECT card_id AS id, word, highlighted_word, memory_note, example_text, is_hidden AS hidden, + prefix_morpheme_id, root_morpheme_id, suffix_morpheme_id, default_family_ref + FROM card + WHERE card_id = #{id} + """) + CardRow findCard(@Param("id") long id); + + @Select(""" + + """) + List listCardExams(@Param("ids") List ids); + + @Select(""" + + """) + List listMorphemeRefs(@Param("ids") List ids); + + @Select(""" + SELECT link_id AS id, group_no, family_ref, is_hidden AS hidden + FROM card_family_link + WHERE card_id = #{cardId} + ORDER BY group_no, link_id + """) + List listCardFamilyLinks(@Param("cardId") long cardId); + + @Select(""" + + """) + long countFamilies(@Param("keyword") String keyword); + + @Select(""" + + """) + List listFamilies(@Param("keyword") String keyword, @Param("offset") int offset, + @Param("limit") int limit); + + @Select(""" + SELECT f.family_entry_id AS id, f.word, f.top_family_id AS top_family_id, + t.word AS top_word, f.interpretation, + f.group_level_1, f.group_level_2, f.group_level_3 + FROM word_family f + LEFT JOIN word_family t ON t.family_entry_id = f.top_family_id + WHERE f.family_entry_id = #{id} + """) + FamilyRow findFamily(@Param("id") long id); + + @Select(""" + + """) + List listFamilyExams(@Param("ids") List ids); + + @Select(""" + SELECT v.variant_id AS id, v.variant_word, v.interpretation, + (SELECT COUNT(*) FROM word_family_variant_member m + WHERE m.variant_id = v.variant_id) AS member_count + FROM word_family_variant v + WHERE v.top_family_id = #{topId} + ORDER BY v.variant_id + """) + List listVariants(@Param("topId") long topId); + + @Select(""" + SELECT mg.mini_group_id AS id, mg.size + FROM word_family_mini_group mg + WHERE EXISTS ( + SELECT 1 + FROM word_family_mini_group_member m + JOIN word_family f ON f.family_entry_id = m.family_entry_id + WHERE m.mini_group_id = mg.mini_group_id AND f.top_family_id = #{topId} + ) + ORDER BY mg.mini_group_id + LIMIT 200 + """) + List listMiniGroups(@Param("topId") long topId); + + @Select(""" + SELECT m.family_entry_id, f.word, m.position + FROM word_family_mini_group_member m + JOIN word_family f ON f.family_entry_id = m.family_entry_id + WHERE m.mini_group_id = #{miniGroupId} + ORDER BY m.position + LIMIT 50 + """) + List listMiniGroupMembers(@Param("miniGroupId") long miniGroupId); + + @Select(""" + SELECT (SELECT COUNT(*) FROM word_family_variant v WHERE v.top_family_id = #{topId}) + AS variant_count, + (SELECT COUNT(*) FROM word_family_mini_group mg WHERE EXISTS ( + SELECT 1 + FROM word_family_mini_group_member m + JOIN word_family f ON f.family_entry_id = m.family_entry_id + WHERE m.mini_group_id = mg.mini_group_id AND f.top_family_id = #{topId})) + AS group_count + """) + TreeCounts countTopChildren(@Param("topId") long topId); + + @Select(""" + SELECT * FROM ( + SELECT 'variant' AS node_type, + CAST(v.variant_id AS CHAR) AS id, + v.variant_word AS label, + v.interpretation AS subtitle, + (SELECT COUNT(*) FROM word_family_variant_member m + WHERE m.variant_id = v.variant_id) AS member_count, + 0 AS leaf + FROM word_family_variant v + WHERE v.top_family_id = #{topId} + UNION ALL + SELECT 'miniGroup' AS node_type, + CAST(mg.mini_group_id AS CHAR) AS id, + CONCAT('小组 #', mg.mini_group_id) AS label, + CONCAT('成员 ', mg.size) AS subtitle, + mg.size AS member_count, + 0 AS leaf + FROM word_family_mini_group mg + WHERE EXISTS ( + SELECT 1 + FROM word_family_mini_group_member m + JOIN word_family f ON f.family_entry_id = m.family_entry_id + WHERE m.mini_group_id = mg.mini_group_id AND f.top_family_id = #{topId} + ) + ) t + ORDER BY node_type, id + LIMIT #{limit} OFFSET #{offset} + """) + List listTopChildren(@Param("topId") long topId, @Param("offset") int offset, + @Param("limit") int limit); + + @Select("SELECT COUNT(*) FROM word_family_variant_member WHERE variant_id = #{variantId}") + long countVariantMembers(@Param("variantId") long variantId); + + @Select(""" + SELECT 'member' AS node_type, + CONCAT('word:', vm.member_word, ':', vm.exam_id, ':', vm.position) AS id, + vm.member_word AS label, + CONCAT(COALESCE(ex.exam_name_zh, CONCAT('考试 ', vm.exam_id)), ' · 第 ', + vm.position, ' 位') AS subtitle, + 0 AS member_count, + 1 AS leaf + FROM word_family_variant_member vm + LEFT JOIN exam ex ON ex.exam_id = vm.exam_id + WHERE vm.variant_id = #{variantId} + ORDER BY vm.exam_id, vm.position + LIMIT #{limit} OFFSET #{offset} + """) + List listVariantMemberNodes(@Param("variantId") long variantId, + @Param("offset") int offset, @Param("limit") int limit); + + @Select("SELECT COUNT(*) FROM word_family_mini_group_member WHERE mini_group_id = #{miniGroupId}") + long countMiniGroupMembers(@Param("miniGroupId") long miniGroupId); + + @Select(""" + SELECT 'member' AS node_type, + CONCAT('family:', m.family_entry_id) AS id, + f.word AS label, + CONCAT('词族内位置 ', m.position) AS subtitle, + 0 AS member_count, + 1 AS leaf + FROM word_family_mini_group_member m + JOIN word_family f ON f.family_entry_id = m.family_entry_id + WHERE m.mini_group_id = #{miniGroupId} + ORDER BY m.position + LIMIT #{limit} OFFSET #{offset} + """) + List listMiniGroupMemberNodes(@Param("miniGroupId") long miniGroupId, + @Param("offset") int offset, @Param("limit") int limit); + + @Select(""" + + """) + List listFamilyWords(@Param("ids") List ids); +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/QualityMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/QualityMapper.java new file mode 100644 index 0000000..fdc2d8c --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/QualityMapper.java @@ -0,0 +1,112 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.QualityDtos.DeclaredDiff; +import com.wordmarket.admin.dto.QualityDtos.MissingBook; +import com.wordmarket.admin.dto.QualityDtos.MissingZpk; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Param; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface QualityMapper { + + @Select(""" + SELECT COUNT(*) + FROM book b + WHERE b.declared_entry_count IS NOT NULL + AND b.declared_entry_count <> (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) + """) + long countDeclaredMismatch(); + + @Select(""" + SELECT b.book_id AS book_id, + b.book_name, + b.book_code, + e.exam_name_zh AS exam_name, + b.declared_entry_count AS declared, + (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) AS actual, + (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) + - b.declared_entry_count AS diff + FROM book b + LEFT JOIN exam e ON e.exam_id = b.exam_id + WHERE b.declared_entry_count IS NOT NULL + AND b.declared_entry_count <> (SELECT COUNT(*) FROM book_entry be WHERE be.book_id = b.book_id) + ORDER BY ABS(diff) DESC, b.book_id + """) + List listDeclaredMismatch(); + + @Select("SELECT COUNT(*) FROM book WHERE has_wordbook_file = 0") + long countMissingFiles(); + + @Select("SELECT book_id AS book_id, book_code, book_name FROM book WHERE has_wordbook_file = 0") + List listMissingFileBooks(); + + @Select(""" + + """) + List listKnownMissingZpk(@Param("keys") List keys); + + @Select(""" + SELECT COUNT(*) + FROM word_entry e + WHERE NOT EXISTS (SELECT 1 FROM word_sense s WHERE s.entry_id = e.entry_id) + """) + long countEntriesWithoutSense(); + + @Select(""" + SELECT COUNT(*) + FROM synonym_word w + WHERE NOT EXISTS (SELECT 1 FROM synonym_sense s WHERE s.word_id = w.word_id) + """) + long countSynonymWordsWithoutSense(); + + @Select("SELECT COUNT(*) FROM book WHERE exam_id IS NULL") + long countBooksWithoutExam(); + + @Select("SELECT COUNT(*) FROM book WHERE cover_url IS NULL OR cover_url = ''") + long countBooksWithoutCover(); + + @Select("SELECT book_id AS book_id, book_code, book_name FROM book WHERE cover_url IS NULL OR cover_url = ''") + List listBooksWithoutCover(); + + @Select("SELECT COUNT(DISTINCT LOWER(TRIM(word))) FROM card") + long cardTotal(); + + @Select(""" + SELECT COUNT(DISTINCT LOWER(TRIM(c.word))) + FROM card c + WHERE EXISTS (SELECT 1 FROM word_entry e WHERE e.index_word = LOWER(TRIM(c.word))) + """) + long cardHit(); + + @Select("SELECT COUNT(DISTINCT LOWER(TRIM(word))) FROM word_family") + long familyTotal(); + + @Select(""" + SELECT COUNT(DISTINCT LOWER(TRIM(f.word))) + FROM word_family f + WHERE EXISTS (SELECT 1 FROM word_entry e WHERE e.index_word = LOWER(TRIM(f.word))) + """) + long familyHit(); + + @Select("SELECT COUNT(DISTINCT LOWER(TRIM(word))) FROM synonym_word") + long synonymTotal(); + + @Select(""" + SELECT COUNT(DISTINCT LOWER(TRIM(s.word))) + FROM synonym_word s + WHERE EXISTS (SELECT 1 FROM word_entry e WHERE e.index_word = LOWER(TRIM(s.word))) + """) + long synonymHit(); +} diff --git a/backend/src/main/java/com/wordmarket/admin/mapper/SynonymMapper.java b/backend/src/main/java/com/wordmarket/admin/mapper/SynonymMapper.java new file mode 100644 index 0000000..a54b247 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/mapper/SynonymMapper.java @@ -0,0 +1,119 @@ +package com.wordmarket.admin.mapper; + +import com.wordmarket.admin.dto.SynonymDtos.AntonymRow; +import com.wordmarket.admin.dto.SynonymDtos.BucketRow; +import com.wordmarket.admin.dto.SynonymDtos.GroupRow; +import com.wordmarket.admin.dto.SynonymDtos.MemberRow; +import com.wordmarket.admin.dto.SynonymDtos.WordItem; +import com.wordmarket.admin.dto.SynonymDtos.WordRow; +import org.apache.ibatis.annotations.Mapper; +import org.apache.ibatis.annotations.Param; +import org.apache.ibatis.annotations.Select; + +import java.util.List; + +@Mapper +public interface SynonymMapper { + + @Select(""" + + """) + long countWords(@Param("keyword") String keyword); + + @Select(""" + + """) + List listWords(@Param("keyword") String keyword, @Param("offset") int offset, + @Param("limit") int limit); + + @Select("SELECT word_id AS word_id, word FROM synonym_word WHERE word_id = #{id}") + WordRow findWord(@Param("id") long id); + + @Select(""" + SELECT sense_id, part_of_speech, gloss_zh + FROM synonym_sense + WHERE word_id = #{wordId} + ORDER BY sense_id + """) + List listSenses(@Param("wordId") long wordId); + + @Select(""" + + """) + List listGroups(@Param("ids") List ids); + + @Select(""" + + """) + List listMembers(@Param("ids") List ids); + + @Select(""" + + """) + List listAntonyms(@Param("ids") List ids); + + @Select(""" + SELECT CASE + WHEN member_count <= 1 THEN '1' + WHEN member_count = 2 THEN '2' + WHEN member_count = 3 THEN '3' + WHEN member_count = 4 THEN '4' + WHEN member_count <= 6 THEN '5-6' + WHEN member_count <= 10 THEN '7-10' + ELSE '11+' + END AS label, + COUNT(*) AS count + FROM synonym_group + GROUP BY label + ORDER BY MIN(member_count) + """) + List groupSizeDistribution(); +} diff --git a/backend/src/main/java/com/wordmarket/admin/security/JwtAuthFilter.java b/backend/src/main/java/com/wordmarket/admin/security/JwtAuthFilter.java new file mode 100644 index 0000000..fd2b153 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/security/JwtAuthFilter.java @@ -0,0 +1,63 @@ +package com.wordmarket.admin.security; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.wordmarket.admin.common.ApiResponse; +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.authority.SimpleGrantedAuthority; +import org.springframework.security.core.context.SecurityContextHolder; +import org.springframework.stereotype.Component; +import org.springframework.web.filter.OncePerRequestFilter; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.util.List; + +@Component +public class JwtAuthFilter extends OncePerRequestFilter { + + private final JwtService jwtService; + private final ObjectMapper objectMapper; + + public JwtAuthFilter(JwtService jwtService, ObjectMapper objectMapper) { + this.jwtService = jwtService; + this.objectMapper = objectMapper; + } + + @Override + protected boolean shouldNotFilter(HttpServletRequest request) { + if ("OPTIONS".equalsIgnoreCase(request.getMethod())) { + return true; + } + return "/api/auth/login".equals(request.getRequestURI()); + } + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, + FilterChain filterChain) throws ServletException, IOException { + String header = request.getHeader(HttpHeaders.AUTHORIZATION); + if (header == null || !header.startsWith("Bearer ")) { + filterChain.doFilter(request, response); + return; + } + try { + String username = jwtService.parseSubject(header.substring(7)); + var authentication = new UsernamePasswordAuthenticationToken( + username, null, List.of(new SimpleGrantedAuthority("ROLE_ADMIN"))); + SecurityContextHolder.getContext().setAuthentication(authentication); + filterChain.doFilter(request, response); + } catch (RuntimeException ex) { + SecurityContextHolder.clearContext(); + response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); + response.setCharacterEncoding(StandardCharsets.UTF_8.name()); + response.setContentType(MediaType.APPLICATION_JSON_VALUE); + objectMapper.writeValue(response.getWriter(), + ApiResponse.error(401, "登录状态无效或已过期")); + } + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/security/JwtService.java b/backend/src/main/java/com/wordmarket/admin/security/JwtService.java new file mode 100644 index 0000000..f157244 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/security/JwtService.java @@ -0,0 +1,55 @@ +package com.wordmarket.admin.security; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.config.AdminProperties; +import io.jsonwebtoken.Claims; +import io.jsonwebtoken.JwtException; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import org.springframework.stereotype.Component; + +import javax.crypto.SecretKey; +import java.nio.charset.StandardCharsets; +import java.time.Instant; +import java.time.temporal.ChronoUnit; +import java.util.Date; + +@Component +public class JwtService { + + private final SecretKey key; + private final int ttlHours; + + public JwtService(AdminProperties properties) { + this.key = Keys.hmacShaKeyFor(properties.getJwtSecret().getBytes(StandardCharsets.UTF_8)); + this.ttlHours = properties.getTokenTtlHours(); + } + + public IssuedToken issue(String username) { + Instant now = Instant.now(); + Instant expiresAt = now.plus(ttlHours, ChronoUnit.HOURS); + String token = Jwts.builder() + .subject(username) + .issuedAt(Date.from(now)) + .expiration(Date.from(expiresAt)) + .signWith(key) + .compact(); + return new IssuedToken(token, expiresAt); + } + + public String parseSubject(String token) { + try { + Claims claims = Jwts.parser() + .verifyWith(key) + .build() + .parseSignedClaims(token) + .getPayload(); + return claims.getSubject(); + } catch (JwtException | IllegalArgumentException ex) { + throw BizException.unauthorized("登录状态无效或已过期"); + } + } + + public record IssuedToken(String token, Instant expiresAt) { + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/security/RestAuthEntryPoint.java b/backend/src/main/java/com/wordmarket/admin/security/RestAuthEntryPoint.java new file mode 100644 index 0000000..f1e59dc --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/security/RestAuthEntryPoint.java @@ -0,0 +1,32 @@ +package com.wordmarket.admin.security; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.wordmarket.admin.common.ApiResponse; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import org.springframework.http.MediaType; +import org.springframework.security.core.AuthenticationException; +import org.springframework.security.web.AuthenticationEntryPoint; +import org.springframework.stereotype.Component; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; + +@Component +public class RestAuthEntryPoint implements AuthenticationEntryPoint { + + private final ObjectMapper objectMapper; + + public RestAuthEntryPoint(ObjectMapper objectMapper) { + this.objectMapper = objectMapper; + } + + @Override + public void commence(HttpServletRequest request, HttpServletResponse response, + AuthenticationException authException) throws IOException { + response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); + response.setCharacterEncoding(StandardCharsets.UTF_8.name()); + response.setContentType(MediaType.APPLICATION_JSON_VALUE); + objectMapper.writeValue(response.getWriter(), ApiResponse.error(401, "未认证或登录已过期")); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/AggregateCache.java b/backend/src/main/java/com/wordmarket/admin/service/AggregateCache.java new file mode 100644 index 0000000..de05e77 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/AggregateCache.java @@ -0,0 +1,33 @@ +package com.wordmarket.admin.service; + +import com.github.benmanes.caffeine.cache.Cache; +import org.springframework.stereotype.Component; + +import java.util.function.Supplier; + +@Component +public class AggregateCache { + + private final Cache cache; + + public AggregateCache(Cache aggregateCache) { + this.cache = aggregateCache; + } + + @SuppressWarnings("unchecked") + public T get(String key, boolean refresh, Supplier loader) { + if (!refresh) { + Object cached = cache.getIfPresent(key); + if (cached != null) { + return (T) cached; + } + } + T value = loader.get(); + cache.put(key, value); + return value; + } + + public void clear() { + cache.invalidateAll(); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/AuthService.java b/backend/src/main/java/com/wordmarket/admin/service/AuthService.java new file mode 100644 index 0000000..ff1a96c --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/AuthService.java @@ -0,0 +1,35 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.config.AdminProperties; +import com.wordmarket.admin.dto.AuthDtos.LoginRequest; +import com.wordmarket.admin.dto.AuthDtos.LoginResponse; +import com.wordmarket.admin.security.JwtService; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.stereotype.Service; + +@Service +public class AuthService { + + private final AdminProperties adminProperties; + private final PasswordEncoder passwordEncoder; + private final JwtService jwtService; + + public AuthService(AdminProperties adminProperties, PasswordEncoder passwordEncoder, + JwtService jwtService) { + this.adminProperties = adminProperties; + this.passwordEncoder = passwordEncoder; + this.jwtService = jwtService; + } + + public LoginResponse login(LoginRequest request) { + boolean usernameMatches = adminProperties.getUsername().equals(request.username()); + boolean passwordMatches = passwordEncoder.matches(request.password(), + adminProperties.getPasswordHash()); + if (!usernameMatches || !passwordMatches) { + throw BizException.unauthorized("用户名或密码错误"); + } + JwtService.IssuedToken issued = jwtService.issue(request.username()); + return new LoginResponse(issued.token(), issued.expiresAt().toString(), request.username()); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/BookService.java b/backend/src/main/java/com/wordmarket/admin/service/BookService.java new file mode 100644 index 0000000..2a61965 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/BookService.java @@ -0,0 +1,63 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.common.Pages; +import com.wordmarket.admin.dto.BookDtos.BookDetail; +import com.wordmarket.admin.dto.BookDtos.BookDetailRow; +import com.wordmarket.admin.dto.BookDtos.BookEntryItem; +import com.wordmarket.admin.dto.BookDtos.BookListItem; +import com.wordmarket.admin.dto.BookDtos.ExamOption; +import com.wordmarket.admin.mapper.BookMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@Transactional(readOnly = true) +public class BookService { + + private final BookMapper bookMapper; + + public BookService(BookMapper bookMapper) { + this.bookMapper = bookMapper; + } + + public PageResult list(Integer pageParam, Integer sizeParam, Long examId, + String keyword, Boolean hasFile) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = bookMapper.countBooks(examId, keyword, hasFile); + List items = bookMapper.listBooks(examId, keyword, hasFile, + Pages.offset(page, size), size); + return PageResult.of(items, total, page, size); + } + + public BookDetail detail(long id) { + BookDetailRow detail = bookMapper.findBook(id); + if (detail == null) { + throw BizException.notFound("词书不存在"); + } + boolean mismatch = detail.declared() != null && detail.declared() != detail.actual(); + return new BookDetail(detail.id(), detail.code(), detail.name(), detail.description(), + detail.examId(), detail.examName(), detail.declared(), detail.actual(), + detail.contentVersion(), detail.schemaVersion(), detail.coverPath(), + detail.packageUrl(), detail.hasFile(), detail.sortAt(), detail.labels(), mismatch); + } + + public PageResult entries(long bookId, Integer pageParam, Integer sizeParam, + String keyword) { + detail(bookId); + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = bookMapper.countBookEntries(bookId, keyword); + List items = bookMapper.listBookEntries(bookId, keyword, + Pages.offset(page, size), size); + return PageResult.of(items, total, page, size); + } + + public List exams() { + return bookMapper.listExams(); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/DashboardService.java b/backend/src/main/java/com/wordmarket/admin/service/DashboardService.java new file mode 100644 index 0000000..64c4ce4 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/DashboardService.java @@ -0,0 +1,82 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.dto.DashboardDtos.CoverageItem; +import com.wordmarket.admin.dto.DashboardDtos.ExamStat; +import com.wordmarket.admin.dto.DashboardDtos.Kpi; +import com.wordmarket.admin.dto.DashboardDtos.PosStat; +import com.wordmarket.admin.dto.DashboardDtos.QualityItem; +import com.wordmarket.admin.dto.DashboardDtos.Summary; +import com.wordmarket.admin.dto.DashboardDtos.TopBook; +import com.wordmarket.admin.mapper.DashboardMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@Transactional(readOnly = true) +public class DashboardService { + + private final DashboardMapper dashboardMapper; + private final QualityService qualityService; + private final AggregateCache cache; + + public DashboardService(DashboardMapper dashboardMapper, QualityService qualityService, + AggregateCache cache) { + this.dashboardMapper = dashboardMapper; + this.qualityService = qualityService; + this.cache = cache; + } + + public Summary summary(boolean refresh) { + return cache.get("dashboard:summary", refresh, this::loadSummary); + } + + private Summary loadSummary() { + long books = dashboardMapper.countBooks(); + long entries = dashboardMapper.countEntries(); + long links = dashboardMapper.countBookEntries(); + long sentences = dashboardMapper.countExampleSentences(); + long families = dashboardMapper.countFamilies(); + long synonymWords = dashboardMapper.countSynonymWords(); + + long averagePerBook = books == 0 ? 0 : Math.round(links * 1.0 / books); + + List kpis = List.of( + new Kpi("books", "词书", books, + dashboardMapper.countBooksWithoutFile() + " 本无清单文件", "blue"), + new Kpi("entries", "词条", entries, + String.format("%,d 个索引词", dashboardMapper.countIndexWords()), "green"), + new Kpi("links", "词书词条关联", links, + String.format("平均每本 %,d 条", averagePerBook), "violet"), + new Kpi("sentences", "例句", sentences, + String.format("含使用模式 %,d", dashboardMapper.countExampleUsages()), "amber"), + new Kpi("families", "词族", families, + String.format("顶层族 %,d", dashboardMapper.countTopFamilies()), "cyan"), + new Kpi("synonyms", "近义词头", synonymWords, + String.format("义项 %,d", dashboardMapper.countSynonymSenses()), "rose")); + + List quality = qualityService.loadSummaryItems().stream() + .map(item -> new QualityItem(item.key(), item.label(), item.value(), item.unit(), + item.level(), QualityService.targetOf(item.key()))) + .toList(); + + List coverage = qualityService.loadCoverage().stream() + .map(item -> new CoverageItem(item.name(), item.hit(), item.total(), item.pct())) + .toList(); + + return new Summary(kpis, quality, coverage); + } + + public List examDistribution(boolean refresh) { + return cache.get("dashboard:exam", refresh, dashboardMapper::examDistribution); + } + + public List topBooks(boolean refresh) { + return cache.get("dashboard:top", refresh, dashboardMapper::topBooks); + } + + public List posDistribution(boolean refresh) { + return cache.get("dashboard:pos", refresh, dashboardMapper::posDistribution); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/EntryService.java b/backend/src/main/java/com/wordmarket/admin/service/EntryService.java new file mode 100644 index 0000000..1bb4249 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/EntryService.java @@ -0,0 +1,251 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.common.Pages; +import com.wordmarket.admin.dto.EntryDtos.ConfusableItem; +import com.wordmarket.admin.dto.EntryDtos.EntryBookItem; +import com.wordmarket.admin.dto.EntryDtos.EntryBookRow; +import com.wordmarket.admin.dto.EntryDtos.EntryDetail; +import com.wordmarket.admin.dto.EntryDtos.EntryListItem; +import com.wordmarket.admin.dto.EntryDtos.ExamRef; +import com.wordmarket.admin.dto.EntryDtos.ExampleGroupItem; +import com.wordmarket.admin.dto.EntryDtos.ExampleGroupRow; +import com.wordmarket.admin.dto.EntryDtos.ExampleSentenceItem; +import com.wordmarket.admin.dto.EntryDtos.ExampleUsageItem; +import com.wordmarket.admin.dto.EntryDtos.GroupExamRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseExamRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseItem; +import com.wordmarket.admin.dto.EntryDtos.PhraseOrder; +import com.wordmarket.admin.dto.EntryDtos.PhraseOrderRow; +import com.wordmarket.admin.dto.EntryDtos.PhraseRow; +import com.wordmarket.admin.dto.EntryDtos.SenseExamRow; +import com.wordmarket.admin.dto.EntryDtos.SenseItem; +import com.wordmarket.admin.dto.EntryDtos.SenseRelation; +import com.wordmarket.admin.dto.EntryDtos.SenseRelationRow; +import com.wordmarket.admin.dto.EntryDtos.SenseRow; +import com.wordmarket.admin.dto.EntryDtos.SentenceRow; +import com.wordmarket.admin.dto.EntryDtos.SpellingVariantItem; +import com.wordmarket.admin.dto.EntryDtos.UsageRow; +import com.wordmarket.admin.mapper.EntryMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +@Service +@Transactional(readOnly = true) +public class EntryService { + + private static final int DEFINITION_PREVIEW = 120; + + private final EntryMapper entryMapper; + + public EntryService(EntryMapper entryMapper) { + this.entryMapper = entryMapper; + } + + public PageResult list(Integer pageParam, Integer sizeParam, String keyword) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = entryMapper.countEntries(keyword); + List items = entryMapper.listEntries(keyword, Pages.offset(page, size), size) + .stream() + .map(item -> new EntryListItem(item.id(), item.headword(), item.indexWord(), + item.pronunciation(), preview(item.definition()), item.senseCount(), + item.bookCount())) + .toList(); + return PageResult.of(items, total, page, size); + } + + public EntryDetail detail(long id) { + EntryDetail detail = entryMapper.findEntry(id); + if (detail == null) { + throw BizException.notFound("词条不存在"); + } + return detail; + } + + public List senses(long entryId) { + detail(entryId); + List rows = entryMapper.listSenses(entryId); + if (rows.isEmpty()) { + return List.of(); + } + List ids = rows.stream().map(row -> Long.parseLong(row.senseId())).toList(); + Map> exams = groupExams(entryMapper.listSenseExams(ids)); + Map> relations = groupRelations(entryMapper.listSenseRelations(ids)); + List items = new ArrayList<>(rows.size()); + for (SenseRow row : rows) { + long senseId = Long.parseLong(row.senseId()); + items.add(new SenseItem(row.senseId(), row.senseNo(), row.partOfSpeech(), row.glossZh(), + exams.getOrDefault(senseId, List.of()), + relations.getOrDefault(senseId, List.of()))); + } + return items; + } + + public PageResult phrases(long entryId, Integer pageParam, Integer sizeParam) { + detail(entryId); + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = entryMapper.countPhrases(entryId); + List rows = entryMapper.listPhrases(entryId, Pages.offset(page, size), size); + if (rows.isEmpty()) { + return PageResult.of(List.of(), total, page, size); + } + List ids = rows.stream().map(row -> Long.parseLong(row.id())).toList(); + Map> exams = groupPhraseExams(entryMapper.listPhraseExams(ids)); + Map> orders = new HashMap<>(); + for (PhraseOrderRow order : entryMapper.listPhraseOrders(entryId)) { + orders.computeIfAbsent(Long.parseLong(order.phraseId()), key -> new ArrayList<>()) + .add(new PhraseOrder(order.examId(), order.examName(), order.groupType(), + order.position())); + } + List items = rows.stream() + .map(row -> { + long phraseId = Long.parseLong(row.id()); + return new PhraseItem(row.id(), row.textEn(), row.textZh(), row.groupType(), + row.meaningId(), exams.getOrDefault(phraseId, List.of()), + orders.getOrDefault(phraseId, List.of())); + }) + .toList(); + return PageResult.of(items, total, page, size); + } + + public PageResult examples(long entryId, Integer pageParam, Integer sizeParam) { + detail(entryId); + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = entryMapper.countExampleGroups(entryId); + List rows = entryMapper.listExampleGroups(entryId, + Pages.offset(page, size), size); + if (rows.isEmpty()) { + return PageResult.of(List.of(), total, page, size); + } + List ids = rows.stream().map(row -> Long.parseLong(row.id())).toList(); + Map> exams = groupExampleExams(entryMapper.listExampleGroupExams(ids)); + Map> usages = new HashMap<>(); + for (UsageRow usage : entryMapper.listExampleUsages(ids)) { + usages.computeIfAbsent(Long.parseLong(usage.groupId()), key -> new ArrayList<>()) + .add(usage); + } + Map> sentencesByGroup = new HashMap<>(); + Map> sentencesByUsage = new HashMap<>(); + for (SentenceRow sentence : entryMapper.listExampleSentences(ids)) { + sentencesByGroup.computeIfAbsent(Long.parseLong(sentence.groupId()), + key -> new ArrayList<>()).add(sentence); + if (sentence.usageId() != null) { + sentencesByUsage.computeIfAbsent(Long.parseLong(sentence.usageId()), + key -> new ArrayList<>()).add(sentence); + } + } + List items = new ArrayList<>(rows.size()); + for (ExampleGroupRow row : rows) { + long groupId = Long.parseLong(row.id()); + List usageItems = usages.getOrDefault(groupId, List.of()).stream() + .map(usage -> new ExampleUsageItem(usage.id(), usage.patternId(), + usage.patternText(), usage.position(), toSentenceItems( + sentencesByUsage.getOrDefault(Long.parseLong(usage.id()), List.of())))) + .toList(); + List groupSentences = sentencesByGroup.getOrDefault(groupId, List.of()); + List direct = groupSentences.stream() + .filter(sentence -> sentence.usageId() == null) + .map(EntryService::toSentenceItem) + .toList(); + items.add(new ExampleGroupItem(row.id(), row.groupKind(), row.partOfSpeech(), + row.entryKindCode(), row.headForm(), row.definitionEn(), row.definitionZh(), + exams.getOrDefault(groupId, List.of()), usageItems, direct, groupSentences.size())); + } + return PageResult.of(items, total, page, size); + } + + public List confusables(long entryId) { + detail(entryId); + return entryMapper.listConfusables(entryId).stream() + .map(row -> new ConfusableItem(row.id(), row.wordText(), row.glossZh(), row.posCode(), + row.spellingFlag(), row.position())) + .toList(); + } + + public List spellingVariants(long entryId) { + detail(entryId); + return entryMapper.listSpellingVariants(entryId).stream() + .map(row -> new SpellingVariantItem(row.position(), row.variant())) + .toList(); + } + + public PageResult books(long entryId, Integer pageParam, Integer sizeParam) { + detail(entryId); + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = entryMapper.countEntryBooks(entryId); + List items = entryMapper.listEntryBooks(entryId, Pages.offset(page, size), size) + .stream() + .map(row -> new EntryBookItem(row.bookId(), row.bookName(), row.bookCode(), + row.displayWord(), row.seqBook())) + .toList(); + return PageResult.of(items, total, page, size); + } + + private static Map> groupExams(List rows) { + Map> map = new HashMap<>(); + for (SenseExamRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.senseId()), key -> new ArrayList<>()) + .add(new ExamRef(row.id(), row.code(), row.name())); + } + return map; + } + + private static Map> groupRelations(List rows) { + Map> map = new HashMap<>(); + for (SenseRelationRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.senseId()), key -> new ArrayList<>()) + .add(new SenseRelation(row.type(), row.position(), row.targetMeaningId(), + row.targetEntryId())); + } + return map; + } + + private static Map> groupPhraseExams(List rows) { + Map> map = new LinkedHashMap<>(); + for (PhraseExamRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.phraseId()), key -> new ArrayList<>()) + .add(new ExamRef(row.id(), row.code(), row.name())); + } + return map; + } + + private static Map> groupExampleExams(List rows) { + Map> map = new HashMap<>(); + for (GroupExamRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.groupId()), key -> new ArrayList<>()) + .add(new ExamRef(row.id(), row.code(), row.name())); + } + return map; + } + + private static List toSentenceItems(List rows) { + return rows.stream().map(EntryService::toSentenceItem).toList(); + } + + private static ExampleSentenceItem toSentenceItem(SentenceRow row) { + return new ExampleSentenceItem(row.id(), row.textEn(), row.textZh(), row.sourceTitle(), + row.audioUrl(), row.listening()); + } + + private static String preview(String text) { + if (text == null) { + return null; + } + String trimmed = text.trim(); + if (trimmed.length() <= DEFINITION_PREVIEW) { + return trimmed; + } + return trimmed.substring(0, DEFINITION_PREVIEW) + "…"; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/MorphologyService.java b/backend/src/main/java/com/wordmarket/admin/service/MorphologyService.java new file mode 100644 index 0000000..b5353e2 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/MorphologyService.java @@ -0,0 +1,227 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.common.Pages; +import com.wordmarket.admin.dto.MorphologyDtos.CardBrief; +import com.wordmarket.admin.dto.MorphologyDtos.CardDetail; +import com.wordmarket.admin.dto.MorphologyDtos.CardFamilyLink; +import com.wordmarket.admin.dto.MorphologyDtos.CardItem; +import com.wordmarket.admin.dto.MorphologyDtos.CardItemRow; +import com.wordmarket.admin.dto.MorphologyDtos.CardRow; +import com.wordmarket.admin.dto.MorphologyDtos.ExamRef; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyDetail; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyExamRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyItem; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyLinkRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyMemberItem; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyRow; +import com.wordmarket.admin.dto.MorphologyDtos.FamilyVariantItem; +import com.wordmarket.admin.dto.MorphologyDtos.LinkExamRow; +import com.wordmarket.admin.dto.MorphologyDtos.MemberRow; +import com.wordmarket.admin.dto.MorphologyDtos.MiniGroupItem; +import com.wordmarket.admin.dto.MorphologyDtos.MiniGroupRow; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeDetail; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeItem; +import com.wordmarket.admin.dto.MorphologyDtos.MorphemeRefRow; +import com.wordmarket.admin.dto.MorphologyDtos.TreeCounts; +import com.wordmarket.admin.dto.MorphologyDtos.TreeNode; +import com.wordmarket.admin.dto.MorphologyDtos.TreePage; +import com.wordmarket.admin.dto.MorphologyDtos.VariantRow; +import com.wordmarket.admin.mapper.MorphologyMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +@Service +@Transactional(readOnly = true) +public class MorphologyService { + + private static final Set MORPHEME_TYPES = Set.of("prefix", "root", "suffix"); + private static final int MEMBER_PREVIEW = 50; + + private final MorphologyMapper morphologyMapper; + + public MorphologyService(MorphologyMapper morphologyMapper) { + this.morphologyMapper = morphologyMapper; + } + + public PageResult morphemes(String type, String keyword, Integer pageParam, + Integer sizeParam) { + if (type != null && !type.isBlank() && !MORPHEME_TYPES.contains(type)) { + throw BizException.badRequest("词素类型必须为 prefix、root 或 suffix"); + } + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = morphologyMapper.countMorphemes(type, keyword); + List items = morphologyMapper.listMorphemes(type, keyword, + Pages.offset(page, size), size); + return PageResult.of(items, total, page, size); + } + + public MorphemeDetail morpheme(long id) { + MorphemeItem item = morphologyMapper.findMorpheme(id); + if (item == null) { + throw BizException.notFound("词素不存在"); + } + List cards = morphologyMapper.listCardsByMorpheme(id); + return new MorphemeDetail(item.id(), item.type(), item.form(), item.displayText(), + item.meaningEn(), item.meaningZh(), item.note(), cards, + morphologyMapper.countCardsByMorpheme(id)); + } + + public PageResult cards(String keyword, Integer pageParam, Integer sizeParam) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = morphologyMapper.countCards(keyword); + List rows = morphologyMapper.listCards(keyword, Pages.offset(page, size), size); + if (rows.isEmpty()) { + return PageResult.of(List.of(), total, page, size); + } + List ids = rows.stream().map(row -> Long.parseLong(row.id())).toList(); + Map> exams = groupCardExams(morphologyMapper.listCardExams(ids)); + List items = rows.stream() + .map(row -> new CardItem(row.id(), row.word(), row.memoryNote(), row.highlightedWord(), + exams.getOrDefault(Long.parseLong(row.id()), List.of()))) + .toList(); + return PageResult.of(items, total, page, size); + } + + public CardDetail card(long id) { + CardRow row = morphologyMapper.findCard(id); + if (row == null) { + throw BizException.notFound("单词卡片不存在"); + } + Map> exams = groupCardExams( + morphologyMapper.listCardExams(List.of(id))); + List morphemeIds = new ArrayList<>(); + addPositive(morphemeIds, row.prefixMorphemeId()); + addPositive(morphemeIds, row.rootMorphemeId()); + addPositive(morphemeIds, row.suffixMorphemeId()); + Map refs = new HashMap<>(); + if (!morphemeIds.isEmpty()) { + for (MorphemeRefRow ref : morphologyMapper.listMorphemeRefs(morphemeIds)) { + refs.put(Long.parseLong(ref.id()), ref); + } + } + List links = morphologyMapper.listCardFamilyLinks(id).stream() + .map(link -> new CardFamilyLink(link.id(), link.groupNo(), link.familyRef(), + link.hidden())) + .toList(); + return new CardDetail(row.id(), row.word(), row.highlightedWord(), row.memoryNote(), + row.exampleText(), row.hidden(), + morphemeId(row.prefixMorphemeId()), formOf(refs, row.prefixMorphemeId()), + morphemeId(row.rootMorphemeId()), formOf(refs, row.rootMorphemeId()), + morphemeId(row.suffixMorphemeId()), formOf(refs, row.suffixMorphemeId()), + row.defaultFamilyRef(), exams.getOrDefault(id, List.of()), links); + } + + public PageResult families(String keyword, Integer pageParam, Integer sizeParam) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = morphologyMapper.countFamilies(keyword); + List rows = morphologyMapper.listFamilies(keyword, Pages.offset(page, size), size); + if (rows.isEmpty()) { + return PageResult.of(List.of(), total, page, size); + } + List ids = rows.stream().map(row -> Long.parseLong(row.id())).toList(); + Map> exams = groupFamilyExams(morphologyMapper.listFamilyExams(ids)); + List items = rows.stream() + .map(row -> new FamilyItem(row.id(), row.word(), row.topFamilyId(), row.topWord(), + row.interpretation(), row.groupLevel1(), row.groupLevel2(), row.groupLevel3(), + exams.getOrDefault(Long.parseLong(row.id()), List.of()))) + .toList(); + return PageResult.of(items, total, page, size); + } + + public FamilyDetail family(long id) { + FamilyRow row = morphologyMapper.findFamily(id); + if (row == null) { + throw BizException.notFound("词族不存在"); + } + Map> exams = groupFamilyExams( + morphologyMapper.listFamilyExams(List.of(id))); + long topId = Long.parseLong(row.topFamilyId()); + List variants = morphologyMapper.listVariants(topId).stream() + .map(variant -> new FamilyVariantItem(variant.id(), variant.variantWord(), + variant.interpretation(), variant.memberCount())) + .toList(); + List miniGroups = new ArrayList<>(); + for (MiniGroupRow group : morphologyMapper.listMiniGroups(topId)) { + List members = morphologyMapper + .listMiniGroupMembers(Long.parseLong(group.id())).stream() + .map(member -> new FamilyMemberItem(member.familyEntryId(), member.word(), + member.position())) + .toList(); + miniGroups.add(new MiniGroupItem(group.id(), group.size(), members)); + } + return new FamilyDetail(row.id(), row.word(), row.topFamilyId(), row.topWord(), + row.interpretation(), row.groupLevel1(), row.groupLevel2(), row.groupLevel3(), + exams.getOrDefault(id, List.of()), variants, miniGroups); + } + + public TreePage tree(long id, String nodeType, Integer pageParam, Integer sizeParam) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + String type = nodeType == null || nodeType.isBlank() ? "top" : nodeType; + return switch (type) { + case "top" -> { + if (morphologyMapper.findFamily(id) == null) { + throw BizException.notFound("词族不存在"); + } + TreeCounts counts = morphologyMapper.countTopChildren(id); + List nodes = morphologyMapper.listTopChildren(id, Pages.offset(page, size), + size); + yield new TreePage(nodes, counts.variantCount() + counts.groupCount(), page, size); + } + case "variant" -> new TreePage( + morphologyMapper.listVariantMemberNodes(id, Pages.offset(page, size), size), + morphologyMapper.countVariantMembers(id), page, size); + case "miniGroup" -> new TreePage( + morphologyMapper.listMiniGroupMemberNodes(id, Pages.offset(page, size), size), + morphologyMapper.countMiniGroupMembers(id), page, size); + default -> throw BizException.badRequest("不支持的树节点类型"); + }; + } + + private static Map> groupCardExams(List rows) { + Map> map = new HashMap<>(); + for (LinkExamRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.cardId()), key -> new ArrayList<>()) + .add(new ExamRef(row.id(), row.code(), row.name())); + } + return map; + } + + private static Map> groupFamilyExams(List rows) { + Map> map = new HashMap<>(); + for (FamilyExamRow row : rows) { + map.computeIfAbsent(Long.parseLong(row.familyEntryId()), key -> new ArrayList<>()) + .add(new ExamRef(row.id(), row.code(), row.name())); + } + return map; + } + + private static void addPositive(List ids, String value) { + if (value != null && !value.isBlank() && !"0".equals(value)) { + ids.add(Long.parseLong(value)); + } + } + + private static String morphemeId(String value) { + return value == null || "0".equals(value) ? null : value; + } + + private static String formOf(Map refs, String id) { + if (id == null || "0".equals(id)) { + return null; + } + MorphemeRefRow ref = refs.get(Long.parseLong(id)); + return ref == null ? null : ref.form(); + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/QualityService.java b/backend/src/main/java/com/wordmarket/admin/service/QualityService.java new file mode 100644 index 0000000..06c555f --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/QualityService.java @@ -0,0 +1,150 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.config.AppProperties; +import com.wordmarket.admin.dto.QualityDtos.Coverage; +import com.wordmarket.admin.dto.QualityDtos.DeclaredDiff; +import com.wordmarket.admin.dto.QualityDtos.MissingBook; +import com.wordmarket.admin.dto.QualityDtos.MissingReference; +import com.wordmarket.admin.dto.QualityDtos.MissingZpk; +import com.wordmarket.admin.dto.QualityDtos.QualitySummary; +import com.wordmarket.admin.dto.QualityDtos.SummaryItem; +import com.wordmarket.admin.mapper.QualityMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +@Service +@Transactional(readOnly = true) +public class QualityService { + + private static final String KEY_MISMATCH = "mismatch"; + private static final String KEY_NO_FILE = "nofile"; + private static final String KEY_NO_ZPK = "nozpk"; + private static final String KEY_NO_SENSE = "nosense"; + private static final String KEY_NO_SYN_SENSE = "nosyn"; + private static final String KEY_NO_EXAM = "noexam"; + private static final String KEY_NO_COVER = "nocover"; + + private final QualityMapper qualityMapper; + private final AggregateCache cache; + private final AppProperties appProperties; + + public QualityService(QualityMapper qualityMapper, AggregateCache cache, AppProperties appProperties) { + this.qualityMapper = qualityMapper; + this.cache = cache; + this.appProperties = appProperties; + } + + public QualitySummary summary(boolean refresh) { + return cache.get("quality:summary", refresh, () -> new QualitySummary(loadSummaryItems())); + } + + public List loadSummaryItems() { + List items = new ArrayList<>(); + items.add(new SummaryItem(KEY_MISMATCH, "声明与实际词条数不一致", + qualityMapper.countDeclaredMismatch(), "本", "warn", + "口径:book.declared_entry_count 与 book_entry 实际行数不一致的词书。")); + items.add(new SummaryItem(KEY_NO_FILE, "缺失词书清单文件", + qualityMapper.countMissingFiles(), "本", "bad", + "口径:目录中存在但磁盘缺少清单文件的词书(book.has_wordbook_file = 0)。")); + items.add(new SummaryItem(KEY_NO_ZPK, "缺失 zpk 引用", + missingZpkRows().size(), "个", "bad", + "口径:配置中登记的缺失 zpk 文件键,仍被 book_entry.source_zpk_key 引用的去重数量。")); + items.add(new SummaryItem(KEY_NO_SENSE, "无结构化义项的词条", + qualityMapper.countEntriesWithoutSense(), "条", "warn", + "口径:word_sense 中完全没有记录的词条。")); + items.add(new SummaryItem(KEY_NO_SYN_SENSE, "无义项的近义词头", + qualityMapper.countSynonymWordsWithoutSense(), "个", "warn", + "口径:synonym_sense 中完全没有记录的近义词头。")); + items.add(new SummaryItem(KEY_NO_EXAM, "未设置考试的词书", + qualityMapper.countBooksWithoutExam(), "本", "info", + "口径:book.exam_id 为空的词书,通常为非考试类或未归类。")); + items.add(new SummaryItem(KEY_NO_COVER, "无封面词书", + qualityMapper.countBooksWithoutCover(), "本", "info", + "口径:book.cover_url 为空的词书,前端展示统一占位图。")); + return items; + } + + public List declaredVsActual(boolean refresh) { + return cache.get("quality:declared", refresh, qualityMapper::listDeclaredMismatch); + } + + public List missingReferences(boolean refresh) { + return cache.get("quality:missing", refresh, this::loadMissingReferences); + } + + private List loadMissingReferences() { + List items = new ArrayList<>(); + for (MissingBook book : qualityMapper.listMissingFileBooks()) { + items.add(new MissingReference("book_file", book.bookCode(), + "book.has_wordbook_file", book.bookName(), book.bookId())); + } + List keys = configuredZpkKeys(); + if (!keys.isEmpty()) { + for (MissingZpk zpk : qualityMapper.listKnownMissingZpk(keys)) { + items.add(new MissingReference("zpk", zpk.sourceKey(), "book_entry.source_zpk_key", + "影响 " + zpk.rowCount() + " 行词书关联;词书 ID: " + zpk.bookIds(), null)); + } + } + for (MissingBook book : qualityMapper.listBooksWithoutCover()) { + items.add(new MissingReference("cover", book.bookCode(), "book.cover_url", + book.bookName(), book.bookId())); + } + return items; + } + + public List crossDomainCoverage(boolean refresh) { + return cache.get("quality:coverage", refresh, this::loadCoverage); + } + + public List loadCoverage() { + List items = new ArrayList<>(); + items.add(coverage("card", "单词卡片", qualityMapper.cardHit(), qualityMapper.cardTotal())); + items.add(coverage("family", "词族", qualityMapper.familyHit(), qualityMapper.familyTotal())); + items.add(coverage("synonym", "近义词头", qualityMapper.synonymHit(), qualityMapper.synonymTotal())); + return items; + } + + private List missingZpkRows() { + List keys = configuredZpkKeys(); + if (keys.isEmpty()) { + return List.of(); + } + return qualityMapper.listKnownMissingZpk(keys); + } + + private List configuredZpkKeys() { + String raw = appProperties.getQuality().getKnownMissingZpkKeys(); + if (raw == null || raw.isBlank()) { + return List.of(); + } + return Arrays.stream(raw.split(",")) + .map(String::trim) + .filter(value -> !value.isEmpty()) + .toList(); + } + + private static Coverage coverage(String key, String name, long hit, long total) { + double pct = total == 0 ? 0 : Math.round(hit * 1000.0 / total) / 10.0; + return new Coverage(key, name, hit, total, pct); + } + + public static String levelOf(String key) { + return switch (key) { + case KEY_NO_FILE, KEY_NO_ZPK -> "bad"; + case KEY_MISMATCH, KEY_NO_SENSE, KEY_NO_SYN_SENSE -> "warn"; + default -> "info"; + }; + } + + public static String targetOf(String key) { + return switch (key) { + case KEY_NO_SENSE, KEY_NO_ZPK -> "词条"; + case KEY_NO_SYN_SENSE -> "近义词"; + default -> "词书"; + }; + } +} diff --git a/backend/src/main/java/com/wordmarket/admin/service/SynonymService.java b/backend/src/main/java/com/wordmarket/admin/service/SynonymService.java new file mode 100644 index 0000000..215e524 --- /dev/null +++ b/backend/src/main/java/com/wordmarket/admin/service/SynonymService.java @@ -0,0 +1,121 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.common.Pages; +import com.wordmarket.admin.dto.SynonymDtos.AntonymItem; +import com.wordmarket.admin.dto.SynonymDtos.AntonymRow; +import com.wordmarket.admin.dto.SynonymDtos.GroupItem; +import com.wordmarket.admin.dto.SynonymDtos.GroupRow; +import com.wordmarket.admin.dto.SynonymDtos.MemberItem; +import com.wordmarket.admin.dto.SynonymDtos.MemberRow; +import com.wordmarket.admin.dto.SynonymDtos.SenseItem; +import com.wordmarket.admin.dto.SynonymDtos.SenseRow; +import com.wordmarket.admin.dto.SynonymDtos.SizeBucket; +import com.wordmarket.admin.dto.SynonymDtos.WordDetail; +import com.wordmarket.admin.dto.SynonymDtos.WordItem; +import com.wordmarket.admin.dto.SynonymDtos.WordRow; +import com.wordmarket.admin.mapper.SynonymMapper; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +@Service +@Transactional(readOnly = true) +public class SynonymService { + + private static final int MEMBER_LIMIT = 50; + + private final SynonymMapper synonymMapper; + + public SynonymService(SynonymMapper synonymMapper) { + this.synonymMapper = synonymMapper; + } + + public PageResult list(Integer pageParam, Integer sizeParam, String keyword) { + int page = Pages.page(pageParam); + int size = Pages.size(sizeParam); + long total = synonymMapper.countWords(keyword); + List items = synonymMapper.listWords(keyword, Pages.offset(page, size), size); + return PageResult.of(items, total, page, size); + } + + public WordDetail detail(long wordId) { + WordRow word = synonymMapper.findWord(wordId); + if (word == null) { + throw BizException.notFound("近义词词头不存在"); + } + List senses = synonymMapper.listSenses(wordId); + if (senses.isEmpty()) { + return new WordDetail(word.wordId(), word.word(), List.of()); + } + List ids = senses.stream().map(sense -> Long.parseLong(sense.senseId())).toList(); + Map> groupsBySense = new HashMap<>(); + for (GroupRow group : synonymMapper.listGroups(ids)) { + groupsBySense.computeIfAbsent(group.senseId(), key -> new ArrayList<>()).add(group); + } + Map> membersByGroup = new HashMap<>(); + for (MemberRow member : synonymMapper.listMembers(ids)) { + membersByGroup.computeIfAbsent(member.senseId() + ":" + member.examId(), + key -> new ArrayList<>()).add(member); + } + Map> antonymsByGroup = new LinkedHashMap<>(); + for (AntonymRow antonym : synonymMapper.listAntonyms(ids)) { + antonymsByGroup.computeIfAbsent(antonym.senseId() + ":" + antonym.examId(), + key -> new ArrayList<>()).add(antonym); + } + + List senseItems = new ArrayList<>(senses.size()); + for (SenseRow sense : senses) { + List groups = new ArrayList<>(); + List antonyms = new ArrayList<>(); + List examOrder = new ArrayList<>(); + for (GroupRow group : groupsBySense.getOrDefault(sense.senseId(), List.of())) { + String key = group.senseId() + ":" + group.examId(); + examOrder.add(key); + List members = membersByGroup.getOrDefault(key, List.of()).stream() + .limit(MEMBER_LIMIT) + .map(member -> new MemberItem(member.wordId(), member.word(), member.position())) + .toList(); + boolean truncated = membersByGroup.getOrDefault(key, List.of()).size() > MEMBER_LIMIT; + groups.add(new GroupItem(group.examId(), group.examName(), group.canonicalWordId(), + group.canonicalWord(), group.memberCount(), members, truncated)); + } + for (String key : examOrder) { + List rows = antonymsByGroup.getOrDefault(key, List.of()); + if (rows.isEmpty()) { + continue; + } + AntonymRow first = rows.get(0); + List words = rows.stream() + .map(row -> new MemberItem(row.wordId(), row.word(), row.position())) + .toList(); + antonyms.add(new AntonymItem(first.examId(), first.examName(), words)); + } + if (groups.isEmpty() && antonyms.isEmpty()) { + senseItems.add(new SenseItem(sense.senseId(), sense.partOfSpeech(), sense.glossZh(), + List.of(), List.of())); + } else { + senseItems.add(new SenseItem(sense.senseId(), sense.partOfSpeech(), sense.glossZh(), + groups, antonyms)); + } + } + return new WordDetail(word.wordId(), word.word(), senseItems); + } + + public List groupSizeDistribution() { + var rows = synonymMapper.groupSizeDistribution(); + long total = rows.stream().mapToLong(row -> row.count()).sum(); + List buckets = new ArrayList<>(rows.size()); + for (var row : rows) { + double pct = total == 0 ? 0 : Math.round(row.count() * 1000.0 / total) / 10.0; + buckets.add(new SizeBucket(row.label(), row.count(), pct)); + } + return buckets; + } +} diff --git a/backend/src/main/resources/application-dev.yml b/backend/src/main/resources/application-dev.yml new file mode 100644 index 0000000..2490c7b --- /dev/null +++ b/backend/src/main/resources/application-dev.yml @@ -0,0 +1,9 @@ +logging: + level: + com.wordmarket.admin: DEBUG + org.springframework.web: INFO + org.mybatis: INFO + +mybatis-plus: + configuration: + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl diff --git a/backend/src/main/resources/application.example.yml b/backend/src/main/resources/application.example.yml new file mode 100644 index 0000000..02f5fcf --- /dev/null +++ b/backend/src/main/resources/application.example.yml @@ -0,0 +1,28 @@ +# 复制为 application-local.yml,或直接通过环境变量注入。 +# 仓库中不得出现真实凭据。 +server: + port: 8080 + +spring: + datasource: + url: jdbc:mysql://s1.void01.com:3306/word_market?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true&connectTimeout=10000&socketTimeout=30000 + username: your_read_only_user + password: your_password + +admin: + username: admin + # 使用 BCrypt 哈希,例如: + # htpasswd -bnBC 10 "" 'your-password' | tr -d ':\n' + password-hash: $2a$10$replace_with_a_real_bcrypt_hash + jwt-secret: replace_with_a_random_secret_at_least_32_characters + token-ttl-hours: 8 + +app: + cors: + allowed-origins: http://localhost:5173,http://127.0.0.1:5173 + cover-base-url: https://static.beingfine.cn + cache: + ttl-minutes: 10 + maximum-size: 200 + quality: + known-missing-zpk-keys: 0_53785_101_1775241011 diff --git a/backend/src/main/resources/application.yml b/backend/src/main/resources/application.yml new file mode 100644 index 0000000..866fc3c --- /dev/null +++ b/backend/src/main/resources/application.yml @@ -0,0 +1,53 @@ +server: + port: ${SERVER_PORT:8080} + shutdown: graceful + +spring: + application: + name: word-market-admin + profiles: + default: dev + datasource: + url: ${DB_URL:jdbc:mysql://s1.void01.com:3306/word_market?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true&connectTimeout=10000&socketTimeout=30000} + username: ${DB_USERNAME:} + password: ${DB_PASSWORD:} + hikari: + read-only: true + maximum-pool-size: ${DB_POOL_SIZE:15} + minimum-idle: 2 + connection-timeout: 10000 + validation-timeout: 5000 + connection-init-sql: SET NAMES utf8mb4 + jackson: + time-zone: Asia/Shanghai + mvc: + problemdetails: + enabled: false + +mybatis-plus: + configuration: + map-underscore-to-camel-case: true + default-fetch-size: 100 + global-config: + banner: false + +admin: + username: ${ADMIN_USERNAME:} + password-hash: ${ADMIN_PASSWORD_HASH:} + jwt-secret: ${JWT_SECRET:} + token-ttl-hours: ${ADMIN_TOKEN_TTL_HOURS:8} + +app: + cors: + allowed-origins: ${CORS_ALLOWED_ORIGINS:http://localhost:5173,http://127.0.0.1:5173} + cover-base-url: ${COVER_BASE_URL:https://static.beingfine.cn} + cache: + ttl-minutes: ${CACHE_TTL_MINUTES:10} + maximum-size: ${CACHE_MAXIMUM_SIZE:200} + quality: + known-missing-zpk-keys: ${KNOWN_MISSING_ZPK_KEYS:0_53785_101_1775241011} + +logging: + level: + root: INFO + com.wordmarket.admin: INFO diff --git a/backend/src/test/java/com/wordmarket/admin/common/PagesTest.java b/backend/src/test/java/com/wordmarket/admin/common/PagesTest.java new file mode 100644 index 0000000..2149dc3 --- /dev/null +++ b/backend/src/test/java/com/wordmarket/admin/common/PagesTest.java @@ -0,0 +1,28 @@ +package com.wordmarket.admin.common; + +import org.junit.jupiter.api.Test; + +import static org.assertj.core.api.Assertions.assertThat; + +class PagesTest { + + @Test + void normalizesPageAndSize() { + assertThat(Pages.page(null)).isEqualTo(1); + assertThat(Pages.page(0)).isEqualTo(1); + assertThat(Pages.page(-3)).isEqualTo(1); + assertThat(Pages.page(4)).isEqualTo(4); + + assertThat(Pages.size(null)).isEqualTo(20); + assertThat(Pages.size(0)).isEqualTo(20); + assertThat(Pages.size(500)).isEqualTo(100); + assertThat(Pages.size(50)).isEqualTo(50); + } + + @Test + void computesOffset() { + assertThat(Pages.offset(1, 20)).isZero(); + assertThat(Pages.offset(3, 20)).isEqualTo(40); + assertThat(Pages.offset(Integer.MAX_VALUE, 100)).isEqualTo(Integer.MAX_VALUE); + } +} diff --git a/backend/src/test/java/com/wordmarket/admin/service/AggregateCacheTest.java b/backend/src/test/java/com/wordmarket/admin/service/AggregateCacheTest.java new file mode 100644 index 0000000..0786fd1 --- /dev/null +++ b/backend/src/test/java/com/wordmarket/admin/service/AggregateCacheTest.java @@ -0,0 +1,29 @@ +package com.wordmarket.admin.service; + +import com.github.benmanes.caffeine.cache.Cache; +import com.github.benmanes.caffeine.cache.Caffeine; +import org.junit.jupiter.api.Test; + +import java.util.concurrent.atomic.AtomicInteger; + +import static org.assertj.core.api.Assertions.assertThat; + +class AggregateCacheTest { + + private final Cache cache = Caffeine.newBuilder().maximumSize(10).build(); + private final AggregateCache aggregateCache = new AggregateCache(cache); + + @Test + void cachesUntilRefresh() { + AtomicInteger loads = new AtomicInteger(); + String first = aggregateCache.get("k", false, () -> "v" + loads.incrementAndGet()); + String second = aggregateCache.get("k", false, () -> "v" + loads.incrementAndGet()); + assertThat(first).isEqualTo("v1"); + assertThat(second).isEqualTo("v1"); + assertThat(loads.get()).isEqualTo(1); + + String refreshed = aggregateCache.get("k", true, () -> "v" + loads.incrementAndGet()); + assertThat(refreshed).isEqualTo("v2"); + assertThat(loads.get()).isEqualTo(2); + } +} diff --git a/backend/src/test/java/com/wordmarket/admin/service/AuthServiceTest.java b/backend/src/test/java/com/wordmarket/admin/service/AuthServiceTest.java new file mode 100644 index 0000000..75aa642 --- /dev/null +++ b/backend/src/test/java/com/wordmarket/admin/service/AuthServiceTest.java @@ -0,0 +1,65 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.config.AdminProperties; +import com.wordmarket.admin.dto.AuthDtos.LoginRequest; +import com.wordmarket.admin.dto.AuthDtos.LoginResponse; +import com.wordmarket.admin.security.JwtService; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpStatus; +import org.springframework.security.crypto.password.PasswordEncoder; + +import java.time.Instant; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +class AuthServiceTest { + + private final AdminProperties properties = new AdminProperties(); + private final PasswordEncoder passwordEncoder = mock(PasswordEncoder.class); + private final JwtService jwtService = mock(JwtService.class); + private AuthService authService; + + @BeforeEach + void setUp() { + properties.setUsername("admin"); + properties.setPasswordHash("hash"); + properties.setJwtSecret("0123456789012345678901234567890123456789"); + authService = new AuthService(properties, passwordEncoder, jwtService); + } + + @Test + void issuesTokenForValidCredentials() { + when(passwordEncoder.matches("secret", "hash")).thenReturn(true); + when(jwtService.issue("admin")).thenReturn( + new JwtService.IssuedToken("token", Instant.parse("2030-01-01T00:00:00Z"))); + + LoginResponse response = authService.login(new LoginRequest("admin", "secret")); + + assertThat(response.token()).isEqualTo("token"); + assertThat(response.username()).isEqualTo("admin"); + assertThat(response.expiresAt()).isEqualTo("2030-01-01T00:00:00Z"); + } + + @Test + void rejectsWrongCredentials() { + when(passwordEncoder.matches("bad", "hash")).thenReturn(false); + + assertThatThrownBy(() -> authService.login(new LoginRequest("admin", "bad"))) + .isInstanceOf(BizException.class) + .satisfies(error -> assertThat(((BizException) error).getStatus()) + .isEqualTo(HttpStatus.UNAUTHORIZED)); + } + + @Test + void rejectsWrongUsername() { + when(passwordEncoder.matches("secret", "hash")).thenReturn(true); + + assertThatThrownBy(() -> authService.login(new LoginRequest("other", "secret"))) + .isInstanceOf(BizException.class); + } +} diff --git a/backend/src/test/java/com/wordmarket/admin/service/BookServiceTest.java b/backend/src/test/java/com/wordmarket/admin/service/BookServiceTest.java new file mode 100644 index 0000000..346b0df --- /dev/null +++ b/backend/src/test/java/com/wordmarket/admin/service/BookServiceTest.java @@ -0,0 +1,64 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.BizException; +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.BookDtos.BookDetailRow; +import com.wordmarket.admin.dto.BookDtos.BookEntryItem; +import com.wordmarket.admin.dto.BookDtos.BookListItem; +import com.wordmarket.admin.mapper.BookMapper; +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpStatus; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.ArgumentMatchers.isNull; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +class BookServiceTest { + + private final BookMapper bookMapper = mock(BookMapper.class); + private final BookService bookService = new BookService(bookMapper); + + @Test + void detailReturnsNotFoundWhenMissing() { + when(bookMapper.findBook(99L)).thenReturn(null); + + assertThatThrownBy(() -> bookService.detail(99L)) + .isInstanceOf(BizException.class) + .satisfies(error -> assertThat(((BizException) error).getStatus()) + .isEqualTo(HttpStatus.NOT_FOUND)); + } + + @Test + void listClampsPageAndSize() { + when(bookMapper.countBooks(isNull(), isNull(), isNull())).thenReturn(0L); + when(bookMapper.listBooks(isNull(), isNull(), isNull(), eq(0), eq(100))) + .thenReturn(List.of()); + + PageResult result = bookService.list(0, 500, null, null, null); + + assertThat(result.page()).isEqualTo(1); + assertThat(result.size()).isEqualTo(100); + assertThat(result.items()).isEmpty(); + } + + @Test + void entriesClampPaginationAndVerifyBook() { + when(bookMapper.findBook(3L)).thenReturn(new BookDetailRow("3", "CET6", "六级", null, "4", + "六级", 100L, 90L, 1, 3, null, null, true, 0L, null)); + when(bookMapper.countBookEntries(3L, null)).thenReturn(0L); + when(bookMapper.listBookEntries(eq(3L), isNull(), eq(0), eq(100))) + .thenReturn(List.of()); + + PageResult result = bookService.entries(3L, 0, 500, null); + + assertThat(result.page()).isEqualTo(1); + assertThat(result.size()).isEqualTo(100); + assertThat(result.total()).isZero(); + } +} diff --git a/backend/src/test/java/com/wordmarket/admin/service/EntryServiceTest.java b/backend/src/test/java/com/wordmarket/admin/service/EntryServiceTest.java new file mode 100644 index 0000000..9df6229 --- /dev/null +++ b/backend/src/test/java/com/wordmarket/admin/service/EntryServiceTest.java @@ -0,0 +1,41 @@ +package com.wordmarket.admin.service; + +import com.wordmarket.admin.common.PageResult; +import com.wordmarket.admin.dto.EntryDtos.EntryDetail; +import com.wordmarket.admin.dto.EntryDtos.ExampleGroupItem; +import com.wordmarket.admin.dto.EntryDtos.SenseItem; +import com.wordmarket.admin.mapper.EntryMapper; +import org.junit.jupiter.api.Test; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +class EntryServiceTest { + + private final EntryMapper entryMapper = mock(EntryMapper.class); + private final EntryService entryService = new EntryService(entryMapper); + + private EntryDetail detail() { + return new EntryDetail("1", "word", "word", null, null, null, "2.0", null, null, + 0, false, "key"); + } + + @Test + void returnsEmptySensesAndExamples() { + when(entryMapper.findEntry(1L)).thenReturn(detail()); + when(entryMapper.listSenses(1L)).thenReturn(List.of()); + when(entryMapper.countExampleGroups(1L)).thenReturn(0L); + when(entryMapper.listExampleGroups(1L, 0, 5)).thenReturn(List.of()); + + List senses = entryService.senses(1L); + PageResult examples = entryService.examples(1L, 1, 5); + + assertThat(senses).isEmpty(); + assertThat(examples.items()).isEmpty(); + assertThat(examples.total()).isZero(); + assertThat(examples.page()).isEqualTo(1); + } +} diff --git a/frontend/.env.example b/frontend/.env.example new file mode 100644 index 0000000..8ce34a7 --- /dev/null +++ b/frontend/.env.example @@ -0,0 +1,4 @@ +# 默认连接真实后端;后端未就绪时可临时设为 true 使用本地同形 mock +VITE_USE_MOCK=false +VITE_API_BASE_URL=/api +VITE_COVER_BASE_URL=https://static.beingfine.cn diff --git a/frontend/README.md b/frontend/README.md index 394213b..6d30689 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -1,7 +1,77 @@ -# frontend — 单词管理前端 +# frontend — 词库管理前端 -占位目录,技术栈待定。 +Vue 3 + Vite + TypeScript + Element Plus + ECharts。 -用途:浏览、检索、编辑与管理由 `importer` 导入的词书、词条及其关联数据。 +## 功能 -后续确定技术栈与目录结构后在此实现。 +- 单管理员登录、token 持久化、路由守卫与 401 自动跳转。 +- 概览:六项 KPI、考试分布、词书规模排行、词性分布、质量红绿灯、跨域覆盖度,支持强制刷新聚合缓存。 +- 词书:列表筛选、详情、词条清单分页与搜索、封面占位。 +- 词条:搜索列表 + 右侧抽屉详情,义项/短语/例句/收录词书按 Tab 懒加载,支持空状态与分页。 +- 词根词族:词素、单词卡片、词族列表与详情,词族树形族谱按节点懒加载。 +- 近反义词:组规模分布图、词头列表、词头详情(分考试近义组与反义词)。 +- 数据质量:指标摘要与口径提示、声明与实际差异、缺失引用明细、跨域覆盖度、实体跳转。 + +## 开发 + +```powershell +cd frontend +npm install +npm run dev +``` + +默认地址:http://127.0.0.1:5173。开发服务器将 `/api` 代理到 `http://127.0.0.1:8080`;如后端端口不同: + +```powershell +$env:VITE_PROXY_TARGET = 'http://127.0.0.1:18080' +npm run dev +``` + +后端未启动时可临时使用本地 mock: + +```powershell +$env:VITE_USE_MOCK = 'true' +npm run dev +``` + +## 构建 + +```powershell +npm run build +``` + +产物在 `dist/`。构建前会执行 `vue-tsc --noEmit` 类型检查。 + +## 环境变量 + +复制 `.env.example` 为 `.env`: + +```text +VITE_USE_MOCK=false +VITE_API_BASE_URL=/api +VITE_COVER_BASE_URL=https://static.beingfine.cn +``` + +- `VITE_USE_MOCK`:仅在明确设为 `true` 时使用本地 mock。 +- `VITE_API_BASE_URL`:接口前缀,默认 `/api`。 +- `VITE_COVER_BASE_URL`:词书封面 CDN 前缀。 + +## 目录 + +```text +src/ + api/ Axios 封装、各模块接口与类型 + charts/ ECharts 配置 + components/ DataTable、CoverImage、StatCard、SectionPanel + layouts/ AdminLayout 侧边栏布局 + mocks/ 离线开发用的概览数据快照 + router/ 路由与登录守卫 + stores/ 认证状态 + styles/ 全局基础样式 + utils/ 封面地址、存储键、HTML 文本清理 + views/ 登录、概览、词书、词条、词根词族、近反义词、数据质量 +``` + +## 生产部署 + +`npm run build` 后将 `dist/` 交给 Nginx,并把 `/api` 反向代理到后端。示例配置见 [`../backend/README.md`](../backend/README.md) 的部署章节。 diff --git a/frontend/index.html b/frontend/index.html new file mode 100644 index 0000000..dc016ab --- /dev/null +++ b/frontend/index.html @@ -0,0 +1,16 @@ + + + + + + + Word Market · 词库管理后台 + + +
+ + + diff --git a/frontend/package-lock.json b/frontend/package-lock.json new file mode 100644 index 0000000..760c2f5 --- /dev/null +++ b/frontend/package-lock.json @@ -0,0 +1,2202 @@ +{ + "name": "word-market-frontend", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "word-market-frontend", + "version": "0.1.0", + "dependencies": { + "@element-plus/icons-vue": "^2.3.1", + "axios": "^1.7.9", + "echarts": "^5.5.1", + "element-plus": "^2.8.8", + "pinia": "^2.3.0", + "vue": "^3.5.13", + "vue-router": "^4.5.0" + }, + "devDependencies": { + "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^5.2.1", + "typescript": "~5.7.2", + "vite": "^6.0.5", + "vue-tsc": "^2.2.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.13", + "resolved": "https://registry.npmmirror.com/@babel/helper-string-parser/-/helper-string-parser-7.29.13.tgz", + "integrity": "sha512-fWegr+WsEsiMVW4KUNdIIzzMTZSzNiqhy0//6+2MRi2d5NFNsL/AYwBQW8eBnRbTBVRnDVzjaJEUqKaCWjMMdQ==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.13", + "resolved": "https://registry.npmmirror.com/@babel/parser/-/parser-7.29.13.tgz", + "integrity": "sha512-fJM50YYjlTiBhgdkGmC1tBpv+FMAyo4annf2X6Aks+0yRlaiVkYW/3f07xAfVVkYIoZ9fFZp+mEThUFnuybhkQ==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.11" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.11", + "resolved": "https://registry.npmmirror.com/@babel/types/-/types-7.29.11.tgz", + "integrity": "sha512-WCsemW40Cpc6gouC1SrY6PBaZ+oLRlEVY9XBvZBI7il/HyUrb2nJ505wE1MHEFyDZNnrWDEuy4jL50WVHfTTSQ==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.11", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@ctrl/tinycolor": { + "version": "4.3.0", + "resolved": "https://registry.npmmirror.com/@ctrl/tinycolor/-/tinycolor-4.3.0.tgz", + "integrity": "sha512-6V0+8vw/GmH92URQ/Ki12FPhoB3nqaQUJE+5xgbFbB5ok0OXYK5jCQsQQoyR3BzCddHsCpyCFRnIcI1PSOVYkQ==", + "license": "MIT", + "engines": { + "node": ">=14" + } + }, + "node_modules/@element-plus/icons-vue": { + "version": "2.3.2", + "resolved": "https://registry.npmmirror.com/@element-plus/icons-vue/-/icons-vue-2.3.2.tgz", + "integrity": "sha512-OzIuTaIfC8QXEPmJvB4Y4kw34rSXdCJzxcD1kFStBvr8bK6X1zQAYDo0CNMjojnfTqRQCJ0I7prlErcoRiET2A==", + "license": "MIT", + "peerDependencies": { + "vue": "^3.2.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz", + "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/android-arm/-/android-arm-0.25.12.tgz", + "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz", + "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/android-x64/-/android-x64-0.25.12.tgz", + "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz", + "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz", + "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz", + "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz", + "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz", + "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz", + "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz", + "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz", + "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz", + "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz", + "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz", + "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz", + "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz", + "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz", + "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz", + "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz", + "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz", + "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz", + "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz", + "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz", + "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz", + "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz", + "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@floating-ui/core": { + "version": "1.8.0", + "resolved": "https://registry.npmmirror.com/@floating-ui/core/-/core-1.8.0.tgz", + "integrity": "sha512-0CIZ5itps/8x7BG8dEIhs53BvCUH2PCoogtakwRTut+Arm58sJooJ0AuZhLw2HJYIR5cMLNPBSS728sPho2khQ==", + "license": "MIT", + "dependencies": { + "@floating-ui/utils": "^0.2.12" + } + }, + "node_modules/@floating-ui/dom": { + "version": "1.8.0", + "resolved": "https://registry.npmmirror.com/@floating-ui/dom/-/dom-1.8.0.tgz", + "integrity": "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg==", + "license": "MIT", + "dependencies": { + "@floating-ui/core": "^1.8.0", + "@floating-ui/utils": "^0.2.12" + } + }, + "node_modules/@floating-ui/utils": { + "version": "0.2.12", + "resolved": "https://registry.npmmirror.com/@floating-ui/utils/-/utils-0.2.12.tgz", + "integrity": "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww==", + "license": "MIT" + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmmirror.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "license": "MIT" + }, + "node_modules/@popperjs/core": { + "name": "@sxzz/popperjs-es", + "version": "2.11.8", + "resolved": "https://registry.npmmirror.com/@sxzz/popperjs-es/-/popperjs-es-2.11.8.tgz", + "integrity": "sha512-wOwESXvvED3S8xBmcPWHs2dUuzrE4XiZeFu7e1hROIJkm02a49N120pmOXxY33sBb6hArItm5W5tcg1cBtV+HQ==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/popperjs" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.68.0.tgz", + "integrity": "sha512-Ta2n0ntLfzP0LqwwcXOIh2z0mnHjlxMS+h4Y9lo+w33Quyf9KFKEi9QZ2IKqeEBKr0qxNpXc/DQjz5KVIs8AEA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.68.0.tgz", + "integrity": "sha512-iFDtS0oMaBvKbtrRKXmRcBSsI0UaWL2bWpd62iHzb0A8RSPrVz47mUGE0CfrrD0c/7/7dUhNtoN3cc6aEUn1Ow==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-x64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-android-x64/-/rollup-android-x64-4.68.0.tgz", + "integrity": "sha512-OnYETr+cZYSbesBD1tCvUjrBUTkjSaOcewRUoIHqD0XI3yn5i9WpdFaE3LZwrMlq0yeJNU0N5sxfHK/fNVMqlQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.68.0.tgz", + "integrity": "sha512-2qavWZtFeon/6oMkjsBF3OH7ENKgRTW4xRTwmz9VJeNUYhmPitpR9Jd4sAAc2OZJryHs2neoovMTCYnNvhvANQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.68.0.tgz", + "integrity": "sha512-QpgJO+GwNQDPt6uYcFSjZTFVyHNIeumN2am7RISDR9Nf3e/h8sur9cIfplPGihZPUn+sTw9j3JErZIUkHg8+Pw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.68.0.tgz", + "integrity": "sha512-TERqEn6P9bp4lsTyoFjT3nLKV6G++76HhGb4k6dRGcs+jvhVcTGaS2zkeRdLLRjwKxpBtdCZe11kUQ2hNGgFSA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.68.0.tgz", + "integrity": "sha512-RBjDrqb7h5l6Xgdgz5eKYvbpnUkii/z5ejWuZmHJsXORi0X0tTtFzEEgJj2DX995kW18c6T9LGFn/deEAMXDcQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.68.0.tgz", + "integrity": "sha512-HtLgXBqjF1Ampt9eJjzSmoGDvNb4LP8Y2aPXQZeQ5qhyExXLmoXJB9Jfm/nPi/8fJ3UFn4sZ7pQKyr8V+oTN8g==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.68.0.tgz", + "integrity": "sha512-q51xJyqjaqCNtDjYD7xNVwsPa2TcVfAIBeP6E20wicKZ6XYp8Taz9SUPYhIENojAQIAoV7cO3mUdMUgWYEAuhQ==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.68.0.tgz", + "integrity": "sha512-wejnVabl92oFC/o4sr/EEJuJZMHtMq4C+LBIPphN4EUiVHe9qvZNw+biqhVHpX2ggs1+Z3ugXGwJxT+qhyaaYQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.68.0.tgz", + "integrity": "sha512-tyu+hrsCWHHqV6+2tligV/recJH+HVvNV2Sp4nS1C+MKQPkNXRovKIzyHy0V0xXjm6igCLgsT2vTky5CvWP37g==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.68.0.tgz", + "integrity": "sha512-5gjJNglKDfgs3OmnGi/RVZQPhEfRoCIHxwSAP9ngmdnxreu0Vl9lI4gxmFBXOhKdftpS82xRdc/7Dp5/A1F0qg==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.68.0.tgz", + "integrity": "sha512-2IBxTUds33rFYwOIEyf77wfW8WQThwiQQ1ofXSraZQG7PiIq7BnQBf/ge0qEI/Ny/2cSc7SKkGO/wUDqmYXqTg==", + "cpu": [ + "loong64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.68.0.tgz", + "integrity": "sha512-mE/Pj2PPTZIVHkNNuHq+eYoU3td8LCm73zjrXoBWkNlnuULJS2l/fxwgGPpN4WUCNZgKZ1IXwrnnETPyOcWPmg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.68.0.tgz", + "integrity": "sha512-dYuykUkAiTv+RQdP3Ib47XcFiImkBWiRpTGSQWAMfZPQyoQYGe8Je4IUeZYNUQWIojmRCUnt5xsH4BbUb2uqSw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.68.0.tgz", + "integrity": "sha512-OnPDDFXLqJewY56T6ow8sA4wuzbqlliD7QJgkrx2KX+pWOpjI3usYXgB0pwK3nsgTF2odCw9IuJs0Uis/jy2qA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.68.0.tgz", + "integrity": "sha512-CqoQf06cK0brrRfDqH7Mt8G4MdteFGbjBdC61zEMaSVna6xo6QMUixa9bAkAD4a92g3ElPbQAkLMUzdf+Lk8dg==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.68.0.tgz", + "integrity": "sha512-LPHNmE8GwiyELGLUTkqj4zsP1YEHzGdtwnKxAcdP/swsNxXsfxPtpe5nrD/KGxr136xPB+eWv2r/SGj9md0pnQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.68.0.tgz", + "integrity": "sha512-GDOmvgephpRCNyNGRQOZh0KD2gTyRVM1Bb1iOo759xeCUpCAoRCmJioOOSu2MwyWfNOocGd0V5I9vYLfteC6/A==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.68.0.tgz", + "integrity": "sha512-HADRxkvl5eg3hbemCmv81UwTfdQy/CiSJDOabLE+p5tpm3OTjuRtzpLXy5zPfGY9FQD4Qv7qHptXmG/YjmNmyw==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.68.0.tgz", + "integrity": "sha512-iERrpqu1VEfyX736HLKiXRbwGDkCV/iybARY/mn14KcI6oKhJGBx1e+bU+g+umTKghtiGSPaHkwwpII4/N3RjA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.68.0.tgz", + "integrity": "sha512-hBn57IqAbpXpyktckonwePTaFOQS6THph8ZnpRO3eZHY4LncuZGjSsseigBnKuSMKKpLnJJ7PemDvXEzniXC+A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.68.0.tgz", + "integrity": "sha512-pJWb7mIw9Z25Hl3Q6nHFjl7AnczfOpm2gbOFYguSRv6TiH7DzsoAk/thymb/URSQu9OUEK7uaDMC5Xfm+7TAww==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.68.0.tgz", + "integrity": "sha512-pnrhmoyF2otH2Mezol14/ELUFGuRddOCz6+I+J0pq2Itnp4UxkjABQcXawCNMaKNsCRiuL90BtNzbEd0fHjpIg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.68.0.tgz", + "integrity": "sha512-1dJ3U+ktdtaIdPaOZKwIX57+bKQk4iAjs5M1wQWLKRB6Wglp98qf8LUeuN4u6bGlIYouZKaySZJ5Qd4OalUMnA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.68.0.tgz", + "integrity": "sha512-e/NRJFl48wL5DFNSzQrvm4kaB5dzNNmqWjIJ6And2Sjuw4klO3w3TXMvCAEF1tHTrQQgpOD4QVkBE/92/yBGrQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/estree": { + "version": "1.0.10", + "resolved": "https://registry.npmmirror.com/@types/estree/-/estree-1.0.10.tgz", + "integrity": "sha512-lTyOMnOcmRBzdCv6/4zUZCrEhV0xrqQiUZBZtVcbmLHBXKLnN8q89v/wKRF/Q0HbwVsqbIG3o5HDoFl9sduM+g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/lodash": { + "version": "4.17.27", + "resolved": "https://registry.npmmirror.com/@types/lodash/-/lodash-4.17.27.tgz", + "integrity": "sha512-VenMRv/eKNrspX9v3H4dbmjsrnCOYdYBG3kxXKk3dG6X+urBGcj2Prww3xw1U5K4FV/mE4h5GbWd0szEKf+9ew==", + "license": "MIT" + }, + "node_modules/@types/lodash-es": { + "version": "4.17.12", + "resolved": "https://registry.npmmirror.com/@types/lodash-es/-/lodash-es-4.17.12.tgz", + "integrity": "sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==", + "license": "MIT", + "dependencies": { + "@types/lodash": "*" + } + }, + "node_modules/@types/node": { + "version": "22.20.5", + "resolved": "https://registry.npmmirror.com/@types/node/-/node-22.20.5.tgz", + "integrity": "sha512-U2+DNr+wSjpsTS/wZGYHq7GcwfuSmKiKvoPvK22zwTlRhU91yOniN4qRR5KhIjvif7ysw/dz/hKmfDH0Ris4aA==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@types/web-bluetooth": { + "version": "0.0.21", + "resolved": "https://registry.npmmirror.com/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz", + "integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==", + "license": "MIT" + }, + "node_modules/@vitejs/plugin-vue": { + "version": "5.2.4", + "resolved": "https://registry.npmmirror.com/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz", + "integrity": "sha512-7Yx/SXSOcQq5HiiV3orevHUFn+pmMB4cgbEkDYgnkUWb0WfeQ/wa2yFv6D5ICiCQOVpjA7vYDXrC7AGO8yjDHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "peerDependencies": { + "vite": "^5.0.0 || ^6.0.0", + "vue": "^3.2.25" + } + }, + "node_modules/@volar/language-core": { + "version": "2.4.15", + "resolved": "https://registry.npmmirror.com/@volar/language-core/-/language-core-2.4.15.tgz", + "integrity": "sha512-3VHw+QZU0ZG9IuQmzT68IyN4hZNd9GchGPhbD9+pa8CVv7rnoOZwo7T8weIbrRmihqy3ATpdfXFnqRrfPVK6CA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/source-map": "2.4.15" + } + }, + "node_modules/@volar/source-map": { + "version": "2.4.15", + "resolved": "https://registry.npmmirror.com/@volar/source-map/-/source-map-2.4.15.tgz", + "integrity": "sha512-CPbMWlUN6hVZJYGcU/GSoHu4EnCHiLaXI9n8c9la6RaI9W5JHX+NqG+GSQcB0JdC2FIBLdZJwGsfKyBB71VlTg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@volar/typescript": { + "version": "2.4.15", + "resolved": "https://registry.npmmirror.com/@volar/typescript/-/typescript-2.4.15.tgz", + "integrity": "sha512-2aZ8i0cqPGjXb4BhkMsPYDkkuc2ZQ6yOpqwAuNwUoncELqoy5fRgOQtLR9gB0g902iS0NAkvpIzs27geVyVdPg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.15", + "path-browserify": "^1.0.1", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/compiler-core/-/compiler-core-3.5.45.tgz", + "integrity": "sha512-XGHJrM6ufZARAc/w+tyOswStw9tdKiqCKBScI4gGaNxD+aaGu/HQWgKJ+JItjRLPqenQ7iE7G8AJC7T5ew1p+g==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.12", + "@vue/shared": "3.5.45", + "entities": "^7.0.1", + "estree-walker": "^2.0.2", + "source-map-js": "^1.2.2" + } + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/compiler-dom/-/compiler-dom-3.5.45.tgz", + "integrity": "sha512-LbP2d19GSOYGPmvMBBCVJVlv7TKtjM1Cfeyu3cYia720pknZP+1cLX7H5MVatvruT6MuJhiPuNbQBW/MDn/EwA==", + "license": "MIT", + "dependencies": { + "@vue/compiler-core": "3.5.45", + "@vue/shared": "3.5.45" + } + }, + "node_modules/@vue/compiler-sfc": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/compiler-sfc/-/compiler-sfc-3.5.45.tgz", + "integrity": "sha512-MKFjb2UX0M/l/jhfzqMLrI8VM4pfvFKG3pqFZkSZFHRLtNld/O4RtUPZFWSwhro/14qP88UQEkWzHxAZAQ0tsw==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.12", + "@vue/compiler-core": "3.5.45", + "@vue/compiler-dom": "3.5.45", + "@vue/compiler-ssr": "3.5.45", + "@vue/shared": "3.5.45", + "estree-walker": "^2.0.2", + "magic-string": "^0.30.21", + "postcss": "^8.5.32", + "source-map-js": "^1.2.2" + } + }, + "node_modules/@vue/compiler-ssr": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/compiler-ssr/-/compiler-ssr-3.5.45.tgz", + "integrity": "sha512-RF5sbZOfYz5AK00tOJUn2PwFXR2fS1u2HVzI8D9VF9rGAFxuGBqg2bB1kJ3ZHMprqSltXnT9MZE1IsqjSM8oew==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.45", + "@vue/shared": "3.5.45" + } + }, + "node_modules/@vue/compiler-vue2": { + "version": "2.7.16", + "resolved": "https://registry.npmmirror.com/@vue/compiler-vue2/-/compiler-vue2-2.7.16.tgz", + "integrity": "sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==", + "dev": true, + "license": "MIT", + "dependencies": { + "de-indent": "^1.0.2", + "he": "^1.2.0" + } + }, + "node_modules/@vue/devtools-api": { + "version": "6.6.4", + "resolved": "https://registry.npmmirror.com/@vue/devtools-api/-/devtools-api-6.6.4.tgz", + "integrity": "sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g==", + "license": "MIT" + }, + "node_modules/@vue/language-core": { + "version": "2.2.12", + "resolved": "https://registry.npmmirror.com/@vue/language-core/-/language-core-2.2.12.tgz", + "integrity": "sha512-IsGljWbKGU1MZpBPN+BvPAdr55YPkj2nB/TBNGNC32Vy2qLG25DYu/NBN2vNtZqdRbTRjaoYrahLrToim2NanA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.15", + "@vue/compiler-dom": "^3.5.0", + "@vue/compiler-vue2": "^2.7.16", + "@vue/shared": "^3.5.0", + "alien-signals": "^1.0.3", + "minimatch": "^9.0.3", + "muggle-string": "^0.4.1", + "path-browserify": "^1.0.1" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@vue/reactivity": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/reactivity/-/reactivity-3.5.45.tgz", + "integrity": "sha512-WqkyubNWpI4OYBOipSrjIssMdJO8K1i9Zts/Wm8Er10/0msOEwCyWWWvZnAI7WW3kQsTong6DJp8Cbb+vd4cPA==", + "license": "MIT", + "dependencies": { + "@vue/shared": "3.5.45" + } + }, + "node_modules/@vue/runtime-core": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/runtime-core/-/runtime-core-3.5.45.tgz", + "integrity": "sha512-bzIO3+FABjpj85uIKSc+Qnj36/sxDNI3tcH9i6w6xKA1k6e0ejv0G0jMCfeJBvK3yGL5XbJ3DMZj+ClqyCHFYw==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.45", + "@vue/shared": "3.5.45" + } + }, + "node_modules/@vue/runtime-dom": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/runtime-dom/-/runtime-dom-3.5.45.tgz", + "integrity": "sha512-ZvRTFMDgfqTDYWvJfoVpQTJx1RN5M6l7Pyd6wfdY2NaXzbPQVh9ezeQYFbNPP6bIcRVn2SqSSR25N/jSW69BFw==", + "license": "MIT", + "dependencies": { + "@vue/reactivity": "3.5.45", + "@vue/runtime-core": "3.5.45", + "@vue/shared": "3.5.45", + "csstype": "^3.2.3" + } + }, + "node_modules/@vue/server-renderer": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/server-renderer/-/server-renderer-3.5.45.tgz", + "integrity": "sha512-1fNXUHhhsWf4EVL4XixbGBU5mKdiIXJAB82feHRTyPPo6ZUEYWIJuEeUl3mVV6QDBp50HJOX4obLhxYXlrjrzA==", + "license": "MIT", + "dependencies": { + "@vue/compiler-ssr": "3.5.45", + "@vue/runtime-dom": "3.5.45", + "@vue/shared": "3.5.45" + } + }, + "node_modules/@vue/shared": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/@vue/shared/-/shared-3.5.45.tgz", + "integrity": "sha512-ue9fgHmVNPlP7iW3+cxoBX/Cnlw53dHlVSw0JKGY6z1lObg8pHoj928M2nzG4/yVsMZ3NaRZ2s2z61uC16NDwQ==", + "license": "MIT" + }, + "node_modules/@vueuse/core": { + "version": "15.0.0", + "resolved": "https://registry.npmmirror.com/@vueuse/core/-/core-15.0.0.tgz", + "integrity": "sha512-Zv67h5mrk7YHDJsRObx+DXaCBz6RKBUpxqLesJ+3xZNPG6yuQs7ja7kg3veFrrouYLWAqydQ7CwGEbLVxB43Ng==", + "license": "MIT", + "dependencies": { + "@types/web-bluetooth": "^0.0.21", + "@vueuse/metadata": "15.0.0", + "@vueuse/shared": "15.0.0" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "vue": "^3.5.0" + } + }, + "node_modules/@vueuse/metadata": { + "version": "15.0.0", + "resolved": "https://registry.npmmirror.com/@vueuse/metadata/-/metadata-15.0.0.tgz", + "integrity": "sha512-sfWE5LADAKJ0KnjtGliMdSN8Ij/L7uP6rXIZlgPloAI4zvvefbw6H5Lt7KJA6RqQOYgVqWF5Guj50HHMIzygBg==", + "license": "MIT", + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + } + }, + "node_modules/@vueuse/shared": { + "version": "15.0.0", + "resolved": "https://registry.npmmirror.com/@vueuse/shared/-/shared-15.0.0.tgz", + "integrity": "sha512-vbNXhGrbV53xPOMSyOzMHQRvhMgZf7oNDw2RChUetVxwTIEkInQ1joZ9JbT0G3z2n2AJNjvmCWeM9ySYrnvogA==", + "license": "MIT", + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "vue": "^3.5.0" + } + }, + "node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmmirror.com/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/alien-signals": { + "version": "1.0.13", + "resolved": "https://registry.npmmirror.com/alien-signals/-/alien-signals-1.0.13.tgz", + "integrity": "sha512-OGj9yyTnJEttvzhTUWuscOvtqxq5vrhF7vL9oS0xJ2mK0ItPYP1/y+vCFebfxoEyAz0++1AIwJ5CMr+Fk3nDmg==", + "dev": true, + "license": "MIT" + }, + "node_modules/async-validator": { + "version": "4.2.5", + "resolved": "https://registry.npmmirror.com/async-validator/-/async-validator-4.2.5.tgz", + "integrity": "sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==", + "license": "MIT" + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmmirror.com/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/axios": { + "version": "1.21.0", + "resolved": "https://registry.npmmirror.com/axios/-/axios-1.21.0.tgz", + "integrity": "sha512-YCzXMB53Q9PZBsh7yN7wtapit4WepwcHS2fP8QhGsBxSz5YtgYobV7GGlWlAJi+RxfU77GQTQi2DSLUma42EYA==", + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.16.0", + "form-data": "^4.0.6", + "https-proxy-agent": "^5.0.1", + "proxy-from-env": "^2.1.0" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/brace-expansion": { + "version": "2.1.7", + "resolved": "https://registry.npmmirror.com/brace-expansion/-/brace-expansion-2.1.7.tgz", + "integrity": "sha512-uZbew1NqdmPDTMJ8ah1y+b+9QEJrfkXFk3RcTQw3X0jW/xRUvFKsg1CfQdSYGdTbXZWExtU3J3ccxtnfw1Fi0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmmirror.com/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmmirror.com/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/dayjs": { + "version": "1.11.23", + "resolved": "https://registry.npmmirror.com/dayjs/-/dayjs-1.11.23.tgz", + "integrity": "sha512-QDTCU0M0MxR3hQfnlDJfwekQiaanm1ubOD231u73WBckQ/fsamwRLiE2GBz6D3a/xF1NgfiDLJjXBa1hYOYTtQ==", + "license": "MIT" + }, + "node_modules/de-indent": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/de-indent/-/de-indent-1.0.2.tgz", + "integrity": "sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==", + "dev": true, + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmmirror.com/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmmirror.com/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/echarts": { + "version": "5.6.0", + "resolved": "https://registry.npmmirror.com/echarts/-/echarts-5.6.0.tgz", + "integrity": "sha512-oTbVTsXfKuEhxftHqL5xprgLoc0k7uScAwtryCgWF6hPYFLRwOUHiFmHGCBKP5NPFNkDVopOieyUqYGH8Fa3kA==", + "license": "Apache-2.0", + "dependencies": { + "tslib": "2.3.0", + "zrender": "5.6.1" + } + }, + "node_modules/element-plus": { + "version": "2.14.8", + "resolved": "https://registry.npmmirror.com/element-plus/-/element-plus-2.14.8.tgz", + "integrity": "sha512-Z4Br45W9b8vWKvVHSTvbS6rRKmsLjmHCPXICJR6osl35+i+S2LCBs4NN8apLBkQiUh0pzS9labK5eCS7yzDhWw==", + "license": "MIT", + "dependencies": { + "@ctrl/tinycolor": "^4.2.2", + "@element-plus/icons-vue": "^2.3.2", + "@floating-ui/dom": "^1.8.0", + "@popperjs/core": "npm:@sxzz/popperjs-es@^2.11.8", + "@types/lodash": "^4.17.24", + "@types/lodash-es": "^4.17.12", + "@vueuse/core": "15.0.0", + "async-validator": "^4.2.5", + "dayjs": "^1.11.20", + "lodash": "^4.18.1", + "lodash-es": "^4.18.1", + "lodash-unified": "^1.0.3", + "memoize-one": "^6.0.0", + "normalize-wheel-es": "^1.2.0", + "vue-component-type-helpers": "^3.3.11" + }, + "peerDependencies": { + "vue": "^3.3.7" + } + }, + "node_modules/entities": { + "version": "7.0.1", + "resolved": "https://registry.npmmirror.com/entities/-/entities-7.0.1.tgz", + "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmmirror.com/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmmirror.com/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmmirror.com/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/esbuild": { + "version": "0.25.12", + "resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.25.12.tgz", + "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.25.12", + "@esbuild/android-arm": "0.25.12", + "@esbuild/android-arm64": "0.25.12", + "@esbuild/android-x64": "0.25.12", + "@esbuild/darwin-arm64": "0.25.12", + "@esbuild/darwin-x64": "0.25.12", + "@esbuild/freebsd-arm64": "0.25.12", + "@esbuild/freebsd-x64": "0.25.12", + "@esbuild/linux-arm": "0.25.12", + "@esbuild/linux-arm64": "0.25.12", + "@esbuild/linux-ia32": "0.25.12", + "@esbuild/linux-loong64": "0.25.12", + "@esbuild/linux-mips64el": "0.25.12", + "@esbuild/linux-ppc64": "0.25.12", + "@esbuild/linux-riscv64": "0.25.12", + "@esbuild/linux-s390x": "0.25.12", + "@esbuild/linux-x64": "0.25.12", + "@esbuild/netbsd-arm64": "0.25.12", + "@esbuild/netbsd-x64": "0.25.12", + "@esbuild/openbsd-arm64": "0.25.12", + "@esbuild/openbsd-x64": "0.25.12", + "@esbuild/openharmony-arm64": "0.25.12", + "@esbuild/sunos-x64": "0.25.12", + "@esbuild/win32-arm64": "0.25.12", + "@esbuild/win32-ia32": "0.25.12", + "@esbuild/win32-x64": "0.25.12" + } + }, + "node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmmirror.com/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmmirror.com/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/follow-redirects": { + "version": "1.16.2", + "resolved": "https://registry.npmmirror.com/follow-redirects/-/follow-redirects-1.16.2.tgz", + "integrity": "sha512-/kVP2U8z596Ia0gwFrwyIeo74ta5aVmSeU1FfAUMAmcEP5EP7zydmag3SLiN64NaRKef3lxsq7i/g7ltJQDGow==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/form-data": { + "version": "4.0.6", + "resolved": "https://registry.npmmirror.com/form-data/-/form-data-4.0.6.tgz", + "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.4", + "mime-types": "^2.1.35" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmmirror.com/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmmirror.com/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmmirror.com/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmmirror.com/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmmirror.com/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmmirror.com/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmmirror.com/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "dev": true, + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmmirror.com/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/lodash": { + "version": "4.18.1", + "resolved": "https://registry.npmmirror.com/lodash/-/lodash-4.18.1.tgz", + "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", + "license": "MIT" + }, + "node_modules/lodash-es": { + "version": "4.18.1", + "resolved": "https://registry.npmmirror.com/lodash-es/-/lodash-es-4.18.1.tgz", + "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==", + "license": "MIT" + }, + "node_modules/lodash-unified": { + "version": "1.0.3", + "resolved": "https://registry.npmmirror.com/lodash-unified/-/lodash-unified-1.0.3.tgz", + "integrity": "sha512-WK9qSozxXOD7ZJQlpSqOT+om2ZfcT4yO+03FuzAHD0wF6S0l0090LRPDx3vhTTLZ8cFKpBn+IOcVXK6qOcIlfQ==", + "license": "MIT", + "peerDependencies": { + "@types/lodash-es": "*", + "lodash": "*", + "lodash-es": "*" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmmirror.com/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmmirror.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/memoize-one": { + "version": "6.0.0", + "resolved": "https://registry.npmmirror.com/memoize-one/-/memoize-one-6.0.0.tgz", + "integrity": "sha512-rkpe71W0N0c0Xz6QD0eJETuWAJGnJ9afsl1srmwPrI+yBCkge5EycXXbYRyvL29zZVUWQCY7InPRCv3GDXuZNw==", + "license": "MIT" + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmmirror.com/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmmirror.com/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/minimatch": { + "version": "9.0.9", + "resolved": "https://registry.npmmirror.com/minimatch/-/minimatch-9.0.9.tgz", + "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.2" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmmirror.com/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/muggle-string": { + "version": "0.4.1", + "resolved": "https://registry.npmmirror.com/muggle-string/-/muggle-string-0.4.1.tgz", + "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.20", + "resolved": "https://registry.npmmirror.com/nanoid/-/nanoid-3.3.20.tgz", + "integrity": "sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/normalize-wheel-es": { + "version": "1.2.0", + "resolved": "https://registry.npmmirror.com/normalize-wheel-es/-/normalize-wheel-es-1.2.0.tgz", + "integrity": "sha512-Wj7+EJQ8mSuXr2iWfnujrimU35R2W4FAErEyTmJoJ7ucwTn2hOUSsRehMb5RSYkxXGTM7Y9QpvPmp++w5ftoJw==", + "license": "BSD-3-Clause" + }, + "node_modules/path-browserify": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/path-browserify/-/path-browserify-1.0.1.tgz", + "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", + "dev": true, + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmmirror.com/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmmirror.com/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pinia": { + "version": "2.3.1", + "resolved": "https://registry.npmmirror.com/pinia/-/pinia-2.3.1.tgz", + "integrity": "sha512-khUlZSwt9xXCaTbbxFYBKDc/bWAGWJjOgvxETwkTN7KRm66EeT1ZdZj6i2ceh9sP2Pzqsbc704r2yngBrxBVug==", + "license": "MIT", + "dependencies": { + "@vue/devtools-api": "^6.6.3", + "vue-demi": "^0.14.10" + }, + "funding": { + "url": "https://github.com/sponsors/posva" + }, + "peerDependencies": { + "typescript": ">=4.4.4", + "vue": "^2.7.0 || ^3.5.11" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/postcss": { + "version": "8.5.32", + "resolved": "https://registry.npmmirror.com/postcss/-/postcss-8.5.32.tgz", + "integrity": "sha512-LJlKCCAUFKOuZxipUdYw1NzIITEsPcgyOG9LkvRJvuKj/bRzbuRY0ARXvL0pWGpsZvn8jku+LMep2eU0seHp8g==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.20", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.2" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/proxy-from-env": { + "version": "2.1.0", + "resolved": "https://registry.npmmirror.com/proxy-from-env/-/proxy-from-env-2.1.0.tgz", + "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/rollup": { + "version": "4.68.0", + "resolved": "https://registry.npmmirror.com/rollup/-/rollup-4.68.0.tgz", + "integrity": "sha512-BIHWnc1Qjdy+WLfOdcSd67sxO4iW6pTnhdZosg+7ywSaiMWxxzKldkkNpUJqeXYAiJzyB14P2cIjqC6tlb6xzw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.10" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.68.0", + "@rollup/rollup-android-arm64": "4.68.0", + "@rollup/rollup-android-x64": "4.68.0", + "@rollup/rollup-darwin-arm64": "4.68.0", + "@rollup/rollup-darwin-x64": "4.68.0", + "@rollup/rollup-freebsd-arm64": "4.68.0", + "@rollup/rollup-freebsd-x64": "4.68.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.68.0", + "@rollup/rollup-linux-arm-musleabihf": "4.68.0", + "@rollup/rollup-linux-arm64-gnu": "4.68.0", + "@rollup/rollup-linux-arm64-musl": "4.68.0", + "@rollup/rollup-linux-loong64-gnu": "4.68.0", + "@rollup/rollup-linux-loong64-musl": "4.68.0", + "@rollup/rollup-linux-ppc64-gnu": "4.68.0", + "@rollup/rollup-linux-ppc64-musl": "4.68.0", + "@rollup/rollup-linux-riscv64-gnu": "4.68.0", + "@rollup/rollup-linux-riscv64-musl": "4.68.0", + "@rollup/rollup-linux-s390x-gnu": "4.68.0", + "@rollup/rollup-linux-x64-gnu": "4.68.0", + "@rollup/rollup-linux-x64-musl": "4.68.0", + "@rollup/rollup-openbsd-x64": "4.68.0", + "@rollup/rollup-openharmony-arm64": "4.68.0", + "@rollup/rollup-win32-arm64-msvc": "4.68.0", + "@rollup/rollup-win32-ia32-msvc": "4.68.0", + "@rollup/rollup-win32-x64-gnu": "4.68.0", + "@rollup/rollup-win32-x64-msvc": "4.68.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/source-map-js": { + "version": "1.2.2", + "resolved": "https://registry.npmmirror.com/source-map-js/-/source-map-js-1.2.2.tgz", + "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmmirror.com/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tslib": { + "version": "2.3.0", + "resolved": "https://registry.npmmirror.com/tslib/-/tslib-2.3.0.tgz", + "integrity": "sha512-N82ooyxVNm6h1riLCoyS9e3fuJ3AMG2zIZs2Gd1ATcSFjSA23Q0fzjjZeh0jbJvWVDZ0cJT8yaNNaaXHzueNjg==", + "license": "0BSD" + }, + "node_modules/typescript": { + "version": "5.7.3", + "resolved": "https://registry.npmmirror.com/typescript/-/typescript-5.7.3.tgz", + "integrity": "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==", + "devOptional": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmmirror.com/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/vite": { + "version": "6.4.5", + "resolved": "https://registry.npmmirror.com/vite/-/vite-6.4.5.tgz", + "integrity": "sha512-4enwjFfi4IwtEh0w+jPzpLVOFQiPHmmzPxcHXQOyEur47o6u0jE573DmGpjA+7irXoMLYRZD5ZaFUEneS3abPg==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.25.0", + "fdir": "^6.4.4", + "picomatch": "^4.0.2", + "postcss": "^8.5.3", + "rollup": "^4.34.9", + "tinyglobby": "^0.2.13" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || ^20.0.0 || >=22.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", + "jiti": ">=1.21.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vscode-uri": { + "version": "3.2.0", + "resolved": "https://registry.npmmirror.com/vscode-uri/-/vscode-uri-3.2.0.tgz", + "integrity": "sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==", + "dev": true, + "license": "MIT" + }, + "node_modules/vue": { + "version": "3.5.45", + "resolved": "https://registry.npmmirror.com/vue/-/vue-3.5.45.tgz", + "integrity": "sha512-3cvsib8m9c0vB24+MDKsgcW4+Da4xaBl9Z/5Tbm2pmSIsRPxcil4cdXjXlVsmJ2g64XJo5h+IRd7rsdGT9pZaw==", + "license": "MIT", + "dependencies": { + "@vue/compiler-dom": "3.5.45", + "@vue/compiler-sfc": "3.5.45", + "@vue/runtime-dom": "3.5.45", + "@vue/server-renderer": "3.5.45", + "@vue/shared": "3.5.45" + }, + "peerDependencies": { + "typescript": "*" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/vue-component-type-helpers": { + "version": "3.3.14", + "resolved": "https://registry.npmmirror.com/vue-component-type-helpers/-/vue-component-type-helpers-3.3.14.tgz", + "integrity": "sha512-Pq3+OnbCiPCHk0R7KSZrx+j/XXaUn2kSQ1epxq60w8CPbByLjC1EJgV51n4WY851sTXUVzsNMuitywdkdVyKjA==", + "license": "MIT" + }, + "node_modules/vue-demi": { + "version": "0.14.10", + "resolved": "https://registry.npmmirror.com/vue-demi/-/vue-demi-0.14.10.tgz", + "integrity": "sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "vue-demi-fix": "bin/vue-demi-fix.js", + "vue-demi-switch": "bin/vue-demi-switch.js" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/antfu" + }, + "peerDependencies": { + "@vue/composition-api": "^1.0.0-rc.1", + "vue": "^3.0.0-0 || ^2.6.0" + }, + "peerDependenciesMeta": { + "@vue/composition-api": { + "optional": true + } + } + }, + "node_modules/vue-router": { + "version": "4.6.4", + "resolved": "https://registry.npmmirror.com/vue-router/-/vue-router-4.6.4.tgz", + "integrity": "sha512-Hz9q5sa33Yhduglwz6g9skT8OBPii+4bFn88w6J+J4MfEo4KRRpmiNG/hHHkdbRFlLBOqxN8y8gf2Fb0MTUgVg==", + "license": "MIT", + "dependencies": { + "@vue/devtools-api": "^6.6.4" + }, + "funding": { + "url": "https://github.com/sponsors/posva" + }, + "peerDependencies": { + "vue": "^3.5.0" + } + }, + "node_modules/vue-tsc": { + "version": "2.2.12", + "resolved": "https://registry.npmmirror.com/vue-tsc/-/vue-tsc-2.2.12.tgz", + "integrity": "sha512-P7OP77b2h/Pmk+lZdJ0YWs+5tJ6J2+uOQPo7tlBnY44QqQSPYvS0qVT4wqDJgwrZaLe47etJLLQRFia71GYITw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/typescript": "2.4.15", + "@vue/language-core": "2.2.12" + }, + "bin": { + "vue-tsc": "bin/vue-tsc.js" + }, + "peerDependencies": { + "typescript": ">=5.0.0" + } + }, + "node_modules/zrender": { + "version": "5.6.1", + "resolved": "https://registry.npmmirror.com/zrender/-/zrender-5.6.1.tgz", + "integrity": "sha512-OFXkDJKcrlx5su2XbzJvj/34Q3m6PvyCZkVPHGYpcCJ52ek4U/ymZyfuV1nKE23AyBJ51E/6Yr0mhZ7xGTO4ag==", + "license": "BSD-3-Clause", + "dependencies": { + "tslib": "2.3.0" + } + } + } +} diff --git a/frontend/package.json b/frontend/package.json new file mode 100644 index 0000000..02b7476 --- /dev/null +++ b/frontend/package.json @@ -0,0 +1,27 @@ +{ + "name": "word-market-frontend", + "private": true, + "version": "0.1.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "vue-tsc --noEmit && vite build", + "preview": "vite preview" + }, + "dependencies": { + "@element-plus/icons-vue": "^2.3.1", + "axios": "^1.7.9", + "echarts": "^5.5.1", + "element-plus": "^2.8.8", + "pinia": "^2.3.0", + "vue": "^3.5.13", + "vue-router": "^4.5.0" + }, + "devDependencies": { + "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^5.2.1", + "typescript": "~5.7.2", + "vite": "^6.0.5", + "vue-tsc": "^2.2.0" + } +} diff --git a/frontend/prototype/README.md b/frontend/prototype/README.md new file mode 100644 index 0000000..e4ed7b4 --- /dev/null +++ b/frontend/prototype/README.md @@ -0,0 +1,61 @@ +# UI 原型(throwaway) + +> **方案 A(经典后台)已选定。** 原型现已覆盖概览与五个业务模块;正式实现见 `frontend/src/`。 +> +> **这是可丢弃的 UI 原型,不是生产代码。** + +## 运行 + +在仓库根目录执行: + +```powershell +python -m http.server 8090 --directory frontend/prototype +``` + +打开 http://127.0.0.1:8090/index.html 即可。也可以直接双击 `index.html`(依赖 CDN,需要联网)。 + +## 页面 + +| 页面 | URL | 内容 | +|---|---|---| +| 概览 | `?page=overview&variant=A` | KPI、考试分布、词性分布、词书排行、质量红绿灯;支持 A/B/C 方案切换 | +| 词书管理 | `?page=books` | 词书列表、考试/关键词/文件状态筛选、词书详情与词条清单 | +| 词书详情 | `?page=books&id=15` | SAT10000 信息卡 + 12 条词条清单 | +| 词条词典 | `?page=entries` | 词条搜索与列表 | +| 词条详情 | `?page=entries&id=26132` | 右侧抽屉展示 `cinema` 基本信息 + 义项/短语/例句/易混词/收录词书五个 Tab | +| 词根词族 | `?page=morphology` | 词素、单词卡片、词族、树形族谱四个 Tab | +| 近反义词 | `?page=synonyms` | 词头列表 | +| 近反义词详情 | `?page=synonyms&id=2411` | `gain` 义项、分考试近义组、组规模分布、反义词 | +| 数据质量 | `?page=quality` | 7 项摘要、18 本声明差异、缺失引用、跨域覆盖度 | + +侧边栏可切换模块;词书与近义词列表中的“查看”进入详情页;词条列表点击行或“查看”在右侧非模态抽屉中展开详情,抽屉打开时仍可继续点击其他词条或切换模块,关闭抽屉即回到列表;词条与词根词族支持 Tab 切换;概览页底部条和键盘 `←` / `→` 切换 A/B/C。 + +## 数据 + +全部来自 MySQL `word_market` 的真实快照(2026-11-08),不是编造内容: + +- 词书 10 本、词书词条 12 条 +- 词条 10 条;`cinema` 含 2 个义项、3 个短语、6 条例句、5 个易混词、8 本收录词书 +- 词素 12 个、卡片 6 张、词族 8 个;`behave` 含 5 个变体与 4 个小组 +- 近义词头 8 个;`gain` 含 5 个义项、10 个近义组、2 组反义词 +- 质量差异 18 本词书、19 个无义项近义词头 + +## 文件 + +- `index.html`:入口、CDN 依赖、页面路由与方案切换 +- `data.js`:概览数据快照 +- `data-modules.js`:模块数据样本 +- `variant-a.js` / `variant-b.js` / `variant-c.js`:概览三方案 +- `module-shell.js`:模块页共用的 A 风格侧边栏布局 +- `view-books.js` / `view-entries.js` / `view-morphology.js` / `view-synonyms.js` / `view-quality.js` +- `styles.css`:概览与通用样式 +- `modules.css`:模块页样式 +- `screenshots/`:各页面截图 + +## 仍待确认 + +- 词条抽屉宽度是否合适,是否需要支持拖拽调整宽度。 +- 词书详情是否需要展示内容版本、发布时间等目录字段。 +- 词条抽屉内例句是否按例句组折叠,而不是平铺。 +- 族谱是否需要支持逐层懒加载,而不是默认展开全部。 +- 质量页的差异行是否需要提供“定位到词书”的钻取。 diff --git a/frontend/prototype/data-modules.js b/frontend/prototype/data-modules.js new file mode 100644 index 0000000..60d012b --- /dev/null +++ b/frontend/prototype/data-modules.js @@ -0,0 +1,214 @@ +// PROTOTYPE ONLY — real data samples from MySQL word_market (2026-11-08). +window.MODULE_DATA = { + books: [ + { id: 15, code: 'SAT', name: 'SAT10000', exam: '未归类', declared: 10001, actual: 10001, coverPath: '/dicts/v3/img_032516463440_24_opt.png', hasFile: true }, + { id: 1170, code: 'LLYC2027', name: '2027恋练有词考研英语词汇', exam: '考研', declared: 7969, actual: 7969, coverPath: '/dicts/v3/img_122613473672_1017_opt.png', hasFile: true }, + { id: 557, code: 'LLYCKY2024', name: '2024恋练有词考研英语词汇', exam: '考研', declared: 7949, actual: 7949, coverPath: '/dicts/v3/img_032615238520_111_opt.png', hasFile: true }, + { id: 740, code: 'LLYCKY2026', name: '2026恋练有词考研英语词汇', exam: '考研', declared: 7941, actual: 7941, coverPath: '/dicts/v3/img_122414371550_51_opt.png', hasFile: true }, + { id: 630, code: 'LLYCKY2025', name: '2025恋练有词考研英语词汇', exam: '考研', declared: 7940, actual: 7940, coverPath: '/dicts/v3/img_032615097259_51_opt.png', hasFile: true }, + { id: 508, code: 'LLYCK2023N', name: '2023恋练有词考研英语词汇', exam: '考研', declared: 7919, actual: 7919, coverPath: '/dicts/v3/img_042716404904_126_opt.png', hasFile: true }, + { id: 331, code: 'LLYCKY2023', name: '2023恋练有词考研英语词汇', exam: '考研', declared: 7919, actual: 7919, coverPath: '/dicts/v3/img_032617141081_126_opt.png', hasFile: true }, + { id: 841, code: 'HZBCET6N', name: '英语六级 你还在背单词吗(新版)', exam: '六级', declared: 7799, actual: 7799, coverPath: '/dicts/v3/img_081109464902_93_opt.png', hasFile: true }, + { id: 519, code: 'PETS5', name: '全国英语等级考试第五级', exam: '未归类', declared: 7527, actual: 7527, coverPath: '/dicts/v3/img_032516041386_40_opt.png', hasFile: true }, + { id: 819, code: 'KYLX2026', name: '考研词汇 词根联想记忆法 乱序版', exam: '考研', declared: 7349, actual: 7349, coverPath: '/dicts/v3/img_071615349355_34_opt.png', hasFile: true } + ], + bookEntries: [ + { displayWord: 'abandon', headword: 'abandon', pronunciation: 'əˈbændən', definition: 'vt. 放弃;抛弃;沉湎于 n. 放任,放纵', seq: 1 }, + { displayWord: 'surge', headword: 'surge', pronunciation: 'sɜːrdʒ', definition: 'vi. 涌动;激增 n. 激增;(感情的) 突发', seq: 1 }, + { displayWord: 'promotion', headword: 'promotion', pronunciation: 'prəˈmoʊʃn', definition: 'n. 晋升;促销;促进;晋级', seq: 2 }, + { displayWord: 'prompt', headword: 'prompt', pronunciation: 'prɑːmpt', definition: 'vt. 促使;引起 adj. 迅速的;准时的', seq: 2 }, + { displayWord: 'competitive', headword: 'competitive', pronunciation: 'kəmˈpetətɪv', definition: 'adj. 竞争的;有竞争力的;好胜的', seq: 3 }, + { displayWord: 'efficient', headword: 'efficient', pronunciation: 'ɪˈfɪʃnt', definition: 'adj. 效率高的', seq: 4 }, + { displayWord: 'uneasy', headword: 'uneasy', pronunciation: 'ʌnˈiːzi', definition: 'adj. 不安的,不自在的;不稳定的', seq: 4 }, + { displayWord: 'inquiry', headword: 'inquiry', pronunciation: 'ˈɪnkwəri', definition: 'n. 询问,打听;调查,探究', seq: 5 }, + { displayWord: 'stock', headword: 'stock', pronunciation: 'stɑːk', definition: 'n. 库存;储备物;股票;家畜', seq: 6 }, + { displayWord: 'exploit', headword: 'exploit', pronunciation: 'ɪkˈsplɔɪt', definition: 'vt. 剥削;利用;开采 n. 英勇的行为', seq: 7 }, + { displayWord: 'diagnose', headword: 'diagnose', pronunciation: 'ˌdaɪəɡˈnoʊs', definition: 'vt. vi. 诊断 (病症)', seq: 9 }, + { displayWord: 'advertise', headword: 'advertise', pronunciation: 'ˈædvərtaɪz', definition: 'vi. vt. 为…做广告;征聘', seq: 10 } + ], + entries: [ + { id: 26132, headword: 'cinema', indexWord: 'cinema', pronunciation: 'ˈsɪnəmə', definition: 'n. 电影院;电影艺术,电影业', occurrence: 91, senses: 2 }, + { id: 2763, headword: 'China', indexWord: 'China', pronunciation: 'ˈtʃaɪnə', definition: 'n. 中国', occurrence: 50, senses: 1 }, + { id: 52254, headword: 'inhabitant', indexWord: 'inhabitant', pronunciation: 'ɪnˈhæbɪtənt', definition: 'n. 居民,栖居的动物', occurrence: 37, senses: 1 }, + { id: 96868, headword: 'vast', indexWord: 'vast', pronunciation: 'væst', definition: 'adj. 巨大的,广阔的', occurrence: 36, senses: 1 }, + { id: 54775, headword: 'kilo', indexWord: 'kilo', pronunciation: 'ˈkiːloʊ', definition: 'n. 千克,公斤', occurrence: 35, senses: 1 }, + { id: 84763, headword: 'sometimes', indexWord: 'sometimes', pronunciation: 'ˈsʌmtaɪmz', definition: 'adv. 有时', occurrence: 35, senses: 1 }, + { id: 74617, headword: 'put on', indexWord: 'put on', pronunciation: '', definition: 'phrv. 穿上,戴上;增加体重;举办,上演', occurrence: 34, senses: 3 }, + { id: 81834, headword: 'seventeen', indexWord: 'seventeen', pronunciation: 'ˌsevnˈtiːn', definition: 'num. 十七', occurrence: 33, senses: 1 }, + { id: 29516, headword: 'corresponding', indexWord: 'corresponding', pronunciation: 'ˌkɔːrəˈspɑːndɪŋ', definition: 'adj. 符合的,相应的', occurrence: 32, senses: 1 }, + { id: 63898, headword: 'neutron', indexWord: 'neutron', pronunciation: 'ˈnuːtrɑːn', definition: 'n. 中子', occurrence: 30, senses: 1 } + ], + entryDetail: { + id: 26132, + headword: 'cinema', + indexWord: 'cinema', + pronunciation: 'ˈsɪnəmə', + definition: 'n. 电影院;电影艺术,电影业', + occurrence: 91, + senses: [ + { no: 1, pos: 'n.', gloss: '电影院', exams: '中考 / 高考 / 六级 / 考研 / 雅思 / 专升本' }, + { no: 2, pos: 'n.', gloss: '电影艺术,电影业', exams: '高考 / 雅思' } + ], + phrases: [ + { en: 'go to the cinema', zh: '去看电影', type: 2 }, + { en: 'a local cinema', zh: '当地影院', type: 2 }, + { en: 'American cinema', zh: '美国电影界', type: 2 } + ], + examples: [ + { en: "And besides, it's rude to talk in the cinema.", zh: '而且,在电影院大声喧哗是不礼貌的。' }, + { en: "I'm free this afternoon. Why don't we go to the cinema?", zh: '我今天下午有空,要不我们去看电影吧?' }, + { en: '"Loving Vincent" is set to hit cinema screens this fall.', zh: '《至爱梵高》将在今年秋季上映。' }, + { en: 'This was shown at a local cinema and made $100.', zh: '这部电影在当地一家影院上映,取得了100美元的利润。' }, + { en: 'Bruce Lee exploded onto American cinemas screen in August 1973.', zh: '1973年8月,李小龙凭借《龙争虎斗》闯入美国影坛。' }, + { en: 'A Moscow cinema has stopped screening the banned film.', zh: '莫斯科某影院已停止放映被禁影片。' } + ], + confusables: [ + { word: 'ninety', gloss: 'num. 九十' }, + { word: 'china', gloss: 'n. 瓷,瓷料;瓷器' }, + { word: 'coma', gloss: 'n. 昏迷' }, + { word: 'mine', gloss: 'pron. 我的' }, + { word: 'lineup', gloss: 'n. 阵容,阵列' } + ], + books: [ + { name: '外研join in六年级上', display: 'cinema', seq: 1 }, + { name: '人教PEP版六年级上', display: 'cinema', seq: 5 }, + { name: '辽师大五年级上(新版)', display: 'cinema', seq: 12 }, + { name: '鲁教版七年级上(五四学制)', display: 'cinema', seq: 14 }, + { name: '人教大同版四年级上(新版)', display: 'cinema', seq: 15 }, + { name: '外研社版四年级上(三年级起点)', display: 'cinema', seq: 15 }, + { name: '沪教版二年级上(新版)', display: 'cinema', seq: 20 }, + { name: '闽教版四年级上(新版)', display: 'cinema', seq: 21 } + ] + }, + morphemes: [ + { id: 1, type: 'prefix', form: 'caco-', meaningEn: 'bad', meaningZh: '坏的', note: '' }, + { id: 2, type: 'prefix', form: 'genu-', meaningEn: 'knee', meaningZh: '膝盖', note: '' }, + { id: 3, type: 'prefix', form: 'geronto-', meaningEn: 'old', meaningZh: '老的', note: '' }, + { id: 4, type: 'prefix', form: 'mega-', meaningEn: 'great', meaningZh: '巨大的', note: '' }, + { id: 215, type: 'root', form: 'duct', meaningEn: 'to lead', meaningZh: '引导', note: '' }, + { id: 216, type: 'root', form: 'duc', meaningEn: 'to lead', meaningZh: '引导', note: '' }, + { id: 217, type: 'root', form: 'du', meaningEn: 'to lead', meaningZh: '引导', note: '' }, + { id: 218, type: 'root', form: 'hom', meaningEn: 'man', meaningZh: '人类', note: '' }, + { id: 2080, type: 'suffix', form: '-aholic', meaningEn: '', meaningZh: '构成名词', note: '对…成瘾的人' }, + { id: 2081, type: 'suffix', form: '-ar', meaningEn: '', meaningZh: '构成形容词', note: '' }, + { id: 2082, type: 'suffix', form: '-ar', meaningEn: '', meaningZh: '构成名词', note: '做某事的人' }, + { id: 2083, type: 'suffix', form: '-ard', meaningEn: '', meaningZh: '构成名词', note: '常处于某种状态的人' } + ], + cards: [ + { id: 3, word: 'adherence', memory: '粘在…上 → 紧紧跟随 ⇨ 坚持,遵守,遵循', example: 'strict adherence to the rules\n严格遵守规章制度' }, + { id: 6, word: 'adherent', memory: '粘在…上 → 紧紧跟随 ⇨ 追随者,拥护者', example: 'adherents of the Greek Orthodox Church\n希腊东正教的信徒' }, + { id: 1, word: 'Anglican', memory: '英国国教会的;圣公会的', example: '' }, + { id: 2, word: 'Anglo-Saxon', memory: '盎格鲁-撒克逊人的;古英语的', example: '' }, + { id: 4, word: 'Antarctic', memory: '北边的反面 ⇨ 南极地区', example: '' }, + { id: 5, word: 'Antarctica', memory: '北边的反面 ⇨ 南极地区', example: '' } + ], + families: [ + { id: 585, word: 'act', interpretation: 'n. 行为;法案 v. 扮演', members: 112 }, + { id: 10126, word: 'heart', interpretation: 'n. 心脏;内心;中央', members: 97 }, + { id: 18270, word: 'sense', interpretation: 'n. 感官;意识;意思 v. 意识到', members: 74 }, + { id: 12115, word: 'light', interpretation: 'n. 光;电灯 adj. 明亮的;轻的', members: 68 }, + { id: 1501, word: 'arm', interpretation: 'n. 手臂 v. 武装,装备', members: 64 }, + { id: 12616, word: 'man', interpretation: 'n. 男人;人类,人', members: 63 }, + { id: 2146, word: 'behave', interpretation: 'v. 表现;举止得体', members: 24 }, + { id: 3664, word: 'civil', interpretation: 'adj. 公民的;有礼貌的', members: 18 } + ], + familyTree: { + id: 2146, + word: 'behave', + interpretation: 'v. 表现;举止得体', + variants: ['behaviour', 'behavioural', 'behaviourism', 'behaviourist', 'misbehaviour'], + groups: [ + ['behave', 'behavior', 'misbehave'], + ['behave', 'behavior', 'behavioral'], + ['behave', 'behavior', 'behaviorism'], + ['behave', 'behavior', 'behaviorist'] + ] + }, + synonyms: [ + { id: 4990, word: 'show', senses: 10 }, + { id: 3509, word: 'mark', senses: 8 }, + { id: 2174, word: 'fall', senses: 6 }, + { id: 2245, word: 'figure', senses: 6 }, + { id: 2411, word: 'gain', senses: 6 }, + { id: 4183, word: 'position', senses: 6 }, + { id: 4191, word: 'post', senses: 6 }, + { id: 4244, word: 'present', senses: 6 } + ], + synonymDetail: { + id: 2411, + word: 'gain', + senses: [ + { id: 3267, pos: 'v.', gloss: '获得' }, + { id: 3268, pos: 'v.', gloss: '增加' }, + { id: 3269, pos: 'v.', gloss: '受益' }, + { id: 3270, pos: 'n.', gloss: '增加' }, + { id: 3271, pos: 'n.', gloss: '好处' } + ], + groups: [ + { senseId: 3267, exam: '中考', canonical: 'achieve', count: 2 }, + { senseId: 3267, exam: '高考', canonical: 'obtain', count: 6 }, + { senseId: 3267, exam: '四级', canonical: 'obtain', count: 6 }, + { senseId: 3267, exam: '六级', canonical: 'obtain', count: 6 }, + { senseId: 3267, exam: '考研', canonical: 'obtain', count: 6 }, + { senseId: 3267, exam: '雅思', canonical: 'obtain', count: 6 }, + { senseId: 3267, exam: '托福', canonical: 'achieve', count: 6 }, + { senseId: 3268, exam: '中考', canonical: '', count: 8 }, + { senseId: 3268, exam: '高考', canonical: '', count: 10 }, + { senseId: 3268, exam: '四级', canonical: '', count: 10 } + ], + members: [ + { senseId: 3267, exam: '中考', words: ['gain', 'achieve'] }, + { senseId: 3267, exam: '高考', words: ['gain', 'obtain', 'achieve', 'acquire', 'attain', 'secure'] }, + { senseId: 3267, exam: '四级', words: ['gain', 'obtain', 'achieve', 'acquire', 'attain', 'secure'] }, + { senseId: 3267, exam: '六级', words: ['gain', 'obtain', 'achieve', 'acquire', 'attain', 'secure'] }, + { senseId: 3267, exam: '考研', words: ['gain', 'obtain', 'achieve', 'acquire', 'attain', 'secure'] }, + { senseId: 3267, exam: '雅思', words: ['gain', 'obtain', 'achieve', 'acquire', 'attain', 'secure'] } + ], + antonyms: [ + { senseId: 3270, gloss: '增加', exams: ['高考', '四级', '六级', '雅思', '托福', '其他'], word: 'loss' }, + { senseId: 3271, gloss: '好处', exams: ['中考', '高考', '四级', '六级', '考研', '雅思', '专升本', '其他'], word: 'loss' } + ] + }, + quality: { + summary: [ + { label: '声明与实际词条数不一致', value: 18, unit: '本', level: 'warn' }, + { label: '缺失词书清单文件', value: 1, unit: '本', level: 'bad' }, + { label: '缺失 zpk 引用', value: 1, unit: '个', level: 'bad' }, + { label: '无结构化义项的词条', value: 5250, unit: '条', level: 'warn' }, + { label: '无义项的近义词头', value: 19, unit: '个', level: 'warn' }, + { label: '未设置考试的词书', value: 509, unit: '本', level: 'info' }, + { label: '无封面词书', value: 27, unit: '本', level: 'info' } + ], + mismatch: [ + { name: '外研社版八年级上(新版)', code: 'WYS8S', declared: 335, actual: 256 }, + { name: '译林版牛津英语九上(新版)', code: 'YLB9S', declared: 305, actual: 368 }, + { name: '人教版七年级上(新版)', code: 'RJB7S2024', declared: 288, actual: 269 }, + { name: '沪教版三年级上(新版)', code: 'HJ3S', declared: 162, actual: 146 }, + { name: '外研社版四年级上(新版)', code: 'WYS4NJS', declared: 165, actual: 153 }, + { name: '鲁教版九年级全册(新版)', code: 'LJ9Q', declared: 482, actual: 492 }, + { name: '外研社版七年级上(新版)', code: 'WYS7S2024', declared: 298, actual: 288 }, + { name: '译林版牛津英语八上(新版)', code: 'YLB8S', declared: 440, actual: 450 }, + { name: '人教PEP版四年级上(新版)', code: 'RJPEP4S', declared: 109, actual: 117 }, + { name: '人教版八年级上(新版)', code: 'RJB8S', declared: 554, actual: 550 }, + { name: '外研社版高中选择性必修一(新)', code: 'WYSGZXZBX1', declared: 266, actual: 263 }, + { name: '科普版六年级上(新版)', code: 'KP6SN', declared: 108, actual: 109 }, + { name: '六级考前保命200词', code: 'CET6BM200', declared: 219, actual: 220 }, + { name: '闽教版五年级上(新版)', code: 'MJ5SN', declared: 135, actual: 134 }, + { name: '杭州English for Kids 2B', code: 'HZ2B', declared: 42, actual: 41 }, + { name: '人教版高中选择性必修一(新)', code: 'RJBGZXZBX1', declared: 345, actual: 344 }, + { name: '2021何凯文考研英语必考词汇', code: 'HKWKY2021', declared: 4249, actual: 4248 }, + { name: '考研考前保命200词', code: 'KYBM200', declared: 257, actual: 258 } + ], + missingFile: [{ name: '全国医学博士外语统一考试大纲', code: 'KBYXKSDG' }], + synNoSense: [ + 'adulthood', 'at home', 'attached', 'away', 'caring', 'childhood', 'confirmed', 'debit', 'luck', + 'nap', 'on a daily basis', 'purely', 'set sail', 'take a nap', 'trade union', 'unattached', + 'unbroken', 'uncaring', 'unconfirmed' + ], + coverage: [ + { name: '单词卡片', hit: 11662, total: 11998, pct: 97.2 }, + { name: '词族', hit: 17587, total: 22710, pct: 77.4 }, + { name: '近义词头', hit: 6231, total: 6279, pct: 99.2 } + ] + } +}; diff --git a/frontend/prototype/data.js b/frontend/prototype/data.js new file mode 100644 index 0000000..adbd647 --- /dev/null +++ b/frontend/prototype/data.js @@ -0,0 +1,63 @@ +// PROTOTYPE ONLY — throwaway UI data. Real snapshot from MySQL word_market (2026-11-08). +// Not production code; safe to delete. +window.DASHBOARD_DATA = { + kpis: [ + { key: 'books', label: '词书', value: 1025, note: '1 本无清单文件', tone: 'blue' }, + { key: 'entries', label: '词条', value: 38116, note: '38,000 个索引词', tone: 'green' }, + { key: 'links', label: '词书词条关联', value: 1228421, note: '平均每本 1,200 条', tone: 'violet' }, + { key: 'sentences', label: '例句', value: 235744, note: '含使用模式 71,964', tone: 'amber' }, + { key: 'families', label: '词族', value: 22717, note: '顶层族 5,629', tone: 'cyan' }, + { key: 'synonyms', label: '近义词头', value: 6279, note: '义项 8,383', tone: 'rose' } + ], + exams: [ + { name: '考研', code: 'KY', books: 108, entries: 480091 }, + { name: '未归类', code: '—', books: 509, entries: 258233 }, + { name: '高考', code: 'GK', books: 150, entries: 154292 }, + { name: '中考', code: 'ZK', books: 156, entries: 74439 }, + { name: '四级', code: 'CET4', books: 29, entries: 69362 }, + { name: '六级', code: 'CET6', books: 22, entries: 52863 }, + { name: '专升本', code: 'ZSB', books: 19, entries: 52681 }, + { name: '专四', code: 'PRO4', books: 7, entries: 25627 }, + { name: '雅思', code: 'IELTS', books: 11, entries: 25314 }, + { name: '专八', code: 'PRO8', books: 6, entries: 19954 }, + { name: '托福', code: 'TOEFL', books: 8, entries: 15565 } + ], + topBooks: [ + { id: 15, name: 'SAT10000', code: 'SAT', exam: 'SAT', declared: 10001, actual: 10001, cover: 'https://static.beingfine.cn/dicts/v3/img_032516463440_24_opt.png' }, + { id: 1170, name: '2027恋练有词考研英语词汇', code: 'LLYC2027', exam: '考研', declared: 7969, actual: 7969, cover: 'https://static.beingfine.cn/dicts/v3/img_122613473672_1017_opt.png' }, + { id: 557, name: '2024恋练有词考研英语词汇', code: 'LLYCKY2024', exam: '考研', declared: 7949, actual: 7949, cover: 'https://static.beingfine.cn/dicts/v3/img_032615238520_111_opt.png' }, + { id: 740, name: '2026恋练有词考研英语词汇', code: 'LLYCKY2026', exam: '考研', declared: 7941, actual: 7941, cover: 'https://static.beingfine.cn/dicts/v3/img_122414371550_51_opt.png' }, + { id: 630, name: '2025恋练有词考研英语词汇', code: 'LLYCKY2025', exam: '考研', declared: 7940, actual: 7940, cover: 'https://static.beingfine.cn/dicts/v3/img_032615097259_51_opt.png' }, + { id: 331, name: '2023恋练有词考研英语词汇', code: 'LLYCKY2023', exam: '考研', declared: 7919, actual: 7919, cover: 'https://static.beingfine.cn/dicts/v3/img_032617141081_126_opt.png' }, + { id: 508, name: '2023恋练有词考研英语词汇', code: 'LLYCK2023N', exam: '考研', declared: 7919, actual: 7919, cover: 'https://static.beingfine.cn/dicts/v3/img_042716404904_126_opt.png' }, + { id: 841, name: '英语六级 你还在背单词吗(新版)', code: 'HZBCET6N', exam: '六级', declared: 7799, actual: 7799, cover: 'https://static.beingfine.cn/dicts/v3/img_081109464902_93_opt.png' }, + { id: 519, name: '全国英语等级考试第五级', code: 'PETS5', exam: '未归类', declared: 7527, actual: 7527, cover: 'https://static.beingfine.cn/dicts/v3/img_032516041386_40_opt.png' }, + { id: 819, name: '考研词汇 词根联想记忆法 乱序版', code: 'KYLX2026', exam: '考研', declared: 7349, actual: 7349, cover: 'https://static.beingfine.cn/dicts/v3/img_071615349355_34_opt.png' } + ], + pos: [ + { name: 'n.', value: 21313 }, + { name: 'adj.', value: 9782 }, + { name: 'phr.', value: 6922 }, + { name: 'vt.', value: 5331 }, + { name: 'adv.', value: 1996 }, + { name: 'vi.', value: 1800 }, + { name: 'phrv.', value: 1758 }, + { name: 'idm.', value: 1595 }, + { name: 'vi. vt.', value: 971 }, + { name: 'vt. vi.', value: 896 } + ], + quality: [ + { key: 'mismatch', label: '声明与实际词条数不一致', value: 18, unit: '本', level: 'warn', target: '词书' }, + { key: 'nofile', label: '缺失词书清单文件', value: 1, unit: '本', level: 'bad', target: '词书' }, + { key: 'nozpk', label: '缺失 zpk 引用', value: 1, unit: '个', level: 'bad', target: '词条' }, + { key: 'nosense', label: '无结构化义项的词条', value: 5250, unit: '条', level: 'warn', target: '词条' }, + { key: 'nosyn', label: '无义项的近义词头', value: 19, unit: '个', level: 'warn', target: '近义词' }, + { key: 'noexam', label: '未设置考试的词书', value: 509, unit: '本', level: 'info', target: '词书' }, + { key: 'nocover', label: '无封面词书', value: 27, unit: '本', level: 'info', target: '词书' } + ], + coverage: [ + { name: '单词卡片', hit: 11662, total: 11998, pct: 97.2 }, + { name: '词族', hit: 17587, total: 22710, pct: 77.4 }, + { name: '近义词头', hit: 6231, total: 6279, pct: 99.2 } + ] +}; diff --git a/frontend/prototype/index.html b/frontend/prototype/index.html new file mode 100644 index 0000000..ee157e7 --- /dev/null +++ b/frontend/prototype/index.html @@ -0,0 +1,167 @@ + + + + + + + 词库后台 · UI 原型(throwaway) + + + + + + +
+ + + + + + + + + + + + + + + + + + + + diff --git a/frontend/prototype/module-shell.js b/frontend/prototype/module-shell.js new file mode 100644 index 0000000..b9e64e7 --- /dev/null +++ b/frontend/prototype/module-shell.js @@ -0,0 +1,42 @@ +// PROTOTYPE ONLY — shared A-style shell for module pages. +window.ModuleShell = { + name: 'ModuleShell', + props: { active: String, title: String }, + methods: { + go(page) { + window.protoNavigate(page); + } + }, + template: ` +
+
+ + +
+
+
后台 / {{ title }}
+
+ +
AD
+
+
+ +
+
+
` +}; diff --git a/frontend/prototype/modules.css b/frontend/prototype/modules.css new file mode 100644 index 0000000..a19c3a2 --- /dev/null +++ b/frontend/prototype/modules.css @@ -0,0 +1,893 @@ +/* PROTOTYPE ONLY — module pages (books / entries / morphology / synonyms / quality). */ + +.m-page-head { + display: flex; + align-items: flex-end; + justify-content: space-between; + gap: 16px; + margin-bottom: 18px; +} + +.m-page-head h1 { + margin: 0 0 4px; + font-size: 22px; + letter-spacing: -0.01em; +} + +.m-page-head p { + margin: 0; + font-size: 13px; + color: #6b7280; +} + +.m-page-meta { + font-size: 11.5px; + color: #9ca3af; +} + +.m-toolbar { + display: flex; + align-items: flex-end; + gap: 14px; + flex-wrap: wrap; + background: #fff; + border: 1px solid #e8ebf0; + border-radius: 10px; + padding: 14px 16px; + margin-bottom: 16px; +} + +.m-toolbar-inline { + background: transparent; + border: 0; + padding: 0; + margin: 0 0 12px; +} + +.m-field { + display: flex; + flex-direction: column; + gap: 4px; + min-width: 140px; +} + +.m-field-grow { + flex: 1; + min-width: 220px; +} + +.m-field label { + font-size: 11px; + color: #9ca3af; +} + +.m-field input, +.m-field select { + height: 34px; + border: 1px solid #e5e7eb; + border-radius: 7px; + background: #fff; + padding: 0 10px; + font: inherit; + font-size: 13px; + color: #374151; + outline: none; +} + +.m-field input:focus, +.m-field select:focus { + border-color: #93c5fd; + box-shadow: 0 0 0 3px #eff6ff; +} + +.m-toolbar-note { + margin-left: auto; + font-size: 11px; + color: #9ca3af; + padding-bottom: 9px; +} + +.m-table { + width: 100%; + border-collapse: collapse; + font-size: 13px; +} + +.m-table th { + text-align: left; + font-weight: 500; + font-size: 11.5px; + color: #9ca3af; + padding: 7px 8px; + border-bottom: 1px solid #eef0f3; + white-space: nowrap; +} + +.m-table td { + padding: 9px 8px; + border-bottom: 1px solid #f3f4f6; + vertical-align: middle; +} + +.m-table tbody tr:hover { + background: #fafbfc; +} + +.m-table tbody tr:last-child td { + border-bottom: 0; +} + +.m-num { + text-align: right; + font-variant-numeric: tabular-nums; +} + +.m-cell-title { + font-weight: 500; + color: #1f2937; +} + +.m-cell-sub { + font-size: 11px; + color: #9ca3af; +} + +.m-book-cell { + display: flex; + align-items: center; + gap: 10px; + min-width: 0; +} + +.m-cover { + width: 30px; + height: 40px; + border-radius: 4px; + object-fit: cover; + background: #eef2f7; + flex: none; +} + +.m-cover-lg { + width: 96px; + height: 132px; + border-radius: 8px; + object-fit: cover; + background: #eef2f7; + flex: none; +} + +.m-word { + font-weight: 600; + color: #111827; +} + +.m-phonetic { + font-size: 12px; + color: #6b7280; +} + +.m-def { + font-size: 12.5px; + color: #4b5563; + line-height: 1.65; +} + +.m-tag { + display: inline-block; + padding: 1px 7px; + border-radius: 999px; + background: #f1f5f9; + color: #475569; + font-size: 11px; + white-space: nowrap; +} + +.m-tag-prefix { + background: #eef2ff; + color: #4338ca; +} + +.m-tag-root { + background: #ecfdf5; + color: #047857; +} + +.m-tag-suffix { + background: #fffbeb; + color: #b45309; +} + +.m-dot { + display: inline-block; + width: 7px; + height: 7px; + border-radius: 50%; + margin-right: 6px; + vertical-align: middle; +} + +.m-dot.ok { + background: #16a34a; +} + +.m-dot.bad { + background: #ef4444; +} + +.m-dot.warn { + background: #f59e0b; +} + +.m-dot.info { + background: #3b82f6; +} + +.m-link { + color: #2563eb; + cursor: pointer; + white-space: nowrap; +} + +.m-link:hover { + text-decoration: underline; +} + +.m-ok { + color: #16a34a; +} + +.m-warn-text { + color: #d97706; +} + +.m-bad-text { + color: #dc2626; +} + +.m-empty { + padding: 42px 16px; + text-align: center; + color: #9ca3af; + font-size: 13px; +} + +.m-back { + display: inline-flex; + align-items: center; + gap: 4px; + margin-bottom: 12px; + font-size: 13px; + color: #6b7280; + cursor: pointer; +} + +.m-back:hover { + color: #2563eb; +} + +.m-detail-head { + display: flex; + align-items: center; + gap: 22px; + padding: 20px; +} + +.m-detail-main { + flex: 1; + min-width: 0; +} + +.m-detail-kicker { + font-size: 11px; + letter-spacing: 0.12em; + color: #9ca3af; +} + +.m-detail-title { + margin: 4px 0 8px; + font-size: 26px; + letter-spacing: -0.01em; +} + +.m-detail-meta { + display: flex; + align-items: center; + gap: 8px; + flex-wrap: wrap; +} + +.m-stat-row { + display: flex; + gap: 28px; + margin-left: auto; +} + +.m-stat { + text-align: right; +} + +.m-stat b { + display: block; + font-size: 22px; + font-weight: 700; + font-variant-numeric: tabular-nums; +} + +.m-stat span { + font-size: 11px; + color: #9ca3af; +} + +.m-tabs { + display: flex; + gap: 4px; + border-bottom: 1px solid #e5e7eb; + margin: 18px 0 0; +} + +.m-tab { + padding: 9px 14px; + font-size: 13.5px; + color: #6b7280; + cursor: pointer; + border-bottom: 2px solid transparent; + margin-bottom: -1px; +} + +.m-tab:hover { + color: #374151; +} + +.m-tab.active { + color: #4338ca; + border-color: #4338ca; + font-weight: 600; +} + +.m-tab-panel { + margin-top: 0; + border-radius: 0 0 10px 10px; + padding: 16px 18px; +} + +.m-note { + font-size: 11.5px; + color: #9ca3af; + line-height: 1.7; +} + +.m-example-list { + display: flex; + flex-direction: column; +} + +.m-example { + display: grid; + grid-template-columns: 36px minmax(0, 1fr); + gap: 12px; + padding: 12px 0; + border-bottom: 1px dashed #eef0f3; +} + +.m-example:last-child { + border-bottom: 0; +} + +.m-example-no { + font-size: 11px; + color: #9ca3af; + padding-top: 2px; +} + +.m-example-en { + font-size: 13px; + color: #1f2937; + line-height: 1.7; +} + +.m-example-zh { + font-size: 12px; + color: #6b7280; + margin-top: 4px; + line-height: 1.6; +} + +.m-chip-row { + display: flex; + gap: 8px; + margin-bottom: 14px; +} + +.m-chip { + display: inline-block; + padding: 3px 9px; + border-radius: 999px; + background: #f1f5f9; + color: #475569; + font-size: 11.5px; + border: 1px solid transparent; +} + +.m-chip-row .m-chip { + cursor: pointer; +} + +.m-chip.active { + background: #eef2ff; + color: #4338ca; + border-color: #c7d2fe; +} + +.m-chips { + display: flex; + flex-wrap: wrap; + gap: 6px; + margin-top: 6px; +} + +.m-card-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); + gap: 14px; +} + +.m-memo-card { + background: #fff; + border: 1px solid #e8ebf0; + border-radius: 10px; + padding: 16px; +} + +.m-memo-word { + font-size: 18px; + font-weight: 700; +} + +.m-memo-note { + margin-top: 8px; + font-size: 12.5px; + color: #4b5563; + line-height: 1.7; +} + +.m-memo-example { + margin-top: 10px; + padding-top: 10px; + border-top: 1px dashed #eef0f3; + font-size: 12px; + color: #6b7280; + white-space: pre-line; + line-height: 1.7; +} + +.m-tree-layout { + display: grid; + grid-template-columns: 250px minmax(0, 1fr); + gap: 16px; +} + +.m-family-list { + padding: 12px; + max-height: 600px; + overflow-y: auto; +} + +.m-family-item { + padding: 9px 10px; + border-radius: 8px; + cursor: pointer; +} + +.m-family-item:hover { + background: #f8fafc; +} + +.m-family-item.active { + background: #eef2ff; +} + +.m-family-item.active .m-family-word { + color: #4338ca; +} + +.m-family-word { + font-size: 13.5px; + font-weight: 600; +} + +.m-family-meta { + font-size: 11px; + color: #9ca3af; +} + +.m-tree-panel { + padding: 16px 18px; +} + +.m-tree-panel .el-tree { + background: transparent; + --el-tree-node-hover-bg-color: #f8fafc; +} + +.m-tree-panel .el-tree-node__content { + height: 32px; + border-radius: 6px; +} + +.m-tree-node { + display: flex; + align-items: center; + gap: 8px; + font-size: 13px; +} + +.m-tree-type { + font-size: 9.5px; + color: #9ca3af; + letter-spacing: 0.06em; + text-transform: uppercase; +} + +.m-tree-root { + font-weight: 700; +} + +.m-tree-branch { + font-weight: 600; + color: #4b5563; +} + +.m-tree-variant { + color: #7c3aed; +} + +.m-tree-group { + color: #0891b2; +} + +.m-two-col { + display: grid; + grid-template-columns: 1.35fr minmax(0, 1fr); + gap: 16px; + align-items: start; +} + +.m-side-stack { + display: flex; + flex-direction: column; + gap: 16px; + min-width: 0; +} + +.m-sense { + padding: 14px 0; + border-bottom: 1px dashed #eef0f3; +} + +.m-sense:first-child { + padding-top: 0; +} + +.m-sense:last-child { + border-bottom: 0; + padding-bottom: 0; +} + +.m-sense-head { + display: flex; + align-items: center; + gap: 10px; + margin-bottom: 10px; +} + +.m-sense-no { + font-size: 11px; + color: #9ca3af; + min-width: 26px; +} + +.m-sense-gloss { + font-size: 13.5px; + font-weight: 600; +} + +.m-group-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(210px, 1fr)); + gap: 10px; +} + +.m-group { + border: 1px solid #eef0f3; + border-radius: 8px; + padding: 10px 12px; + background: #fcfcfd; +} + +.m-group-top { + display: flex; + align-items: center; + justify-content: space-between; + gap: 8px; + margin-bottom: 6px; +} + +.m-group-canon { + font-size: 12px; + color: #6b7280; + margin-bottom: 2px; +} + +.m-group-empty { + font-size: 11.5px; + color: #9ca3af; + padding: 4px 0; +} + +.m-bar-row { + display: grid; + grid-template-columns: 82px minmax(0, 1fr) 54px; + gap: 10px; + align-items: center; + margin-bottom: 9px; +} + +.m-bar-label { + font-size: 11.5px; + color: #6b7280; +} + +.m-bar-track { + display: block; + height: 6px; + background: #eef0f3; + border-radius: 3px; + overflow: hidden; +} + +.m-bar-fill { + display: block; + height: 100%; + background: linear-gradient(90deg, #2563eb, #7c3aed); +} + +.m-bar-value { + text-align: right; + font-size: 11.5px; + color: #6b7280; + font-variant-numeric: tabular-nums; +} + +.m-antonym { + padding: 10px 0; + border-bottom: 1px dashed #eef0f3; +} + +.m-antonym:last-child { + border-bottom: 0; + padding-bottom: 0; +} + +.m-antonym-head { + display: flex; + align-items: center; + gap: 8px; +} + +.m-antonym-word { + margin-left: auto; + color: #111827; +} + +.m-metric-grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); + gap: 12px; +} + +.m-metric { + background: #fff; + border: 1px solid #e8ebf0; + border-radius: 10px; + padding: 14px; +} + +.m-metric-top { + display: flex; + align-items: center; + gap: 8px; + font-size: 12px; + color: #6b7280; +} + +.m-metric-value { + margin-top: 8px; + font-size: 24px; + font-weight: 700; + font-variant-numeric: tabular-nums; +} + +.m-metric-value span { + margin-left: 3px; + font-size: 10px; + color: #9ca3af; + font-weight: 400; +} + +.m-issue { + padding: 12px 0; + border-bottom: 1px dashed #eef0f3; +} + +.m-issue:last-child { + border-bottom: 0; + padding-bottom: 0; +} + +.m-issue-head { + display: flex; + align-items: center; + gap: 8px; + font-size: 13px; + margin-bottom: 6px; +} + +.m-issue-body { + font-size: 12.5px; + color: #4b5563; + line-height: 1.7; +} + +.m-cov { + margin-bottom: 14px; +} + +.m-cov-top { + display: flex; + justify-content: space-between; + gap: 12px; + font-size: 12px; + color: #6b7280; + margin-bottom: 4px; +} + +.m-cov-top b { + color: #374151; + font-variant-numeric: tabular-nums; +} + +.m-cov-track { + display: block; + height: 5px; + background: #eef0f3; + border-radius: 3px; + overflow: hidden; +} + +.m-cov-fill { + display: block; + height: 100%; + background: linear-gradient(90deg, #2563eb, #7c3aed); +} + +.m-cov-note { + margin-top: 3px; + font-size: 11px; + color: #9ca3af; +} + +/* ---------- entry drawer ---------- */ +/* Element Plus 在 modal=false 时仍保留全屏定位层,放行点击到页面,仅抽屉本身可交互 */ +body > div:has(> .entry-drawer) { + pointer-events: none; +} + +.entry-drawer { + pointer-events: auto; +} + +.entry-drawer .el-drawer__body { + padding: 0; + overflow-y: auto; +} + +.entry-drawer .el-drawer__header { + display: none; +} + +.drawer-body { + min-height: 100%; +} + +.drawer-head { + position: relative; + display: flex; + align-items: flex-end; + gap: 22px; + padding: 22px 54px 16px 24px; + border-bottom: 1px solid #eef0f3; +} + +.drawer-title { + margin: 4px 0 8px; + font-size: 28px; + letter-spacing: -0.01em; +} + +.drawer-close { + position: absolute; + top: 16px; + right: 18px; + width: 30px; + height: 30px; + border-radius: 50%; + border: 1px solid #e5e7eb; + background: #fff; + color: #6b7280; + font-size: 18px; + line-height: 1; + cursor: pointer; + display: grid; + place-items: center; +} + +.drawer-close:hover { + background: #f3f4f6; + color: #111827; +} + +.drawer-note { + margin: 12px 24px 0; +} + +.drawer-tabs { + margin: 0; + padding: 0 24px; +} + +.drawer-tab-panel { + padding: 16px 24px 28px; +} + +@media (max-width: 800px) { + .entry-drawer { + width: 92% !important; + } + + .drawer-head { + flex-wrap: wrap; + } + + .drawer-head .m-stat-row { + margin-left: 0; + } +} + +@media (max-width: 1100px) { + .m-two-col { + grid-template-columns: minmax(0, 1fr); + } + + .m-tree-layout { + grid-template-columns: 220px minmax(0, 1fr); + } + + .m-detail-head { + flex-wrap: wrap; + } + + .m-stat-row { + margin-left: 0; + } +} + +@media (max-width: 780px) { + .m-tree-layout { + grid-template-columns: minmax(0, 1fr); + } + + .m-metric-grid { + grid-template-columns: repeat(2, minmax(0, 1fr)); + } +} diff --git a/frontend/prototype/screenshots/book-detail.png b/frontend/prototype/screenshots/book-detail.png new file mode 100644 index 0000000..5ffae6c Binary files /dev/null and b/frontend/prototype/screenshots/book-detail.png differ diff --git a/frontend/prototype/screenshots/books.png b/frontend/prototype/screenshots/books.png new file mode 100644 index 0000000..a4636b0 Binary files /dev/null and b/frontend/prototype/screenshots/books.png differ diff --git a/frontend/prototype/screenshots/entry-detail.png b/frontend/prototype/screenshots/entry-detail.png new file mode 100644 index 0000000..99e8211 Binary files /dev/null and b/frontend/prototype/screenshots/entry-detail.png differ diff --git a/frontend/prototype/screenshots/morphology-tree.png b/frontend/prototype/screenshots/morphology-tree.png new file mode 100644 index 0000000..648ffe4 Binary files /dev/null and b/frontend/prototype/screenshots/morphology-tree.png differ diff --git a/frontend/prototype/screenshots/quality.png b/frontend/prototype/screenshots/quality.png new file mode 100644 index 0000000..d605444 Binary files /dev/null and b/frontend/prototype/screenshots/quality.png differ diff --git a/frontend/prototype/screenshots/synonyms.png b/frontend/prototype/screenshots/synonyms.png new file mode 100644 index 0000000..3404106 Binary files /dev/null and b/frontend/prototype/screenshots/synonyms.png differ diff --git a/frontend/prototype/screenshots/variant-a.png b/frontend/prototype/screenshots/variant-a.png new file mode 100644 index 0000000..d6bc9a7 Binary files /dev/null and b/frontend/prototype/screenshots/variant-a.png differ diff --git a/frontend/prototype/screenshots/variant-b.png b/frontend/prototype/screenshots/variant-b.png new file mode 100644 index 0000000..14f5b6e Binary files /dev/null and b/frontend/prototype/screenshots/variant-b.png differ diff --git a/frontend/prototype/screenshots/variant-c.png b/frontend/prototype/screenshots/variant-c.png new file mode 100644 index 0000000..ec4cc2b Binary files /dev/null and b/frontend/prototype/screenshots/variant-c.png differ diff --git a/frontend/prototype/styles.css b/frontend/prototype/styles.css new file mode 100644 index 0000000..79dd9b8 --- /dev/null +++ b/frontend/prototype/styles.css @@ -0,0 +1,202 @@ +/* PROTOTYPE ONLY — throwaway styling for UI variants. */ +*, *::before, *::after { box-sizing: border-box; } +html, body { margin: 0; padding: 0; } +body { font-family: "PingFang SC", "Microsoft YaHei", "Segoe UI", system-ui, sans-serif; -webkit-font-smoothing: antialiased; } +button { font: inherit; cursor: pointer; } +img { display: block; } + +.proto-badge { + position: fixed; top: 14px; right: 14px; z-index: 1500; + background: #111827; color: #f9fafb; border: 1px solid #374151; + padding: 5px 10px; border-radius: 999px; font-size: 11px; letter-spacing: .08em; + opacity: .82; pointer-events: none; +} + +/* ---------- shared switcher ---------- */ +.proto-switcher { + position: fixed; left: 50%; bottom: 22px; transform: translateX(-50%); + z-index: 9999; display: flex; align-items: center; gap: 10px; + background: #0f172a; color: #e2e8f0; border: 1px solid #334155; + padding: 8px 10px; border-radius: 999px; + box-shadow: 0 10px 30px rgba(2, 6, 23, .45); + font-size: 13px; user-select: none; +} +.proto-switcher button { + width: 30px; height: 30px; border-radius: 50%; + border: 1px solid #475569; background: #1e293b; color: #e2e8f0; + display: grid; place-items: center; font-size: 15px; line-height: 1; +} +.proto-switcher button:hover { background: #334155; } +.proto-switcher .label { min-width: 210px; text-align: center; letter-spacing: .02em; } +.proto-switcher .label b { color: #fff; } +.proto-switcher .hint { color: #94a3b8; font-size: 11px; margin-left: 4px; } + +/* ========================================================= + VARIANT A — 经典后台:白色侧栏 + KPI 卡 + 图表网格 + ========================================================= */ +.a-root { min-height: 100vh; background: #f3f5f8; color: #1f2937; } +.a-shell { display: grid; grid-template-columns: 228px 1fr; min-height: 100vh; } +.a-sidebar { background: #fff; border-right: 1px solid #e5e7eb; padding: 22px 16px; display: flex; flex-direction: column; } +.a-brand { display: flex; align-items: center; gap: 10px; padding: 0 6px 22px; } +.a-brand-mark { width: 34px; height: 34px; border-radius: 9px; background: linear-gradient(135deg, #2563eb, #7c3aed); color: #fff; display: grid; place-items: center; font-weight: 700; } +.a-brand-name { font-size: 15px; font-weight: 700; } +.a-brand-sub { font-size: 11px; color: #9ca3af; } +.a-nav { display: flex; flex-direction: column; gap: 2px; } +.a-nav-item { display: flex; align-items: center; gap: 10px; padding: 9px 10px; border-radius: 8px; color: #4b5563; font-size: 13.5px; cursor: pointer; } +.a-nav-item.active { background: #eef2ff; color: #4338ca; font-weight: 600; } +.a-nav-item .dot { width: 7px; height: 7px; border-radius: 50%; background: currentColor; opacity: .55; } +.a-nav-gap { height: 14px; } +.a-side-foot { margin-top: auto; border-top: 1px solid #eef0f3; padding-top: 14px; font-size: 12px; color: #9ca3af; } +.a-main { padding: 0 26px 90px; } +.a-topbar { height: 62px; display: flex; align-items: center; justify-content: space-between; border-bottom: 1px solid #e5e7eb; margin-bottom: 22px; } +.a-crumb { font-size: 13px; color: #6b7280; } +.a-crumb b { color: #111827; } +.a-top-actions { display: flex; align-items: center; gap: 10px; } +.a-search { width: 240px; height: 34px; border: 1px solid #e5e7eb; background: #fff; border-radius: 8px; padding: 0 12px; font-size: 13px; color: #6b7280; display: flex; align-items: center; } +.a-avatar { width: 32px; height: 32px; border-radius: 50%; background: #e0e7ff; color: #4338ca; display: grid; place-items: center; font-size: 12px; font-weight: 700; } +.a-heading { display: flex; align-items: flex-end; justify-content: space-between; margin-bottom: 18px; } +.a-heading h1 { margin: 0 0 4px; font-size: 22px; letter-spacing: -.01em; } +.a-heading p { margin: 0; font-size: 13px; color: #6b7280; } +.a-kpis { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 12px; margin-bottom: 16px; } +.a-kpi { background: #fff; border: 1px solid #e8ebf0; border-radius: 10px; padding: 14px; position: relative; overflow: hidden; } +.a-kpi::after { content: ""; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; background: var(--tone, #2563eb); } +.a-kpi-label { font-size: 12px; color: #6b7280; } +.a-kpi-value { font-size: 23px; font-weight: 700; margin: 7px 0 3px; font-variant-numeric: tabular-nums; } +.a-kpi-note { font-size: 11px; color: #9ca3af; } +.a-grid { display: grid; grid-template-columns: 1.55fr 1fr; gap: 16px; } +.a-grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-top: 16px; } +.a-panel { background: #fff; border: 1px solid #e8ebf0; border-radius: 10px; padding: 16px 18px; } +.a-panel-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 12px; } +.a-panel-title { font-size: 14px; font-weight: 600; } +.a-panel-sub { font-size: 11.5px; color: #9ca3af; } +.a-chart { height: 300px; width: 100%; } +.a-chart-sm { height: 240px; width: 100%; } +.a-ranking { width: 100%; border-collapse: collapse; font-size: 13px; } +.a-ranking th { text-align: left; font-weight: 500; color: #9ca3af; font-size: 11.5px; padding: 6px 8px; border-bottom: 1px solid #eef0f3; } +.a-ranking td { padding: 8px; border-bottom: 1px solid #f3f4f6; } +.a-ranking tr:last-child td { border-bottom: 0; } +.a-book { display: flex; align-items: center; gap: 10px; } +.a-cover { width: 30px; height: 40px; border-radius: 4px; object-fit: cover; background: #eef2f7; } +.a-cover-ph { width: 30px; height: 40px; border-radius: 4px; background: linear-gradient(135deg, #e5e7eb, #d1d5db); display: grid; place-items: center; font-size: 9px; color: #6b7280; } +.a-mono { font-variant-numeric: tabular-nums; color: #374151; } +.a-quality { display: grid; grid-template-columns: repeat(4, 1fr); gap: 10px; } +.a-q-item { border: 1px solid #eef0f3; border-radius: 8px; padding: 10px 12px; } +.a-q-top { display: flex; align-items: center; gap: 7px; font-size: 12px; color: #6b7280; } +.a-led { width: 8px; height: 8px; border-radius: 50%; } +.a-led.bad { background: #ef4444; box-shadow: 0 0 0 3px #fee2e2; } +.a-led.warn { background: #f59e0b; box-shadow: 0 0 0 3px #fef3c7; } +.a-led.info { background: #3b82f6; box-shadow: 0 0 0 3px #dbeafe; } +.a-q-value { font-size: 18px; font-weight: 700; margin-top: 6px; } +.a-q-value span { font-size: 11px; color: #9ca3af; font-weight: 400; margin-left: 3px; } + +/* ========================================================= + VARIANT B — 指挥中心:深色全宽 + 巨型数字 + 横向条形 + ========================================================= */ +.b-root { min-height: 100vh; background: #080f1e; color: #dbe4f0; font-family: "DIN Alternate", "Bahnschrift", "Segoe UI", sans-serif; } +.b-grid-bg { position: fixed; inset: 0; background-image: linear-gradient(rgba(56,189,248,.045) 1px, transparent 1px), linear-gradient(90deg, rgba(56,189,248,.045) 1px, transparent 1px); background-size: 42px 42px; pointer-events: none; } +.b-shell { position: relative; padding: 0 30px 90px; } +.b-top { height: 66px; display: flex; align-items: center; gap: 26px; border-bottom: 1px solid rgba(148,163,184,.16); } +.b-brand { font-size: 15px; letter-spacing: .16em; color: #7dd3fc; font-weight: 700; white-space: nowrap; } +.b-nav { display: flex; gap: 20px; font-size: 12.5px; color: #64748b; letter-spacing: .04em; } +.b-nav .active { color: #e0f2fe; border-bottom: 2px solid #38bdf8; padding-bottom: 4px; } +.b-top-right { margin-left: auto; display: flex; align-items: center; gap: 14px; font-size: 11px; color: #64748b; letter-spacing: .08em; } +.b-live { display: inline-flex; align-items: center; gap: 6px; color: #4ade80; } +.b-live::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: #4ade80; box-shadow: 0 0 8px #4ade80; } +.b-title-row { display: flex; align-items: baseline; justify-content: space-between; padding: 26px 0 18px; } +.b-title-row h1 { margin: 0; font-size: 24px; letter-spacing: .1em; font-weight: 600; color: #f0f9ff; } +.b-title-row .sub { font-size: 11px; color: #64748b; letter-spacing: .12em; } +.b-kpi-band { display: grid; grid-template-columns: repeat(6, 1fr); border-top: 1px solid rgba(148,163,184,.16); border-bottom: 1px solid rgba(148,163,184,.16); } +.b-kpi { padding: 18px 20px 16px; border-right: 1px solid rgba(148,163,184,.12); } +.b-kpi:last-child { border-right: 0; } +.b-kpi-label { font-size: 10.5px; color: #64748b; letter-spacing: .14em; } +.b-kpi-value { font-size: 38px; font-weight: 700; color: #f8fafc; line-height: 1.12; margin: 8px 0 4px; font-variant-numeric: tabular-nums; } +.b-kpi-note { font-size: 10.5px; color: #475569; letter-spacing: .04em; } +.b-body { display: grid; grid-template-columns: 1.5fr 1fr; gap: 30px; margin-top: 26px; } +.b-section-title { font-size: 11px; color: #7dd3fc; letter-spacing: .18em; margin-bottom: 14px; display: flex; align-items: center; gap: 10px; } +.b-section-title::after { content: ""; flex: 1; height: 1px; background: linear-gradient(90deg, rgba(56,189,248,.35), transparent); } +.b-bars { display: flex; flex-direction: column; gap: 11px; } +.b-bar-row { display: grid; grid-template-columns: 74px 1fr 92px; align-items: center; gap: 12px; font-size: 12.5px; } +.b-bar-name { color: #cbd5e1; } +.b-bar-track { height: 9px; background: rgba(148,163,184,.1); border-radius: 2px; overflow: hidden; } +.b-bar-fill { height: 100%; border-radius: 2px; background: linear-gradient(90deg, #0ea5e9, #38bdf8); } +.b-bar-row.unclassified .b-bar-fill { background: linear-gradient(90deg, #475569, #64748b); } +.b-bar-value { text-align: right; color: #94a3b8; font-variant-numeric: tabular-nums; font-size: 12px; } +.b-bar-value b { color: #e2e8f0; } +.b-chart { height: 230px; } +.b-side { display: flex; flex-direction: column; gap: 26px; } +.b-quality { display: flex; flex-direction: column; } +.b-q-row { display: grid; grid-template-columns: 10px 1fr auto; gap: 10px; align-items: center; padding: 9px 0; border-bottom: 1px dashed rgba(148,163,184,.14); font-size: 12.5px; } +.b-q-row:last-child { border-bottom: 0; } +.b-q-led { width: 7px; height: 7px; border-radius: 50%; } +.b-q-led.bad { background: #f87171; box-shadow: 0 0 7px #f87171; } +.b-q-led.warn { background: #fbbf24; box-shadow: 0 0 7px #fbbf24; } +.b-q-led.info { background: #60a5fa; box-shadow: 0 0 7px #60a5fa; } +.b-q-label { color: #94a3b8; } +.b-q-value { color: #f1f5f9; font-variant-numeric: tabular-nums; font-size: 15px; } +.b-coverage { display: flex; flex-direction: column; gap: 13px; } +.b-cov-row { font-size: 12px; } +.b-cov-top { display: flex; justify-content: space-between; color: #94a3b8; margin-bottom: 5px; } +.b-cov-top b { color: #e2e8f0; font-variant-numeric: tabular-nums; } +.b-cov-track { height: 4px; background: rgba(148,163,184,.12); } +.b-cov-fill { height: 100%; background: linear-gradient(90deg, #22d3ee, #818cf8); } +.b-rank { display: flex; flex-direction: column; } +.b-rank-row { display: grid; grid-template-columns: 26px 1fr 88px 74px; gap: 10px; align-items: center; padding: 8px 0; border-bottom: 1px solid rgba(148,163,184,.08); font-size: 12px; } +.b-rank-no { color: #38bdf8; font-variant-numeric: tabular-nums; } +.b-rank-name { color: #cbd5e1; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } +.b-rank-actual { text-align: right; color: #f8fafc; font-variant-numeric: tabular-nums; } +.b-rank-diff { text-align: right; color: #64748b; font-size: 11px; } + +/* ========================================================= + VARIANT C — 编辑部:纸面 + 编号目录 + 编辑式排版 + ========================================================= */ +.c-root { min-height: 100vh; background: #f7f3ea; color: #26221c; font-family: "Songti SC", "Noto Serif SC", Georgia, serif; } +.c-shell { display: grid; grid-template-columns: 74px minmax(0, 1fr); max-width: 1240px; margin: 0 auto; padding: 0 28px 100px; } +.c-rail { padding-top: 46px; position: sticky; top: 0; align-self: start; display: flex; flex-direction: column; gap: 18px; align-items: center; } +.c-rail-num { width: 30px; height: 30px; border: 1px solid #d6cdbb; border-radius: 50%; display: grid; place-items: center; font-size: 11px; color: #8a8172; font-family: "Segoe UI", sans-serif; } +.c-rail-num.active { background: #26221c; color: #f7f3ea; border-color: #26221c; } +.c-main { padding-top: 44px; min-width: 0; } +.c-masthead { display: flex; align-items: flex-end; justify-content: space-between; border-bottom: 2px solid #26221c; padding-bottom: 14px; } +.c-masthead h1 { margin: 0; font-size: 34px; font-weight: 600; letter-spacing: .02em; } +.c-masthead .kicker { font-family: "Segoe UI", sans-serif; font-size: 10.5px; letter-spacing: .22em; color: #8a8172; text-transform: uppercase; margin-bottom: 8px; } +.c-masthead .date { font-family: "Segoe UI", sans-serif; font-size: 11.5px; color: #8a8172; text-align: right; line-height: 1.7; } +.c-lede { max-width: 780px; font-size: 15px; line-height: 1.85; color: #4a443a; margin: 24px 0 34px; } +.c-lede b { color: #26221c; } +.c-section { padding: 22px 0; border-top: 1px solid #d9d1c1; } +.c-section-head { display: flex; align-items: baseline; justify-content: space-between; margin-bottom: 18px; } +.c-section-head h2 { margin: 0; font-size: 19px; font-weight: 600; } +.c-section-head h2 span { font-family: "Segoe UI", sans-serif; font-size: 11px; color: #9a917f; letter-spacing: .1em; margin-right: 10px; } +.c-section-head .aside { font-family: "Segoe UI", sans-serif; font-size: 11px; color: #9a917f; } +.c-stats { display: grid; grid-template-columns: repeat(6, 1fr); gap: 0; border-top: 1px solid #d9d1c1; } +.c-stat { padding: 16px 14px 16px 0; border-right: 1px solid #e2dacb; } +.c-stat:last-child { border-right: 0; } +.c-stat .n { font-size: 30px; font-weight: 600; line-height: 1.1; font-variant-numeric: tabular-nums; } +.c-stat .l { font-family: "Segoe UI", sans-serif; font-size: 11px; color: #8a8172; margin-top: 6px; letter-spacing: .04em; } +.c-cols { display: grid; grid-template-columns: 1.35fr 1fr; gap: 44px; } +.c-chart { height: 270px; } +.c-list { margin: 0; padding: 0; list-style: none; counter-reset: item; } +.c-list li { counter-increment: item; display: grid; grid-template-columns: 26px 34px 1fr auto; gap: 12px; align-items: center; padding: 9px 0; border-bottom: 1px dotted #d9d1c1; font-family: "Segoe UI", sans-serif; font-size: 12.5px; } +.c-list li::before { content: counter(item, decimal-leading-zero); color: #9a917f; font-size: 10.5px; } +.c-list .thumb { width: 26px; height: 34px; border-radius: 2px; object-fit: cover; background: #e6dece; } +.c-list .title { color: #33302a; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } +.c-list .num { color: #6e6556; font-variant-numeric: tabular-nums; } +.c-quality-cols { column-count: 2; column-gap: 40px; } +.c-q { break-inside: avoid; display: grid; grid-template-columns: 1fr auto; gap: 10px; padding: 10px 0; border-bottom: 1px dotted #d9d1c1; font-family: "Segoe UI", sans-serif; font-size: 12.5px; } +.c-q .k { color: #5d5547; } +.c-q .v { font-weight: 700; font-variant-numeric: tabular-nums; } +.c-q .v.bad { color: #a33a2b; } +.c-q .v.warn { color: #9a6a12; } +.c-q .v.info { color: #3d6b8a; } +.c-cov { display: flex; flex-direction: column; gap: 12px; margin-top: 6px; } +.c-cov-row { font-family: "Segoe UI", sans-serif; font-size: 12px; display: grid; grid-template-columns: 82px 1fr 72px; gap: 12px; align-items: center; } +.c-cov-track { display: block; height: 2px; background: #ded5c5; position: relative; } +.c-cov-fill { position: absolute; inset: 0 auto 0 0; background: #26221c; } +.c-cov-val { text-align: right; color: #5d5547; font-variant-numeric: tabular-nums; } +.c-footnote { margin-top: 26px; padding-top: 14px; border-top: 1px solid #d9d1c1; font-family: "Segoe UI", sans-serif; font-size: 11px; color: #9a917f; line-height: 1.8; } + +@media (max-width: 1180px) { + .a-kpis { grid-template-columns: repeat(3, 1fr); } + .b-kpi-band { grid-template-columns: repeat(3, 1fr); } + .b-kpi:nth-child(3n) { border-right: 0; } + .c-stats { grid-template-columns: repeat(3, 1fr); } + .c-stat:nth-child(3n) { border-right: 0; } +} diff --git a/frontend/prototype/variant-a.js b/frontend/prototype/variant-a.js new file mode 100644 index 0000000..381b8c1 --- /dev/null +++ b/frontend/prototype/variant-a.js @@ -0,0 +1,194 @@ +// PROTOTYPE ONLY — Variant A: classic admin (white sidebar, KPI cards, chart grid). +(function () { + const { ref, onMounted, onBeforeUnmount, nextTick } = Vue; + const D = window.DASHBOARD_DATA; + const PH = 'data:image/svg+xml;utf8,' + encodeURIComponent( + 'N/A' + ); + const fmt = (n) => n.toLocaleString('en-US'); + const short = (n) => n >= 10000 ? (n / 1000).toFixed(1) + 'k' : String(n); + const tone = { blue: '#2563eb', green: '#16a34a', violet: '#7c3aed', amber: '#d97706', cyan: '#0891b2', rose: '#e11d48' }; + + window.VariantA = { + name: 'VariantA — 经典后台', + setup() { + const examEl = ref(null); + const posEl = ref(null); + let charts = []; + const resize = () => charts.forEach((c) => c.resize()); + + onMounted(async () => { + await nextTick(); + const exam = echarts.init(examEl.value); + const rows = D.exams; + exam.setOption({ + grid: { left: 8, right: 54, top: 6, bottom: 6, containLabel: true }, + tooltip: { + trigger: 'axis', axisPointer: { type: 'shadow' }, + formatter: (p) => { + const r = rows[rows.length - 1 - p[0].dataIndex]; + return `${r.name}
关联词条 ${fmt(r.entries)}
词书 ${r.books} 本`; + } + }, + xAxis: { type: 'value', splitLine: { lineStyle: { color: '#f1f3f6' } }, axisLabel: { color: '#9ca3af', fontSize: 10, formatter: short } }, + yAxis: { type: 'category', data: rows.map((r) => r.name).reverse(), axisTick: { show: false }, axisLine: { show: false }, axisLabel: { color: '#4b5563', fontSize: 11.5 } }, + series: [{ + type: 'bar', barWidth: 13, + data: rows.map((r) => ({ value: r.entries, itemStyle: { color: r.code === '—' ? '#cbd5e1' : '#3b82f6', borderRadius: [0, 3, 3, 0] } })).reverse(), + label: { show: true, position: 'right', color: '#6b7280', fontSize: 10.5, formatter: (p) => short(p.value) } + }] + }); + + const pos = echarts.init(posEl.value); + pos.setOption({ + tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' }, + legend: { right: 0, top: 'center', orient: 'vertical', itemWidth: 8, itemHeight: 8, textStyle: { color: '#6b7280', fontSize: 11 } }, + series: [{ + type: 'pie', radius: ['46%', '70%'], center: ['34%', '50%'], + itemStyle: { borderColor: '#fff', borderWidth: 2 }, + label: { show: false }, + data: D.pos.map((p, i) => ({ name: p.name, value: p.value, itemStyle: { color: ['#2563eb', '#3b82f6', '#60a5fa', '#93c5fd', '#a5b4fc', '#c7d2fe', '#818cf8', '#6366f1', '#4f46e5', '#cbd5e1'][i] } })) + }] + }); + + charts = [exam, pos]; + window.addEventListener('resize', resize); + }); + + onBeforeUnmount(() => { + window.removeEventListener('resize', resize); + charts.forEach((c) => c.dispose()); + charts = []; + }); + + return { D, fmt, short, tone, PH, examEl, posEl, go }; + + function go(page) { + window.protoNavigate(page); + } + }, + template: ` +
+
+ + +
+
+
后台 / 概览
+
+ +
AD
+
+
+ +
+
+

数据概览

+

四个业务域的整体规模、分布与健康度

+
+
共 36 张表 · 约 364 万行
+
+ +
+
+
{{ k.label }}
+
{{ fmt(k.value) }}
+
{{ k.note }}
+
+
+ +
+
+
+
考试维度 · 关联词条量
+
按 book.exam_id 汇总
+
+
+
+
+
+
词性分布
+
word_sense · Top 10
+
+
+
+
+ +
+
+
+
词书规模排行
+
实际词条数 Top 10
+
+ + + + + + + + + + + +
词书考试实际声明差异
+
+ +
+
{{ b.name }}
+
{{ b.code }}
+
+
+
{{ b.exam }}{{ fmt(b.actual) }}{{ fmt(b.declared) }}{{ b.actual === b.declared ? '一致' : (b.actual - b.declared) }}
+
+ +
+
+
+
质量红绿灯
+
点击进入数据质量
+
+
+
+ + {{ q.label }} + {{ fmt(q.value) }} {{ q.unit }} +
+
+
+
+
+
跨域文本覆盖度
+
与词条索引词交集
+
+
+
+ {{ c.name }}{{ c.pct }}% · {{ fmt(c.hit) }}/{{ fmt(c.total) }} +
+
+
+
+
+
+
+
+
+
+
` + }; +})(); diff --git a/frontend/prototype/variant-b.js b/frontend/prototype/variant-b.js new file mode 100644 index 0000000..8cdbd01 --- /dev/null +++ b/frontend/prototype/variant-b.js @@ -0,0 +1,121 @@ +// PROTOTYPE ONLY — Variant B: dark operations console (full-width bands, dense data, no cards). +(function () { + const D = window.DASHBOARD_DATA; + const fmt = (n) => n.toLocaleString('en-US'); + const short = (n) => n >= 10000 ? (n / 1000).toFixed(1) + 'k' : String(n); + const maxEntries = Math.max(...D.exams.map((e) => e.entries)); + const maxPos = Math.max(...D.pos.map((p) => p.value)); + + window.VariantB = { + name: 'VariantB — 指挥中心', + setup() { + return { D, fmt, short, maxEntries, maxPos }; + }, + template: ` +
+
+
+
+
WORD · MARKET
+ +
+ SYNCED + SNAPSHOT 2026-11-08 +
+
+ +
+

词库运行概览

+
36 TABLES / 3.64M ROWS / READ-ONLY
+
+ +
+
+
{{ k.label }}
+
{{ fmt(k.value) }}
+
{{ k.note }}
+
+
+ +
+
+
考试维度 / 关联词条量
+
+
+
{{ e.name }}
+
+
{{ short(e.entries) }} / {{ e.books }}本
+
+
+ +
词书规模 / TOP 10
+
+
+
{{ String(i + 1).padStart(2, '0') }}
+
{{ b.name }}
+
{{ fmt(b.actual) }}
+
{{ b.actual === b.declared ? 'MATCH' : 'Δ ' + (b.actual - b.declared) }}
+
+
+ +
词性分布 / WORD SENSE
+
+
+
{{ short(p.value) }}
+
+
{{ p.name }}
+
+
+
+ +
+
+
质量状态 / DATA HEALTH
+
+
+ + {{ q.label }} + {{ fmt(q.value) }} {{ q.unit }} +
+
+
+ +
+
跨域覆盖 / WEAK LINK
+
+
+
{{ c.name }}{{ c.pct }}% · {{ fmt(c.hit) }}/{{ fmt(c.total) }}
+
+
+
+
+ +
+
数据快照 / SNAPSHOT
+
+
+
EXAM VIEWS
+
16
+
+
+
TOP FAMILIES
+
5,629
+
+
+
SENTENCES
+
235,744
+
+
+
CONFUSABLES
+
158,870
+
+
+
+
+
+
+
` + }; +})(); diff --git a/frontend/prototype/variant-c.js b/frontend/prototype/variant-c.js new file mode 100644 index 0000000..1c6cd95 --- /dev/null +++ b/frontend/prototype/variant-c.js @@ -0,0 +1,169 @@ +// PROTOTYPE ONLY — Variant C: editorial paper layout (numbered rail, prose, lists instead of cards). +(function () { + const { ref, onMounted, onBeforeUnmount, nextTick } = Vue; + const D = window.DASHBOARD_DATA; + const PH = 'data:image/svg+xml;utf8,' + encodeURIComponent( + 'N/A' + ); + const fmt = (n) => n.toLocaleString('en-US'); + const maxPos = Math.max(...D.pos.map((p) => p.value)); + const maxEntries = Math.max(...D.exams.map((e) => e.entries)); + + window.VariantC = { + name: 'VariantC — 编辑部', + setup() { + const examEl = ref(null); + let chart = null; + const resize = () => chart && chart.resize(); + + onMounted(async () => { + await nextTick(); + chart = echarts.init(examEl.value); + const rows = D.exams; + chart.setOption({ + grid: { left: 6, right: 46, top: 8, bottom: 4, containLabel: true }, + tooltip: { + trigger: 'axis', axisPointer: { type: 'shadow' }, + backgroundColor: '#26221c', borderWidth: 0, + textStyle: { color: '#f7f3ea', fontSize: 12 }, + formatter: (p) => { + const r = rows[rows.length - 1 - p[0].dataIndex]; + return `${r.name} 关联 ${fmt(r.entries)} 词书 ${r.books} 本`; + } + }, + xAxis: { type: 'value', splitLine: { show: false }, axisLabel: { show: false }, axisLine: { show: false }, axisTick: { show: false } }, + yAxis: { type: 'category', data: rows.map((r) => r.name).reverse(), axisLine: { show: false }, axisTick: { show: false }, axisLabel: { color: '#4a443a', fontSize: 11.5, fontFamily: 'Segoe UI' } }, + series: [{ + type: 'bar', barWidth: 9, + data: rows.map((r) => ({ value: r.entries, itemStyle: { color: r.code === '—' ? '#b9ae9a' : '#26221c' } })).reverse(), + label: { show: true, position: 'right', color: '#6e6556', fontSize: 10.5, fontFamily: 'Segoe UI', formatter: (p) => fmt(p.value) } + }] + }); + window.addEventListener('resize', resize); + }); + + onBeforeUnmount(() => { + window.removeEventListener('resize', resize); + if (chart) chart.dispose(); + chart = null; + }); + + return { D, fmt, PH, examEl, maxPos, maxEntries }; + }, + template: ` +
+
+ + +
+
+
+
Word Market · Data Report
+

词库概览

+
+
2026 年 11 月 8 日
只读快照 · 36 张表
+
+ +

+ 当前词库收录 1,025 本词书、38,116 个词条,词书与词条之间形成 + 1,228,421 条关联;配套沉淀了 235,744 条例句、22,717 个词族与 6,279 个近义词头。 + 四个业务域之间以单词文本弱关联,覆盖度存在差异,阅读时应把“未归类”与弱关联一并考虑。 +

+ +
+
+

01规模

+
SNAPSHOT · 2026-11-08
+
+
+
+
{{ fmt(k.value) }}
+
{{ k.label }}
+
+
+
+ +
+
+

02分布

+
按考试关联词条量 / 词性义项数
+
+
+
+
+
+
+
+ {{ p.name }} + + {{ fmt(p.value) }} +
+
+ 名词义项占绝对多数;短语类(phr.)义项 6,922 条,提示词条中存在大量短语条目。 +
+
+
+
+ +
+
+

03词书排行

+
实际词条数 TOP 10
+
+
+
    +
  1. + + {{ b.name }} + {{ fmt(b.actual) }} +
  2. +
+
    +
  1. + + {{ b.name }} + {{ fmt(b.actual) }} +
  2. +
+
+
+ +
+
+

04质量注脚

+
异常项与弱关联覆盖度
+
+
+
+
+ {{ q.label }} + {{ fmt(q.value) }} {{ q.unit }} +
+
+
+
CROSS-DOMAIN COVERAGE
+
+
+ {{ c.name }} + + {{ c.pct }}% +
+
+
+
+
+ +
+ 口径说明:考试维度按 book.exam_id 汇总,未设置考试的词书单列为“未归类”;跨域覆盖度以词条索引词(index_word)为基准,属于文本弱关联,不作为外键约束。
+ 数据来源:MySQL word_market · 只读快照。 +
+
+
+
` + }; +})(); diff --git a/frontend/prototype/view-books.js b/frontend/prototype/view-books.js new file mode 100644 index 0000000..dd2e7c9 --- /dev/null +++ b/frontend/prototype/view-books.js @@ -0,0 +1,153 @@ +// PROTOTYPE ONLY — 词书列表与详情。 +(function () { + const D = window.MODULE_DATA; + const PH = 'data:image/svg+xml;utf8,' + encodeURIComponent( + 'N/A' + ); + const fmt = (n) => n.toLocaleString('en-US'); + + window.ViewBooks = { + name: 'ViewBooks', + props: { id: String, kw: String }, + setup(props) { + const { ref, computed } = Vue; + const keyword = ref(props.kw || ''); + const exam = ref('全部'); + const file = ref('全部'); + + const exams = computed(() => ['全部', ...new Set(D.books.map((b) => b.exam))]); + const filtered = computed(() => D.books.filter((b) => { + const kw = keyword.value.trim().toLowerCase(); + const matchKw = !kw || b.name.toLowerCase().includes(kw) || b.code.toLowerCase().includes(kw); + const matchExam = exam.value === '全部' || b.exam === exam.value; + const matchFile = file.value === '全部' + || (file.value === '有文件' && b.hasFile) + || (file.value === '无文件' && !b.hasFile); + return matchKw && matchExam && matchFile; + })); + const selected = computed(() => D.books.find((b) => String(b.id) === props.id) || null); + + function openBook(id) { window.protoNavigate('books', id); } + function openEntry() { window.protoNavigate('entries', 26132); } + function back() { window.protoNavigate('books'); } + function cover(path) { return path ? 'https://static.beingfine.cn' + path : PH; } + + return { D, PH, fmt, keyword, exam, file, exams, filtered, selected, openBook, openEntry, back, cover }; + }, + template: ` + + + + +` + }; +})(); diff --git a/frontend/prototype/view-entries.js b/frontend/prototype/view-entries.js new file mode 100644 index 0000000..b29ea23 --- /dev/null +++ b/frontend/prototype/view-entries.js @@ -0,0 +1,195 @@ +// PROTOTYPE ONLY — 词条列表;详情以右侧抽屉展示。 +(function () { + const D = window.MODULE_DATA; + const fmt = (n) => n.toLocaleString('en-US'); + + window.ViewEntries = { + name: 'ViewEntries', + props: { id: String, kw: String }, + setup(props) { + const { ref, computed, watch } = Vue; + const keyword = ref(''); + const tab = ref('senses'); + const drawerOpen = ref(!!props.id); + + const filtered = computed(() => { + const kw = keyword.value.trim().toLowerCase(); + if (!kw) return D.entries; + return D.entries.filter((e) => e.headword.toLowerCase().includes(kw) || e.definition.toLowerCase().includes(kw)); + }); + const selected = computed(() => D.entries.find((e) => String(e.id) === props.id) || null); + const rich = computed(() => !!selected.value && String(selected.value.id) === String(D.entryDetail.id)); + + watch(() => props.id, () => { + drawerOpen.value = !!selected.value; + tab.value = 'senses'; + }); + + function openEntry(id) { window.protoNavigate('entries', id); } + function closeDrawer() { drawerOpen.value = false; } + function handleDrawerClose() { + const page = new URLSearchParams(location.search).get('page'); + if (props.id && page === 'entries') window.protoNavigate('entries'); + } + function setTab(name) { tab.value = name; } + + return { + D, fmt, keyword, tab, drawerOpen, filtered, selected, rich, + openEntry, closeDrawer, handleDrawerClose, setTab + }; + }, + template: ` + +
+
+

词条词典

+

搜索词条,点击行内“查看”在右侧抽屉中展开详情

+
+
38,116 个词条 · 5,250 条无结构化义项
+
+ +
+
+ + +
+
仅展示 10 条样本 · cinema 含完整详情
+
+ +
+ + + + + + + + + + + + + + +
词条释义义项收录词书操作
+
{{ e.headword }}
+
{{ e.pronunciation || '—' }}
+
{{ e.definition }}{{ e.senses }}{{ e.occurrence }}查看
没有匹配的词条
+
+ + +
+
+
+
{{ selected.indexWord }}
+

{{ selected.headword }}

+
+ {{ selected.pronunciation || '无音标' }} + {{ selected.definition }} +
+
+
+
{{ fmt(selected.occurrence) }}收录词书
+
{{ selected.senses }}结构化义项
+
{{ rich ? 6 : 0 }}例句(样本)
+
+ +
+ +
+ 原型仅展开 cinema(entry_id=26132)的完整子资源;当前词条展示基本信息与空状态。 +
+ +
+
义项
+
短语
+
例句
+
易混词
+
收录词书
+
+ +
+ + + + + + + + + +
+
+
+
` + }; +})(); diff --git a/frontend/prototype/view-morphology.js b/frontend/prototype/view-morphology.js new file mode 100644 index 0000000..ac341dc --- /dev/null +++ b/frontend/prototype/view-morphology.js @@ -0,0 +1,154 @@ +// PROTOTYPE ONLY — 词根词缀与词族,含树形族谱。 +(function () { + const D = window.MODULE_DATA; + + window.ViewMorphology = { + name: 'ViewMorphology', + props: { id: String, kw: String }, + setup() { + const { ref, computed } = Vue; + const tab = ref('morphemes'); + const morphemeType = ref('all'); + const selectedFamily = ref(D.families.find((f) => f.word === 'behave') || D.families[0]); + + const typeLabel = (t) => ({ prefix: '前缀', root: '词根', suffix: '后缀' }[t] || t); + const filteredMorphemes = computed(() => ( + morphemeType.value === 'all' + ? D.morphemes + : D.morphemes.filter((m) => m.type === morphemeType.value) + )); + + const treeData = computed(() => [{ + label: `${D.familyTree.word} · ${D.familyTree.interpretation}`, + type: 'root', + children: [ + { + label: `变体 · ${D.familyTree.variants.length}`, + type: 'branch', + children: D.familyTree.variants.map((word) => ({ label: word, type: 'variant' })) + }, + { + label: `小组 · ${D.familyTree.groups.length}`, + type: 'branch', + children: D.familyTree.groups.map((group) => ({ + label: group.join(' / '), + type: 'group', + children: group.map((word) => ({ label: word, type: 'member' })) + })) + } + ] + }]); + const treeProps = { children: 'children', label: 'label' }; + + function setTab(name) { tab.value = name; } + function setType(type) { morphemeType.value = type; } + function selectFamily(family) { selectedFamily.value = family; } + function openTree(family) { + selectedFamily.value = family; + tab.value = 'tree'; + } + + return { + D, tab, morphemeType, selectedFamily, typeLabel, filteredMorphemes, + treeData, treeProps, setTab, setType, selectFamily, openTree + }; + }, + template: ` + +
+
+

词根词族

+

词素、单词卡片与词族层级关系,支持树形族谱

+
+
2,235 个词素 · 12,003 张卡片 · 22,717 个词族
+
+ +
+
词素
+
单词卡片
+
词族
+
树形族谱
+
+ +
+
+ 全部 + 前缀 + 词根 + 后缀 +
+ + + + + + + + + + + +
类型词形英文释义中文释义备注
{{ typeLabel(m.type) }}{{ m.form }}{{ m.meaningEn || '—' }}{{ m.meaningZh || '—' }}{{ m.note || '—' }}
+
+ +
+
+
{{ c.word }}
+
{{ c.memory }}
+
{{ c.example }}
+
+
+ +
+ + + + + + + + + + +
词族释义成员数操作
{{ f.word }}{{ f.interpretation }}{{ f.members }}查看族谱
+
+ +
+
+
顶层词族
5,629 个
+
+
{{ f.word }}
+
{{ f.members }} 个成员
+
+
+ +
+
+
{{ selectedFamily.word }} · 族谱
+
变体 + 小组 + 成员
+
+ +
该词族的族谱在原型中未展开,仅 behave 提供完整示例。
+
+
+
` + }; +})(); diff --git a/frontend/prototype/view-quality.js b/frontend/prototype/view-quality.js new file mode 100644 index 0000000..b00534c --- /dev/null +++ b/frontend/prototype/view-quality.js @@ -0,0 +1,124 @@ +// PROTOTYPE ONLY — 数据质量摘要、差异明细与覆盖度。 +(function () { + const D = window.MODULE_DATA; + const fmt = (n) => n.toLocaleString('en-US'); + + window.ViewQuality = { + name: 'ViewQuality', + props: { id: String, kw: String }, + setup() { + const { ref, computed } = Vue; + const keyword = ref(''); + const mismatch = computed(() => { + const kw = keyword.value.trim().toLowerCase(); + if (!kw) return D.quality.mismatch; + return D.quality.mismatch.filter((b) => b.name.toLowerCase().includes(kw) || b.code.toLowerCase().includes(kw)); + }); + return { D, fmt, keyword, mismatch }; + }, + template: ` + +
+
+

数据质量

+

汇总异常指标,定位声明不符、缺失引用与跨域弱关联

+
+
只读快照 · 2026-11-08
+
+ +
+
+
+ + {{ q.label }} +
+
{{ fmt(q.value) }}{{ q.unit }}
+
+
+ +
+
+
声明与实际词条数差异
+
{{ D.quality.mismatch.length }} 本词书不一致
+
+
+
+ + +
+
+ + + + + + + + + + + + +
词书编码声明实际差异
{{ b.name }}{{ b.code }}{{ fmt(b.declared) }}{{ fmt(b.actual) }} + {{ b.actual - b.declared > 0 ? '+' : '' }}{{ b.actual - b.declared }} +
没有匹配的词书
+
+ +
+
+
缺失引用与文件
需人工核查
+ +
+
+ + 缺失词书清单文件 + {{ D.quality.missingFile.length }} 本 +
+
+ {{ b.name }}({{ b.code }}) +
+
+ +
+
+ + 缺失 zpk 引用 + 1 个 +
+
源文件引用的 zpk 在解密目录中缺失,无法定位到具体词条。
+
+ +
+
+ + 无义项的近义词头 + {{ D.quality.synNoSense.length }} 个 +
+
+ {{ w }} +
+
+
+ +
+
跨域文本覆盖度
与词条索引词交集
+
+
+ {{ c.name }} + {{ c.pct }}% · {{ fmt(c.hit) }}/{{ fmt(c.total) }} +
+
+
未覆盖 {{ fmt(c.total - c.hit) }} 个
+
+
+ 跨域关联基于单词文本(归一化小写),不是数据库外键;词族覆盖度明显低于其他两域。 +
+
+
+ +
+ 口径说明:声明与实际差异按 book.declared_entry_count 与 book_entry 实际行数比较;“未设置考试”单列为“未归类”,不计入异常;无结构化义项指 word_entry 在 word_sense 中没有任何记录。 +
+
` + }; +})(); diff --git a/frontend/prototype/view-synonyms.js b/frontend/prototype/view-synonyms.js new file mode 100644 index 0000000..5271321 --- /dev/null +++ b/frontend/prototype/view-synonyms.js @@ -0,0 +1,153 @@ +// PROTOTYPE ONLY — 近义词头、义项、分考试近义组与反义词。 +(function () { + const D = window.MODULE_DATA; + + window.ViewSynonyms = { + name: 'ViewSynonyms', + props: { id: String, kw: String }, + setup(props) { + const { ref, computed } = Vue; + const keyword = ref(''); + const selected = computed(() => D.synonyms.find((s) => String(s.id) === props.id) || null); + const rich = computed(() => !!selected.value && selected.value.id === D.synonymDetail.id); + const filtered = computed(() => { + const kw = keyword.value.trim().toLowerCase(); + return kw ? D.synonyms.filter((s) => s.word.toLowerCase().includes(kw)) : D.synonyms; + }); + + const groupsFor = (senseId) => D.synonymDetail.groups.filter((g) => g.senseId === senseId); + const membersFor = (group) => { + const found = D.synonymDetail.members.find((m) => m.senseId === group.senseId && m.exam === group.exam); + return found ? found.words : []; + }; + const dist = computed(() => { + const buckets = {}; + D.synonymDetail.groups.forEach((g) => { buckets[g.count] = (buckets[g.count] || 0) + 1; }); + const keys = Object.keys(buckets).map(Number).sort((a, b) => a - b); + const max = Math.max(...Object.values(buckets), 1); + return keys.map((k) => ({ label: `${k} 个成员`, count: buckets[k], pct: Math.round((buckets[k] / max) * 100) })); + }); + + function openWord(id) { window.protoNavigate('synonyms', id); } + function back() { window.protoNavigate('synonyms'); } + + return { D, keyword, filtered, selected, rich, groupsFor, membersFor, dist, openWord, back }; + }, + template: ` + + + + +` + }; +})(); diff --git a/frontend/src/App.vue b/frontend/src/App.vue new file mode 100644 index 0000000..98240ae --- /dev/null +++ b/frontend/src/App.vue @@ -0,0 +1,3 @@ + diff --git a/frontend/src/api/auth.ts b/frontend/src/api/auth.ts new file mode 100644 index 0000000..49f16e6 --- /dev/null +++ b/frontend/src/api/auth.ts @@ -0,0 +1,7 @@ +import http from './http' +import type { ApiResponse, LoginResponse } from './types' + +export async function login(username: string, password: string): Promise { + const { data } = await http.post>('/auth/login', { username, password }) + return data.data +} diff --git a/frontend/src/api/books.ts b/frontend/src/api/books.ts new file mode 100644 index 0000000..ded2bd2 --- /dev/null +++ b/frontend/src/api/books.ts @@ -0,0 +1,49 @@ +import http from './http' +import type { + ApiResponse, + BookDetail, + BookEntryItem, + BookListItem, + ExamOption, + Items, + PageResult +} from './types' + +export interface BookQuery { + page?: number + size?: number + examId?: string | null + keyword?: string + hasFile?: boolean | null +} + +export interface BookEntryQuery { + page?: number + size?: number + keyword?: string +} + +export async function getBooks(params: BookQuery): Promise> { + const { data } = await http.get>>('/books', { params }) + return data.data +} + +export async function getBook(id: string): Promise { + const { data } = await http.get>(`/books/${id}`) + return data.data +} + +export async function getBookEntries( + id: string, + params: BookEntryQuery +): Promise> { + const { data } = await http.get>>(`/books/${id}/entries`, { + params + }) + return data.data +} + +export async function getExams(): Promise { + const { data } = await http.get>>('/exams') + return data.data.items +} diff --git a/frontend/src/api/dashboard.ts b/frontend/src/api/dashboard.ts new file mode 100644 index 0000000..d0b128c --- /dev/null +++ b/frontend/src/api/dashboard.ts @@ -0,0 +1,61 @@ +import http from './http' +import type { + ApiResponse, + DashboardSummary, + ExamStat, + Items, + PosStat, + TopBook +} from './types' +import { + mockCoverage, + mockExams, + mockKpis, + mockPos, + mockQuality, + mockTopBooks +} from '@/mocks/dashboard' + +const useMock = import.meta.env.VITE_USE_MOCK === 'true' + +function delay(data: T): Promise { + return new Promise((resolve) => setTimeout(() => resolve(data), 220)) +} + +function refreshParams(refresh: boolean) { + return refresh ? { refresh: true } : undefined +} + +export async function getDashboardSummary(refresh = false): Promise { + if (useMock) { + return delay({ kpis: mockKpis, quality: mockQuality, coverage: mockCoverage }) + } + const { data } = await http.get>('/dashboard/summary', { + params: refreshParams(refresh) + }) + return data.data +} + +export async function getExamDistribution(refresh = false): Promise { + if (useMock) return delay(mockExams) + const { data } = await http.get>>('/dashboard/exam-distribution', { + params: refreshParams(refresh) + }) + return data.data.items +} + +export async function getTopBooks(refresh = false): Promise { + if (useMock) return delay(mockTopBooks) + const { data } = await http.get>>('/dashboard/book-size-top', { + params: refreshParams(refresh) + }) + return data.data.items +} + +export async function getPosDistribution(refresh = false): Promise { + if (useMock) return delay(mockPos) + const { data } = await http.get>>('/dashboard/pos-distribution', { + params: refreshParams(refresh) + }) + return data.data.items +} diff --git a/frontend/src/api/entries.ts b/frontend/src/api/entries.ts new file mode 100644 index 0000000..80b111a --- /dev/null +++ b/frontend/src/api/entries.ts @@ -0,0 +1,78 @@ +import http from './http' +import type { + ApiResponse, + ConfusableItem, + EntryBookItem, + EntryDetail, + EntryListItem, + ExampleGroupItem, + Items, + PageResult, + PhraseItem, + SenseItem, + SpellingVariantItem +} from './types' + +export interface EntryQuery { + page?: number + size?: number + keyword?: string +} + +export async function getEntries(params: EntryQuery): Promise> { + const { data } = await http.get>>('/entries', { params }) + return data.data +} + +export async function getEntry(id: string): Promise { + const { data } = await http.get>(`/entries/${id}`) + return data.data +} + +export async function getEntrySenses(id: string): Promise { + const { data } = await http.get>>(`/entries/${id}/senses`) + return data.data.items +} + +export async function getEntryPhrases( + id: string, + page: number, + size: number +): Promise> { + const { data } = await http.get>>(`/entries/${id}/phrases`, { + params: { page, size } + }) + return data.data +} + +export async function getEntryExamples( + id: string, + page: number, + size: number +): Promise> { + const { data } = await http.get>>(`/entries/${id}/examples`, { + params: { page, size } + }) + return data.data +} + +export async function getEntryConfusables(id: string): Promise { + const { data } = await http.get>>(`/entries/${id}/confusables`) + return data.data.items +} + +export async function getEntryVariants(id: string): Promise { + const { data } = await http.get>>(`/entries/${id}/variants`) + return data.data.items +} + +export async function getEntryBooks( + id: string, + page: number, + size: number +): Promise> { + const { data } = await http.get>>(`/entries/${id}/books`, { + params: { page, size } + }) + return data.data +} diff --git a/frontend/src/api/http.ts b/frontend/src/api/http.ts new file mode 100644 index 0000000..539b00c --- /dev/null +++ b/frontend/src/api/http.ts @@ -0,0 +1,35 @@ +import axios from 'axios' +import { clearAuthStorage, TOKEN_KEY } from '@/utils/storage' + +const http = axios.create({ + baseURL: import.meta.env.VITE_API_BASE_URL ?? '/api', + timeout: 20000 +}) + +http.interceptors.request.use((config) => { + const token = localStorage.getItem(TOKEN_KEY) + if (token) { + config.headers.Authorization = `Bearer ${token}` + } + return config +}) + +http.interceptors.response.use( + (response) => response, + (error) => { + const status = error.response?.status + const url: string = error.config?.url ?? '' + const message: string = + error.response?.data?.message ?? error.message ?? '请求失败' + if (status === 401 && !url.includes('/auth/login')) { + clearAuthStorage() + if (window.location.pathname !== '/login') { + const redirect = encodeURIComponent(window.location.pathname + window.location.search) + window.location.assign(`/login?redirect=${redirect}`) + } + } + return Promise.reject(new Error(message)) + } +) + +export default http diff --git a/frontend/src/api/morphology.ts b/frontend/src/api/morphology.ts new file mode 100644 index 0000000..0e3dff1 --- /dev/null +++ b/frontend/src/api/morphology.ts @@ -0,0 +1,62 @@ +import http from './http' +import type { + ApiResponse, + CardDetail, + CardItem, + FamilyDetail, + FamilyItem, + MorphemeDetail, + MorphemeItem, + PageResult, + TreePage +} from './types' + +export interface PagedQuery { + page?: number + size?: number + keyword?: string +} + +export async function getMorphemes( + params: PagedQuery & { type?: string } +): Promise> { + const { data } = await http.get>>('/morphemes', { params }) + return data.data +} + +export async function getMorpheme(id: string): Promise { + const { data } = await http.get>(`/morphemes/${id}`) + return data.data +} + +export async function getCards(params: PagedQuery): Promise> { + const { data } = await http.get>>('/cards', { params }) + return data.data +} + +export async function getCard(id: string): Promise { + const { data } = await http.get>(`/cards/${id}`) + return data.data +} + +export async function getFamilies(params: PagedQuery): Promise> { + const { data } = await http.get>>('/families', { params }) + return data.data +} + +export async function getFamily(id: string): Promise { + const { data } = await http.get>(`/families/${id}`) + return data.data +} + +export async function getFamilyTree( + id: string, + nodeType: string, + page = 1, + size = 50 +): Promise { + const { data } = await http.get>(`/families/${id}/tree`, { + params: { nodeType, page, size } + }) + return data.data +} diff --git a/frontend/src/api/quality.ts b/frontend/src/api/quality.ts new file mode 100644 index 0000000..036e976 --- /dev/null +++ b/frontend/src/api/quality.ts @@ -0,0 +1,39 @@ +import http from './http' +import type { + ApiResponse, + DeclaredDiff, + Items, + MissingReference, + QualityCoverage, + QualitySummary +} from './types' + +export async function getQualitySummary(refresh = false): Promise { + const { data } = await http.get>('/quality/summary', { + params: refresh ? { refresh: true } : undefined + }) + return data.data +} + +export async function getDeclaredDiff(refresh = false): Promise { + const { data } = await http.get>>('/quality/declared-vs-actual', { + params: refresh ? { refresh: true } : undefined + }) + return data.data.items +} + +export async function getMissingReferences(refresh = false): Promise { + const { data } = await http.get>>( + '/quality/missing-references', + { params: refresh ? { refresh: true } : undefined } + ) + return data.data.items +} + +export async function getQualityCoverage(refresh = false): Promise { + const { data } = await http.get>>( + '/quality/cross-domain-coverage', + { params: refresh ? { refresh: true } : undefined } + ) + return data.data.items +} diff --git a/frontend/src/api/synonyms.ts b/frontend/src/api/synonyms.ts new file mode 100644 index 0000000..363159a --- /dev/null +++ b/frontend/src/api/synonyms.ts @@ -0,0 +1,30 @@ +import http from './http' +import type { + ApiResponse, + Items, + PageResult, + SizeBucket, + SynonymDetail, + SynonymWordItem +} from './types' + +export interface SynonymQuery { + page?: number + size?: number + keyword?: string +} + +export async function getSynonyms(params: SynonymQuery): Promise> { + const { data } = await http.get>>('/synonyms', { params }) + return data.data +} + +export async function getSynonym(wordId: string): Promise { + const { data } = await http.get>(`/synonyms/${wordId}`) + return data.data +} + +export async function getSynonymDistribution(): Promise { + const { data } = await http.get>>('/synonyms/group-size-distribution') + return data.data.items +} diff --git a/frontend/src/api/types.ts b/frontend/src/api/types.ts new file mode 100644 index 0000000..18f46f2 --- /dev/null +++ b/frontend/src/api/types.ts @@ -0,0 +1,443 @@ +export type Tone = 'blue' | 'green' | 'violet' | 'amber' | 'cyan' | 'rose' + +export interface ApiResponse { + code: number + message: string + data: T +} + +export interface Items { + items: T[] +} + +export interface PageResult { + items: T[] + total: number + page: number + size: number +} + +export interface ExamOption { + id: string + code: string + name: string +} + +export interface ExamRef { + id: string + code: string | null + name: string +} + +/* ---------- 概览 ---------- */ + +export interface Kpi { + key: string + label: string + value: number + note: string + tone: Tone +} + +export interface ExamStat { + name: string + code: string | null + books: number + entries: number +} + +export interface TopBook { + id: string + name: string + code: string + exam: string | null + declared: number | null + actual: number + coverPath: string | null +} + +export interface PosStat { + name: string + value: number +} + +export type QualityLevel = 'bad' | 'warn' | 'info' + +export interface QualityItem { + key: string + label: string + value: number + unit: string + level: QualityLevel + target: string +} + +export interface CoverageItem { + name: string + hit: number + total: number + pct: number +} + +export interface DashboardSummary { + kpis: Kpi[] + quality: QualityItem[] + coverage: CoverageItem[] +} + +/* ---------- 词书 ---------- */ + +export interface BookListItem { + id: string + code: string + name: string + examId: string | null + examName: string | null + declared: number | null + actual: number + hasFile: boolean + coverPath: string | null +} + +export interface BookDetail extends BookListItem { + description: string | null + contentVersion: number | null + schemaVersion: number | null + packageUrl: string | null + sortAt: number | null + labels: string | null + mismatch: boolean +} + +export interface BookEntryItem { + entryId: string + displayWord: string + headwordText: string | null + seqBook: number | null + seqAz: number | null + seqFreq: number | null + headword: string | null + indexWord: string | null +} + +/* ---------- 词条 ---------- */ + +export interface EntryListItem { + id: string + headword: string + indexWord: string + pronunciation: string | null + definition: string | null + senseCount: number + bookCount: number +} + +export interface EntryDetail { + id: string + headword: string + indexWord: string + usPronunciation: string | null + ukPronunciation: string | null + definitionText: string | null + dataVersion: string | null + bookExamId: string | null + bookExamName: string | null + occurrenceCount: number | null + hasListeningExamples: boolean + sourceZpkKey: string | null +} + +export interface SenseRelation { + type: string + position: number | null + targetMeaningId: string | null + targetEntryId: string | null +} + +export interface SenseItem { + senseId: string + senseNo: number | null + partOfSpeech: string | null + glossZh: string | null + exams: ExamRef[] + relations: SenseRelation[] +} + +export interface PhraseOrder { + examId: string + examName: string + groupType: number | null + position: number | null +} + +export interface PhraseItem { + id: string + textEn: string + textZh: string | null + groupType: number | null + meaningId: string | null + exams: ExamRef[] + orders: PhraseOrder[] +} + +export interface ExampleSentenceItem { + id: string + textEn: string + textZh: string | null + sourceTitle: string | null + audioUrl: string | null + listening: boolean +} + +export interface ExampleUsageItem { + id: string + patternId: string | null + patternText: string | null + position: number | null + sentences: ExampleSentenceItem[] +} + +export interface ExampleGroupItem { + id: string + groupKind: number + partOfSpeech: string | null + entryKindCode: string | null + headForm: string | null + definitionEn: string | null + definitionZh: string | null + exams: ExamRef[] + usages: ExampleUsageItem[] + directSentences: ExampleSentenceItem[] + sentenceCount: number +} + +export interface ConfusableItem { + id: string + wordText: string + glossZh: string | null + posCode: number | null + spellingFlag: string | null + position: number | null +} + +export interface SpellingVariantItem { + position: number | null + variant: string +} + +export interface EntryBookItem { + bookId: string + bookName: string + bookCode: string + displayWord: string + seqBook: number | null +} + +/* ---------- 词根词族 ---------- */ + +export interface MorphemeItem { + id: string + type: 'prefix' | 'root' | 'suffix' + form: string | null + displayText: string + meaningEn: string | null + meaningZh: string | null + note: string | null +} + +export interface CardBrief { + id: string + word: string + memoryNote: string | null + exampleText: string | null +} + +export interface MorphemeDetail extends MorphemeItem { + cards: CardBrief[] + cardCount: number +} + +export interface CardItem { + id: string + word: string + memoryNote: string | null + highlightedWord: string | null + exams: ExamRef[] +} + +export interface CardFamilyLink { + linkId: string + groupNo: number + familyRef: string | null + hidden: boolean +} + +export interface CardDetail { + id: string + word: string + highlightedWord: string | null + memoryNote: string | null + exampleText: string | null + hidden: boolean + prefixMorphemeId: string | null + prefixForm: string | null + rootMorphemeId: string | null + rootForm: string | null + suffixMorphemeId: string | null + suffixForm: string | null + defaultFamilyRef: string | null + exams: ExamRef[] + familyLinks: CardFamilyLink[] +} + +export interface FamilyItem { + id: string + word: string + topFamilyId: string + topWord: string + interpretation: string | null + groupLevel1: number | null + groupLevel2: number | null + groupLevel3: number | null + exams: ExamRef[] +} + +export interface FamilyVariantItem { + id: string + variantWord: string + interpretation: string | null + memberCount: number +} + +export interface FamilyMemberItem { + familyEntryId: string + word: string + position: number | null +} + +export interface MiniGroupItem { + id: string + size: number + members: FamilyMemberItem[] +} + +export interface FamilyDetail extends FamilyItem { + variants: FamilyVariantItem[] + miniGroups: MiniGroupItem[] +} + +export interface TreeNode { + nodeType: 'top' | 'variant' | 'miniGroup' | 'member' | 'info' + id: string + label: string + subtitle: string + memberCount: number + leaf: boolean +} + +export interface TreePage { + nodes: TreeNode[] + total: number + page: number + size: number +} + +/* ---------- 近反义词 ---------- */ + +export interface SynonymWordItem { + wordId: string + word: string + senseCount: number + hasRelation: boolean +} + +export interface SynonymMember { + wordId: string + word: string + position: number | null +} + +export interface SynonymGroup { + examId: string + examName: string + canonicalWordId: string | null + canonicalWord: string | null + memberCount: number + members: SynonymMember[] + truncated: boolean +} + +export interface AntonymGroup { + examId: string + examName: string + words: SynonymMember[] +} + +export interface SynonymSense { + senseId: string + partOfSpeech: string | null + glossZh: string | null + groups: SynonymGroup[] + antonyms: AntonymGroup[] +} + +export interface SynonymDetail { + wordId: string + word: string + senses: SynonymSense[] +} + +export interface SizeBucket { + label: string + count: number + pct: number +} + +/* ---------- 数据质量 ---------- */ + +export interface QualitySummaryItem { + key: string + label: string + value: number + unit: string + level: QualityLevel + description: string +} + +export interface QualitySummary { + items: QualitySummaryItem[] +} + +export interface DeclaredDiff { + bookId: string + bookName: string + bookCode: string + examName: string | null + declared: number + actual: number + diff: number +} + +export interface MissingReference { + type: string + identifier: string + source: string + detail: string + bookId: string | null +} + +export interface QualityCoverage { + key: string + name: string + hit: number + total: number + pct: number +} + +/* ---------- 认证 ---------- */ + +export interface LoginResponse { + token: string + expiresAt: string + username: string +} diff --git a/frontend/src/charts/overview.ts b/frontend/src/charts/overview.ts new file mode 100644 index 0000000..b5ae2d9 --- /dev/null +++ b/frontend/src/charts/overview.ts @@ -0,0 +1,92 @@ +import type { EChartsOption } from 'echarts' +import type { ExamStat, PosStat } from '@/api/types' + +const POS_COLORS = [ + '#2563eb', + '#3b82f6', + '#60a5fa', + '#93c5fd', + '#a5b4fc', + '#c7d2fe', + '#818cf8', + '#6366f1', + '#4f46e5', + '#cbd5e1' +] + +function short(n: number): string { + return n >= 10000 ? `${(n / 1000).toFixed(1)}k` : String(n) +} + +export function examChartOption(rows: ExamStat[]): EChartsOption { + const reversed = [...rows].reverse() + return { + grid: { left: 8, right: 56, top: 6, bottom: 6, containLabel: true }, + tooltip: { + trigger: 'axis', + axisPointer: { type: 'shadow' }, + formatter: '{b}
关联词条 {c}' + }, + xAxis: { + type: 'value', + splitLine: { lineStyle: { color: '#f1f3f6' } }, + axisLabel: { + color: '#9ca3af', + fontSize: 10, + formatter: (value: string | number) => short(Number(value)) + } + }, + yAxis: { + type: 'category', + data: reversed.map((row) => row.name), + axisTick: { show: false }, + axisLine: { show: false }, + axisLabel: { color: '#4b5563', fontSize: 11.5 } + }, + series: [ + { + type: 'bar', + barWidth: 13, + data: reversed.map((row) => ({ + value: row.entries, + itemStyle: { color: row.code === null ? '#cbd5e1' : '#3b82f6', borderRadius: [0, 3, 3, 0] } + })), + label: { + show: true, + position: 'right', + color: '#6b7280', + fontSize: 10.5, + formatter: '{c}' + } + } + ] + } +} + +export function posChartOption(rows: PosStat[]): EChartsOption { + return { + tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' }, + legend: { + right: 0, + top: 'center', + orient: 'vertical', + itemWidth: 8, + itemHeight: 8, + textStyle: { color: '#6b7280', fontSize: 11 } + }, + series: [ + { + type: 'pie', + radius: ['46%', '70%'], + center: ['34%', '50%'], + itemStyle: { borderColor: '#fff', borderWidth: 2 }, + label: { show: false }, + data: rows.map((row, index) => ({ + name: row.name, + value: row.value, + itemStyle: { color: POS_COLORS[index % POS_COLORS.length] } + })) + } + ] + } +} diff --git a/frontend/src/charts/quality.ts b/frontend/src/charts/quality.ts new file mode 100644 index 0000000..f325220 --- /dev/null +++ b/frontend/src/charts/quality.ts @@ -0,0 +1,44 @@ +import type { EChartsOption } from 'echarts' +import type { QualityCoverage } from '@/api/types' + +export function coverageOption(rows: QualityCoverage[]): EChartsOption { + return { + grid: { left: 8, right: 48, top: 8, bottom: 8, containLabel: true }, + tooltip: { + trigger: 'axis', + axisPointer: { type: 'shadow' }, + formatter: (params: unknown) => { + const item = (params as { name: string; value: number }[])[0] + return `${item.name}
覆盖率 ${item.value}%` + } + }, + xAxis: { + type: 'value', + max: 100, + splitLine: { lineStyle: { color: '#f1f3f6' } }, + axisLabel: { color: '#9ca3af', fontSize: 10, formatter: '{value}%' } + }, + yAxis: { + type: 'category', + data: rows.map((row) => row.name), + axisTick: { show: false }, + axisLine: { show: false }, + axisLabel: { color: '#4b5563', fontSize: 11.5 } + }, + series: [ + { + type: 'bar', + barWidth: 16, + itemStyle: { color: '#0891b2', borderRadius: [0, 4, 4, 0] }, + label: { + show: true, + position: 'right', + color: '#6b7280', + fontSize: 10.5, + formatter: '{c}%' + }, + data: rows.map((row) => row.pct) + } + ] + } +} diff --git a/frontend/src/charts/synonyms.ts b/frontend/src/charts/synonyms.ts new file mode 100644 index 0000000..a703892 --- /dev/null +++ b/frontend/src/charts/synonyms.ts @@ -0,0 +1,43 @@ +import type { EChartsOption } from 'echarts' +import type { SizeBucket } from '@/api/types' + +export function synonymDistributionOption(rows: SizeBucket[]): EChartsOption { + return { + grid: { left: 8, right: 24, top: 16, bottom: 8, containLabel: true }, + tooltip: { + trigger: 'axis', + axisPointer: { type: 'shadow' }, + formatter: (params: unknown) => { + const item = (params as { name: string; value: number }[])[0] + return `${item.name} 个成员
组数 ${item.value.toLocaleString('en-US')}` + } + }, + xAxis: { + type: 'category', + data: rows.map((row) => row.label), + axisTick: { show: false }, + axisLine: { lineStyle: { color: '#e5e7eb' } }, + axisLabel: { color: '#6b7280', fontSize: 11 } + }, + yAxis: { + type: 'value', + splitLine: { lineStyle: { color: '#f1f3f6' } }, + axisLabel: { color: '#9ca3af', fontSize: 10 } + }, + series: [ + { + type: 'bar', + barWidth: 22, + itemStyle: { color: '#6366f1', borderRadius: [4, 4, 0, 0] }, + label: { + show: true, + position: 'top', + color: '#6b7280', + fontSize: 10, + formatter: '{c}' + }, + data: rows.map((row) => row.count) + } + ] + } +} diff --git a/frontend/src/components/CoverImage.vue b/frontend/src/components/CoverImage.vue new file mode 100644 index 0000000..a6d9b35 --- /dev/null +++ b/frontend/src/components/CoverImage.vue @@ -0,0 +1,33 @@ + + + + + diff --git a/frontend/src/components/DataTable.vue b/frontend/src/components/DataTable.vue new file mode 100644 index 0000000..2373532 --- /dev/null +++ b/frontend/src/components/DataTable.vue @@ -0,0 +1,104 @@ + + + + + diff --git a/frontend/src/components/SectionPanel.vue b/frontend/src/components/SectionPanel.vue new file mode 100644 index 0000000..f630c65 --- /dev/null +++ b/frontend/src/components/SectionPanel.vue @@ -0,0 +1,44 @@ + + + + + diff --git a/frontend/src/components/StatCard.vue b/frontend/src/components/StatCard.vue new file mode 100644 index 0000000..1b93a24 --- /dev/null +++ b/frontend/src/components/StatCard.vue @@ -0,0 +1,56 @@ + + + + + diff --git a/frontend/src/env.d.ts b/frontend/src/env.d.ts new file mode 100644 index 0000000..dfe2229 --- /dev/null +++ b/frontend/src/env.d.ts @@ -0,0 +1,11 @@ +/// + +interface ImportMetaEnv { + readonly VITE_USE_MOCK?: string + readonly VITE_API_BASE_URL?: string + readonly VITE_COVER_BASE_URL?: string +} + +interface ImportMeta { + readonly env: ImportMetaEnv +} diff --git a/frontend/src/layouts/AdminLayout.vue b/frontend/src/layouts/AdminLayout.vue new file mode 100644 index 0000000..c9e4236 --- /dev/null +++ b/frontend/src/layouts/AdminLayout.vue @@ -0,0 +1,214 @@ + + + + + diff --git a/frontend/src/main.ts b/frontend/src/main.ts new file mode 100644 index 0000000..bbeb328 --- /dev/null +++ b/frontend/src/main.ts @@ -0,0 +1,14 @@ +import { createApp } from 'vue' +import { createPinia } from 'pinia' +import ElementPlus from 'element-plus' +import zhCn from 'element-plus/es/locale/lang/zh-cn' +import 'element-plus/dist/index.css' +import App from './App.vue' +import router from './router' +import './styles/main.css' + +createApp(App) + .use(createPinia()) + .use(router) + .use(ElementPlus, { locale: zhCn }) + .mount('#app') diff --git a/frontend/src/mocks/dashboard.ts b/frontend/src/mocks/dashboard.ts new file mode 100644 index 0000000..a981411 --- /dev/null +++ b/frontend/src/mocks/dashboard.ts @@ -0,0 +1,74 @@ +import type { + CoverageItem, + ExamStat, + Kpi, + PosStat, + QualityItem, + TopBook +} from '@/api/types' + +// 真实快照:MySQL word_market,2026-11-08。后端就绪后由 API 替换。 +export const mockKpis: Kpi[] = [ + { key: 'books', label: '词书', value: 1025, note: '1 本无清单文件', tone: 'blue' }, + { key: 'entries', label: '词条', value: 38116, note: '38,000 个索引词', tone: 'green' }, + { key: 'links', label: '词书词条关联', value: 1228421, note: '平均每本 1,200 条', tone: 'violet' }, + { key: 'sentences', label: '例句', value: 235744, note: '含使用模式 71,964', tone: 'amber' }, + { key: 'families', label: '词族', value: 22717, note: '顶层族 5,629', tone: 'cyan' }, + { key: 'synonyms', label: '近义词头', value: 6279, note: '义项 8,383', tone: 'rose' } +] + +export const mockExams: ExamStat[] = [ + { name: '考研', code: 'KY', books: 108, entries: 480091 }, + { name: '未归类', code: null, books: 509, entries: 258233 }, + { name: '高考', code: 'GK', books: 150, entries: 154292 }, + { name: '中考', code: 'ZK', books: 156, entries: 74439 }, + { name: '四级', code: 'CET4', books: 29, entries: 69362 }, + { name: '六级', code: 'CET6', books: 22, entries: 52863 }, + { name: '专升本', code: 'ZSB', books: 19, entries: 52681 }, + { name: '专四', code: 'PRO4', books: 7, entries: 25627 }, + { name: '雅思', code: 'IELTS', books: 11, entries: 25314 }, + { name: '专八', code: 'PRO8', books: 6, entries: 19954 }, + { name: '托福', code: 'TOEFL', books: 8, entries: 15565 } +] + +export const mockTopBooks: TopBook[] = [ + { id: '15', name: 'SAT10000', code: 'SAT', exam: 'SAT', declared: 10001, actual: 10001, coverPath: '/dicts/v3/img_032516463440_24_opt.png' }, + { id: '1170', name: '2027恋练有词考研英语词汇', code: 'LLYC2027', exam: '考研', declared: 7969, actual: 7969, coverPath: '/dicts/v3/img_122613473672_1017_opt.png' }, + { id: '557', name: '2024恋练有词考研英语词汇', code: 'LLYCKY2024', exam: '考研', declared: 7949, actual: 7949, coverPath: '/dicts/v3/img_032615238520_111_opt.png' }, + { id: '740', name: '2026恋练有词考研英语词汇', code: 'LLYCKY2026', exam: '考研', declared: 7941, actual: 7941, coverPath: '/dicts/v3/img_122414371550_51_opt.png' }, + { id: '630', name: '2025恋练有词考研英语词汇', code: 'LLYCKY2025', exam: '考研', declared: 7940, actual: 7940, coverPath: '/dicts/v3/img_032615097259_51_opt.png' }, + { id: '331', name: '2023恋练有词考研英语词汇', code: 'LLYCKY2023', exam: '考研', declared: 7919, actual: 7919, coverPath: '/dicts/v3/img_032617141081_126_opt.png' }, + { id: '508', name: '2023恋练有词考研英语词汇', code: 'LLYCK2023N', exam: '考研', declared: 7919, actual: 7919, coverPath: '/dicts/v3/img_042716404904_126_opt.png' }, + { id: '841', name: '英语六级 你还在背单词吗(新版)', code: 'HZBCET6N', exam: '六级', declared: 7799, actual: 7799, coverPath: '/dicts/v3/img_081109464902_93_opt.png' }, + { id: '519', name: '全国英语等级考试第五级', code: 'PETS5', exam: '未归类', declared: 7527, actual: 7527, coverPath: '/dicts/v3/img_032516041386_40_opt.png' }, + { id: '819', name: '考研词汇 词根联想记忆法 乱序版', code: 'KYLX2026', exam: '考研', declared: 7349, actual: 7349, coverPath: '/dicts/v3/img_071615349355_34_opt.png' } +] + +export const mockPos: PosStat[] = [ + { name: 'n.', value: 21313 }, + { name: 'adj.', value: 9782 }, + { name: 'phr.', value: 6922 }, + { name: 'vt.', value: 5331 }, + { name: 'adv.', value: 1996 }, + { name: 'vi.', value: 1800 }, + { name: 'phrv.', value: 1758 }, + { name: 'idm.', value: 1595 }, + { name: 'vi. vt.', value: 971 }, + { name: 'vt. vi.', value: 896 } +] + +export const mockQuality: QualityItem[] = [ + { key: 'mismatch', label: '声明与实际词条数不一致', value: 18, unit: '本', level: 'warn', target: '词书' }, + { key: 'nofile', label: '缺失词书清单文件', value: 1, unit: '本', level: 'bad', target: '词书' }, + { key: 'nozpk', label: '缺失 zpk 引用', value: 1, unit: '个', level: 'bad', target: '词条' }, + { key: 'nosense', label: '无结构化义项的词条', value: 5250, unit: '条', level: 'warn', target: '词条' }, + { key: 'nosyn', label: '无义项的近义词头', value: 19, unit: '个', level: 'warn', target: '近义词' }, + { key: 'noexam', label: '未设置考试的词书', value: 509, unit: '本', level: 'info', target: '词书' }, + { key: 'nocover', label: '无封面词书', value: 27, unit: '本', level: 'info', target: '词书' } +] + +export const mockCoverage: CoverageItem[] = [ + { name: '单词卡片', hit: 11662, total: 11998, pct: 97.2 }, + { name: '词族', hit: 17587, total: 22710, pct: 77.4 }, + { name: '近义词头', hit: 6231, total: 6279, pct: 99.2 } +] diff --git a/frontend/src/router/index.ts b/frontend/src/router/index.ts new file mode 100644 index 0000000..cae9428 --- /dev/null +++ b/frontend/src/router/index.ts @@ -0,0 +1,91 @@ +import { createRouter, createWebHistory } from 'vue-router' +import AdminLayout from '@/layouts/AdminLayout.vue' +import { TOKEN_KEY } from '@/utils/storage' + +const router = createRouter({ + history: createWebHistory(), + routes: [ + { + path: '/login', + name: 'login', + component: () => import('@/views/LoginView.vue'), + meta: { title: '登录', public: true } + }, + { + path: '/', + component: AdminLayout, + children: [ + { + path: '', + name: 'overview', + component: () => import('@/views/OverviewView.vue'), + meta: { title: '概览' } + }, + { + path: 'books', + name: 'books', + component: () => import('@/views/BooksView.vue'), + meta: { title: '词书管理' } + }, + { + path: 'books/:id', + name: 'book-detail', + component: () => import('@/views/BookDetailView.vue'), + meta: { title: '词书详情' } + }, + { + path: 'entries', + name: 'entries', + component: () => import('@/views/EntriesView.vue'), + meta: { title: '词条词典' } + }, + { + path: 'morphology', + name: 'morphology', + component: () => import('@/views/MorphologyView.vue'), + meta: { title: '词根词族' } + }, + { + path: 'synonyms', + name: 'synonyms', + component: () => import('@/views/SynonymsView.vue'), + meta: { title: '近反义词' } + }, + { + path: 'synonyms/:id', + name: 'synonym-detail', + component: () => import('@/views/SynonymDetailView.vue'), + meta: { title: '近义词详情' } + }, + { + path: 'quality', + name: 'quality', + component: () => import('@/views/QualityView.vue'), + meta: { title: '数据质量' } + } + ] + }, + { path: '/:pathMatch(.*)*', redirect: '/' } + ] +}) + +router.beforeEach((to) => { + const token = localStorage.getItem(TOKEN_KEY) + if (to.meta.public) { + if (token && to.name === 'login') { + return { name: 'overview' } + } + return true + } + if (!token) { + return { name: 'login', query: { redirect: to.fullPath } } + } + return true +}) + +router.afterEach((to) => { + const title = String(to.meta.title ?? '') + document.title = title ? `${title} · Word Market` : 'Word Market · 词库管理后台' +}) + +export default router diff --git a/frontend/src/stores/auth.ts b/frontend/src/stores/auth.ts new file mode 100644 index 0000000..02655d0 --- /dev/null +++ b/frontend/src/stores/auth.ts @@ -0,0 +1,31 @@ +import { computed, ref } from 'vue' +import { defineStore } from 'pinia' +import { login as loginApi } from '@/api/auth' +import { clearAuthStorage, EXPIRES_KEY, TOKEN_KEY, USER_KEY } from '@/utils/storage' + +export const useAuthStore = defineStore('auth', () => { + const token = ref(localStorage.getItem(TOKEN_KEY) ?? '') + const username = ref(localStorage.getItem(USER_KEY) ?? '') + const expiresAt = ref(localStorage.getItem(EXPIRES_KEY) ?? '') + + const isAuthenticated = computed(() => Boolean(token.value)) + + async function login(user: string, password: string): Promise { + const result = await loginApi(user, password) + token.value = result.token + username.value = result.username + expiresAt.value = result.expiresAt + localStorage.setItem(TOKEN_KEY, result.token) + localStorage.setItem(USER_KEY, result.username) + localStorage.setItem(EXPIRES_KEY, result.expiresAt) + } + + function logout(): void { + token.value = '' + username.value = '' + expiresAt.value = '' + clearAuthStorage() + } + + return { token, username, expiresAt, isAuthenticated, login, logout } +}) diff --git a/frontend/src/styles/main.css b/frontend/src/styles/main.css new file mode 100644 index 0000000..c56f9c5 --- /dev/null +++ b/frontend/src/styles/main.css @@ -0,0 +1,28 @@ +*, +*::before, +*::after { + box-sizing: border-box; +} + +html, +body, +#app { + margin: 0; + min-height: 100%; +} + +body { + font-family: 'PingFang SC', 'Microsoft YaHei', 'Segoe UI', system-ui, sans-serif; + color: #1f2937; + background: #f3f5f8; + -webkit-font-smoothing: antialiased; +} + +a { + color: inherit; + text-decoration: none; +} + +img { + display: block; +} diff --git a/frontend/src/utils/cover.ts b/frontend/src/utils/cover.ts new file mode 100644 index 0000000..b432865 --- /dev/null +++ b/frontend/src/utils/cover.ts @@ -0,0 +1,16 @@ +const COVER_BASE = import.meta.env.VITE_COVER_BASE_URL || 'https://static.beingfine.cn' + +export const PLACEHOLDER_COVER = + 'data:image/svg+xml;utf8,' + + encodeURIComponent( + 'N/A' + ) + +export function coverUrl(path: string | null): string { + return path ? `${COVER_BASE}${path}` : PLACEHOLDER_COVER +} + +export function onCoverError(event: Event): void { + const img = event.target as HTMLImageElement + if (img.src !== PLACEHOLDER_COVER) img.src = PLACEHOLDER_COVER +} diff --git a/frontend/src/utils/storage.ts b/frontend/src/utils/storage.ts new file mode 100644 index 0000000..dab81c8 --- /dev/null +++ b/frontend/src/utils/storage.ts @@ -0,0 +1,9 @@ +export const TOKEN_KEY = 'word-market-token' +export const USER_KEY = 'word-market-user' +export const EXPIRES_KEY = 'word-market-expires' + +export function clearAuthStorage(): void { + localStorage.removeItem(TOKEN_KEY) + localStorage.removeItem(USER_KEY) + localStorage.removeItem(EXPIRES_KEY) +} diff --git a/frontend/src/utils/text.ts b/frontend/src/utils/text.ts new file mode 100644 index 0000000..1882fa3 --- /dev/null +++ b/frontend/src/utils/text.ts @@ -0,0 +1,4 @@ +export function plainText(value: string | null | undefined): string { + if (!value) return '' + return value.replace(/<[^>]*>/g, '') +} diff --git a/frontend/src/views/BookDetailView.vue b/frontend/src/views/BookDetailView.vue new file mode 100644 index 0000000..482823e --- /dev/null +++ b/frontend/src/views/BookDetailView.vue @@ -0,0 +1,323 @@ + + + + + diff --git a/frontend/src/views/BooksView.vue b/frontend/src/views/BooksView.vue new file mode 100644 index 0000000..f8b9eb0 --- /dev/null +++ b/frontend/src/views/BooksView.vue @@ -0,0 +1,242 @@ + + + + + diff --git a/frontend/src/views/EntriesView.vue b/frontend/src/views/EntriesView.vue new file mode 100644 index 0000000..a299dae --- /dev/null +++ b/frontend/src/views/EntriesView.vue @@ -0,0 +1,813 @@ + + + + + diff --git a/frontend/src/views/LoginView.vue b/frontend/src/views/LoginView.vue new file mode 100644 index 0000000..b959935 --- /dev/null +++ b/frontend/src/views/LoginView.vue @@ -0,0 +1,143 @@ + + + + + diff --git a/frontend/src/views/MorphologyView.vue b/frontend/src/views/MorphologyView.vue new file mode 100644 index 0000000..85520c2 --- /dev/null +++ b/frontend/src/views/MorphologyView.vue @@ -0,0 +1,762 @@ + + + + + diff --git a/frontend/src/views/OverviewView.vue b/frontend/src/views/OverviewView.vue new file mode 100644 index 0000000..d4031fe --- /dev/null +++ b/frontend/src/views/OverviewView.vue @@ -0,0 +1,475 @@ + + + + + diff --git a/frontend/src/views/PlaceholderView.vue b/frontend/src/views/PlaceholderView.vue new file mode 100644 index 0000000..359bfd7 --- /dev/null +++ b/frontend/src/views/PlaceholderView.vue @@ -0,0 +1,22 @@ + + + + + diff --git a/frontend/src/views/QualityView.vue b/frontend/src/views/QualityView.vue new file mode 100644 index 0000000..6804be7 --- /dev/null +++ b/frontend/src/views/QualityView.vue @@ -0,0 +1,414 @@ + + + + + diff --git a/frontend/src/views/SynonymDetailView.vue b/frontend/src/views/SynonymDetailView.vue new file mode 100644 index 0000000..0bd9acc --- /dev/null +++ b/frontend/src/views/SynonymDetailView.vue @@ -0,0 +1,249 @@ + + + + + diff --git a/frontend/src/views/SynonymsView.vue b/frontend/src/views/SynonymsView.vue new file mode 100644 index 0000000..198c67b --- /dev/null +++ b/frontend/src/views/SynonymsView.vue @@ -0,0 +1,213 @@ + + + + + diff --git a/frontend/tsconfig.json b/frontend/tsconfig.json new file mode 100644 index 0000000..0947646 --- /dev/null +++ b/frontend/tsconfig.json @@ -0,0 +1,25 @@ +{ + "compilerOptions": { + "target": "ES2022", + "useDefineForClassFields": true, + "module": "ESNext", + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "skipLibCheck": true, + "moduleResolution": "Bundler", + "allowImportingTsExtensions": true, + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "jsx": "preserve", + "strict": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "noFallthroughCasesInSwitch": true, + "baseUrl": ".", + "paths": { + "@/*": ["src/*"] + }, + "types": ["node", "element-plus/global"] + }, + "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.vue", "vite.config.ts"] +} diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts new file mode 100644 index 0000000..15f525f --- /dev/null +++ b/frontend/vite.config.ts @@ -0,0 +1,21 @@ +import { fileURLToPath, URL } from 'node:url' +import { defineConfig } from 'vite' +import vue from '@vitejs/plugin-vue' + +export default defineConfig({ + plugins: [vue()], + resolve: { + alias: { + '@': fileURLToPath(new URL('./src', import.meta.url)) + } + }, + server: { + port: 5173, + proxy: { + '/api': { + target: process.env.VITE_PROXY_TARGET ?? 'http://127.0.0.1:8080', + changeOrigin: true + } + } + } +}) diff --git a/openspec/changes/add-admin-console/.openspec.yaml b/openspec/changes/add-admin-console/.openspec.yaml new file mode 100644 index 0000000..c0ad5ed --- /dev/null +++ b/openspec/changes/add-admin-console/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-11-08 diff --git a/openspec/changes/add-admin-console/README.md b/openspec/changes/add-admin-console/README.md new file mode 100644 index 0000000..ab1004a --- /dev/null +++ b/openspec/changes/add-admin-console/README.md @@ -0,0 +1,3 @@ +# add-admin-console + +基于 Vue 3 + Spring Boot 3 的只读单词数据管理后台 diff --git a/openspec/changes/add-admin-console/design.md b/openspec/changes/add-admin-console/design.md new file mode 100644 index 0000000..35ea49b --- /dev/null +++ b/openspec/changes/add-admin-console/design.md @@ -0,0 +1,135 @@ +## Context + +词库数据已完整落库到 MySQL `word_market`(36 张表、约 364 万行、约 590MB),`importer/` 负责导入且不应被后台改动。`backend/` 与 `frontend/` 目前只有占位 README。本地环境为 Java 17 + Maven 3.9 + Node 24,没有 Docker;数据库在 `s1.void01.com`,需要跨网络访问。 + +需求与行为契约见 `proposal.md` 与 `specs/`,本文只记录实现层面的技术选择。 + +## Goals / Non-Goals + +**Goals:** + +- 用一套可维护的 Spring Boot 服务承载全部只读查询,接口足够稳定以支撑前端六个模块。 +- 在远程数据库和 123 万行大表的前提下,保证看板首屏和列表页的响应可接受。 +- 前后端分离部署,配置全部外部化,仓库不出现凭据。 +- 明确的只读边界,从连接、事务和代码三个层面防止写入。 + +**Non-Goals:** + +- 不做任何新增、修改、删除、导入触发功能。 +- 不做多租户、多角色、权限矩阵。 +- 不做实时推送、定时任务或数据同步。 +- 不做移动端适配,首期以桌面端 1280px 以上为主。 +- 不改造 `importer` 或数据库 schema。 + +## Decisions + +### 1. 后端:Spring Boot 3 + Java 17 + MyBatis-Plus + +- 采用 Spring Boot 3.3.x、Java 17、Maven 构建,与本地已安装版本一致。 +- 持久层选 MyBatis-Plus:列表接口的筛选条件组合多、需要分页,MyBatis-Plus 的 `LambdaQueryWrapper` 和分页插件能显著减少样板 SQL;只读场景不需要 JPA 的实体生命周期和脏检查。 +- 备选:`JdbcTemplate`(SQL 最透明,但动态筛选和分页要手写较多代码);Spring Data JPA(对纯读场景偏重)。 + +### 2. 只读保障三层 + +- 数据库侧:建议为后台创建仅 `SELECT` 权限的账号,通过环境变量配置;这是运维动作,执行前需单独确认。 +- 连接池:HikariCP 设置 `read-only: true`。 +- 应用侧:全部 Service 标注 `@Transactional(readOnly = true)`;不创建任何 `insert/update/delete` Mapper 方法;代码评审时以此为准。 + +### 3. 认证:单管理员 + JWT(HS256) + +- 管理员用户名、BCrypt 密码哈希、JWT 密钥全部来自环境变量(`ADMIN_USERNAME`、`ADMIN_PASSWORD_HASH`、`JWT_SECRET`)。 +- 启动时校验三项配置存在,缺失则启动失败并输出配置名,避免“能启动但登录不了”的隐性故障。 +- token 有效期默认 8 小时,前端存内存 + localStorage;401 时清除并跳转登录页。 +- 不建用户表,不引入 Spring Session 或 OAuth。备选 OAuth 需要外部身份提供方,超出本期范围。 + +### 4. 聚合缓存:Caffeine 本地缓存 + +- 概览与数据质量的聚合结果缓存 10 分钟;缓存 key 包含查询类型和参数。 +- 提供 `refresh=true` 参数绕过缓存并回填。 +- 列表、详情和子资源不做长缓存,避免看到过期内容;详情查询本身有主键索引。 +- 单实例部署下本地缓存足够;未来横向扩容时再换 Redis。备选 Redis 现阶段会多一个运维组件。 + +### 5. API 约定 + +- 统一前缀 `/api`,响应结构 `{ code, message, data }`;分页数据为 `{ items, total, page, size }`。 +- 时间统一返回 ISO-8601 字符串,数值 ID 以 string 返回,避免前端精度丢失(`bigint` 超过 `Number.MAX_SAFE_INTEGER` 的风险)。 +- 全局异常处理:参数错误 400、未认证 401、未找到 404、服务异常 500,均返回统一结构。 +- 主要接口: + +| 模块 | 接口 | +|---|---| +| 认证 | `POST /api/auth/login` | +| 概览 | `GET /api/dashboard/summary`、`/exam-distribution`、`/book-size-top`、`/pos-distribution` | +| 词书 | `GET /api/books`、`/api/books/{id}`、`/api/books/{id}/entries` | +| 词条 | `GET /api/entries`、`/api/entries/{id}`、`/{id}/senses`、`/phrases`、`/examples`、`/confusables`、`/books` | +| 词根词族 | `GET /api/morphemes`、`/api/morphemes/{id}`、`/api/cards`、`/api/cards/{id}`、`/api/families`、`/api/families/{id}`、`/api/families/{id}/tree` | +| 近反义词 | `GET /api/synonyms`、`/api/synonyms/{wordId}`、`/api/synonyms/group-size-distribution` | +| 数据质量 | `GET /api/quality/summary`、`/declared-vs-actual`、`/missing-references`、`/cross-domain-coverage` | + +### 6. 前端:Vue 3 + Vite + TS + Element Plus + ECharts + +- Vue 3 + Vite + TypeScript;状态管理只用于认证和布局,业务数据走页面级请求,不放进全局 store。 +- Element Plus 提供表格、分页、树、标签页、抽屉等后台组件;ECharts 负责 KPI 之外的图表。 +- Axios 封装统一注入 token、解包 `data`、处理 401;路由使用 `meta.requiresAuth` 做守卫。 +- 页面结构:登录页 + 侧边栏布局 + 各模块列表页/详情页;详情页用 Tab 或锚点分区,避免单页过长。 +- 词族树使用 Element Plus `el-tree` 的 `lazy` 模式,节点展开时按需请求子节点;成员节点分页,避免一次渲染上千成员。 + +### 7. 数据访问与性能 + +- 列表统一使用 `LIMIT/OFFSET` 分页,默认每页 20 条,最大 100 条。 +- 详情页的子资源按各自索引查询:`book_entry(book_id, seq_book)`、`word_sense(entry_id, sense_no)`、`example_group(entry_id, group_kind)`、`phrase(entry_id)`、`synonym_sense(word_id)` 等。 +- 详情页需要多个子资源时按 Tab 懒加载,避免一次请求全部关联表。 +- `book_entry` 123 万行的全表 `COUNT(*)` 与分组只出现在概览/质量聚合中,统一走缓存;列表计数按筛选条件走索引。 +- 跨域覆盖度需要文本交集,查询较重,缓存时间可长于其他指标;实现时优先用单条 SQL 的 `EXISTS`/`JOIN`,避免把两边的词表拉到应用层。 +- 连接池大小按单实例 10–20 配置,并为查询设置超时,防止远程库抖动拖垮线程。 + +### 8. 封面与静态资源 + +- 封面地址 = `COVER_BASE_URL`(默认 `https://static.beingfine.cn`)+ `book.cover_url`。 +- 前端图片组件统一处理加载失败,回退到本地占位图;27 本无封面词书使用同一占位图。 + +### 9. 部署与配置 + +- 后端产出可执行 jar,前端产出 `dist` 静态资源;生产环境由 Nginx 托管前端并反向代理 `/api`。 +- 开发环境 Vite dev server 代理 `/api` 到后端,避免 CORS 配置复杂化;后端仍保留可配置的 CORS 白名单。 +- 所有敏感配置通过环境变量注入,仓库只提供 `.env.example` 和 `application.example.yml`。 + +### 10. 概览页 UI 采用方案 A(经典后台) + +- 采用 `frontend/prototype/` 中的方案 A:228px 白色左侧导航 + 顶部栏 + 六列 KPI 卡片 + 2:1 图表网格 + 词书排行表格与质量红绿灯/覆盖度侧栏。 +- 理由:日常管理场景下信息层级最清晰,侧边栏框架可被词书、词条等模块直接复用;方案 B 的深色大屏偏监控、方案 C 的编辑式排版偏研报,都不匹配本期后台定位。 +- 方案 B/C 保留在原型目录作为参考,正式实现只采用 A 的结构。 +- 实现落点为 `/` 路由与 `OverviewView` 组件,数据走 `/api/dashboard/*`;后端未就绪时使用与接口同形的本地 mock,切换后端只改 API 层。 + +### 11. 词条详情使用右侧抽屉 + +- 词条列表点击行或“查看”时,在右侧 760px 抽屉中展示基本信息与义项/短语/例句/易混词/收录词书五个 Tab,列表保持可见。 +- 抽屉使用非模态(`modal=false`、`lock-scroll=false`):打开时仍可点击其他词条切换内容,也可直接使用侧边栏切换模块。 +- 词书详情中的“查看词条”跳转到词条列表并自动打开对应抽屉。 +- 抽屉支持关闭按钮与 ESC;关闭时清除 URL 中的 `id`,直接访问带 `id` 的 URL 可恢复抽屉。 +- 词书与近义词仍使用独立详情页;只有词条采用抽屉,便于在列表中快速对照多个词条。 +- 正式实现使用 Element Plus `el-drawer`,`append-to-body`,桌面宽度 760px,窄屏 92vw。 + +## Risks / Trade-offs + +- [远程数据库查询延迟] → 聚合走缓存、查询设置超时、列表强制分页;前端加载态与错误态必须明确。 +- [聚合首次查询慢] → 缓存预热可在部署后手动触发刷新;必要时为高频聚合增加覆盖索引。 +- [深分页性能下降] → 首期限定最大页码或最大 offset;后续可改 keyset 分页。 +- [词族树节点过大] → 懒加载 + 成员分页;单节点成员上限由接口控制。 +- [JWT 与管理员凭据泄漏] → 仅通过环境变量注入;生产必须 HTTPS;token 短期有效。 +- [只读约束被绕过] → 数据库只读账号是最终防线;应用层禁止写 Mapper,并在评审中检查。 +- [封面 CDN 不可用] → 占位图兜底,不阻塞页面。 +- [中文乱码] → 数据库、JDBC URL、HTTP 响应统一 UTF-8;前端不使用 GBK 相关配置。 +- [无真实趋势数据] → 不生成伪时间序列图;只做快照分布与排行。 + +## Migration Plan + +1. 在数据库侧创建只读账号(需单独确认并执行授权语句)。 +2. 配置后端环境变量,启动 jar 并验证登录与只读接口。 +3. 构建前端静态资源,部署到 Nginx,配置 `/api` 反向代理。 +4. 回滚:停止新服务并恢复上一版本 jar/dist;数据库无 schema 变更,无需回滚脚本。 + +## Open Questions + +- 概览各图表的最终视觉形式(柱状/环形/横向条)在实现时按数据分布微调,不影响接口契约。 +- 缓存 TTL 的首期取值(默认 10 分钟)可在联调后按查询耗时调整。 diff --git a/openspec/changes/add-admin-console/proposal.md b/openspec/changes/add-admin-console/proposal.md new file mode 100644 index 0000000..747c9e2 --- /dev/null +++ b/openspec/changes/add-admin-console/proposal.md @@ -0,0 +1,44 @@ +## Why + +`importer` 已将 Lexis 词库完整导入 MySQL `word_market`(36 张表、约 364 万行),但目前没有任何浏览或可视化入口。核对词书内容、排查数据质量问题只能手写 SQL,效率低且容易误操作。需要一套只读管理后台,把词书、词条、词根词族、近反义词四个业务域的数据可视化,并支持从看板钻取到明细,帮助快速理解和核查这批数据。 + +本期明确只做查询与展示,不提供任何增删改,避免误改源数据。 + +## What Changes + +- 新建 `backend/`:Spring Boot 3(Java 17)+ MyBatis-Plus,只读连接 MySQL `word_market`。 +- 新建 `frontend/`:Vue 3 + Vite + TypeScript + Element Plus + ECharts。 +- 单管理员登录:账号密码来自环境变量,登录后签发 JWT;前端路由守卫与 401 拦截。 +- 概览看板:总量 KPI、考试分布、词书规模排行、词性分布、数据质量红绿灯。 +- 词书模块:1,025 本词书的列表、筛选、详情与词条清单分页。 +- 词条模块:38,116 个词条的搜索、详情,覆盖义项、短语、例句、易混词、收录词书。 +- 词根词族模块:词素(前缀/词根/后缀)、单词卡片、词族及**树形族谱**。 +- 近反义词模块:词头列表、义项详情、分考试近义组与反义词。 +- 数据质量模块:声明 vs 实际、缺失文件/引用、无结构化义项、跨域覆盖度。 +- 全局只读约束:所有接口仅执行 SELECT,应用层开启 read-only 事务,数据库侧建议使用只读账号。 +- 聚合查询使用 Caffeine 缓存,列表与子资源统一分页。 + +## Capabilities + +### New Capabilities + +- `admin-auth`: 单管理员凭据校验、JWT 签发与校验、未认证访问拦截。 +- `admin-overview`: 概览看板的 KPI 与分布图表数据。 +- `book-catalog`: 词书列表、筛选、详情与词条清单的只读浏览。 +- `word-lexicon`: 词条搜索、详情及义项/短语/例句/易混词/收录词书等子资源浏览。 +- `word-morphology`: 词素、单词卡片、词族及树形族谱的只读浏览。 +- `synonym-relations`: 近义词头、义项、分考试近义组与反义词的只读浏览。 +- `data-quality`: 数据质量指标与异常明细的聚合展示。 + +### Modified Capabilities + +无。当前 `openspec/specs/` 下没有既有能力,本次全部为新增。 + +## Impact + +- 代码:`backend/`、`frontend/` 由占位目录变为实际工程;`importer/` 与数据库 schema 不改动。 +- 数据:只读访问 MySQL `s1.void01.com:3306/word_market`,不新增表、不写入。 +- 配置:需要数据库连接信息、管理员账号与密码哈希、JWT 密钥等环境变量;不得硬编码凭据。 +- 外部依赖:词书封面通过 `https://static.beingfine.cn` + `book.cover_url` 访问。 +- 性能:概览聚合依赖 Caffeine 缓存,避免高频全表聚合;详情页子资源必须分页。 +- 运维:前后端分离部署,后端产出可执行 jar,前端产出静态资源。 diff --git a/openspec/changes/add-admin-console/specs/admin-auth/spec.md b/openspec/changes/add-admin-console/specs/admin-auth/spec.md new file mode 100644 index 0000000..993e8cb --- /dev/null +++ b/openspec/changes/add-admin-console/specs/admin-auth/spec.md @@ -0,0 +1,62 @@ +## Purpose + +保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据。 + +## ADDED Requirements + +### Requirement: 管理员登录 + +系统 SHALL 提供登录接口,校验单一管理员账号与密码;凭据必须来自外部配置(环境变量),不得硬编码在代码或仓库中。校验成功后签发 JWT,失败时返回统一错误结构。 + +#### Scenario: 凭据正确 + +- **WHEN** 管理员提交正确的用户名和密码 +- **THEN** 系统返回 JWT 和过期时间,前端进入后台首页 + +#### Scenario: 凭据错误 + +- **WHEN** 管理员提交错误的用户名或密码 +- **THEN** 系统返回 401,且不返回任何 token 或账号信息 + +#### Scenario: 请求缺字段 + +- **WHEN** 登录请求缺少用户名或密码 +- **THEN** 系统返回 400,并说明缺少的字段 + +#### Scenario: 启动时缺少管理员配置 + +- **WHEN** 应用启动时未提供管理员账号或密码哈希 +- **THEN** 应用拒绝启动并输出明确的配置缺失错误 + +### Requirement: 受保护接口鉴权 + +除登录接口外,所有业务接口 MUST 要求携带有效 JWT。无效、过期或缺失 token 的请求 SHALL 被拒绝,不得返回业务数据。 + +#### Scenario: 未携带 token + +- **WHEN** 请求受保护接口时未提供 Authorization 头 +- **THEN** 系统返回 401 + +#### Scenario: token 无效或过期 + +- **WHEN** 请求携带格式错误、签名不匹配或已过期的 token +- **THEN** 系统返回 401,且不返回业务数据 + +#### Scenario: token 有效 + +- **WHEN** 请求携带有效 token +- **THEN** 系统正常返回业务数据 + +### Requirement: 前端会话处理 + +前端 SHALL 在本地保存登录状态;收到 401 时必须清除登录状态并跳转登录页,不得停留在空白或报错页面。 + +#### Scenario: token 过期 + +- **WHEN** 任意页面请求返回 401 +- **THEN** 前端清除本地 token 并跳转登录页 + +#### Scenario: 主动退出 + +- **WHEN** 管理员点击退出 +- **THEN** 前端清除本地 token 并返回登录页 diff --git a/openspec/changes/add-admin-console/specs/admin-overview/spec.md b/openspec/changes/add-admin-console/specs/admin-overview/spec.md new file mode 100644 index 0000000..ec6171f --- /dev/null +++ b/openspec/changes/add-admin-console/specs/admin-overview/spec.md @@ -0,0 +1,69 @@ +## Purpose + +在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口。 + +## ADDED Requirements + +### Requirement: 总量指标 + +系统 SHALL 在概览页展示词书数、词条数、词书词条关联数、例句数、词族数、近义词头数六项核心指标。 + +#### Scenario: 打开概览页 + +- **WHEN** 已登录管理员进入概览页 +- **THEN** 页面展示六项指标及其当前数值 + +#### Scenario: 指标查询失败 + +- **WHEN** 某一指标查询失败 +- **THEN** 页面展示该指标的不可用状态,其余指标仍正常展示 + +### Requirement: 考试维度分布 + +系统 SHALL 按考试展示词书数与关联词条数,并 MUST 显式包含“未归类”分组,避免未设置考试的词书被忽略。 + +#### Scenario: 查看考试分布 + +- **WHEN** 管理员查看考试分布图 +- **THEN** 图中包含各考试的词书数、关联词条数以及“未归类”分组 + +### Requirement: 词书规模排行 + +系统 SHALL 展示实际词条数最多的前 10 本词书,同时给出各自声明的词条数,便于发现两者差异。 + +#### Scenario: 查看规模排行 + +- **WHEN** 管理员查看词书规模排行 +- **THEN** 页面按实际词条数降序列出前 10 本,并同时显示声明词条数 + +### Requirement: 词性分布 + +系统 SHALL 按 `part_of_speech` 汇总词义数量并展示主要词性占比。 + +#### Scenario: 查看词性分布 + +- **WHEN** 管理员查看词性分布 +- **THEN** 页面展示各词性的义项数及占比,空词性单独归类 + +### Requirement: 质量红绿灯 + +系统 SHALL 在概览页展示关键数据质量指标摘要,并提供进入数据质量模块的入口。 + +#### Scenario: 查看质量摘要 + +- **WHEN** 管理员查看质量红绿灯 +- **THEN** 页面展示异常项数量与状态,并可跳转到数据质量模块 + +### Requirement: 聚合结果缓存 + +概览聚合结果 SHALL 缓存一段时间;缓存有效期内重复请求直接返回缓存,过期后重新查询。系统 SHALL 提供手动刷新方式以强制重新计算。 + +#### Scenario: 缓存命中 + +- **WHEN** 缓存在有效期内,管理员重复打开概览页 +- **THEN** 系统直接返回缓存结果,不重新执行聚合查询 + +#### Scenario: 手动刷新 + +- **WHEN** 管理员触发刷新 +- **THEN** 系统忽略现有缓存并重新计算后返回 diff --git a/openspec/changes/add-admin-console/specs/book-catalog/spec.md b/openspec/changes/add-admin-console/specs/book-catalog/spec.md new file mode 100644 index 0000000..eeb78da --- /dev/null +++ b/openspec/changes/add-admin-console/specs/book-catalog/spec.md @@ -0,0 +1,71 @@ +## Purpose + +以只读方式浏览词书目录及每本词书的词条清单,帮助核对词书规模、考试归属和内容完整性。 + +## ADDED Requirements + +### Requirement: 词书列表与筛选 + +系统 SHALL 提供分页的词书列表,支持按考试、关键词和是否存在词书文件筛选;列表 MUST 展示名称、业务编码、考试、声明词条数、实际词条数和文件状态。 + +#### Scenario: 默认分页浏览 + +- **WHEN** 管理员打开词书列表 +- **THEN** 系统按稳定顺序返回第一页词书,并给出总数与总页数 + +#### Scenario: 按考试筛选 + +- **WHEN** 管理员选择某个考试 +- **THEN** 列表只返回该考试下的词书 + +#### Scenario: 按关键词搜索 + +- **WHEN** 管理员输入词书名称或编码的一部分 +- **THEN** 列表返回名称或编码匹配的词书 + +#### Scenario: 按文件状态筛选 + +- **WHEN** 管理员筛选“无词书文件” +- **THEN** 列表只返回没有对应清单文件的词书 + +### Requirement: 词书详情 + +系统 SHALL 展示单本词书的名称、编码、考试、描述、声明词条数、实际词条数、内容版本、封面和文件状态。 + +#### Scenario: 查看词书详情 + +- **WHEN** 管理员从列表进入某本词书 +- **THEN** 页面展示该词书的完整信息,并标明实际词条数与声明词条数是否一致 + +#### Scenario: 词书不存在 + +- **WHEN** 请求的词书 ID 不存在 +- **THEN** 系统返回明确的未找到错误,前端展示不存在提示 + +### Requirement: 词书词条清单 + +系统 SHALL 以分页方式展示词书内词条,默认按词书内顺序排列,并支持按展示词文本筛选。 + +#### Scenario: 浏览词条清单 + +- **WHEN** 管理员打开词书详情的词条清单 +- **THEN** 系统按 `seq_book` 返回第一页词条,并给出总数 + +#### Scenario: 按词筛选 + +- **WHEN** 管理员在词条清单中输入关键词 +- **THEN** 系统只返回展示词包含该关键词的词条 + +### Requirement: 封面展示 + +系统 SHALL 将词书封面相对路径拼接到外部 CDN 地址展示;封面为空或加载失败时 MUST 显示占位图,不得展示破图。 + +#### Scenario: 正常封面 + +- **WHEN** 词书存在封面路径 +- **THEN** 列表与详情展示来自 CDN 的封面图片 + +#### Scenario: 无封面或加载失败 + +- **WHEN** 词书没有封面路径或图片加载失败 +- **THEN** 页面展示统一的占位图 diff --git a/openspec/changes/add-admin-console/specs/data-quality/spec.md b/openspec/changes/add-admin-console/specs/data-quality/spec.md new file mode 100644 index 0000000..e560a17 --- /dev/null +++ b/openspec/changes/add-admin-console/specs/data-quality/spec.md @@ -0,0 +1,88 @@ +## Purpose + +汇总词库的数据质量问题,提供可解释的指标口径和到明细的下钻入口,帮助定位需要修复的数据。 + +## ADDED Requirements + +### Requirement: 质量摘要 + +系统 SHALL 提供数据质量摘要,至少包含:声明与实际词条数不一致的词书数、缺失词书文件数、缺失 zpk 引用数、无结构化义项的词条数、无义项的近义词头数、未设置考试的词书数。 + +#### Scenario: 查看质量摘要 + +- **WHEN** 管理员打开数据质量模块 +- **THEN** 页面展示上述指标的当前数值和状态 + +#### Scenario: 指标查询失败 + +- **WHEN** 某一质量指标查询失败 +- **THEN** 页面展示该指标不可用,其余指标正常展示 + +### Requirement: 指标口径说明 + +每个质量指标 SHALL 附带口径说明,明确统计范围和判定条件,避免管理员误读。 + +#### Scenario: 查看口径 + +- **WHEN** 管理员将鼠标悬停或点击指标说明 +- **THEN** 页面展示该指标的统计范围与判定条件 + +### Requirement: 声明与实际差异明细 + +系统 SHALL 列出声明词条数与实际词条数不一致的词书,展示两者数值及差值,并支持跳转到词书详情。 + +#### Scenario: 查看差异明细 + +- **WHEN** 管理员打开声明与实际差异明细 +- **THEN** 页面列出全部不一致词书及其声明数、实际数和差值 + +#### Scenario: 跳转到词书 + +- **WHEN** 管理员点击某本差异词书 +- **THEN** 前端跳转到该词书详情 + +### Requirement: 缺失引用与文件明细 + +系统 SHALL 列出缺失词书文件、缺失 zpk 引用等异常明细,并标明对应标识,便于人工核查。 + +#### Scenario: 查看缺失明细 + +- **WHEN** 管理员打开缺失明细 +- **THEN** 页面列出每个异常项的标识、来源和缺失类型 + +### Requirement: 跨域覆盖度 + +系统 SHALL 展示单词卡片、词族、近义词头与词条索引词之间的文本交集覆盖率,并说明关联是弱关联。 + +#### Scenario: 查看覆盖度 + +- **WHEN** 管理员打开跨域覆盖度视图 +- **THEN** 页面展示各域与词条索引词的交集数量、占比和未覆盖数量 + +### Requirement: 异常下钻 + +系统 SHALL 允许从质量异常项跳转到对应的词书、词条或近义词详情,前提是存在可直接定位的实体标识。 + +#### Scenario: 下钻到实体 + +- **WHEN** 管理员点击一个可定位的异常项 +- **THEN** 前端跳转到对应实体详情页 + +#### Scenario: 无法定位 + +- **WHEN** 异常项没有可定位的实体标识 +- **THEN** 页面仅展示明细,不提供跳转 + +### Requirement: 质量结果缓存 + +质量摘要与覆盖度等聚合结果 SHALL 缓存一段时间,并支持手动刷新强制重算。 + +#### Scenario: 缓存命中 + +- **WHEN** 缓存在有效期内重复访问质量模块 +- **THEN** 系统返回缓存结果 + +#### Scenario: 手动刷新 + +- **WHEN** 管理员触发刷新 +- **THEN** 系统忽略缓存并重新计算 diff --git a/openspec/changes/add-admin-console/specs/synonym-relations/spec.md b/openspec/changes/add-admin-console/specs/synonym-relations/spec.md new file mode 100644 index 0000000..2d03cf6 --- /dev/null +++ b/openspec/changes/add-admin-console/specs/synonym-relations/spec.md @@ -0,0 +1,75 @@ +## Purpose + +浏览近义词头、义项,以及按考试划分的近义词组和反义词关系。 + +## ADDED Requirements + +### Requirement: 近义词头列表与搜索 + +系统 SHALL 提供分页的近义词头列表,支持按单词搜索,并展示义项数量和是否有近义关系。 + +#### Scenario: 默认浏览 + +- **WHEN** 管理员打开近义词头列表 +- **THEN** 系统返回第一页词头及总数 + +#### Scenario: 按单词搜索 + +- **WHEN** 管理员输入单词的一部分 +- **THEN** 列表返回单词匹配的词头 + +### Requirement: 义项详情 + +系统 SHALL 展示词头下的全部义项,包括词性、中文释义,以及每个义项在各考试下的近义组和反义词。 + +#### Scenario: 查看义项 + +- **WHEN** 管理员进入某个词头详情 +- **THEN** 页面按义项展示词性和中文释义 + +#### Scenario: 无义项 + +- **WHEN** 词头没有任何义项 +- **THEN** 页面展示空状态,并保留词头本身的信息 + +### Requirement: 分考试近义组 + +系统 SHALL 对每个义项按考试展示近义组,包含规范词、成员单词、成员数量和成员顺序。 + +#### Scenario: 查看近义组 + +- **WHEN** 管理员展开某个义项的考试分组 +- **THEN** 页面展示该考试下的规范词和全部成员 + +#### Scenario: 成员较多 + +- **WHEN** 近义组成员数量超出页面承载 +- **THEN** 页面截断或分页展示,并标明完整成员数量 + +#### Scenario: 某考试无数据 + +- **WHEN** 义项在某个考试下没有近义组 +- **THEN** 该考试不展示为空组 + +### Requirement: 反义词展示 + +系统 SHALL 展示每个义项在各考试下的反义词。 + +#### Scenario: 查看反义词 + +- **WHEN** 义项存在反义词 +- **THEN** 页面在对应考试分组下展示反义词 + +#### Scenario: 无反义词 + +- **WHEN** 义项没有反义词 +- **THEN** 反义词区域展示空状态 + +### Requirement: 组规模分布 + +系统 SHALL 提供近义组规模分布视图,展示不同成员数量的组占比,帮助识别异常过大或过小的组。 + +#### Scenario: 查看分布 + +- **WHEN** 管理员打开近义词模块的分布视图 +- **THEN** 页面展示按成员数量分桶的组数量与占比 diff --git a/openspec/changes/add-admin-console/specs/word-lexicon/spec.md b/openspec/changes/add-admin-console/specs/word-lexicon/spec.md new file mode 100644 index 0000000..edad418 --- /dev/null +++ b/openspec/changes/add-admin-console/specs/word-lexicon/spec.md @@ -0,0 +1,108 @@ +## Purpose + +搜索并查看单个词条的完整词典内容,覆盖释义、短语、例句、易混词及其被词书收录的情况。 + +## ADDED Requirements + +### Requirement: 词条搜索与列表 + +系统 SHALL 提供分页的词条列表,支持按原形或归一化索引词模糊搜索;列表 MUST 展示原形、音标、释义摘要、义项数量和收录词书数。 + +#### Scenario: 默认浏览 + +- **WHEN** 管理员打开词条列表 +- **THEN** 系统返回第一页词条及总数 + +#### Scenario: 按词搜索 + +- **WHEN** 管理员输入单词的一部分 +- **THEN** 系统返回原形或索引词匹配的词条 + +#### Scenario: 无匹配结果 + +- **WHEN** 搜索结果为空 +- **THEN** 页面展示空状态,而不是错误 + +### Requirement: 词条基本信息 + +系统 SHALL 展示词条的原形、索引词、美式与英式音标、释义原文、数据版本、所属考试和来源标识。 + +#### Scenario: 查看基本信息 + +- **WHEN** 管理员进入词条详情 +- **THEN** 页面展示该词条的基本字段 + +#### Scenario: 词条不存在 + +- **WHEN** 请求的词条 ID 不存在 +- **THEN** 系统返回未找到错误,前端展示不存在提示 + +### Requirement: 义项浏览 + +系统 SHALL 展示词条的结构化义项,包括序号、词性、中文释义、关联考试和义项关系。 + +#### Scenario: 有结构化义项 + +- **WHEN** 词条存在结构化义项 +- **THEN** 页面按序号展示全部义项及其考试和关系 + +#### Scenario: 无结构化义项 + +- **WHEN** 词条没有任何结构化义项 +- **THEN** 义项区域展示空状态,并在基本信息中保留原始释义文本 + +### Requirement: 短语浏览 + +系统 SHALL 展示词条关联的短语,包括英文、中文、所属义项、分组类型和关联考试。 + +#### Scenario: 查看短语 + +- **WHEN** 管理员打开短语区域 +- **THEN** 页面展示该词条的短语列表及其考试关联 + +#### Scenario: 无短语 + +- **WHEN** 词条没有短语 +- **THEN** 短语区域展示空状态 + +### Requirement: 例句浏览 + +系统 SHALL 按例句组展示例句,包含例句文本、翻译、使用模式和来源类型;数据量较大时 MUST 分页。 + +#### Scenario: 查看例句 + +- **WHEN** 管理员打开例句区域 +- **THEN** 页面按例句组展示第一页例句 + +#### Scenario: 例句较多 + +- **WHEN** 词条例句数量超过一页 +- **THEN** 页面提供分页,不得一次性加载全部例句 + +#### Scenario: 无例句 + +- **WHEN** 词条没有例句 +- **THEN** 例句区域展示空状态 + +### Requirement: 易混词浏览 + +系统 SHALL 展示词条的易混词及其辨析信息。 + +#### Scenario: 查看易混词 + +- **WHEN** 管理员打开易混词区域 +- **THEN** 页面展示易混词列表及辨析内容 + +### Requirement: 收录词书浏览 + +系统 SHALL 分页展示收录该词书的词书,包括词书名称、词书内展示词和顺序。 + +#### Scenario: 查看收录词书 + +- **WHEN** 管理员打开收录词书区域 +- **THEN** 页面分页展示收录该词条的词书及词书内顺序 + +#### Scenario: 未被任何词书收录 + +- **WHEN** 词条没有被任何词书收录 +- **THEN** 收录词书区域展示空状态 diff --git a/openspec/changes/add-admin-console/specs/word-morphology/spec.md b/openspec/changes/add-admin-console/specs/word-morphology/spec.md new file mode 100644 index 0000000..41b37a7 --- /dev/null +++ b/openspec/changes/add-admin-console/specs/word-morphology/spec.md @@ -0,0 +1,90 @@ +## Purpose + +浏览词素(前缀、词根、后缀)、单词卡片、词族及其层级关系,支持以树形结构理解词族组成。 + +## ADDED Requirements + +### Requirement: 词素列表与筛选 + +系统 SHALL 提供分页的词素列表,支持按词素类型(前缀、词根、后缀)和词形关键词筛选,并展示词形、类型、英文释义和中文释义。 + +#### Scenario: 默认浏览词素 + +- **WHEN** 管理员打开词素列表 +- **THEN** 系统返回第一页词素及总数 + +#### Scenario: 按类型筛选 + +- **WHEN** 管理员选择“前缀” +- **THEN** 列表只返回前缀类型词素 + +#### Scenario: 按词形搜索 + +- **WHEN** 管理员输入词形的一部分 +- **THEN** 列表返回词形匹配的词素 + +### Requirement: 词素详情 + +系统 SHALL 展示词素的完整释义、备注以及引用该词素的单词卡片。 + +#### Scenario: 查看词素详情 + +- **WHEN** 管理员进入某个词素详情 +- **THEN** 页面展示词素信息及关联卡片列表 + +#### Scenario: 词素不存在 + +- **WHEN** 请求的词素 ID 不存在 +- **THEN** 系统返回未找到错误,前端展示不存在提示 + +### Requirement: 单词卡片列表与详情 + +系统 SHALL 提供分页的单词卡片列表,支持按单词搜索;详情展示单词、记忆提示、例句、关联词素、适用考试和关联词族。 + +#### Scenario: 浏览卡片 + +- **WHEN** 管理员打开卡片列表 +- **THEN** 系统返回第一页卡片及总数 + +#### Scenario: 查看卡片详情 + +- **WHEN** 管理员进入某个卡片详情 +- **THEN** 页面展示卡片内容、关联词素和适用考试 + +### Requirement: 词族列表与详情 + +系统 SHALL 提供分页的词族列表,支持按单词搜索;详情展示词族词条、顶层词族、变体、小组、关联考试和族内顺序。 + +#### Scenario: 浏览词族 + +- **WHEN** 管理员打开词族列表 +- **THEN** 系统返回第一页词族及总数 + +#### Scenario: 查看词族详情 + +- **WHEN** 管理员进入某个词族详情 +- **THEN** 页面展示该词族的基础信息、变体和小组 + +### Requirement: 树形族谱 + +系统 SHALL 以可展开的树形结构展示词族层级:顶层词族节点可展开其变体与小组,最末级展示成员单词。节点必须标明自身类型和成员数量。 + +#### Scenario: 展开节点 + +- **WHEN** 管理员展开一个顶层词族节点 +- **THEN** 系统加载并展示其子节点,节点类型和成员数量清晰可见 + +#### Scenario: 收起节点 + +- **WHEN** 管理员收起已展开的节点 +- **THEN** 其子节点从视图中移除 + +#### Scenario: 成员过多 + +- **WHEN** 某个节点的成员数量超过一页 +- **THEN** 系统分页或懒加载成员,不得一次性渲染全部成员 + +#### Scenario: 空族谱 + +- **WHEN** 顶层词族没有变体、小组或成员 +- **THEN** 页面展示空状态,节点仍可正常展开和收起 diff --git a/openspec/changes/add-admin-console/tasks.md b/openspec/changes/add-admin-console/tasks.md new file mode 100644 index 0000000..47c76a9 --- /dev/null +++ b/openspec/changes/add-admin-console/tasks.md @@ -0,0 +1,91 @@ +## 1. 工程骨架与配置 + +- [x] 1.1 在 `backend/` 创建 Maven 工程:Spring Boot 3.3.x、Java 17、Web / Security / Validation / MyBatis-Plus / MySQL Driver / Caffeine 依赖 +- [x] 1.2 创建 `application.yml` 与 `application-dev.yml`,配置数据源、Hikari `read-only`、连接超时、UTF-8、MyBatis-Plus 分页插件 +- [x] 1.3 提供 `application.example.yml` 与后端 `.env.example`,列出 `DB_URL`、`DB_USERNAME`、`DB_PASSWORD`、`ADMIN_USERNAME`、`ADMIN_PASSWORD_HASH`、`JWT_SECRET`、`COVER_BASE_URL` +- [x] 1.4 实现统一响应结构 `{ code, message, data }`、分页结构 `{ items, total, page, size }` 和全局异常处理(400/401/404/500) +- [x] 1.5 配置 CORS 白名单与请求日志,确保中文 UTF-8 正常 +- [x] 1.6 在 `frontend/` 创建 Vite + Vue 3 + TypeScript 工程,接入 Element Plus、ECharts、Pinia、Vue Router、Axios +- [x] 1.7 配置前端环境变量 `VITE_API_BASE_URL`、Vite 开发代理 `/api`、路径别名和基础目录结构 + +## 2. 认证与后台框架 + +- [x] 2.1 后端实现管理员凭据读取与启动校验:缺少 `ADMIN_USERNAME` / `ADMIN_PASSWORD_HASH` / `JWT_SECRET` 时启动失败并输出缺失项 +- [x] 2.2 实现 `POST /api/auth/login`:校验 BCrypt 密码,签发 HS256 JWT,返回 token 与过期时间 +- [x] 2.3 实现 JWT 校验过滤器与 Spring Security 配置,除登录接口外全部要求认证,失败统一返回 401 +- [x] 2.4 为全部 Service 启用 `@Transactional(readOnly = true)`,确认不存在任何写 Mapper 方法 +- [x] 2.5 前端实现登录页、auth store、token 持久化和退出逻辑 +- [x] 2.6 前端实现路由守卫与 Axios 拦截器:注入 token、解包响应、401 时清理状态并跳转登录页 +- [x] 2.7 前端实现后台布局:侧边栏导航(概览/词书/词条/词根词族/近反义词/数据质量)、顶栏、退出入口 +- [x] 2.8 封装通用组件:分页表格、加载态、空状态、错误态、指标卡、图表卡、封面占位图 + +## 3. 概览模块 + +- [x] 3.1 实现 `GET /api/dashboard/summary`:词书、词条、关联、例句、词族、近义词头六项总量 +- [x] 3.2 实现 `GET /api/dashboard/exam-distribution`:按考试统计词书数与关联词条数,包含“未归类” +- [x] 3.3 实现 `GET /api/dashboard/book-size-top`:实际词条数 Top 10 与声明词条数 +- [x] 3.4 实现 `GET /api/dashboard/pos-distribution`:按词性统计义项数 +- [x] 3.5 配置 Caffeine 缓存(默认 10 分钟)与 `refresh=true` 强制刷新 +- [x] 3.6 前端实现概览页:六项 KPI、考试分布图、规模排行、词性分布、质量红绿灯与跳转 +- [x] 3.7 验证缓存命中与手动刷新行为,确认重复进入概览不重复执行重聚合 + +## 4. 词书模块 + +- [x] 4.1 实现 `GET /api/books`:分页,支持 `examId`、`keyword`、`hasFile` 筛选,返回声明/实际词条数 +- [x] 4.2 实现 `GET /api/books/{id}`:词书详情与声明/实际差异标识,处理不存在返回 404 +- [x] 4.3 实现 `GET /api/books/{id}/entries`:按 `seq_book` 分页,支持展示词关键词筛选 +- [x] 4.4 前端实现词书列表页:筛选栏、封面对齐 CDN、分页、文件状态标识 +- [x] 4.5 前端实现词书详情页:信息卡、封面与占位图、词条清单分页与搜索 +- [x] 4.6 验证无封面词书、无文件词书、空词条清单的展示 + +## 5. 词条模块 + +- [x] 5.1 实现 `GET /api/entries`:按 `headword` / `index_word` 模糊搜索,分页,返回义项数与收录词书数 +- [x] 5.2 实现 `GET /api/entries/{id}`:基本信息与原始释义,处理 404 +- [x] 5.3 实现义项接口:义项、考试、义项关系、考试义项顺序 +- [x] 5.4 实现短语接口:短语、分组类型、考试关联与顺序 +- [x] 5.5 实现例句接口:例句组、使用模式、例句句子,支持分页 +- [x] 5.6 实现易混词接口与拼写变体接口 +- [x] 5.7 实现 `GET /api/entries/{id}/books`:分页返回收录词书、词书内展示词与顺序 +- [x] 5.8 前端实现词条搜索页与详情页,子资源按 Tab 懒加载 +- [x] 5.9 验证无结构化义项(约 5,250 条)、无短语、无例句、未被收录等空状态 +- [x] 5.10 验证例句较多的词条分页正确,不一次性加载全部数据 + +## 6. 词根词族模块 + +- [x] 6.1 实现 `GET /api/morphemes`:按类型与词形筛选,分页 +- [x] 6.2 实现 `GET /api/morphemes/{id}`:词素详情与引用它的卡片 +- [x] 6.3 实现 `GET /api/cards` 与 `/api/cards/{id}`:卡片列表、详情、关联词素与考试 +- [x] 6.4 实现 `GET /api/families` 与 `/api/families/{id}`:词族列表、详情、变体与小组 +- [x] 6.5 实现 `GET /api/families/{id}/tree`:按节点类型懒加载子节点,成员分页 +- [x] 6.6 前端实现词素列表/详情页,按 prefix/root/suffix 标注类型 +- [x] 6.7 前端实现卡片列表/详情页 +- [x] 6.8 前端实现词族列表/详情页与 `el-tree` 懒加载树形族谱,支持展开、收起和成员分页 +- [x] 6.9 验证空族谱、成员过多节点、深层嵌套节点的展开与收起(当前数据无空族谱实例,界面已覆盖空数组;懒加载展开/收起已验证) + +## 7. 近反义词模块 + +- [x] 7.1 实现 `GET /api/synonyms`:词头分页与搜索,返回义项数 +- [x] 7.2 实现 `GET /api/synonyms/{wordId}`:词头、义项、分考试近义组(规范词、成员、顺序)与反义词 +- [x] 7.3 实现 `GET /api/synonyms/group-size-distribution`:成员数量分桶统计 +- [x] 7.4 前端实现词头列表、详情页与组规模分布图 +- [x] 7.5 验证无义项词头(约 19 个)、某考试无数据、成员过多时的截断或分页展示(词头 131 已验证无义项;现有最大成员数 22,截断逻辑已覆盖) + +## 8. 数据质量模块 + +- [x] 8.1 实现 `GET /api/quality/summary`:六项关键指标与口径说明 +- [x] 8.2 实现 `GET /api/quality/declared-vs-actual`:声明与实际差异词书明细 +- [x] 8.3 实现 `GET /api/quality/missing-references`:缺失文件、缺失 zpk 等明细 +- [x] 8.4 实现 `GET /api/quality/cross-domain-coverage`:卡片/词族/近义词与词条索引词的覆盖率 +- [x] 8.5 为质量聚合结果接入 Caffeine 缓存与强制刷新 +- [x] 8.6 前端实现数据质量页:摘要、口径提示、差异表、缺失明细、覆盖度图与实体跳转 +- [x] 8.7 验证可定位异常项跳转正确,不可定位异常项只展示明细 + +## 9. 联调、验证与交付 + +- [x] 9.1 用真实数据库完成六个模块的端到端联调,确认登录、分页、筛选、详情与空状态 +- [ ] 9.2 验证只读约束:代码中无写 Mapper;Hikari 与应用事务为只读;与用户确认后创建并切换到只读数据库账号(代码、Hikari、事务只读已验证;只读数据库账号待用户确认后创建) +- [x] 9.3 检查关键查询耗时,确认概览与质量页命中缓存,列表与详情响应在可接受范围 +- [x] 9.4 为认证、分页边界、404、空状态和缓存刷新补充后端测试 +- [x] 9.5 更新 `backend/README.md` 与 `frontend/README.md`:环境变量、启动命令、构建与部署方式 +- [x] 9.6 构建后端 jar 与前端 `dist`,按前后端分离方式做一次本地部署演练