docs(changelog): add v2.7.4 and v2.8.0 release notes

This commit is contained in:
saltbo
2026-07-24 14:54:59 -04:00
parent ae9273ce01
commit ef78e20261
7 changed files with 381 additions and 0 deletions
+59
View File
@@ -1,3 +1,62 @@
## v2.8.0 — 2026-07-24 · Admin analytics & operations
### Features
- **Admin analytics dashboard** — live operational cards and trustworthy hourly
rollups for storage, traffic, users, shares, remote downloads, and background
jobs, including trend charts, coverage indicators, and backfill tooling.
- **Storage operations** — redesigned backend management with provider presets,
connection testing and request previews, usage projections by category, file
location tracking, and safer cleanup workflows.
- **Spaces and quota** — workspace settings now separate members, services,
billing, and image hosting, with clearer quota ownership and cross-space file
operations.
- **Public profiles and shares** — redesigned public pages can feature curated
shares directly on a user's profile.
- **WebDAV administration** — service controls and optional custom domains, with
automatic domain derivation and verification.
- **API and events** — complete OpenAPI coverage with Scalar documentation,
consistent resource schemas and errors, plus a unified SSE stream that
replaces frontend polling.
- **More refinements** — admin user/team activity feeds, improved audit filters,
remote-download event timelines, NFO previews, configurable email
verification, and a remembered last sign-in method.
### Fixes
- Reworked remote-downloader supervision, heartbeat recovery, seeding, retries,
credit pre-authorization, progress reporting, and cleanup.
- Analytics now uses bounded, completed rollups and explicitly shows incomplete
history instead of silently mixing partial or live data.
- Fixed upload metadata for non-ASCII filenames and synchronized stored content
types after upload.
- Improved Finder WebDAV compatibility, active-folder protection, dialog
overflow, and collapsible folder navigation.
> **Breaking changes:** API endpoints and response shapes are now consistently
> resource-oriented; errors use a unified format, delete operations return
> `204 No Content`, and status transitions use resource status endpoints.
> Landing-page shares are now publicly accessible by default unless explicitly
> configured as private.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### Features
- Loopback and LAN origins are trusted automatically without
`TRUSTED_ORIGINS`.
- Cloud license pairing now has clearer configuration, errors, and confirmation.
- Coupon codes can be entered during checkout.
### Fixes
- Eliminated cross-request session initialization hangs and added a faster
client-side session cache.
- Non-ASCII upload filenames are now safe in `Content-Disposition`.
- Duplicate checkout attempts automatically cancel the stale pending order.
- Default quota values are handled correctly in the admin form.
- Failed D1 queries now log their underlying cause chain.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### Features
+60
View File
@@ -1,3 +1,63 @@
## v2.8.0 — 2026-07-24 · Analítica y operaciones de administración
### Funcionalidades
- **Panel analítico de administración** — tarjetas operativas en vivo y
agregados horarios fiables para almacenamiento, tráfico, usuarios, recursos
compartidos, descargas remotas y tareas en segundo plano, con tendencias,
indicadores de cobertura y herramientas de relleno histórico.
- **Operaciones de almacenamiento** — gestión de backends rediseñada con
preajustes de proveedor, pruebas de conexión, vistas previas de solicitudes,
proyecciones de uso por categoría, ubicación de archivos y limpieza segura.
- **Espacios y cuota** — los ajustes del espacio separan miembros, servicios,
facturación y alojamiento de imágenes, con propiedad de cuota y operaciones
entre espacios más claras.
- **Perfiles y recursos públicos** — las páginas públicas rediseñadas pueden
mostrar recursos compartidos seleccionados en el perfil del usuario.
- **Administración WebDAV** — controles del servicio y dominios personalizados
opcionales, con derivación y verificación automáticas.
- **API y eventos** — cobertura OpenAPI completa con documentación Scalar,
esquemas y errores coherentes, y un flujo SSE unificado que sustituye el sondeo.
- **Más mejoras** — actividad de usuarios/equipos en administración, mejores
filtros de auditoría, cronologías de descargas remotas, vista previa NFO,
verificación de correo configurable y recuerdo del último método de acceso.
### Correcciones
- Revisión de la supervisión, recuperación por heartbeat, siembra, reintentos,
preautorización de créditos, progreso y limpieza del descargador remoto.
- La analítica usa agregados delimitados y completos, y muestra el historial
incompleto en vez de mezclar silenciosamente datos parciales o en vivo.
- Corrección de metadatos de subida para nombres no ASCII y sincronización del
tipo de contenido almacenado después de la subida.
- Mejor compatibilidad WebDAV con Finder, protección de carpetas activas,
desbordamiento de diálogos y navegación plegable por carpetas.
> **Cambios incompatibles:** las rutas y respuestas de la API ahora están
> orientadas a recursos; los errores usan un formato unificado, las eliminaciones
> devuelven `204 No Content` y los cambios de estado usan endpoints de estado.
> Los recursos con página de presentación son públicos por defecto salvo que se
> configuren explícitamente como privados.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### Funcionalidades
- Los orígenes de loopback y LAN se confían automáticamente sin
`TRUSTED_ORIGINS`.
- El emparejamiento de licencia en la nube ofrece configuración, errores y
confirmación más claros.
- Se pueden introducir cupones durante el pago.
### Correcciones
- Eliminados los bloqueos de inicialización de sesión entre solicitudes y
añadida una caché de sesión del cliente más rápida.
- Los nombres no ASCII ahora son seguros en `Content-Disposition`.
- Los pagos duplicados cancelan automáticamente el pedido pendiente obsoleto.
- Los valores de cuota predeterminados se procesan correctamente en administración.
- Los fallos de consultas D1 registran toda la cadena de causas.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### Funcionalidades
+52
View File
@@ -1,3 +1,55 @@
## v2.8.0 — 2026-07-24 · 管理分析と運用
### 新機能
- **管理分析ダッシュボード** — ストレージ、トラフィック、ユーザー、共有、
リモートダウンロード、バックグラウンドジョブを対象としたライブ運用カードと
信頼性の高い時間単位ロールアップ。トレンド、カバレッジ表示、バックフィル
ツールも備えます。
- **ストレージ運用** — プロバイダープリセット、接続テスト、リクエストプレビュー、
カテゴリ別使用量予測、ファイル配置追跡、安全なクリーンアップを備えた管理画面。
- **スペースとクォータ** — ワークスペース設定をメンバー、サービス、請求、
画像ホスティングに整理し、クォータ所有権とスペース間操作を明確化。
- **公開プロフィールと共有** — 公開ページを刷新し、厳選した共有をユーザーの
プロフィールへ直接掲載できます。
- **WebDAV 管理** — サービス制御と任意のカスタムドメイン、自動導出・検証に対応。
- **API とイベント** — Scalar ドキュメント付きの完全な OpenAPI、統一された
リソーススキーマとエラー、フロントエンドのポーリングを置き換える SSE ストリーム。
- **その他の改善** — 管理者向けユーザー/チーム活動、監査フィルター、
リモートダウンロード履歴、NFO プレビュー、メール認証設定、前回のログイン方法の記憶。
### 修正
- リモートダウンローダーの監視、heartbeat 復旧、シード、再試行、
クレジット事前承認、進捗報告、クリーンアップを全面的に改善。
- 分析は範囲が確定した完了済みロールアップのみを使用し、不完全な履歴を
部分データやライブデータと混在させず明示するようになりました。
- 非 ASCII ファイル名のアップロードメタデータと、アップロード後の保存済み
Content-Type 同期を修正。
- Finder の WebDAV 互換性、使用中フォルダの保護、ダイアログのオーバーフロー、
フォルダツリーの折りたたみを改善。
> **破壊的変更:** API のパスとレスポンスをリソース指向に統一しました。
> エラー形式も統一され、削除は `204 No Content` を返し、状態遷移には
> リソースの status エンドポイントを使用します。ランディングページ形式の共有は、
> 明示的に非公開へ設定しない限り、デフォルトで公開アクセス可能になりました。
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### 新機能
- `TRUSTED_ORIGINS` なしで loopback と LAN のオリジンを自動的に信頼。
- クラウドライセンスのペアリングで設定、エラー、確認手順を明確化。
- チェックアウト時にクーポンコードを入力可能。
### 修正
- リクエスト間のセッション初期化停止を解消し、高速なクライアントキャッシュを追加。
- 非 ASCII のアップロードファイル名を `Content-Disposition` で安全に処理。
- 重複チェックアウト時に古い保留中の注文を自動キャンセル。
- 管理フォームでデフォルトのクォータ値を正しく処理。
- D1 クエリ失敗時に根本原因のチェーンを記録。
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### 新機能
+50
View File
@@ -1,3 +1,53 @@
## v2.8.0 — 2026-07-24 · 관리자 분석 및 운영
### 기능
- **관리자 분석 대시보드** — 저장소, 트래픽, 사용자, 공유, 원격 다운로드,
백그라운드 작업을 위한 실시간 운영 카드와 신뢰할 수 있는 시간별 롤업을
제공하며 추세, 데이터 범위 표시, 백필 도구를 포함합니다.
- **저장소 운영** — 공급자 프리셋, 연결 테스트, 요청 미리보기, 범주별 사용량
예측, 파일 위치 추적, 안전한 정리 흐름을 갖춘 새 백엔드 관리 화면.
- **공간과 할당량** — 워크스페이스 설정을 구성원, 서비스, 결제, 이미지 호스팅으로
분리하고 할당량 소유권과 공간 간 파일 작업을 명확하게 정리했습니다.
- **공개 프로필과 공유** — 새 공개 페이지에서 선별한 공유를 사용자 프로필에
직접 표시할 수 있습니다.
- **WebDAV 관리** — 서비스 제어와 선택적 사용자 지정 도메인, 자동 도메인
파생 및 검증을 지원합니다.
- **API 및 이벤트** — Scalar 문서를 포함한 완전한 OpenAPI, 일관된 리소스
스키마와 오류, 프런트엔드 폴링을 대체하는 통합 SSE 스트림.
- **추가 개선** — 관리자 사용자/팀 활동, 향상된 감사 필터, 원격 다운로드
이벤트 타임라인, NFO 미리보기, 이메일 인증 설정, 마지막 로그인 방식 기억.
### 수정
- 원격 다운로더의 감독, heartbeat 복구, 시딩, 재시도, 크레딧 사전 승인,
진행률 보고와 정리 기능을 전면 개선했습니다.
- 분석은 범위가 명확하고 완료된 롤업만 사용하며, 불완전한 이력을 부분 또는
실시간 데이터와 섞지 않고 명확히 표시합니다.
- 비 ASCII 파일명의 업로드 메타데이터와 업로드 후 저장된 콘텐츠 유형 동기화를 수정했습니다.
- Finder WebDAV 호환성, 활성 폴더 보호, 대화상자 넘침, 폴더 트리 접기를 개선했습니다.
> **호환성이 깨지는 변경:** API 경로와 응답이 리소스 중심으로 통일되었습니다.
> 오류는 통합 형식을 사용하고 삭제는 `204 No Content`를 반환하며 상태 변경은
> 리소스 상태 엔드포인트를 사용합니다. 랜딩 페이지 공유는 명시적으로 비공개로
> 설정하지 않는 한 기본적으로 공개됩니다.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### 기능
- `TRUSTED_ORIGINS` 없이 loopback 및 LAN origin을 자동으로 신뢰합니다.
- 클라우드 라이선스 페어링의 구성, 오류, 확인 절차가 더 명확해졌습니다.
- 결제 중 쿠폰 코드를 입력할 수 있습니다.
### 수정
- 요청 간 세션 초기화 멈춤을 제거하고 더 빠른 클라이언트 세션 캐시를 추가했습니다.
- 비 ASCII 업로드 파일명을 `Content-Disposition`에서 안전하게 처리합니다.
- 중복 결제 시 오래된 대기 주문을 자동으로 취소합니다.
- 관리자 양식에서 기본 할당량 값을 올바르게 처리합니다.
- D1 쿼리 실패 시 근본 원인 체인을 기록합니다.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### 기능
+56
View File
@@ -1,3 +1,59 @@
## v2.8.0 — 2026-07-24 · Análises e operações administrativas
### Recursos
- **Painel analítico administrativo** — cartões operacionais ao vivo e
agregações horárias confiáveis para armazenamento, tráfego, usuários,
compartilhamentos, downloads remotos e tarefas em segundo plano, com
tendências, cobertura dos dados e ferramentas de preenchimento histórico.
- **Operações de armazenamento** — gestão de backends reformulada com presets
de provedores, teste de conexão, prévia de requisições, projeção de uso por
categoria, localização de arquivos e limpeza segura.
- **Espaços e cota** — as configurações separam membros, serviços, cobrança e
hospedagem de imagens, com propriedade de cota e operações entre espaços mais claras.
- **Perfis e compartilhamentos públicos** — páginas públicas renovadas podem
exibir compartilhamentos selecionados diretamente no perfil do usuário.
- **Administração WebDAV** — controles do serviço e domínios personalizados
opcionais, com derivação e verificação automáticas.
- **API e eventos** — cobertura OpenAPI completa com documentação Scalar,
esquemas e erros consistentes e um fluxo SSE unificado que substitui o polling.
- **Mais melhorias** — atividade de usuários/equipes na administração, filtros
de auditoria, linha do tempo de downloads remotos, prévia NFO, verificação de
e-mail configurável e memorização do último método de login.
### Correções
- Reformulada a supervisão, recuperação por heartbeat, semeadura, repetição,
pré-autorização de créditos, progresso e limpeza do downloader remoto.
- As análises usam apenas agregações delimitadas e concluídas e mostram
históricos incompletos em vez de misturar dados parciais ou ao vivo.
- Corrigidos os metadados de upload para nomes não ASCII e a sincronização do
tipo de conteúdo armazenado após o upload.
- Melhor compatibilidade WebDAV com Finder, proteção de pastas ativas,
transbordamento de diálogos e navegação recolhível por pastas.
> **Mudanças incompatíveis:** rotas e respostas da API agora são orientadas a
> recursos; erros usam um formato unificado, exclusões retornam `204 No Content`
> e mudanças de estado usam endpoints de status. Compartilhamentos com landing
> page agora são públicos por padrão, salvo configuração explícita como privados.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### Recursos
- Origens de loopback e LAN são confiáveis automaticamente sem `TRUSTED_ORIGINS`.
- O pareamento da licença em nuvem tem configuração, erros e confirmação mais claros.
- Cupons podem ser inseridos durante o checkout.
### Correções
- Eliminadas travas na inicialização de sessão entre requisições, com um cache
de sessão do cliente mais rápido.
- Nomes não ASCII agora são seguros em `Content-Disposition`.
- Checkouts duplicados cancelam automaticamente o pedido pendente obsoleto.
- Valores padrão de cota são tratados corretamente no formulário administrativo.
- Falhas de consultas D1 registram toda a cadeia de causas.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### Recursos
+58
View File
@@ -1,3 +1,61 @@
## v2.8.0 — 2026-07-24 · Аналитика и эксплуатация
### Возможности
- **Панель аналитики для администраторов** — оперативные карточки и надёжные
почасовые сводки по хранилищу, трафику, пользователям, общим ресурсам,
удалённым загрузкам и фоновым задачам, включая тренды, покрытие данных и бэкфилл.
- **Управление хранилищами** — обновлённый интерфейс с шаблонами провайдеров,
проверкой подключения, предпросмотром запросов, прогнозом использования по
категориям, учётом расположения файлов и безопасной очисткой.
- **Пространства и квоты** — настройки разделены на участников, сервисы,
биллинг и хостинг изображений; владение квотой и операции между пространствами
стали понятнее.
- **Публичные профили и общий доступ** — обновлённые публичные страницы позволяют
показывать избранные общие ресурсы прямо в профиле пользователя.
- **Администрирование WebDAV** — управление сервисом и необязательные собственные
домены с автоматическим определением и проверкой.
- **API и события** — полное покрытие OpenAPI с документацией Scalar, единые
схемы ресурсов и ошибок, а также общий SSE-поток вместо опроса с фронтенда.
- **Другие улучшения** — ленты активности пользователей и команд в админке,
фильтры аудита, хронология удалённых загрузок, просмотр NFO, настраиваемая
проверка email и запоминание последнего способа входа.
### Исправления
- Полностью переработаны контроль удалённого загрузчика, восстановление heartbeat,
сидирование, повторы, предварительная авторизация кредитов, прогресс и очистка.
- Аналитика использует только ограниченные и завершённые сводки и явно показывает
неполную историю вместо скрытого смешивания частичных и текущих данных.
- Исправлены метаданные загрузки для имён с не-ASCII символами и синхронизация
сохранённого типа контента после загрузки.
- Улучшены совместимость WebDAV с Finder, защита активных папок, переполнение
диалогов и сворачиваемая навигация по папкам.
> **Несовместимые изменения:** маршруты и ответы API теперь единообразно
> ориентированы на ресурсы; ошибки используют общий формат, удаление возвращает
> `204 No Content`, а смена состояния выполняется через status-маршруты.
> Общие ресурсы с лендингом теперь публичны по умолчанию, если явно не указана
> приватность.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### Возможности
- Loopback- и LAN-источники автоматически считаются доверенными без
`TRUSTED_ORIGINS`.
- Для привязки облачной лицензии улучшены настройка, сообщения об ошибках и подтверждение.
- При оформлении заказа можно вводить купоны.
### Исправления
- Устранены зависания межзапросной инициализации сессии и добавлен быстрый
клиентский кэш сессии.
- Имена файлов с не-ASCII символами безопасно передаются в `Content-Disposition`.
- Повторное оформление автоматически отменяет устаревший ожидающий заказ.
- Значения квоты по умолчанию корректно обрабатываются в форме администратора.
- При сбоях запросов D1 журналируется вся цепочка первопричин.
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### Возможности
+46
View File
@@ -1,3 +1,49 @@
## v2.8.0 — 2026-07-24 · 管理分析与运维
### 新功能
- **管理分析仪表盘** — 提供实时运维指标卡和可信的小时级汇总,覆盖存储、
流量、用户、分享、远程下载与后台任务,并包含趋势图、数据覆盖提示和回填工具。
- **存储运维** — 重新设计存储后端管理,新增供应商预设、连接测试、请求预览、
分类用量预测、文件位置追踪和更安全的清理流程。
- **空间与配额** — 工作区设置现在明确分离成员、服务、计费和图床,并优化
配额归属与跨空间文件操作。
- **公开主页与分享** — 重新设计公开页面,可在用户主页中直接展示精选分享。
- **WebDAV 管理** — 新增服务开关与可选自定义域名,并支持自动推导和验证域名。
- **API 与事件** — 完整的 OpenAPI 覆盖和 Scalar 文档、统一的资源模型与
错误格式,以及替代前端轮询的统一 SSE 事件流。
- **更多改进** — 管理端用户/团队活动流、更好用的审计筛选、远程下载事件时间线、
NFO 预览、可配置的邮箱验证,以及记住上次登录方式。
### 修复
- 全面改进远程下载节点的进程监管、心跳恢复、做种、重试、积分预授权、
进度上报和清理。
- 分析数据现在仅使用有边界且已完成的汇总;历史数据不完整时会明确提示,
不再静默混入部分或实时数据。
- 修复非 ASCII 文件名的上传元数据,并在上传后同步已存储的内容类型。
- 改进 Finder 的 WebDAV 兼容性、活动文件夹保护、弹窗溢出和文件夹树折叠。
> **破坏性变更:** API 路径与响应结构现已统一为面向资源的形式;错误采用
> 统一格式,删除操作返回 `204 No Content`,状态变更使用资源状态端点。
> 落地页分享现在默认公开访问,除非明确配置为私有。
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.8.0)
## v2.7.4 — 2026-06-11
### 新功能
- 无需配置 `TRUSTED_ORIGINS`,即可自动信任回环地址与局域网来源。
- 云端授权配对提供更清晰的配置、错误信息和确认流程。
- 结账时可输入优惠码。
### 修复
- 消除跨请求会话初始化卡死,并加入更快的客户端会话缓存。
- 非 ASCII 上传文件名现在可安全用于 `Content-Disposition`
- 重复结账时会自动取消过期的待处理订单。
- 管理端表单可正确处理默认配额值。
- D1 查询失败时会记录完整的底层原因链。
[Full release notes ↗](https://github.com/saltbo/zpan/releases/tag/v2.7.4)
## v2.7.3 — 2026-06-09
### 新功能