diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..0eb01d1 --- /dev/null +++ b/.env.example @@ -0,0 +1,16 @@ +DB_URL=jdbc:postgresql://localhost:5432/myspace +DB_USER=myspace +DB_PASSWORD=replace-with-a-long-database-password +ADMIN_USERNAME=admin +ADMIN_PASSWORD=replace-with-a-unique-password +STORAGE_PATH=./data/assets +COOKIE_SECURE=false + +# 本机验收使用 Docker Hub 官方直连;设为 docker.io 可使用 Docker 配置中的镜像加速服务。 +IMAGE_REGISTRY=registry-1.docker.io + +# Optional server-side AI provider. Use the base API URL, including /v1 when required. +AI_BASE_URL= +AI_API_KEY= +AI_CHAT_MODELS= +AI_IMAGE_MODELS= diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e1b688f --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +.env +.local/ +backend/target/ +backend/data/ +frontend/node_modules/ +frontend/dist/ +output/playwright/*.zip +*.log +.DS_Store + +.playwright-cli/ diff --git a/README.md b/README.md new file mode 100644 index 0000000..b6b1ebe --- /dev/null +++ b/README.md @@ -0,0 +1,120 @@ +# MySpace + +新版界面以 [MySpace V4 开发交接](docs/v4-development.md) 为参考。管理页支持 `/admin/notes`、`/admin/blog`、`/admin/assets`、`/admin/bookmarks` 等直接访问。公开博客使用双栏文章和侧栏索引,支持分类、全文搜索与 RSS。公开导航提供分类书签和搜索。公开 AI 工作台位于 `/ai`,当前为访客界面预览。 + +基于实际 HTML 原型实现的个人知识与数字资产平台。Java 21 + Spring Boot 3 模块化单体,Vue 3 + TypeScript + Vite + Element Plus,PostgreSQL 16 + Flyway,单用户,REST `/api/v1`。 + +源原型位于 `/Users/xzh/Documents/MySpace/prototype`,保持原样。工程位于 `/Users/xzh/Documents/project/MySpace`。详细页面/API/数据库映射和后续五阶段计划见 [实施计划](docs/implementation-plan.md)。 + +## 已实现 + +- 工作台、登录、全局搜索和深浅色主题。 +- 知识库包含文件夹、分类、多标签、模板、列表和网格、批量管理、双链、反向链接及图谱。编辑器自动保存,支持版本预览、恢复和带元数据的 Markdown 导出。 +- 博客支持分类、草稿与已发布状态、笔记和博客互转、网络或图床封面、Markdown 即时预览与整篇预览。 +- 图床包含图片管理、文件管理、存储概览、文件夹、分类与标签、批量整理、素材元数据编辑,以及 URL、Markdown、HTML 和 BBCode 引用。 +- 书签包含常用收藏、手动顺序、标签、图标和打开方式设置、批量管理、HTML/JSON 导入预览与导出。 +- 书签和文件信息可转入收集箱,保留来源和整理状态。 +- 四个模块均有回收站。素材恢复后保留原链接,仍有引用的素材无法永久删除。 +- 「公开发布」以服务器快照同步博客与勾选的书签。已公开内容的普通编辑等待再次同步;文章转草稿、移入回收站或取消书签公开后立即撤回。已存在的公开链接沿用原地址。 + +## 后台 V4 + +- 工具中心含标签、版本、统一回收站、批量管理、工作流、浏览器工具和联动说明,均可单独打开。 +- RSS 可管理订阅、手动获取公开 RSS/Atom、阅读和收藏,并转存到收集箱、笔记或待办。仅在本机网络返回合成 DNS 地址时,使用 `RSS_PUBLIC_DNS` 指定的公开解析服务获取真实公网地址。 +- 效率中心提供待办、月历和代码片段。收集箱支持手动收集、浏览器书签收集和去重转存。 +- 设置支持个人资料、主题、自动保存偏好,以及有预览的非覆盖式 JSON 导入。备份导出包含文件清单,附件内容需另行备份。 +- AI Studio 的历史、素材、提示词、模型、用量和日志接入真实数据。可在部署环境设置 `AI_BASE_URL`、`AI_API_KEY`、`AI_CHAT_MODELS`、`AI_IMAGE_MODELS`,其中模型列表使用逗号分隔。支持 Chat Completions 和返回 PNG Base64 的 Images API。密钥只留在服务端。公开发布面板支持选择公开提示词和生成图片,访客生成当前关闭。 + +## Docker Compose 运行 + +需要 Docker Engine / Docker Desktop 和 Compose v2: + +```sh +cp .env.example .env +# 必须在首次启动前编辑 .env:设置独立的数据库密码和 12–72 字符的账户密码 +# 不要使用示例值作为实际密码(示例密码仍可通过登录校验) + +docker compose up --build -d +``` + +Compose 项目名固定为 `myspace`(`compose.yml` 中的 `name:`),无论目录名如何。首次启动时 `DB_PASSWORD` 决定数据库角色密码,`ADMIN_PASSWORD` 决定初始账户密码;容器重建**不会**修改已有的角色密码和账户密码,修改 `.env` 后需手动重置,见下。启动顺序为 db → backend(健康检查通过)→ frontend;后端的健康检查只探测 8080 端口可连接,首启动(Flyway 迁移 + 账号初始化)大约需要 10 秒。 + +打开 http://localhost:8088 ,使用 `.env` 中的 `ADMIN_USERNAME` 和 `ADMIN_PASSWORD`。数据库和文件分别保存在命名卷 `myspace_postgres-data`、`myspace_asset-data`。`docker compose down` 保留数据;不要随意使用 `down -v`。修改初始化环境变量不会修改数据库内的账户密码。没有密码重置界面。 + +已有数据卷时修改密码(不删除数据;在工程根目录执行,`db` 容器需先停止): + +```sh +set -a; . ./.env; set +a # 读取 DB_PASSWORD;也可换成任意密码 +docker compose stop db +docker run --rm --user postgres -e NEWPW="$DB_PASSWORD" \ + -v myspace_postgres-data:/var/lib/postgresql/data \ + registry-1.docker.io/library/postgres:16-alpine \ + sh -c 'printf "ALTER ROLE myspace PASSWORD %s;\n" "$(printf "%s" "$NEWPW" | sed "s/'"'"'/'"'"''"'"'/g; s/^/'"'"'/; s/$/'"'"'/")" | postgres --single -D /var/lib/postgresql/data postgres' +docker compose up -d +``` + +账户密码需要重新生成 BCrypt 哈希后写入 `app_user`,见 [容器验收](docs/container-testing.md) 的「重置账户密码」。 + +默认仅绑定回环地址,本机访问使用 HTTP;若配置外部 HTTPS 入口,将 `COOKIE_SECURE=true`。后端不直接暴露端口,前端 Nginx 同源代理 API。尚未提供公网部署加固、登录限速、MFA 或自动备份。2026-11-10 已在 Docker Desktop 上完成前后端镜像构建、Compose 启动、28 项接口/持久化检查及浏览器验证;详见 [容器验收](docs/container-testing.md)。 + +## 本机开发 + +需要 Java 21、Maven 3.9+、Node 22.13+(本机验证 Node 24)、PostgreSQL 16。创建 `myspace` 数据库和有权限的专用角色。 + +```sh +cp .env.example .env +# 修改 DB_URL / DB_USER / DB_PASSWORD / ADMIN_PASSWORD +set -a +. ./.env +set +a +mvn -f backend/pom.xml spring-boot:run +``` + +也可在配置 `.env` 后运行 `./scripts/dev.sh` 同时启动前后端(数据库需先启动)。 + +另开终端: + +```sh +cd frontend +npm ci +npm run dev +``` + +打开 http://localhost:5173 。Vite 将 `/api` 转发到 `127.0.0.1:8080`。首次启动由 Flyway 建表,然后初始化账户。空数据库启动时必须提供有效密码,否则启动失败。 + +当前 Mac 的默认 Java 是 8,应先设置: + +```sh +export JAVA_HOME=/Applications/ServBay/package/openjdk/21/21.0.10/zulu-21.jdk/Contents/Home +export PATH="$JAVA_HOME/bin:$PATH" +``` + +本次本地验证的独立 PostgreSQL 数据目录为 `.local/pgdata`,监听 `127.0.0.1:55432`,开发角色 `myspace`,仅用于本机验证、使用 trust 认证,不适用于部署。日志为 `.local/backend.log`、`.local/frontend.log`、`.local/postgres.log`。停止验证数据库可执行 `pg_ctl -D .local/pgdata stop`(使用 PostgreSQL 16 工具)。 + +## 构建与测试 + +后端集成测试使用真实 PostgreSQL,不使用 H2。**必须准备独立测试数据库**;测试会清空 `notes`、`assets` 和 `blogs`,切勿指向业务数据库。 + +```sh +# 先创建 myspace_test 数据库 +export TEST_DB_URL=jdbc:postgresql://localhost:55432/myspace_test +export TEST_DB_USER=myspace +export TEST_DB_PASSWORD='' +export DB_PASSWORD=unused +mvn -f backend/pom.xml verify +npm --prefix frontend ci +npm --prefix frontend test +npm --prefix frontend run build +``` + +测试账户固定为 `admin / integration-test-password`,仅存在于测试库;测试资产在 `backend/target/test-assets`。 + +后端 4 组集成测试覆盖未认证拒绝、登录失败、CSRF 拒绝、退出、密码散列、笔记完整 CRUD、输入校验、版本冲突、工作台聚合、私有文件上传/跨会话读取/下载/删除,以及博客的默认草稿、状态切换、状态筛选、搜索、版本冲突、非法状态和删除;公开博客只暴露已发布文章、草稿 slug 返回 404、匿名可读且不返回内部字段、ETag 条件请求返回 304。前端 5 项测试覆盖 Markdown 渲染、脚本及危险链接清理、原始 HTML 媒体/容器标签移除、http(s) 图片保留和外部链接新标签页打开。浏览器验收记录见 [验证记录](docs/verification.md)。 + +## API 与数据 + +见 [API 说明](docs/api.md)。第二版迁移 `V2__blogs.sql` 新增 `blogs` 表(status 有 CHECK 约束,按状态+更新时间建索引);第三版迁移 `V3__public_blogs.sql` 为文章增加唯一 `slug` 并回填历史文章。代码按 `auth`、`notes`、`blogs`、`assets`、`dashboard`、`common` 分包;`PublicBlogsController` 提供公开只读接口,`common/SecurityHeaders` 统一输出 `X-Content-Type-Options`、`Referrer-Policy`、`X-Frame-Options`。所有业务模块在同一进程内运行,共用一个数据库。第一版使用 Spring JDBC 参数化 SQL,迁移文件在 `backend/src/main/resources/db/migration`。 + +文件以随机 UUID 保存,客户端文件名不参与存储路径;不执行上传内容。数据库与文件系统不具备跨介质事务保证,进程崩溃时可能产生孤立文件或缺失内容;缺失文件返回 404。备份必须同时保存 PostgreSQL 和资产目录,后续阶段实现备份/恢复及清理任务。 + +认证实现参考 [Spring Security CSRF 文档](https://docs.spring.io/spring-security/reference/servlet/exploits/csrf.html):登录及退出后重新获取 CSRF token。前端运行环境参考 [Vite 官方说明](https://vite.dev/guide/)。 diff --git a/backend/.dockerignore b/backend/.dockerignore new file mode 100644 index 0000000..80ddbfc --- /dev/null +++ b/backend/.dockerignore @@ -0,0 +1,2 @@ +target +data diff --git a/backend/.idea/.gitignore b/backend/.idea/.gitignore new file mode 100644 index 0000000..f3b42f4 --- /dev/null +++ b/backend/.idea/.gitignore @@ -0,0 +1,12 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Markdown personal settings +/markdown.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Ignored default folder with query files +/queries/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/backend/.idea/ApifoxUploaderProjectSetting.xml b/backend/.idea/ApifoxUploaderProjectSetting.xml new file mode 100644 index 0000000..6ce63cc --- /dev/null +++ b/backend/.idea/ApifoxUploaderProjectSetting.xml @@ -0,0 +1,8 @@ + + + + + \ No newline at end of file diff --git a/backend/.idea/compiler.xml b/backend/.idea/compiler.xml new file mode 100644 index 0000000..dabe1aa --- /dev/null +++ b/backend/.idea/compiler.xml @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/backend/.idea/encodings.xml b/backend/.idea/encodings.xml new file mode 100644 index 0000000..63e9001 --- /dev/null +++ b/backend/.idea/encodings.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/backend/.idea/inspectionProfiles/Project_Default.xml b/backend/.idea/inspectionProfiles/Project_Default.xml new file mode 100644 index 0000000..8d66637 --- /dev/null +++ b/backend/.idea/inspectionProfiles/Project_Default.xml @@ -0,0 +1,5 @@ + + + + \ No newline at end of file diff --git a/backend/.idea/jarRepositories.xml b/backend/.idea/jarRepositories.xml new file mode 100644 index 0000000..abb532a --- /dev/null +++ b/backend/.idea/jarRepositories.xml @@ -0,0 +1,20 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/backend/.idea/misc.xml b/backend/.idea/misc.xml new file mode 100644 index 0000000..a529c76 --- /dev/null +++ b/backend/.idea/misc.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + 常规 + + + + + 用户定义 + + + + + + + + + \ No newline at end of file diff --git a/backend/.idea/vcs.xml b/backend/.idea/vcs.xml new file mode 100644 index 0000000..6c0b863 --- /dev/null +++ b/backend/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/backend/Dockerfile b/backend/Dockerfile new file mode 100644 index 0000000..d0ad2d6 --- /dev/null +++ b/backend/Dockerfile @@ -0,0 +1,13 @@ +ARG IMAGE_REGISTRY=docker.io +FROM ${IMAGE_REGISTRY}/library/maven:3.9-eclipse-temurin-21 AS build +WORKDIR /app +COPY pom.xml . +COPY src src +RUN --mount=type=cache,id=myspace-maven,target=/root/.m2,sharing=locked mvn -B -U package -DskipTests +FROM ${IMAGE_REGISTRY}/library/eclipse-temurin:21-jre +WORKDIR /app +RUN useradd --system --uid 10001 myspace && mkdir -p /data/assets && chown -R myspace /data +COPY --from=build /app/target/myspace-0.1.0.jar app.jar +USER myspace +EXPOSE 8080 +ENTRYPOINT ["java","-jar","app.jar"] diff --git a/backend/pom.xml b/backend/pom.xml new file mode 100644 index 0000000..2230ea4 --- /dev/null +++ b/backend/pom.xml @@ -0,0 +1,4 @@ +4.0.0org.springframework.bootspring-boot-starter-parent3.5.7com.myspacemyspace0.1.021 +org.apache.httpcomponents.client5httpclient5 +org.commonmarkcommonmark0.24.0 +org.springframework.bootspring-boot-starter-weborg.springframework.bootspring-boot-starter-securityorg.springframework.bootspring-boot-starter-validationorg.springframework.bootspring-boot-starter-jdbcorg.flywaydbflyway-coreorg.flywaydbflyway-database-postgresqlorg.postgresqlpostgresqlruntimeorg.springframework.bootspring-boot-starter-testtestorg.springframework.securityspring-security-testtestorg.springframework.bootspring-boot-maven-plugin \ No newline at end of file diff --git a/backend/src/main/java/com/myspace/MySpaceApplication.java b/backend/src/main/java/com/myspace/MySpaceApplication.java new file mode 100644 index 0000000..7f2b716 --- /dev/null +++ b/backend/src/main/java/com/myspace/MySpaceApplication.java @@ -0,0 +1,11 @@ +package com.myspace; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class MySpaceApplication { + public static void main(String[] args) { + SpringApplication.run(MySpaceApplication.class, args); + } +} diff --git a/backend/src/main/java/com/myspace/admin/AdminSearchController.java b/backend/src/main/java/com/myspace/admin/AdminSearchController.java new file mode 100644 index 0000000..a81ce11 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/AdminSearchController.java @@ -0,0 +1,39 @@ +package com.myspace.admin; + +import jakarta.validation.constraints.Size; +import java.util.List; +import java.util.Map; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.*; + +@RestController +@RequestMapping("/api/v1/search") +public class AdminSearchController { + private final JdbcTemplate db; + public AdminSearchController(JdbcTemplate db) { this.db=db; } + + @GetMapping + public List> search(@RequestParam(defaultValue="") @Size(max=250) String q) { + if(q.isBlank()) return List.of(); + return db.queryForList(""" + with records(kind,id,title,hint,searchable) as ( + select 'notes',id,title,category,title || ' ' || body || ' ' || tags from notes where deleted_at is null + union all select 'blogs',id,title,category,title || ' ' || summary || ' ' || body from blogs where deleted_at is null + union all select 'assets',id,name,folder,name || ' ' || description || ' ' || tags from assets where deleted_at is null + union all select 'bookmarks',id,title,category,title || ' ' || url || ' ' || description || ' ' || tags from bookmarks where deleted_at is null + union all select kind,id,title,category,title || ' ' || body || ' ' || tags from planner_items where deleted_at is null + union all select 'rss',a.id,a.title,s.title,a.title || ' ' || a.body || ' ' || s.title + from rss_articles a join rss_sources s on s.id=a.source_id + where a.deleted_at is null and s.deleted_at is null + union all select 'prompts',id,title,category,title || ' ' || body from ai_prompts where deleted_at is null + union all select mode,id,left(prompt,100),model,prompt || ' ' || coalesce(response,'') + from ai_runs r where r.mode='chat' or exists(select from assets a where a.id=r.asset_id and a.deleted_at is null) + union all select 'inbox',id,title,source_kind,title || ' ' || content from inbox_items where deleted_at is null + ), ranked as ( + select kind,id,title,hint,row_number() over(partition by kind order by title,id) as position from records + where position(lower(?) in lower(searchable))>0 + ) + select kind,id,title,hint from ranked where position<=10 order by position,kind,title + """,q.strip()); + } +} diff --git a/backend/src/main/java/com/myspace/admin/AdminToolsController.java b/backend/src/main/java/com/myspace/admin/AdminToolsController.java new file mode 100644 index 0000000..e078821 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/AdminToolsController.java @@ -0,0 +1,236 @@ +package com.myspace.admin; + +import com.myspace.common.WorkspaceNotifications; +import com.myspace.library.TrashService; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/admin-tools") +public class AdminToolsController { + private final JdbcTemplate db; + private final TrashService trash; + private final WorkspaceNotifications notifications; + public AdminToolsController(JdbcTemplate db,TrashService trash,WorkspaceNotifications notifications) { + this.db=db; this.trash=trash; this.notifications=notifications; + } + private static final String TAG_ROWS = """ + select tags from notes where deleted_at is null + union all select tags from assets where deleted_at is null + union all select tags from bookmarks where deleted_at is null + union all select tags from planner_items where deleted_at is null + """; + /** 原型统一回收站:笔记/博客/书签/素材/待办/日程/代码片段,另含 RSS 订阅、提示词、工作流。 */ + private static final String TRASH = """ + select 'notes' as kind,id,title,deleted_at,category from notes + union all select 'blogs',id,title,deleted_at,category from blogs + union all select 'bookmarks',id,title,deleted_at,category from bookmarks + union all select 'assets',id,name,deleted_at,category from assets + union all select kind,id,title,deleted_at,'' from planner_items + union all select 'rss',id,title,deleted_at,category from rss_sources + union all select 'prompts',id,title,deleted_at,category from ai_prompts + union all select 'flows',id,title,deleted_at,'' from workspace_flows + union all select 'inbox',id,title,deleted_at,'收集箱' from inbox_items + """; + + public record Name(@NotBlank @Size(max=60) String name) {} + public record Flow(@NotBlank @Size(max=60) String title,@NotBlank @Size(max=8000) String instructions) {} + public record Preferences(@NotBlank @Size(max=60) String display_name,@NotNull @Size(max=300) String bio, boolean autosave) {} + + /** 工具中心各入口的计数与待同步状态;另外附带各标签页的回收站计数,首页汇总一次取回。 */ + @GetMapping("/summary") + @Transactional(readOnly=true) + public Map summary() { + var publication = db.queryForMap(""" + select published_at, + exists(select from blogs b left join published_blogs p on p.id=b.id + where b.deleted_at is null and b.status='published' and b.version is distinct from p.version) + or exists(select from bookmarks b left join published_bookmarks p on p.id=b.id where b.deleted_at is null and b.is_public + and (b.title,b.url,b.description,b.category,b.icon_asset_id,b.icon_mode,b.icon_url,b.new_window,b.sort_order) + is distinct from (p.title,p.url,p.description,p.category,p.icon_asset_id,p.icon_mode,p.icon_url,p.new_window,p.sort_order)) + or exists(select from ai_prompts a join published_ai_prompts p on p.id=a.id + where (a.title,a.body,a.category) is distinct from (p.title,p.body,p.category)) as pending + from publication_state where id=1 + """); + return Map.of("publication",publication, + "unread",db.queryForObject("select count(*) from workspace_notifications where read_at is null",Long.class), + "trash",db.queryForObject("select count(*) from ("+TRASH+") t where deleted_at is not null",Long.class), + "versions",db.queryForObject("select count(*) from note_history h join notes n on n.id=h.note_id where n.deleted_at is null",Long.class), + "tags",tags().size(), + "flows",db.queryForObject("select count(*) from workspace_flows where deleted_at is null",Long.class), + "inbox",db.queryForObject("select count(*) from inbox_items where processed_at is null and deleted_at is null",Long.class), + "trashByKind",trashByKind()); + } + + private List> trashByKind() { + return db.queryForList("select kind,count(*) as count from ("+TRASH+") t where deleted_at is not null group by kind"); + } + + @GetMapping("/notifications") + public List> notifications() { + return db.queryForList("select * from workspace_notifications order by id desc limit 50"); + } + + @PutMapping("/notifications") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void readNotifications() { + db.update("update workspace_notifications set read_at=now() where read_at is null"); + } + + @GetMapping("/tags") + public List> tags() { + return db.queryForList("with names as (select distinct tag.name as name from ("+TAG_ROWS+") r" + + " cross join lateral unnest(string_to_array(r.tags,',')) as tag(name) where tag.name<>'')" + + " select names.name, (select count(*) from ("+TAG_ROWS+") r" + + " where names.name=any(string_to_array(r.tags,','))) as count" + + " from (select name from names union select name from workspace_tags) names order by name"); + } + + @PostMapping("/tags") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void addTag(@Valid @RequestBody Name input) { + db.update("insert into workspace_tags(name) values(?) on conflict do nothing",tag(input.name())); + } + + @PutMapping("/tags") + @Transactional + @ResponseStatus(HttpStatus.NO_CONTENT) + public void renameTag(@RequestParam String name,@Valid @RequestBody Name input) { + String target=tag(input.name()); + if (!changeTag(tag(name),target)) throw missing(); + db.update("insert into workspace_tags(name) values(?) on conflict do nothing",target); + } + + @DeleteMapping("/tags") + @Transactional + @ResponseStatus(HttpStatus.NO_CONTENT) + public void removeTag(@RequestParam String name) { + if (!changeTag(tag(name),null)) throw missing(); + } + + /** + * 重命名/删除标签。名称不存在返回 false;回收站中的记录同样改写,恢复正常后标签同样有效; + * 回收站中的笔记也必须提升版本号,否则原页面持有的版本号会误报「已在其他页面更新」。 + */ + private boolean changeTag(String name,String replacement) { + boolean exists = Boolean.TRUE.equals(db.queryForObject( + "select exists(select 1 from workspace_tags where name=?)",Boolean.class,name)); + for(String table:List.of("notes","assets","bookmarks","planner_items")) { + String changed=replaceInTags(table); + // 回收站中的笔记也要提升版本号,否则原编辑页持有的版本号会误报「已在其他页面更新」 + String revision=table.equals("notes") ? ",tag=coalesce(nullif(split_part(changed,',',1),''),''),version=version+1" : ""; + int count=db.update("update "+table+" t set tags=changed"+revision + +" from ("+changed+") patch where patch.id=t.id",name,replacement,name); + exists|=count>0; + } + db.update("delete from workspace_tags where name=?",name); + return exists; + } + + /** 保留出现顺序去重的标签串;replacement 为 null 时表示删除该标签。占位符顺序:name, replacement, name。 */ + private static String replaceInTags(String table) { + return "select x.id,coalesce((select string_agg(kept.v,',' order by kept.ord) from (" + +"select mapped.v,min(src.ord) as ord from unnest(string_to_array(x.tags,',')) with ordinality as src(value,ord)" + +" cross join lateral (select case when src.value=? then ?::text else src.value end as v) mapped" + +" where mapped.v is not null group by mapped.v) kept),'') as changed" + +" from "+table+" x where ?=any(string_to_array(x.tags,','))"; + } + @GetMapping("/history") + public List> history(@RequestParam(defaultValue="") String q,@RequestParam(defaultValue="0") @Min(0) int offset) { + return db.queryForList("select n.id,n.title,n.category,n.folder,count(h.version) as versions,max(h.saved_at) as last_saved" + + " from notes n join note_history h on h.note_id=n.id where n.deleted_at is null" + + " and position(lower(?) in lower(n.title))>0 group by n.id order by last_saved desc,n.id limit 100 offset ?",q,offset); + } + + @GetMapping("/trash") + public List> trash(@RequestParam(defaultValue="") String kind,@RequestParam(defaultValue="0") @Min(0) int offset) { + return db.queryForList("select * from ("+TRASH+") t where deleted_at is not null and (?='' or kind=?)" + + " order by deleted_at desc,id limit 100 offset ?",kind,kind,offset); + } + + @PostMapping("/trash/{kind}/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void restoreTrash(@PathVariable String kind,@PathVariable UUID id) { + trash.restore(kind,id); + } + + @DeleteMapping("/trash/{kind}/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void purgeTrash(@PathVariable String kind,@PathVariable UUID id) { + trash.purge(kind,id); + } + + /** 原型「清空回收站」:逐个永久删除,素材仍被引用时跳过并在结果中列出。 */ + @DeleteMapping("/trash") + public Map emptyTrash() { + var rows = db.queryForList("select kind,id,title from ("+TRASH+") t where deleted_at is not null order by deleted_at,id"); + List skipped = new ArrayList<>(); + int purged = 0; + for (var row : rows) { + try { trash.purge((String) row.get("kind"), (UUID) row.get("id")); purged++; } + catch (ResponseStatusException conflict) { skipped.add("「" + row.get("title") + "」" + conflict.getReason()); } + } + if (purged > 0) notifications.notify("已永久删除 " + purged + " 项回收站内容"); + return Map.of("purged", purged, "skipped", skipped); + } + + @GetMapping("/preferences") + public Map preferences() { + return db.queryForMap("select display_name,bio,autosave from workspace_preferences where id=1"); + } + + @PutMapping("/preferences") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void preferences(@Valid @RequestBody Preferences input) { + db.update("update workspace_preferences set display_name=?,bio=?,autosave=? where id=1",input.display_name().strip(),input.bio(),input.autosave()); + } + + @GetMapping("/flows") + public Map flows() { + return Map.of("flows",db.queryForList("select * from workspace_flows where deleted_at is null order by updated_at desc"), + "runs",db.queryForList("select * from workspace_flow_runs order by created_at desc limit 50")); + } + + @PostMapping("/flows") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void createFlow(@Valid @RequestBody Flow input) { + db.update("insert into workspace_flows(id,title,instructions) values(?,?,?)",UUID.randomUUID(),input.title().strip(),input.instructions()); + } + + @PutMapping("/flows/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void updateFlow(@PathVariable UUID id,@Valid @RequestBody Flow input) { + if (db.update("update workspace_flows set title=?,instructions=?,updated_at=now() where id=? and deleted_at is null", + input.title().strip(),input.instructions(),id)==0) throw missing(); + } + + @DeleteMapping("/flows/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void deleteFlow(@PathVariable UUID id) { + // 原型 P0-1「回收站覆盖全部模块」:工作流删除同样先进回收站 + String title=db.queryForList("select title from workspace_flows where id=? and deleted_at is null for update",String.class,id) + .stream().findFirst().orElseThrow(AdminToolsController::missing); + db.update("update workspace_flows set deleted_at=now() where id=?",id); + trash.notifyTrashed("flows",title); + } + + @PostMapping("/flows/{id}/run") + public Map runFlow(@PathVariable UUID id) { + return db.queryForList("insert into workspace_flow_runs(id,flow_id,title,result)" + +" select ?,id,title,instructions from workspace_flows where id=? and deleted_at is null returning *",UUID.randomUUID(),id) + .stream().findFirst().orElseThrow(AdminToolsController::missing); + } + + private static String tag(String name) { + if(name.isBlank() || name.length()>60 || name.contains(",") || name.contains(",")) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"请输入一个有效标签"); + return name.strip(); + } + private static ResponseStatusException missing() { return new ResponseStatusException(HttpStatus.NOT_FOUND,"记录不存在"); } +} diff --git a/backend/src/main/java/com/myspace/admin/AiStudioController.java b/backend/src/main/java/com/myspace/admin/AiStudioController.java new file mode 100644 index 0000000..23610c7 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/AiStudioController.java @@ -0,0 +1,243 @@ +package com.myspace.admin; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.myspace.assets.AssetFiles; +import com.myspace.library.TrashService; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.io.*; +import java.net.URI; +import java.net.http.*; +import java.time.Duration; +import java.util.*; +import java.util.concurrent.Semaphore; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionTemplate; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/studio") +public class AiStudioController { + private final JdbcTemplate db; + private final TransactionTemplate tx; + private final AssetFiles files; + private final ObjectMapper json; + private final TrashService trash; + private final String base; + private final String token; + private final Map> configured; + private final Semaphore active=new Semaphore(1); + private final HttpClient client=HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(8)).build(); + + public AiStudioController(JdbcTemplate db, TransactionTemplate tx, AssetFiles files, ObjectMapper json, TrashService trash, + @Value("${app.ai-base-url:}") String base,@Value("${app.ai-api-key:}") String token, + @Value("${app.ai-chat-models:}") String chat,@Value("${app.ai-image-models:}") String image) { + this.db=db; this.tx=tx; this.files=files; this.json=json; this.trash=trash; + this.base=base.strip().replaceAll("/+$",""); this.token=token; + configured=Map.of("chat",models(chat),"image",models(image)); + } + + public record Generation(@Pattern(regexp="chat|image") @NotBlank String mode, + @NotBlank @Size(max=150) String model,@NotBlank @Size(max=8000) String prompt, + UUID session_id,UUID note_id,@Pattern(regexp="1024x1024|1536x1024|1024x1536") String size) {} + public record Prompt(@NotBlank @Size(max=120) String title,@NotBlank @Size(max=8000) String body, + @NotBlank @Size(max=60) String category,boolean favorite) {} + public record Model(@NotBlank @Pattern(regexp="chat|image") String mode,@NotBlank @Size(max=150) String model,boolean enabled) {} + public record Favorite(boolean favorite) {} + + @GetMapping("/configuration") + public Map configuration() { + var models=new ArrayList>(); + var defaults=new HashMap(); + for(String mode:List.of("chat","image")) { + var disabled=disabled(mode); + var available=configured.get(mode).stream().filter(name->!disabled.contains(name)).toList(); + var preferred=db.queryForObject("select model from ai_preferences where mode=?",String.class,mode); + defaults.put(mode,available.contains(preferred)?preferred:available.stream().findFirst().orElse("")); + for(String model:configured.get(mode)) models.add(Map.of("name",model,"mode",mode,"enabled",!disabled.contains(model))); + } + return Map.of("configured",!base.isBlank(),"models",models,"defaults",defaults); + } + + @PutMapping("/configuration/model") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void model(@Valid @RequestBody Model input) { + requireModel(input.mode(),input.model(),false); + if(input.enabled()) db.update("delete from ai_disabled_models where mode=? and model=?",input.mode(),input.model()); + else { + db.update("insert into ai_disabled_models(mode,model) values(?,?) on conflict do nothing",input.mode(),input.model()); + db.update("update ai_preferences set model=null where mode=? and model=?",input.mode(),input.model()); + db.update("insert into workspace_notifications(title) values(?)","已停用 AI 模型 "+clip(input.model(),140)); + } + } + + @PutMapping("/configuration/default") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void defaultModel(@Valid @RequestBody Model input) { + requireModel(input.mode(),input.model(),true); + db.update("update ai_preferences set model=? where mode=?",input.model(),input.mode()); + } + + @GetMapping("/history") + public List> history(@RequestParam(defaultValue="chat") String mode, + @RequestParam(defaultValue="") String q,@RequestParam(defaultValue="false") boolean favorite, + @RequestParam(defaultValue="0") @Min(0) int offset) { + return db.queryForList("select r.* from ai_runs r where r.mode=? and (?=false or r.favorite)" + +" and position(lower(?) in lower(r.prompt || ' ' || coalesce(r.response,'')))>0" + +" and (r.mode='chat' or exists(select from assets a where a.id=r.asset_id and a.deleted_at is null))" + +" order by created_at desc,id limit 100 offset ?",mode,favorite,q,offset); + } + + @GetMapping("/history/{id}") + public Map run(@PathVariable UUID id) { + return db.queryForList("select * from ai_runs where id=?",id).stream().findFirst().orElseThrow(AiStudioController::missing); + } + + @GetMapping("/sessions/{id}") + public List> session(@PathVariable UUID id) { + return db.queryForList("select * from (select * from ai_runs where session_id=? and mode='chat'" + +" order by created_at desc,id desc limit 100) r order by created_at,id",id); + } + + @PutMapping("/history/{id}/favorite") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void favorite(@PathVariable UUID id,@RequestBody Favorite input) { + require(db.update("update ai_runs set favorite=? where id=? and mode='image'",input.favorite(),id)); + } + + @PostMapping("/generate") + public Map generate(@Valid @RequestBody Generation input) { + requireModel(input.mode(),input.model(),true); + if(base.isBlank()) throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE,"尚未配置 AI 服务"); + if(!active.tryAcquire()) throw new ResponseStatusException(HttpStatus.TOO_MANY_REQUESTS,"请等待正在生成的请求完成"); + try { + UUID session=input.session_id()==null?UUID.randomUUID():input.session_id(); + boolean chat=input.mode().equals("chat"); + var params=new HashMap(); + params.put("model",input.model()); + if(chat) { + var messages=new ArrayList>(); + var previous=db.queryForList("select prompt,response from (select prompt,response,created_at,id from ai_runs where session_id=? and mode='chat'" + +" order by created_at desc,id desc limit 8) r order by created_at,id",session); + for(var exchange:previous) { + messages.add(Map.of("role","user","content",(String)exchange.get("prompt"))); + messages.add(Map.of("role","assistant","content",clip((String)exchange.get("response"),8000))); + } + messages.add(Map.of("role","user","content",input.prompt())); + params.put("messages",messages); + } else { + params.put("prompt",input.prompt()); + params.put("size",Objects.toString(input.size(),"1024x1024")); + params.put("n",1); + } + JsonNode data=call(chat?"/chat/completions":"/images/generations",params); + String response=chat?data.path("choices").path(0).path("message").path("content").asText(""):null; + if(chat && response.isBlank()) throw new IOException("模型未返回文本"); + byte[] image=chat?null:Base64.getDecoder().decode(data.path("data").path(0).path("b64_json").asText("")); + Integer tokens=data.path("usage").path("total_tokens").canConvertToInt()?data.path("usage").path("total_tokens").asInt():null; + UUID id=UUID.randomUUID(); + return tx.execute(status->{ + UUID asset=image==null?null:files.storeGeneratedPng(db,image); + db.update("insert into ai_runs(id,session_id,mode,model,prompt,response,note_id,asset_id,tokens)" + +" values(?,?,?,?,?,?,(select id from notes where id=? and deleted_at is null),?,?)", + id,session,input.mode(),input.model(),input.prompt(),response,input.note_id(),asset,tokens); + log(input,"success"); + return run(id); + }); + } catch(InterruptedException failure) { + Thread.currentThread().interrupt(); + log(input,"interrupted"); + throw new ResponseStatusException(HttpStatus.BAD_GATEWAY,"模型请求已中断"); + } catch(Exception failure) { + log(input,"failed"); + throw new ResponseStatusException(HttpStatus.BAD_GATEWAY,"模型未返回可用结果,请检查模型和服务配置"); + } finally { active.release(); } + } + + @GetMapping("/prompts") + public List> prompts(@RequestParam(defaultValue="") String q, + @RequestParam(defaultValue="false") boolean favorite) { + return db.queryForList("select * from ai_prompts where deleted_at is null and (?=false or favorite)" + +" and position(lower(?) in lower(title || ' ' || body || ' ' || category))>0 order by updated_at desc,id limit 100",favorite,q); + } + + @PostMapping("/prompts") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void prompt(@Valid @RequestBody Prompt input) { + db.update("insert into ai_prompts(id,title,body,category,favorite) values(?,?,?,?,?)", + UUID.randomUUID(),input.title().strip(),input.body(),input.category().strip(),input.favorite()); + } + + @GetMapping("/prompts/{id}") + public Map prompt(@PathVariable UUID id) { + return db.queryForList("select * from ai_prompts where id=? and deleted_at is null",id).stream().findFirst().orElseThrow(AiStudioController::missing); + } + + @PutMapping("/prompts/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void prompt(@PathVariable UUID id,@Valid @RequestBody Prompt input) { + require(db.update("update ai_prompts set title=?,body=?,category=?,favorite=?,updated_at=now() where id=? and deleted_at is null", + input.title().strip(),input.body(),input.category().strip(),input.favorite(),id)); + } + + /** + * 提示词删除:进入统一回收站(可恢复);同时撤回公开快照,保证公开侧立即不可见。 + */ + @DeleteMapping("/prompts/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void deletePrompt(@PathVariable UUID id) { + String title=db.queryForList("select title from ai_prompts where id=? and deleted_at is null for update",String.class,id) + .stream().findFirst().orElseThrow(AiStudioController::missing); + db.update("update ai_prompts set deleted_at=now() where id=?",id); + db.update("delete from published_ai_prompts where id=?",id); + trash.notifyTrashed("prompts",title); + } + + @GetMapping("/usage") + public List> usage() { + return db.queryForList("select mode,model,count(*) as requests,sum(tokens) as tokens from ai_runs group by mode,model order by mode,model"); + } + + @GetMapping("/logs") + public List> logs() { + return db.queryForList("select * from ai_events order by id desc limit 100"); + } + + private JsonNode call(String path,Map data) throws IOException,InterruptedException { + var request=HttpRequest.newBuilder(URI.create(base+path)).timeout(Duration.ofSeconds(100)) + .header("Content-Type","application/json").POST(HttpRequest.BodyPublishers.ofString(json.writeValueAsString(data))); + if(!token.isBlank()) request.header("Authorization","Bearer "+token); + var response=client.send(request.build(),HttpResponse.BodyHandlers.ofInputStream()); + try(InputStream stream=response.body()) { + if(response.statusCode()<200 || response.statusCode()>=300) throw new IOException("上游服务返回错误"); + int limit=22*1024*1024; + byte[] result=stream.readNBytes(limit+1); + if(result.length>limit) throw new IOException("模型响应超出上限"); + return json.readTree(result); + } + } + + private Set disabled(String mode) { + return new HashSet<>(db.queryForList("select model from ai_disabled_models where mode=?",String.class,mode)); + } + private void requireModel(String mode,String model,boolean enabled) { + if(!configured.getOrDefault(mode,List.of()).contains(model) || enabled && disabled(mode).contains(model)) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"模型未配置或已停用"); + } + private void log(Generation input,String status) { + db.update("insert into ai_events(mode,model,status) values(?,?,?)",input.mode(),input.model(),status); + } + private static List models(String value) { + return Arrays.stream(value.split(",")).map(String::strip).filter(model->!model.isBlank() && model.length()<=150).distinct().toList(); + } + private static String clip(String value,int limit) { return value.length()<=limit?value:value.substring(0,limit); } + private static void require(int count) { if(count==0) throw missing(); } + private static ResponseStatusException missing() { return new ResponseStatusException(HttpStatus.NOT_FOUND,"记录不存在"); } +} diff --git a/backend/src/main/java/com/myspace/admin/BackupController.java b/backend/src/main/java/com/myspace/admin/BackupController.java new file mode 100644 index 0000000..373d8f8 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/BackupController.java @@ -0,0 +1,216 @@ +package com.myspace.admin; + +import com.fasterxml.jackson.databind.JsonNode; +import com.myspace.library.LibraryFields; +import java.net.URI; +import java.time.LocalDateTime; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Isolation; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/backup") +public class BackupController { + private static final List GROUPS=List.of("notes","blogs","bookmarks","planner_items","ai_prompts","workspace_flows"); + private final JdbcTemplate db; + public BackupController(JdbcTemplate db) { this.db=db; } + + @GetMapping + @Transactional(readOnly=true,isolation=Isolation.REPEATABLE_READ) + public Map export() { + var records=new LinkedHashMap(); + records.put("notes",db.queryForList("select id,title,body,category,tags,star,folder from notes where deleted_at is null order by id")); + records.put("blogs",db.queryForList("select id,title,summary,body,category,slug,cover_asset_id,cover_url from blogs where deleted_at is null order by id")); + records.put("bookmarks",db.queryForList("select id,title,url,description,category,tags,favorite,new_window,icon_asset_id,icon_mode,icon_url" + +" from bookmarks where deleted_at is null order by sort_order,id")); + records.put("planner_items",db.queryForList(""" + select id,kind,title,body,category,tags,completed,priority, + to_char(starts_at,'YYYY-MM-DD"T"HH24:MI') as starts_at,to_char(ends_at,'YYYY-MM-DD"T"HH24:MI') as ends_at,language + from planner_items where deleted_at is null order by id + """)); + records.put("ai_prompts",db.queryForList("select id,title,body,category,favorite from ai_prompts order by id")); + records.put("workspace_flows",db.queryForList("select id,title,instructions from workspace_flows order by id")); + return Map.of("version",1,"records",records, + "assets",db.queryForList("select id,name,size,media_type,folder,category,tags,description from assets where deleted_at is null order by id")); + } + + @PostMapping("/preview") + @Transactional(readOnly=true,isolation=Isolation.REPEATABLE_READ) + public Map preview(@RequestBody JsonNode data) { + var counts=new LinkedHashMap(); + var duplicates=new LinkedHashMap(); + for(var group:read(data).entrySet()) { + counts.put(group.getKey(),group.getValue().size()); + int skip=0; + for(var row:group.getValue()) if(exists(group.getKey(),id(row)) + || group.getKey().equals("blogs") && slugExists(row)) skip++; + duplicates.put(group.getKey(),skip); + } + return Map.of("counts",counts,"duplicates",duplicates); + } + + @PostMapping("/restore") + @Transactional + public Map restore(@RequestBody JsonNode data) { + var groups=read(data); + var inserted=new LinkedHashMap(); + for(var group:groups.entrySet()) { + int added=0; + for(var row:group.getValue()) { + if(exists(group.getKey(),id(row)) || group.getKey().equals("blogs") && slugExists(row)) continue; + added+=insert(group.getKey(),row); + } + inserted.put(group.getKey(),added); + } + db.update("insert into workspace_notifications(title) values(?)","已导入数据备份"); + return Map.of("inserted",inserted); + } + + private Map> read(JsonNode data) { + if(!data.isObject() || !data.path("version").isIntegralNumber() || data.path("version").intValue()!=1 + || !data.path("records").isObject()) throw invalid("不支持的备份格式或版本"); + var records=new LinkedHashMap>(); + for(String kind:GROUPS) { + JsonNode items=data.path("records").path(kind); + if(items.isMissingNode()) continue; + if(!items.isArray()) throw invalid("备份记录列表无效"); + var rows=new ArrayList(); + var seen=new HashSet(); + for(JsonNode row:items) { + if(!row.isObject() || !seen.add(id(row))) throw invalid("备份包含无效或重复 ID"); + validate(kind,row); + rows.add(row); + } + records.put(kind,rows); + } + if(records.isEmpty()) throw invalid("备份没有可导入的模块"); + return records; + } + + private static void validate(String kind,JsonNode row) { + required(row,"title",switch(kind) {case "bookmarks","workspace_flows"->60;case "planner_items"->160;default->120;}); + if(kind.equals("workspace_flows")) { required(row,"instructions",8000); return; } + required(row,"category",60); + switch(kind) { + case "notes" -> { optional(row,"body",1000000); required(row,"folder",60); tags(row); } + case "blogs" -> { + optional(row,"body",1000000); optional(row,"summary",200); + if(!required(row,"slug",160).matches("[a-z0-9-]+")) throw invalid("文章链接格式无效"); + url(optional(row,"cover_url",4096),false); assetId(row,"cover_asset_id"); + } + case "bookmarks" -> { + url(required(row,"url",4096),true); optional(row,"description",160); tags(row); assetId(row,"icon_asset_id"); + String mode=optional(row,"icon_mode",10); + if(!Set.of("","auto","asset","custom","default").contains(mode)) throw invalid("书签图标模式无效"); + url(optional(row,"icon_url",4096),mode.equals("custom")); + } + case "planner_items" -> { + String type=required(row,"kind",12); + if(!Set.of("tasks","events","snippets").contains(type)) throw invalid("效率记录类型无效"); + String priority=required(row,"priority",8); + if(!Set.of("low","normal","high").contains(priority)) throw invalid("待办优先级无效"); + var start=date(row,"starts_at"); var end=date(row,"ends_at"); + if(type.equals("events") && start==null || end!=null && (start==null || end.isBefore(start))) throw invalid("日程时间无效"); + optional(row,"body",100000); optional(row,"language",40); tags(row); + } + case "ai_prompts" -> required(row,"body",8000); + default -> throw invalid("未知模块"); + } + } + + private int insert(String kind,JsonNode row) { + UUID id=id(row); + String title=row.path("title").asText(), category=row.path("category").asText(); + return switch(kind) { + case "notes" -> { + String folder=row.path("folder").asText(), tags=tags(row); + db.update("insert into note_categories(name) values(?) on conflict do nothing",category); + db.update("insert into library_folders(kind,name) values('notes',?) on conflict do nothing",folder); + yield db.update("insert into notes(id,title,body,category,folder,tags,tag,star) values(?,?,?,?,?,?,?,?) on conflict do nothing", + id,title,row.path("body").asText(),category,folder,tags,LibraryFields.firstTag(tags),row.path("star").asBoolean(false)); + } + case "blogs" -> { + db.update("insert into blog_categories(name) values(?) on conflict do nothing",category); + yield db.update("insert into blogs(id,title,summary,body,category,slug,cover_asset_id,cover_url)" + +" values(?,?,?,?,?,?,?,?) on conflict do nothing",id,title,row.path("summary").asText(),row.path("body").asText(), + category,row.path("slug").asText(),existingImage(row,"cover_asset_id"),url(row.path("cover_url").asText(""),false)); + } + case "bookmarks" -> { + db.update("insert into bookmark_categories(name) values(?) on conflict do nothing",category); + UUID image=existingImage(row,"icon_asset_id"); + String mode=row.path("icon_mode").asText("default"); + if(mode.isBlank() || mode.equals("asset") && image==null) mode="default"; + yield db.update("insert into bookmarks(id,title,url,description,category,tags,favorite,new_window,icon_asset_id,icon_mode,icon_url)" + +" values(?,?,?,?,?,?,?,?,?,?,?) on conflict do nothing",id,title,url(row.path("url").asText(),true),row.path("description").asText(), + category,tags(row),row.path("favorite").asBoolean(false),row.path("new_window").asBoolean(true),image,mode, + url(row.path("icon_url").asText(""),mode.equals("custom"))); + } + case "planner_items" -> db.update("insert into planner_items(id,kind,title,body,category,tags,completed,priority,starts_at,ends_at,language)" + +" values(?,?,?,?,?,?,?,?,?,?,?) on conflict do nothing",id,row.path("kind").asText(),title,row.path("body").asText(),category, + tags(row),row.path("completed").asBoolean(false),row.path("priority").asText(),date(row,"starts_at"),date(row,"ends_at"),row.path("language").asText()); + case "ai_prompts" -> db.update("insert into ai_prompts(id,title,body,category,favorite) values(?,?,?,?,?) on conflict do nothing", + id,title,row.path("body").asText(),category,row.path("favorite").asBoolean(false)); + case "workspace_flows" -> db.update("insert into workspace_flows(id,title,instructions) values(?,?,?) on conflict do nothing", + id,title,row.path("instructions").asText()); + default -> throw invalid("未知模块"); + }; + } + + private boolean exists(String group,UUID id) { + return Boolean.TRUE.equals(db.queryForObject("select exists(select 1 from "+group+" where id=?)",Boolean.class,id)); + } + private boolean slugExists(JsonNode row) { + return Boolean.TRUE.equals(db.queryForObject("select exists(select 1 from blogs where slug=?)",Boolean.class,row.path("slug").asText())); + } + private UUID existingImage(JsonNode row,String key) { + UUID id=assetId(row,key); + return id==null?null:db.queryForList("select id from assets where id=? and deleted_at is null and media_type like 'image/%' for key share", + UUID.class,id).stream().findFirst().orElse(null); + } + private static UUID id(JsonNode row) { + return assetId(row,"id",true); + } + private static UUID assetId(JsonNode row,String key) { return assetId(row,key,false); } + private static UUID assetId(JsonNode row,String key,boolean required) { + String value=row.path(key).asText(""); + if(value.isBlank() && !required) return null; + try { + UUID result=UUID.fromString(value); + if(result.toString().equalsIgnoreCase(value)) return result; + } catch(IllegalArgumentException ignored) {} + throw invalid("备份记录 ID 无效"); + } + private static String tags(JsonNode row) { return LibraryFields.tags(optional(row,"tags",1500)); } + private static LocalDateTime date(JsonNode row,String key) { + String value=optional(row,key,30); + if(value.isBlank()) return null; + try { return LocalDateTime.parse(value); } + catch(java.time.format.DateTimeParseException error) { throw invalid("备份日期格式无效"); } + } + private static String required(JsonNode row,String key,int limit) { + String value=optional(row,key,limit); + if(value.isBlank()) throw invalid("备份缺少必填字段 "+key); + return value; + } + private static String optional(JsonNode row,String key,int limit) { + var field=row.path(key); + if(field.isMissingNode() || field.isNull()) return ""; + if(!field.isTextual() || field.asText().length()>limit || field.asText().indexOf(0)>=0) + throw invalid("备份字段格式无效 "+key); + return field.asText(); + } + private static String url(String value,boolean required) { + if(value.isBlank() && !required) return null; + try { + var uri=URI.create(value.strip()); + if(uri.getHost()!=null && uri.getUserInfo()==null && ("http".equalsIgnoreCase(uri.getScheme()) || "https".equalsIgnoreCase(uri.getScheme()))) + return uri.toASCIIString(); + } catch(IllegalArgumentException ignored) {} + throw invalid("备份包含无效的网址"); + } + private static ResponseStatusException invalid(String message) { return new ResponseStatusException(HttpStatus.BAD_REQUEST,message); } +} diff --git a/backend/src/main/java/com/myspace/admin/FeedReader.java b/backend/src/main/java/com/myspace/admin/FeedReader.java new file mode 100644 index 0000000..ab80c84 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/FeedReader.java @@ -0,0 +1,195 @@ +package com.myspace.admin; + +import com.fasterxml.jackson.databind.ObjectMapper; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.net.*; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpResponse; +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.time.*; +import java.time.format.DateTimeFormatter; +import java.time.format.DateTimeParseException; +import java.util.*; +import javax.xml.XMLConstants; +import javax.xml.parsers.DocumentBuilderFactory; +import org.apache.hc.client5.http.DnsResolver; +import org.apache.hc.client5.http.classic.methods.HttpGet; +import org.apache.hc.client5.http.config.ConnectionConfig; +import org.apache.hc.client5.http.config.RequestConfig; +import org.apache.hc.client5.http.impl.classic.HttpClients; +import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder; +import org.apache.hc.core5.util.Timeout; +import org.w3c.dom.Element; +import org.w3c.dom.Node; + +final class FeedReader { + private static final int MAX_BYTES = 2 * 1024 * 1024; + private static final HttpClient DNS_HTTP=HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(4)).build(); + private static final ObjectMapper DNS_JSON=new ObjectMapper(); + private FeedReader() {} + record Entry(String key,String title,String url,String body,OffsetDateTime published) {} + private record Result(byte[] bytes,String redirect) {} + + static URI feedUri(String value) { + URI uri=URI.create(value.strip()); + String host=uri.getHost(); + if (host==null || !host.matches("(?i)([a-z0-9-]+\\.)+[a-z][a-z0-9-]*") + || host.endsWith(".local") || host.endsWith(".localhost") || uri.getUserInfo()!=null + || !Set.of("http","https").contains(Objects.toString(uri.getScheme(),"").toLowerCase(Locale.ROOT)) + || (uri.getPort()!=-1 && uri.getPort()!=("https".equalsIgnoreCase(uri.getScheme()) ? 443 : 80))) + throw new IllegalArgumentException("订阅地址须为公开的 HTTP(S) 域名"); + return uri; + } + + static List fetch(URI start,String dnsEndpoint) throws Exception { + var manager=PoolingHttpClientConnectionManagerBuilder.create() + .setDefaultConnectionConfig(ConnectionConfig.custom().setConnectTimeout(Timeout.ofSeconds(5)) + .setSocketTimeout(Timeout.ofSeconds(6)).build()) + .setDnsResolver(new DnsResolver() { + @Override public InetAddress[] resolve(String host) throws UnknownHostException { + var system=InetAddress.getAllByName(host); + var addresses=Arrays.stream(system).filter(FeedReader::publicIpv4).limit(2).toArray(InetAddress[]::new); + // Some local tunnels supply synthetic addresses in the benchmark block. + // Use verified public DNS answers and connect to those IPs, never to the synthetic range. + if(addresses.length==0 && !dnsEndpoint.isBlank() && Arrays.stream(system).anyMatch(FeedReader::synthetic)) + addresses=publicDns(host,dnsEndpoint); + if(addresses.length==0) throw new UnknownHostException("订阅域名没有可访问的公网 IPv4 地址"); + return addresses; + } + @Override public String resolveCanonicalHostname(String host) { return host; } + }).build(); + try (var client=HttpClients.custom().setConnectionManager(manager).disableRedirectHandling() + .disableAutomaticRetries().disableCookieManagement() + .setDefaultRequestConfig(RequestConfig.custom().setResponseTimeout(Timeout.ofSeconds(8)).build()).build()) { + URI uri=start; + for (int hop=0;hop<4;hop++) { + var request=new HttpGet(uri); + request.setHeader("Accept","application/rss+xml, application/atom+xml, application/xml, text/xml"); + Result result=client.execute(request,response -> { + int status=response.getCode(); + if(Set.of(301,302,303,307,308).contains(status) && response.getFirstHeader("Location")!=null) + return new Result(null,response.getFirstHeader("Location").getValue()); + if(status!=200 || response.getEntity()==null) throw new IOException("订阅源返回 HTTP "+status); + try(var stream=response.getEntity().getContent()) { + byte[] body=stream.readNBytes(MAX_BYTES+1); + if(body.length>MAX_BYTES) throw new IOException("订阅源超过 2 MB"); + return new Result(body,null); + } + }); + if (result.redirect()==null) return parse(result.bytes(),uri); + uri=feedUri(uri.resolve(result.redirect()).toString()); + } + } + throw new IOException("订阅源重定向次数过多"); + } + + private static boolean synthetic(InetAddress address) { + byte[] ip=address.getAddress(); + return ip.length==4 && (ip[0]&255)==198 && ((ip[1]&255)==18 || (ip[1]&255)==19); + } + + private static InetAddress[] publicDns(String host,String endpoint) throws UnknownHostException { + try { + var uri=URI.create(endpoint+"?type=A&name="+URLEncoder.encode(host,StandardCharsets.UTF_8)); + if(!"https".equalsIgnoreCase(uri.getScheme()) || uri.getUserInfo()!=null) throw new IOException("无效的 DNS 服务"); + var request=HttpRequest.newBuilder(uri).header("Accept","application/dns-json") + .timeout(Duration.ofSeconds(6)).GET().build(); + var response=DNS_HTTP.send(request,HttpResponse.BodyHandlers.ofInputStream()); + try(var stream=response.body()) { + if(response.statusCode()!=200) throw new IOException("DNS 服务不可用"); + byte[] bytes=stream.readNBytes(16_385); + if(bytes.length>16_384) throw new IOException("DNS 响应过大"); + var data=DNS_JSON.readTree(bytes); + if(data.path("Status").asInt(-1)!=0) return new InetAddress[0]; + var results=new ArrayList(); + for(var answer:data.path("Answer")) { + if(answer.path("type").asInt()!=1) continue; + String value=answer.path("data").asText(); + if(!value.matches("[0-9]{1,3}(\\.[0-9]{1,3}){3}")) continue; + var address=InetAddress.getByName(value); + if(publicIpv4(address)) results.add(address); + if(results.size()==2) break; + } + return results.toArray(InetAddress[]::new); + } + } catch(InterruptedException failure) { + Thread.currentThread().interrupt(); + throw new UnknownHostException("公开 DNS 请求已中断"); + } catch(IOException | IllegalArgumentException failure) { + throw new UnknownHostException("无法获取公网 DNS 记录"); + } + } + + private static boolean publicIpv4(InetAddress address) { + byte[] ip=address.getAddress(); + if(ip.length!=4 || address.isAnyLocalAddress() || address.isLoopbackAddress() || address.isLinkLocalAddress() + || address.isSiteLocalAddress() || address.isMulticastAddress()) return false; + int a=ip[0]&255,b=ip[1]&255,c=ip[2]&255; + return a!=0 && a<224 && !(a==100 && b>=64 && b<=127) && !(a==192 && b==0 && (c==0 || c==2)) + && !(a==198 && (b==18 || b==19 || (b==51 && c==100))) && !(a==203 && b==0 && c==113); + } + + static List parse(byte[] bytes,URI base) throws Exception { + var factory=DocumentBuilderFactory.newInstance(); + factory.setFeature(XMLConstants.FEATURE_SECURE_PROCESSING,true); + factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl",true); + factory.setAttribute(XMLConstants.ACCESS_EXTERNAL_DTD,""); + factory.setAttribute(XMLConstants.ACCESS_EXTERNAL_SCHEMA,""); + factory.setNamespaceAware(true); + var root=factory.newDocumentBuilder().parse(new ByteArrayInputStream(bytes)).getDocumentElement(); + String format=root.getLocalName(); + if (!Set.of("rss","feed","RDF").contains(format)) throw new IOException("订阅源不是 RSS 或 Atom"); + var nodes=root.getElementsByTagNameNS("*",format.equals("feed") ? "entry" : "item"); + var items=new ArrayList(); + var digest=MessageDigest.getInstance("SHA-256"); + for(int i=0;i !value.isBlank()).findFirst().orElse(""); + } + + private static String clip(String value,int limit) { + return value.codePointCount(0,value.length())<=limit ? value : value.substring(0,value.offsetByCodePoints(0,limit)); + } +} diff --git a/backend/src/main/java/com/myspace/admin/PlannerController.java b/backend/src/main/java/com/myspace/admin/PlannerController.java new file mode 100644 index 0000000..38a0b10 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/PlannerController.java @@ -0,0 +1,148 @@ +package com.myspace.admin; + +import com.myspace.common.WorkspaceNotifications; +import com.myspace.library.LibraryFields; +import com.myspace.library.TrashService; +import com.myspace.library.LibraryController; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.time.LocalDateTime; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/planner") +public class PlannerController { + private static final Set KINDS = Set.of("tasks","events","snippets"); + private static final String FIELDS = """ + id,kind,title,body,category,tags,completed,priority, + to_char(starts_at,'YYYY-MM-DD"T"HH24:MI') as starts_at, + to_char(ends_at,'YYYY-MM-DD"T"HH24:MI') as ends_at,language,created_at,updated_at + """; + private final JdbcTemplate db; + private final TrashService trash; + public PlannerController(JdbcTemplate db,TrashService trash) { this.db = db; this.trash = trash; } + + public record Input(@NotBlank @Size(max=160) String title, @NotNull @Size(max=100000) String body, + @Size(max=60) String category, @Size(max=1500) String tags, boolean completed, + @Pattern(regexp="low|normal|high") String priority, LocalDateTime starts_at, + LocalDateTime ends_at, @Size(max=40) String language) {} + public record Completion(boolean completed) {} + + @GetMapping("/{kind}") + public List> list(@PathVariable String kind, + @RequestParam(defaultValue="") String q, @RequestParam(defaultValue="all") String status, + @RequestParam(defaultValue="0") @Min(0) int offset, + @RequestParam(required=false) LocalDateTime from, + @RequestParam(required=false) LocalDateTime until) { + check(kind); + return db.queryForList("select "+FIELDS+" from planner_items where kind=? and deleted_at is null" + + " and position(lower(?) in lower(title || ' ' || body || ' ' || tags || ' ' || category))>0" + + " and (?='all' or completed=(?='done'))" + + " and (?::timestamp is null or coalesce(ends_at,starts_at)>=?)" + + " and (?::timestamp is null or starts_at { if(trashOne(kind,id)!=1) throw missing(); } + case "category" -> { + if(input.value()==null || input.value().isBlank() || input.value().strip().length()>60) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"请输入有效分类"); + require(db.update("update planner_items set category=?,updated_at=now() where kind=? and id=? and deleted_at is null", + input.value().strip(),kind,id)); + } + case "tags" -> { + var tags=db.queryForList("select tags from planner_items where kind=? and id=? and deleted_at is null for update",String.class,kind,id) + .stream().findFirst().orElseThrow(PlannerController::missing); + require(db.update("update planner_items set tags=?,updated_at=now() where kind=? and id=? and deleted_at is null", + LibraryFields.tags(tags+","+(input.value()==null?"":input.value())),kind,id)); + } + default -> throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"操作不适用于此模块"); + } + } + } + + @GetMapping("/{kind}/{id}") + public Map get(@PathVariable String kind,@PathVariable UUID id) { + check(kind); + return db.queryForList("select "+FIELDS+" from planner_items where kind=? and id=? and deleted_at is null",kind,id) + .stream().findFirst().orElseThrow(PlannerController::missing); + } + + @PostMapping("/{kind}") + @ResponseStatus(HttpStatus.CREATED) + @Transactional + public Map create(@PathVariable String kind,@Valid @RequestBody Input input) { + validate(kind,input); + UUID id=UUID.randomUUID(); + db.update("insert into planner_items(id,kind,title,body,category,tags,completed,priority,starts_at,ends_at,language)" + + " values(?,?,?,?,?,?,?,?,?,?,?)",id,kind,input.title().strip(),input.body(),category(input), + LibraryFields.tags(input.tags()),input.completed(),priority(input),input.starts_at(),input.ends_at(),language(input)); + return get(kind,id); + } + + @PutMapping("/{kind}/{id}") + @Transactional + public Map update(@PathVariable String kind,@PathVariable UUID id,@Valid @RequestBody Input input) { + validate(kind,input); + require(db.update("update planner_items set title=?,body=?,category=?,tags=?,completed=?,priority=?," + + " starts_at=?,ends_at=?,language=?,updated_at=now() where kind=? and id=? and deleted_at is null", + input.title().strip(),input.body(),category(input),LibraryFields.tags(input.tags()),input.completed(),priority(input), + input.starts_at(),input.ends_at(),language(input),kind,id)); + return get(kind,id); + } + + @PutMapping("/tasks/{id}/completion") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void completion(@PathVariable UUID id,@RequestBody Completion input) { + require(db.update("update planner_items set completed=?,updated_at=now() where kind='tasks' and id=? and deleted_at is null", + input.completed(),id)); + } + + @DeleteMapping("/{kind}/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void delete(@PathVariable String kind,@PathVariable UUID id) { trashOne(kind,id); } + + /** 先写通知再删除:通知需要读取标题,而 liveTitle 只命中未删除记录。 */ + private int trashOne(String kind,UUID id) { + check(kind); + trash.notifyLive(kind,id,"select title from planner_items where kind=? and id=? and deleted_at is null"); + require(db.update("update planner_items set deleted_at=now() where kind=? and id=? and deleted_at is null",kind,id)); + return 1; + } + + private static void validate(String kind,Input input) { + check(kind); + if ((kind.equals("events") && input.starts_at()==null) + || (input.ends_at()!=null && (input.starts_at()==null || input.ends_at().isBefore(input.starts_at())))) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"请检查日程开始和结束时间"); + if (kind.equals("snippets") && input.body().isBlank()) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"请输入代码"); + } + + private static String category(Input input) { + return input.category()==null || input.category().isBlank() ? "未分类" : input.category().strip(); + } + private static String priority(Input input) { return input.priority()==null ? "normal" : input.priority(); } + private static String language(Input input) { return input.language()==null ? "" : input.language().strip(); } + private static void check(String kind) { if (!KINDS.contains(kind)) throw missing(); } + private static void require(int count) { if (count==0) throw missing(); } + private static ResponseStatusException missing() { + return new ResponseStatusException(HttpStatus.NOT_FOUND,"记录不存在"); + } +} diff --git a/backend/src/main/java/com/myspace/admin/PublicStudioController.java b/backend/src/main/java/com/myspace/admin/PublicStudioController.java new file mode 100644 index 0000000..5fd8292 --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/PublicStudioController.java @@ -0,0 +1,34 @@ +package com.myspace.admin; + +import com.myspace.assets.AssetFiles; +import java.util.Map; +import java.util.UUID; +import org.springframework.core.io.Resource; +import org.springframework.http.*; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/public/studio") +public class PublicStudioController { + private final JdbcTemplate db; + private final AssetFiles files; + public PublicStudioController(JdbcTemplate db,AssetFiles files) { this.db=db; this.files=files; } + + @GetMapping + public ResponseEntity> library() { + var prompts=db.queryForList("select id,title,body,category from published_ai_prompts order by category,title,id"); + var images=db.queryForList("select p.id,p.title from published_ai_images p join assets a on a.id=p.asset_id" + +" where a.deleted_at is null order by p.title,p.id"); + return ResponseEntity.ok().cacheControl(CacheControl.noStore()).body(Map.of("prompts",prompts,"images",images)); + } + + @GetMapping("/images/{id}") + public ResponseEntity image(@PathVariable UUID id) { + var item=db.queryForList("select a.id,a.name,a.size,a.media_type from published_ai_images p join assets a on a.id=p.asset_id" + +" where p.id=? and a.deleted_at is null and a.media_type='image/png'",id) + .stream().findFirst().orElseThrow(()->new ResponseStatusException(HttpStatus.NOT_FOUND,"图片未公开")); + return files.content((UUID)item.get("id"),item,false,"no-store"); + } +} diff --git a/backend/src/main/java/com/myspace/admin/RssController.java b/backend/src/main/java/com/myspace/admin/RssController.java new file mode 100644 index 0000000..6f8236b --- /dev/null +++ b/backend/src/main/java/com/myspace/admin/RssController.java @@ -0,0 +1,143 @@ +package com.myspace.admin; + +import com.myspace.library.InboxController; +import com.myspace.library.TrashService; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.dao.DuplicateKeyException; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionTemplate; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/rss") +public class RssController { + private final JdbcTemplate db; + private final TransactionTemplate tx; + private final InboxController inbox; + private final TrashService trash; + private final String dnsEndpoint; + public RssController(JdbcTemplate db,TransactionTemplate tx,InboxController inbox,TrashService trash, + @Value("${app.rss-public-dns:}") String dnsEndpoint) { + this.db=db; this.tx=tx; this.inbox=inbox; this.trash=trash; this.dnsEndpoint=dnsEndpoint; + } + + public record Source(@NotBlank @Size(max=100) String title,@NotBlank @Size(max=4096) String url, + @NotBlank @Size(max=60) String category) {} + public record Flags(Boolean read,Boolean starred) {} + public record Bulk(@NotEmpty @Size(max=100) List<@NotNull UUID> ids) {} + + @GetMapping("/sources") + public List> sources() { + return db.queryForList("select s.*,count(a.id) filter(where a.read_at is null) as unread" + +" from rss_sources s left join rss_articles a on a.source_id=s.id and a.deleted_at is null" + +" where s.deleted_at is null group by s.id order by s.category,s.title,s.id"); + } + + @PostMapping("/sources") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void add(@Valid @RequestBody Source input) { save(null,input); } + + @PutMapping("/sources/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void update(@PathVariable UUID id,@Valid @RequestBody Source input) { save(id,input); } + + private void save(UUID id,Source input) { + String url; + try { url=FeedReader.feedUri(input.url()).normalize().toASCIIString(); } + catch(IllegalArgumentException error) { throw new ResponseStatusException(HttpStatus.BAD_REQUEST,"订阅地址须为公开的 HTTP(S) 域名"); } + try { + if(id==null) db.update("insert into rss_sources(id,title,url,category) values(?,?,?,?)", + UUID.randomUUID(),input.title().strip(),url,input.category().strip()); + else if(db.update("update rss_sources set title=?,url=?,category=?,last_attempt_at=case when url=? then last_attempt_at else null end," + +" last_success_at=case when url=? then last_success_at else null end,error=null where id=? and deleted_at is null", + input.title().strip(),url,input.category().strip(),url,url,id)==0) throw missing(); + } catch(DuplicateKeyException error) { throw new ResponseStatusException(HttpStatus.CONFLICT,"已订阅此地址"); } + } + + /** 原型:删除订阅即移除该订阅下的文章;订阅本身进统一回收站,可恢复。 */ + @DeleteMapping("/sources/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void remove(@PathVariable UUID id) { + String title=db.queryForList("select title from rss_sources where id=? and deleted_at is null for update",String.class,id) + .stream().findFirst().orElseThrow(RssController::missing); + db.update("update rss_sources set deleted_at=now() where id=?",id); + db.update("update rss_articles set deleted_at=now() where source_id=? and deleted_at is null",id); + trash.notifyTrashed("rss",title); + } + + @PostMapping("/sources/{id}/refresh") + public Map refresh(@PathVariable UUID id) { + var source=db.queryForList("select url from rss_sources where id=? and deleted_at is null",String.class,id) + .stream().findFirst().orElseThrow(RssController::missing); + if(db.update("update rss_sources set last_attempt_at=now() where id=? and url=? and deleted_at is null" + +" and (last_attempt_at is null or last_attempt_at entries; + try { entries=FeedReader.fetch(FeedReader.feedUri(source),dnsEndpoint); } + catch(Exception failure) { + String message=failure instanceof java.io.IOException && failure.getMessage()!=null + && failure.getMessage().startsWith("订阅源") ? failure.getMessage() : "无法读取订阅源,请检查地址、网络及订阅格式"; + db.update("update rss_sources set error=? where id=? and url=? and deleted_at is null",message,id,source); + throw new ResponseStatusException(HttpStatus.BAD_GATEWAY,message); + } + int inserted=tx.execute(transaction -> { + if(db.update("update rss_sources set last_success_at=now(),error=null where id=? and url=? and deleted_at is null",id,source)==0) + throw new ResponseStatusException(HttpStatus.CONFLICT,"订阅源已变更,请重新刷新"); + int added=0; + for(var entry:entries) added+=db.update("insert into rss_articles(id,source_id,external_key,title,url,body,published_at)" + +" values(?,?,?,?,?,?,?) on conflict(source_id,external_key) do nothing", + UUID.randomUUID(),id,entry.key(),entry.title(),entry.url(),entry.body(),entry.published()); + return added; + }); + return Map.of("added",inserted); + } + + @GetMapping("/articles") + public List> articles(@RequestParam(defaultValue="") String q, + @RequestParam(defaultValue="all") String status,@RequestParam(defaultValue="") String category, + @RequestParam(required=false) UUID source,@RequestParam(defaultValue="0") @Min(0) int offset) { + return db.queryForList("select a.id,a.title,a.url,left(a.body,1800) as body,a.published_at,a.fetched_at,a.read_at,a.starred," + +" s.title as source_title,s.category from rss_articles a join rss_sources s on s.id=a.source_id" + +" where a.deleted_at is null and s.deleted_at is null and (?::uuid is null or a.source_id=?) and (?='' or s.category=?)" + +" and (?='all' or (?='unread' and a.read_at is null) or (?='starred' and a.starred))" + +" and position(lower(?) in lower(a.title || ' ' || a.body || ' ' || s.title))>0" + +" order by coalesce(a.published_at,a.fetched_at) desc,a.id limit 100 offset ?", + source,source,category,category,status,status,status,q,offset); + } + + @GetMapping("/articles/{id}") + public Map get(@PathVariable UUID id) { + return db.queryForList("select a.*,s.title as source_title,s.category from rss_articles a" + +" join rss_sources s on s.id=a.source_id where a.id=? and a.deleted_at is null and s.deleted_at is null",id) + .stream().findFirst().orElseThrow(RssController::missing); + } + + @PutMapping("/articles/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void flags(@PathVariable UUID id,@RequestBody Flags input) { + if(db.update("update rss_articles set read_at=case when ?::boolean is null then read_at when ? then coalesce(read_at,now()) else null end," + +" starred=coalesce(?,starred) where id=? and deleted_at is null",input.read(),input.read(),input.starred(),id)==0) throw missing(); + } + + @PostMapping("/articles/read") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void mark(@Valid @RequestBody Bulk input) { + db.batchUpdate("update rss_articles set read_at=coalesce(read_at,now()) where id=? and deleted_at is null", + input.ids().stream().distinct().map(id->new Object[]{id}).toList()); + } + + @PostMapping("/articles/{id}/capture/{target}") + public Map capture(@PathVariable UUID id,@PathVariable String target) { + var item=inbox.capture("rss",id); + return target.equals("inbox") ? item : inbox.organize((UUID)item.get("id"),target); + } + + private static ResponseStatusException missing() { return new ResponseStatusException(HttpStatus.NOT_FOUND,"订阅或文章不存在"); } +} diff --git a/backend/src/main/java/com/myspace/assets/AssetFiles.java b/backend/src/main/java/com/myspace/assets/AssetFiles.java new file mode 100644 index 0000000..7788f08 --- /dev/null +++ b/backend/src/main/java/com/myspace/assets/AssetFiles.java @@ -0,0 +1,102 @@ +package com.myspace.assets; + +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.Map; +import java.util.Set; +import java.util.UUID; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.core.io.FileSystemResource; +import org.springframework.core.io.Resource; +import org.springframework.http.*; +import org.springframework.stereotype.Component; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.support.TransactionSynchronization; +import org.springframework.transaction.support.TransactionSynchronizationManager; +import org.springframework.web.server.ResponseStatusException; + +@Component +public class AssetFiles { + private static final Set IMAGE_TYPES = Set.of("image/png", "image/jpeg", "image/gif", "image/webp"); + private final Path root; + + public AssetFiles(@Value("${app.storage}") String path) throws IOException { + root = Path.of(path).toAbsolutePath().normalize(); + Files.createDirectories(root); + } + + Path path(UUID id) { + return root.resolve(id.toString()); + } + + public UUID storeGeneratedPng(JdbcTemplate db, byte[] image) { + byte[] signature={(byte)137,80,78,71,13,10,26,10}; + if (image.length<8 || image.length>15*1024*1024 + || !java.util.Arrays.equals(image,0,8,signature,0,8)) + throw new ResponseStatusException(HttpStatus.BAD_GATEWAY,"模型返回的图片不是支持的 PNG 文件"); + UUID id=UUID.randomUUID(); + try { Files.write(path(id),image,java.nio.file.StandardOpenOption.CREATE_NEW); } + catch (IOException failure) { throw new java.io.UncheckedIOException(failure); } + TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() { + @Override public void afterCompletion(int status) { + if(status!=STATUS_COMMITTED) { + try { Files.deleteIfExists(path(id)); } + catch(IOException error) { org.slf4j.LoggerFactory.getLogger(AssetFiles.class).error("Could not clean up asset {}",id,error); } + } + } + }); + db.update("insert into assets(id,name,media_type,size,category) values(?,?,'image/png',?," + +"(select name from asset_categories order by (name='未分类') desc,name limit 1))", + id,"AI-"+id.toString().substring(0,8)+".png",image.length); + return id; + } + + public void purge(JdbcTemplate db, UUID id) { + if (db.queryForList("select id from assets where id=? and deleted_at is not null for update", UUID.class, id).isEmpty()) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "文件不在回收站"); + String link = "/api/v1/assets/" + id + "/content"; + boolean inUse = Boolean.TRUE.equals(db.queryForObject( + "select exists(select 1 from blogs where cover_asset_id=? or position(? in body)>0)" + + " or exists(select 1 from bookmarks where icon_asset_id=?)" + + " or exists(select 1 from notes where position(? in body)>0)" + + " or exists(select 1 from note_history where position(? in body)>0)" + + " or exists(select 1 from published_blogs where cover_asset_id=? or position(? in body)>0)" + + " or exists(select 1 from published_bookmarks where icon_asset_id=?)", + Boolean.class, id, link, id, link, link, id, link, id)); + if (inUse) throw new ResponseStatusException(HttpStatus.CONFLICT, "文件仍被文章、书签或笔记引用"); + db.update("delete from assets where id=?", id); + TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() { + @Override public void afterCommit() { + try { + Files.deleteIfExists(path(id)); + } catch (IOException error) { + org.slf4j.LoggerFactory.getLogger(AssetFiles.class).error("Could not remove asset {}", id, error); + } + } + }); + } + + public static boolean isImage(String mediaType) { + return IMAGE_TYPES.contains(mediaType); + } + + public ResponseEntity content( + UUID id, Map asset, boolean download, String cacheControl) { + Path path = path(id); + if (!Files.isRegularFile(path)) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "文件内容缺失"); + String type = (String) asset.get("media_type"); + return ResponseEntity.ok() + .contentType(MediaType.parseMediaType(type)) + .contentLength(((Number) asset.get("size")).longValue()) + .header("Cache-Control", cacheControl) + .header("Content-Security-Policy", "sandbox") + .header("Content-Disposition", ContentDisposition.builder( + !download && type.startsWith("image/") ? "inline" : "attachment") + .filename((String) asset.get("name"), StandardCharsets.UTF_8) + .build().toString()) + .body(new FileSystemResource(path)); + } +} diff --git a/backend/src/main/java/com/myspace/assets/AssetsController.java b/backend/src/main/java/com/myspace/assets/AssetsController.java new file mode 100644 index 0000000..2a060bc --- /dev/null +++ b/backend/src/main/java/com/myspace/assets/AssetsController.java @@ -0,0 +1,145 @@ +package com.myspace.assets; + +import com.myspace.library.TrashService; +import com.myspace.library.LibraryFields; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import org.springframework.transaction.annotation.Transactional; +import java.io.*; +import java.nio.charset.StandardCharsets; +import java.nio.file.*; +import java.util.*; +import org.springframework.core.io.*; +import org.springframework.http.*; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.multipart.MultipartFile; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/assets") +public class AssetsController { + private final JdbcTemplate db; + private final AssetFiles files; + + private final TrashService trash; + + public AssetsController(JdbcTemplate db, AssetFiles files, TrashService trash) { + this.db = db; + this.files = files; + this.trash = trash; + } + + @GetMapping + public List> list( + @RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "all") String type, + @RequestParam(defaultValue = "0") int offset, + @RequestParam(defaultValue = "") String folder, + @RequestParam(defaultValue = "") String category, + @RequestParam(defaultValue = "") String tag, + @RequestParam(defaultValue = "new") String sort) { + String order = switch (sort) { + case "name" -> "lower(name)"; + case "size" -> "size desc"; + case "old" -> "created_at"; + default -> "created_at desc"; + }; + return db.queryForList( + "select * from assets where deleted_at is null" + + " and position(lower(?) in lower(name || ' ' || category || ' ' || folder || ' ' || tags))>0" + + " and (?='all' or (?='image' and media_type like 'image/%') or (?='file' and media_type not like 'image/%'))" + + " and (?='' or folder=?) and (?='' or category=?) and (?='' or ?=any(string_to_array(tags,',')))" + + " order by " + order + ",id limit 100 offset ?", + q, type, type, type, folder, folder, category, category, tag, tag, Math.max(0, offset)); + } + + @GetMapping("/{id}") + public Map get(@PathVariable UUID id) { + return db.queryForList("select * from assets where id=? and deleted_at is null", id).stream() + .findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "文件不存在")); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + public Map upload(@RequestParam MultipartFile file, + @RequestParam(required = false) String folder) throws IOException { + String destination = LibraryFields.folder(db, "assets", folder); + if (file.isEmpty() || file.getSize() > 15 * 1024 * 1024) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "文件必须为 1 字节至 15 MB"); + String name = Optional.ofNullable(file.getOriginalFilename()).orElse("file").replace('\\', '/'); + name = name.substring(name.lastIndexOf('/') + 1).replaceAll("[\\p{Cntrl}]", "_"); + if (name.isBlank() || name.length() > 255) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "文件名无效"); + UUID id = UUID.randomUUID(); + Path dest = files.path(id); + try { + file.transferTo(dest); + String mime = "application/octet-stream"; + byte[] head; + try (var in = Files.newInputStream(dest)) { + head = in.readNBytes(12); + } + if (head.length >= 8 + && head[0] == (byte) 137 + && head[1] == 80 + && head[2] == 78 + && head[3] == 71) mime = "image/png"; + else if (head.length >= 3 + && head[0] == (byte) 255 + && head[1] == (byte) 216 + && head[2] == (byte) 255) mime = "image/jpeg"; + else if (head.length >= 6 + && new String(head, 0, 6, StandardCharsets.US_ASCII).matches("GIF8[79]a")) + mime = "image/gif"; + else if (head.length == 12 + && new String(head, 0, 4, StandardCharsets.US_ASCII).equals("RIFF") + && new String(head, 8, 4, StandardCharsets.US_ASCII).equals("WEBP")) + mime = "image/webp"; + db.update( + "insert into assets(id,name,media_type,size,folder,category) values(?,?,?,?,?," + + "(select name from asset_categories order by (name='未分类') desc,name limit 1))", + id, + name, + mime, + file.getSize(), destination); + return get(id); + } catch (Exception e) { + Files.deleteIfExists(dest); + throw e; + } + } + + public record Metadata(@NotBlank @Size(max = 255) String name, @NotBlank @Size(max = 60) String folder, + @NotBlank @Size(max = 60) String category, @NotNull @Size(max = 500) String description, + @Size(max = 1500) String tags) {} + + @PutMapping("/{id}") + @Transactional + public Map update(@PathVariable UUID id, @Valid @RequestBody Metadata input) { + String folder = LibraryFields.folder(db, "assets", input.folder()); + String category = input.category().strip(); + db.update("insert into asset_categories(name) values(?) on conflict do nothing", category); + if (db.update("update assets set name=?,folder=?,category=?,description=?,tags=? where id=? and deleted_at is null", + input.name().strip(), folder, category, input.description(), LibraryFields.tags(input.tags()), id) == 0) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "文件不存在"); + return get(id); + } + + @GetMapping("/{id}/content") + public ResponseEntity content( + @PathVariable UUID id, @RequestParam(defaultValue = "false") boolean download) { + return files.content(id, get(id), download, "private, no-store"); + } + + @DeleteMapping("/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void delete(@PathVariable UUID id) { + String name = db.queryForList("select name from assets where id=? and deleted_at is null for update", String.class, id) + .stream().findFirst().orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "文件不存在")); + db.update("update assets set deleted_at=now() where id=?", id); + trash.notifyTrashed("assets", name); + } +} diff --git a/backend/src/main/java/com/myspace/auth/AccountInitializer.java b/backend/src/main/java/com/myspace/auth/AccountInitializer.java new file mode 100644 index 0000000..fae3f18 --- /dev/null +++ b/backend/src/main/java/com/myspace/auth/AccountInitializer.java @@ -0,0 +1,37 @@ +package com.myspace.auth; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.ApplicationRunner; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.stereotype.Component; + +@Component +public class AccountInitializer implements ApplicationRunner { + private final JdbcTemplate db; + private final PasswordEncoder encoder; + private final String username, password; + + public AccountInitializer( + JdbcTemplate db, + PasswordEncoder encoder, + @Value("${app.admin-username}") String username, + @Value("${app.admin-password}") String password) { + this.db = db; + this.encoder = encoder; + this.username = username; + this.password = password; + } + + public void run(org.springframework.boot.ApplicationArguments args) { + if (db.queryForObject("select count(*) from app_user", Long.class) == 0) { + if (password.length() < 12 || password.length() > 72 || username.isBlank()) + throw new IllegalStateException( + "Set ADMIN_USERNAME and ADMIN_PASSWORD (12-72 characters) for first start"); + db.update( + "insert into app_user values(1,?,?) on conflict do nothing", + username, + encoder.encode(password)); + } + } +} diff --git a/backend/src/main/java/com/myspace/auth/AuthController.java b/backend/src/main/java/com/myspace/auth/AuthController.java new file mode 100644 index 0000000..2a8bb5d --- /dev/null +++ b/backend/src/main/java/com/myspace/auth/AuthController.java @@ -0,0 +1,20 @@ +package com.myspace.auth; + +import java.security.Principal; +import java.util.Map; +import org.springframework.security.web.csrf.CsrfToken; +import org.springframework.web.bind.annotation.*; + +@RestController +@RequestMapping("/api/v1/auth") +public class AuthController { + @GetMapping("/csrf") + public Map csrf(CsrfToken token) { + return Map.of("token", token.getToken(), "headerName", token.getHeaderName()); + } + + @GetMapping("/me") + public Map me(Principal user) { + return Map.of("username", user.getName()); + } +} diff --git a/backend/src/main/java/com/myspace/auth/SecurityConfig.java b/backend/src/main/java/com/myspace/auth/SecurityConfig.java new file mode 100644 index 0000000..aaa776e --- /dev/null +++ b/backend/src/main/java/com/myspace/auth/SecurityConfig.java @@ -0,0 +1,69 @@ +package com.myspace.auth; + +import org.springframework.context.annotation.*; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.security.authorization.AuthorizationDecision; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.core.userdetails.*; +import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; +import org.springframework.security.crypto.password.PasswordEncoder; +import org.springframework.security.web.SecurityFilterChain; + +@Configuration +public class SecurityConfig { + + @Bean + PasswordEncoder passwordEncoder() { + return new BCryptPasswordEncoder(); + } + + @Bean + UserDetailsService users(JdbcTemplate db) { + return name -> + db + .query( + "select username,password_hash from app_user where username=?", + (rs, n) -> + User.withUsername(rs.getString(1)) + .password(rs.getString(2)) + .roles("OWNER") + .build(), + name) + .stream() + .findFirst() + .orElseThrow(() -> new UsernameNotFoundException("Invalid credentials")); + } + + @Bean + SecurityFilterChain security(HttpSecurity http) throws Exception { + return http.authorizeHttpRequests( + a -> + a.requestMatchers("/api/v1/auth/csrf", "/api/v1/auth/login", "/error") + .permitAll() + // 公开只读接口不使用会话:被外部嵌入或链接时也不会带上登录 Cookie + .requestMatchers("/api/v1/public/**") + .access((auth, ctx) -> new AuthorizationDecision(true)) + .anyRequest() + .authenticated()) + .formLogin( + f -> + f.loginProcessingUrl("/api/v1/auth/login") + .successHandler( + (q, s, a) -> { + s.setContentType("application/json"); + s.getWriter().write("{\"ok\":true}"); + }) + .failureHandler((q, s, e) -> s.sendError(401, "用户名或密码错误"))) + .logout( + l -> + l.logoutUrl("/api/v1/auth/logout") + .logoutSuccessHandler((q, s, a) -> s.setStatus(204)) + .deleteCookies("JSESSIONID")) + .exceptionHandling( + e -> + e.authenticationEntryPoint((q, s, x) -> s.sendError(401)) + .accessDeniedHandler((q, s, x) -> s.sendError(403))) + .requestCache(c -> c.disable()) + .build(); + } +} diff --git a/backend/src/main/java/com/myspace/blogs/BlogsController.java b/backend/src/main/java/com/myspace/blogs/BlogsController.java new file mode 100644 index 0000000..6e550a0 --- /dev/null +++ b/backend/src/main/java/com/myspace/blogs/BlogsController.java @@ -0,0 +1,166 @@ +package com.myspace.blogs; + +import com.myspace.assets.AssetFiles; +import com.myspace.library.TrashService; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +/** + * 博客文章管理。每篇文章有一个 URL 片段(slug),「已发布」文章会出现在 /blog 公开页面。 + * 草稿不会进入公开列表,公开列表与详情不返回正文以外的任何账户信息。 + */ +@RestController +@RequestMapping("/api/v1/blogs") +public class BlogsController { + private static final java.util.regex.Pattern STATUS = + java.util.regex.Pattern.compile("draft|published"); + private static final java.util.regex.Pattern ASCII = + java.util.regex.Pattern.compile("[^a-z0-9]+"); + + private final JdbcTemplate db; + + private final TrashService trash; + + public BlogsController(JdbcTemplate db, TrashService trash) { + this.db = db; + this.trash = trash; + } + + public record Input( + @NotBlank @Size(max = 120) String title, + @NotNull @Size(max = 200) String summary, + @NotNull @Size(max = 1000000) String body, + @NotBlank @Pattern(regexp = "draft|published") String status, + @Min(0) long version, + UUID cover_asset_id, + @Size(max = 60) String category, @Size(max = 4096) String cover_url) {} + + // 列表与详情同样返回全文:页内搜索和全局搜索都按正文匹配(与原型一致),单用户空间一次最多 100 篇 + static final String FIELD = + "id,title,summary,status,slug,version,created_at,updated_at,body,cover_asset_id,category,cover_url"; + + @GetMapping + public List> list( + @RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "all") String status, + @RequestParam(defaultValue = "") String category, + @RequestParam(defaultValue = "false") boolean excerpt, + @RequestParam(defaultValue = "100") @Min(1) @Max(100) int limit, + @RequestParam(defaultValue = "0") @Min(0) int offset) { + if (!STATUS.matcher(status).matches() && !"all".equals(status)) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "状态筛选无效"); + return db.queryForList( + "select " + (excerpt ? FIELD.replace("body,", "") : FIELD) + + ",exists(select 1 from published_blogs p where p.id=b.id) as live" + + " from blogs b where deleted_at is null" + + " and position(lower(?) in lower(title || ' ' || summary || ' ' || body || ' ' || category))>0" + + " and (?='all' or status=?) and (?='' or category=?) order by updated_at desc,id limit ? offset ?", + q, status, status, category, category, limit, offset); + } + + @GetMapping("/{id}") + public Map get(@PathVariable UUID id) { + return db.queryForList("select " + FIELD + ",exists(select 1 from published_blogs p where p.id=b.id) as live" + + " from blogs b where id=? and deleted_at is null", id).stream() + .findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "文章不存在")); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + @Transactional + public Map create(@Valid @RequestBody Input b) { + validateCover(b.cover_asset_id()); + ensureCategory(category(b.category())); + UUID id = UUID.randomUUID(); + db.update( + "insert into blogs(id,title,summary,body,status,slug,cover_asset_id,category,cover_url) values(?,?,?,?,?,?,?,?,?)", + id, + b.title().trim(), + b.summary().trim(), + b.body(), + b.status(), + slugFrom(b.title(), id), + b.cover_asset_id(), category(b.category()), coverUrl(b)); + return get(id); + } + + @PutMapping("/{id}") + @Transactional + public Map update(@PathVariable UUID id, @Valid @RequestBody Input b) { + get(id); + validateCover(b.cover_asset_id()); + if (b.category() != null) ensureCategory(category(b.category())); + if (db.update( + "update blogs set" + + " title=?,summary=?,body=?,status=?,cover_asset_id=?,category=coalesce(?,category),cover_url=case when ? then null else coalesce(?,cover_url) end,version=version+1,updated_at=now() where" + + " id=? and version=? and deleted_at is null", + b.title().trim(), + b.summary().trim(), + b.body(), + b.status(), + b.cover_asset_id(), + b.category() == null ? null : category(b.category()), + b.cover_asset_id() != null || "".equals(b.cover_url()), + coverUrl(b), + id, + b.version()) + == 0) throw new ResponseStatusException(HttpStatus.CONFLICT, "文章已在其他页面更新,请重新打开后编辑"); + return get(id); + } + + private static String coverUrl(Input input) { + if (input.cover_asset_id() != null || input.cover_url() == null || input.cover_url().isBlank()) return null; + try { + var uri = new java.net.URI(input.cover_url().strip()); + if (uri.getHost() != null && uri.getUserInfo() == null + && ("http".equalsIgnoreCase(uri.getScheme()) || "https".equalsIgnoreCase(uri.getScheme()))) + return uri.toASCIIString(); + } catch (java.net.URISyntaxException ignored) {} + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "封面网址必须是有效的 HTTP(S) 地址"); + } + + private void ensureCategory(String name) { + db.update("insert into blog_categories(name) values(?) on conflict do nothing", name); + } + + private static String category(String value) { + return value == null || value.isBlank() ? "未分类" : value.strip(); + } + + private void validateCover(UUID id) { + if (id == null) return; + var types = db.queryForList("select media_type from assets where id=? and deleted_at is null for key share", String.class, id); + if (types.isEmpty() || !AssetFiles.isImage(types.get(0))) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "封面必须选择图床中已上传的图片"); + } + + /** + * 由标题生成 URL 片段:保留 ASCII 字母数字,其余转连字符;中文标题没有可用字符时退回 article。 + * 冲突时追加 id 片段,保证唯一且不改变已发布文章的链接。 + */ + static String slugFrom(String title, UUID id) { + String base = ASCII.matcher(title.toLowerCase(java.util.Locale.ROOT)).replaceAll("-"); + base = base.replaceAll("^-+|-+$", ""); + if (base.length() > 80) base = base.substring(0, 80).replaceAll("-+$", ""); + // 纯数字或空片段没有可读性,统一用 article + if (!base.matches(".*[a-z].*")) base = "article"; + return base + "-" + id.toString().replace("-", "").substring(0, 6); + } + + @DeleteMapping("/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void delete(@PathVariable UUID id) { + String title = db.queryForList("select title from blogs where id=? and deleted_at is null for update", String.class, id) + .stream().findFirst().orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "文章不存在")); + db.update("update blogs set deleted_at=now(),status='draft',version=version+1 where id=?", id); + trash.notifyTrashed("blogs", title); + } +} diff --git a/backend/src/main/java/com/myspace/blogs/PublicBlogsController.java b/backend/src/main/java/com/myspace/blogs/PublicBlogsController.java new file mode 100644 index 0000000..41aba1b --- /dev/null +++ b/backend/src/main/java/com/myspace/blogs/PublicBlogsController.java @@ -0,0 +1,154 @@ +package com.myspace.blogs; + +import static java.nio.charset.StandardCharsets.UTF_8; +import static java.util.stream.Collectors.joining; + +import com.myspace.assets.AssetFiles; +import com.myspace.common.HttpCache; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import jakarta.validation.constraints.Min; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import org.commonmark.node.Image; +import org.commonmark.node.Node; +import org.commonmark.parser.Parser; +import org.springframework.core.io.Resource; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.util.DigestUtils; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +/** + * 公开博客的只读接口:匿名访问者只能读取已发布的文章及其引用的图片。 + */ +@RestController +@RequestMapping("/api/v1/public/blogs") +public class PublicBlogsController { + private static final String FIELDS = "title,summary,slug,updated_at,cover_asset_id,category,cover_url"; + private static final Parser MARKDOWN = Parser.builder().build(); + + private final JdbcTemplate db; + private final HttpCache cache; + private final AssetFiles files; + + public PublicBlogsController(JdbcTemplate db, HttpCache cache, AssetFiles files) { + this.db = db; + this.cache = cache; + this.files = files; + } + + @GetMapping + public ResponseEntity>> list( + HttpServletRequest req, + HttpServletResponse res, + @RequestParam(defaultValue = "0") @Min(0) int offset, + @RequestParam(defaultValue = "20") @Min(1) int limit, + @RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "") String category) { + res.setHeader("Cache-Control", "no-cache"); + int size = Math.min(Math.max(limit, 1), 50); + int from = Math.max(0, offset); + List> rows = + db.queryForList( + "select " + FIELDS + ",version from published_blogs where true" + + " and (?='' or category=?)" + + " and position(lower(?) in lower(title || ' ' || summary || ' ' || body || ' ' || category))>0" + + " order by updated_at desc,id limit ? offset ?", + category, category, q, size, + from); + String version = rows.stream() + .map(row -> row.get("slug") + ":" + row.remove("version") + ":" + row.get("cover_asset_id")) + .collect(joining(",")); + return cache.etag(rows, DigestUtils.md5DigestAsHex(version.getBytes(UTF_8)), req); + } + + @GetMapping("/categories") + public List categories() { + return db.queryForList("select distinct category from published_blogs order by category", String.class); + } + + @GetMapping(value = "/rss.xml", produces = "application/rss+xml;charset=UTF-8") + public ResponseEntity rss(HttpServletRequest request) { + String origin = org.springframework.web.util.UriComponentsBuilder.newInstance() + .scheme(request.getScheme()).host(request.getServerName()) + .port(request.getServerPort() == (request.isSecure() ? 443 : 80) ? -1 : request.getServerPort()) + .build().toUriString(); + String home = origin + "/blog"; + var entries = db.query("select title,summary,slug,updated_at from published_blogs order by updated_at desc,id limit 30", + (row, index) -> new String[] {row.getString("title"), row.getString("summary"), row.getString("slug"), + java.time.format.DateTimeFormatter.RFC_1123_DATE_TIME.format( + row.getTimestamp("updated_at").toInstant().atZone(java.time.ZoneOffset.UTC))}); + var xml = new StringBuilder(""); + xml.append("MySpace · 公开博客").append(xmlText(home)) + .append("MySpace 公开博客的最近更新"); + for (String[] entry : entries) { + String link = xmlText(home + "/" + entry[2]); + xml.append("").append(xmlText(entry[0])).append("").append(link) + .append("").append(link).append("").append(xmlText(entry[1])) + .append("").append(entry[3]).append(""); + } + xml.append(""); + return ResponseEntity.ok().header("Cache-Control", "no-cache").body(xml.toString()); + } + + private static String xmlText(String value) { + return value.replaceAll("[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x{FFFE}\\x{FFFF}]", "") + .replace("&", "&").replace("<", "<").replace(">", ">"); + } + + @GetMapping("/{slug}") + public ResponseEntity> article( + @PathVariable String slug, HttpServletRequest req, HttpServletResponse res) { + if (!slug.matches("[a-z0-9-]{1,160}")) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "文章不存在或尚未发布"); + // 只有已发布文章可见;草稿与不存在的文章返回同样的 404,不泄露草稿存在与否 + List> rows = + db.queryForList( + "select " + FIELDS + ",version,body from published_blogs where slug=?", + slug); + if (rows.isEmpty()) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "文章不存在或尚未发布"); + Map article = new java.util.HashMap<>(rows.get(0)); + Object version = article.remove("version"); + res.setHeader("Cache-Control", "no-cache"); + return cache.etag(article, slug + "-" + version + "-" + article.get("cover_asset_id"), req); + } + + @GetMapping("/{slug}/images/{id}") + public ResponseEntity image(@PathVariable String slug, @PathVariable UUID id) { + var matches = db.queryForList( + "select a.media_type,a.name,a.size,b.cover_asset_id,b.body from published_blogs b cross join assets a" + + " where b.slug=? and a.deleted_at is null and a.id=?", + slug, id); + if (!matches.isEmpty()) { + var match = matches.get(0); + if (AssetFiles.isImage((String) match.get("media_type")) + && (id.equals(match.get("cover_asset_id")) || referencesImage((String) match.get("body"), id))) { + return files.content(id, match, false, "no-store"); + } + } + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "图片不存在或未公开"); + } + + private static boolean referencesImage(String body, UUID id) { + String url = "/api/v1/assets/" + id + "/content"; + if (!body.contains(url)) return false; + // Traverse the parsed Markdown so links, raw HTML and code examples do not grant access. + Node root = MARKDOWN.parse(body); + Node node = root.getFirstChild(); + while (node != null && node != root) { + if (node instanceof Image image && url.equals(image.getDestination())) return true; + if (node.getFirstChild() != null) { + node = node.getFirstChild(); + } else { + while (node != root && node.getNext() == null) node = node.getParent(); + node = node.getNext(); + } + } + return false; + } +} diff --git a/backend/src/main/java/com/myspace/bookmarks/BookmarkCategoriesController.java b/backend/src/main/java/com/myspace/bookmarks/BookmarkCategoriesController.java new file mode 100644 index 0000000..ad1202a --- /dev/null +++ b/backend/src/main/java/com/myspace/bookmarks/BookmarkCategoriesController.java @@ -0,0 +1,52 @@ +package com.myspace.bookmarks; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import java.util.List; +import java.util.Map; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +/** Owner-managed categories used to organize navigation bookmarks. */ +@RestController +@RequestMapping("/api/v1/bookmark-categories") +public class BookmarkCategoriesController { + private final JdbcTemplate db; + + public BookmarkCategoriesController(JdbcTemplate db) { + this.db = db; + } + + public record Input(@NotBlank @Size(max = 60) String name) {} + + @GetMapping + public List> list() { + return db.queryForList( + "select c.name,count(b.id) as bookmarks from bookmark_categories c left join bookmarks b on b.category=c.name and b.deleted_at is null" + + " group by c.name order by c.name"); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + public Map create(@Valid @RequestBody Input input) { + String name = input.name().trim(); + try { + db.update("insert into bookmark_categories(name) values(?)", name); + } catch (org.springframework.dao.DuplicateKeyException e) { + throw new ResponseStatusException(HttpStatus.CONFLICT, "该分类已存在"); + } + return Map.of("name", name, "bookmarks", 0); + } + + @DeleteMapping("/{name}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void delete(@PathVariable String name) { + if (db.queryForObject("select count(*) from bookmarks where category=?", Long.class, name) > 0) + throw new ResponseStatusException(HttpStatus.CONFLICT, "该分类仍包含书签,请先删除或更换这些书签的分类"); + if (db.update("delete from bookmark_categories where name=?", name) == 0) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "分类不存在"); + } +} diff --git a/backend/src/main/java/com/myspace/bookmarks/BookmarksController.java b/backend/src/main/java/com/myspace/bookmarks/BookmarksController.java new file mode 100644 index 0000000..f0209ea --- /dev/null +++ b/backend/src/main/java/com/myspace/bookmarks/BookmarksController.java @@ -0,0 +1,186 @@ +package com.myspace.bookmarks; + +import com.myspace.assets.AssetFiles; +import com.myspace.library.TrashService; +import com.myspace.library.LibraryFields; +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; +import java.net.URI; +import java.net.URISyntaxException; +import java.util.List; +import java.util.Map; +import java.util.UUID; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +/** Private navigation bookmarks. Only web URLs are accepted so links can be opened safely in a new tab. */ +@RestController +@RequestMapping("/api/v1/bookmarks") +public class BookmarksController { + private final JdbcTemplate db; + + private final TrashService trash; + + public BookmarksController(JdbcTemplate db, TrashService trash) { + this.db = db; + this.trash = trash; + } + + public record Input( + @NotBlank @Size(max = 60) String title, + @NotBlank @Size(max = 4096) String url, + @NotNull @Size(max = 160) String description, + @NotBlank @Size(max = 60) String category, + UUID icon_asset_id, + boolean is_public, + @Size(max = 1500) String tags, Boolean favorite, Boolean new_window, + @jakarta.validation.constraints.Pattern(regexp = "auto|custom|default|asset") String icon_mode, + @Size(max = 4096) String icon_url) {} + + @GetMapping + public List> list( + @RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "") String category, + @RequestParam(defaultValue = "0") int offset, + @RequestParam(defaultValue = "false") boolean favorite, + @RequestParam(defaultValue = "updated") String sort) { + if (offset < 0) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "分页参数无效"); + String order = switch (sort) { + case "name" -> "lower(title)"; + case "created" -> "created_at"; + case "custom" -> "sort_order"; + default -> "updated_at desc"; + }; + return db.queryForList( + "select * from bookmarks where deleted_at is null and position(lower(?) in lower(title || ' ' || description || ' ' || url || ' ' || tags))>0" + + " and (?='' or category=?) and (?=false or favorite) order by " + order + ",id limit 100 offset ?", + q, + category, + category, favorite, + offset); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + @Transactional + public Map create(@Valid @RequestBody Input bookmark) { + validateIcon(bookmark.icon_asset_id()); + validateCategory(bookmark.category()); + UUID id = UUID.randomUUID(); + db.update( + "insert into bookmarks(id,title,url,description,category,icon_asset_id,is_public,tags,favorite,new_window,icon_mode,icon_url) values(?,?,?,?,?,?,?,?,?,?,?,?)", + id, + bookmark.title().trim(), + webUrl(bookmark.url()), + bookmark.description().trim(), + bookmark.category().trim(), + bookmark.icon_asset_id(), bookmark.is_public(), LibraryFields.tags(bookmark.tags()), + Boolean.TRUE.equals(bookmark.favorite()), !Boolean.FALSE.equals(bookmark.new_window()), mode(bookmark), iconUrl(bookmark)); + return get(id); + } + + @PutMapping("/{id}") + @Transactional + public Map update(@PathVariable UUID id, @Valid @RequestBody Input bookmark) { + validateIcon(bookmark.icon_asset_id()); + validateCategory(bookmark.category()); + int updated = db.update( + "update bookmarks set title=?,url=?,description=?,category=?,icon_asset_id=?,is_public=?," + + "tags=coalesce(?,tags),favorite=coalesce(?,favorite),new_window=coalesce(?,new_window)," + + "icon_mode=?,icon_url=?,updated_at=now() where id=? and deleted_at is null", + bookmark.title().trim(), webUrl(bookmark.url()), bookmark.description().trim(), + bookmark.category().trim(), bookmark.icon_asset_id(), bookmark.is_public(), + bookmark.tags() == null ? null : LibraryFields.tags(bookmark.tags()), bookmark.favorite(), bookmark.new_window(), + mode(bookmark), iconUrl(bookmark), id); + if (updated == 0) throw new ResponseStatusException(HttpStatus.NOT_FOUND, "书签不存在"); + return get(id); + } + + public record Favorite(boolean favorite) {} + + @PutMapping("/{id}/favorite") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void favorite(@PathVariable UUID id, @RequestBody Favorite input) { + if (db.update("update bookmarks set favorite=? where id=? and deleted_at is null", input.favorite(), id) == 0) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "书签不存在"); + } + + @PostMapping("/import") + @Transactional + @ResponseStatus(HttpStatus.CREATED) + public Map importBookmarks(@Valid @RequestBody Import input) { + db.execute("lock table bookmarks in share row exclusive mode"); + int created = 0; + for (Input bookmark : input.bookmarks()) { + String url = webUrl(bookmark.url()); + if (Boolean.TRUE.equals(db.queryForObject( + "select exists(select 1 from bookmarks where url=? and deleted_at is null)", Boolean.class, url))) continue; + String category = bookmark.category().strip(); + db.update("insert into bookmark_categories(name) values(?) on conflict do nothing", category); + create(new Input(bookmark.title(), url, bookmark.description(), category, null, false, + bookmark.tags(), bookmark.favorite(), bookmark.new_window(), "default", null)); + created++; + } + return Map.of("created", created, "skipped", input.bookmarks().size() - created); + } + + public record Import(@jakarta.validation.constraints.NotEmpty @Size(max = 500) + List<@Valid @NotNull Input> bookmarks) {} + + @GetMapping("/{id}") + public Map get(@PathVariable UUID id) { + return db.queryForList("select * from bookmarks where id=? and deleted_at is null", id).stream() + .findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "书签不存在")); + } + + @DeleteMapping("/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void delete(@PathVariable UUID id) { + String title = db.queryForList("select title from bookmarks where id=? and deleted_at is null for update", String.class, id) + .stream().findFirst().orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "书签不存在")); + db.update("update bookmarks set deleted_at=now(),is_public=false where id=?", id); + trash.notifyTrashed("bookmarks", title); + } + + private static String mode(Input bookmark) { + if (bookmark.icon_mode() != null) return bookmark.icon_mode(); + return bookmark.icon_asset_id() == null ? "default" : "asset"; + } + + private static String iconUrl(Input bookmark) { + if (!mode(bookmark).equals("custom")) return null; + if (bookmark.icon_url() == null) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请填写图标网址"); + return webUrl(bookmark.icon_url()); + } + + private static String webUrl(String raw) { + try { + URI uri = new URI(raw.trim()); + if (!("http".equalsIgnoreCase(uri.getScheme()) || "https".equalsIgnoreCase(uri.getScheme()))) + throw new URISyntaxException(raw, "unsupported scheme"); + if (uri.getHost() == null) throw new URISyntaxException(raw, "missing host"); + return uri.normalize().toASCIIString(); + } catch (URISyntaxException | IllegalArgumentException e) { + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "网址必须是有效的 http:// 或 https:// 地址"); + } + } + + private void validateIcon(UUID id) { + if (id == null) return; + var types = db.queryForList("select media_type from assets where id=? and deleted_at is null for key share", String.class, id); + if (types.isEmpty() || !AssetFiles.isImage(types.get(0))) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "图标必须选择图床中已上传的图片"); + } + + private void validateCategory(String category) { + if (db.queryForObject("select count(*) from bookmark_categories where name=?", Long.class, category.trim()) == 0) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请选择已有的书签分类"); + } +} diff --git a/backend/src/main/java/com/myspace/bookmarks/PublicBookmarksController.java b/backend/src/main/java/com/myspace/bookmarks/PublicBookmarksController.java new file mode 100644 index 0000000..f989a1b --- /dev/null +++ b/backend/src/main/java/com/myspace/bookmarks/PublicBookmarksController.java @@ -0,0 +1,61 @@ +package com.myspace.bookmarks; + +import com.myspace.assets.AssetFiles; +import com.myspace.common.HttpCache; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import jakarta.validation.constraints.Min; +import java.nio.charset.StandardCharsets; +import java.util.List; +import java.util.Map; +import org.springframework.http.ResponseEntity; +import org.springframework.core.io.Resource; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.util.DigestUtils; +import org.springframework.web.bind.annotation.*; + +/** Anonymous, read-only directory of the owner's navigation bookmarks. */ +@RestController +@RequestMapping("/api/v1/public/bookmarks") +public class PublicBookmarksController { + private static final String FIELDS = "title,url,description,category,updated_at,icon_asset_id,icon_mode,icon_url,new_window"; + private final JdbcTemplate db; + private final HttpCache cache; + private final AssetFiles files; + + public PublicBookmarksController(JdbcTemplate db, HttpCache cache, AssetFiles files) { + this.db = db; + this.cache = cache; + this.files = files; + } + + @GetMapping + public ResponseEntity>> list( + HttpServletRequest req, + HttpServletResponse res, + @RequestParam(defaultValue = "0") @Min(0) int offset, + @RequestParam(defaultValue = "50") @Min(1) int limit) { + int size = Math.min(limit, 100); + List> bookmarks = + db.queryForList( + "select " + FIELDS + ",updated_at::text as cache_version from published_bookmarks" + + " order by sort_order,id limit ? offset ?", + size, + offset); + String version = bookmarks.stream() + .map(row -> row.get("title") + ":" + row.get("url") + ":" + row.get("icon_asset_id") + ":" + row.remove("cache_version")) + .reduce("", (a, b) -> a + "," + b); + res.setHeader("Cache-Control", "no-cache"); + return cache.etag(bookmarks, DigestUtils.md5DigestAsHex(version.getBytes(StandardCharsets.UTF_8)), req); + } + + @GetMapping("/images/{id}") + public ResponseEntity image(@PathVariable java.util.UUID id) { + var rows = db.queryForList( + "select a.media_type,a.name,a.size from published_bookmarks b join assets a on a.id=b.icon_asset_id where a.id=? and a.deleted_at is null", + id); + if (!rows.isEmpty() && AssetFiles.isImage((String) rows.get(0).get("media_type"))) + return files.content(id, rows.get(0), false, "no-store"); + throw new org.springframework.web.server.ResponseStatusException(org.springframework.http.HttpStatus.NOT_FOUND, "图标不存在或未公开"); + } +} diff --git a/backend/src/main/java/com/myspace/common/ApiErrors.java b/backend/src/main/java/com/myspace/common/ApiErrors.java new file mode 100644 index 0000000..caf5ddc --- /dev/null +++ b/backend/src/main/java/com/myspace/common/ApiErrors.java @@ -0,0 +1,27 @@ +package com.myspace.common; + +import java.util.Map; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.MethodArgumentNotValidException; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.multipart.MaxUploadSizeExceededException; +import org.springframework.web.server.ResponseStatusException; + +@RestControllerAdvice +public class ApiErrors { + @ExceptionHandler(ResponseStatusException.class) + ResponseEntity status(ResponseStatusException e) { + return ResponseEntity.status(e.getStatusCode()) + .body(Map.of("message", e.getReason() == null ? "请求失败" : e.getReason())); + } + + @ExceptionHandler(MethodArgumentNotValidException.class) + ResponseEntity invalid(Exception e) { + return ResponseEntity.badRequest().body(Map.of("message", "输入内容无效,请检查必填项和长度")); + } + + @ExceptionHandler(MaxUploadSizeExceededException.class) + ResponseEntity large(Exception e) { + return ResponseEntity.status(413).body(Map.of("message", "单个文件最大 15 MB")); + } +} diff --git a/backend/src/main/java/com/myspace/common/HttpCache.java b/backend/src/main/java/com/myspace/common/HttpCache.java new file mode 100644 index 0000000..b8af3f0 --- /dev/null +++ b/backend/src/main/java/com/myspace/common/HttpCache.java @@ -0,0 +1,17 @@ +package com.myspace.common; + +import jakarta.servlet.http.HttpServletRequest; +import org.springframework.http.MediaType; +import org.springframework.http.ResponseEntity; +import org.springframework.stereotype.Component; + +/** 公开只读接口的 ETag:内容未变时返回 304,轮询不会重复下载正文。 */ +@Component +public class HttpCache { + public ResponseEntity etag(T body, String version, HttpServletRequest req) { + String tag = "\"" + version + "\""; + if (tag.equals(req.getHeader("If-None-Match"))) + return ResponseEntity.status(304).eTag(tag).build(); + return ResponseEntity.ok().eTag(tag).contentType(MediaType.APPLICATION_JSON).body(body); + } +} diff --git a/backend/src/main/java/com/myspace/common/SecurityHeaders.java b/backend/src/main/java/com/myspace/common/SecurityHeaders.java new file mode 100644 index 0000000..85acaee --- /dev/null +++ b/backend/src/main/java/com/myspace/common/SecurityHeaders.java @@ -0,0 +1,26 @@ +package com.myspace.common; + +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import java.io.IOException; +import org.springframework.core.Ordered; +import org.springframework.core.annotation.Order; +import org.springframework.stereotype.Component; +import org.springframework.web.filter.OncePerRequestFilter; + +/** 统一安全响应头:防 MIME 嗅探、限制 Referer 泄露、禁止被第三方站点内嵌。 */ +@Component +@Order(Ordered.HIGHEST_PRECEDENCE) +public class SecurityHeaders extends OncePerRequestFilter { + @Override + protected void doFilterInternal( + HttpServletRequest req, HttpServletResponse res, FilterChain chain) + throws ServletException, IOException { + res.setHeader("X-Content-Type-Options", "nosniff"); + res.setHeader("Referrer-Policy", "strict-origin-when-cross-origin"); + res.setHeader("X-Frame-Options", "SAMEORIGIN"); + chain.doFilter(req, res); + } +} diff --git a/backend/src/main/java/com/myspace/common/WorkspaceNotifications.java b/backend/src/main/java/com/myspace/common/WorkspaceNotifications.java new file mode 100644 index 0000000..aff56b5 --- /dev/null +++ b/backend/src/main/java/com/myspace/common/WorkspaceNotifications.java @@ -0,0 +1,21 @@ +package com.myspace.common; + +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Component; + +/** 通知中心统一写入口,标题最多 160 字符。 */ +@Component +public class WorkspaceNotifications { + private final JdbcTemplate db; + public WorkspaceNotifications(JdbcTemplate db) { this.db = db; } + + public void notify(String title) { + db.update("insert into workspace_notifications(title) values(?)", clip(title, 160)); + } + + public static String clip(String value, int limit) { + if (value == null) return ""; + if (value.length() <= limit) return value; + return value.substring(0, Character.isHighSurrogate(value.charAt(limit - 1)) ? limit - 1 : limit); + } +} diff --git a/backend/src/main/java/com/myspace/dashboard/DashboardController.java b/backend/src/main/java/com/myspace/dashboard/DashboardController.java new file mode 100644 index 0000000..bf9ea71 --- /dev/null +++ b/backend/src/main/java/com/myspace/dashboard/DashboardController.java @@ -0,0 +1,63 @@ +package com.myspace.dashboard; + +import java.time.LocalDate; +import java.time.format.DateTimeParseException; +import java.util.Map; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.*; + +@RestController +public class DashboardController { + private final JdbcTemplate db; + + public DashboardController(JdbcTemplate db) { + this.db = db; + } + + /** + * 工作台聚合。tasks 对应原型首页「今日待办」: + * 未完成且(指定了截止日期的已到期,或未指定日期的随手待办)可见, + * 逾期项按「高优先 → 早到期」排在最前,与原型一致。 + */ + @GetMapping("/api/v1/dashboard") + public Map dashboard( + @RequestParam(defaultValue = "") String today) { + String day = todayDate(today).toString(); + return Map.of( + "notes", + db.queryForObject("select count(*) from notes where deleted_at is null", Long.class), + "starred", + db.queryForObject("select count(*) from notes where deleted_at is null and star", Long.class), + "assets", + db.queryForObject("select count(*) from assets where deleted_at is null", Long.class), + "bookmarks", + db.queryForObject("select count(*) from bookmarks where deleted_at is null", Long.class), + "storageBytes", + db.queryForObject("select coalesce(sum(size),0) from assets where deleted_at is null", Long.class), + "recentNotes", + db.queryForList("select * from notes where deleted_at is null order by updated_at desc limit 4"), + "tasks", + db.queryForList("select id,title,priority," + + "to_char(starts_at,'YYYY-MM-DD\"T\"HH24:MI') as starts_at" + + " from planner_items where kind='tasks' and not completed and deleted_at is null" + + " and (starts_at is null or starts_at < ?::timestamp)" + + " order by (starts_at is not null) desc,(priority='high') desc,starts_at,updated_at desc,id limit 4", + day + "T23:59:59"), + // due 与上方「今日待办」保持同一口径:到期的或未设日期的未完成项 + "taskCounts", + db.queryForMap("select count(*) filter(where not completed) as open," + + " count(*) filter(where not completed" + + " and (starts_at is null or starts_at < ?::timestamp)) as due," + + " count(*) filter(where completed) as done" + + " from planner_items where kind='tasks' and deleted_at is null", day + "T23:59:59"), + "recentRss", + db.queryForList("select a.id,a.title,b.title as source from rss_articles a join rss_sources b on b.id=a.source_id" + + " where a.deleted_at is null and b.deleted_at is null" + + " order by coalesce(a.published_at,a.fetched_at) desc,a.id limit 3")); + } + + private static LocalDate todayDate(String today) { + try { return today.isBlank() ? LocalDate.now() : LocalDate.parse(today); } + catch (DateTimeParseException invalid) { return LocalDate.now(); } + } +} diff --git a/backend/src/main/java/com/myspace/library/InboxController.java b/backend/src/main/java/com/myspace/library/InboxController.java new file mode 100644 index 0000000..779d3ab --- /dev/null +++ b/backend/src/main/java/com/myspace/library/InboxController.java @@ -0,0 +1,132 @@ +package com.myspace.library; + +import com.myspace.admin.PlannerController; +import com.myspace.bookmarks.BookmarksController; +import com.myspace.notes.NotesController; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/inbox") +public class InboxController { + private final JdbcTemplate db; + private final NotesController notes; + private final BookmarksController bookmarks; + private final PlannerController planner; + private final TrashService trash; + public InboxController(JdbcTemplate db, NotesController notes, BookmarksController bookmarks, PlannerController planner, + TrashService trash) { + this.db=db; this.notes=notes; this.bookmarks=bookmarks; this.planner=planner; this.trash=trash; + } + + @GetMapping + public List> list( + @RequestParam(defaultValue = "false") boolean processed, + @RequestParam(defaultValue = "0") @Min(0) int offset) { + return db.queryForList("select * from inbox_items where deleted_at is null and (processed_at is not null)=?" + + " order by created_at desc,id limit 100 offset ?", processed, offset); + } + + public record Capture(@NotBlank @Size(max=255) String title,@NotBlank @Size(max=200000) String content) {} + + @GetMapping("/{id}") + public Map get(@PathVariable UUID id) { + return live(id); + } + + /** 删除收集项:与原型一致,先进全站统一回收站(可恢复)。 */ + @DeleteMapping("/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void delete(@PathVariable UUID id) { + String title = db.queryForList("select title from inbox_items where id=? and deleted_at is null for update", + String.class, id).stream().findFirst().orElseThrow(InboxController::missing); + db.update("update inbox_items set deleted_at=now() where id=?", id); + trash.notifyTrashed("inbox", title); + } + + /** 读取未删除的收集项。 */ + private Map live(UUID id) { + return db.queryForList("select * from inbox_items where id=? and deleted_at is null",id).stream() + .findFirst().orElseThrow(InboxController::missing); + } + + @PostMapping + @ResponseStatus(HttpStatus.NO_CONTENT) + public void manual(@Valid @RequestBody Capture input) { + UUID id=UUID.randomUUID(); + db.update("insert into inbox_items(id,source_kind,source_id,title,content) values(?,'manual',?,?,?)", + id,id,input.title().strip(),input.content()); + } + + @PostMapping("/{kind}/{source}") + @Transactional + public Map capture(@PathVariable String kind, @PathVariable UUID source) { + String query = switch (kind) { + case "bookmarks" -> "select title,concat_ws(chr(10),url,nullif(description,'')) as content" + + " from bookmarks where id=? and deleted_at is null"; + case "assets" -> "select name as title,concat_ws(chr(10),'/api/v1/assets/' || id || '/content',nullif(description,'')) as content" + + " from assets where id=? and deleted_at is null"; + case "rss" -> "select title,concat_ws(chr(10),url,nullif(body,'')) as content from rss_articles where id=?"; + default -> throw missing(); + }; + var item = db.queryForList(query, source).stream().findFirst().orElseThrow(InboxController::missing); + // 同一来源在回收站里还有旧条目时,再次采集视为「重新收集」:复活该条目并刷新内容,避免 unique(source_kind,source_id) 冲突 + if (db.update("update inbox_items set deleted_at=null,title=?,content=?,processed_at=null,target_kind=null,target_id=null" + + " where source_kind=? and source_id=? and deleted_at is not null", + item.get("title"), item.get("content"), kind, source) > 0) + return db.queryForMap("select * from inbox_items where source_kind=? and source_id=?", kind, source); + db.update("insert into inbox_items(id,source_kind,source_id,title,content) values(?,?,?,?,?)" + + " on conflict(source_kind,source_id) do nothing", + UUID.randomUUID(), kind, source, item.get("title"), item.get("content")); + return db.queryForMap("select * from inbox_items where source_kind=? and source_id=?", kind, source); + } + + @PostMapping("/{id}/organize/{target}") + @Transactional + public Map organize(@PathVariable UUID id,@PathVariable String target) { + var item=db.queryForList("select * from inbox_items where id=? and deleted_at is null for update",id).stream() + .findFirst().orElseThrow(InboxController::missing); + if(item.get("target_id")!=null) { + if(!target.equals(item.get("target_kind"))) + throw new ResponseStatusException(HttpStatus.CONFLICT,"此收集项已转存"); + return Map.of("kind",target,"id",item.get("target_id")); + } + String title=(String)item.get("title"), content=(String)item.get("content"); + String first=content.lines().findFirst().orElse("").strip(); + var result=switch(target) { + case "notes" -> notes.create(new NotesController.Input(clip(title,120),content, + db.queryForList("select name from note_categories order by id limit 1",String.class).getFirst(),"",false,0,null,null)); + case "tasks" -> planner.create("tasks",new PlannerController.Input(clip(title,160),clip(content,100000), + "收集箱",null,false,"normal",null,null,null)); + case "bookmarks" -> bookmarks.create(new BookmarksController.Input(clip(title,60),first,clip(content.substring(Math.min(first.length(),content.length())).strip(),160), + db.queryForList("select name from bookmark_categories order by name limit 1",String.class).getFirst(),null,false,null,null,true,"default",null)); + default -> throw missing(); + }; + db.update("update inbox_items set target_kind=?,target_id=?,processed_at=now() where id=?",target,result.get("id"),id); + return Map.of("kind",target,"id",result.get("id")); + } + + private static String clip(String value,int length) { + if(value.length()<=length) return value; + return value.substring(0,Character.isHighSurrogate(value.charAt(length-1)) ? length-1 : length); + } + + @PutMapping("/{id}/processed") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void process(@PathVariable UUID id, @RequestBody Processed input) { + if (db.update("update inbox_items set processed_at=case when ? then coalesce(processed_at,now()) else null end" + + " where id=? and deleted_at is null", input.processed(), id) == 0) throw missing(); + } + + public record Processed(boolean processed) {} + + private static ResponseStatusException missing() { + return new ResponseStatusException(HttpStatus.NOT_FOUND, "收集来源或收集项不存在"); + } +} diff --git a/backend/src/main/java/com/myspace/library/LibraryController.java b/backend/src/main/java/com/myspace/library/LibraryController.java new file mode 100644 index 0000000..457858a --- /dev/null +++ b/backend/src/main/java/com/myspace/library/LibraryController.java @@ -0,0 +1,227 @@ +package com.myspace.library; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/library") +public class LibraryController { + private static final Set KINDS = Set.of("notes", "blogs", "assets", "bookmarks"); + private final JdbcTemplate db; + private final TrashService trash; + + public LibraryController(JdbcTemplate db, TrashService trash) { + this.db = db; + this.trash = trash; + } + + public record Name(@NotBlank @Size(max = 60) String name) {} + public record CategoryChange(@NotBlank @Size(max = 60) String name, + @NotBlank @Size(max = 60) String target, boolean remove) {} + public record Batch(@NotEmpty @Size(max = 500) List<@NotNull UUID> ids, + @NotBlank String action, @Size(max = 1500) String value) {} + + @GetMapping("/{kind}/folders") + public List folders(@PathVariable String kind) { + folderKind(kind); + return db.queryForList("select name from library_folders where kind=? order by name", String.class, kind); + } + + @PostMapping("/{kind}/folders") + @ResponseStatus(HttpStatus.CREATED) + public Map addFolder(@PathVariable String kind, @Valid @RequestBody Name input) { + folderKind(kind); + if (db.update("insert into library_folders(kind,name) values(?,?) on conflict do nothing", + kind, input.name().strip()) == 0) + throw new ResponseStatusException(HttpStatus.CONFLICT, "文件夹已存在"); + return Map.of("name", input.name().strip()); + } + + @GetMapping("/{kind}/categories") + public List> categories(@PathVariable String kind) { + String table = categoryTable(kind); + return db.queryForList("select c.name,count(r.id) as count from " + table + " c left join " + + kind + " r on r.category=c.name and r.deleted_at is null group by c.name order by c.name"); + } + + @PostMapping("/{kind}/categories") + @ResponseStatus(HttpStatus.CREATED) + public Map addCategory(@PathVariable String kind, @Valid @RequestBody Name input) { + if (db.update("insert into " + categoryTable(kind) + "(name) values(?) on conflict do nothing", + input.name().strip()) == 0) + throw new ResponseStatusException(HttpStatus.CONFLICT, "分类已存在"); + return Map.of("name", input.name().strip()); + } + + @PutMapping("/{kind}/categories") + @Transactional + @ResponseStatus(HttpStatus.NO_CONTENT) + public void changeCategory(@PathVariable String kind, @Valid @RequestBody CategoryChange input) { + String table = categoryTable(kind); + String name = input.name().strip(), target = input.target().strip(); + if (name.equals(target)) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请选择不同的分类"); + if (db.queryForList("select name from " + table + " where name=? for update", String.class, name).isEmpty()) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "分类不存在"); + if (input.remove()) requireCategory(kind, target); + else addCategory(kind, new Name(target)); + String revision = kind.equals("notes") || kind.equals("blogs") + ? ",version=version+1,updated_at=now()" : kind.equals("bookmarks") ? ",updated_at=now()" : ""; + db.update("update " + kind + " set category=?" + revision + " where category=?", target, name); + db.update("delete from " + table + " where name=?", name); + } + + @GetMapping("/{kind}/facets") + public Map facets(@PathVariable String kind) { + folderKind(kind); + var counts = db.queryForList("select folder,count(*) as count from " + kind + + " where deleted_at is null group by folder"); + var tags = db.queryForList("select distinct item.name from " + kind + + " cross join lateral unnest(string_to_array(tags,',')) as item(name)" + + " where deleted_at is null and item.name<>'' order by item.name", String.class); + var stats = kind.equals("assets") + ? db.queryForMap("select count(*) filter(where media_type like 'image/%') as images," + + "count(*) filter(where media_type not like 'image/%') as files,coalesce(sum(size),0) as bytes" + + " from assets where deleted_at is null") + : Map.of(); + return Map.of("folders", counts, "tags", tags, "stats", stats); + } + + @PostMapping("/{kind}/batch") + @Transactional + @ResponseStatus(HttpStatus.NO_CONTENT) + public void batch(@PathVariable String kind, @Valid @RequestBody Batch input) { + checkKind(kind); + var ids = new LinkedHashSet<>(input.ids()); + if ("swap".equals(input.action())) { + if (!kind.equals("bookmarks") || ids.size() != 2) throw invalidAction(); + var items = new ArrayList<>(ids); + var rows = db.queryForList("select id,sort_order from bookmarks where id in (?,?) and deleted_at is null" + + " order by id for update", items.get(0), items.get(1)); + if (rows.size() != 2) throw missing(); + var first = rows.get(0); + var second = rows.get(1); + db.update("update bookmarks set sort_order=? where id=?", second.get("sort_order"), first.get("id")); + db.update("update bookmarks set sort_order=? where id=?", first.get("sort_order"), second.get("id")); + return; + } + for (UUID id : ids) { + int changed = switch (input.action()) { + case "trash" -> trashOne(kind, id); + case "folder" -> { + folderKind(kind); + yield db.update("update " + kind + " set folder=?" + + (kind.equals("notes") ? ",version=version+1,updated_at=now()" : "") + + " where id=? and deleted_at is null", LibraryFields.folder(db, kind, input.value()), id); + } + case "tags" -> appendTags(kind, id, input.value()); + case "category" -> { + requireCategory(kind, input.value()); + String revision = switch (kind) { + case "notes", "blogs" -> ",version=version+1,updated_at=now()"; + case "bookmarks" -> ",updated_at=now()"; + default -> ""; + }; + yield db.update("update " + kind + " set category=?" + revision + + " where id=? and deleted_at is null", input.value(), id); + } + default -> throw invalidAction(); + }; + if (changed == 0) throw missing(); + } + } + + private int appendTags(String kind, UUID id, String value) { + if (kind.equals("blogs")) throw invalidAction(); + var rows = db.queryForList("select tags from " + kind + " where id=? and deleted_at is null for update", + String.class, id); + if (rows.isEmpty()) return 0; + String tags = LibraryFields.tags(rows.getFirst() + "," + Objects.toString(value, "")); + if (kind.equals("notes")) + return db.update("update notes set tags=?,tag=?,version=version+1,updated_at=now() where id=?", + tags, LibraryFields.firstTag(tags), id); + return db.update("update " + kind + " set tags=? where id=?", tags, id); + } + + public int trash(String kind, UUID id) { + checkKind(kind); + String visibility = switch (kind) { + case "notes" -> ",version=version+1"; + case "bookmarks" -> ",is_public=false"; + case "blogs" -> ",status='draft',version=version+1,updated_at=now()"; + default -> ""; + }; + return db.update("update " + kind + " set deleted_at=now()" + visibility + + " where id=? and deleted_at is null", id); + } + + @GetMapping("/{kind}/trash") + public List> trashList(@PathVariable String kind, + @RequestParam(defaultValue = "0") @Min(0) int offset) { + checkKind(kind); + return db.queryForList("select id," + (kind.equals("assets") ? "name as title" : "title") + + ",deleted_at from " + kind + " where deleted_at is not null order by deleted_at desc,id limit 100 offset ?", offset); + } + + /** 回收站恢复/永久删除统一走 TrashService,分类缺失时自动补回。 */ + @PostMapping("/{kind}/trash/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void restore(@PathVariable String kind, @PathVariable UUID id) { + checkKind(kind); + trash.restore(kind, id); + } + + @DeleteMapping("/{kind}/trash/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + public void purge(@PathVariable String kind, @PathVariable UUID id) { + checkKind(kind); + trash.purge(kind, id); + } + + @Transactional + private int trashOne(String kind, UUID id) { + String title = db.queryForList("select " + (kind.equals("assets") ? "name" : "title") + " from " + kind + + " where id=? and deleted_at is null for update", String.class, id).stream().findFirst() + .orElseThrow(LibraryController::missing); + if (trash(kind, id) == 0) throw missing(); + trash.notifyTrashed(kind, title); + return 1; + } + + private void requireCategory(String kind, String name) { + if (name == null || db.queryForList("select name from " + categoryTable(kind) + + " where name=? for key share", String.class, name).isEmpty()) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "分类不存在"); + } + + private static String categoryTable(String kind) { + return switch (kind) { + case "notes" -> "note_categories"; + case "assets" -> "asset_categories"; + case "blogs" -> "blog_categories"; + case "bookmarks" -> "bookmark_categories"; + default -> throw missing(); + }; + } + + private static void checkKind(String kind) { + if (!KINDS.contains(kind)) throw missing(); + } + + private static void folderKind(String kind) { + if (!kind.equals("notes") && !kind.equals("assets")) throw missing(); + } + + private static ResponseStatusException missing() { + return new ResponseStatusException(HttpStatus.NOT_FOUND, "记录不存在"); + } + + private static ResponseStatusException invalidAction() { + return new ResponseStatusException(HttpStatus.BAD_REQUEST, "操作不适用于当前模块"); + } +} diff --git a/backend/src/main/java/com/myspace/library/LibraryFields.java b/backend/src/main/java/com/myspace/library/LibraryFields.java new file mode 100644 index 0000000..3b78c32 --- /dev/null +++ b/backend/src/main/java/com/myspace/library/LibraryFields.java @@ -0,0 +1,34 @@ +package com.myspace.library; + +import java.util.Arrays; +import java.util.stream.Collectors; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.server.ResponseStatusException; + +public final class LibraryFields { + public static final String DEFAULT_FOLDER = "默认文件夹"; + private LibraryFields() {} + + public static String tags(String text) { + if (text == null) return ""; + return Arrays.stream(text.split("[,,]")).map(String::strip).filter(tag -> !tag.isEmpty()) + .distinct().limit(24).map(tag -> { + if (tag.length() > 60) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "每个标签最多 60 字符"); + return tag; + }).collect(Collectors.joining(",")); + } + + public static String firstTag(String tags) { + return tags.split(",", 2)[0]; + } + + public static String folder(JdbcTemplate db, String kind, String name) { + String folder = name == null || name.isBlank() ? DEFAULT_FOLDER : name.strip(); + if (!Boolean.TRUE.equals(db.queryForObject( + "select exists(select 1 from library_folders where kind=? and name=?)", + Boolean.class, kind, folder))) + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "文件夹不存在"); + return folder; + } +} diff --git a/backend/src/main/java/com/myspace/library/PublicationController.java b/backend/src/main/java/com/myspace/library/PublicationController.java new file mode 100644 index 0000000..06c6484 --- /dev/null +++ b/backend/src/main/java/com/myspace/library/PublicationController.java @@ -0,0 +1,104 @@ +package com.myspace.library; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Isolation; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/publication") +public class PublicationController { + private final JdbcTemplate db; + + public PublicationController(JdbcTemplate db) { + this.db = db; + } + + public record Input(@Min(0) long revision,@NotNull List<@NotNull UUID> bookmarks, + List<@NotNull UUID> prompts,List<@NotNull UUID> images) {} + + @GetMapping + @Transactional(readOnly = true, isolation = Isolation.REPEATABLE_READ) + public Map preview() { + var blogs = db.queryForList("select b.id,b.title,b.category,b.slug,p.id is not null as live," + + " (p.version is distinct from b.version) as pending from blogs b left join published_blogs p on p.id=b.id" + + " where b.deleted_at is null and b.status='published' order by b.updated_at desc,b.id"); + var bookmarks = db.queryForList("select b.id,b.title,b.category,b.is_public as selected,p.id is not null as live," + + " case when p.id is null then b.is_public else" + + " (b.title,b.url,b.description,b.category,b.icon_asset_id,b.icon_mode,b.icon_url,b.new_window,b.sort_order)" + + " is distinct from (p.title,p.url,p.description,p.category,p.icon_asset_id,p.icon_mode,p.icon_url,p.new_window,p.sort_order)" + + " end as pending from bookmarks b left join published_bookmarks p on p.id=b.id" + + " where b.deleted_at is null order by b.sort_order,b.id"); + var prompts=db.queryForList("select a.id,a.title,a.category,p.id is not null as selected," + +" p.id is not null and (a.title,a.body,a.category) is distinct from (p.title,p.body,p.category) as pending" + +" from ai_prompts a left join published_ai_prompts p on p.id=a.id where a.deleted_at is null order by a.title,a.id"); + var images=db.queryForList("select r.id,a.name as title,p.id is not null as selected" + +" from ai_runs r join assets a on a.id=r.asset_id left join published_ai_images p on p.id=r.id" + +" where r.mode='image' and a.deleted_at is null order by r.created_at desc,r.id"); + return Map.of("state",state(),"blogs",blogs,"bookmarks",bookmarks,"prompts",prompts,"images",images); + } + + @PostMapping + @Transactional + public Map publish(@Valid @RequestBody Input input) { + long revision = db.queryForObject("select revision from publication_state where id=1 for update", Long.class); + if (revision != input.revision()) + throw new ResponseStatusException(HttpStatus.CONFLICT, "已有新的发布版本,请重新打开发布面板"); + db.execute("lock table blogs, bookmarks in share row exclusive mode"); + replaceStudio(input.prompts(),input.images()); + var ids = new LinkedHashSet<>(input.bookmarks()); + var available = new HashSet<>(db.queryForList("select id from bookmarks where deleted_at is null", UUID.class)); + if (!available.containsAll(ids)) + throw new ResponseStatusException(HttpStatus.CONFLICT, "勾选的书签已变更,请重新打开发布面板"); + db.update("update bookmarks set is_public=false where is_public and deleted_at is null"); + for (UUID id : ids) db.update("update bookmarks set is_public=true where id=?", id); + db.update("delete from published_blogs"); + int blogs = db.update("insert into published_blogs" + + " select id,slug,title,summary,body,category,cover_asset_id,cover_url,updated_at,version" + + " from blogs where deleted_at is null and status='published'"); + db.update("delete from published_bookmarks"); + int bookmarks = db.update("insert into published_bookmarks" + + " select id,title,url,description,category,icon_asset_id,icon_mode,icon_url,new_window,sort_order,updated_at" + + " from bookmarks where deleted_at is null and is_public"); + db.update("update publication_state set revision=revision+1,published_at=now() where id=1"); + db.update("insert into workspace_notifications(title) values(?)", "已同步 %d 篇文章和 %d 个书签".formatted(blogs,bookmarks)); + return Map.of("state", state(), "blogs", blogs, "bookmarks", bookmarks); + } + + @GetMapping("/export") + @Transactional(readOnly = true, isolation = Isolation.REPEATABLE_READ) + public Map export() { + return Map.of("state", state(), + "blogs", db.queryForList("select title,summary,body,category,slug,cover_asset_id,cover_url,updated_at" + + " from published_blogs order by updated_at desc,id"), + "bookmarks", db.queryForList("select title,url,description,category,icon_asset_id,icon_mode,icon_url,new_window,updated_at" + + " from published_bookmarks order by sort_order,id"), + "prompts",db.queryForList("select title,body,category from published_ai_prompts order by title,id"), + "images",db.queryForList("select id,title from published_ai_images order by title,id")); + } + + private void replaceStudio(List prompts,List images) { + if(prompts!=null) { + db.update("delete from published_ai_prompts"); + for(UUID id:new LinkedHashSet<>(prompts)) + if(db.update("insert into published_ai_prompts select id,title,body,category from ai_prompts where id=? and deleted_at is null",id)==0) + throw new ResponseStatusException(HttpStatus.CONFLICT,"提示词已变更,请重新打开发布面板"); + } + if(images!=null) { + db.update("delete from published_ai_images"); + for(UUID id:new LinkedHashSet<>(images)) + if(db.update("insert into published_ai_images select r.id,a.id,a.name from ai_runs r join assets a on a.id=r.asset_id" + +" where r.id=? and r.mode='image' and a.deleted_at is null for share of a",id)==0) + throw new ResponseStatusException(HttpStatus.CONFLICT,"图片已变更,请重新打开发布面板"); + } + } + + private Map state() { + return db.queryForMap("select revision,published_at from publication_state where id=1"); + } +} diff --git a/backend/src/main/java/com/myspace/library/TrashService.java b/backend/src/main/java/com/myspace/library/TrashService.java new file mode 100644 index 0000000..6127819 --- /dev/null +++ b/backend/src/main/java/com/myspace/library/TrashService.java @@ -0,0 +1,144 @@ +package com.myspace.library; + +import com.myspace.assets.AssetFiles; +import com.myspace.common.WorkspaceNotifications; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.server.ResponseStatusException; + +/** + * 全站唯一回收站:各模块的删除都只写 deleted_at,恢复/永久删除集中在这里处理。 + * 标签文案与原型 KIND_NAME 保持一致。 + */ +@Service +public class TrashService { + public record Spec(String table, String title, String name, boolean category) {} + private static final Map SPECS = Map.ofEntries( + Map.entry("notes", new Spec("notes", "笔记", "title", true)), + Map.entry("blogs", new Spec("blogs", "博客", "title", true)), + Map.entry("bookmarks", new Spec("bookmarks", "书签", "title", true)), + Map.entry("assets", new Spec("assets", "素材", "name", true)), + Map.entry("tasks", new Spec("planner_items", "待办", "title", false)), + Map.entry("events", new Spec("planner_items", "日程", "title", false)), + Map.entry("snippets", new Spec("planner_items", "代码片段", "title", false)), + Map.entry("rss", new Spec("rss_sources", "RSS 订阅", "title", false)), + Map.entry("prompts", new Spec("ai_prompts", "AI 提示词", "title", false)), + Map.entry("flows", new Spec("workspace_flows", "自动化工作流", "title", false)), + // 收集箱没有分类列:恢复时不补分类 + Map.entry("inbox", new Spec("inbox_items", "收集项", "title", false))); + public static final List KINDS = List.of("notes", "blogs", "bookmarks", "assets", + "tasks", "events", "snippets", "rss", "prompts", "flows", "inbox"); + private static final Map CATEGORY_TABLES = Map.of( + "notes", "note_categories", "blogs", "blog_categories", + "assets", "asset_categories", "bookmarks", "bookmark_categories"); + + private final JdbcTemplate db; + private final AssetFiles files; + private final WorkspaceNotifications notifications; + + public TrashService(JdbcTemplate db, AssetFiles files, WorkspaceNotifications notifications) { + this.db = db; + this.files = files; + this.notifications = notifications; + } + + public static boolean isPlanner(String kind) { return Objects.equals(spec(kind).table(), "planner_items"); } + public static String label(String kind) { return spec(kind).title(); } + public static String titleColumn(String kind) { return spec(kind).name(); } + + public static Spec spec(String kind) { + Spec spec = SPECS.get(kind); + if (spec == null) throw missing(); + return spec; + } + + /** 同一张 planner_items 表按 kind 区分待办/日程/代码片段。 */ + public static String match(String kind) { + return isPlanner(kind) ? "kind=? and id=?" : "id=?"; + } + + /** + * 供 JdbcTemplate#queryForList(String, Object...) 使用的参数。注意不要直接写成 + * queryForList(sql, args(kind, id)),那样 Object[] 会被当成单个可变参数(一张表会被塞进占位符)。 + */ + public static Object[] args(String kind, UUID id) { + return isPlanner(kind) ? new Object[]{kind, id} : new Object[]{id}; + } + + /** 读取仍在使用中的记录标题,用于删除通知。 */ + public String liveTitle(String kind, UUID id) { + Object[] a = args(kind, id); + return db.queryForList("select " + titleColumn(kind) + " from " + spec(kind).table() + + " where " + match(kind) + " and deleted_at is null", String.class, a) + .stream().findFirst().orElseThrow(TrashService::missing); + } + + /** 删除后记录通知。注意:软删除后再查 liveTitle 会找不到记录,调用方应在删除前取好标题。 */ + public void notifyTrashed(String kind, String title) { + notifications.notify("已删除" + label(kind) + "「" + WorkspaceNotifications.clip(title, 100) + "」,可在回收站恢复"); + } + + /** 删除前由调用方用给定的查询(在删除前)读取标题,再做软删除,两者处于同一事务。 */ + public void notifyLive(String kind, UUID id, String selectTitle) { + Object[] a = args(kind, id); + notifyTrashed(kind, db.queryForList(selectTitle, String.class, a).stream().findFirst() + .orElseThrow(TrashService::missing)); + } + + public void notifyTrashed(String kind, UUID id) { + notifications.notify("已删除" + label(kind) + "「" + WorkspaceNotifications.clip(liveTitle(kind, id), 100) + + "」,可在回收站恢复"); + } + + @Transactional + public void restore(String kind, UUID id) { + Spec spec = spec(kind); + var rows = query(kind, id, " and deleted_at is not null for update"); + if (rows.isEmpty()) throw missing(); + Object[] a = args(kind, id); + db.update("update " + spec.table() + " set deleted_at=null where " + match(kind), a); + Object category = rows.getFirst().get("category"); + if (spec.category() && category != null) ensureCategory(kind, (String) category); + notifications.notify("已恢复" + label(kind) + "「" + + WorkspaceNotifications.clip((String) rows.getFirst().get("title"), 100) + "」" + // 订阅删除时文章被同事务隐藏,恢复订阅不会把旧文章带回来,这里明确告知,避免误解 + + (Objects.equals(kind, "rss") ? ";删除时隐藏的历史文章不会恢复,下次刷新只拉取新文章" : "")); + } + + @Transactional + public void purge(String kind, UUID id) { + if (id == null) throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "缺少记录 ID"); + Spec spec = spec(kind); + if (Objects.equals(spec.table(), "assets")) { + // 素材沿用 AssetFiles 的规则:仍被引用时拒绝永久删除,并同步清理磁盘文件 + files.purge(db, id); + return; + } + if (query(kind, id, " and deleted_at is not null for update").isEmpty()) throw missing(); + Object[] a = args(kind, id); + db.update("delete from " + spec.table() + " where " + match(kind), a); + if (Objects.equals(spec.table(), "notes")) db.update("delete from note_history where note_id=?", id); + if (isPlanner(kind)) db.update("delete from inbox_items where target_kind=? and target_id=?", kind, id); + } + + private List> query(String kind, UUID id, String tail) { + Spec spec = spec(kind); + Object[] a = args(kind, id); + return db.queryForList("select " + spec.name() + " as title" + + (spec.category() ? ",category" : "") + " from " + spec.table() + " where " + match(kind) + tail, a); + } + + private void ensureCategory(String kind, String name) { + String table = CATEGORY_TABLES.get(kind); + if (table == null) return; + if (db.update("insert into " + table + "(name) values(?) on conflict (name) do nothing", name) == 1) + notifications.notify("恢复时补回「" + label(kind) + "」分类:" + WorkspaceNotifications.clip(name, 60)); + } + + public static ResponseStatusException missing() { + return new ResponseStatusException(HttpStatus.NOT_FOUND, "记录不在回收站或不存在"); + } +} diff --git a/backend/src/main/java/com/myspace/notes/NoteCategoriesController.java b/backend/src/main/java/com/myspace/notes/NoteCategoriesController.java new file mode 100644 index 0000000..8aa534a --- /dev/null +++ b/backend/src/main/java/com/myspace/notes/NoteCategoriesController.java @@ -0,0 +1,111 @@ +package com.myspace.notes; + +import jakarta.validation.Valid; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; +import java.util.List; +import java.util.Map; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/notes/categories") +public class NoteCategoriesController { + private final JdbcTemplate db; + + public NoteCategoriesController(JdbcTemplate db) { + this.db = db; + } + + public record Input(@NotBlank @Size(max = 60) String name) {} + public record Usage(String name, long noteCount) {} + + @GetMapping + public List list() { + return db.queryForList("select name from note_categories order by id", String.class); + } + + @GetMapping("/usage") + public List usage() { + return db.query( + "select c.name,count(n.id) from note_categories c left join notes n on n.category=c.name and n.deleted_at is null" + + " group by c.id order by c.id", + (row, index) -> new Usage(row.getString(1), row.getLong(2))); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + public Map create(@Valid @RequestBody Input input) { + String name = input.name().strip(); + if (name.isEmpty() || name.equals("全部") || name.equals("已收藏")) { + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请输入分类名称,不能使用「全部」或「已收藏」"); + } + if (db.update("insert into note_categories(name) values(?) on conflict (name) do nothing", name) == 0) { + throw new ResponseStatusException(HttpStatus.CONFLICT, "该分类已存在"); + } + return Map.of("name", name); + } + + @DeleteMapping + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void delete(@RequestParam String name, @RequestParam(required = false) String replacement) { + // 锁住分类表:新建/编辑笔记也会写这张表(on conflict do nothing),并发写入时迁移与删除会互相覆盖 + db.execute("lock table note_categories in share row exclusive mode"); + List categories = list(); + if (!categories.contains(name)) { + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "分类不存在"); + } + if (replacement != null && replacement.isEmpty()) replacement = null; + if (categories.size() == 1) { + throw new ResponseStatusException(HttpStatus.CONFLICT, "至少需要保留一个分类"); + } + if (replacement == null) { + Boolean hasNotes = db.queryForObject( + "select exists(select 1 from notes where category=?)", Boolean.class, name); + if (Boolean.TRUE.equals(hasNotes)) { + throw new ResponseStatusException(HttpStatus.CONFLICT, "该分类仍包含笔记,请先为这些笔记选择其他分类"); + } + } else { + if (name.equals(replacement) || !categories.contains(replacement)) { + throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "请选择另一个已有分类"); + } + moveCategoryNotes(name, replacement); + } + // 历史快照带有 category 外键:不清理会让「分类下只剩历史引用」的删除被外键挡住(整个事务回滚)。 + // 有迁移目标时历史一并迁移(保留可回溯性),没有迁移目标时清掉该分类的版本记录。 + if (replacement == null) db.update("delete from note_history where category=?", name); + else db.update("update note_history set category=? where category=?", replacement, name); + if (db.update("delete from note_categories where name=?", name) == 0) + throw new ResponseStatusException(HttpStatus.NOT_FOUND, "分类不存在"); + } + + /** + * 把分类下的笔记(含回收站中的笔记)迁到目标分类,并补一条「迁移前」的版本快照。 + * 快照必须按「迁移后的版本号」写入,否则迁移后的 history/{version} 会缺失。 + * 顺序:先迁笔记拿到新版本号;再给仍缺快照的笔记补一条,内容取自已迁到目标分类的最早快照; + * 否则迁移这个分类的历史(原分类的快照优先,保持可回溯性)。 + */ + private void moveCategoryNotes(String name, String replacement) { + db.execute("lock table notes in share row exclusive mode"); + List> moved = db.queryForList("update notes set category=?,version=version+1,updated_at=now()" + + " where category=? returning id,version", replacement, name); + for (var note : moved) { + long version = ((Number) note.get("version")).longValue(); + db.update("insert into note_history(note_id,version,title,body,category,folder,tags,star)" + + " select n.id,?,n.title,n.body,n.category,n.folder,n.tags,n.star from notes n" + + " where n.id=? and not exists(select 1 from note_history h where h.note_id=n.id and h.version=?)", + version, note.get("id"), version); + db.update("insert into note_history(note_id,version,title,body,category,folder,tags,star)" + + " select h.note_id,?,h.title,h.body,h.category,h.folder,h.tags,h.star from note_history h" + + " where h.note_id=? and h.category=?" + + " and not exists(select 1 from note_history x where x.note_id=h.note_id and x.version=?)" + + " order by h.saved_at,h.version limit 1", + version, note.get("id"), name, version); + } + db.update("update note_history set category=? where category=?", replacement, name); + } +} diff --git a/backend/src/main/java/com/myspace/notes/NotesController.java b/backend/src/main/java/com/myspace/notes/NotesController.java new file mode 100644 index 0000000..627a2ea --- /dev/null +++ b/backend/src/main/java/com/myspace/notes/NotesController.java @@ -0,0 +1,249 @@ +package com.myspace.notes; + +import com.myspace.common.WorkspaceNotifications; +import com.myspace.library.LibraryFields; +import com.myspace.library.TrashService; +import jakarta.validation.Valid; +import jakarta.validation.constraints.*; +import java.util.*; +import org.springframework.http.HttpStatus; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.transaction.annotation.Transactional; +import org.springframework.web.bind.annotation.*; +import org.springframework.web.server.ResponseStatusException; + +@RestController +@RequestMapping("/api/v1/notes") +public class NotesController { + private final JdbcTemplate db; + private final TrashService trash; + + public NotesController(JdbcTemplate db, TrashService trash) { + this.db = db; + this.trash = trash; + } + + public record Input( + @NotBlank @Size(max = 120) String title, + @NotNull @Size(max = 1000000) String body, + @NotBlank @Size(max = 60) String category, + @NotNull @Size(max = 60) String tag, + boolean star, + @Min(0) long version, @Size(max = 60) String folder, @Size(max = 1500) String tags) {} + + @GetMapping + public List> list( + @RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "") String category, + @RequestParam(defaultValue = "false") boolean starred, + @RequestParam(defaultValue = "") String folder, + @RequestParam(defaultValue = "") String tag, + @RequestParam(defaultValue = "updated") String sort, + @RequestParam(defaultValue = "false") boolean excerpt, + @RequestParam(defaultValue = "0") @Min(0) int offset) { + String order = switch (sort) { + case "created" -> "created_at desc"; + case "name" -> "lower(title)"; + default -> "updated_at desc"; + }; + return db.queryForList( + "select " + (excerpt ? "id,title,left(body,180) as body,category,folder,tags,tag,star,version,created_at,updated_at" : "*") + + " from notes where deleted_at is null and position(lower(?) in lower(title || ' ' || body || ' ' || tags))>0" + + " and (?='' or category=?) and (?=false or star) and (?='' or folder=?)" + + " and (?='' or ?=any(string_to_array(tags,','))) order by " + order + ",id limit 100 offset ?", + q, category, category, starred, folder, folder, tag, tag, offset); + } + + @GetMapping("/resolve") + public List> resolve(@RequestParam String title) { + return db.queryForList("select id,title from notes where title=? and deleted_at is null" + + " order by updated_at desc,id limit 50", title); + } + + @GetMapping("/graph") + public Map graph(@RequestParam(defaultValue = "") String q, + @RequestParam(defaultValue = "") String category) { + var nodes = db.queryForList("select id,title,category from notes where deleted_at is null" + + " and (?='' or category=?) and position(lower(?) in lower(title || ' ' || tags))>0" + + " order by updated_at desc,id limit 24", category, category, q); + var edges = db.queryForList("with scope as (select id,title,body from notes where deleted_at is null" + + " and (?='' or category=?) and position(lower(?) in lower(title || ' ' || tags))>0" + + " order by updated_at desc,id limit 24)" + + " select a.id as source,b.id as target from scope a join scope b on a.id<>b.id" + + " and position('[[' || b.title || ']]' in a.body)>0", category, category, q); + return Map.of("nodes", nodes, "edges", edges); + } + + @GetMapping("/{id}") + public Map get(@PathVariable UUID id) { + return db.queryForList("select * from notes where id=? and deleted_at is null", id).stream() + .findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "笔记不存在")); + } + + @PostMapping + @ResponseStatus(HttpStatus.CREATED) + @Transactional + public Map create(@Valid @RequestBody Input n) { + UUID id = UUID.randomUUID(); + ensureCategory(n.category()); + String tags = LibraryFields.tags(n.tags() == null ? n.tag() : n.tags()); + db.update( + "insert into notes(id,title,body,category,tag,star,folder,tags) values(?,?,?,?,?,?,?,?)", + id, + n.title().trim(), + n.body(), + n.category(), + LibraryFields.firstTag(tags), n.star(), LibraryFields.folder(db, "notes", n.folder()), tags); + return get(id); + } + + /** + * 兼容前端笔记列表的整批保存:一次提交多条笔记,逐条走 update 的快照与合并逻辑。 + */ + public record BatchItem(@NotNull UUID id, Input note) {} + + @PutMapping("/batch") + @Transactional + public List> batchUpdate(@Valid @RequestBody @Size(max = 200) List items) { + List> saved = new ArrayList<>(); + for (BatchItem item : items) saved.add(update(item.id(), item.note())); + return saved; + } + + @PutMapping("/{id}") + @Transactional + public Map update(@PathVariable UUID id, @Valid @RequestBody Input n) { + Map current = lock(id); + // 只有真的改到别的分类时才补建分类,避免过期保存把已删除的分类重新创建出来 + if (!Objects.equals(current.get("category"), n.category())) ensureCategory(n.category()); + String tags = LibraryFields.tags(n.tags() == null + ? Objects.equals(n.tag(), current.get("tag")) ? (String) current.get("tags") : n.tag() : n.tags()); + String folder = n.folder() == null ? (String) current.get("folder") : LibraryFields.folder(db, "notes", n.folder()); + if (Objects.equals(current.get("title"), n.title().strip()) && Objects.equals(current.get("body"), n.body()) + && Objects.equals(current.get("category"), n.category()) && Objects.equals(current.get("folder"), folder) + && Objects.equals(current.get("tags"), tags) && Objects.equals(current.get("star"), n.star())) return current; + // 原型 P0-4:每次保存前自动记录快照。提交的版本已过期时不再报冲突,也不覆盖库内较新内容 + // (覆盖会把已迁移的分类、新内容回滚),本次编辑以库内最新状态为基准合并后保存。 + // 快照按「保存后的版本」编号,与 notes.version 一一对应:当前 version=N 的内容随时可通过 history/N 取回。 + long resultVersion = ((Number) current.get("version")).longValue() + 1; + if (((Number) current.get("version")).longValue() != n.version()) { + Map merged = new HashMap<>(current); + String currentTag = (String) current.get("tag"); + merged.put("title", n.title().strip()); + merged.put("body", n.body()); + // 过期保存不改动分类:分类可能已在别处迁移或删除,沿用库内最新值 + merged.put("category", current.get("category")); + if (!Objects.equals(n.tag(), currentTag)) merged.put("tags", tags); + merged.put("tag", LibraryFields.firstTag((String) merged.get("tags"))); + merged.put("folder", folder); + merged.put("star", n.star()); + snapshot(current, resultVersion); + db.update("update notes set title=?,body=?,category=?,tag=?,star=?,folder=?,tags=?,version=version+1,updated_at=now() where id=?", + merged.get("title"), merged.get("body"), merged.get("category"), merged.get("tag"), merged.get("star"), + merged.get("folder"), merged.get("tags"), id); + return get(id); + } + snapshot(current, resultVersion); + db.update("update notes set title=?,body=?,category=?,tag=?,star=?,folder=?,tags=?,version=version+1,updated_at=now() where id=?", + n.title().strip(), n.body(), n.category(), LibraryFields.firstTag(tags), n.star(), folder, tags, id); + return get(id); + } + + // Existing note API clients can still submit a category name directly. + private void ensureCategory(String name) { + db.update("insert into note_categories(name) values(?) on conflict (name) do nothing", name); + } + + /** + * 版本列表。版本号即 notes.version 的取值,语义沿用既有约定:「version=N 的这一行是第 N 版的内容」。 + * 新口径下保存前的快照以「保存后的版本号」落库,因此当前 version 这一行就是当前内容的保存前快照, + * 历史编号与笔记版本号连续、无空洞;旧口径(V18 之前写入的行)只在没有新快照占用该号时返回,历史不会被重排。 + * 唯一随口径变化的是「第 0 版」:新口径下第一次保存前的内容记在第 1 版,因此不再出现 version=0。 + */ + @GetMapping("/{id}/history") + public List> history(@PathVariable UUID id, + @RequestParam(defaultValue = "0") @Min(0) int offset) { + get(id); + // 同一版本号可能同时有旧口径行与新快照:只保留新口径行 + return db.queryForList("select h.version,h.title,h.saved_at,length(h.body) as characters from note_history h" + + " where h.note_id=? and (not h.legacy_versioning or not exists(select 1 from note_history n" + + " where n.note_id=h.note_id and n.version=h.version and not n.legacy_versioning))" + + " order by h.version desc limit 50 offset ?", id, offset); + } + + @GetMapping("/{id}/history/{version}") + public Map version(@PathVariable UUID id, @PathVariable long version) { + return contentAt(get(id), version); + } + + /** + * 取历史 version 的内容。保存前快照以「保存后的版本号」写入,因此 history/N 永远是「第 N 版保存前的内容」, + * 编号与 notes.version 连续、无空洞。旧口径(V18 之前写入的行)与新快照同号时以新快照为准。 + */ + private Map contentAt(Map note, long version) { + return db.queryForList("select title,body,category,folder,tags,star,saved_at from note_history" + + " where note_id=? and version=? order by legacy_versioning limit 1", note.get("id"), version) + .stream().findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "版本不存在")); + } + + public record Restore(@Min(0) Long currentVersion) {} + + @PostMapping("/{id}/history/{version}") + @Transactional + public Map restore(@PathVariable UUID id, @PathVariable long version, + @RequestBody(required = false) Restore input) { + var current = lock(id); + // 版本号可选:旧调用方仍传 currentVersion 做并发校验;新调用方不传,就以库内最新内容为准 + if (input != null && input.currentVersion() != null) checkVersion(current, input.currentVersion()); + // 恢复必须基于真实的历史行,不能落到「当前内容」兜底 + var old = db.queryForList("select title,body,category,folder,tags,star,saved_at from note_history" + + " where note_id=? and version=?", id, version).stream().findFirst() + .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "版本不存在")); + String category = db.queryForList("select name from note_categories where name=?", + String.class, old.get("category")).stream().findFirst().orElse((String) current.get("category")); + String tags = (String) old.get("tags"); + snapshot(current, ((Number) current.get("version")).longValue() + 1); // 原型:恢复前先把当前内容记录为快照 + db.update("update notes set title=?,body=?,category=?,folder=?,tags=?,tag=?,star=?,version=version+1,updated_at=now() where id=?", + old.get("title"), old.get("body"), category, old.get("folder"), tags, LibraryFields.firstTag(tags), old.get("star"), id); + return get(id); + } + + @GetMapping("/{id}/backlinks") + public List> backlinks(@PathVariable UUID id) { + String title = (String) get(id).get("title"); + return db.queryForList("select id,title from notes where id<>? and deleted_at is null" + + " and position(? in body)>0 order by updated_at desc", id, "[[" + title + "]]"); + } + + private Map lock(UUID id) { + return db.queryForList("select * from notes where id=? and deleted_at is null for update", id) + .stream().findFirst().orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "笔记不存在")); + } + + private void checkVersion(Map note, long version) { + if (((Number) note.get("version")).longValue() != version) + throw new ResponseStatusException(HttpStatus.CONFLICT, "笔记已在其他页面更新,请重新打开后编辑"); + } + + /** + * 以「保存后的版本号」写入快照(即本次保存的「保存前内容」)。此后该版本被再次保存或恢复时, + * 先读取 contentAt 取回内容,再写入新版本的快照,因此不会出现历史被覆盖或版本错位。 + */ + private void snapshot(Map note, long version) { + db.update("insert into note_history(note_id,version,title,body,category,folder,tags,star)" + + " values(?,?,?,?,?,?,?,?) on conflict (note_id,version) do nothing", + note.get("id"), version, WorkspaceNotifications.clip((String) note.get("title"), 120), + note.get("body"), note.get("category"), note.get("folder"), note.get("tags"), note.get("star")); + } + + @DeleteMapping("/{id}") + @ResponseStatus(HttpStatus.NO_CONTENT) + @Transactional + public void delete(@PathVariable UUID id) { + Map current = lock(id); + db.update("update notes set deleted_at=now(),version=version+1 where id=?", id); + trash.notifyTrashed("notes", (String) current.get("title")); + } +} diff --git a/backend/src/main/resources/application.yml b/backend/src/main/resources/application.yml new file mode 100644 index 0000000..6fd0bbd --- /dev/null +++ b/backend/src/main/resources/application.yml @@ -0,0 +1,28 @@ +spring: + datasource: + url: ${DB_URL:jdbc:postgresql://localhost:5432/myspace} + username: ${DB_USER:myspace} + password: ${DB_PASSWORD} + servlet: + multipart: + max-file-size: 15MB + max-request-size: 16MB +server: + address: ${SERVER_ADDRESS:127.0.0.1} + port: ${PORT:8080} + servlet: + session: + timeout: 8h + cookie: + http-only: true + same-site: strict + secure: ${COOKIE_SECURE:false} +app: + admin-username: ${ADMIN_USERNAME:admin} + admin-password: ${ADMIN_PASSWORD:} + storage: ${STORAGE_PATH:./data/assets} + ai-base-url: ${AI_BASE_URL:} + ai-api-key: ${AI_API_KEY:} + ai-chat-models: ${AI_CHAT_MODELS:} + ai-image-models: ${AI_IMAGE_MODELS:} + rss-public-dns: ${RSS_PUBLIC_DNS:https://cloudflare-dns.com/dns-query} diff --git a/backend/src/main/resources/db/migration/V10__library_workspace.sql b/backend/src/main/resources/db/migration/V10__library_workspace.sql new file mode 100644 index 0000000..b3a9354 --- /dev/null +++ b/backend/src/main/resources/db/migration/V10__library_workspace.sql @@ -0,0 +1,54 @@ +create table library_folders ( + kind varchar(10) not null check (kind in ('notes', 'assets')), + name varchar(60) not null, + primary key (kind, name) +); +insert into library_folders values ('notes','默认文件夹'), ('assets','默认文件夹'); + +alter table notes add column folder varchar(60) not null default '默认文件夹', + add column tags text not null default '', add column deleted_at timestamptz; +update notes set tags = tag; +alter table assets add column folder varchar(60) not null default '默认文件夹', + add column category varchar(60) not null default '未分类', + add column description varchar(500) not null default '', + add column tags text not null default '', add column deleted_at timestamptz; +alter table blogs add column deleted_at timestamptz, add column cover_url varchar(4096); +alter table bookmarks add column deleted_at timestamptz, + add column tags text not null default '', add column favorite boolean not null default false, + add column new_window boolean not null default true, + add column icon_mode varchar(10) not null default 'default', + add column icon_url varchar(4096), + add column sort_order bigint generated by default as identity; +update bookmarks set icon_mode='asset' where icon_asset_id is not null; + +create table note_history ( + note_id uuid not null references notes(id) on delete cascade, + version bigint not null, + title varchar(120) not null, + body text not null, + category varchar(60) not null, + folder varchar(60) not null, + tags text not null, + star boolean not null, + saved_at timestamptz not null default now(), + primary key(note_id, version) +); + +create function save_note_history() returns trigger language plpgsql as $$ +begin + if (old.title,old.body,old.category,old.folder,old.tags,old.star) + is distinct from (new.title,new.body,new.category,new.folder,new.tags,new.star) then + insert into note_history(note_id,version,title,body,category,folder,tags,star) + values (old.id,old.version,old.title,old.body,old.category,old.folder,old.tags,old.star); + end if; + return new; +end +$$; +create trigger note_history_before_update before update on notes +for each row execute function save_note_history(); + +create table asset_categories (name varchar(60) primary key); +insert into asset_categories values ('未分类'); +create table blog_categories (name varchar(60) primary key); +insert into blog_categories select distinct category from blogs; +insert into blog_categories values ('未分类') on conflict do nothing; diff --git a/backend/src/main/resources/db/migration/V11__publication_snapshots.sql b/backend/src/main/resources/db/migration/V11__publication_snapshots.sql new file mode 100644 index 0000000..496a019 --- /dev/null +++ b/backend/src/main/resources/db/migration/V11__publication_snapshots.sql @@ -0,0 +1,61 @@ +create table publication_state ( + id smallint primary key check (id = 1), + revision bigint not null default 0, + published_at timestamptz +); +insert into publication_state(id) values(1); + +create table published_blogs ( + id uuid primary key references blogs(id) on delete cascade, + slug varchar(160) not null unique, + title varchar(120) not null, + summary varchar(200) not null, + body text not null, + category varchar(60) not null, + cover_asset_id uuid references assets(id) on delete set null, + cover_url varchar(4096), + updated_at timestamptz not null, + version bigint not null +); +insert into published_blogs +select id,slug,title,summary,body,category,cover_asset_id,cover_url,updated_at,version +from blogs where status='published' and deleted_at is null; + +create table published_bookmarks ( + id uuid primary key references bookmarks(id) on delete cascade, + title varchar(60) not null, + url text not null, + description varchar(160) not null, + category varchar(60) not null, + icon_asset_id uuid references assets(id) on delete set null, + icon_mode varchar(10) not null, + icon_url varchar(4096), + new_window boolean not null, + sort_order bigint not null, + updated_at timestamptz not null +); +insert into published_bookmarks +select id,title,url,description,category,icon_asset_id,icon_mode,icon_url,new_window,sort_order,updated_at +from bookmarks where is_public and deleted_at is null; + +create function withdraw_blog_snapshot() returns trigger language plpgsql as $$ +begin + if new.status='draft' or new.deleted_at is not null then + delete from published_blogs where id=new.id; + end if; + return new; +end +$$; +create trigger withdraw_blog after update of status,deleted_at on blogs +for each row execute function withdraw_blog_snapshot(); + +create function withdraw_bookmark_snapshot() returns trigger language plpgsql as $$ +begin + if not new.is_public or new.deleted_at is not null then + delete from published_bookmarks where id=new.id; + end if; + return new; +end +$$; +create trigger withdraw_bookmark after update of is_public,deleted_at on bookmarks +for each row execute function withdraw_bookmark_snapshot(); diff --git a/backend/src/main/resources/db/migration/V12__library_inbox.sql b/backend/src/main/resources/db/migration/V12__library_inbox.sql new file mode 100644 index 0000000..95f6014 --- /dev/null +++ b/backend/src/main/resources/db/migration/V12__library_inbox.sql @@ -0,0 +1,10 @@ +create table inbox_items ( + id uuid primary key, + source_kind varchar(12) not null check (source_kind in ('bookmarks','assets')), + source_id uuid not null, + title varchar(255) not null, + content text not null, + created_at timestamptz not null default now(), + processed_at timestamptz, + unique(source_kind,source_id) +); diff --git a/backend/src/main/resources/db/migration/V13__admin_workspaces.sql b/backend/src/main/resources/db/migration/V13__admin_workspaces.sql new file mode 100644 index 0000000..bcca198 --- /dev/null +++ b/backend/src/main/resources/db/migration/V13__admin_workspaces.sql @@ -0,0 +1,53 @@ +create table planner_items ( + id uuid primary key, + kind varchar(12) not null check (kind in ('tasks','events','snippets')), + title varchar(160) not null, + body text not null default '', + category varchar(60) not null default '未分类', + tags text not null default '', + completed boolean not null default false, + priority varchar(8) not null default 'normal' check (priority in ('low','normal','high')), + starts_at timestamp, + ends_at timestamp, + language varchar(40) not null default '', + created_at timestamptz not null default now(), + updated_at timestamptz not null default now(), + deleted_at timestamptz, + check (ends_at is null or ends_at >= starts_at) +); +create index planner_kind_active on planner_items(kind, starts_at, updated_at desc) where deleted_at is null; + +create table workspace_preferences ( + id smallint primary key check (id=1), + display_name varchar(60) not null default '我的数字花园', + bio varchar(300) not null default '', + autosave boolean not null default true +); +insert into workspace_preferences(id) values(1); + +create table workspace_tags (name varchar(60) primary key); + +alter table inbox_items drop constraint inbox_items_source_kind_check; +alter table inbox_items add constraint inbox_items_source_kind_check + check (source_kind in ('bookmarks','assets','manual','rss')); +alter table inbox_items add column target_kind varchar(12), add column target_id uuid; + +create table workspace_notifications ( + id bigint generated always as identity primary key, + title varchar(160) not null, + created_at timestamptz not null default now(), + read_at timestamptz +); +create table workspace_flows ( + id uuid primary key, + title varchar(60) not null, + instructions text not null, + updated_at timestamptz not null default now() +); +create table workspace_flow_runs ( + id uuid primary key, + flow_id uuid references workspace_flows(id) on delete set null, + title varchar(60) not null, + result text not null, + created_at timestamptz not null default now() +); diff --git a/backend/src/main/resources/db/migration/V14__rss_reader.sql b/backend/src/main/resources/db/migration/V14__rss_reader.sql new file mode 100644 index 0000000..bb14873 --- /dev/null +++ b/backend/src/main/resources/db/migration/V14__rss_reader.sql @@ -0,0 +1,24 @@ +create table rss_sources ( + id uuid primary key, + title varchar(100) not null, + url varchar(4096) not null, + category varchar(60) not null, + last_attempt_at timestamptz, + last_success_at timestamptz, + error varchar(300), + deleted_at timestamptz +); +create unique index rss_source_active_url on rss_sources(url) where deleted_at is null; +create table rss_articles ( + id uuid primary key, + source_id uuid not null references rss_sources(id), + external_key varchar(64) not null, + title varchar(255) not null, + url varchar(4096), + body text not null, + published_at timestamptz, + fetched_at timestamptz not null default now(), + read_at timestamptz, + starred boolean not null default false, + unique(source_id,external_key) +); diff --git a/backend/src/main/resources/db/migration/V15__ai_studio.sql b/backend/src/main/resources/db/migration/V15__ai_studio.sql new file mode 100644 index 0000000..623d8d0 --- /dev/null +++ b/backend/src/main/resources/db/migration/V15__ai_studio.sql @@ -0,0 +1,35 @@ +create table ai_prompts ( + id uuid primary key, + title varchar(120) not null, + body text not null, + category varchar(60) not null, + favorite boolean not null default false, + updated_at timestamptz not null default now() +); +create table ai_runs ( + id uuid primary key, + session_id uuid not null, + mode varchar(8) not null check(mode in ('chat','image')), + model varchar(150) not null, + prompt text not null, + response text, + note_id uuid references notes(id) on delete set null, + asset_id uuid references assets(id) on delete set null, + favorite boolean not null default false, + tokens integer, + created_at timestamptz not null default now() +); +create index ai_runs_session on ai_runs(session_id,created_at,id); +create table ai_events ( + id bigint generated always as identity primary key, + mode varchar(8) not null, + model varchar(150) not null, + status varchar(30) not null, + created_at timestamptz not null default now() +); +create table ai_preferences ( + mode varchar(8) primary key check(mode in ('chat','image')), + model varchar(150) +); +insert into ai_preferences values('chat',null),('image',null); +create table ai_disabled_models (mode varchar(8) not null, model varchar(150) not null, primary key(mode,model)); diff --git a/backend/src/main/resources/db/migration/V16__public_studio_library.sql b/backend/src/main/resources/db/migration/V16__public_studio_library.sql new file mode 100644 index 0000000..7c6e272 --- /dev/null +++ b/backend/src/main/resources/db/migration/V16__public_studio_library.sql @@ -0,0 +1,21 @@ +create table published_ai_prompts ( + id uuid primary key references ai_prompts(id) on delete cascade, + title varchar(120) not null, + body text not null, + category varchar(60) not null +); +create table published_ai_images ( + id uuid primary key references ai_runs(id) on delete cascade, + asset_id uuid not null references assets(id) on delete cascade, + title varchar(255) not null +); +create function withdraw_studio_image() returns trigger language plpgsql as $$ +begin + if new.deleted_at is not null then + delete from published_ai_images where asset_id=new.id; + end if; + return new; +end +$$; +create trigger withdraw_studio_image after update of deleted_at on assets +for each row execute function withdraw_studio_image(); diff --git a/backend/src/main/resources/db/migration/V17__unified_trash.sql b/backend/src/main/resources/db/migration/V17__unified_trash.sql new file mode 100644 index 0000000..15a64df --- /dev/null +++ b/backend/src/main/resources/db/migration/V17__unified_trash.sql @@ -0,0 +1,20 @@ +-- 统一回收站:为每张可删除表补齐 deleted_at,使库内单一回收站可恢复任一模块的删除。 +-- 原型的「版本历史」语义是:每次保存前记录一份快照(含版本已过期的保存)。 +-- 旧实现由触发器在 UPDATE 时插入,与业务中的补救快照互相冲突,统一改为业务层显式写入。 +drop trigger if exists note_history_before_update on notes; +drop function if exists save_note_history(); + +-- 顺手补齐几个联动所需的索引(不改变既有表结构语义)。 + +-- 可重复执行:旧版本迁移只建了唯一索引、不建 deleted_at,原脚本在此处失败过(column already exists) +alter table rss_sources add column if not exists deleted_at timestamptz; +alter table rss_articles add column if not exists deleted_at timestamptz; +alter table ai_prompts add column if not exists deleted_at timestamptz; +alter table workspace_flows add column if not exists deleted_at timestamptz; +alter table inbox_items add column if not exists deleted_at timestamptz; + +-- 分类表已以 name 作主键/唯一键,恢复时"补回分类"用 insert on conflict do nothing 即可。 +-- 原脚本为四张分类表 add column id identity:对已有主键的表会重复建主键而失败,且无人使用,故移除。 + +create index if not exists rss_articles_source on rss_articles(source_id, deleted_at); +create index if not exists published_bookmarks_sort on published_bookmarks(sort_order, id); diff --git a/backend/src/main/resources/db/migration/V18__note_history_version_alignment.sql b/backend/src/main/resources/db/migration/V18__note_history_version_alignment.sql new file mode 100644 index 0000000..1bf0f22 --- /dev/null +++ b/backend/src/main/resources/db/migration/V18__note_history_version_alignment.sql @@ -0,0 +1,10 @@ +-- 版本历史与 notes.version 对齐。 +-- 旧口径:note_history.version 存的是「来源版本」(保存前笔记的版本号), +-- 因此有 N 条历史的笔记,历史里缺了「与当前 version 对应的那一版」,回退永远差一位。 +-- 新口径:note_history.version 存「本次保存后的版本号」,notes.version 这一版的内容总能在历史里取到。 +-- +-- 旧数据无法整体平移(平移后与当前版本同号,会撞主键),所以用一列标记写入口径: +-- 迁移前已存在的行置为 true,业务层按旧口径解析(version=N 即「保存前的 N 版」);新写入的行默认 false。 +alter table note_history add column if not exists legacy_versioning boolean not null default false; +-- 只标记迁移前已存在的行;本脚本只执行一次,不会误标后续新写入的快照 +update note_history set legacy_versioning = true where not legacy_versioning; diff --git a/backend/src/main/resources/db/migration/V1__initial.sql b/backend/src/main/resources/db/migration/V1__initial.sql new file mode 100644 index 0000000..2937456 --- /dev/null +++ b/backend/src/main/resources/db/migration/V1__initial.sql @@ -0,0 +1,5 @@ +CREATE TABLE app_user (id smallint PRIMARY KEY CHECK (id = 1), username varchar(80) UNIQUE NOT NULL, password_hash varchar(100) NOT NULL); +CREATE TABLE notes (id uuid PRIMARY KEY, title varchar(120) NOT NULL, body text NOT NULL DEFAULT '', category varchar(60) NOT NULL, tag varchar(60) NOT NULL DEFAULT '', star boolean NOT NULL DEFAULT false, version bigint NOT NULL DEFAULT 0, created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now()); +CREATE INDEX notes_updated_idx ON notes(updated_at DESC); +CREATE TABLE assets (id uuid PRIMARY KEY, name varchar(255) NOT NULL, media_type varchar(100) NOT NULL, size bigint NOT NULL CHECK(size >= 0), created_at timestamptz NOT NULL DEFAULT now()); +CREATE INDEX assets_created_idx ON assets(created_at DESC); diff --git a/backend/src/main/resources/db/migration/V2__blogs.sql b/backend/src/main/resources/db/migration/V2__blogs.sql new file mode 100644 index 0000000..45d2fa8 --- /dev/null +++ b/backend/src/main/resources/db/migration/V2__blogs.sql @@ -0,0 +1,3 @@ +CREATE TABLE blogs (id uuid PRIMARY KEY, title varchar(120) NOT NULL, summary varchar(200) NOT NULL DEFAULT '', body text NOT NULL DEFAULT '', status varchar(10) NOT NULL DEFAULT 'draft' CHECK (status IN ('draft','published')), version bigint NOT NULL DEFAULT 0, created_at timestamptz NOT NULL DEFAULT now(), updated_at timestamptz NOT NULL DEFAULT now()); +CREATE INDEX blogs_updated_idx ON blogs(updated_at DESC); +CREATE INDEX blogs_status_updated_idx ON blogs(status, updated_at DESC); diff --git a/backend/src/main/resources/db/migration/V3__public_blogs.sql b/backend/src/main/resources/db/migration/V3__public_blogs.sql new file mode 100644 index 0000000..214d7f3 --- /dev/null +++ b/backend/src/main/resources/db/migration/V3__public_blogs.sql @@ -0,0 +1,11 @@ +-- 公开博客:每篇文章一个可读的 URL 片段,仅「已发布」文章对外可见 +ALTER TABLE blogs ADD COLUMN slug varchar(160); +-- 回填历史文章:中文标题没有 ASCII 可用字符时用 article +UPDATE blogs SET slug = + COALESCE(NULLIF(trim(both '-' from regexp_replace(lower(title), '[^a-z0-9]+', '-', 'g')), ''), 'article') + || '-' || substr(replace(id::text, '-', ''), 1, 6); +UPDATE blogs SET slug = slug || '-' || substr(md5(id::text), 1, 4) + WHERE slug IN (SELECT slug FROM blogs GROUP BY slug HAVING count(*) > 1); +ALTER TABLE blogs ALTER COLUMN slug SET NOT NULL; +CREATE UNIQUE INDEX blogs_slug_uq ON blogs(slug); +CREATE INDEX blogs_published_slug_idx ON blogs(slug) WHERE status = 'published'; diff --git a/backend/src/main/resources/db/migration/V4__blog_cover.sql b/backend/src/main/resources/db/migration/V4__blog_cover.sql new file mode 100644 index 0000000..a1b43c9 --- /dev/null +++ b/backend/src/main/resources/db/migration/V4__blog_cover.sql @@ -0,0 +1,2 @@ +ALTER TABLE blogs ADD COLUMN cover_asset_id uuid REFERENCES assets(id) ON DELETE SET NULL; +CREATE INDEX blogs_cover_asset_idx ON blogs(cover_asset_id) WHERE cover_asset_id IS NOT NULL; diff --git a/backend/src/main/resources/db/migration/V5__bookmarks.sql b/backend/src/main/resources/db/migration/V5__bookmarks.sql new file mode 100644 index 0000000..b48922e --- /dev/null +++ b/backend/src/main/resources/db/migration/V5__bookmarks.sql @@ -0,0 +1,10 @@ +CREATE TABLE bookmarks ( + id uuid PRIMARY KEY, + title varchar(60) NOT NULL, + url text NOT NULL, + description varchar(160) NOT NULL DEFAULT '', + category varchar(60) NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX bookmarks_updated_idx ON bookmarks(updated_at DESC); diff --git a/backend/src/main/resources/db/migration/V6__bookmark_icon.sql b/backend/src/main/resources/db/migration/V6__bookmark_icon.sql new file mode 100644 index 0000000..bbb1590 --- /dev/null +++ b/backend/src/main/resources/db/migration/V6__bookmark_icon.sql @@ -0,0 +1,2 @@ +ALTER TABLE bookmarks ADD COLUMN icon_asset_id uuid REFERENCES assets(id) ON DELETE SET NULL; +CREATE INDEX bookmarks_icon_asset_idx ON bookmarks(icon_asset_id) WHERE icon_asset_id IS NOT NULL; diff --git a/backend/src/main/resources/db/migration/V7__note_categories.sql b/backend/src/main/resources/db/migration/V7__note_categories.sql new file mode 100644 index 0000000..3575f69 --- /dev/null +++ b/backend/src/main/resources/db/migration/V7__note_categories.sql @@ -0,0 +1,13 @@ +CREATE TABLE note_categories ( + id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, + name varchar(60) NOT NULL UNIQUE +); + +INSERT INTO note_categories(name) VALUES ('技术笔记'), ('设计灵感'), ('个人成长'); + +INSERT INTO note_categories(name) +SELECT DISTINCT category FROM notes ORDER BY category +ON CONFLICT (name) DO NOTHING; + +ALTER TABLE notes ADD CONSTRAINT notes_category_fk + FOREIGN KEY (category) REFERENCES note_categories(name); diff --git a/backend/src/main/resources/db/migration/V8__bookmark_categories.sql b/backend/src/main/resources/db/migration/V8__bookmark_categories.sql new file mode 100644 index 0000000..dfc5fee --- /dev/null +++ b/backend/src/main/resources/db/migration/V8__bookmark_categories.sql @@ -0,0 +1,8 @@ +CREATE TABLE bookmark_categories ( + name varchar(60) PRIMARY KEY, + created_at timestamptz NOT NULL DEFAULT now() +); +INSERT INTO bookmark_categories(name) VALUES ('设计工具'), ('开发资源'), ('灵感收藏'); +INSERT INTO bookmark_categories(name) + SELECT DISTINCT category FROM bookmarks + ON CONFLICT DO NOTHING; diff --git a/backend/src/main/resources/db/migration/V9__v4_public_navigation.sql b/backend/src/main/resources/db/migration/V9__v4_public_navigation.sql new file mode 100644 index 0000000..73ca580 --- /dev/null +++ b/backend/src/main/resources/db/migration/V9__v4_public_navigation.sql @@ -0,0 +1,2 @@ +alter table bookmarks add column is_public boolean not null default false; +alter table blogs add column category varchar(60) not null default '未分类'; diff --git a/backend/src/test/java/com/myspace/ApiIntegrationTest.java b/backend/src/test/java/com/myspace/ApiIntegrationTest.java new file mode 100644 index 0000000..a402841 --- /dev/null +++ b/backend/src/test/java/com/myspace/ApiIntegrationTest.java @@ -0,0 +1,901 @@ +package com.myspace; + +import static org.junit.jupiter.api.Assertions.*; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.csrf; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +import com.fasterxml.jackson.databind.ObjectMapper; +import java.util.Base64; +import java.util.List; +import java.util.Map; +import org.junit.jupiter.api.*; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.mock.web.MockHttpSession; +import org.springframework.mock.web.MockMultipartFile; +import org.springframework.test.web.servlet.MockMvc; + +@SpringBootTest( + properties = { + "spring.datasource.url=${TEST_DB_URL:jdbc:postgresql://localhost:55432/myspace_test}", + "spring.datasource.username=${TEST_DB_USER:myspace}", + "spring.datasource.password=${TEST_DB_PASSWORD:}", + "app.admin-password=integration-test-password", + "app.storage=target/test-assets" + }) +@AutoConfigureMockMvc +class ApiIntegrationTest { + @Autowired MockMvc mvc; + @Autowired ObjectMapper json; + @Autowired JdbcTemplate db; + + @BeforeEach + void clean() { + db.update("delete from inbox_items"); + db.update("delete from planner_items"); + db.update("delete from workspace_tags"); + db.update("delete from workspace_flows"); + db.update("delete from notes"); + db.update("delete from assets"); + db.update("delete from blogs"); + db.update("delete from bookmarks"); + db.update("delete from bookmark_categories where name not in ('设计工具','开发资源','灵感收藏')"); + db.update("delete from note_categories where name not in ('技术笔记','设计灵感','个人成长')"); + } + + MockHttpSession login() throws Exception { + return (MockHttpSession) + mvc.perform( + post("/api/v1/auth/login") + .with(csrf()) + .param("username", "admin") + .param("password", "integration-test-password")) + .andExpect(status().isOk()) + .andReturn() + .getRequest() + .getSession(); + } + + void syncPublication(MockHttpSession session, String... ids) throws Exception { + long revision = db.queryForObject("select revision from publication_state where id=1", Long.class); + mvc.perform(post("/api/v1/publication").session(session).with(csrf()) + .contentType("application/json") + .content(json.writeValueAsBytes(Map.of("revision", revision, "bookmarks", List.of(ids))))) + .andExpect(status().isOk()); + } + + @Test + void authenticationAndCsrf() throws Exception { + mvc.perform(get("/api/v1/notes")).andExpect(status().isUnauthorized()); + mvc.perform( + post("/api/v1/auth/login") + .param("username", "admin") + .param("password", "integration-test-password")) + .andExpect(status().isForbidden()); + mvc.perform( + post("/api/v1/auth/login") + .with(csrf()) + .param("username", "admin") + .param("password", "wrong")) + .andExpect(status().isUnauthorized()); + var session = login(); + mvc.perform(get("/api/v1/auth/me").session(session)) + .andExpect(jsonPath("$.username").value("admin")); + mvc.perform(post("/api/v1/auth/logout").session(session).with(csrf())) + .andExpect(status().isNoContent()); + assertTrue( + db.queryForObject("select password_hash from app_user", String.class).startsWith("$2")); + } + + @Test + void customNoteCategoryPersistsWithoutNotesAndSupportsFiltering() throws Exception { + String name = "读书笔记-" + java.util.UUID.randomUUID(); + var session = login(); + String categories = "/api/v1/notes/categories"; + byte[] payload = json.writeValueAsBytes(Map.of("name", " " + name + " ")); + mvc.perform(get(categories)).andExpect(status().isUnauthorized()); + mvc.perform(post(categories).session(session).contentType("application/json").content(payload)) + .andExpect(status().isForbidden()); + mvc.perform(post(categories).session(session).with(csrf()) + .contentType("application/json").content(payload)) + .andExpect(status().isCreated()).andExpect(jsonPath("$.name").value(name)); + mvc.perform(post(categories).session(session).with(csrf()) + .contentType("application/json").content(payload)) + .andExpect(status().isConflict()); + byte[] note = json.writeValueAsBytes(Map.of("title", "分类测试", "body", "", "category", name, "tag", "")); + var response = mvc.perform(post("/api/v1/notes").session(session).with(csrf()) + .contentType("application/json").content(note)) + .andExpect(status().isCreated()).andReturn().getResponse(); + String id = json.readTree(response.getContentAsByteArray()).get("id").asText(); + mvc.perform(get("/api/v1/notes").session(session).param("category", name)) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(delete("/api/v1/notes/" + id).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get(categories).session(login())) + .andExpect(jsonPath("$", org.hamcrest.Matchers.hasItem(name))); + } + + @Test + void categoryDeletionMovesNotesOrRejectsUnsafeDeletion() throws Exception { + var session = login(); + String path = "/api/v1/notes/categories"; + String name = "待删除-" + java.util.UUID.randomUUID(); + String empty = "空分类-" + java.util.UUID.randomUUID(); + for (String category : new String[]{name, empty}) { + mvc.perform(post(path).session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("name", category)))) + .andExpect(status().isCreated()); + } + byte[] original = json.writeValueAsBytes(Map.of( + "title", "分类迁移测试", "body", "保留正文", "category", name, "tag", "", "version", 0)); + var note = mvc.perform(post("/api/v1/notes").session(session).with(csrf()) + .contentType("application/json").content(original)) + .andExpect(status().isCreated()).andReturn().getResponse(); + String noteUrl = "/api/v1/notes/" + json.readTree(note.getContentAsByteArray()).get("id").asText(); + mvc.perform(get(path + "/usage").session(session)) + .andExpect(jsonPath("$[?(@.name == '%s')].noteCount".formatted(name)) + .value(org.hamcrest.Matchers.hasItem(1))); + mvc.perform(delete(path).session(session).param("name", name)) + .andExpect(status().isForbidden()); + mvc.perform(delete(path).session(session).with(csrf()).param("name", name)) + .andExpect(status().isConflict()); + mvc.perform(delete(path).session(session).with(csrf()).param("name", name).param("replacement", name)) + .andExpect(status().isBadRequest()); + mvc.perform(delete(path).session(session).with(csrf()).param("name", name).param("replacement", "设计灵感")) + .andExpect(status().isNoContent()); + mvc.perform(delete(path).session(session).with(csrf()).param("name", empty)) + .andExpect(status().isNoContent()); + mvc.perform(get(noteUrl).session(session)) + .andExpect(jsonPath("$.body").value("保留正文")) + .andExpect(jsonPath("$.category").value("设计灵感")) + .andExpect(jsonPath("$.version").value(1)); + // 分类迁移后原页面持有的版本已过期:保存不再直接报冲突,也不把笔记改回已删除的旧分类。 + // 前端已改为整批保存接口,这里保持旧接口单条提交的行为一致。 + var stale = new java.util.HashMap(Map.of( + "title", "分类迁移测试", "body", "改稿", "category", "设计灵感", "tag", "", "version", 1)); + mvc.perform(put(noteUrl).session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(stale))) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.version").value(2)) + .andExpect(jsonPath("$.category").value("设计灵感")); + // 保存前的内容进入版本历史;历史里的分类是迁移后的值,不会把旧分类带回来。 + // 快照以「保存后的版本号」写入,因此 history/{当前 version} 恒为当前内容的保存前快照 + mvc.perform(get(noteUrl).session(session)) + .andExpect(jsonPath("$.version").value(2)); + mvc.perform(get(noteUrl + "/history/1").session(session)) + .andExpect(jsonPath("$.category").value("设计灵感")) + .andExpect(jsonPath("$.body").value("保留正文")); + // 原分类下的快照随笔记一起迁入新分类(可回溯),因此第 2 版同样可查 + mvc.perform(get(noteUrl + "/history/2").session(session)) + .andExpect(jsonPath("$.category").value("设计灵感")); + mvc.perform(get(noteUrl).session(session)).andExpect(jsonPath("$.body").value("改稿")); + // 分类删除在同一事务内完成迁移与删除,不因快照写入失败而回滚(回归防护) + mvc.perform(get(path).session(session)) + .andExpect(jsonPath("$[?(@=='%s')]".formatted(name)).isEmpty()) + .andExpect(jsonPath("$[?(@=='%s')]".formatted(empty)).isEmpty()); + } + + @Test + void noteLifecycleAndConflict() throws Exception { + var session = login(); + String body = + "{\"title\":\"测试笔记\",\"body\":\"#" + + " hello\",\"category\":\"技术笔记\",\"tag\":\"开发\",\"star\":true,\"version\":0}"; + mvc.perform( + post("/api/v1/notes").session(session).contentType("application/json").content(body)) + .andExpect(status().isForbidden()); + String result = + mvc.perform( + post("/api/v1/notes") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body)) + .andExpect(status().isCreated()) + .andReturn() + .getResponse() + .getContentAsString(); + String id = json.readTree(result).get("id").asText(); + mvc.perform(get("/api/v1/notes").session(session).param("q", "hello").param("starred", "true")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform( + put("/api/v1/notes/" + id) + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body.replace("hello", "updated"))) + .andExpect(jsonPath("$.version").value(1)); + // 原型 P0-4:以过期版本保存时,先为库内较新的内容记录快照,再保存本次编辑(不再直接拒绝) + mvc.perform( + put("/api/v1/notes/" + id) + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.version").value(2)); + mvc.perform(get("/api/v1/notes/" + id + "/history/2").session(session)) + .andExpect(jsonPath("$.body").value("# updated")); + mvc.perform(get("/api/v1/dashboard").session(session)) + .andExpect(jsonPath("$.notes").value(1)) + .andExpect(jsonPath("$.starred").value(1)); + mvc.perform( + post("/api/v1/notes") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body.replace("测试笔记", " "))) + .andExpect(status().isBadRequest()); + mvc.perform(delete("/api/v1/notes/" + id).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/notes/" + id).session(session)).andExpect(status().isNotFound()); + } + + @Test + void bookmarkLifecycleSearchAndUrlValidation() throws Exception { + var session = login(); + String body = "{\"title\":\"Figma\",\"url\":\"https://www.figma.com/community\",\"description\":\"设计资源\",\"category\":\"设计工具\"}"; + mvc.perform(post("/api/v1/bookmarks").session(session).contentType("application/json").content(body)).andExpect(status().isForbidden()); + String result = mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()).contentType("application/json").content(body)) + .andExpect(status().isCreated()).andExpect(jsonPath("$.url").value("https://www.figma.com/community")) + .andReturn().getResponse().getContentAsString(); + String id = json.readTree(result).get("id").asText(); + mvc.perform(get("/api/v1/bookmarks").session(session).param("q", "figma").param("category", "设计工具")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()).contentType("application/json") + .content(body.replace("https://www.figma.com/community", "javascript:alert(1)"))).andExpect(status().isBadRequest()); + mvc.perform(delete("/api/v1/bookmarks/" + id).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/bookmarks/" + id).session(session)).andExpect(status().isNotFound()); + } + + @Test + void bookmarkCategoriesCanBeAddedAndDeletedWhenUnused() throws Exception { + var session = login(); + mvc.perform(post("/api/v1/bookmark-categories").session(session).with(csrf()) + .contentType("application/json").content("{\"name\":\"学习资料\"}")) + .andExpect(status().isCreated()).andExpect(jsonPath("$.name").value("学习资料")); + mvc.perform(get("/api/v1/bookmark-categories").session(session)) + .andExpect(jsonPath("$[?(@.name == '学习资料')]").isNotEmpty()); + mvc.perform(delete("/api/v1/bookmark-categories/学习资料") + .session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()).contentType("application/json") + .content("{\"title\":\"MDN\",\"url\":\"https://developer.mozilla.org\",\"description\":\"d\",\"category\":\"开发资源\"}")) + .andExpect(status().isCreated()); + mvc.perform(delete("/api/v1/bookmark-categories/开发资源") + .session(session).with(csrf())) + .andExpect(status().isConflict()); + } + + @Test + void publicBookmarksAreAnonymousAndExposeOnlyDisplayFields() throws Exception { + var session = login(); + byte[] png = Base64.getDecoder().decode( + "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="); + String icon = uploadAsset(session, "bookmark-icon.png", png); + var payload = new java.util.HashMap<>(Map.of("title", "MDN", "url", "https://developer.mozilla.org", + "description", "Web 文档", "category", "开发资源", "icon_asset_id", icon)); + var created = mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(payload))) + .andExpect(status().isCreated()).andExpect(jsonPath("$.is_public").value(false)) + .andReturn(); + String id = json.readTree(created.getResponse().getContentAsByteArray()).get("id").asText(); + mvc.perform(get("/api/v1/public/bookmarks")) + .andExpect(status().isOk()).andExpect(jsonPath("$.length()").value(0)); + mvc.perform(get("/api/v1/public/bookmarks/images/" + icon)).andExpect(status().isNotFound()); + + var update = new java.util.HashMap(payload); + update.put("is_public", true); + mvc.perform(put("/api/v1/bookmarks/" + id).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(update))) + .andExpect(status().isOk()).andExpect(jsonPath("$.id").value(id)); + mvc.perform(get("/api/v1/public/bookmarks")) + .andExpect(status().isOk()).andExpect(jsonPath("$.length()").value(0)); + syncPublication(session, id); + mvc.perform(get("/api/v1/public/bookmarks")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$[0].title").value("MDN")) + .andExpect(jsonPath("$[0].url").value("https://developer.mozilla.org")) + .andExpect(jsonPath("$[0].icon_asset_id").value(icon)) + .andExpect(jsonPath("$[0].id").doesNotExist()) + .andExpect(header().exists("ETag")); + mvc.perform(get("/api/v1/public/bookmarks/images/" + icon)) + .andExpect(status().isOk()).andExpect(content().bytes(png)); + update.put("is_public", false); + update.put("title", "MDN 文档"); + mvc.perform(put("/api/v1/bookmarks/" + id).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(update))) + .andExpect(status().isOk()).andExpect(jsonPath("$.title").value("MDN 文档")); + mvc.perform(get("/api/v1/public/bookmarks/images/" + icon)).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/public/bookmarks")) + .andExpect(status().isOk()).andExpect(jsonPath("$.length()").value(0)); + + } + + @Test + void blogLifecycleStatusAndConflict() throws Exception { + var session = login(); + String body = + "{\"title\":\"第一篇\",\"summary\":\"摘要\",\"body\":\"# 本地草稿\",\"status\":\"draft\"," + + "\"version\":0}"; + mvc.perform( + post("/api/v1/blogs") + .session(session) + .contentType("application/json") + .content(body)) + .andExpect(status().isForbidden()); + String result = + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body)) + .andExpect(status().isCreated()) + .andExpect(jsonPath("$.status").value("draft")) + .andExpect(jsonPath("$.version").value(0)) + .andExpect(jsonPath("$.created_at").exists()) + .andExpect(jsonPath("$.slug").exists()) + .andExpect(jsonPath("$.updated_at").exists()) + .andReturn() + .getResponse() + .getContentAsString(); + String id = json.readTree(result).get("id").asText(); + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body.replace("第一篇", "第二篇"))) + .andExpect(status().isCreated()); + // 新建默认草稿筛选包含两篇,已发布为空 + mvc.perform(get("/api/v1/blogs").session(session).param("status", "draft")) + .andExpect(jsonPath("$.length()").value(2)); + mvc.perform(get("/api/v1/blogs").session(session).param("status", "published")) + .andExpect(jsonPath("$.length()").value(0)); + String published = + body.replace("\"draft\"", "\"published\"").replace("本地草稿", "已发布正文"); + mvc.perform( + put("/api/v1/blogs/" + id) + .session(session) + .with(csrf()) + .contentType("application/json") + .content(published)) + .andExpect(jsonPath("$.status").value("published")) + .andExpect(jsonPath("$.version").value(1)); + mvc.perform(get("/api/v1/blogs").session(session).param("status", "published")) + .andExpect(jsonPath("$.length()").value(1)) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(get("/api/v1/blogs").session(session).param("status", "draft")) + .andExpect(jsonPath("$.length()").value(1)) + .andExpect(jsonPath("$[0].id").value(org.hamcrest.Matchers.not(id))); + mvc.perform(get("/api/v1/blogs").session(session).param("q", "已发布")) + .andExpect(jsonPath("$[0].id").value(id)); + // 版本过期 → 409;非法状态 → 400;重复发布(用旧版本)也冲突 + mvc.perform( + put("/api/v1/blogs/" + id) + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body)) + .andExpect(status().isConflict()); + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body.replace("\"draft\"", "\"公开\""))) + .andExpect(status().isBadRequest()); + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content(body.replace("第一篇", " "))) + .andExpect(status().isBadRequest()); + mvc.perform(get("/api/v1/blogs").session(session).param("status", "bogus")) + .andExpect(status().isBadRequest()); + // 删除后草稿筛选只剩一篇,已发布 404 + mvc.perform(delete("/api/v1/blogs/" + id).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/blogs/" + id).session(session)).andExpect(status().isNotFound()); + mvc.perform(delete("/api/v1/blogs/" + id).session(session).with(csrf())) + .andExpect(status().isNotFound()); + } + + @Test + void publicBlogOnlyExposesPublishedAndIgnoresSession() throws Exception { + var session = login(); + String draft = + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content( + "{\"title\":\"Hidden Draft\",\"summary\":\"s\",\"body\":\"secret body\"," + + "\"status\":\"draft\",\"version\":0}")) + .andExpect(status().isCreated()) + .andExpect(jsonPath("$.slug").value(org.hamcrest.Matchers.matchesPattern("hidden-draft-[0-9a-f]{6}"))) + .andReturn() + .getResponse() + .getContentAsString(); + String draftSlug = json.readTree(draft).get("slug").asText(); + String published = + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content("{\"title\":\"公开的文章\",\"summary\":\"s\",\"body\":\"# Hello\"," + + "\"status\":\"published\",\"version\":0}")) + .andReturn() + .getResponse() + .getContentAsString(); + String slug = json.readTree(published).get("slug").asText(); + assertTrue(slug.matches("article-[0-9a-f]{6}"), "中文标题回退到 article: " + slug); + var numeric = + json.readTree( + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content("{\"title\":\"2026 2026\",\"summary\":\"\",\"body\":\"\"," + + "\"status\":\"draft\",\"version\":0}")) + .andReturn() + .getResponse() + .getContentAsString()); + assertTrue(numeric.get("slug").asText().startsWith("article-"), "纯数字标题: " + numeric.get("slug")); + // 同名文章不产生重复链接 + var other = + mvc.perform( + post("/api/v1/blogs") + .session(session) + .with(csrf()) + .contentType("application/json") + .content("{\"title\":\"公开的文章\",\"summary\":\"\",\"body\":\"\"," + + "\"status\":\"draft\",\"version\":0}")) + .andReturn() + .getResponse() + .getContentAsString(); + assertNotEquals(slug, json.readTree(other).get("slug").asText()); + + mvc.perform(get("/api/v1/public/blogs/" + slug)).andExpect(status().isNotFound()); + syncPublication(session); + mvc.perform(get("/api/v1/public/blogs/rss.xml")) + .andExpect(status().isOk()) + .andExpect(content().contentTypeCompatibleWith("application/rss+xml")) + .andExpect(xpath("/rss/channel/item/title").string("公开的文章")) + .andExpect(xpath("/rss/channel/item/link").string("http://localhost/blog/" + slug)) + .andExpect(xpath("count(/rss/channel/item)").number(1.0)); + // 匿名可读,只含已同步的文章,不返回版本号 + mvc.perform(get("/api/v1/public/blogs")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.length()").value(1)) + .andExpect(jsonPath("$[0].slug").value(slug)) + .andExpect(jsonPath("$[0].version").doesNotExist()) + .andExpect(jsonPath("$[0].body").doesNotExist()); + mvc.perform(get("/api/v1/public/blogs/categories")) + .andExpect(status().isOk()).andExpect(jsonPath("$[0]").value("未分类")); + mvc.perform(get("/api/v1/public/blogs").param("q", "Hello").param("category", "未分类")) + .andExpect(status().isOk()).andExpect(jsonPath("$.length()").value(1)); + mvc.perform(get("/api/v1/public/blogs").param("q", "Hello").param("category", "其他")) + .andExpect(status().isOk()).andExpect(jsonPath("$.length()").value(0)); + mvc.perform(get("/api/v1/public/blogs/" + slug)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.body").value("# Hello")) + .andExpect(jsonPath("$.version").doesNotExist()); + // ETag:内容未变时条件请求返回 304,轮询不重复下载正文 + String tag = + mvc.perform(get("/api/v1/public/blogs/" + slug)) + .andReturn() + .getResponse() + .getHeader("ETag"); + assertNotNull(tag); + mvc.perform(get("/api/v1/public/blogs/" + slug).header("If-None-Match", tag)) + .andExpect(status().isNotModified()); + String listTag = + mvc.perform(get("/api/v1/public/blogs")).andReturn().getResponse().getHeader("ETag"); + mvc.perform(get("/api/v1/public/blogs").header("If-None-Match", listTag)) + .andExpect(status().isNotModified()); + mvc.perform(get("/api/v1/public/blogs/" + draftSlug)).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/public/blogs/not-found-x")).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/public/blogs/UPPER")).andExpect(status().isNotFound()); + // 带登录会话访问同样可用,但不因此暴露草稿 + mvc.perform(get("/api/v1/public/blogs/" + draftSlug).session(session)) + .andExpect(status().isNotFound()); + // 管理接口仍要求登录 + mvc.perform(get("/api/v1/blogs/" + draftSlug.replace("hidden-draft", "x"))) + .andExpect(status().isUnauthorized()); + // 管理列表不再返回正文,详情返回 + // 管理列表包含正文(页内/全局搜索按正文匹配)与 slug + mvc.perform(get("/api/v1/blogs").session(session)) + .andExpect(jsonPath("$[*].body").exists()) + .andExpect(jsonPath("$[*].slug").exists()); + String id = json.readTree(published).get("id").asText(); + mvc.perform(get("/api/v1/blogs/" + id).session(session)).andExpect(jsonPath("$.body").value("# Hello")); + } + + @Test + void blogImagesArePublicOnlyWhenReferencedByAPublishedPost() throws Exception { + var session = login(); + byte[] png = Base64.getDecoder().decode( + "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII="); + String cover = uploadAsset(session, "cover.png", png); + String inline = uploadAsset(session, "inline.png", png); + String other = uploadAsset(session, "other.png", png); + String file = uploadAsset(session, "notes.txt", new byte[]{1}); + String body = "![inline](/api/v1/assets/" + inline + "/content)\n\n" + + "[link only](/api/v1/assets/" + other + "/content)"; + var input = new java.util.HashMap(Map.of( + "title", "Images", "summary", "Images in a blog post", "body", body, + "status", "draft", "version", 0, "cover_asset_id", file)); + mvc.perform(post("/api/v1/blogs").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isBadRequest()); + input.put("cover_asset_id", cover); + var draft = json.readTree(mvc.perform(post("/api/v1/blogs").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isCreated()).andExpect(jsonPath("$.cover_asset_id").value(cover)) + .andReturn().getResponse().getContentAsString()); + String editUrl = "/api/v1/blogs/" + draft.get("id").asText(); + String publicUrl = "/api/v1/public/blogs/" + draft.get("slug").asText(); + mvc.perform(get(publicUrl + "/images/" + cover)).andExpect(status().isNotFound()); + mvc.perform(get(publicUrl + "/images/" + inline)).andExpect(status().isNotFound()); + input.put("status", "published"); + mvc.perform(put(editUrl).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isOk()); + syncPublication(session); + mvc.perform(get(publicUrl)).andExpect(jsonPath("$.cover_asset_id").value(cover)); + mvc.perform(get("/api/v1/public/blogs")) + .andExpect(jsonPath("$[0].cover_asset_id").value(cover)); + for (String id : new String[]{cover, inline}) { + mvc.perform(get(publicUrl + "/images/" + id)) + .andExpect(status().isOk()).andExpect(content().bytes(png)) + .andExpect(content().contentType("image/png")) + .andExpect(header().string("Cache-Control", "no-store")); + mvc.perform(get("/api/v1/assets/" + id + "/content")) + .andExpect(status().isUnauthorized()); + } + mvc.perform(get(publicUrl + "/images/" + other)).andExpect(status().isNotFound()); + mvc.perform(get(publicUrl + "/images/" + file)).andExpect(status().isNotFound()); + input.put("status", "draft"); + input.put("version", 1); + mvc.perform(put(editUrl).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isOk()); + mvc.perform(get(publicUrl + "/images/" + cover)).andExpect(status().isNotFound()); + mvc.perform(get(publicUrl + "/images/" + inline)).andExpect(status().isNotFound()); + mvc.perform(delete("/api/v1/assets/" + cover).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get(editUrl).session(session)).andExpect(jsonPath("$.cover_asset_id").value(cover)); + mvc.perform(delete("/api/v1/library/assets/trash/" + cover).session(session).with(csrf())) + .andExpect(status().isConflict()); + mvc.perform(post("/api/v1/library/assets/trash/" + cover).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/assets/" + cover + "/content").session(session)).andExpect(content().bytes(png)); + } + + private String uploadAsset(MockHttpSession session, String name, byte[] content) throws Exception { + var file = new MockMultipartFile("file", name, "application/octet-stream", content); + return json.readTree(mvc.perform(multipart("/api/v1/assets").file(file).session(session).with(csrf())) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsString()) + .get("id").asText(); + } + + @Test + void privateFileLifecycle() throws Exception { + var session = login(); + byte[] data = "persistent file content".getBytes(); + var file = new MockMultipartFile("file", "../../sample.txt", "text/html", data); + String result = + mvc.perform(multipart("/api/v1/assets").file(file).session(session).with(csrf())) + .andExpect(status().isCreated()) + .andExpect(jsonPath("$.name").value("sample.txt")) + .andReturn() + .getResponse() + .getContentAsString(); + String id = json.readTree(result).get("id").asText(); + mvc.perform(get("/api/v1/assets/" + id + "/content")).andExpect(status().isUnauthorized()); + mvc.perform(get("/api/v1/assets/" + id + "/content").session(login())) + .andExpect(content().bytes(data)) + .andExpect(header().string("Content-Type", "application/octet-stream")) + .andExpect(header().string("X-Content-Type-Options", "nosniff")); + mvc.perform(get("/api/v1/dashboard").session(session)) + .andExpect(jsonPath("$.storageBytes").value(data.length)); + mvc.perform(delete("/api/v1/assets/" + id).session(session).with(csrf())) + .andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/assets/" + id + "/content").session(session)) + .andExpect(status().isNotFound()); + } + @Test + void libraryFoldersTagsHistoryAndTrashWorkTogether() throws Exception { + var session = login(); + String folder = "测试-" + java.util.UUID.randomUUID(); + mvc.perform(post("/api/v1/library/notes/folders").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(Map.of("name", folder)))) + .andExpect(status().isCreated()); + var input = new java.util.HashMap(Map.of( + "title", "版本笔记", "body", "初稿", "category", "技术笔记", "tag", "", "tags", "会议,开发", "folder", folder)); + var result = mvc.perform(post("/api/v1/notes").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isCreated()).andExpect(jsonPath("$.tags").value("会议,开发")) + .andReturn().getResponse(); + String id = json.readTree(result.getContentAsByteArray()).get("id").asText(); + String note = "/api/v1/notes/" + id; + mvc.perform(get("/api/v1/library/notes/facets").session(session)) + .andExpect(status().isOk()).andExpect(jsonPath("$.tags").isArray()); + mvc.perform(get("/api/v1/notes").session(session).param("folder", folder).param("tag", "会议")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(put(note).session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(jsonPath("$.version").value(0)); + input.put("body", "改稿"); + mvc.perform(put(note).session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(jsonPath("$.version").value(1)); + // 快照按保存后的版本号写入:「第 1 版」是 v1 保存前的内容 + mvc.perform(get(note + "/history/1").session(session)).andExpect(jsonPath("$.body").value("初稿")); + mvc.perform(post(note + "/history/1").session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(Map.of("currentVersion", 1)))) + .andExpect(jsonPath("$.body").value("初稿")).andExpect(jsonPath("$.version").value(2)); + // 恢复前先快照当前内容(同样记在第 2 版) + mvc.perform(get(note + "/history/2").session(session)).andExpect(jsonPath("$.body").value("改稿")); + mvc.perform(post("/api/v1/library/notes/batch").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("ids", List.of(id), "action", "trash")))) + .andExpect(status().isNoContent()); + mvc.perform(get(note).session(session)).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/library/notes/trash").session(session)).andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(post("/api/v1/library/notes/trash/" + id).session(session).with(csrf())).andExpect(status().isNoContent()); + // 恢复前先快照当前内容(见「过期保存」用例),再回到历史版本;历史编号与 notes.version 连续 + mvc.perform(get(note + "/history/2").session(session)).andExpect(jsonPath("$.body").value("改稿")); + mvc.perform(get(note).session(session)).andExpect(jsonPath("$.version").value(3)); + mvc.perform(get(note + "/history/3").session(session)).andExpect(status().isNotFound()); + mvc.perform(get(note).session(session)).andExpect(jsonPath("$.folder").value(folder)); + } + + @Test + void publicationChangesOnlyOnSyncAndWithdrawsImmediately() throws Exception { + var session = login(); + var input = new java.util.HashMap(Map.of("title", "原题", "body", "旧正文", + "summary", "摘要", "category", "工程", "status", "published", "version", 0)); + var created = json.readTree(mvc.perform(post("/api/v1/blogs").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()); + String editUrl = "/api/v1/blogs/" + created.get("id").asText(); + String publicUrl = "/api/v1/public/blogs/" + created.get("slug").asText(); + mvc.perform(get(publicUrl)).andExpect(status().isNotFound()); + syncPublication(session); + input.put("body", "新正文"); + mvc.perform(put(editUrl).session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isOk()); + mvc.perform(get(publicUrl)).andExpect(jsonPath("$.body").value("旧正文")); + syncPublication(session); + mvc.perform(get(publicUrl)).andExpect(jsonPath("$.body").value("新正文")); + input.put("status", "draft"); + input.put("version", 1); + mvc.perform(put(editUrl).session(session).with(csrf()).contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isOk()); + mvc.perform(get(publicUrl)).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/publication/export").session(session)).andExpect(jsonPath("$.blogs.length()").value(0)); + } + + @Test + void productivityInboxSearchAndUnifiedTrashShareRecords() throws Exception { + var session=login(); + byte[] capture=json.writeValueAsBytes(Map.of("title","联动验收收集","content","https://example.org/planner")); + mvc.perform(post("/api/v1/inbox").session(session).with(csrf()) + .contentType("application/json").content(capture)).andExpect(status().isNoContent()); + var inbox=json.readTree(mvc.perform(get("/api/v1/inbox").session(session)) + .andExpect(status().isOk()).andReturn().getResponse().getContentAsByteArray()); + String captureId=inbox.get(0).get("id").asText(); + String organize="/api/v1/inbox/"+captureId+"/organize/tasks"; + var result=json.readTree(mvc.perform(post(organize).session(session).with(csrf())) + .andExpect(status().isOk()).andReturn().getResponse().getContentAsByteArray()); + String id=result.get("id").asText(); + mvc.perform(post(organize).session(session).with(csrf())).andExpect(jsonPath("$.id").value(id)); + mvc.perform(get("/api/v1/planner/tasks").session(session).param("status","open")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(get("/api/v1/search").session(session).param("q","联动验收收集")) + .andExpect(jsonPath("$[?(@.kind=='tasks')].id").value(org.hamcrest.Matchers.hasItem(id))); + mvc.perform(delete("/api/v1/planner/tasks/"+id).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/admin-tools/trash").session(session).param("kind","tasks")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(post("/api/v1/admin-tools/trash/tasks/"+id).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/planner/tasks/"+id).session(session)).andExpect(status().isOk()); + mvc.perform(get("/api/v1/admin-tools/summary").session(session)).andExpect(status().isOk()); + } + + @Test + void backupPreviewIsReadOnlyAndRestoreDoesNotDuplicate() throws Exception { + var session=login(); + String id=java.util.UUID.randomUUID().toString(); + byte[] backup=json.writeValueAsBytes(Map.of("version",1,"records",Map.of("notes",List.of(Map.of( + "id",id,"title","备份验收笔记","body","正文","category","技术笔记","folder","默认文件夹","tags","旧标签"))))); + mvc.perform(post("/api/v1/backup/preview").session(session).with(csrf()).contentType("application/json").content(backup)) + .andExpect(jsonPath("$.duplicates.notes").value(0)); + mvc.perform(get("/api/v1/notes/"+id).session(session)).andExpect(status().isNotFound()); + mvc.perform(post("/api/v1/backup/restore").session(session).with(csrf()).contentType("application/json").content(backup)) + .andExpect(jsonPath("$.inserted.notes").value(1)); + mvc.perform(post("/api/v1/backup/restore").session(session).with(csrf()).contentType("application/json").content(backup)) + .andExpect(jsonPath("$.inserted.notes").value(0)); + mvc.perform(put("/api/v1/admin-tools/tags").session(session).with(csrf()).param("name","旧标签") + .contentType("application/json").content(json.writeValueAsBytes(Map.of("name","新标签")))).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/notes/"+id).session(session)).andExpect(jsonPath("$.tags").value("新标签")); + } + + @Test + void rssAndAiEndpointsUseRealConfigurationAndRejectInvalidDestinations() throws Exception { + var session=login(); + mvc.perform(get("/api/v1/rss/articles").session(session)).andExpect(status().isOk()); + mvc.perform(post("/api/v1/rss/sources").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title","本地源","url","http://127.0.0.1/rss","category","测试")))) + .andExpect(status().isBadRequest()); + mvc.perform(get("/api/v1/studio/configuration").session(session)) + .andExpect(status().isOk()).andExpect(jsonPath("$.configured").value(false)); + mvc.perform(post("/api/v1/studio/generate").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("mode","chat","model","test","prompt","x".repeat(8001))))) + .andExpect(status().isBadRequest()); + } + + @Test + void publicStudioPublishesOnlySelectedPrompts() throws Exception { + var session=login(); + String title="公开提示词验收-"+java.util.UUID.randomUUID(); + mvc.perform(post("/api/v1/studio/prompts").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title",title,"body","提示词内容","category","测试")))) + .andExpect(status().isNoContent()); + var id=db.queryForObject("select id from ai_prompts where title=?",java.util.UUID.class,title); + mvc.perform(get("/api/v1/public/studio")).andExpect(jsonPath("$.prompts[?(@.title=='"+title+"')]").isEmpty()); + long revision=db.queryForObject("select revision from publication_state where id=1",Long.class); + mvc.perform(post("/api/v1/publication").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("revision",revision,"bookmarks",List.of(),"prompts",List.of(id),"images",List.of())))) + .andExpect(status().isOk()); + mvc.perform(get("/api/v1/public/studio")).andExpect(jsonPath("$.prompts[0].title").value(title)); + mvc.perform(delete("/api/v1/studio/prompts/"+id).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/public/studio")).andExpect(jsonPath("$.prompts.length()").value(0)); + } + + @Test + void unifiedTrashRestoresCategoriesAndSupportsEmptyAndTimestamps() throws Exception { + var session=login(); + // 书籍分类被外键兜底,不会因删除书籍而消失;用它验证「恢复时分类一起恢复」 + String category="书签回收分类-"+java.util.UUID.randomUUID(); + mvc.perform(post("/api/v1/bookmark-categories").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("name",category)))).andExpect(status().isCreated()); + String bookmark=json.readTree(mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title","回收站书签","url","https://example.com/trash","description","","category",category)))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + mvc.perform(delete("/api/v1/bookmarks/"+bookmark).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/search").session(session).param("q","回收站书签")) + .andExpect(jsonPath("$[?(@.kind=='bookmarks')]").isEmpty()); + mvc.perform(get("/api/v1/admin-tools/trash").session(session).param("kind","bookmarks")) + .andExpect(jsonPath("$[0].id").value(bookmark)).andExpect(jsonPath("$[0].category").value(category)); + mvc.perform(get("/api/v1/admin-tools/summary").session(session)) + .andExpect(jsonPath("$.trashByKind[?(@.kind=='bookmarks')].count").value(org.hamcrest.Matchers.hasItem(1))); + db.update("delete from bookmark_categories where name=?",category); // 模拟分类被清理(正常流程需先清空书签) + mvc.perform(post("/api/v1/admin-tools/trash/bookmarks/"+bookmark).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/bookmarks/"+bookmark).session(session)).andExpect(jsonPath("$.category").value(category)); + mvc.perform(get("/api/v1/admin-tools/notifications").session(session)) + .andExpect(jsonPath("$[0].title").value(org.hamcrest.Matchers.containsString("已恢复书签"))); + + // 标签:删除标签后回收站中的记录也要同步写入,否则恢复正常后旧标签又出现 + String noteId=json.readTree(mvc.perform(post("/api/v1/notes").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title","标签回收笔记","body","内容","category","技术笔记","tag","","tags","甲,乙")))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + mvc.perform(delete("/api/v1/notes/"+noteId).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(delete("/api/v1/admin-tools/tags").session(session).with(csrf()).param("name","甲")).andExpect(status().isNoContent()); + mvc.perform(post("/api/v1/admin-tools/trash/notes/"+noteId).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/notes/"+noteId).session(session)).andExpect(jsonPath("$.tags").value("乙")); + mvc.perform(delete("/api/v1/admin-tools/tags").session(session).with(csrf()).param("name","不存在-"+java.util.UUID.randomUUID())) + .andExpect(status().isNotFound()); + + // 统一回收站覆盖日程:删除 → 列表消失 → 恢复 → 时间按应用时区原样返回 + String day=java.time.LocalDate.now().plusDays(3).toString(); + String event=json.readTree(mvc.perform(post("/api/v1/planner/events").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title","日程联动","body","","starts_at",day+"T07:30")))) + .andExpect(status().isCreated()).andExpect(jsonPath("$.starts_at").value(day+"T07:30")) + .andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + mvc.perform(delete("/api/v1/planner/events/"+event).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/admin-tools/trash").session(session).param("kind","events")) + .andExpect(jsonPath("$[0].id").value(event)); + mvc.perform(post("/api/v1/admin-tools/trash/events/"+event).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/planner/events/"+event).session(session)).andExpect(jsonPath("$.starts_at").value(day+"T07:30")); + mvc.perform(get("/api/v1/dashboard").session(session).param("today",day)) + .andExpect(jsonPath("$.taskCounts.open").value(0)) + .andExpect(jsonPath("$.taskCounts.due").value(0)); + + // 工作流删除进回收站(不再硬删);清空回收站后不能再恢复 + mvc.perform(post("/api/v1/admin-tools/flows").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title","回收站工作流","instructions","步骤")))).andExpect(status().isNoContent()); + String flow=db.queryForObject("select id from workspace_flows where title='回收站工作流'",java.util.UUID.class).toString(); + mvc.perform(delete("/api/v1/admin-tools/flows/"+flow).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/admin-tools/flows").session(session)).andExpect(jsonPath("$.flows[?(@.id=='"+flow+"')]").isEmpty()); + var emptied=json.readTree(mvc.perform(delete("/api/v1/admin-tools/trash").session(session).with(csrf())) + .andExpect(status().isOk()).andReturn().getResponse().getContentAsByteArray()); + assertTrue(emptied.get("purged").asInt()>=1); + mvc.perform(post("/api/v1/admin-tools/trash/flows/"+flow).session(session).with(csrf())).andExpect(status().isNotFound()); + } + + /** XZH-21 回归:收集箱删除进统一回收站,可恢复;回收站中的旧条目再被采集时复活而不是撞唯一键。 */ + @Test + void inboxTrashRestoreAndRecapture() throws Exception { + var session = login(); + String url = "https://example.org/inbox-" + System.nanoTime(); + String bookmark = json.readTree(mvc.perform(post("/api/v1/bookmarks").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(Map.of( + "title", "收集箱书签", "url", url, "description", "说明", "category", "设计工具")))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + String item = json.readTree(mvc.perform(post("/api/v1/inbox/bookmarks/" + bookmark).session(session).with(csrf())) + .andExpect(status().isOk()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + mvc.perform(delete("/api/v1/inbox/" + item).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/inbox").session(session)).andExpect(jsonPath("$[?(@.id=='" + item + "')]").isEmpty()); + mvc.perform(get("/api/v1/inbox/" + item).session(session)).andExpect(status().isNotFound()); + mvc.perform(get("/api/v1/admin-tools/trash").session(session).param("kind", "inbox")) + .andExpect(jsonPath("$[0].id").value(item)); + // 回收站中存在同来源条目时再次采集:复活旧条目,不因 unique(source_kind,source_id) 失败 + mvc.perform(post("/api/v1/inbox/bookmarks/" + bookmark).session(session).with(csrf())) + .andExpect(status().isOk()).andExpect(jsonPath("$.id").value(item)) + .andExpect(jsonPath("$.deleted_at").doesNotExist()); + mvc.perform(delete("/api/v1/inbox/" + item).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(post("/api/v1/admin-tools/trash/inbox/" + item).session(session).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/inbox/" + item).session(session)).andExpect(jsonPath("$.id").value(item)); + mvc.perform(get("/api/v1/admin-tools/trash").session(session).param("kind", "inbox")) + .andExpect(jsonPath("$[?(@.id=='" + item + "')]").isEmpty()); + } + + /** XZH-21 回归:历史编号与 notes.version 对齐,history/{当前版本} 恒可取到「保存前」内容。 */ + @Test + void historyIndexMatchesNoteVersion() throws Exception { + var session = login(); + var input = new java.util.HashMap(Map.of( + "title", "版本对齐", "body", "v0", "category", "技术笔记", "tag", "", "version", 0)); + String id = json.readTree(mvc.perform(post("/api/v1/notes").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + String note = "/api/v1/notes/" + id; + for (String next : new String[]{"v1", "v2"}) { + input.put("body", next); + int version = mvc.perform(put(note).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isOk()).andReturn().getResponse().getStatus(); + assertEquals(200, version); + int current = json.readTree(mvc.perform(get(note).session(session)).andReturn().getResponse() + .getContentAsByteArray()).get("version").asInt(); + // history/{current} 是本次保存前的内容(v0 / v1) + mvc.perform(get(note + "/history/" + current).session(session)) + .andExpect(jsonPath("$.body").value(next.equals("v1") ? "v0" : "v1")); + } + // 列表从当前版本号连续向下 + mvc.perform(get(note + "/history").session(session)) + .andExpect(jsonPath("$[0].version").value(2)) + .andExpect(jsonPath("$[1].version").value(1)) + .andExpect(jsonPath("$.length()").value(2)); + mvc.perform(get(note + "/history/3").session(session)).andExpect(status().isNotFound()); + } + + /** XZH-21 回归:分类删除时迁移该分类下的历史快照,不再被 note_history 外键挡住。 */ + @Test + void categoryDeletionMigratesNoteHistory() throws Exception { + var session = login(); + String cat = "历史分类-" + java.util.UUID.randomUUID(); + mvc.perform(post("/api/v1/notes/categories").session(session).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("name", cat)))).andExpect(status().isCreated()); + var input = new java.util.HashMap(Map.of( + "title", "历史分类笔记", "body", "a", "category", cat, "tag", "", "version", 0)); + String id = json.readTree(mvc.perform(post("/api/v1/notes").session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + input.put("body", "b"); + mvc.perform(put("/api/v1/notes/" + id).session(session).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(input))).andExpect(status().isOk()); + mvc.perform(delete("/api/v1/notes/categories").session(session).with(csrf()) + .param("name", cat).param("replacement", "设计灵感")).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/notes/" + id).session(session)).andExpect(jsonPath("$.category").value("设计灵感")); + // 历史随分类迁移,外键不再引用已删除分类 + assertEquals(0, db.queryForObject("select count(*) from note_history where category=?", Integer.class, cat)); + mvc.perform(get("/api/v1/notes/" + id + "/history/2").session(session)) + .andExpect(jsonPath("$.category").value("设计灵感")); + } +} diff --git a/backend/src/test/java/com/myspace/VerificationTest.java b/backend/src/test/java/com/myspace/VerificationTest.java new file mode 100644 index 0000000..3ea11dd --- /dev/null +++ b/backend/src/test/java/com/myspace/VerificationTest.java @@ -0,0 +1,271 @@ +package com.myspace; + +import static org.junit.jupiter.api.Assertions.*; +import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.csrf; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; + +import com.fasterxml.jackson.databind.ObjectMapper; +import java.util.List; +import java.util.Map; +import org.junit.jupiter.api.*; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.mock.web.MockHttpSession; +import org.springframework.test.web.servlet.MockMvc; + +/** + * XZH-21 验收用附加用例(只追加文件,不改动开发产物)。 + * 每条用例对应开发改动说明中的一条「行为变化」或验收要点,用于独立复核。 + */ +@SpringBootTest( + properties = { + "spring.datasource.url=${TEST_DB_URL:jdbc:postgresql://localhost:55432/myspace_test}", + "spring.datasource.username=${TEST_DB_USER:myspace}", + "spring.datasource.password=${TEST_DB_PASSWORD:}", + "app.admin-password=integration-test-password", + "app.storage=target/test-assets" + }) +@AutoConfigureMockMvc +class VerificationTest { + @Autowired MockMvc mvc; + @Autowired ObjectMapper json; + @Autowired JdbcTemplate db; + + @BeforeEach + void clean() { + db.update("delete from inbox_items"); + db.update("delete from planner_items"); + db.update("delete from workspace_tags"); + db.update("delete from workspace_flows"); + db.update("delete from notes"); + db.update("delete from assets"); + db.update("delete from blogs"); + db.update("delete from bookmarks"); + db.update("delete from bookmark_categories where name not in ('设计工具','开发资源','灵感收藏')"); + db.update("delete from ai_prompts"); + db.update("delete from rss_articles"); + db.update("delete from rss_sources"); + db.update("delete from note_categories where name not in ('技术笔记','设计灵感','个人成长')"); + } + + MockHttpSession login() throws Exception { + return (MockHttpSession) + mvc.perform(post("/api/v1/auth/login").with(csrf()) + .param("username", "admin").param("password", "integration-test-password")) + .andExpect(status().isOk()).andReturn().getRequest().getSession(); + } + + String createNote(MockHttpSession s, Map body) throws Exception { + return json.readTree(mvc.perform(post("/api/v1/notes").session(s).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(body))) + .andExpect(status().isCreated()).andReturn().getResponse().getContentAsByteArray()).get("id").asText(); + } + + int putNote(MockHttpSession s, String id, Map body) throws Exception { + return mvc.perform(put("/api/v1/notes/" + id).session(s).with(csrf()) + .contentType("application/json").content(json.writeValueAsBytes(body))).andReturn().getResponse().getStatus(); + } + + int historyStatus(MockHttpSession s, String id, long version) throws Exception { + return mvc.perform(get("/api/v1/notes/" + id + "/history/" + version).session(s)) + .andReturn().getResponse().getStatus(); + } + + /** P0-4:每次保存前写入快照 —— 第一次保存后,历史里必须有「保存前」的原始正文。 */ + @Test + void firstSaveWritesPreSaveSnapshot() throws Exception { + var s = login(); + var body = new java.util.HashMap(Map.of( + "title", "快照笔记", "body", "原始正文-甲", "category", "技术笔记", "tag", "", "version", 0)); + String id = createNote(s, body); + body.put("body", "已保存正文-乙"); + assertEquals(200, putNote(s, id, body)); + // 快照以保存后的版本号写入:第一次保存后 history/1 就是保存前的原始正文 + assertEquals(200, historyStatus(s, id, 1L), "history/1 应保存「保存前」的原始内容"); + mvc.perform(get("/api/v1/notes/" + id + "/history/1").session(s)).andExpect(jsonPath("$.body").value("原始正文-甲")); + } + + /** 历史编号与 notes.version 对齐:history/{当前版本} 恒为当前内容的保存前快照,无错位、无空洞。 */ + @Test + void historyVersionIndexIsOffByOne() throws Exception { + var s = login(); + var body = new java.util.HashMap(Map.of( + "title", "索引笔记", "body", "v0", "category", "技术笔记", "tag", "", "version", 0)); + String id = createNote(s, body); + body.put("body", "v1"); + putNote(s, id, body); // 保存后 version=1,history/1 = v0 + body.put("body", "v2"); + putNote(s, id, body); // 保存后 version=2,history/2 = v1 + mvc.perform(get("/api/v1/notes/" + id).session(s)).andExpect(jsonPath("$.version").value(2)); + mvc.perform(get("/api/v1/notes/" + id + "/history/1").session(s)).andExpect(jsonPath("$.body").value("v0")); + mvc.perform(get("/api/v1/notes/" + id + "/history/2").session(s)).andExpect(jsonPath("$.body").value("v1")); + // 历史列表最高一条与 notes.version 连续 + mvc.perform(get("/api/v1/notes/" + id + "/history").session(s)).andExpect(jsonPath("$[0].version").value(2)); + } + + /** 开发说明:过期保存由 409 改为 200,且不把笔记改回旧分类。 */ + @Test + void staleSaveReturns200AndKeepsServerCategory() throws Exception { + var s = login(); + String cat = "旧分类-" + java.util.UUID.randomUUID(); + mvc.perform(post("/api/v1/notes/categories").session(s).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("name", cat)))).andExpect(status().isCreated()); + var body = new java.util.HashMap(Map.of( + "title", "过期保存", "body", "a", "category", cat, "tag", "", "version", 0)); + String id = createNote(s, body); + db.update("update notes set category='设计灵感',version=1 where id=?::uuid", id); // 模拟别处已迁移 + body.put("body", "b"); + assertEquals(200, putNote(s, id, body)); + mvc.perform(get("/api/v1/notes/" + id).session(s)) + .andExpect(jsonPath("$.category").value("设计灵感")).andExpect(jsonPath("$.body").value("b")); + } + + /** 恢复历史版本:恢复前先快照当前内容(开发说明),可选 currentVersion。 */ + @Test + void restoreSnapshotsCurrentBeforeRestoring() throws Exception { + var s = login(); + var body = new java.util.HashMap(Map.of( + "title", "恢复笔记", "body", "v0", "category", "技术笔记", "tag", "", "version", 0)); + String id = createNote(s, body); + body.put("body", "v1"); + putNote(s, id, body); + mvc.perform(post("/api/v1/notes/" + id + "/history/1").session(s).with(csrf()) + .contentType("application/json").content("{}")) + .andExpect(status().isOk()).andExpect(jsonPath("$.body").value("v0")).andExpect(jsonPath("$.version").value(2)); + // 恢复前的 v1 应可在历史中找到(恢复前的快照记在第 2 版) + mvc.perform(get("/api/v1/notes/" + id + "/history/2").session(s)).andExpect(jsonPath("$.body").value("v1")); + } + + /** 标签:重命名对回收站中的笔记生效,恢复后是新标签(开发说明)。 */ + @Test + void tagRenameAppliesToTrashedNotes() throws Exception { + var s = login(); + String id = createNote(s, Map.of("title", "标签笔记", "body", "b", "category", "技术笔记", "tag", "", "tags", "甲,乙")); + mvc.perform(delete("/api/v1/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(put("/api/v1/admin-tools/tags").session(s).with(csrf()).param("name", "甲") + .contentType("application/json").content(json.writeValueAsBytes(Map.of("name", "丙")))).andExpect(status().isNoContent()); + mvc.perform(post("/api/v1/admin-tools/trash/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/notes/" + id).session(s)).andExpect(jsonPath("$.tags").value("丙,乙")); + } + + /** 首页今日待办:逾期可见、未来不可见(开发说明)。 */ + @Test + void dashboardTodayTasksExcludeFuture() throws Exception { + var s = login(); + for (var t : List.of("逾期任务", "今天任务", "未来任务")) { + String day = t.equals("逾期任务") ? java.time.LocalDate.now().minusDays(1).toString() + : t.equals("今天任务") ? java.time.LocalDate.now().toString() + : java.time.LocalDate.now().plusDays(7).toString(); + mvc.perform(post("/api/v1/planner/tasks").session(s).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title", t, "body", "", "starts_at", day + "T09:00")))) + .andExpect(status().isCreated()); + } + mvc.perform(get("/api/v1/dashboard").session(s)) + .andExpect(jsonPath("$.tasks[?(@.title=='逾期任务')]").isNotEmpty()) + .andExpect(jsonPath("$.tasks[?(@.title=='今天任务')]").isNotEmpty()) + .andExpect(jsonPath("$.tasks[?(@.title=='未来任务')]").isEmpty()) + .andExpect(jsonPath("$.taskCounts.open").value(3)); + } + + /** 清空回收站:返回 purged 计数,清空后不可再恢复(开发说明)。 */ + @Test + void emptyTrashPurgesAndReports() throws Exception { + var s = login(); + String id = createNote(s, Map.of("title", "待清空", "body", "b", "category", "技术笔记", "tag", "")); + mvc.perform(delete("/api/v1/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(delete("/api/v1/admin-tools/trash").session(s).with(csrf())) + .andExpect(status().isOk()).andExpect(jsonPath("$.purged").value(1)); + mvc.perform(post("/api/v1/admin-tools/trash/notes/" + id).session(s).with(csrf())).andExpect(status().isNotFound()); + } + + /** 回收站里存在该分类的笔记时删除分类:给定迁移目标应成功,且回收站记录随之迁移。 */ + @Test + void deletingCategoryWithOnlyTrashedNotes() throws Exception { + var s = login(); + String cat = "回收分类-" + java.util.UUID.randomUUID(); + String id = createNote(s, Map.of("title", "回收分类笔记", "body", "b", "category", cat, "tag", "")); + mvc.perform(delete("/api/v1/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + int status = mvc.perform(delete("/api/v1/notes/categories").session(s).with(csrf()).param("name", cat) + .param("replacement", "技术笔记")).andReturn().getResponse().getStatus(); + assertTrue(status == 204 || status == 409, "unexpected status " + status); + mvc.perform(get("/api/v1/admin-tools/trash").session(s).param("kind", "notes")) + .andExpect(jsonPath("$[0].id").value(id)); + } + + /** 工作流软删除、恢复(开发说明第 5 条)。 */ + @Test + void flowSoftDeleteAndRestore() throws Exception { + var s = login(); + mvc.perform(post("/api/v1/admin-tools/flows").session(s).with(csrf()).contentType("application/json") + .content(json.writeValueAsBytes(Map.of("title", "验收工作流", "instructions", "步骤")))).andExpect(status().isNoContent()); + String id = db.queryForObject("select id from workspace_flows where title='验收工作流'", java.util.UUID.class).toString(); + mvc.perform(delete("/api/v1/admin-tools/flows/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/admin-tools/trash").session(s).param("kind", "flows")) + .andExpect(jsonPath("$[0].id").value(id)); + mvc.perform(post("/api/v1/admin-tools/trash/flows/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/admin-tools/flows").session(s)).andExpect(jsonPath("$.flows[0].id").value(id)); + } + + /** RSS 订阅删除后文章同事务隐藏,恢复订阅不复活旧文章(开发说明第 4 条,直接查库验证)。 */ + @Test + void rssDeleteHidesArticlesAndRestoreDoesNotRevive() throws Exception { + var s = login(); + java.util.UUID src = java.util.UUID.randomUUID(); + db.update("insert into rss_sources(id,title,url,category) values(?,?,?,?)", src, "验收源", + "https://example.org/feed-" + System.nanoTime(), "测试"); + db.update("insert into rss_articles(id,source_id,external_key,title,body,url) values(?,?,?,?,?,?)", + java.util.UUID.randomUUID(), src, "k" + System.nanoTime(), "旧文章", "正文", "https://example.org/a"); + mvc.perform(delete("/api/v1/rss/sources/" + src).session(s).with(csrf())).andExpect(status().isNoContent()); + assertEquals(1, db.queryForObject("select count(*) from rss_articles where source_id=? and deleted_at is not null", Integer.class, src)); + mvc.perform(post("/api/v1/admin-tools/trash/rss/" + src).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/rss/articles").session(s)) + .andExpect(jsonPath("$[?(@.title=='旧文章')]").isEmpty()); + } + + /** 搜索/公开发布面板不带出回收站内容(开发说明)。 */ + @Test + void searchAndBackupExcludeTrashed() throws Exception { + var s = login(); + String id = createNote(s, Map.of("title", "回收站搜索笔记", "body", "b", "category", "技术笔记", "tag", "")); + mvc.perform(delete("/api/v1/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(get("/api/v1/search").session(s).param("q", "回收站搜索笔记")) + .andExpect(jsonPath("$[?(@.kind=='notes')]").isEmpty()); + mvc.perform(get("/api/v1/backup").session(s)).andExpect(status().isOk()) + .andExpect(jsonPath("$.records.notes[?(@.title=='回收站搜索笔记')]").isEmpty()); + } + + /** 【复现-1】历史索引错位:界面上点「恢复」最近可选的上一版,实际拿到的是「当前内容」本身。 */ + @Test + void restorePreviousVersionIsNoopBecauseOfIndexShift() throws Exception { + var s = login(); + var body = new java.util.HashMap(Map.of( + "title", "错位复现", "body", "v0", "category", "技术笔记", "tag", "", "version", 0)); + String id = createNote(s, body); + body.put("body", "v1"); + putNote(s, id, body); + body.put("body", "v2"); + putNote(s, id, body); // 当前 v2,历史 {0:v0, 1:v1} + String res = mvc.perform(post("/api/v1/notes/" + id + "/history/1").session(s).with(csrf()) + .contentType("application/json").content("{}")).andExpect(status().isOk()) + .andReturn().getResponse().getContentAsString(); + String bodyAfter = json.readTree(res).get("body").asText(); + assertNotEquals("v1", bodyAfter, "history/1 应当回退到 v1"); + } + + /** 【复现-2】回收站里只有「笔记」这类不升版本的分类引用时,恢复该笔记会踩外键。 */ + @Test + void categoryDeletionAndRestoreOfNoteDoesNotResurrectCategory() throws Exception { + var s = login(); + String cat = "回收分类-" + java.util.UUID.randomUUID(); + String id = createNote(s, Map.of("title", "回收分类笔记", "body", "b", "category", cat, "tag", "")); + mvc.perform(delete("/api/v1/notes/" + id).session(s).with(csrf())).andExpect(status().isNoContent()); + mvc.perform(delete("/api/v1/notes/categories").session(s).with(csrf()).param("name", cat).param("replacement", "技术笔记")) + .andExpect(status().isNoContent()); + int restore = mvc.perform(post("/api/v1/admin-tools/trash/notes/" + id).session(s).with(csrf())) + .andReturn().getResponse().getStatus(); + assertEquals(204, restore); + } +} diff --git a/compose.yml b/compose.yml new file mode 100644 index 0000000..95157a7 --- /dev/null +++ b/compose.yml @@ -0,0 +1,59 @@ +services: + db: + image: ${IMAGE_REGISTRY:-docker.io}/library/postgres:16-alpine + environment: + POSTGRES_DB: myspace + POSTGRES_USER: ${DB_USER:-myspace} + POSTGRES_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env} + ports: + - '5432:5432' + volumes: + - postgres-data:/var/lib/postgresql/data + healthcheck: + test: [CMD-SHELL, 'pg_isready -U "$${POSTGRES_USER}" -d myspace'] + interval: 5s + timeout: 5s + retries: 20 + backend: + build: + context: ./backend + args: + IMAGE_REGISTRY: ${IMAGE_REGISTRY:-docker.io} + environment: + DB_URL: jdbc:postgresql://db:5432/myspace + DB_USER: ${DB_USER:-myspace} + DB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD} + ADMIN_USERNAME: ${ADMIN_USERNAME:-admin} + ADMIN_PASSWORD: ${ADMIN_PASSWORD:?Set ADMIN_PASSWORD} + STORAGE_PATH: /data/assets + RSS_PUBLIC_DNS: ${RSS_PUBLIC_DNS-https://cloudflare-dns.com/dns-query} + AI_BASE_URL: ${AI_BASE_URL:-} + AI_API_KEY: ${AI_API_KEY:-} + AI_CHAT_MODELS: ${AI_CHAT_MODELS:-} + AI_IMAGE_MODELS: ${AI_IMAGE_MODELS:-} + SERVER_ADDRESS: 0.0.0.0 + COOKIE_SECURE: ${COOKIE_SECURE:-false} + volumes: + - asset-data:/data/assets + depends_on: + db: + condition: service_healthy + healthcheck: + test: [CMD-SHELL, 'bash -c "exec 3<>/dev/tcp/127.0.0.1/8080"'] + interval: 10s + timeout: 5s + retries: 12 + start_period: 60s + frontend: + build: + context: ./frontend + args: + IMAGE_REGISTRY: ${IMAGE_REGISTRY:-docker.io} + ports: + - '127.0.0.1:8088:80' + depends_on: + backend: + condition: service_healthy +volumes: + postgres-data: + asset-data: diff --git a/docs/api.md b/docs/api.md new file mode 100644 index 0000000..ee18ae2 --- /dev/null +++ b/docs/api.md @@ -0,0 +1,77 @@ +# API(第一阶段 + 博客管理 + 导航书签 + 公开博客) + +所有路径以 `/api/v1` 开头,业务 API 需登录 Cookie;不使用浏览器持久化 token。除 GET 外需 `X-CSRF-TOKEN` 请求头,值从 `/auth/csrf` 的 `token` 字段取得(响应也给出 `headerName`)。登录和退出后重新请求 token。 + +| 方法 | 路径 | 请求/结果 | +|---|---|---| +| GET | /auth/csrf | `{token,headerName}`,匿名可访问 | +| POST | /auth/login | form-urlencoded `username,password`;成功 200,失败 401 | +| GET | /auth/me | `{username}` | +| POST | /auth/logout | 成功 204,失效会话 | +| GET | /dashboard | `{notes,starred,assets,bookmarks,storageBytes,recentNotes}` | +| GET | /notes | `q, category, starred, offset`;数组,每页最多 100 | +| POST | /notes | `{title,body,category,tag,star,version:0}`;201 + 完整记录 | +| GET | /notes/categories | 返回已保存的笔记分类名称数组 | +| POST | /notes/categories | `{name}`;创建分类并返回 `{name}`,重名返回 409 | +| GET | /notes/categories/usage | 返回分类名称和笔记数 `{name,noteCount}` | +| DELETE | /notes/categories | `name` 指定分类,`replacement` 指定迁移目标。空分类可直接删除。有笔记时需提供另一个分类。至少保留一个分类,成功返回 204 | +| GET | /notes/{uuid} | 完整记录 | +| PUT | /notes/{uuid} | 同创建字段,version 必须是读取时版本;更新返回 version+1;冲突 409 | +| DELETE | /notes/{uuid} | 204,移入回收站;不存在返回 404 | +| GET | /assets | `q,type=all/image/file,offset`;数组,每页最多 100 | +| POST | /assets | multipart 字段 `file`,单文件 1 字节至 15 MB;201 | +| GET | /assets/{uuid}/content | PNG/JPEG/GIF 内联,其他附件;`download=true` 强制下载 | +| DELETE | /assets/{uuid} | 删除磁盘文件与元数据,204 | +| GET | /bookmarks | `q,category,offset`;数组,每页最多 100,按更新时间倒序 | +| POST | /bookmarks | `{title,url,description,category,icon_asset_id,is_public}`;默认私有,图标可选,必须是图床图片;仅接受有效的 http(s) URL;201 + 完整记录 | +| GET | /bookmarks/{uuid} | 完整记录 | +| PUT | /bookmarks/{uuid} | 请求字段与新增一致;更新原记录及公开状态;不存在返回 404 | +| DELETE | /bookmarks/{uuid} | 204,移入回收站;不存在返回 404 | +| GET | /public/bookmarks | 匿名只读;`offset,limit(1–100,默认 50)`;仅展示已同步至公开快照的记录,返回 `{title,url,description,category,icon_asset_id,updated_at}` | +| GET | /public/bookmarks/images/{uuid} | 匿名读取被公开书签选为图标的 PNG/JPEG/GIF;其他图片或未引用图片返回 404 | +| GET | /blogs | `q, status=all/draft/published, offset`;数组,每页最多 100,按更新时间倒序 | +| POST | /blogs | `{title,summary,body,status,version:0,cover_asset_id,category}`;status 为 draft/published;201 + 完整记录 | +| GET | /blogs/{uuid} | 完整记录 | +| PUT | /blogs/{uuid} | 同创建字段,version 必须是读取时版本;更新返回 version+1;冲突 409 | +| DELETE | /blogs/{uuid} | 204,移入回收站;不存在返回 404 | +| GET | /public/blogs | 匿名只读;`offset, limit(1–50,默认 20), q, category`;仅已同步的已发布文章,`{title,summary,slug,updated_at,cover_asset_id,category}`,按更新时间倒序 | +| GET | /public/blogs/rss.xml | 匿名订阅最近 30 篇已同步的文章,返回 RSS 2.0 | +| GET | /public/blogs/categories | 匿名只读;返回已发布文章的分类列表 | +| GET | /public/blogs/{slug} | 匿名只读;仅已同步的已发布文章,额外返回 `body`;草稿或不存在的 slug 均为 404 | +| GET | /public/blogs/{slug}/images/{uuid} | 匿名读取该已发布文章引用的封面或 Markdown 图片;其余情况返回 404 | + +笔记字段:id(UUID)、title(1–120 非空)、body(最多 1,000,000 字符)、category(1–60 非空)、tag(0–60)、star、version、created_at、updated_at。 +资产字段:id、name、media_type、size(字节)、created_at。时间由数据库产生,使用 timestamptz。 +书签字段:id(UUID)、title(1–60 非空)、url(有效 http/https 地址,最多 4096 字符)、description(0–160)、category(1–60 非空)、created_at、updated_at。书签为私有数据;管理页面使用 `target="_blank"` 与 `rel="noopener noreferrer"` 打开网址。 +博客字段:id(UUID)、title(1–120 非空)、summary(0–200)、body(最多 1,000,000 字符)、status(draft/published,数据库 CHECK 约束)、slug(唯一)、version、created_at、updated_at。列表不返回数量汇总;前端在本地按状态和关键词筛选(页内搜索与全局搜索都按正文匹配)。 +`cover_asset_id` 是可选的图床图片 UUID。提交 `null` 可移除封面。Flyway V4 为已有文章新增该字段,删除对应图床原图时自动清空。 +`slug` 由服务端在创建时按标题生成:小写 ASCII 字母数字保留,其余转连字符,最多 80 字符;不含字母(如纯中文或纯数字标题)时用 `article`,再追加 id 前 6 位保证唯一。编辑标题不会改变 slug,已分享的链接保持有效。 + +公开与私有边界: +- `/public/**` 可匿名访问,是前端 `/blog`、`/blog/` 页面的唯一数据来源;响应不含 id、version 等内部字段,公开页面请求时使用 `credentials: "omit"`,页面被嵌入或分享时不会带上登录 Cookie。 +- 公开接口响应携带 ETag(根据文章版本、封面及当前页文章集合生成),带 `If-None-Match` 的条件请求内容未变时返回 304;公开页面每 30 秒、以及窗口重新获得焦点时做条件请求,文章更新后自动刷新。 +- 所有 `/blogs` 管理接口仍需登录和 CSRF。单账户平台,不提供按作者或空间的隔离;公开页面目前可被同一台电脑上的浏览器访问,是否可被互联网访问取决于部署与网络环境。 + +响应头:所有响应带 `X-Content-Type-Options: nosniff`、`Referrer-Policy: strict-origin-when-cross-origin`、`X-Frame-Options: SAMEORIGIN`。 + +错误:401 未登录/凭据错误;403 CSRF 不合法;400 输入校验失败(含非法 status 筛选值);404 不存在;409 版本冲突;413 超过上传限制;500 服务失败。控制器业务错误为 `{message}`;安全过滤器错误可能采用 Spring 标准错误格式。前端保留未保存内容并提示错误,不将失败当成功。 + + +## V4 工作区 + +| 方法 | 路径 | 用途 | +|---|---|---| +| GET、POST | /library/{kind}/folders | 知识库及图床的文件夹列表与新增 | +| GET | /library/{kind}/facets | 知识库及图床的文件夹计数、标签和图床存储统计 | +| GET、POST、PUT | /library/{kind}/categories | 分类列表、新增、改名或迁移后删除 | +| POST | /library/{kind}/batch | 对指定 ID 批量移动、加标签、移入回收站或调整书签顺序 | +| GET | /library/{kind}/trash | 按模块查看已删除记录 | +| POST、DELETE | /library/{kind}/trash/{id} | 恢复或永久删除 | +| GET | /notes/{id}/history | 按笔记分页读取版本列表 | +| GET、POST | /notes/{id}/history/{version} | 预览历史版本或使用当前版本号恢复 | +| GET | /notes/{id}/backlinks | 查找引用当前笔记的双链 | +| GET、PUT | /assets/{id} | 读取和编辑文件名、分类、文件夹、标签、描述 | +| PUT | /bookmarks/{id}/favorite | 修改常用收藏状态 | +| POST | /bookmarks/import | 批量导入并按网址去重,导入项默认私有 | +| GET、POST | /publication | 查看待同步清单或按当前发布版本提交同步 | +| GET | /publication/export | 导出已发布的博客与书签快照 | diff --git a/docs/container-testing.md b/docs/container-testing.md new file mode 100644 index 0000000..3fb6e6e --- /dev/null +++ b/docs/container-testing.md @@ -0,0 +1,86 @@ +# Docker Compose 容器验收 + +2026-11-10 实测通过:前后端容器构建、数据库迁移、18 项创建阶段检查、10 项重建后检查,以及 Chromium 登录/工作台/笔记/文件/退出流程。三个容器 ID 均已变化,笔记版本和文件 SHA256 保持一致。测试记录已清理,服务保留运行在 http://localhost:8088 ,登录信息见本机 `.local/container-access.md`。 + +不连接本机开发数据库(127.0.0.1:55432),不使用本机资产目录。测试配置在 Git 忽略的 `.local/container-test.env`,权限为 600。 + +2026-11-10 晚 `compose.yml` 统一为单一栈:固定项目名 `name: myspace`,数据卷 `myspace_postgres-data` / `myspace_asset-data`;后端健康检查通过后才启动前端。此前按目录名运行的 `myspace_hifox` 栈已停止(容器移除,数据卷保留,未被新栈使用),旧的 `-p myspace-container-test` 命令不再适用。 + +## 可重复执行 + +从工程根目录运行。先填写测试环境文件(参考 `.env.example`),并确保 8088 和 5432 端口空闲。项目名由 `compose.yml` 的 `name:` 决定,不要传 `-p`,否则会另建一套数据卷: + +```sh +docker compose --env-file .local/container-test.env up --build -d +python3 scripts/container-smoke.py --phase create +# 重建全部容器,保留命名数据卷;不要加 down -v +docker compose --env-file .local/container-test.env up -d --force-recreate +python3 scripts/container-smoke.py --phase verify +``` + +`/blog` 公开页验收(登录 → 草稿不出现在匿名接口 → 发布后公开 → 删除测试文章):`python3 .local/stack-smoke.py`。2026-11-10 在 `myspace_hifox` 栈实测 6/6 通过;同次确认匿名接口带 `nosniff`、`X-Frame-Options: DENY` 等响应头。 + +2026-11-10 重启时实测:容器已移除但镜像保留时,`docker compose up` 直接运行**旧镜像**,不读源码;改了代码后必须 `docker compose --env-file .local/container-test.env build` 或加 `--build`,再用 `docker compose ... ps` 确认容器镜像 ID 与新镜像一致。.local/compose-e2e.py 依赖公开接口中的 slug(V3),在 V2 镜像上会报 `KeyError: 'slug'`。 + +`create` 验证静态页面、匿名拒绝、登录、CSRF、笔记 CRUD 与冲突、搜索筛选、文本/PNG 上传和下载、实际统计、退出及文件私有性。它将新建记录的 UUID 保存到 `.local/container-test-state.json`。 + +`verify` 重新登录,检查重建前的笔记版本和内容,按 SHA256 检查两个文件内容,随后只删除脚本创建的记录并检查统计回到基线。若中途失败,保留状态文件,排查后再次执行 `verify`;不要直接删除状态文件造成测试数据失去追踪。 + +## 首次启动值与已有数据卷 + +`DB_PASSWORD`(数据库角色)和 `ADMIN_PASSWORD`(唯一账户)只在**首次创建**时生效;已有数据卷时重建容器、修改 env 都不会改变它们。 + +2026-11-10 晚,`myspace_postgres-data` 卷是由先前一次以 `.env.example` 示例值启动的运行创建的:角色密码为 `replace-with-a-long-database-password`,账户 `admin` 的哈希对应示例密码 `replace-with-a-unique-password`。为与 `.local/container-test.env` 一致,角色密码已在单用户模式用 `ALTER ROLE` 重置,账户哈希已改写为 `ADMIN_PASSWORD` 的 BCrypt 值。未删除任何数据。 + +但工程根目录没有 `compose.yml` 的 `name:` 时,项目名取自目录名,当前由 `compose.yml` 使用的是 `myspace_hifox` 栈,其数据卷 `myspace_hifox_postgres-data` / `myspace_hifox_asset-data`。该卷同样由示例值创建,2026-11-10 重启时已把角色密码重置为 `DB_PASSWORD`、`admin` 哈希改写为 `ADMIN_PASSWORD`。目前线上数据只有 1 篇已发布文章。`myspace_postgres-data` / `myspace_asset-data` 中的示例值数据**未**重置,暂未被任何栈使用。 + +## 重置角色密码 + +在工程根目录执行;密码经环境变量传入,包含引号也安全(已实测): + +```sh +set -a; . ./.env; set +a # 读取 DB_PASSWORD;也可换成任意密码 +docker compose stop db +docker run --rm --user postgres -e NEWPW="$DB_PASSWORD" \ + -v myspace_postgres-data:/var/lib/postgresql/data \ + registry-1.docker.io/library/postgres:16-alpine \ + sh -c 'printf "ALTER ROLE myspace PASSWORD %s;\n" "$(printf "%s" "$NEWPW" | sed "s/'"'"'/'"'"''"'"'/g; s/^/'"'"'/; s/$/'"'"'/")" | postgres --single -D /var/lib/postgresql/data postgres' +docker compose up -d +``` + +## 重置账户密码 + +`ADMIN_PASSWORD` 只在数据库中没有任何账户时生效。需要生成 BCrypt 哈希(`$2a$`,60 字符)后写入 `app_user`: + +```sh +set -a; . ./.env; set +a +docker run --rm -e PW="$ADMIN_PASSWORD" registry-1.docker.io/library/maven:3.9-eclipse-temurin-21 sh -c 'mvn -q dependency:get -Dartifact=org.springframework.security:spring-security-crypto:6.5.6 >/dev/null 2>&1; cat > /tmp/G.java < /tmp/hash +[ "${#$(cat /tmp/hash)}" -eq 60 ] || { echo '哈希生成失败,未写入'; exit 1; } +printf "update app_user set password_hash = '%s' where id=1;\n" "$(cat /tmp/hash)" | docker exec -i myspace_hifox-db-1 psql -U myspace -d myspace +rm -f /tmp/hash +``` + +写完无需重启,下一次登录即生效。 + +## 本机镜像拉取问题 + +2026-11-10 首次测试时,Docker Desktop 全局配置中的镜像加速服务长时间未返回。测试通过 `IMAGE_REGISTRY=registry-1.docker.io` 直接从 Docker Hub 官方仓库拉取成功。项目增加了可选 `IMAGE_REGISTRY` 构建参数和数据库镜像前缀,默认仍为 `docker.io`;未修改 Docker Desktop 全局配置,也未关闭 TLS 校验。 + +首次构建需下载 Maven/JDK、JRE、Node、Nginx 和 PostgreSQL 基础镜像。后续构建复用 Docker 缓存。第一次后端构建下载 logback-classic 时遭遇 Maven Central 读取超时;后端 Dockerfile 已加入 BuildKit Maven 缓存挂载,失败后重试可复用已下载依赖。 + +## 服务维护 + +```sh +# 状态和日志 +docker compose --env-file .local/container-test.env ps +docker compose --env-file .local/container-test.env logs --tail=100 +# 后端健康状态 +docker inspect myspace_hifox-backend-1 --format '{{.State.Health.Status}}' +# 停止并移除容器,保留数据卷 +docker compose --env-file .local/container-test.env down +# 再次启动 +docker compose --env-file .local/container-test.env up -d +``` diff --git a/docs/handoff.md b/docs/handoff.md new file mode 100644 index 0000000..4060564 --- /dev/null +++ b/docs/handoff.md @@ -0,0 +1,32 @@ +# 第一阶段交付 + +工程:`/Users/xzh/Documents/project/MySpace`。原型:`/Users/xzh/Documents/MySpace/prototype`(未修改)。 + +2026-11-10 继续工作时已确认本机前端 `http://localhost:5173` 和后端 `http://localhost:8080/api/v1/auth/csrf` 均返回 HTTP 200。 + +本机开发账户见 `.local/access.md`,此文件权限为 600,整个 `.local` 目录均已被 Git 忽略。业务数据位于 `.local/pgdata`,文件位于 `.local/assets`。请避免将它们删除或作为源码提交。 + +## 阅读入口 +- `README.md`:环境、部署、开发和测试命令,以及已知限制。 +- `docs/implementation-plan.md`:实际原型页面、API、数据表与阶段映射。 +- `docs/api.md`:第一阶段接口与字段。 +- `docs/verification.md`:构建、测试及浏览器验收记录。 +- `output/playwright/`:界面截图及可重复执行的浏览器验收脚本。 + +## 下一阶段 +博客管理已于 2026-11-10 实现(`V2__blogs.sql` + `com.myspace.blogs.BlogsController` + `frontend/src/App.vue` 中的博客页、`BlogArt.vue`),验收见 `docs/verification.md`。书签仍是第二阶段剩余部分,尚未开始。开始前应再次读取原型的 blog、blogForm、bookmarks、bookmark-form 处理逻辑;沿用现有认证和错误处理;使用新增 Flyway V2 迁移,不能更改已应用的 V1。 + +博客需要标题、摘要、Markdown、草稿/发布状态、预览与更新日期;“发布”必须定义可访问的公开阅读入口,不能仅改状态冒充完成。公开入口已实现:`V3__public_blogs.sql`(slug)、`PublicBlogsController`(`/api/v1/public/blogs`)、前端 `PublicBlog.vue`(`/blog`、`/blog/`,由 `main.ts` 按路径选择应用);验收脚本 `.local/public-blog-acceptance.py`。公网访问仍需把该地址部署到域名与 HTTPS 之后。书签需要网址协议校验、名称、描述、分类、搜索、删除和新窗口打开。完成后补充 API 测试、前端交互验收,并更新导航的待开发标记。 + +## Docker 验收补充(2026-11-10) + +容器环境已构建并完成启动、CRUD、上传和重建持久化测试,浏览器验证通过。访问 http://localhost:8088 ,登录信息见 `.local/container-access.md`。它与原有 5173 开发环境数据完全独立。运行步骤和结果见 `docs/container-testing.md`。 + +当日晚间:`compose.yml` 固定项目名 `name: myspace`,后端健康检查通过后才启动前端;已重建镜像并重启为单一栈(`myspace-db-1` / `myspace-backend-1` / `myspace-frontend-1`),V3 迁移已应用,`/blog` 公开页验收 6/6 通过。登录 `admin`,密码为 `.local/container-test.env` 中的 `ADMIN_PASSWORD`(原示例密码已作废)。 + +遗留 / 待确认: +- **当前实际运行的是 `myspace_hifox` 栈**(`myspace_hifox-db-1` / `myspace_hifox-backend-1` / `myspace_hifox-frontend-1`,http://localhost:8088)。工程根目录没有 `compose.yml` 的 `name:` 时,项目名取自目录名,文档里的 `name: myspace` 说明尚未生效,需要时再加。 +- 2026-11-10 重启:从源码重新构建镜像并重建容器,6/6 冒烟通过。`admin` 与 DB 角色密码已与 `.local/container-test.env` 对齐(此前仍是示例值)。 +- 以下卷均未使用、可确认后删除:`myspace_postgres-data`、`myspace_asset-data`(文档假设的栈,从未运行)、`myspace-container-test_postgres-data`、`myspace-container-test_asset-data`(旧测试卷)。`docker volume rm` 会永久删除数据,不要删 `myspace_hifox_*`。 +- db 固定发布到宿主机 5432;与其他 PostgreSQL 冲突时修改 `compose.yml` 的端口映射。 +- 首次启动若直接使用 `.env.example` 示例密码,示例密码同样能登录;建议后续在 `AccountInitializer` 中拒绝示例值。 diff --git a/docs/implementation-plan.md b/docs/implementation-plan.md new file mode 100644 index 0000000..28aa12d --- /dev/null +++ b/docs/implementation-plan.md @@ -0,0 +1,29 @@ +# 原型核对与实施映射 + +核对时间:2026-11-09。原型 `/Users/xzh/Documents/MySpace/prototype/index.html` 为单文件 HTML(内嵌 CSS、SVG、原生 JS),同级仅原型及验证产物,无工程。目标目录 `/Users/xzh/Documents/project/MySpace` 原为空。 +原型 SHA256:`2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24`。仅读取,绝不覆盖。样式及花园 SVG 提取到前端,业务重新以 Vue 实现,不使用原型 localStorage 数据。 + +| 页面/交互 | 第一阶段 API(均 /api/v1)或后续建议 | 数据表 | 阶段 | +|---|---|---|---| +| 初始化、登录、退出 | GET auth/csrf,POST auth/login,GET auth/me,POST auth/logout | app_user | 1 | +| 工作台数量、最近笔记、存储使用 | GET dashboard | notes、assets 聚合 | 1 | +| 知识库新增、搜索、分类、收藏、Markdown 编辑/导出/删除 | GET/POST notes,GET/PUT/DELETE notes/{id} | notes(版本号防覆盖) | 1 | +| 文件拖放、分类、名称搜索、预览、原件下载、删除 | GET/POST assets,GET assets/{id}/content,DELETE assets/{id} | assets + 独立磁盘卷 | 1 | +| 博客草稿、发布、预览 | GET/POST blogs,GET/PUT/DELETE blogs/{id},状态字段 draft/published | blogs(V2) | 2 已实现 | +| 公开博客阅读 | GET /public/blogs,GET /public/blogs/{slug}(匿名只读,仅已发布),前端 `/blog` 与 `/blog/` | blogs.slug(V3) | 2 已实现 | +| 导航书签 | bookmarks CRUD(名称、描述、分类、搜索、删除、http(s) 校验) | bookmarks(V5) | 2 已实现 | +| RSS 订阅、阅读、收藏笔记 | feeds、articles、refresh(待实现,需抓取地址防 SSRF) | feeds/articles(计划) | 3 | +| 效率中心:待办、日历、片段 | tasks/events/snippets(待实现) | 对应三表(计划) | 3 | +| AI 问答、检索 | conversations/messages(待实现) | conversations/messages(计划) | 4 | +| 知识图谱:双链、分类关系 | graph(待实现) | note_links(计划) | 4 | +| 系统设置、备份恢复、外部存储 | settings/backup(待实现) | settings(计划) | 5 | + +## 阶段与验收 +1. 工程及真实纵向闭环:Java 21 / Spring Boot 3,按 auth、notes、assets、dashboard 分包的模块化单体;PostgreSQL + Flyway;Vue 3 / TS / Vite / Element Plus。验证认证、CSRF、CRUD、版本冲突、文件刷新可读、工作台聚合和构建。空库无示例业务记录。会话 Cookie,密码 BCrypt;初始化凭据来自环境。文件私有,下载必须登录。 +2. 博客和书签;补充发布/撤回与链接校验测试。(2026-11-10:博客管理、公开博客页与导航书签已实现;公网域名/HTTPS 入口需单独部署。) +3. RSS、待办日历、代码片段;实现调度、抓取防护、幂等及日期时区测试。 +4. AI 与知识图谱;明确模型配置、费用边界、引用来源及真实双链关系。 +5. 系统设置、备份恢复、存储适配;完成灾难恢复演练和部署加固。 + +## 视觉与交互取舍 +保留 224px 侧栏、73px 顶栏、绿色花园欢迎区、卡片、四栏统计、笔记双栏编辑/预览、拖放上传、手机布局和深色主题。未开发的模块显示“尚未实现”,工作台不显示模拟待办、RSS、博客或书签数字。主题仅为当前浏览器偏好,不冒充后端设置。第一阶段为手动保存(离开提示),自动保存、编辑格式工具、双链导航留作后续增强。搜索范围明确限定笔记及资产。 diff --git a/docs/v4-development.md b/docs/v4-development.md new file mode 100644 index 0000000..f9f556d --- /dev/null +++ b/docs/v4-development.md @@ -0,0 +1,90 @@ +# MySpace V4 开发交接 + +更新:2026-11-11。本文是新版 UI、交互和后续任务的入口。现有接口以代码为准,[API 文档](api.md)记录现有契约,[历史交接](handoff.md)和[原计划](implementation-plan.md)供追溯。下文保留 V4 全量目标。当前工程已实现后台导航及工具子路由、工作台、四个内容模块、统一回收站、笔记版本、RSS 手动刷新、效率中心、收集箱、备份和 AI Studio。模型能力由部署配置启用。访客生成和定时工作流仍待开放。 + +## 1. 参考与取舍 + +原型目录:`/Users/xzh/Documents/MySpace/MySpace_修复版_V4`。保持四个 HTML 与两个 JS 在同一目录;从 `MySpace-管理后台.html` 打开,在右上角「公开发布」同步,再从后台分别打开三张公开页。对照时建议以同一个本地静态站点提供四页,避免不同浏览器对直接打开文件时的存储行为影响判断。 + +| 原型文件 | 开发参考 | +|---|---| +| `MySpace-管理后台.html` | 后台页面、工具中心、发布中心、各模块联动;以最后加载的 V4 修复层及实际事件为准 | +| `MySpace_Public_Blog.html` | 公开博客列表、分类、搜索、阅读详情、订阅入口 | +| `MySpace_Public_Nav.html` | 公开导航分组、链接卡片与主题 | +| `MySpace_Public_AI.html` | 对话/生图入口、模型选择、提示词书架、访客会话和公开图片 | +| `myspace-client.js`、`admin_router.js` | 浏览器快照、主题、错误提示和原型路由参考 | +| `README_修复说明_V4.md` | 变更和历史验收线索;末尾「公开页面导航调整」覆盖正文的旧互跳描述 | + +**公开页独立。** 后台可进入博客、导航和 AI,三张公开页均不放其他公开页或后台的入口(包括移动菜单和浮动入口)。保留各自业务导航、主题切换和发布状态。 + +**复刻交互,重写数据层。** 原型用 localStorage 在同浏览器同步,且包含模拟 AI、RSS 示例和叠加事件处理。正式版沿用 Vue/TypeScript、Spring Boot、PostgreSQL、Flyway、登录 Cookie 与 CSRF。业务记录和发布结果以服务器为准;本地只保存主题、视图偏好、可清除的访客会话等。生产空状态与加载失败独立呈现,不混入示例文章、模型或订阅。 + +## 2. 页面范围及实现差距 + +| 页面 | V4 目标及开发切入点 | +|---|---| +| 工作台 | 沿用已有统计和最近笔记;补快捷收集、待办摘要、通知和发布状态。计数来自实际记录。 | +| 知识库 | 现有笔记 CRUD、分类、收藏、Markdown 编辑与预览继续使用。新增文件夹、多标签、网格/列表、筛选排序、批量操作、模板、双链/反链及图谱;编辑器补 AI 助手、配图、版本与导出。分类与文件夹是两个维度。 | +| 博客 | 复用现有草稿/已发布、Markdown、摘要、封面和 slug;补分类、图床/生成封面、从笔记建草稿、转笔记、公开预览。公开 URL 沿用 `/blog`、`/blog/:slug`。 | +| 图床 | 复用真实上传、预览、下载。新增图片/文件视图、文件夹、标签、批量移动/删除、详情与复制链接/Markdown。私有素材使用认证地址;公开素材使用受发布范围约束的稳定地址。 | +| 书签 | 已有新增、删除、分类和图床图标;补编辑、收藏、多标签、手动顺序、列表/卡片、批量操作、浏览器 HTML/JSON 导入导出、公开勾选。沿用 `/bookmarks`;仅接受 HTTP(S) 网址,导入先预览去重并显示跳过原因。 | +| RSS | 新增订阅源、分类、抓取状态、阅读器、已读/收藏、搜索和批量标记;文章可存笔记、待办、收集箱或发给 AI 摘要。删除订阅保留已抓取内容。 | +| 效率中心 | 新增待办、日历、代码片段。待办支持完成和状态筛选;日程可创建、编辑、删除;代码片段可编辑、复制。 | +| AI Studio | 新增对话、生图、供应商、模型、历史、素材库、提示词、用量、日志、偏好。历史区分对话/图片,素材库区分全部/收藏;模型失效时清理失效筛选和默认项,区分未生成与未收藏。 | +| 工具中心 | 七个入口:标签管理、版本历史、回收站、批量管理、自动化工作流、浏览器工具、联动说明。以真实计数和状态展示,另提供收集箱、全局搜索、公开发布入口。自动化和浏览器工具的服务端能力分期,未接通时说明限制。 | +| 收集箱 | 新增手动快速收集及浏览器捕捉入口,记录标题、内容/网址、来源和处理状态;整理成笔记、书签或待办。 | +| 设置 | 新增资料、主题与编辑偏好、备份导入导出。导入先校验版本和预览影响;缺失模块不注入样例。凭据不随备份导出,附件备份是否包含文件须在界面说明。 | +| 公开博客 | 复用 `PublicBlog.vue`,补 V4 分类、更多分类、搜索和发布状态;搜索与分类可叠加,详情支持直接打开和返回。RSS 入口只在真实订阅地址就绪后启用。 | +| 公开导航 | 复用 `PublicBookmarks.vue`,按公开分类和顺序展示,空分组不渲染;统一绿色系与深浅色,保留网址访问和图标失败回退。 | +| 公开 AI | 新增建议路径 `/ai`。欢迎页、模型选择、提示词填入、对话/生图、访客历史搜索与回看、公开图集;真实能力未就绪时明确禁用。 | + +后台主导航按 V4 顺序:工作台 → 知识库 → 博客 → 图床 → 书签 → RSS → 效率中心 → AI Studio → 工具中心 → 收集箱 → 设置。工具中心子页用独立路由状态;父入口、子页名称、面包屑、页面标题和浏览器返回一致。现有后台入口继续可达,管理深链可采用 `/admin/...`,确认前端回退配置并保留原入口。搜索弹窗支持 Cmd/Ctrl+K,结果按类型携带稳定 ID,进入对应详情而非仅切换模块;覆盖笔记、博客、素材、书签、RSS、待办、日程、代码片段、提示词、AI 会话和图片,未交付的模块随其上线纳入。 + +## 3. 关键流程和数据规则 + +### 公开发布 + +- **现状**:公开博客直接读已发布文章;公开书签接口及图标接口目前没有可见性过滤,所有现有书签可被匿名列出。V4 原型首次发布可能默认全选书签,发布函数传入全量提示词开关,空模型白名单也可能回退到全部。正式版不继承这些默认行为。 +- **目标**:发布面板列出符合条件的文章,允许明确勾选书签、提示词、模型及图片,并设置访客生图。新建书签/提示词/图片默认私有,空白名单代表关闭全部模型,生图默认关闭。发布前预览数量,显示最近成功时间及「有改动待同步」,支持导出同一份公开数据 JSON。 +- **建议契约**:`GET /api/v1/publication` 返回待发布预览、当前发布版本、时间和差异;`POST /api/v1/publication` 按预览版本原子提交,只生成允许公开的字段与资源引用,返回新版本和各模块数量。公开接口保留原路径和可兼容字段,以服务器发布版本作为 ETag 的一部分。发布失败保留旧版本并显示原因。草稿化、取消公开、移入回收站、禁用模型或关闭生图立即在服务端撤销可见性/执行权;恢复只回私有区或草稿,重新公开需显式操作。 +- **迁移**:升级前列出现有公开博客、书签及图片引用。已有已发布博客可作为首版基线保留原 slug;现有书签在管理员明确勾选前不进入新发布清单。切换时同时替换匿名列表、详情和图片的权限条件;验证清空选择、缓存更新、直接访问旧图标地址和无登录的新设备。公开响应不得含供应商凭据、内部日志或未选内容。 + +### 回收站与版本 + +- 笔记、博客、书签、图床素材、日程、代码片段的单条及批量删除统一进回收站。现有四类 DELETE 需改为软删除;所有常规列表、搜索、计数和公开读取排除已删除。图床保留文件字节直到永久删除;有活跃引用的素材永久删除前显示影响并拒绝操作,待引用解除后重试。 +- 建议保留源记录及 ID,增加删除时间并用统一回收站视图查询;`GET /api/v1/trash` 支持按类型分页,`POST /api/v1/trash/{kind}/{id}/restore` 恢复,`DELETE /api/v1/trash/{kind}/{id}` 永久删除。原分类/文件夹还在则回原位置,缺失则提示选择替代位置;恢复失败保留记录,成功写入通知。清空需要明确确认与逐项结果。 +- 笔记的有效保存(含自动保存)在同一事务中记录保存前的标题、正文、分类、文件夹、标签等,再提交正文与版本号;无变化不生成重复快照。历史使用不可变版本 ID,可按笔记分页查询/预览。恢复前再存当前版本,使用现有乐观锁;冲突返回 409 并保留编辑稿。编辑器两个导出入口生成相同 UTF-8 Markdown,YAML 用序列化器处理标题、标签、换行和特殊字符。保留策略独立配置,不沿用原型数组截断作为生产规则。 + +### 模块联动与 AI + +- RSS → 笔记、待办、收集箱;笔记 → 博客草稿,博客 → 可编辑笔记;书签 → 收集箱(含网址和描述),素材 → 收集箱(元数据和内部引用);收集箱 → 笔记/书签/待办。保留来源 ID 或链接,创建成功后才更新收集状态,重试不重复创建。完成后提供打开目标入口。 +- 笔记 AI 助手、笔记配图、博客封面和 RSS 摘要进入对应 AI 模式并预填提示词;引用卡片按 ID 打开原文,再返回时保留对话和未发送草稿。生成结果经用户选择可存图床并作为封面;生成过程不自动发布或修改正文。 +- 输入限制统一为 8000 字符;后台按原型在预填/提交前提示并提供截断后的可编辑预览,访客侧超限显示计数、禁用发送;后端按相同计数规则校验并拒绝超限。访客发送时重新校验模型 ID、供应商及能力开关,公开接口只返回可展示字段。凭据仅后端保存;AI 失败保留草稿,日志和用量只记录必要字段,访客调用设置频率、用量限制和超时。访客历史与管理员会话隔离。 +- RSS 抓取、AI 服务和工作流接入前,UI 只展示可用能力。正式 RSS 刷新显示成功时间与失败状态,按来源和文章标识去重;自动化执行和工具接入后单独定义权限、运行记录与失败恢复。 + +## 4. 实施顺序 + +| 批次 | 工作包与交付条件 | +|---|---| +| A:发布边界和 UI 骨架 | 统一后台壳、工具入口、三张公开页入口规则;完成公开书签和图片过滤、发布面板及发布版本;改造已存在的公开博客/导航并保留旧链接。AI 页可先显示能力关闭状态。 | +| B:现有模块完整流程 | 笔记、博客、图床、书签扩展字段和编辑交互;同批接入统一回收站、笔记版本与 Markdown 导出。验证现有库升级、分类和原 slug。 | +| C:新增本地业务 | 收集箱、效率中心、标签/批量、通知、全局搜索、备份;补齐笔记/博客/素材/书签之间的联动。新增模块随交付接入搜索与回收站。 | +| D:外部服务 | RSS 订阅与真实抓取、AI Studio 与公开 AI、用量与日志、自动化和浏览器工具的后端接入。分别验证权限、失败恢复与实际调用;按能力开放。 | + +开发入口:`frontend/src/main.ts` 负责公开页入口,`App.vue` 是现有后台,`api.ts` 是接口层;按模块拆出页面与状态,复用 Markdown 和素材组件。后端沿用现有 controller、认证及集成测试,从下一未使用的 Flyway 版本开始(当前目录最大 V16)。迁移新增字段先回填再约束;保留现有 UUID、slug、分类关系和文件引用。不改已应用 SQL。不自动导入 HTML 原型示例;若后续需要迁移真实原型数据,应走带校验和预览的显式导入,包含旧回收站按类型和源 ID 去重。 + +## 5. 验收清单 + +| 编号 | 验收场景 | +|---|---| +| V4-01 | 工具中心七个入口均打开对应页面;面包屑、高亮、浏览器返回和刷新后的路由一致;无重复一级导航。 | +| V4-02 | 六种支持对象单条删除、各支持模块批量删除后,从列表、搜索及公开页消失;恢复保持 ID 和分类或明确要求重选;永久删除后不可恢复。 | +| V4-03 | 自动和手动保存分别产生有效历史,无变化不重复;可预览、恢复且恢复前留档;并发冲突不覆盖另一稿。两个导出入口能下载并解析含特殊字符的 YAML。 | +| V4-04 | 在无登录的新浏览器验证已发布文章、选中书签/提示词/图片和白名单模型;草稿、未选内容、直链图片及空模型名单不泄露。失败保留原发布版本,撤回后重新请求拿不到旧内容。 | +| V4-05 | 公开博客分类与搜索组合可用,详情直链和返回正常;公开导航分组正常;三张公开页均无互跳或后台入口,后台仍可打开三页。 | +| V4-06 | AI 历史/素材筛选可切换;禁用模型后默认项修正;无生成/无收藏状态不同;8000 和 8001 字符边界前后端一致;关闭生图后访客既不能从 UI 发送也不能直接调用。 | +| V4-07 | 笔记引用回原文后返回 AI 草稿仍在;配图/封面预填正确;搜索同名结果打开各自 ID;RSS/收集箱转存失败后仍可重试且不重复创建。 | +| V4-08 | 按 1150、900、680、430px 断点两侧及 360px 检查工具中心、编辑器、设置、AI 和三张公开页;深浅色、键盘焦点、弹窗关闭后焦点恢复、错误提示可见、页面无横向溢出。 | +| V4-09 | 用空库和已有数据各跑一次迁移;已有公开文章 slug、登录、笔记、上传下载继续工作。备份导入预览及错误分支不改原有数据。 | + +每批在后端集成测试覆盖访问权限、迁移和状态变化,在浏览器验收端到端关键流程。原型 README 中的 24 项后台和 7 项公开页通过记录仅作为原型历史,不能替代工程验收;当前实现范围见工程 README。 diff --git a/docs/verification.md b/docs/verification.md new file mode 100644 index 0000000..1d07b75 --- /dev/null +++ b/docs/verification.md @@ -0,0 +1,77 @@ +# 第一阶段验收记录 + +日期:2026-11-09,Mac 本地执行。Java 21.0.10、Maven 3.9.12、Node 24.14.0、独立 PostgreSQL 16、Chromium。 + +## 自动验证 + +- 后端 `mvn verify`:3 组真实 PostgreSQL 集成测试通过(认证/CSRF、笔记与冲突、私有文件生命周期)。 +- 前端 `npm test`:2 项 Markdown 安全预览测试通过。 +- 前端 `npm run build`:TypeScript 校验和 Vite 构建通过;JavaScript 约 299 KB(gzip 约 110 KB)。 +- `npm audit`:0 已知漏洞。此结果只针对此次锁定的前端依赖及当时的公告数据库。 +- Flyway 从空库成功创建 app_user / notes / assets;开发业务库无内置示例记录。 + +## 浏览器验证 + +`output/playwright/check-live.js` 为 Playwright CLI 的 run-code 验收脚本,针对本机临时验收账号。可通过技能的 CLI 在运行中的本机站点执行;它会创建并删除特定测试记录,勿直接用于含同名记录的业务库。 + +通过:真实登录,新增笔记、Markdown 预览、脚本清理、保存、刷新持久化、未保存离开保护、收藏、删除;文本文件上传、页面刷新后再次打开、原件下载和删除;手机导航、主题切换。过程无 JavaScript pageerror。匿名首次访问 `/auth/me` 的 401 是预期的登录状态探测。 + +已人工查看截图: +- `output/playwright/prototype-desktop.png` 原始原型工作台。 +- `output/playwright/app-desktop.png` 实现后的 1440px 工作台。 +- `output/playwright/app-editor.png` 双栏笔记编辑器。 +- `output/playwright/app-mobile-editor.png` 390px 手机编辑器。 +- `output/playwright/app-mobile.png` 手机工作台。 +- `output/playwright/app-dark.png` 手机深色工作台。 + +390px 编辑器和工作台检查页面宽度均未溢出。原型与实现复用了布局、色彩、CSS、侧栏图标及花园插画;真实空状态替代原型演示数据。 + +原型 SHA256 在开始与结束均为 `2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24`,未改动原文件。 + +## 尚未验证/尚未实现 + +- Docker 构建与 Compose 启动已于 2026-11-10 补充实测通过,见下方新增记录。 +- 未测试所有浏览器、并发压力、大规模数据、备份恢复、公网部署。 +- 博客、书签、RSS、效率中心、AI、图谱和系统设置均未实现,导航和工作台相关区块明确标注。 +- 第一阶段仅手动保存笔记;自动保存、格式快捷工具条和双链导航尚未迁移。 + +## 2026-11-10 容器补充验收 + +Docker Desktop 4.99.0,Docker Engine 29.9.3,Compose v5.7.0,Linux ARM64。前后端均从源码在容器内构建成功。独立项目 `myspace-container-test` 使用单独数据库及资产数据卷,未改动本机开发数据。 + +- PostgreSQL 16.15 健康检查通过;Flyway V1 成功应用。 +- 后端以 UID 10001 运行;上传目录可写,文件删除后物理文件数为 0。 +- 创建阶段 18 项检查通过,包含认证、CSRF、笔记搜索/收藏/分类/版本冲突、文本和 PNG 文件、15 MB 上限、空文件拒绝、工作台聚合及文件访问权限。 +- 三个容器全部强制重建(已确认三个容器 ID 均变化),保留命名卷。验证阶段 10 项检查通过;笔记内容及版本不变,两个文件的 SHA256 不变。 +- 清理仅删除验收脚本创建的记录;最后账户 1 个,笔记 0 条,资产 0 条,磁盘资产文件 0 个。 +- Chromium 通过真实 Nginx 入口验证登录、工作台、知识库、文件页面和退出;无 JavaScript pageerror。截图:`output/playwright/container-desktop.png`。 +- 既有本机开发前端 5173 端口仍返回 200。 + +首次构建遇到镜像加速地址无响应和一次 Maven 依赖超时;通过项目级官方仓库选项及 Maven 缓存后重试成功,未改动 Docker 全局配置。复现命令及维护步骤见 [容器验收](container-testing.md)。 + +## 2026-11-10 博客管理(第二阶段部分) + +按原型 `/Users/xzh/Documents/MySpace/prototype/index.html`(SHA256 仍为 `2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24`,只读)的 `blog()`、`blogForm()`、`preview-blog`、`blog-form` 分支实现。 + +- 后端 `mvn verify`:4 组集成测试通过,新增 `blogLifecycleStatusAndConflict`(默认草稿、发布切换后筛选、搜索、版本冲突 409、非法 status 400、未登录 403、删除与 404)。 +- 前端 `npm test`:4 项通过(新增原始 HTML 媒体/容器标签移除、http(s) 图片保留)。 +- 前端 `npm run build`:TypeScript 校验 + Vite 构建通过。 +- Flyway:测试库与开发库均从 V1 升到 V2;用新 JAR 在独立 `myspace_test` 库启动一次验证迁移幂等。 +- 浏览器验收(Chrome headless,真实登录,1440px 与 390px):39 项全部通过,覆盖新建默认草稿、编辑改标题并发布、刷新后保留、全部/草稿/已发布筛选与徽标一致、页内搜索(标题/正文/空态)、阅读预览 Markdown 渲染与 XSS 清理、全局搜索命中文章并打开预览、删除后刷新仍不存在、390px 无横向溢出、无 JavaScript 运行时错误。验收数据已清理。 +- 截图:`output/playwright/blog-list.png`、`blog-form.png`、`blog-preview.png`、`blog-mobile.png`。 + +与原型的有意差异(均在任务要求范围内):新增「删除文章」与摘要必填校验(原型没有删除,摘要为 `required`);编辑弹窗区分「写一篇新文章 / 编辑文章」标题,而原型复用同一标题;正文 Markdown 使用知识库同一渲染器,因此标题、列表、引用、代码与笔记一致,并移除原始 HTML 中的 img/script/iframe 等标签(原型把原始 HTML 当文本);状态徽标文案为「草稿 · 不公开 / 已发布 · 公开」(公开博客页加入后更新);卡片按 9 篇分页,避免超过 9 篇时失去封面配色循环。原型中的页内搜索框在博客页启用;状态筛选在前端本地完成(与原型一致),列表一次最多拉取 100 篇。 + +## 2026-11-10 公开博客页 + +需求:发布后需要一个公开的博客页面展示已发布的文章。 + +- 后端 `mvn verify`:5 组集成测试通过。新增 `publicBlogOnlyExposesPublishedAndIgnoresSession`:slug 生成与同名去重、中文/纯数字标题回退 `article`、匿名可读、只含已发布、草稿 slug 与不存在 slug 同为 404、响应不含 id/version、管理接口仍要求登录、ETag 条件请求返回 304。 +- 前端:`vue-tsc` 通过,`vitest` 5 项通过(新增外部链接 `target=_blank` + `rel=noopener noreferrer`),`npm run build` 通过(JS 316 KB / gzip 115 KB)。 +- Flyway:开发库与测试库从 V2 升到 V3(`V3__public_blogs.sql` 回填历史文章 slug,唯一索引 + 已发布部分索引)。 +- 浏览器验收(Chrome headless): + - `.local/public-blog-acceptance.py` 24/24:管理端发布 → 卡片出现公开入口与「复制 / 打开」→ 复制写入剪贴板 → 新标签页打开公开页;**全新无 Cookie 的浏览器上下文**打开 `/blog`,列表含已发布、不含草稿、无登录框;进入文章后 URL 为 `/blog/`、Markdown 渲染、` \ No newline at end of file diff --git a/frontend/nginx.conf b/frontend/nginx.conf new file mode 100644 index 0000000..e210e2d --- /dev/null +++ b/frontend/nginx.conf @@ -0,0 +1,8 @@ +server { + listen 80; + server_name _; + root /usr/share/nginx/html; + client_max_body_size 16m; + location /api/ { proxy_pass http://backend:8080; proxy_read_timeout 115s; proxy_set_header Host $http_host; proxy_set_header X-Forwarded-Proto $scheme; } + location / { try_files $uri $uri/ /index.html; } +} diff --git a/frontend/package-lock.json b/frontend/package-lock.json new file mode 100644 index 0000000..3025558 --- /dev/null +++ b/frontend/package-lock.json @@ -0,0 +1,2571 @@ +{ + "name": "myspace-frontend", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "myspace-frontend", + "version": "0.1.0", + "dependencies": { + "dompurify": "^3.3.0", + "element-plus": "^2.11.5", + "marked": "^16.4.1", + "vue": "^3.5.22" + }, + "devDependencies": { + "@vitejs/plugin-vue": "^6.0.1", + "jsdom": "^29.1.1", + "typescript": "~5.9.3", + "vite": "^7.1.12", + "vitest": "^5.1.0", + "vue-tsc": "^3.1.1" + } + }, + "node_modules/@asamuzakjp/css-color": { + "version": "5.1.11", + "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-5.1.11.tgz", + "integrity": "sha512-KVw6qIiCTUQhByfTd78h2yD1/00waTmm9uy/R7Ck/ctUyAPj+AEDLkQIdJW0T8+qGgj3j5bpNKK7Q3G+LedJWg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@asamuzakjp/generational-cache": "^1.0.1", + "@csstools/css-calc": "^3.2.0", + "@csstools/css-color-parser": "^4.1.0", + "@csstools/css-parser-algorithms": "^4.0.0", + "@csstools/css-tokenizer": "^4.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/@asamuzakjp/dom-selector": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/@asamuzakjp/dom-selector/-/dom-selector-7.1.1.tgz", + "integrity": "sha512-67RZDnYRc8H/8MLDgQCDE//zoqVFwajkepHZgmXrbwybzXOEwOWGPYGmALYl9J2DOLfFPPs6kKCqmbzV895hTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@asamuzakjp/generational-cache": "^1.0.1", + "@asamuzakjp/nwsapi": "^2.3.9", + "bidi-js": "^1.0.3", + "css-tree": "^3.2.1", + "is-potential-custom-element-name": "^1.0.1" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/@asamuzakjp/generational-cache": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@asamuzakjp/generational-cache/-/generational-cache-1.0.1.tgz", + "integrity": "sha512-wajfB8KqzMCN2KGNFdLkReeHncd0AslUSrvHVvvYWuU8ghncRJoA50kT3zP9MVL0+9g4/67H+cdvBskj9THPzg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/@asamuzakjp/nwsapi": { + "version": "2.3.9", + "resolved": "https://registry.npmjs.org/@asamuzakjp/nwsapi/-/nwsapi-2.3.9.tgz", + "integrity": "sha512-n8GuYSrI9bF7FFZ/SjhwevlHc8xaVlb/7HmHelnc/PZXBD2ZR49NnN9sMMuDdEGPeeRQ5d0hqlSlEpgCX3Wl0Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.13", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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/@bramus/specificity": { + "version": "2.4.3", + "resolved": "https://registry.npmjs.org/@bramus/specificity/-/specificity-2.4.3.tgz", + "integrity": "sha512-0GEz8qJWokkUVYQYRukmkSHIFNoBH8QTreeHrAFbvz1XFYc3Y+puhMs8PQ5x8GNugiC2l5jvDBXKLbBIByeSBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "css-tree": "^3.2.1" + }, + "bin": { + "specificity": "bin/cli.js" + } + }, + "node_modules/@csstools/color-helpers": { + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.1.2.tgz", + "integrity": "sha512-grhRy3OKmniaAEKXMjua5z/EODX0MSqBGjunw8+j/3HQjOnahs2AGhvEOIYVUWcU6ScApbhLhVrQTX8XqrMrow==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT-0", + "engines": { + "node": ">=20.19.0" + } + }, + "node_modules/@csstools/css-calc": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-3.4.3.tgz", + "integrity": "sha512-iex20d8CHVkyvg6B7UKV7uHnI2Bqo9g+EFfT9E0y+GvTvhZ/DwONJ+9aKb1dlqm0ZiGsL5RXjp0fCoJYnkeDjA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=20.19.0" + }, + "peerDependencies": { + "@csstools/css-parser-algorithms": "^4.0.2", + "@csstools/css-tokenizer": "^4.0.2" + } + }, + "node_modules/@csstools/css-color-parser": { + "version": "4.2.7", + "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-4.2.7.tgz", + "integrity": "sha512-zgm9yjQz5iJB4VL8RyVwd71TWB8Q89FSxt/NzXoWqPSkEBOVtn9L6vAPtSc9hpKfB0Awo/AL2VKFHjYetBLFHQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "dependencies": { + "@csstools/color-helpers": "^6.1.2", + "@csstools/css-calc": "^3.4.3" + }, + "engines": { + "node": ">=20.19.0" + }, + "peerDependencies": { + "@csstools/css-parser-algorithms": "^4.0.2", + "@csstools/css-tokenizer": "^4.0.2" + } + }, + "node_modules/@csstools/css-parser-algorithms": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-4.0.2.tgz", + "integrity": "sha512-40cSKyMvK+tq4qz6Awrlye2WGuOKt3FwPgtGg6KTfbHOWNw+Rk1rzbAtZnZ6IBhsY491HLRnDXwoyBAijmmILA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=20.19.0" + }, + "peerDependencies": { + "@csstools/css-tokenizer": "^4.0.2" + } + }, + "node_modules/@csstools/css-syntax-patches-for-csstree": { + "version": "1.1.16", + "resolved": "https://registry.npmjs.org/@csstools/css-syntax-patches-for-csstree/-/css-syntax-patches-for-csstree-1.1.16.tgz", + "integrity": "sha512-LsDbJPP/B8cPasUJyTA5S99F7C4G93ngW8hUluXz8CFeOaaRnBPtBiIlvgcPYU0HmHNz8CXg+1vwFrIB4F6Dgw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT-0", + "peerDependencies": { + "css-tree": "^3.2.1" + }, + "peerDependenciesMeta": { + "css-tree": { + "optional": true + } + } + }, + "node_modules/@csstools/css-tokenizer": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-4.0.2.tgz", + "integrity": "sha512-OoKoR0f76dCY666JlcbhmVTs2drYj1GUXZTYTcbUgJjh9Nv41aFfZ21bPQTERm5+L5cBDo466NltB2lplS5GBw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/csstools" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/csstools" + } + ], + "license": "MIT", + "engines": { + "node": ">=20.19.0" + } + }, + "node_modules/@ctrl/tinycolor": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz", + "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz", + "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz", + "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz", + "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz", + "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz", + "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz", + "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz", + "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz", + "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz", + "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz", + "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz", + "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz", + "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz", + "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz", + "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz", + "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz", + "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz", + "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz", + "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz", + "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz", + "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz", + "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz", + "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz", + "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz", + "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz", + "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@exodus/bytes": { + "version": "1.16.0", + "resolved": "https://registry.npmjs.org/@exodus/bytes/-/bytes-1.16.0.tgz", + "integrity": "sha512-IcpW84uEn3N7ETtNZMlxKhfl6Pec8rUNGOTBtWbK1FKhJxIFAptZyVrvVRVBimAJxJCgc3PxepxkdWWG4DVzfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + }, + "peerDependencies": { + "@noble/hashes": "^1.8.0 || ^2.0.0" + }, + "peerDependenciesMeta": { + "@noble/hashes": { + "optional": true + } + } + }, + "node_modules/@floating-ui/core": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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.npmjs.org/@floating-ui/utils/-/utils-0.2.12.tgz", + "integrity": "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww==", + "license": "MIT" + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@popperjs/core": { + "name": "@sxzz/popperjs-es", + "version": "2.11.8", + "resolved": "https://registry.npmjs.org/@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/@rolldown/pluginutils": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.1.0.tgz", + "integrity": "sha512-K+NU2HDCEem4sClgHH4ZZXwdJeNFkJo+hRk479DIwdIviAPN2hFJH1KHHwg8CxHQXvi0M5XY4deTXINfIiSG6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.68.1.tgz", + "integrity": "sha512-67xgK/taQ7w18anfSxH4dy3RVwiu7GFT8aZglHVUnYisqIe4Qf1xQW7hWxe3lB7R5XSVfPJJKdKP31eGMID2zw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.68.1.tgz", + "integrity": "sha512-nGmSABuQDWUGPgGOy3VJygaIQl9/2SMPEwwR2+W+uTxit+MoZcve1y2ebaO9Dhg/MZXMeeoYL+HPGq8X5LTzgg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-x64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-x64/-/rollup-android-x64-4.68.1.tgz", + "integrity": "sha512-Es4xgvucd6umxthid6WojNNYHLsfB6oySkLypUn4VXxR7IuK2TS2sdPB6+3U/mw/uU7ahQk9aw7fDUI6y2GkKA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.68.1.tgz", + "integrity": "sha512-biPWTUPYDWejnysuD4A1kJ4mjT121duL6WJ8JJ0lyFWuLSnC91WF6C/X63CSz7z8yJIQEXixlHOpPK/VzPQ3Gw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.68.1.tgz", + "integrity": "sha512-EhxsI1TfSp3Lvyc9W6Y4o9W/zR43zaUgDsENK3hCix/OP/jrGc1CAxNhgmA28SJTsODpAv9ZBYYgP1rO27dfRA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.68.1.tgz", + "integrity": "sha512-p6s+MBrmkj41sOH4no/z1g/5E446H9//kUblCvZY/uy+NWijHT+0/F6sAcRqI3l3RWLyeW6kHl0IqZ0+p3VjrA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.68.1.tgz", + "integrity": "sha512-sm2K6aFA1tn+5gH59LLsm3SbNJ736cXOZ3IcpmxsUxuAEn6h04LFKWk3ji/Jjw1IEDdZ8QhgdxLPzGHnnOD4fg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.68.1.tgz", + "integrity": "sha512-kirHmtPRCh5dVC6v8/9i/ldS60r6TYLiGunHCXpba/4ws1SPyvdW4PYkRLOxpAfYC+A9r2Km2zOLpm4cMty1Rg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.68.1.tgz", + "integrity": "sha512-TR1ec0+aZylxhD9/4UkelsSiCQ5EhtHjzty0LXKiMwwyWa4rgF55bIGExYqxp/+BwCH4GEV8F/EZB9JYwLDTdw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.68.1.tgz", + "integrity": "sha512-dxsv4BC45+TGKImva8fIgVdvuJ1/o2Bov+sGjPX/RFcDp/UtXNJ7K5/6UTS0fbAw0P7kTIvH5M0h6ViS5CP9xQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.68.1.tgz", + "integrity": "sha512-/ATJPUYJUdlm1/Zil0IyU9x14zyBXicfoOvNbvHAUH4c8IjU5xNBCtnDteTD+xd08Ym6fdGVrdZLLThYRvsZOw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.68.1.tgz", + "integrity": "sha512-Bp17x/tj1Fi45pNE4A654jkKAiSUgB6UjQuPltwT+e2jfYw7TfaYzQNGgbzx0MNH27eYQDNVUNxGk9m9L/xUaA==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.68.1.tgz", + "integrity": "sha512-QvECQp0CyvIhiAv9mn1ouYZfIcDBIRdZek7M/ZYqRtiWzpiKAPu2gnGD13yNtI0KykSPk41szQitphAbHfHdvQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.68.1.tgz", + "integrity": "sha512-+ACzFhkXUiYvXLebVBb4ge8gr7EKM/xGDW+J8cmnwv8SSlYyoKXD8Es3OpOPFnHLV5vevmrqlQgCP/qQxr69JQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.68.1.tgz", + "integrity": "sha512-/wMEhoQ0Ithx4CrmhMogO57CKyt0LRB+2A7i97v+GjBDGLh+uhTNNSlIm1NixaTEwMXyiIIZ3bXVkSh4jfAhKg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.68.1.tgz", + "integrity": "sha512-N92PYV7Ulw6pOS16eE32Q/ykWSj2ly+ojYX/IHCsD9+FIj7n10qjeiPhdht7r8UTnCpYdmrGf7VeNonovOvuQQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.68.1.tgz", + "integrity": "sha512-ab332+PwM7/sgbqRlE0BYb2eGNme8Rs1T/2Ob9mYSwrQqK7a1zawpLVYrXtnnRBPQn4TNGGtwaBy6toClPU7aQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.68.1.tgz", + "integrity": "sha512-zaQ2AHQP401CBAa+qhWLLTGU78MQ6nsB0RfWYbw5+AUWNLjp9juAokzZbjtyiXf7CBe8JfBNV7g2lNwbxmLKFg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.68.1.tgz", + "integrity": "sha512-J2KJofHPtGP7AZQUbRfylo7f1ZKdSjY2XG5VXjDwh+Mu2oM/bJN53mDWSjBGzNU3AGaXBqIxIhEAa0tSHQdO6w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.68.1.tgz", + "integrity": "sha512-WMXzHCmeAhFpAwP2w3ugGucdDp5jYJm8fwLO1e9uUtUQXhceWGfobu1E+seQ/zSixxGB+foAX8cs3iiebF+QjA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.68.1.tgz", + "integrity": "sha512-PZadv8s8G/omPyl31lvtraKxlM//Ad0P32kLBBHGjImR31vCXZkiDNqnIQCZ6gXTZ5xN5GkTGhzZdJzMz3EOnw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.68.1.tgz", + "integrity": "sha512-eXI1iou+f8g5iJFGnF9koInoopknJdulR51phO8ggVNGyTT2Ya68M7scDLYpIOTWaTN9cDPxRJ1o0d6ce/P2cQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.68.1.tgz", + "integrity": "sha512-la8czh2p2DlfCC+/XgVbxItS01f2/1ljPSy+U/Z1j5sWtlQv+Ammx04gP2w5MZWsGuKD/r85cTWudlASulQMEw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.68.1.tgz", + "integrity": "sha512-WMc++sC1YObbiuITB73IYD6Neejvz0591glNh9kpJj2ZUA3YkwtYzVVXXkADyyGhttdJkJndR/dd4XKKxCHO+A==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.68.1.tgz", + "integrity": "sha512-jDDAn+OoI7R63WRCsJDMLa9v4Qii/zTrnstftTy8+1kVZpZBJFSF6K6PDyot51Wh9wTcjh0zUU9dHztVNo1+uw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.68.1.tgz", + "integrity": "sha512-kR8W3osyXy6mB3EaaTsC2FTAdgqZgRsOXXs31aIvC/KjbxeMqDon9l3Xyajo1ynQuS1JHlMhkYyqL10VKA3VZw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/chai": { + "version": "5.2.3", + "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz", + "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/deep-eql": "*", + "assertion-error": "^2.0.1" + } + }, + "node_modules/@types/deep-eql": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz", + "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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.npmjs.org/@types/lodash-es/-/lodash-es-4.17.12.tgz", + "integrity": "sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==", + "license": "MIT", + "dependencies": { + "@types/lodash": "*" + } + }, + "node_modules/@types/trusted-types": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz", + "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==", + "license": "MIT", + "optional": true + }, + "node_modules/@types/web-bluetooth": { + "version": "0.0.21", + "resolved": "https://registry.npmjs.org/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz", + "integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==", + "license": "MIT" + }, + "node_modules/@vitejs/plugin-vue": { + "version": "6.0.10", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-6.0.10.tgz", + "integrity": "sha512-b80aUQh3n+qEzzZm5oQp3rT2QImeCx58K6eFl/RkJ3d65KW0kTuv5lNsLRVAjbW9YRUpo/wzmvzMgV34bTAItA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@rolldown/pluginutils": "^1.0.1" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "peerDependencies": { + "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0", + "vue": "^3.2.25 || ^3.6.0-rc.10" + } + }, + "node_modules/@vitest/mocker": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.1.0.tgz", + "integrity": "sha512-5umB9/jlWcqVS6fsrFmv5Gdnpu6wAUio/lEOwAmvB7v+lFo/IW2B9FhAD0p19GCULTgMzLCdUmuCDCnAzWgppQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "0.3.31", + "@vitest/spy": "5.1.0", + "estree-walker": "^3.0.3", + "magic-string": "^1.4.3" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "msw": "^2.4.9 || ^3.0.0", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "msw": { + "optional": true + }, + "vite": { + "optional": true + } + } + }, + "node_modules/@vitest/mocker/node_modules/magic-string": { + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz", + "integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.6.0" + } + }, + "node_modules/@vitest/spy": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.1.0.tgz", + "integrity": "sha512-2DPO5OMHWKrBngC+fCmTQqemNF0gidRhp3lxbBmRhW+M1XJrfgPpqNqWVevXtn2f2ufD5ZaR1B6B641aAlcX5A==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@volar/language-core": { + "version": "2.4.30", + "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.30.tgz", + "integrity": "sha512-73fjwEV8wat6aOZ6U/y/hqtE30ocrIWECg67b0txGczOMNw+MffLmvJ5fnFfN9drVUEYZzLdaNo6VAy6G6avMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/source-map": "2.4.30" + } + }, + "node_modules/@volar/language-service": { + "version": "2.4.30", + "resolved": "https://registry.npmjs.org/@volar/language-service/-/language-service-2.4.30.tgz", + "integrity": "sha512-w/xDsASiqC71ggCOm7sTDXDNk/l72XEptodeRC68tgZ0e5QM4hM3zAqBGC7mBctvhrpYwKfMG+t9xcUo2hEFtA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.30", + "vscode-languageserver-protocol": "^3.17.5", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "typescript": "<7" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@volar/source-map": { + "version": "2.4.30", + "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.30.tgz", + "integrity": "sha512-zym1ob/KwDDyN+0jGVtxwbxJSRRnUvv5HspCtz3yEfVVdCG4/dzxJktMGPAgemqRuVs81O0o/y0q3qOUErR8kg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@volar/typescript": { + "version": "2.4.30", + "resolved": "https://registry.npmjs.org/@volar/typescript/-/typescript-2.4.30.tgz", + "integrity": "sha512-/DgA5tgYFPfrLFuSjIMXMGHk1LQv2+P8eny6+BhGNzFJELWIW7UZlc56ZLIRFhLsPpMfIFxM8/HvOPBggrjTZg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.30", + "@volar/language-service": "2.4.30", + "path-browserify": "^1.0.1", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "typescript": "<7" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@vue/compiler-core": { + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@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-core/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/@vue/compiler-dom": { + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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-sfc/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/@vue/compiler-ssr": { + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@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/language-core": { + "version": "3.3.14", + "resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-3.3.14.tgz", + "integrity": "sha512-kRB+3hHg0c+BdD1XLAvwjVMQd5pC05zijSlPDRI3ERvC/s04JlRs5upy2KjeMg/9m9oD5zuMVh9yVvkKfZqoJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.30", + "@vue/compiler-dom": "^3.5.0", + "@vue/shared": "^3.5.0", + "alien-signals": "^3.2.1", + "muggle-string": "^0.4.1", + "path-browserify": "^1.0.1", + "picomatch": "^4.0.4" + } + }, + "node_modules/@vue/reactivity": { + "version": "3.5.45", + "resolved": "https://registry.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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.npmjs.org/@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/alien-signals": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/alien-signals/-/alien-signals-3.2.1.tgz", + "integrity": "sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==", + "dev": true, + "license": "MIT" + }, + "node_modules/assertion-error": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz", + "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/async-validator": { + "version": "4.2.5", + "resolved": "https://registry.npmjs.org/async-validator/-/async-validator-4.2.5.tgz", + "integrity": "sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==", + "license": "MIT" + }, + "node_modules/bidi-js": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/bidi-js/-/bidi-js-1.1.0.tgz", + "integrity": "sha512-fX1Onk0tdVPC7obPWB5EbJ1z7NVhLq4m2xZLq2YXBkxzMXIGRpNMU88n0EPgWseKl12J7zXs7qrDxPK4sRs2fg==", + "dev": true, + "license": "MIT", + "dependencies": { + "require-from-string": "^2.0.2" + } + }, + "node_modules/chai": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/chai/-/chai-6.3.0.tgz", + "integrity": "sha512-XWAtwJ6OHO+tj0EKCs0Y2UamnyOxseZWltU4x2U2wh8g4AigdjwvtUjvLP2tqkA/avxHEtzxNaqGq/YGNwckKg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/css-tree": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz", + "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==", + "dev": true, + "license": "MIT", + "dependencies": { + "mdn-data": "2.27.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "license": "MIT" + }, + "node_modules/data-urls": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-7.0.0.tgz", + "integrity": "sha512-23XHcCF+coGYevirZceTVD7NdJOqVn+49IHyxgszm+JIiHLoB2TkmPtsYkNWT1pvRSGkc35L6NHs0yHkN2SumA==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-mimetype": "^5.0.0", + "whatwg-url": "^16.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/dayjs": { + "version": "1.11.23", + "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.23.tgz", + "integrity": "sha512-QDTCU0M0MxR3hQfnlDJfwekQiaanm1ubOD231u73WBckQ/fsamwRLiE2GBz6D3a/xF1NgfiDLJjXBa1hYOYTtQ==", + "license": "MIT" + }, + "node_modules/decimal.js": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz", + "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==", + "dev": true, + "license": "MIT" + }, + "node_modules/dompurify": { + "version": "3.4.17", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.17.tgz", + "integrity": "sha512-B/pSlYVHQ58kqISD/yDjuJ1yfzI34m1gF4lAod2bwSRhiN4K5Cl3H8Af7hqB2PmTL911tdEudnnXn5FnhRoz0w==", + "license": "(MPL-2.0 OR Apache-2.0)", + "optionalDependencies": { + "@types/trusted-types": "^2.0.7" + } + }, + "node_modules/element-plus": { + "version": "2.14.8", + "resolved": "https://registry.npmjs.org/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.npmjs.org/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-module-lexer": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.3.2.tgz", + "integrity": "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==", + "dev": true, + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz", + "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.2", + "@esbuild/android-arm": "0.28.2", + "@esbuild/android-arm64": "0.28.2", + "@esbuild/android-x64": "0.28.2", + "@esbuild/darwin-arm64": "0.28.2", + "@esbuild/darwin-x64": "0.28.2", + "@esbuild/freebsd-arm64": "0.28.2", + "@esbuild/freebsd-x64": "0.28.2", + "@esbuild/linux-arm": "0.28.2", + "@esbuild/linux-arm64": "0.28.2", + "@esbuild/linux-ia32": "0.28.2", + "@esbuild/linux-loong64": "0.28.2", + "@esbuild/linux-mips64el": "0.28.2", + "@esbuild/linux-ppc64": "0.28.2", + "@esbuild/linux-riscv64": "0.28.2", + "@esbuild/linux-s390x": "0.28.2", + "@esbuild/linux-x64": "0.28.2", + "@esbuild/netbsd-arm64": "0.28.2", + "@esbuild/netbsd-x64": "0.28.2", + "@esbuild/openbsd-arm64": "0.28.2", + "@esbuild/openbsd-x64": "0.28.2", + "@esbuild/openharmony-arm64": "0.28.2", + "@esbuild/sunos-x64": "0.28.2", + "@esbuild/win32-arm64": "0.28.2", + "@esbuild/win32-ia32": "0.28.2", + "@esbuild/win32-x64": "0.28.2" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/expect-type": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz", + "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/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/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/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/html-encoding-sniffer": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-6.0.0.tgz", + "integrity": "sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@exodus/bytes": "^1.6.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/is-potential-custom-element-name": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz", + "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsdom": { + "version": "29.1.1", + "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-29.1.1.tgz", + "integrity": "sha512-ECi4Fi2f7BdJtUKTflYRTiaMxIB0O6zfR1fX0GXpUrf6flp8QIYn1UT20YQqdSOfk2dfkCwS8LAFoJDEppNK5Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@asamuzakjp/css-color": "^5.1.11", + "@asamuzakjp/dom-selector": "^7.1.1", + "@bramus/specificity": "^2.4.2", + "@csstools/css-syntax-patches-for-csstree": "^1.1.3", + "@exodus/bytes": "^1.15.0", + "css-tree": "^3.2.1", + "data-urls": "^7.0.0", + "decimal.js": "^10.6.0", + "html-encoding-sniffer": "^6.0.0", + "is-potential-custom-element-name": "^1.0.1", + "lru-cache": "^11.3.5", + "parse5": "^8.0.1", + "saxes": "^6.0.0", + "symbol-tree": "^3.2.4", + "tough-cookie": "^6.0.1", + "undici": "^7.25.0", + "w3c-xmlserializer": "^5.0.0", + "webidl-conversions": "^8.0.1", + "whatwg-mimetype": "^5.0.0", + "whatwg-url": "^16.0.1", + "xml-name-validator": "^5.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24.0.0" + }, + "peerDependencies": { + "canvas": "^3.0.0" + }, + "peerDependenciesMeta": { + "canvas": { + "optional": true + } + } + }, + "node_modules/lodash": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/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.npmjs.org/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.npmjs.org/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/lru-cache": { + "version": "11.5.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.3.tgz", + "integrity": "sha512-U4N8FgzmWxc8k1VH8Kr6lQg18U7Fjvby6wXHVRX/ZZ7IwWbRMgrRbP0Wrb5q5NVinryp4SQampHKdvtecItxUg==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/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/marked": { + "version": "16.4.2", + "resolved": "https://registry.npmjs.org/marked/-/marked-16.4.2.tgz", + "integrity": "sha512-TI3V8YYWvkVf3KJe1dRkpnjs68JUPyEa5vjKrp1XEEJUAOaQc+Qj+L1qWbPd0SJuAdQkFU0h73sXXqwDYxsiDA==", + "license": "MIT", + "bin": { + "marked": "bin/marked.js" + }, + "engines": { + "node": ">= 20" + } + }, + "node_modules/mdn-data": { + "version": "2.27.1", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz", + "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==", + "dev": true, + "license": "CC0-1.0" + }, + "node_modules/memoize-one": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/memoize-one/-/memoize-one-6.0.0.tgz", + "integrity": "sha512-rkpe71W0N0c0Xz6QD0eJETuWAJGnJ9afsl1srmwPrI+yBCkge5EycXXbYRyvL29zZVUWQCY7InPRCv3GDXuZNw==", + "license": "MIT" + }, + "node_modules/muggle-string": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/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.npmjs.org/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.npmjs.org/normalize-wheel-es/-/normalize-wheel-es-1.2.0.tgz", + "integrity": "sha512-Wj7+EJQ8mSuXr2iWfnujrimU35R2W4FAErEyTmJoJ7ucwTn2hOUSsRehMb5RSYkxXGTM7Y9QpvPmp++w5ftoJw==", + "license": "BSD-3-Clause" + }, + "node_modules/obug": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/obug/-/obug-3.0.0.tgz", + "integrity": "sha512-5vvB5+W7ePv+p3uqxi+RcW1XAzLW0/hxt3/4X4Lc4qHudzOhmBiBwOY6DRob4WnanAEGvNcLjF+KNOufrUoEQw==", + "dev": true, + "funding": [ + "https://github.com/sponsors/sxzz", + "https://opencollective.com/debug" + ], + "license": "MIT", + "engines": { + "node": ">=12.20.0" + } + }, + "node_modules/parse5": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-8.1.1.tgz", + "integrity": "sha512-EcR/6WDcU7b2N3vQSxKALCk9lXGtUMQxXio008OEMBE0kavu/7JLfBEeFPzi43nMqVDSbEn3QCK+BMCc9zO//w==", + "dev": true, + "license": "MIT", + "dependencies": { + "entities": "^9.0.0" + }, + "funding": { + "url": "https://github.com/inikulin/parse5?sponsor=1" + } + }, + "node_modules/parse5/node_modules/entities": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-9.0.0.tgz", + "integrity": "sha512-oJFNDJg3kTPwAD1cNn2+WmUq4wFoo09npc3Ydf1D7ED4smRiWrsKnaLxykrTWgyGEcusc87P5dxlAleol9kpkg==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=20.19.0" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/path-browserify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/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.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/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/postcss": { + "version": "8.5.32", + "resolved": "https://registry.npmjs.org/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/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/rollup": { + "version": "4.68.1", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.68.1.tgz", + "integrity": "sha512-kjVU1iN2BbQeFPFTpmUtl1bR/DbMl2HPmiSLYpx6XLromTaMkidR+mlRMdS/Doovm6uKlwigyxMcHRhRe1vZ5A==", + "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.1", + "@rollup/rollup-android-arm64": "4.68.1", + "@rollup/rollup-android-x64": "4.68.1", + "@rollup/rollup-darwin-arm64": "4.68.1", + "@rollup/rollup-darwin-x64": "4.68.1", + "@rollup/rollup-freebsd-arm64": "4.68.1", + "@rollup/rollup-freebsd-x64": "4.68.1", + "@rollup/rollup-linux-arm-gnueabihf": "4.68.1", + "@rollup/rollup-linux-arm-musleabihf": "4.68.1", + "@rollup/rollup-linux-arm64-gnu": "4.68.1", + "@rollup/rollup-linux-arm64-musl": "4.68.1", + "@rollup/rollup-linux-loong64-gnu": "4.68.1", + "@rollup/rollup-linux-loong64-musl": "4.68.1", + "@rollup/rollup-linux-ppc64-gnu": "4.68.1", + "@rollup/rollup-linux-ppc64-musl": "4.68.1", + "@rollup/rollup-linux-riscv64-gnu": "4.68.1", + "@rollup/rollup-linux-riscv64-musl": "4.68.1", + "@rollup/rollup-linux-s390x-gnu": "4.68.1", + "@rollup/rollup-linux-x64-gnu": "4.68.1", + "@rollup/rollup-linux-x64-musl": "4.68.1", + "@rollup/rollup-openbsd-x64": "4.68.1", + "@rollup/rollup-openharmony-arm64": "4.68.1", + "@rollup/rollup-win32-arm64-msvc": "4.68.1", + "@rollup/rollup-win32-ia32-msvc": "4.68.1", + "@rollup/rollup-win32-x64-gnu": "4.68.1", + "@rollup/rollup-win32-x64-msvc": "4.68.1", + "fsevents": "~2.3.2" + } + }, + "node_modules/saxes": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz", + "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==", + "dev": true, + "license": "ISC", + "dependencies": { + "xmlchars": "^2.2.0" + }, + "engines": { + "node": ">=v12.22.7" + } + }, + "node_modules/source-map-js": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/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/std-env": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.3.0.tgz", + "integrity": "sha512-OtU/EgQ1kIm5KwqQpBC6ZEMXrZRui11w8zgfTWp8cdO9B8OaPsbA8bTHO2P+HNo1VlUTGMVBwPhydu6poeXiag==", + "dev": true, + "license": "MIT" + }, + "node_modules/symbol-tree": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz", + "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinybench": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-6.2.3.tgz", + "integrity": "sha512-Al01C2JIBnO2CXCAPbpAl6sUiOZHeThGtHYNTa51JRw9PyWOCdr+9Ong05R4qg/Sk3+H645E8ov1h2c58ityNw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/tinyexec": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.1.tgz", + "integrity": "sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/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/tldts": { + "version": "7.4.19", + "resolved": "https://registry.npmjs.org/tldts/-/tldts-7.4.19.tgz", + "integrity": "sha512-48dH6aSpQnpbzDUc4vIQZ1VjB8tkK+e8c1yx05/SZK+rkssgjEOlxDd/yU8/a4vGYQ9vRgJr9dwMq9TJ0b3X2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "tldts-core": "^7.4.19" + }, + "bin": { + "tldts": "bin/cli.js" + } + }, + "node_modules/tldts-core": { + "version": "7.4.20", + "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-7.4.20.tgz", + "integrity": "sha512-C630TWXZCZmLq0F2bW4QqwnaaxCQ/svpAqvJwnC4JvgEM5ohhBnGsEzTLSOXcN+xjz+kEaHS5uoWIw2klnqd0A==", + "dev": true, + "license": "MIT" + }, + "node_modules/tough-cookie": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-6.1.0.tgz", + "integrity": "sha512-FTxc8u8Kl2tz0Lat1u8ksvcy8bwHRyEMawwTWybo51JqaC6O7SvfuhAKg+Ld6VqyIe2QRJBzY9HA7y2WyFRT2w==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "tldts": "^7.0.5" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/tr46": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-6.0.0.tgz", + "integrity": "sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==", + "dev": true, + "license": "MIT", + "dependencies": { + "punycode": "^2.3.1" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "devOptional": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici": { + "version": "7.30.2", + "resolved": "https://registry.npmjs.org/undici/-/undici-7.30.2.tgz", + "integrity": "sha512-mLyPQnHwUxaM/rideoK/+KL8DaAJLRl4aBCfmX444aCSLnIaomqPLtNRe2jdCYcsk5wZzXrDIQC8ZeYNRAYyIA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.18.1" + } + }, + "node_modules/vite": { + "version": "7.3.7", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.7.tgz", + "integrity": "sha512-AHEzTORMbi7/7aXp7w7KZ5+DCUdSeLsJz0grY8xHpc9DHdYb0vQu6DqJfm2tOw3gDExNgPgnJTXxM6syYFHaCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.27.0 || ^0.28.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "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/vitest": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.1.0.tgz", + "integrity": "sha512-MzmNFnrwa8v8lF1bLxw3UJ4EREwVOVb75VqJZmUDRjJ6EluK/x9th7qTbaeDk41WxE1GxWqmTXcdsfobfH5sOA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/chai": "^5.2.2", + "@vitest/mocker": "5.1.0", + "chai": "^6.3.0", + "es-module-lexer": "^2.3.2", + "expect-type": "^1.4.0", + "magic-string": "^1.4.3", + "obug": "^3.0.0", + "picomatch": "^4.0.7", + "std-env": "^4.3.0", + "tinybench": "^6.2.2", + "tinyexec": "^1.3.1", + "tinyglobby": "^0.2.17", + "why-is-node-running": "3.2.1" + }, + "bin": { + "vitest": "vitest.mjs" + }, + "engines": { + "node": "^22.12.0 || ^24.0.0 || >=26.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@edge-runtime/vm": "*", + "@opentelemetry/api": "^1.9.0", + "@types/node": "^22.0.0 || >=24.0.0", + "@vitest/browser-playwright": "5.1.0", + "@vitest/browser-preview": "5.1.0", + "@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0", + "@vitest/coverage-istanbul": "5.1.0", + "@vitest/coverage-v8": "5.1.0", + "@vitest/ui": "5.1.0", + "happy-dom": "*", + "jsdom": "*", + "vite": "^6.4.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "@edge-runtime/vm": { + "optional": true + }, + "@opentelemetry/api": { + "optional": true + }, + "@types/node": { + "optional": true + }, + "@vitest/browser-playwright": { + "optional": true + }, + "@vitest/browser-preview": { + "optional": true + }, + "@vitest/browser-webdriverio": { + "optional": true + }, + "@vitest/coverage-istanbul": { + "optional": true + }, + "@vitest/coverage-v8": { + "optional": true + }, + "@vitest/ui": { + "optional": true + }, + "happy-dom": { + "optional": true + }, + "jsdom": { + "optional": true + }, + "vite": { + "optional": false + } + } + }, + "node_modules/vitest/node_modules/magic-string": { + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz", + "integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.6.0" + } + }, + "node_modules/vscode-jsonrpc": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-10.0.0.tgz", + "integrity": "sha512-USSfxg0vDIpTQqlQBGxF3mBARyoS8cU7LHLpbYNh6dOJt32dlskxPWB0Irrh5TllTmyf7oNLAvqDqzklbwwnpA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.17.0" + } + }, + "node_modules/vscode-languageserver-protocol": { + "version": "3.18.5", + "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.18.5.tgz", + "integrity": "sha512-FW4fBMzZ99N8xeob4py0l050wgCoRgTpEq5Xcsb9lM1bc29UKGR/wSV+4knaqFxssFHajy7OzNiKP/m3U1ZEuA==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-jsonrpc": "10.0.0", + "vscode-languageserver-types": "3.18.5" + } + }, + "node_modules/vscode-languageserver-textdocument": { + "version": "1.0.16", + "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.16.tgz", + "integrity": "sha512-qeNEuOi9a3qkqRf7Gfez2WL2VwlBTLCNekHBGO9kxPVUp9XuY15yfTJ9jwvOwKI0I2MhUUfZq95NSp+LK1CLQg==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-languageserver-types": { + "version": "3.18.5", + "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.18.5.tgz", + "integrity": "sha512-kPd6+JQNz3HMJvjKlqUxERSlZHAntl/aGpsk7ImwIh0ewDKDcjgAEyVSYciPiOJD3ftbK9IrfiqUeTZLSbCizw==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-uri": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/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.npmjs.org/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.npmjs.org/vue-component-type-helpers/-/vue-component-type-helpers-3.3.14.tgz", + "integrity": "sha512-Pq3+OnbCiPCHk0R7KSZrx+j/XXaUn2kSQ1epxq60w8CPbByLjC1EJgV51n4WY851sTXUVzsNMuitywdkdVyKjA==", + "license": "MIT" + }, + "node_modules/vue-tsc": { + "version": "3.3.14", + "resolved": "https://registry.npmjs.org/vue-tsc/-/vue-tsc-3.3.14.tgz", + "integrity": "sha512-URAu2H9AuMZMg9GCgnqbaHHHd8pBZRAwNV2e2yYS8VDsoTVXHiOSo663OS6DkEvauQ2yixn5TPFJ9WV9QIspkA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/typescript": "2.4.30", + "@vue/language-core": "3.3.14" + }, + "bin": { + "vue-tsc": "bin/vue-tsc.js" + }, + "peerDependencies": { + "typescript": ">=5.0.0" + } + }, + "node_modules/w3c-xmlserializer": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz", + "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==", + "dev": true, + "license": "MIT", + "dependencies": { + "xml-name-validator": "^5.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/webidl-conversions": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-8.0.1.tgz", + "integrity": "sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=20" + } + }, + "node_modules/whatwg-mimetype": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-5.0.0.tgz", + "integrity": "sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + } + }, + "node_modules/whatwg-url": { + "version": "16.0.1", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-16.0.1.tgz", + "integrity": "sha512-1to4zXBxmXHV3IiSSEInrreIlu02vUOvrhxJJH5vcxYTBDAx51cqZiKdyTxlecdKNSjj8EcxGBxNf6Vg+945gw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@exodus/bytes": "^1.11.0", + "tr46": "^6.0.0", + "webidl-conversions": "^8.0.1" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=24.0.0" + } + }, + "node_modules/why-is-node-running": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-3.2.1.tgz", + "integrity": "sha512-Tb2FUhB4vUsGQlfSquQLYkApkuPAFQXGFzxWKHHumVz2dK+X1RUm/HnID4+TfIGYJ1kTcwOaCk/buYCEJr6YjQ==", + "dev": true, + "license": "MIT", + "bin": { + "why-is-node-running": "cli.js" + }, + "engines": { + "node": ">=20.11" + } + }, + "node_modules/xml-name-validator": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz", + "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18" + } + }, + "node_modules/xmlchars": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz", + "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==", + "dev": true, + "license": "MIT" + } + } +} diff --git a/frontend/package.json b/frontend/package.json new file mode 100644 index 0000000..2441d6d --- /dev/null +++ b/frontend/package.json @@ -0,0 +1,25 @@ +{ + "name": "myspace-frontend", + "private": true, + "version": "0.1.0", + "type": "module", + "scripts": { + "dev": "vite --host 127.0.0.1", + "build": "vue-tsc --noEmit && vite build", + "test": "vitest run" + }, + "dependencies": { + "dompurify": "^3.3.0", + "element-plus": "^2.11.5", + "marked": "^16.4.1", + "vue": "^3.5.22" + }, + "devDependencies": { + "@vitejs/plugin-vue": "^6.0.1", + "jsdom": "^29.1.1", + "typescript": "~5.9.3", + "vite": "^7.1.12", + "vitest": "^5.1.0", + "vue-tsc": "^3.1.1" + } +} diff --git a/frontend/src/AdminAiStudio.vue b/frontend/src/AdminAiStudio.vue new file mode 100644 index 0000000..a59b30c --- /dev/null +++ b/frontend/src/AdminAiStudio.vue @@ -0,0 +1,288 @@ + + + diff --git a/frontend/src/BlogArt.vue b/frontend/src/BlogArt.vue new file mode 100644 index 0000000..c7d41d5 --- /dev/null +++ b/frontend/src/BlogArt.vue @@ -0,0 +1,24 @@ + + diff --git a/frontend/src/BlogCover.vue b/frontend/src/BlogCover.vue new file mode 100644 index 0000000..21b1e20 --- /dev/null +++ b/frontend/src/BlogCover.vue @@ -0,0 +1,13 @@ + + + diff --git a/frontend/src/BlogImagePicker.vue b/frontend/src/BlogImagePicker.vue new file mode 100644 index 0000000..0708b09 --- /dev/null +++ b/frontend/src/BlogImagePicker.vue @@ -0,0 +1,57 @@ + + + diff --git a/frontend/src/BookmarkIcon.vue b/frontend/src/BookmarkIcon.vue new file mode 100644 index 0000000..4e99d30 --- /dev/null +++ b/frontend/src/BookmarkIcon.vue @@ -0,0 +1,13 @@ + + + diff --git a/frontend/src/BookmarkTransfer.vue b/frontend/src/BookmarkTransfer.vue new file mode 100644 index 0000000..89ce7ba --- /dev/null +++ b/frontend/src/BookmarkTransfer.vue @@ -0,0 +1,152 @@ + + + diff --git a/frontend/src/CategoryManager.vue b/frontend/src/CategoryManager.vue new file mode 100644 index 0000000..a2597e2 --- /dev/null +++ b/frontend/src/CategoryManager.vue @@ -0,0 +1,45 @@ + + + diff --git a/frontend/src/Garden.vue b/frontend/src/Garden.vue new file mode 100644 index 0000000..bf88bfd --- /dev/null +++ b/frontend/src/Garden.vue @@ -0,0 +1,45 @@ + diff --git a/frontend/src/Icon.vue b/frontend/src/Icon.vue new file mode 100644 index 0000000..dc6eed0 --- /dev/null +++ b/frontend/src/Icon.vue @@ -0,0 +1,5 @@ + + \ No newline at end of file diff --git a/frontend/src/LibraryCategories.vue b/frontend/src/LibraryCategories.vue new file mode 100644 index 0000000..6a72406 --- /dev/null +++ b/frontend/src/LibraryCategories.vue @@ -0,0 +1,80 @@ + + + diff --git a/frontend/src/LibraryInbox.vue b/frontend/src/LibraryInbox.vue new file mode 100644 index 0000000..6c15345 --- /dev/null +++ b/frontend/src/LibraryInbox.vue @@ -0,0 +1,100 @@ + + diff --git a/frontend/src/LibraryTrash.vue b/frontend/src/LibraryTrash.vue new file mode 100644 index 0000000..d4977a6 --- /dev/null +++ b/frontend/src/LibraryTrash.vue @@ -0,0 +1,64 @@ + + + diff --git a/frontend/src/LibraryWorkspace.vue b/frontend/src/LibraryWorkspace.vue new file mode 100644 index 0000000..d46ef0a --- /dev/null +++ b/frontend/src/LibraryWorkspace.vue @@ -0,0 +1,326 @@ + + + diff --git a/frontend/src/NoteGraph.vue b/frontend/src/NoteGraph.vue new file mode 100644 index 0000000..2e60545 --- /dev/null +++ b/frontend/src/NoteGraph.vue @@ -0,0 +1,77 @@ + + diff --git a/frontend/src/NoteHistory.vue b/frontend/src/NoteHistory.vue new file mode 100644 index 0000000..37a3570 --- /dev/null +++ b/frontend/src/NoteHistory.vue @@ -0,0 +1,72 @@ + + diff --git a/frontend/src/PublicAi.vue b/frontend/src/PublicAi.vue new file mode 100644 index 0000000..f1287cb --- /dev/null +++ b/frontend/src/PublicAi.vue @@ -0,0 +1,115 @@ + + +