diff --git a/.env.example b/.env.example index b1f0949..762b994 100644 --- a/.env.example +++ b/.env.example @@ -13,9 +13,9 @@ SITEFORGE_PG_PASSWORD=GENERATE_STRONG_URL_SAFE_PASSWORD SITEFORGE_PG_DB=siteforge # Must be HTTPS and trusted deployment endpoint; never set to an arbitrary user URL SITEFORGE_DEPLOY_STAGING_URL= -SITEFORGE_DEPLOY_STAGING_SECRET= +SITEFORGE_DEPLOY_STAGING_SECRET_REF= SITEFORGE_DEPLOY_PRODUCTION_URL= -SITEFORGE_DEPLOY_PRODUCTION_SECRET= +SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF= # Release agent is deployed as an isolated service on the receiving host SITEFORGE_DEPLOY_SECRET= @@ -34,5 +34,9 @@ SITEFORGE_MYSQL_CA_FILE= # SITEFORGE_MYSQL_READ_USER= # SITEFORGE_MYSQL_READ_PASSWORD= # Preferred remote signing secret reference (instead of plaintext _SECRET) -# SITEFORGE_DEPLOY_STAGING_SECRET_REF=env:SITEFORGE_DEPLOY_STAGING_SECRET +# SITEFORGE_DEPLOY_STAGING_SECRET_REF=env:SITEFORGE_STAGING_TOKEN +# SITEFORGE_STAGING_TOKEN= # SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF=file:siteforge_deploy_production +# Mount /run/secrets/siteforge_deploy_production in Worker using a private Compose override. +# Set SITEFORGE_DEPLOY_SECRET_REF=file:siteforge_deploy_production in the remote Agent. +# Never reuse the same token between staging and production. diff --git a/.full_results.txt b/.full_results.txt new file mode 100644 index 0000000..2e51d5b --- /dev/null +++ b/.full_results.txt @@ -0,0 +1,19 @@ +........................................................................ [ 19%] +....................................................F................... [ 39%] +.F.............................sFF............F......................... [ 58%] +...........................................F..........F...F..FFF........ [ 78%] +........................................................................ [ 97%] +........ [100%] +=========================== short test summary info =========================== +FAILED tests/test_p0_backup.py::test_sqlite_backup_and_restore_with_media - P... +FAILED tests/test_p0_p4_completion_v89.py::test_restore_replaces_directory_atomically_and_preserves_previous +FAILED tests/test_release_native_v814.py::test_sftp_immutable_release_atomic_switch_rollback_and_verification +FAILED tests/test_release_native_v814.py::test_sftp_probe_failure_restores_previous_release +FAILED tests/test_release_v813.py::test_agent_rejects_invalid_signature_and_paths +FAILED tests/test_theme_registry.py::test_trade_pro_builds_real_site - assert... +FAILED tests/test_v818_pg_recovery.py::test_pg_env_never_passes_secret_in_commands +FAILED tests/test_v818_pg_recovery.py::test_traversal_and_symlink_refused - O... +FAILED tests/test_v818_sqlite_pg_transfer.py::test_dependent_tables_transferred_with_hashes +FAILED tests/test_v818_sqlite_pg_transfer.py::test_target_nonempty_refuses_all_changes +FAILED tests/test_v818_sqlite_pg_transfer.py::test_migration_guard_and_schema_mismatch +11 failed, 356 passed, 1 skipped in 285.02s (0:04:45) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index cc1e280..6740a06 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -26,8 +26,46 @@ jobs: env: SITEFORGE_ADMIN_PASSWORD: administrator-strong-password-for-ci SITEFORGE_SESSION_SECRET: ci-only-session-key-not-for-production-with-entropy + SITEFORGE_PG_PASSWORD: ci-only-test-postgresql-password run: | - bash scripts/check.sh + SITEFORGE_REGRESSION_REPEAT=2 bash scripts/check.sh + python scripts/http_end_to_end.py + - name: Upload V8.21 regression evidence + if: always() + uses: actions/upload-artifact@v4 + with: + name: v821-regression-${{ matrix.python }} + path: reports/v821-regression* + if-no-files-found: ignore + retention-days: 14 + browser-smoke: + runs-on: ubuntu-24.04 + timeout-minutes: 20 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install test and Chromium dependencies + run: | + python -m pip install -r requirements-dev.lock + python -m pip install -r requirements-browser.txt + python -m playwright install --with-deps chromium + - name: Run real desktop and mobile browser smoke + env: + SITEFORGE_ADMIN_PASSWORD: browser-ci-only-password + SITEFORGE_SESSION_SECRET: browser-ci-only-session-secret-not-for-production + run: | + mkdir -p reports/browser + python scripts/browser_smoke.py reports/browser + - name: Upload browser screenshots + if: always() + uses: actions/upload-artifact@v4 + with: + name: v821-browser-smoke + path: reports/browser/ + if-no-files-found: ignore + retention-days: 14 container: runs-on: ubuntu-24.04 steps: @@ -55,7 +93,7 @@ jobs: sleep 2 done test "$web" = healthy && test "$worker" = healthy - docker compose exec -T siteforge python -c "import json,urllib.request; data=json.load(urllib.request.urlopen('http://127.0.0.1:8787/api/health')); assert data['version']=='8.12.0-dev.1' and data.get('commit')" + docker compose exec -T siteforge python -c "import json,urllib.request; data=json.load(urllib.request.urlopen('http://127.0.0.1:8787/api/health')); assert data['version']=='8.21.0-dev.1' and data.get('commit')" - name: Stop Compose smoke if: always() env: @@ -77,6 +115,13 @@ jobs: options: >- --health-cmd "pg_isready -U siteforge -d siteforge_ci" --health-interval 10s --health-timeout 5s --health-retries 5 + redis: + image: redis:7.4.2-alpine + ports: + - 6379:6379 + options: >- + --health-cmd "redis-cli ping" + --health-interval 10s --health-timeout 5s --health-retries 5 steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 @@ -84,7 +129,17 @@ jobs: python-version: '3.12' - name: Install pinned dependencies and PG driver run: pip install -r requirements.lock -r requirements-enterprise.txt - - name: Bootstrap PG and verify transactional queue + - name: Install PostgreSQL 16 maintenance clients + run: | + sudo apt-get update -qq + sudo apt-get install -y postgresql-client-16 + pg_dump --version + - name: Bootstrap all PG schemas and verify worker queue env: SITEFORGE_DATABASE_URL: postgresql://siteforge:postgres-ci-only@127.0.0.1:5432/siteforge_ci - run: python scripts/verify_pg_bootstrap.py + SITEFORGE_REDIS_URL: redis://127.0.0.1:6379/0 + run: | + python scripts/verify_pg_bootstrap.py + SITEFORGE_ALLOW_PG_DATA_SMOKE=1 python scripts/verify_sqlite_pg_transfer.py + python scripts/verify_redis_signal.py + SITEFORGE_ALLOW_PG_DR_SMOKE=1 python scripts/verify_pg_backup_restore.py diff --git a/.github/workflows/siteforge-v817-acceptance.yml b/.github/workflows/siteforge-v817-acceptance.yml new file mode 100644 index 0000000..20b89fa --- /dev/null +++ b/.github/workflows/siteforge-v817-acceptance.yml @@ -0,0 +1,69 @@ +# Manual-only workflow. Runs against ephemeral test services, never production data. +name: SiteForge V8.17 acceptance (isolated) +on: + workflow_dispatch: +permissions: + contents: read +jobs: + lint-and-audit: + runs-on: ubuntu-latest + timeout-minutes: 15 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install isolated audit dependencies + run: python -m pip install -r requirements-dev.lock + - name: Run V8.17 tests + run: python -m pytest -q tests/test_siteforge_v817_audit.py tests/test_wordpress_baseline.py tests/test_regression_runner_v817.py + - name: Static repository audit + run: python scripts/siteforge_v817_audit.py --repo . --output reports/ci-repo + - name: Upload non-secret audit report + if: always() + uses: actions/upload-artifact@v4 + with: + name: siteforge-v817-repo-audit + path: reports/ci-repo.* + if-no-files-found: warn + isolated-services: + runs-on: ubuntu-latest + timeout-minutes: 15 + services: + postgres: + image: postgres:16-alpine + env: + POSTGRES_USER: siteforge_ci + POSTGRES_PASSWORD: ephemeral-ci-only-password + POSTGRES_DB: siteforge_ci + ports: + - 5432:5432 + options: >- + --health-cmd "pg_isready -U siteforge_ci -d siteforge_ci" + --health-interval 5s --health-timeout 3s --health-retries 10 + redis: + image: redis:7-alpine + ports: + - 6379:6379 + options: >- + --health-cmd "redis-cli ping" + --health-interval 5s --health-timeout 3s --health-retries 10 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install read-only probe clients + run: python -m pip install 'psycopg[binary]>=3,<4' 'redis>=5,<7' + - name: Probe disposable PG/Redis services + env: + SITEFORGE_DATABASE_URL: postgresql://siteforge_ci:ephemeral-ci-only-password@127.0.0.1:5432/siteforge_ci + SITEFORGE_REDIS_URL: redis://127.0.0.1:6379/0 + run: python scripts/siteforge_v817_audit.py --postgres --redis --output reports/ci-datastores + - name: Upload non-secret audit report + if: always() + uses: actions/upload-artifact@v4 + with: + name: siteforge-v817-datastore-audit + path: reports/ci-datastores.* + if-no-files-found: warn diff --git a/README.md b/README.md index a5d7491..f589527 100644 --- a/README.md +++ b/README.md @@ -1,298 +1,313 @@ -# SiteForge Enterprise V8.12.0-dev.1 — 工作台流程与任务状态增强 +# SiteForge Enterprise V8.21.3 — 四套内置主题手机端统一优化 -> **开发集成版，尚未通过 P0–P4 全部生产验收门禁。** 完整工程在 V8.11 基线上升级；P5/多语言和 Art Design Pro 官方工程等未在本轮解决。 +> **状态：开发集成版**。从 V8.21.2 完整源码升级；原站点与数据未覆盖。四套内置主题统一支持抽屉菜单，可选的 1–5 项手机底栏 Tabs 默认关闭。正式生产的域名部署、Apple/Android 真机与 Art Design Pro 官方构建仍需独立验收。 +## 本轮重点 -## V8.11：管理后台重新设计（本轮重点） +- `automotive` / `industrial` / `corporate` / `minimal` 手机端导航统一为右侧抽屉，菜单可包含二三级链接。 +- 全站设计新增 `mobile_tabs`：默认 `enabled=false`；开启后新增、删除、排序、图标、站内/HTTPS/电话/邮箱链接均通过可视化表单配置。 +- 支持底部 `菜单` Tab 打开抽屉；适配安全区域与小屏宽度。 +- 保留现有网站内容、URL/SEO、设计草稿与构建/发布流程；旧配置无需迁移，默认不显示底栏。 +- 手机端 4 套主题 × 首页/产品列表/产品详情/文章详情 × 375/390/430px 离线 Chromium 回归通过。 -默认 `http://localhost:8787/` 现使用 **简洁工作台**，保留原有业务 API 和数据结构，不迁移数据库。 +## 快速使用和测试 -- **工作台**：网站数量、操作引导、最近网站；不要求初学者理解 Worker/SEO/主题 Schema。 -- **我的网站**：一个地方选择所有网站；创建新站的表单只保留必要字段。 -- **网站概览**：四步流程（建立网站、准备内容、完善设计、构建预览），动态提示下一步。 -- **内容与页面**：页面、产品、新闻统一管理，可快捷修改文字或进入可视化设计器。 -- **外观与设计**：行业主题选择与实际页面编辑；草稿/发布隔离仍由原编辑器负责。 -- **导入与迁移**：默认进入带预演、复核与批次回滚的导入工作台；小文件直写保留为高级操作且必须确认。 -- **构建与交付**：使用既有异步 Worker，预览、静态 ZIP、质量报告集中呈现；正式审批和远程发布保留在企业交付中心。 -- **网站设置**：站点名称、域名、公司标语、Logo、类型等从设计功能中独立出来。 -- **高级工具**：折叠保留原有生产控制台、任务与审批、主题预览以及历史后台 `/classic`，确保不丢功能。 - -新增页面在 `app/templates/workspace.html`，样式和功能逻辑在 `app/static/workspace.css`、`app/static/workspace.js`。 -专业页面已经使用 V8.11 的统一导航与分组交互；Art Design Pro 官方完整工程仍未正式编译整合。 - -**运行前后检查**：登录、创建站点、内容编辑、主题切换、文件导入、异步构建、预览/ZIP、手机宽度侧边栏。 - -**注意**：新 UI 不改变业务 API 或权限模型；`/classic` 留作过渡。真实浏览器/生产 Docker 的全面实机回归仍应在目标服务器执行。 +- **直观预览**：`examples/mobile-showcase/index.html`（离线主题样例，可切换四主题和四类页面）。 +- **后台配置**：网站 → 可视化编辑器 → 全站页眉与页脚 → 手机底部快捷导航 Tabs。 +- **专项测试**：`python -m pytest tests/test_mobile_tabs_v8213.py -q`。 +- **Chromium 测试**：`python scripts/browser_mobile_v8213.py`（需要 Playwright 和 Chromium）；结果写入 `reports/mobile-v8213-browser.json`。 +- **HTTP 端到端**：`python scripts/http_end_to_end.py`。 +- **完整技术说明**：`docs/V8_21_3_MOBILE_THEMES.md`。 --- -## V8.9 已有能力（原样保留） +# SiteForge Enterprise V8.21.2 — 简洁可视化编辑器（开发集成版） +本轮优化聚焦**降低学习成本**，而不是增加技术菜单。新增三步操作指引、显眼的草稿保存和设计发布、左侧一键添加区块、右侧内容/样式/设备编辑，复杂模板与动态数据设置默认收起；中间预览可以直接点击区块选中。FAQ、轮播、画廊、优势、数字统计等条目使用逐项普通表单，**不再要求普通用户填写 JSON**。 - -1. **P0 离线恢复安全**：恢复前校验 ZIP 路径、内容范围和数据库完整性；同文件系统暂存目录重命名切换，保留原数据目录以便回退，失败不先覆盖旧数据库。使用 `python scripts/restore_backup.py backup.zip --data /path --confirmed-offline`（务必先停 Web/Worker），完整备份生成用 `python -m app.backup`。 -2. **P2 WordPress 响应式图片**：解析 `srcset`、`data-src`、`data-srcset`、`picture/source` 和视频 poster 的外部资源引用；受限本地化后保留宽度/倍数提示及懒加载 URL，无法处理的外链进入迁移复核，绝不静默删除 CDN 引用。外部 CSS 背景图、任意复杂插件布局仍未全面迁移。 -3. **P3 5000 条真实构建**：独立 SQLite 夹具 10×500 记录实际导入 5,000 条并生成超 5,000 个静态 HTML；构建器预计算品牌/分类索引，交付检查和质量审计改为流式处理，避免随内容数平方增长；正式 SEO 警告仍需清理。 -4. **P4 维持现有设计器与模板**：保留跨设备列设置、页面草稿、全站设计草稿、Owner 整站套版与事务回滚；针对优化过的构建器/质量检查加入回归测试。 - -**验收报告与限制：** [P0–P4 V8.9 评估](docs/P0_P4_V8_9_VERIFICATION.md) | [原验收矩阵](docs/P0_P4_ACCEPTANCE_MATRIX.md) - -## 启动与测试（Windows PowerShell / Docker Desktop） - -```powershell -# 在解压后的项目根目录执行，首次生成 .env -# 不能直接覆写旧项目数据；务必使用新测试卷 -docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py -docker compose up -d --build -docker compose ps -``` - -- 简洁管理后台（默认推荐）：`http://localhost:8787/` -- 旧版专业操作页：`http://localhost:8787/classic` -- 高级数据与迁移工具：`http://localhost:8787/production-v8` -- 主题中心：`http://localhost:8787/theme-gallery` -- `/api/health` 应返回平台版本 `8.10.0-dev.1` 和构建提交标识。 -- 本地测试：`bash scripts/check.sh` 或 Windows PowerShell `scripts/check.ps1`。 -- 独立 5000 条验收：`python scripts/pilot_5000.py --report pilot.json`（默认只验证 5,000 条导入）。有足够资源的测试机上加 `--build` 同时检查整站构建；仍需分开核查 SEO 警告。。 - -## 迁移及回滚注意 - -离线恢复在目标目录旁保留 `*.pre-restore-*` 原数据目录；恢复完成后先验证旧构建、媒体、权限和管理员登录，再确认是否可以清理原目录。请先把备份 ZIP 拷贝到 Docker 卷之外。此恢复脚本适用于 SQLite 单机数据；**不是 PostgreSQL 恢复工具**。恢复前 Web 与 Worker 必须全部停止。 - -## 开发验收边界 - -此版本未在当前环境执行 Docker Engine、GitHub Actions 云端 CI、真实授权 WordPress 全站迁移、MySQL TLS 实机、生产密钥轮换以及桌面/移动浏览器完整视觉验收。P0–P4 尚不能全部标为生产交付完成。跨域 CDN、CSS 背景资源、付费/私有 WordPress 数据及复杂 WooCommerce/Elementor 页仍需定制适配与人工复核。 +- 编辑器：原 `/editor/{site_id}/{entry_id}` 路径，无数据库结构变更。 +- 离线可交互预览：[`examples/Studio_V8_21_2_新手友好版交互预览.html`](examples/Studio_V8_21_2_新手友好版交互预览.html)。演示中的保存/发布不连接生产 API。 +- 变更与验收：[`docs/V8_21_2_EASY_STUDIO.md`](docs/V8_21_2_EASY_STUDIO.md)。 +- 仍保持原有 CSRF、权限、草稿乐观锁、审核及静态构建流程；**发布设计不等于自动部署上线**。 +- 官方 Art Design Pro 工程、真实 Chromium E2E 和生产环境验收仍需独立完成；不要据此宣布正式投产。 --- -## 历史功能说明（原 V8.8/之前版本，仅供追溯） +# SiteForge Enterprise V8.21.1 — Studio 可视化编辑器体验增强 -# SiteForge Enterprise V8.8.0-dev.1 — P0–P4 集成增强版 - -> **交付状态：开发集成版，尚未通过 P0–P4 全部门禁，不应作为正式商业验收报告。** - -本版延续 V8.7 的完整源码，聚焦 P4（响应式独立列布局、图片素材库、整站模板两步审核与多页原子操作），同时修复深层页面 CTA/媒体根路径问题、版本与 Compose 遗留问题。旧站迁移、数据装配、安全 HTTP、Worker、四套主题继续保留。 - -- **P4 设备布局**：页面中的多列区块可设置平板/手机独立列数、排序、跨度和显示隐藏；所有自定义 CSS 经过严格参数校验，并按页面作用域生成。 -- **P4 模板套版**：生产控制台先预检、再暂存，最后 Owner 发布；冲突拒绝、失败回滚，同步保证数据与 SEO 不被模板业务内容覆盖。旧版直接应用 API 需显式设置开发兼容开关。 -- **P4 媒体素材**：编辑器新增本站图片库选择，支持图片组件、画廊和轮播；深层页面正确使用根路径。 -- **验证状态与全部遗留**：[P0–P4 验收矩阵](docs/P0_P4_ACCEPTANCE_MATRIX.md)。 -- **运行**：与 V8.7 一样，首先在独立测试目录执行 `python scripts/init_config.py`（或 Docker 运行该脚本），再 `docker compose up -d --build`。不得覆盖运行中的旧版数据卷。 - ---- - -## V8.7 历史项目说明（保留升级依据） - -# SiteForge Enterprise V8.7.0-dev.1 — 全站设计草稿与响应式管理 - -> **交付状态：开发试点版。** 本轮基于 V8.6 延续原 Web + Docker 工程，不是单独演示网站。 - -## V8.7 本轮实际实现 - -- **全站设计草稿**：`GET/PUT/DELETE /api/sites/{site}/site-design` 管理独立草稿；`POST /site-design/publish` 才更新用于正式构建的全站配置。对 `revision` 和底层设置指纹做并发冲突检查，发布记录保存在 `site_design_publications`。 -- **统一页眉/页脚/导航**：支持安全的三级导航、搜索显示、顶部公告、联系 CTA、页脚标题/介绍/邮箱、页脚菜单显示选项；四套专业主题的最终 HTML 均消费同一份配置。导航只允许站内路径，严禁任意脚本、外部链接注入。 -- **响应式控制**：平板与手机的区块间距、手机内容左右内边距、移动端公告和页脚导航显隐；已写入最终静态 `assets/custom.css` 和可视化编辑器预览 CSS。它是可交付的响应式参数编辑，**并非**完整独立设备画布。 -- **设计令牌统一入草稿**：字体、标题缩放、版心宽度、圆角等改为全站草稿保存/发布；未经发布不会更改新构建。编辑器内可在“设计规范”和“全站页眉与页脚”面板操作。 -- **关闭旧版直写绕过**：`/blueprint` 直写、旧导航直写、旧设计令牌直写及 `PATCH entry.meta` 的布局直写，在生产环境默认返回 HTTP 409。旧脚本若必须临时过渡，可显式设 `SITEFORGE_ALLOW_LEGACY_DIRECT_DESIGN_WRITE=1`；**正式生产不应启用此选项**。原后台导航表单与企业设计令牌页已改写全站草稿。 -- **测试**：在现有 168 项回归基础上新增 13 项专项测试，验证四主题、草稿构建隔离、发布、设计令牌、安全输入、跨站隔离、并发拒绝、旧接口安全门禁。 - -### 使用方法 - -1. 解压后先在**独立测试环境**启动 Docker（以下为 PowerShell）： - - ```powershell - docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py - docker compose up -d --build - ``` - -2. 登录 `http://localhost:8787/`，进入任意站点页面的 `/editor/{site_id}/{entry_id}` 设计器。 -3. 点击 **全站页眉与页脚**，调整导航/页眉/页脚/手机与平板设置，点击 **预览草稿**，随后 **保存全站草稿**。 -4. 由网站 Owner 点击 **发布全站设计**，然后触发 Worker 网站构建。现有已发布静态版本不会因保存或发布设计而被原位篡改。 -5. CI 中可执行 `pytest`、Python 编译检查、`node --check`；Docker、真实浏览器和服务器发布需要独立实机验收。 - -### API 及兼容性 - -| 方法与路径 | 行为 | -|---|---| -| `GET /api/sites/{site}/site-design` | 返回已发布配置或草稿、版本、冲突状态 | -| `PUT /api/sites/{site}/site-design` | 携带 `config` 与 `expected_revision` 保存草稿 | -| `POST /api/sites/{site}/site-design/publish` | Owner 审核发布，要求版本号 | -| `DELETE /api/sites/{site}/site-design` | 删除未发布草稿 | -| `GET /api/sites/{site}/site-design/publications` | 查询最近的发布审计记录 | -| `POST /api/sites/{site}/pages/{entry}/editor-preview` | 请求体的 `site_design` 可预览未发布的整站草稿 | - -### 明确未完成 - -- 目前并非 Figma 式自由定位编辑；完整 PC/平板/手机**独立布局**、全站模板可视化拖拽、实时跨设备视觉验收仍待开发。 -- 旧版批量套版及部分内容创建接口仍可能更新布局，需在后续将所有设计变更统一纳入发布工作流；本次仅限制上述直接绕过入口。 -- Art Design Pro 官方工程、复杂 CMS 无损迁移、PostgreSQL/Redis 多实例、SFTP/S3 正式发布仍未完成完整实机验收。 -- 当前环境无 Docker Engine，**不能宣称** `docker compose up` 已实机通过；亦未完成 GitHub 云端 CI 和真机 Chrome 视觉回归。 - ---- - -## 上一版 V8.6 的开发记录（保留供升级追踪） - -# SiteForge Enterprise V8.6.0-dev.1 - -> **状态：开发试点版，P4 设计器与整站模板增强。** 同一主线延续 V8.5 的认证 API、只读 MySQL、V8.4 XML/API、WordPress 迁移、四套主题、构建 Worker 和发布审批。尚未完成正式商业/生产验收。 - -## 这一轮新增（P4） - -- **六种声明式组件**：`carousel` 图片滚动展示、`video` YouTube/Vimeo 白名单视频、`tabs` 可访问详情分组、`pricing` 服务方案、`map` 可信地图外链、`form_link` 询盘入口。都使用可信渲染器输出，不允许用户提交 JavaScript。 -- **独立设计草稿**：V8.6 可视化编辑器的“保存草稿”只写入 `studio_drafts`，不会修改正式 entries 或被静态构建读取；“发布设计”才会原子写入正式页面，随后需重新构建静态网站。 -- **并发保护**：每次草稿更新携带 `expected_revision`；正式页面被其他人改动后，拒绝发布，防止静默覆盖。放弃草稿会恢复正式版设计。操作支持站点权限隔离与审计。 -- **整站模板兼容性**：模板带主题版本声明；新增 `/whole-site-templates/preflight` 无副作用检查，验证主题是否存在、指定版本是否可用、已安装组件、已有路径，后台预检后再应用。 -- **前端操作入口**：原 `/editor/{site_id}/{entry_id}` 页面新增保存草稿、发布设计、放弃草稿；整站模板控制台在应用前执行独立兼容性检查。原 `/blueprint` 直写接口保留兼容旧系统，尚未完全禁用。 - -### Docker 运行 - -Windows PowerShell（在解压后的项目根目录）： - -```powershell -docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py -docker compose up -d --build -docker compose ps -``` - -页面：管理台 `http://localhost:8787/`；生产控制台 `/production-v8`；主题 `/theme-gallery`；设计器从网站页面进入 `/editor/{site_id}/{entry_id}`；API 版本 `/api/health`。 - -首次升级必须使用**独立测试环境和数据副本**，备份 `.env`、数据库、媒体及归档。草稿表通过幂等方式初始化，未在原有生产数据库上完成实际迁移演练。 - -### P4 接口 - -| HTTP 接口 | 用途 | -|---|---| -| `GET /api/editor/blocks` | 读取组件注册表与属性契约 | -| `GET /api/sites/{site}/pages/{entry}/studio-draft` | 获取当前草稿或正式布局 | -| `GET /api/sites/{site}/pages/{entry}/studio-draft/preset?page_template=home` | 获取主题预设，不修改正式页 | -| `PUT /api/sites/{site}/pages/{entry}/studio-draft` | 保存草稿，要求 `expected_revision` | -| `POST /api/sites/{site}/pages/{entry}/studio-draft/publish` | 发布设计，需要 owner 角色和 `expected_revision` | -| `DELETE /api/sites/{site}/pages/{entry}/studio-draft` | 放弃草稿 | -| `POST /api/factory/sites/{site}/whole-site-templates/preflight` | 整站模板无副作用兼容检查 | - -开发环境已经完成 **168 项本地 pytest**、全部 JavaScript 语法与版本检查，另有“草稿构建不包含未发布内容 → 发布后重新构建包含内容”的实测回归。 - -**未验收**：Docker Engine 实机、GitHub 云端 CI、浏览器 PC/手机端手工交互、真实客户内容视觉检查、Art Design Pro 官方工程编译、复杂 WordPress 无损迁移、PostgreSQL/Redis 多实例能力、SFTP/S3 正式发布。 - -详细信息见 [V8.6 验收与剩余需求](docs/V8_6_RELEASE_STATUS.md)。 - ---- - -## 历史版本功能参考（以下内容为 V8.5 及更早阶段的开发记录，不是 V8.6 最新状态） - ---- - -## V8.4 历史能力（继续保留） - - -> 当前阶段：统一网站生产工厂，**P3 数据连接器第一轮（安全 XML、公开 JSON API + Worker）**。本版本是开发试点版，并非所有网站工厂需求均已实现。 - -## V8.4 本轮新增 - -- **安全 XML 导入**：`/production-v8` 可以上传 XML，选择记录节点、内容类型和字段映射，支持扁平或两级结构；使用 `defusedxml` 禁用 DTD 与外部实体，并限制最大 8 MB、1000 条记录及节点/深度上限。 -- **公开 HTTPS JSON API**：设置 `url`、JSON 列表路径（例如 `data.items`）、字段映射和分页；创建后提交 Worker 后台采集，使用既有租约/取消/重试/超时机制。每页形成独立暂存批次，可以审批提交或回滚。所有采集均不自动上线。 -- **进度和误差边界**：最多 50 页 × 每页 100 条，合计 5000 条；发生中断从已保存页码继续，复用已有同页批次避免重试重复写入；达到最大页数而上页满额会显示 `limit_reached`，不能视为采集完整。 -- **统一后台**：新增 XML 文件上传、API 创建、采集任务、取消和进度查询操作区域，并保留 WordPress 迁移、主题和编辑器。 -- **版本与 CI**：统一应用版本标记、Compose 名称、脚本和 CI 版本断言为 `8.5.0-dev.1`；**144 项本地自动化测试通过**。 - -[详细功能、接口、安全限制与剩余需求](docs/V8_4_RELEASE_STATUS.md) - -**边界**：目前 API **只支持无需认证的公开 JSON**，不支持带密钥 API；MySQL 只读连接器、完整 Art Design Pro 编译和生产级外部发布也尚未完成。没有运行 Docker 实机或云端 CI，因此不得将该版本称为企业正式上线完成版。 - ---- - -## 既有 V8.3 迁移与建站功能（本轮保留） - - -> SiteForge Enterprise 统一开发主线：**WordPress 可恢复迁移 + Sitemap 完整性审计 + 有界媒体本地化 + Worker 后台采集**。 +> 基于 V8.21.0-dev.1 完整源码迭代；当前版本 `8.21.1-dev.1`，属于兼容性开发集成版，未覆盖生产网站。 > -> 版本状态：开发试点候选版，不可直接对外宣称完整 WordPress 无损迁移或企业生产部署已验收。V8.1 网站、主题、编辑器、导入批次和静态构建功能均在此版本继续维护。 +> **本次直接改进**：区块搜索和快捷排序、属性分类、PC/平板/手机预览、保存与预览异步竞态保护、移动端侧栏、Ctrl+S、测试工具和离线交互示例。 +> +> 交付说明：[可视化编辑器优化实施与验证](docs/V8_21_1_STUDIO_UX.md) | [无需服务器的离线交互演示](examples/Studio_V8_21_1_交互预览.html) | [原始测试数据](reports/studio-ux/editor-ux-validation.json) +> +> **准确验收边界**：39 个测试模块拆分运行累计 328 项通过，HTTP+Worker 构建通过；一键回归在第七批出现停滞，真实 Chromium 因环境策略被拒绝。尚未完成正式 Art Design Pro 全工程编译或真实企业部署验收。 -## 快速启动（Docker Desktop / Linux Docker） +--- -项目根目录第一次初始化： +# SiteForge Enterprise V8.21.0-dev.1 — 高级编辑历史与安全数据装配 + +**交付性质：完整源码的开发集成版。** 基于 V8.20 继续开发，保留原有 WordPress 迁移、主题建站、P5 发布、多语言和企业运维代码。 + +本轮新增： + +- **持久化设计版本历史**：每次页面草稿保存与发布自动创建完整快照，按网站和页面隔离，SHA-256 完整性校验，编辑权限控制；可从历史记录恢复成**新草稿**（不直接覆写线上页面）。前端编辑器新增“版本历史”操作。 +- **更安全的数据装配**：字段映射支持受限的 trim、默认值、英文大小写转换、前后缀；预览生成确定性 `plan_hash`，确认导入时可携带该指纹防止过期预览；新增严格冲突拒绝模式 `abort`，现有 `skip`、`replace` 仍兼容。内容导入 UI 新增转换选择、冲突策略和预检确认。 +- **质量与版本管理**：更新镜像标签、版本常量和检查入口；专项测试覆盖历史恢复、站点隔离、快照篡改阻断、过期预检及字段处理。 + +验收：本地按 **10 个独立分组**执行原项目全部 **38 个测试模块、325 项测试通过**；Python 编译、Node.js 语法、静态发布检查和 HTTP+Worker E2E 通过。长流程一键检查在本环境**曾偶发停滞**，因此不能把它记为完全稳定。真实 Docker、PostgreSQL/Redis、正式 Art Design Pro 工程编译及客户迁移仍未通过验收。 + +文档：[V8.21 实现与验收](docs/V8_21_EDITOR_AND_MAPPING.md) · [HTML 验收报告](reports/V8_21_集成验收.html) · [10 批原始日志](reports/v821_manual_verified/) + +验证命令： ```bash -# PowerShell 将 `$(pwd)` 改为 `${PWD}` -docker run --rm -v "$(pwd):/project" -w /project python:3.12-slim python scripts/init_config.py +python -m pytest -q tests/test_v821_editor_history_and_mapping.py +python scripts/http_end_to_end.py +bash scripts/check.sh +``` + +--- + +# SiteForge Enterprise V8.20.0-dev.1 — 复杂 WordPress 迁移预检与兼容性增强 + +基于 V8.19 完整源码。本轮新增 WXR 离线兼容预检 API + 后台入口、ACF 简单 Repeater 元数据提取、CSS 背景图本地化、危险 URL 在直接导入及暂存前阻断，以及带构建路径对账的 JSON/HTML CLI 报告。 + +- 阅读：[`docs/V8_20_COMPLEX_WORDPRESS.md`](docs/V8_20_COMPLEX_WORDPRESS.md) +- 演示：`python scripts/wp_v820_preflight.py fixtures/v820/wordPress-complex-sample.xml --output reports/v820-demo.json`（演示数据包含故意设置的阻断项，返回码为 1） +- 回归：`bash scripts/check.sh` 或 `python scripts/regression_v820.py --batch-size 4 --report reports/v820-regression` +- HTTP 集成：`python scripts/http_end_to_end.py` +- 安全：所有离线预检不写数据库、不联网、不执行 PHP/JS 或反序列化未知 PHP 对象。 + +**交付状态：开发集成版。** 尚未实现 WordPress/Elementor/ACF/WooCommerce 完整 1:1 视觉或动态业务迁移；Art Design Pro 官方工程真实编译与生产 PostgreSQL/Redis/远程发布仍需现场验收。 + +--- + +# SiteForge Enterprise V8.19.0-dev.1 — 统一后台集成版 + +V8.19 基于 V8.18 的完整项目继续开发。新增 **后端授权菜单 `/api/console/bootstrap`**、Art Design Pro **单一导航树安装器**、Vue 工作台与内容管理、共享会话/CSRF/站点选择、官方工程安装校验，以及 HTTPS 同源反向代理示例。正式功能与限制详见 [`docs/V8_19_ART_UNIFIED_BACKEND.md`](docs/V8_19_ART_UNIFIED_BACKEND.md)。 + +**交付性质：开发集成版。** 本仓库含完整 SiteForge 后端和 Art 对接业务模块，**不含官方 Art Design Pro 整套前端工程**；真实官方 `pnpm build`、PC/移动端浏览器及 HTTPS 正式发布尚未验收。不得把安装器 fixture 测试等同于官方完整前端编译。历史的 PostgreSQL/Redis/多 Worker 生产门禁仍未关闭。 + +建议执行： + +```bash +bash scripts/check.sh +python scripts/http_end_to_end.py +python scripts/install_into_art_design_pro.py /path/to/official/art-design-pro +python scripts/install_into_art_design_pro.py /path/to/official/art-design-pro --apply +python scripts/verify_art_design_pro_v819.py /path/to/official/art-design-pro +``` + +--- + +# SiteForge Enterprise V8.18.0-dev.1 — 企业底座与数据迁移安全 + +V8.18 基于 V8.17 完整源码继续开发。新增 PostgreSQL 专用灾备、SQLite→PG 数据迁移校验、外部发布不确定状态的安全处置、CI 集成验证。详见 [`README_V8_18.md`](README_V8_18.md) 和 [`docs/V8_18_ENTERPRISE_HARDENING.md`](docs/V8_18_ENTERPRISE_HARDENING.md)。**本版本尚未完成真实生产环境验收。** + +--- + +# SiteForge Enterprise V8.17.0-dev.1 — 集成回归与生产验收整合版 + +> **状态：开发集成版；不代表生产环境验收通过。** 基于 V8.16 完整源码升级，合入 V8.17 只读审计和 WordPress URL 迁移基线工具，并改造官方回归执行器。原 ZIP 不受影响。 + +## V8.17 本轮已整合 + +- **统一回归执行器**：`scripts/regression_v817.py` 逐批运行测试（每批最多 10 个文件），每批超时默认 90 秒；超时将结束整个子进程组、留存日志，随后逐个模块隔离定位。任何超时、失败或重试后才通过，都不能算本次验收通过。 +- **Windows + Linux 一致性**：`scripts/check.sh` 和 `scripts/check.ps1` 均调用该执行器。JSON、Markdown、HTML 及每批 verbose 日志保存在 `reports/`。 +- **可重复 CI**：Linux CI 两轮重复测试并上传报告；新增隔离浏览器 smoke 作业，原有 PostgreSQL、Docker 质量门禁保留。CI 定义存在并不表示已经在 GitHub Actions 实际执行。 +- **Chromium 测试修复**：移动端新页面复用桌面端登录上下文；默认使用 Playwright 安装的 Chromium，`SITEFORGE_CHROMIUM` 可显式指定浏览器。 +- **生产验收只读工具**：`scripts/siteforge_v817_audit.py` 支持仓库、存活/就绪探针、Compose、PG SELECT 1、Redis PING、静态构建/SEO、人工发布证据校验；不会执行部署或数据库变更。 +- **WordPress 路径核对**：`scripts/export_wordpress_url_baseline.py` 从授权站点导出的 WXR/Sitemap 等本地文件建立旧路径基线，再用构建目录对比。缺失路径阻断验收而不是静默改 URL。 +- 本轮产品版本更新为 `8.17.0-dev.1`；Compose 镜像及已有版本断言相应升级。不存在自动升级现有部署卷的操作。 + +### 一键回归（隔离本地目录） + +```bash +bash scripts/check.sh +python scripts/http_end_to_end.py +python scripts/siteforge_v817_audit.py --repo . --output reports/v817-audit +``` + +Windows PowerShell：`./scripts/check.ps1`。 + +若需重复运行和定位卡点： + +```bash +python scripts/regression_v817.py --repeat 3 --timeout 90 --module-timeout 50 --report reports/repeated +``` + +### 上线门禁 + +正式上线之前必须在独立测试环境完成 GitHub CI 的 Docker / PG / Redis / Chromium、真实远程发布与回滚、备份恢复、业务页面与 301/canonical/hreflang 审核。**没有实测证据时这些条目均视为未验收。** `Art Design Pro` 官方完整工程并未随此源码提供，本版本没有声称已编译或安装该后台。 + +参阅：`docs/V8_17_ACCEPTANCE_RUNBOOK.md` 和 `docs/V8_17_INTEGRATION_RELEASE_NOTES.md`。 + +--- + +# SiteForge Enterprise V8.16.0-dev.1 — 企业部署基础与可重复验收 + +> **交付状态：开发集成版。** 该版本继续沿用 V8.15 全部建站、编辑、WordPress 迁移、P5 发布和 P6 多语言功能。本轮重点是修复 PostgreSQL 兼容隐患、健康探针、Worker 实例隔离和实测建站链路。**Art Design Pro 官方完整工程没有随项目提供，不能声称已集成或完成编译；真实 PostgreSQL/Redis、Docker 和公网上线仍须实机验收。** + +## V8.16 本轮变更 + +1. **PostgreSQL 查询行适配**：`PGRow` 同时提供字典字段访问和数字索引（如 `fetchone()[0]`），修复了原队列容量检查与其他遗留语句在 PG 下类型不匹配的问题。占位符转换现在保护 SQL 注释和转义引号；DDL 分句避免破坏字符串里的分号。 +2. **数据库初始化迁移**：原先仅 SQLite 执行的 `schema_registry` 迁移账本现在也在 PostgreSQL 创建和校验；重复运行可验证迁移 checksum。团队账号唯一性冲突也支持 PG 错误码 `23505`。 +3. **探针分层**：`GET /api/health` 为轻量存活；新增公开 `GET /api/ready` 检查数据库查询和 `/data` 可写性，失败只返回 `503 {"status":"unavailable"}`，不会泄露数据库/文件路径。Compose 的 Web 探针改用 `/api/ready`，Worker 探针附加数据库和存储检查。 +4. **Worker 心跳隔离**：支持 `SITEFORGE_WORKER_INSTANCE`，企业 PostgreSQL 模式下默认以容器主机名隔离心跳，防止两个 Worker 相互掩盖健康问题；构建队列依然以数据库锁/租约为准。 +5. **集成验证**：新增 `scripts/http_end_to_end.py`，可在隔离 SQLite 中实际启动 HTTP 服务，创建网站和页面、提交任务、启动 Worker 子进程、检查 ZIP 和预览。`scripts/browser_smoke.py` 为真实 Chromium 脚本（需要浏览器允许本地 HTTP）；扩展 `scripts/verify_pg_bootstrap.py` 对所有模块初始化和队列 claim/complete/cancel 的真实 PostgreSQL 验证。 +6. **CI**：回归按模块分进程运行，减少历史测试共享状态造成的超时；Web 真实 HTTP 集成测试纳入测试 Job，PG 连接测试继续由 CI `postgres-smoke` Job 执行。 + +## 快速检查 + +```bash +bash scripts/check.sh +python scripts/http_end_to_end.py +# 仅在隔离的 PostgreSQL 数据库中： +SITEFORGE_DATABASE_URL='postgresql://siteforge:***@postgres:5432/siteforge_test' python scripts/verify_pg_bootstrap.py +# 可选：安装 Playwright + Chromium 后，且允许访问 localhost： +python scripts/browser_smoke.py +``` + +完整验收说明和未完成门禁见 [`docs/V8_16_PRODUCTION_ACCEPTANCE.md`](docs/V8_16_PRODUCTION_ACCEPTANCE.md)。**不要在生产数据库上运行 PG smoke**，不要直接把 SQLite 数据文件重定向为 PostgreSQL，也不要在没有备份/恢复演练时升级正式卷。 + +--- + +# SiteForge Enterprise V8.15.0-dev.1 — P6 多语言网站与国际 SEO + +> 历史版本说明：V8.14 在 V8.13 基础上新增原生 SFTP、S3 发布适配器及 S3 发布指针读取服务，保留 P5 发布任务、不可变版本校验与历史回滚；保留四套主题、内容管理、WordPress 迁移、数据连接器、编辑器和 Worker。**SFTP/S3 已有代码及本地仿真测试，但未完成真实 Docker、远程服务器和生产域名验收，不可直接宣布生产级完成。** + + +## V8.15 新增：P6 多语言网站管理（开发集成版） + +**请先读此段**：V8.15 在 V8.14 完整源码上新增语言组/翻译组、审核状态、前台语言切换、HTML `lang`、双向 `hreflang` 与 Sitemap `xhtml:link`。所有业务内容由用户自己翻译、审核；不会自动翻译产品规格、公司地址或 SEO 事实。 + +- 入口：后台首页 → 选择网站 → **多语言管理**。 +- 一个 SiteForge 站点代表一个语言版本，每个语言站拥有独立的企业内容和 URL。已实现**独立域名或子域名**方案，组成员必须配置自己的 HTTPS 域名；尚不支持多个语言共用域名下的 `/en/` 子路径方案。 +- 管理员创建语言组，选择默认语言；拥有两个语言站 Owner 权限的操作者可以把站点加入同一语言组。 +- 按语义创建翻译内容组（如 `product:rox01`），把中文 `/products/rox/` 与英文 `/vehicle/rox/` 的**实际内容 ID** 关联。两端需要 `published` 和 `approved` 且允许索引才会输出相互指向的语言链接。 +- `pending` 只允许关联内容草稿。如果后来绕过编辑器直接将 pending 内容改为 published，**构建会拒绝执行**。 +- 默认语言确实有已审核对应页面时才输出 `x-default`；`noindex`、缺失、草稿或不一致 canonical 的页面不参与。 +- 生成的 `sitemap.xml` 使用正确的 XHTML 命名空间和双方对称的 alternate URL；每个独立网站的 canonical 仍指向自己的正式 URL。 +- UI 有可点击的语言切换条，未关联的页面不显示不存在的翻译页面入口。 +- 旧站无需设置语言组，可继续按原构建方式工作；数据库迁移只新增表格。 +- 本轮**没有**实现机器翻译、批量翻译工作流、子路径多语言站点、主题各栏目默认文案的完全国际化。四套现有商业主题的预设导航和空栏目提示部分仍是中文，正式英文站上线前需配置企业自己的导航和文案。 + +操作示例： + +1. 在“我的网站”分别新建中文站和英文站，设置 `https://zh.example.com`、`https://en.example.com`。 +2. 选择中文站 → 多语言管理 → 建立语言组，默认语言可选 `en`，并将当前站点登记为 `zh-CN`（若建组时，分别填写“默认语言”和“当前网站实际语言”，两者可以不同）。 +3. 将英文站加入该语言组，设置 `en`；在两个站各自建立真实对应页面。 +4. 创建翻译组 `about-company`，分别选中两语言的页面，状态设为“已确认”。 +5. 在两个站分别执行 Worker 静态构建，检查 HTML ``、`rel=alternate` 和 `sitemap.xml`；正式发布仍需要独立审批。 + +本轮核心代码：`app/multilingual.py`、`app/builder.py`、`app/templates/workspace.html`、`app/static/workspace.js`，专项测试 `tests/test_multilingual_v815.py`。 + + +## V8.15 新增：P6 多语言网站管理（开发集成版） + +**请先读此段**：V8.15 在 V8.14 完整源码上新增语言组/翻译组、审核状态、前台语言切换、HTML `lang`、双向 `hreflang` 与 Sitemap `xhtml:link`。所有业务内容由用户自己翻译、审核；不会自动翻译产品规格、公司地址或 SEO 事实。 + +- 入口：后台首页 → 选择网站 → **多语言管理**。 +- 一个 SiteForge 站点代表一个语言版本，每个语言站拥有独立的企业内容和 URL。已实现**独立域名或子域名**方案，组成员必须配置自己的 HTTPS 域名；尚不支持多个语言共用域名下的 `/en/` 子路径方案。 +- 管理员创建语言组，选择默认语言；拥有两个语言站 Owner 权限的操作者可以把站点加入同一语言组。 +- 按语义创建翻译内容组（如 `product:rox01`），把中文 `/products/rox/` 与英文 `/vehicle/rox/` 的**实际内容 ID** 关联。两端需要 `published` 和 `approved` 且允许索引才会输出相互指向的语言链接。 +- `pending` 只允许关联内容草稿。如果后来绕过编辑器直接将 pending 内容改为 published，**构建会拒绝执行**。 +- 默认语言确实有已审核对应页面时才输出 `x-default`；`noindex`、缺失、草稿或不一致 canonical 的页面不参与。 +- 生成的 `sitemap.xml` 使用正确的 XHTML 命名空间和双方对称的 alternate URL；每个独立网站的 canonical 仍指向自己的正式 URL。 +- UI 有可点击的语言切换条，未关联的页面不显示不存在的翻译页面入口。 +- 旧站无需设置语言组，可继续按原构建方式工作；数据库迁移只新增表格。 +- 本轮**没有**实现机器翻译、批量翻译工作流、子路径多语言站点、主题各栏目默认文案的完全国际化。四套现有商业主题的预设导航和空栏目提示部分仍是中文，正式英文站上线前需配置企业自己的导航和文案。 + +操作示例： + +1. 在“我的网站”分别新建中文站和英文站，设置 `https://zh.example.com`、`https://en.example.com`。 +2. 选择中文站 → 多语言管理 → 建立语言组，默认语言可选 `en`，并将当前站点登记为 `zh-CN`（若建组时默认语言不是当前站实际语言，请创建后在已建组界面使用对应语言站点；管理后台的建组快捷操作默认登记所选默认语言，操作前请校正）。 +3. 将英文站加入该语言组，设置 `en`；在两个站各自建立真实对应页面。 +4. 创建翻译组 `about-company`，分别选中两语言的页面，状态设为“已确认”。 +5. 在两个站分别执行 Worker 静态构建，检查 HTML ``、`rel=alternate` 和 `sitemap.xml`；正式发布仍需要独立审批。 + +本轮核心代码：`app/multilingual.py`、`app/builder.py`、`app/templates/workspace.html`、`app/static/workspace.js`，专项测试 `tests/test_multilingual_v815.py`。 + +## 一、系统入口 + +- 简洁管理后台：`http://localhost:8787/` +- 「构建与交付」：构建、预览、质量检查、提交审批、远程发布及回滚 +- 「高级工具」→「任务与发布审批」：审核人对不同账号提交的申请进行审批，查看任务详情 +- `http://localhost:8787/api/health`：核实运行版本与构建提交 + +### V8.14 新增实际功能（同时保留 V8.13 发布流程） + +| 流程 | 位置 | 实际行为 | +|---|---|---| +| 发布前核对 | `GET /api/production/sites/{site}/preflight/{build}` | 必须构建 complete、有 ZIP、静态质量通过、迁移复核完成、另一账号审批通过 | +| 发起远程发布 | `POST /api/production/sites/{site}/deploy` | Owner 提交到共享 Worker 队列，返回 202 + 任务 ID；不在 Web 请求中传 ZIP | +| Worker 实际上传 | `app.job_runner` + `app.release_api.run_delivery` | 暂存 ZIP、比对 SHA256、校验远程文件清单、激活线上指针、再核对公开首页 | +| 历史版本回滚 | `POST /api/production/sites/{site}/rollback` | Owner 只能回滚本站指定目标的已记录版本，后台异步执行 | +| 发布进度/历史 | `GET /api/production/sites/{site}/delivery-status` | 返回任务、发布历史及目标是否配置；不暴露 URL 凭据 | +| 远程 Agent | `app.deploy_agent:app` | 新增 `staging` / `verify` / `activate` 事务式三阶段，不覆盖已发布目录 | + +共享 Worker 的取消、重试、限额、幂等键及租约机制沿用 V8.12；**远程发布依赖在目标服务器部署新版本 Agent，旧版 Agent 不支持三阶段 API**。 + + +## V8.14 原生 SFTP / S3 发布 + +- `SITEFORGE_DEPLOY_STAGING_TYPE` 和 `SITEFORGE_DEPLOY_PRODUCTION_TYPE` 支持 `agent`（兼容默认）、`sftp`、`s3`。 +- 原生 SFTP：Worker 使用管理员挂载的私钥与严格 known_hosts；远程服务器需要支持原子 `posix_rename`；发布指针为 `current` 符号链接。 +- 原生 S3：按版本前缀不可变保存文件，使用 S3 条件更新 `current.json`；必须搭配只读指针感知网关 `app.s3_gateway:app`，不能将 S3 裸网站端点视为原子上线。 +- 目标 URL、SSH 主机、桶和密钥只能由服务器配置，不能由建站人员在浏览器随意填写；Worker 执行真实上传，Web 仅提交任务。 +- 详见 [`deploy/native-release/README.md`](deploy/native-release/README.md)、`compose.publish-targets.example.yaml`、`compose.s3-gateway.example.yaml`。 +- **约束**：本次对 SFTP 和 S3 的测试使用模拟文件系统与模拟 S3 兼容语义，尚未在实际远程服务器或 Docker 环境验收。 + +## 二、Docker 安装（Windows PowerShell） + +```powershell +# 解压 V8.14 后进入项目根目录。请勿直接覆盖 V8.12 的数据卷。 +docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py docker compose up -d --build docker compose ps ``` -- 登录：`http://localhost:8787/` -- **V8.4 生产控制台**：`http://localhost:8787/production-v8` -- 主题管理：`http://localhost:8787/theme-gallery` -- 页面编辑：`http://localhost:8787/factory-studio` -- 任务中心：`http://localhost:8787/operations` -- 构建版本：`http://localhost:8787/api/health`；当前应显示 `8.5.0-dev.1`。 +推荐先用独立测试域名 / Docker volume。Web 默认只监听 `127.0.0.1:8787`。如果反向代理到外网，需要设置 HTTPS 和 `SITEFORGE_COOKIE_SECURE=true`，自行配置防火墙、TLS 与可信反向代理。 -**升级注意：** 不要直接覆盖 V8.1 正在运行的存储卷。先备份 `.env`、数据库、媒体和生成文件，在独立 Compose 项目中完成验收，然后安排升级与回滚。新版本表结构采用幂等的 `CREATE TABLE IF NOT EXISTS`，但并未进行真实旧数据库原地升级演练。 +**PostgreSQL/Redis 测试配置**：`docker compose -f compose.enterprise.yaml up -d --build`。这只是配置与兼容层，不能视为分布式高可用验收通过。 -## V8.3 新增：WordPress 关系数据与归档 URL 保真 +## 三、远程发布如何配置？ -- 为每次 WordPress 迁移会话采集公开 REST 分类、标签和媒体库**元数据**，分别保存页码和已采集数量。关闭页面后可以继续下一页。 -- 原始 WordPress ID、分类/标签/特色图片的关联 ID 写入批次记录和关系索引；导入确认前，在已同步名称的情况下补充分类/标签字段；绝不凭空创建不存在的分类内容。 -- 分类/标签来源归档 URL 纳入旧站 SEO 基线。无对应的新页面或批准重定向时，需要通过差异检查处理。 -- 对缺失的标签/分类、未知特色图片、ACF 和页面构建器内容保留人工审核事项。公开 ACF 只保留有界快照，不承诺原样转换。 -- 控制台按钮：选择“分类 / 标签 / 媒体库”→ “同步目录下一页”→ “目录进度”，完成后再核对媒体和 Sitemap，最后确认导入。 +1. 在**接收网站的独立服务器**上部署 `compose.release-agent.yaml`，把 Agent 的 `127.0.0.1:8790` 通过受控 HTTPS 反向代理转发为固定发布域名（如 `https://deploy.example.com`）。Agent 所在服务器必须保留持久化 `releases` 卷。 +2. 在接收服务器设置 `SITEFORGE_DEPLOY_SECRET_REF=file:production_release`，把强随机密钥文件仅挂载到 Agent `/run/secrets/production_release`。可通过 `compose.agent-secrets.example.yaml` 作为私有 Compose 覆盖参考。 +3. 在 SiteForge 管理服务器 `.env` 中设置 `SITEFORGE_DEPLOY_PRODUCTION_URL=https://deploy.example.com` 和 `SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF=file:production_release`，将**同一生产密钥**只挂载到 Worker `/run/secrets/production_release`；通过 `compose.release-secrets.example.yaml` 添加私有只读挂载。不要把密钥写进网站数据库或前端 JavaScript。 +4. Staging 使用**另一套服务器及独立密钥**，不要复用生产凭据。 +5. 使用 Owner 账号选择已完成的构建，执行「检查发布条件」→「提交审批」，由**另一个具有审核权限的账号**批准后选择目标提交异步发布，回到任务列表等待确认。 +6. 正式域名的 DNS/CDN、静态页面反向代理、询盘服务和 HTTPS 证书需单独配置并验证。**Agent 的 `/public/{site}/` 是自身提供的内容探针，不等于你公司的域名已经自动生效。** -详细的操作与验收边界见 [V8.3 开发验收报告](docs/V8_3_RELEASE_STATUS.md)。 +生产系统不应在管理后台填入任意远程 URL：仅运维人员通过可信环境配置发布目标，且 `safe_http` 禁止访问回环、内网、云元数据与 DNS 重绑定目标。 -## V8.3 迁移流程与增强 +### Agent 路由 -1. 创建迁移会话：指定授权 WordPress 来源和最多采集条数。 -2. **提交 Worker 后台采集**：一次提交到统一数据库任务队列，Worker 子进程逐页采集 WordPress REST `pages/posts`，保持每页检查点。浏览器关闭后可以继续执行。 -3. 在任务中心监控扫描的排队、执行、取消、重试、超时等状态。扫描任务不会自动提交暂存内容、不会直接上线。 -4. **发现 Sitemap**：单独读取 WordPress `wp-sitemap.xml`；支持 `sitemapindex` 嵌套与有界 gzip XML，记录未从 REST 采集到的 URL。若使用 Yoast 或 RankMath 自定义 Sitemap，可以通过 API 指定同源 URL。 -5. **媒体本地化**：在最终导入前，手动分批读取（每次最多 40 个）暂存文章中的图片，限制大小、格式、原站域名，自动重写正文及特色图片路径。其他 CDN 域名默认拒绝自动下载，并形成待复核项。 -6. 检查扫描结果、Sitemap 缺页和图片缺失，明确点击“确认并导入”。将旧 URL / SEO 清单加入审计；存在未处理差异的迁移站继续受发布审批门禁限制。 -7. 选择主题后使用原有 Worker 构建网站，查看 QA 和 ZIP。 +- `POST /staging/{site}`：签名上传并生成不可变版本文件，不修改线上 current。 +- `GET /sites/{site}/verify/{release}`：签名核对文件哈希、完整性、是否在线。 +- `POST /sites/{site}/activate/{release}`：验证后原子切换 current 指针。 +- `POST /sites/{site}/rollback/{release}`：校验、原子切换回旧版本。 +- `GET /public/{site}/`：验证激活后网站首页实际可访问，Worker 会比对首页 SHA256。 -**重要边界**：Sitemap 只用于发现遗漏，并不自动解析任意 Sitemap 页面内容；完整的 `srcset`、CSS 背景图片、跨域 CDN、附件、视频、登录后数据及复杂 Elementor/ACF/WooCommerce 迁移仍需要额外适配和人工复核。未运行 Sitemap 完整性审计时，系统不能保证完整发现旧站 URL。WP 媒体本地化是用户主动触发的、同步分批执行的步骤，不会在后台无界下载资源。 - -## V8.3 主要接口 - -所有接口需要原有 Session + CSRF + 网站权限；`POST` 不允许匿名调用。 - -| 接口 | 说明 | -|---|---| -| `POST /api/migrations/sites/{site}/wordpress/sessions` | 创建迁移会话 | -| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/scan` | 将 REST 扫描加入 Worker 队列；可传 `idempotency_key` | -| `GET /api/migrations/sites/{site}/wordpress/sessions/{session}` | 查询检查点、页数和警告 | -| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/sitemap` | 安全发现同源 Sitemap，JSON 可传 `url` | -| `GET /api/migrations/sites/{site}/wordpress/sessions/{session}/sitemap` | 已发现 URL 数、缺失计数、前 100 项示例 | -| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/media/localize` | 分批媒体本地化，JSON `limit` 1–40 | -| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/finalize` | 明确确认提交，建立 URL/SEO 基线与复核项 | -| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/cancel` | 取消会话；正在运行的任务另在任务中心申请取消 | - -后台扫描任务使用 `build_jobs.kind='wordpress_scan'`，与原网站构建共享 Worker/容量限制/租约/退避。可使用 `/operations` 监控或使用既有企业任务 API。**扫描完成不代表迁移交付完成**。 - -## 测试与已知限制 +## 四、运行回归 ```bash +python -m pytest -q +python -m compileall -q app bash scripts/check.sh python scripts/verify_release.py ``` -截至本次代码交付，130 项自动化测试在当前开发环境全部通过，包含 V8.2 的 120 项和本轮的 10 项专项测试。测试覆盖嵌套 Sitemap、压缩炸弹、XXE、缺页审计、媒体格式与同源限制、子进程任务派发、幂等、容量门禁、API 鉴权等。 +**现有环境验证**：本地 Python、JavaScript 与 HTTP 模拟发布 Agent 的测试。远端真实公网 HTTPS、断网后的最终一致性、Docker Engine、浏览器跨设备交互以及正式域名端到端发布都还需要运维实机验收。严禁把模拟 Agent 测试记录成外网部署通过。 -本环境没有 Docker Engine；没有实际执行 Docker 实机启动、GitHub 云端 CI、官方 Art Design Pro 编译、真实 WordPress 全量迁移、浏览器全流程或远端正式发布。是否能交付企业生产仍需上述验收。 +## 五、限制及尚未实现 -接下来的 P2 收尾任务：自动尝试多种 Sitemap 路径、WordPress 媒体库/分类标签迁移、REST 采集的统计/重试监控、媒体 CDN 授权白名单和批量迁移压测。之后再推进 P3 XML/API/只读数据库连接器、P4 整站编辑器、P5 安全发布、多语言与 PostgreSQL/Redis 生产化。 +- 本轮新增 **原生 SFTP/S3 发布代码及只读 S3 指针网关**；真实 SSH/S3、CDN、DNS/HTTPS、原子切换在正式服务器上的验收仍未完成。 +- Worker 取消发生在指针切换瞬间时可能形成“远程已经切换、任务记录尚未写入”的待复核状态；必须检查 Agent 的带签名版本清单并人工处理，不保证跨机器严格事务。 +- 存在内容/SEO 警告时必须人工复核；系统不会自动保证真实站点 SEO 或询盘业务有效。 +- Art Design Pro 官方完整工程尚未集成编译；企业级 PostgreSQL/Redis 高可用、SSO、容灾和完整生产安全审计待验收。 +- P0–P4 尚存在复杂插件迁移、真实浏览器、生产 MySQL/TLS、独立设备设计深度等未关闭项。 -更多细节：[V8.3 验收与剩余功能](docs/V8_3_RELEASE_STATUS.md)。 - -## V8.11：统一专业管理体验 - -本版在 V8.10 基础上统一五个专业工具页面的导航、当前网站选择、业务提示、表单焦点和操作按钮。编辑器将“草稿/预览/正式发布”分组，平板和手机提供结构/预览/属性面板切换；任务中心按迁移、构建、审批发布分为三个阶段。所有原业务 API 与 Docker 服务保持不变。 - -- 默认工作台：`http://localhost:8787/` -- 主题预览：`/theme-gallery` -- 页面编辑器：从工作台的“外观与设计”进入 -- 高级建站：`/factory-studio` -- 数据迁移：`/production-v8` -- 任务与交付：`/operations` - -详细功能对照与人工验收清单见 [`docs/V8_11_UNIFIED_ADMIN.md`](docs/V8_11_UNIFIED_ADMIN.md)。 - -运行测试：`python -m pytest -q --disable-warnings`。本版在当前环境通过 218 项测试。Docker 实机与浏览器跨设备回归仍需部署后完成。 +参阅 [V8.14 原生发布配置](deploy/native-release/README.md)、[V8.14 验收报告](docs/V8_14_P5_ACCEPTANCE.md) 和 [V8.13 旧版发布验收](docs/V8_13_P5_ACCEPTANCE.md) 与 [V8.12 历史说明](docs/HISTORY_V8_12_README.md)。 diff --git a/README_V8_18.md b/README_V8_18.md new file mode 100644 index 0000000..673177a --- /dev/null +++ b/README_V8_18.md @@ -0,0 +1,14 @@ +# SiteForge Enterprise V8.18.0-dev.1 + +在 V8.17 全源码基础上新增企业数据安全与灾备工具。全部历史业务模块保留。 + +**先阅读** [`docs/V8_18_ENTERPRISE_HARDENING.md`](docs/V8_18_ENTERPRISE_HARDENING.md) 了解备份、迁移、恢复和正式环境限制。 + +```bash +bash scripts/check.sh +python scripts/http_end_to_end.py +python scripts/pg_disaster_recovery.py --help +python scripts/migrate_sqlite_to_postgres.py --help +``` + +本版仍为开发集成版，不得把 SQLite 模拟测试当作真实 PG/Docker 验收通过。 diff --git a/SHA256SUMS.txt b/SHA256SUMS.txt new file mode 100644 index 0000000..c4d42db --- /dev/null +++ b/SHA256SUMS.txt @@ -0,0 +1,527 @@ +8160c295667adfcabf7f9c1583b9d85e748c8f0da9dbce69b6cfb6fbcb1ea526 .dockerignore +df1884dd9fb98e9d34b0fc684f43477cf9fb83d5e2528735afb0131390e6d1e7 .env.example +268951a0195a3cbae90202d9ad981bd26ad47d3c9b60285faad0f52e4bad3a1d .github/workflows/ci.yml +bdb2dc0a51c3c076f6c546faac14d4d5f2adc115102d2e9e4319bfc3c955ce89 .github/workflows/siteforge-v817-acceptance.yml +2231dfe8f0e707d633756aeecc6c0a4d0528e1c6036ceab6b1d467ecf4cd2a1f .gitignore +4397605f43fd98bee2223852331757714decd30d9887635dd7a9038d794a84f5 Dockerfile +66564850ecf93dce486c2135016b93401a97eaded7f1a2bcc09fc935c7df3912 Dockerfile.enterprise +4844d1cc288ebfdd2972985778b8514edccb6601c78ab6ce26665009db503578 README.md +34520443b3e9cf65e22feaf4064a9baccb02aee2182bfd21d36c812af5129686 README_V8_18.md +e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 app/__init__.py +db344b49c6e2f26203f0726b8a58e4b0b42683276e6ba46e8e4c93562e9fdd27 app/adapters.py +51f7258c207f8ac39c6087b42d5a7c479c2ef5f0fe4f9c60eef8f311c52fb185 app/assembly.py +ecd0e4bc46440bc6ee877d9361325deae92ded21e0de6e452a041fe7a81f2db5 app/backup.py +10f7e802d61a74da656ea6c62ee47ec366506fe6fdfff1598a61aa53b6c0383c app/blueprints.py +658647e48ae1c263934ef057c2532222e09a76b98c0834d3a73e31e0d736b27f app/builder.py +d6904c6d19646457eeec64afbd018fbef008ad8efde22d099cbdfca6552ff0c4 app/cms_pipeline.py +24643585b2cdfcf95e11df7b7a42359b2c9bae4ed288a2da330ac966ebf72dcf app/commercial_readiness.py +b02659cdb9c477bf066e9da8c950b6e5e915b5cd23ccb7c8ab2be21eb9c68146 app/connectors_v84.py +76647bd3087718346982694b9669138f3fd576ed82026a31ec96a79cb194b9a1 app/connectors_v85.py +cf080514f78e5d9789885360f32a554cca7fe0e4d1c51f0543dffff744edc0af app/console_v819.py +e9275988896ce3b3b730772e77699026aa556e1968148e46372e448c9e3ba803 app/core.py +ff3510d4e1db341637b0bf36e424ad3bcc389f658767675eb2332d5aac98b51b app/db.py +4ca6961e2dcd9d4f466bd29a7805fbd41af6d1d18f48a47a90a24192118bec73 app/deploy_agent.py +9eaf38b155172c557ee432519fbb287f59b2a657bd721f57eec1d93ceb73847f app/enterprise.py +a121f181115480f136a1c632d8fb3e954c374a6ce9e8e67ffc1a2bbd4b078888 app/factory_api.py +96d7205c657dd13a056223c75e578725a75c2e32c20594ac56f655b6825e2901 app/healthchecks.py +5ab6032d3e6dc96042a41583003f830b471009dc824d5f6cba5f5341477d1d02 app/importers.py +3e8d060ed93479c1f3853473c583e52550e96192356adc9e309843fac9068acc app/job_runner.py +100922fd669f98211e268d3b0b648d4750df7e1f33774447e6c4bc2cd3f6115f app/jobs.py +9e0150e86c6d8df055b8e1baa6933938cf27cc49952c081bf4f0e6e9c62bb090 app/main.py +9f8e80c8db2ff93bcd7371eea1b7addb49dd107df8fbaff90e84feb0dd837042 app/migration_audit.py +0a5fad652f4b5cdd9400de6f6d513bc6108170c63a4773a0bc79f8f7ce3ee348 app/multilingual.py +8632f8bcc9fb6bf13c332183473a374c57798c0059898d24636cd08b739db8c7 app/pg_compat.py +b5ef8ecb5dbf3736b815af9b78f3479719b1b709583a3dfba9555c6f98b9be0b app/pg_disaster_recovery.py +58971247927d5691dfa87f515d8fbf5d9492a1255a6d22a07ee7602a0ee762ae app/preview_rewrite.py +5ff67d4a664a0fc33eb1273da6b6252d90a6fcc8b7279462b531ef4849c50fdd app/quality.py +ca604b8bf684dd26c0697b6b19d1fa0d0c872a226e631266742f10039180823a app/redis_signal.py +0bc2351993b49da4b88a94bda13e24c0a718711f16667ec71ab1b635c442b7bc app/relations.py +4da0e2c48fad9f6a833ca40f170555c0c98250c17d1ea2c8fc2e744eaad6bd46 app/release_api.py +84dc5c1a78229efdc92c0092df64c8686a005af458a68a86642d8e4c4a8a3324 app/release_targets.py +b52a4bbf946449e48300f981f69ebd06dcf3f867af5700e3135207dd9fc7941e app/request_trace.py +9a86055d047bd3966b4d7934faca49960d6fb987235e26925de1e085039a9212 app/responsive.py +d8cc021c56f50de072368e23b12c318c19e58946a50989c66455e9a948af4f8f app/reusables.py +7cde83d093289210be2759864bb686a9537ccbbc94c5cea09f7a55eed707dc50 app/s3_gateway.py +5f5612da8d182fdaa4704fcbcb2da57428e70f9b0c88fff481b1b3c316f9a6f2 app/safe_http.py +99a193de6dcf33045112535ba23d31215e77da9751ef2b1af44a7c9b9a38a855 app/schema_registry.py +9d6c1e1209470e519d38cfd480497ca110ec977f2be8186ec9eaf6a137b30dd3 app/secret_refs.py +1fbdd2973f7124c0c5858c29fa4f89e56a7a0bf7fb4369d716060f80899ef165 app/security.py +10f3a61518d579a13e8f1d7e7e75b81a8a5231d984f230c3ee48031a8f61833b app/site_design_v87.py +9a7e7e8e90071590a6cb32b5e96beb4c44fb922cea80102aa73b8a794d092d16 app/sqlite_pg_transfer.py +18d358b56f21719a9f08b78ac9b7e26f1a74f98436f8c77bd75655de4160b269 app/static/admin.css +3d8cca57b06613796b11d2f634ee694fe6c69e6b0ce875ecd0d507dbe4e4ffeb app/static/admin.js +2901d62f48ba63f4a674b566df5ff724533f858b8dc73d13f831abec728d1d4f app/static/blocks.css +25bb8cc3c567cf5298536c7b870e4b70044cc83fde1ef8ecaedb8c66ff3ae163 app/static/commercial.css +607d65720012495068eb5a1c77b9b5ff1405dff9c0ec72f672fd4b9215eee60a app/static/editor-helpers.js +87856aa2d78488ebf8af5a0f7579a108aea183bdc9d4ba5ea950e405902c9d3e app/static/editor.css +ff96eb606ffcfffeaba9e9de59e8b4b18204ecd1c14f5649c3dc9ffdcce6aaf8 app/static/editor.js +6946a8ae5c590c15bebd862d008d13a802c6572e83e627737b62d29a765e4c96 app/static/enterprise-ui.js +e00adc97487f62f8aa7b9c6866b3a0178b5b820da039ae8b299afd0ab6a3877d app/static/factory-v2.css +89a91a6305f297b5197c8da287839b83a01b69cfa088ff3b694315bf2a4a70ec app/static/factory-v2.js +90ee3adaf693525b87e1d95fc49652573decf534a2abf742113ffb620a85897a app/static/factory.css +46acb1830cf8065a172036984bcd6fa496fb30a69785ae934507fe8d98b62fa5 app/static/favicon.ico +ea0192e7a6c11f21053ad57bab7c62f7415c6d19ec42b107b555a651d524d08b app/static/operations.css +b90a776a6215f5843522ae0cb2c49ed2c46a9c6f05d619942c14e7665c2fb377 app/static/operations.js +a5f356afed6bf4a4a72a95b5152a8a68ce48f418a7c12aa2b052f511e84751e1 app/static/pro-base.css +f681ff6686f296728c0ec7addd056994f9960ee87e751560c8dc53da339db531 app/static/pro.js +a3161924f80590a4f252690d9949faf36dc0591f083f2d38bbddcfa9592842d7 app/static/professional-ui.css +afc4b234f8503147e2ea4840dc6d6386c65dd216d3b66664c07dde76f2331bfb app/static/professional-ui.js +a76917b83e1c305b4d07c1e8fd28cbfdf36e1955a83d36a465f83e572cb6ed7b app/static/site-runtime.js +3bf16dcaf0e85e3cf5d4ab204fa5f60480e1462be865ccb8656a5b655b32933c app/static/workspace.css +3993aae17a23540c7579d90595175ad84b6d838a52701212a912c7090d705143 app/static/workspace.js +d1b0719a7cd9e202867cc28c3a6b2310c446e21b6f58d91d92684aa13ba3b419 app/static_site.py +5c2fafa38683d2dff8ac275a6b12b8daab66f592ff07c19da959955ef6b20773 app/studio_v86.py +2f909fbe08b8c2f1bac0af5c58fbbb74b61bbdfbc02ac1694a86832794609a5c app/table_loader.py +00a2966ac9fabaa06488c2644b00868293fc92d9a44bbc0a92d7f5462947dd54 app/templates/admin.html +d0980087a43c4480a07c0043d26bb8ca83d0641c5dcc90fff8d13d08efa03577 app/templates/editor.html +62e89984c93a510f3b2d9982fdb0ca7983a750c54d2114d084f49df6ad6bb6c9 app/templates/factory-v2.html +904db5703893e3429a1006e3b40f2c85317b2846ecbd2759b001dc8fb0dfb39b app/templates/login.html +01037e8d9e41248ae05472cec13e4ba8a8fb7a845e1a839196faca609c78e445 app/templates/operations.html +04a3826e0bca24a5050e6a673507476376fae3d24f33f8e0202931893defb175 app/templates/production-v8.html +8818fe0aea672ac3acf93e674712f0c965792183f292d85623b7eedbef5ed8a2 app/templates/theme-gallery.html +18cc2dd7be37a61879d29ab9f0ced42ee252e503c6ab97e5fb5d79095459beb7 app/templates/workspace.html +8e46c4e5ae3555cdabf542aaa4adfe6fd76ad2ba09b5264fa799ce54fe465dfe app/theme_pro.py +8f79878f39f1b97aa9cc3d7d30a79d58b30514518e271add02d81fc7ff8827c5 app/theme_store.py +b81a089c1a1aa709c924fa97f5b097797e7a28550f1c0d51854e5d392f4f94ef app/v8_templates.py +201c84875d4abb20d38fb79482ab0de075c911a2f1535d3ee44b1135e57c43f3 app/v8_workflows.py +06c36e6a4563535797c9ca56f6b660dc672832e3de4c5fa8e2e005a875988f20 app/version.py +9221fed981059ca2636d2201464a73af5ad200146da42beee23e936a1739a47d app/wordpress_compat.py +01f1ffe2f905bbfc28a8cd4f976d613b6866aac70491950f0acc1df4cffdf4a0 app/worker.py +a81c904d3b52af6b0be8311c1a22f9d06dc457b2f0502ed5e0eccd47e916f4f5 app/worker_health.py +49b6f9c88cdaa0f438e278347cb44302fee85f448812571dbf25984526c29683 app/wp_complex_v820.py +fbd08f545111f0c3f8c93e2a086bfdfd74aeecafb31c7dadf832b23645d09f17 app/wp_migration_v81.py +91fc8c973afcd3607f68de5229e305b359d22f269239af2932f173a89c1b2d59 app/wp_migration_v82.py +b360582b75e2f1ec88362777d10cd2cdd2af8c3342b10c2958120978970b8a95 app/wp_migration_v83.py +88057ac3b66fe3aa8c721c399aa215a8bcdee78955d7a4247415bebb8d2642e8 compose.agent-secrets.example.yaml +8e40d12416362d6a05d33482a22802b8142388bce1d05762a22d7abcfbf592f4 compose.enterprise.yaml +d040afae76ea42f5b50d39526f8e8e35afe6bf121b1d861859abe103fe5e9172 compose.mysql-secrets.yaml +e1d68ca913864ea297b3423e5e388d9d6682114b6f5519879facd18a61f54358 compose.public.yaml +207375844eeb51d1d860e58e1f61d633638da6c272009411e04d450a8bcb1ffc compose.publish-targets.example.yaml +da6ae00325e4c3f2a99c71af8d63017c9ed267aeac9c2898f6c452e4e4e14241 compose.release-agent.yaml +9ecab06570c12919d93c697374d49dd37a4dc2a4ff49895471ac037741572fa5 compose.release-secrets.example.yaml +1de018c7b19334035772a10b42dc14d6204ec3a5710061a5d98ff8912b6503fa compose.s3-gateway.example.yaml +506e1c126087393127448202d37f5d72684b9a189e27aa07a9919b18f89f1eb9 compose.yaml +0118e47006525bea623dd260ccc614b65d327016ada007e8dbf2c6ba24346697 deploy/Caddyfile +77f7036a1c0c72b3e04aa5197d820b968fc2c646b86679b2b0527613e8cd94ca deploy/art-design-pro/siteforge-nginx.conf.example +4f8fef885de20660176a05e717c062fdf570dc8d19b8a20343e85c966ccc3bd5 deploy/native-release/README.md +397ea1a45decb52c1e04b1f54bd725e54eaf84dea0f4c4e8c6991d26caf18de3 docs/CHANGELOG_V6.md +e0bd3ccaa54c4dcc51188f74420aa715285b650714eb2003b0b49d1b6186518e docs/CHANGELOG_v0.3.md +7dcfe5731c35539fd888854e1628ab8cd58a6434b2d7513f6533e246d8755fd0 docs/COMMERCIAL_THEME_V5.md +23dcfc4bb981ee647e8d4d8fc27367d22dccdafe526642d18bb3cf89aac1504e docs/COMPLETION_PLAN_ALIGNMENT_V7_1.md +d2ddc1ab9f40ab47c4adb8c4ffe599d0d4f003b8ef9323fdc1761d9187c1a8e9 docs/DEPLOYMENT_V7.md +7d63e0277e25f1b4284993be70495cee9ec81e3802ab9bd14ab9e62506ae770e docs/HISTORY_V8_12_README.md +9019aa7ae8548b9a9e6d29fc7860840a700bebd995d4f0c5bd131d3376754280 docs/IMPLEMENTATION_STATUS_V6.md +ae44d4843744f6dbdbe05dd6b348057158fb5c265bc57a4ab3d32717ef1877ac docs/IMPLEMENTATION_V4.md +258d09112cdbb4b6e11fc46d5670f1bfc1bc9b1324ece1b55ce6e1c3311831c8 docs/OPERATIONS_V6.md +3ca12f1387b066ec52c70fe54bf0eaceee77ca253e6676d5cd374f7958a36fd6 docs/P0_P4_ACCEPTANCE_MATRIX.md +30d9fb7bd0440434a3ea7647f026d0500dd5672afe99f3f69e01072235e231b0 docs/P0_P4_V8_9_VERIFICATION.md +9f22777f9b5b9223a8faad5fd00ece0a83e993ea7dec7a7a463bdd5c22400b26 docs/P6_QUICKSTART.md +cc5bd537c9f4c509c0999ff954b7a9758de5bc39754be62c3db5e0bfa91bc16d docs/PRODUCTION_ROADMAP.md +b1534e64fbecf1a8b1f642aa25f639fc5f89991c4fbc9ab511b9398246c054d8 docs/RELEASE_STATUS_V2.md +edb33b5f5b482591a01169b88d7ce688894fad69e8e2d3f994edbb653e382d90 docs/RELEASE_STATUS_V7.md +510349c284b7e44dcb9e8a8f92091f72c3e9cdb060d6364c5e2a430f9eecd304 docs/REQUIREMENTS_V7.md +df960ed41279c51cfcc0c7814bb62d3ffca01c42eb693c5689ce9e871774f529 docs/SiteForge_V2_Architecture.md +f3a8d60d2deb0f0b016af3a7ce19801fddc2ae8ecf6b0884aeb050a478e48ddf docs/V7_2_P1_IMPLEMENTATION.md +1c3f11c9faf2bf875f3d4121fdc726c1b8dab6e6f33d96a83f7e416c9f342e26 docs/V8_10_RELEASE_STATUS.md +46700ee2a818abed56ce76104490ea4d1f9ce093acc190ce98c1bf021c7172de docs/V8_10_UI_GUIDE.md +e5a86662ee9660dc85bb7a7b5cb3e535a5b32e6eb613f87fe3247cc77ee6cb10 docs/V8_11_UNIFIED_ADMIN.md +32a200865516375159c8948d61ded9543ed9cd91b99ad21f38e52c506225739a docs/V8_12_WORKFLOW_USABILITY.md +39bcf6c6fd02d895fd8151e499ce840fd7107ee3fecee624c43dd1d6a0f897d8 docs/V8_13_P5_ACCEPTANCE.md +ef6a3fa525d5e31d71f06d4ebbaf035e9e627bdf38cf23786be9aa8798b050ae docs/V8_14_P5_ACCEPTANCE.md +db7a5d1833e0fe15c9d5f49a3c456b49138a54675f50aded9aa317eeb742b140 docs/V8_15_P6_ACCEPTANCE.md +5e6c5b06fdededc3092302c260f4ff1b7a785cabfea41885b5af2b4fc5641ba1 docs/V8_16_PRODUCTION_ACCEPTANCE.md +877683f0dc74e564bf3f66c41972421f168773dfaef7c446336b313567b83959 docs/V8_17_ACCEPTANCE_RUNBOOK.md +8ddd24fc7559f9a85e0ef8d4c02fa7ddc034c063f08e6835cfbd6bc1c5eb9a0d docs/V8_17_INTEGRATION_RELEASE_NOTES.md +f20f02ccd342cd20d93655fa425217dcd103228b69634d1805bc89c3b301e84b docs/V8_17_INTEGRATION_TEST_RESULTS.md +46ae264dd42eba223ead7ed1cb3c4f6bd4f984d80bac2a72edaf36554a46b0b8 docs/V8_18_ENTERPRISE_HARDENING.md +bbf9acbb3ac38f62c22672136a763fc3c7bbbf97de6e5be3f843b0a3ad8b72ff docs/V8_19_ART_UNIFIED_BACKEND.md +3435a4d9c74e7b79022dbcf02e87561c9831323f05000b6613da3af0238b4416 docs/V8_1_RELEASE_STATUS.md +0772375d9a8f9c5d946e6e5c12ed3e6b87f1027ae17e0540cbdddaa0105e6cb8 docs/V8_20_COMPLEX_WORDPRESS.md +e7f6cb5ac850b9718ccc028c357b0bc728447da27eb946fc192537387a83ffaf docs/V8_21_1_STUDIO_UX.md +34f62aef43df157e9be0d0d805f66a1e8b56994b4e2a31725d5db2e9be5aed0c docs/V8_21_2_EASY_STUDIO.md +d00e37927e077dc96c0b5fc6620d39059b10a6e6d8e4e2c7a6639cf884c0c856 docs/V8_21_3_MOBILE_THEMES.md +fab1525c484f29564b9d5e1f81cd4f301429eda5f6fb1e5f5d277e68d3231d97 docs/V8_21_EDITOR_AND_MAPPING.md +4e0d51f96458a07500f609a891e77d05c6e27ef8e744c49c84073cb20f38084d docs/V8_2_RELEASE_STATUS.md +36c9baed7a596e2a50c487d985a4e035f935f9ba322ea4d89320e623457dc96f docs/V8_3_RELEASE_STATUS.md +bf1784e8616e5064df8c7d846f9f6fe1d6a677e1935e04824a2d663209ef62bb docs/V8_4_RELEASE_STATUS.md +9d09d3a943ecb41a1a92e994cb65d569212b8888e0585be24100afedf8552b2d docs/V8_5_RELEASE_STATUS.md +8dc46eee0205ffa5c5d6ed56c9e1b030c7b94d5e55df944b5e15247070fa24c8 docs/V8_6_RELEASE_STATUS.md +235951d21e66fb6b0eb784f00da4d4f51737e3a91f8585a133d4d626eead17b6 docs/V8_7_RELEASE_STATUS.md +0f1bd9c80859c099becf6b15c54bd896b1ca31707b448856000fbcd0592b7046 docs/V8_RELEASE_STATUS.md +5e94b8dc8efa5e65a072c0369796d90036446c55aa92c2bc951e8e0b0724cc31 examples/Studio_V8_21_1_交互预览.html +51b6a38ef26133246201621818b86a041866744787b620c43381a545900bbd2b examples/Studio_V8_21_2_新手友好版交互预览.html +503b72f32f10af98dd8e42636d5b5546d49f39d375738927e4f31af43af338eb examples/content.json +7fc29633073afe33fc6eae6a46ff380c1fd974fda205e998ed48d58a7042d9a5 examples/declarative-theme-1.0.0.zip +440d212d5101d8b6d4b53368c5929f686ca0e998601e2200c320e99396b373a9 examples/evidence.template.json +d7734fbd698070aa0e62cc5d1c3ae19e3be9e625fec97a84b9cdb4325c0c7c69 examples/mobile-showcase/automotive/article.html +2901d62f48ba63f4a674b566df5ff724533f858b8dc73d13f831abec728d1d4f examples/mobile-showcase/automotive/assets/blocks.css +25bb8cc3c567cf5298536c7b870e4b70044cc83fde1ef8ecaedb8c66ff3ae163 examples/mobile-showcase/automotive/assets/commercial.css +ce99b22d93867c3a1ab2d6f8344244f5f476f4b9e3274aaa92612a4d48a6c0cc examples/mobile-showcase/automotive/assets/custom.css +90ee3adaf693525b87e1d95fc49652573decf534a2abf742113ffb620a85897a examples/mobile-showcase/automotive/assets/factory.css +a5f356afed6bf4a4a72a95b5152a8a68ce48f418a7c12aa2b052f511e84751e1 examples/mobile-showcase/automotive/assets/pro-base.css +c4fdce0a226a3e952424fc72225d9a48f285783658889aa913c8e065ac0fcdd3 examples/mobile-showcase/automotive/assets/pro.css +f681ff6686f296728c0ec7addd056994f9960ee87e751560c8dc53da339db531 examples/mobile-showcase/automotive/assets/pro.js +4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945 examples/mobile-showcase/automotive/assets/search-index.json +a76917b83e1c305b4d07c1e8fd28cbfdf36e1955a83d36a465f83e572cb6ed7b examples/mobile-showcase/automotive/assets/site-runtime.js +7740f6529507f41901eb08e8d923e99e05e918e0ac3eeb35a65cf807da68cdfc examples/mobile-showcase/automotive/assets/theme.css +732a3d37ab415f4e877d9c7104b81c3822c931757801ca1f7b1bd57a23579d90 examples/mobile-showcase/automotive/assets/visual/hero.svg +b04f9fc7cada56dd9da42c6f19e9aa99c80e4c35723329649424f98681591e5a examples/mobile-showcase/automotive/index.html +354aa639424a8f72b230db973fa742b903945f4de87d4c99894cdf7c5abe45ae examples/mobile-showcase/automotive/listing.html +88c35a63bd8bbeb0d295eac40133634b2216d0af370ee18646c415be66077656 examples/mobile-showcase/automotive/product.html +67eb36ddd801d473d384dfb87b917d59c8705d28b67b1fabe24e0be9e54c7a98 examples/mobile-showcase/corporate/article.html +2901d62f48ba63f4a674b566df5ff724533f858b8dc73d13f831abec728d1d4f examples/mobile-showcase/corporate/assets/blocks.css +25bb8cc3c567cf5298536c7b870e4b70044cc83fde1ef8ecaedb8c66ff3ae163 examples/mobile-showcase/corporate/assets/commercial.css +ce99b22d93867c3a1ab2d6f8344244f5f476f4b9e3274aaa92612a4d48a6c0cc examples/mobile-showcase/corporate/assets/custom.css +90ee3adaf693525b87e1d95fc49652573decf534a2abf742113ffb620a85897a examples/mobile-showcase/corporate/assets/factory.css +a5f356afed6bf4a4a72a95b5152a8a68ce48f418a7c12aa2b052f511e84751e1 examples/mobile-showcase/corporate/assets/pro-base.css +5cf231b4fb89bb47fd18961214a197823ab24daa3df1c2e445ad9576532f0627 examples/mobile-showcase/corporate/assets/pro.css +f681ff6686f296728c0ec7addd056994f9960ee87e751560c8dc53da339db531 examples/mobile-showcase/corporate/assets/pro.js +4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945 examples/mobile-showcase/corporate/assets/search-index.json +a76917b83e1c305b4d07c1e8fd28cbfdf36e1955a83d36a465f83e572cb6ed7b examples/mobile-showcase/corporate/assets/site-runtime.js +7421696b8bf8f210a13663e20e6078aa1dcfb35135ddd489eaf4b9a14954aa8a examples/mobile-showcase/corporate/assets/theme.css +8eb9ae4b3bdbd778a9931079cb393fbf2789c2ce9f3226e47f903f9dd35cbc3f examples/mobile-showcase/corporate/assets/visual/hero.svg +3e8bbe485cdec6d1a82f7509ba85eb81daec7118fa971b53b15341f9b721c3f1 examples/mobile-showcase/corporate/index.html +0472f5dee2073fcbcf107d9d9c62e8b17e625b80a09058c401bc37a918df1965 examples/mobile-showcase/corporate/listing.html +328307b5cae28b6df2215c13f5866824b334c9f2b082995a6fb635bc7414ff45 examples/mobile-showcase/corporate/product.html +2a41272ff1f4213028d802d0026210859f7951c4ddf9a9696c616b988f3c2acc examples/mobile-showcase/index.html +1dc0375e4a703408a266c5cc9b827cd6c6dc73f7a8ed6af92ccd473cfdbfecf5 examples/mobile-showcase/industrial/article.html +2901d62f48ba63f4a674b566df5ff724533f858b8dc73d13f831abec728d1d4f examples/mobile-showcase/industrial/assets/blocks.css +25bb8cc3c567cf5298536c7b870e4b70044cc83fde1ef8ecaedb8c66ff3ae163 examples/mobile-showcase/industrial/assets/commercial.css +ce99b22d93867c3a1ab2d6f8344244f5f476f4b9e3274aaa92612a4d48a6c0cc examples/mobile-showcase/industrial/assets/custom.css +90ee3adaf693525b87e1d95fc49652573decf534a2abf742113ffb620a85897a examples/mobile-showcase/industrial/assets/factory.css +a5f356afed6bf4a4a72a95b5152a8a68ce48f418a7c12aa2b052f511e84751e1 examples/mobile-showcase/industrial/assets/pro-base.css +61e5ee68f42e743ae15da56c5f18cafc941e276cdc6c863e45bc8daae1023edf examples/mobile-showcase/industrial/assets/pro.css +f681ff6686f296728c0ec7addd056994f9960ee87e751560c8dc53da339db531 examples/mobile-showcase/industrial/assets/pro.js +4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945 examples/mobile-showcase/industrial/assets/search-index.json +a76917b83e1c305b4d07c1e8fd28cbfdf36e1955a83d36a465f83e572cb6ed7b examples/mobile-showcase/industrial/assets/site-runtime.js +a2e30bcaa8d4e15658558531329c177c1aecfa980cf36fe001ed5effa38ccd93 examples/mobile-showcase/industrial/assets/theme.css +75d4bebbb077e5af36d4f9383f893c91a8b45db1ffd91dc6e2d5107daa849006 examples/mobile-showcase/industrial/assets/visual/hero.svg +0d1f318ff83c436b3ab7fb3405df67109c188ef5bee59816685360d8d88edb75 examples/mobile-showcase/industrial/index.html +a3473c04afcaa2db36fba5604e59944ac6434ac6fad1cd4daea4831e5fa4b804 examples/mobile-showcase/industrial/listing.html +74f7d31274ea7944df622e6502fb35f5c832808c068d4c394ebf7e44d6791fcd examples/mobile-showcase/industrial/product.html +d3ea10d5c1cbd84df83456421668044fdaafd0f0c4de730f8d17c5cfca870d9e examples/mobile-showcase/minimal/article.html +2901d62f48ba63f4a674b566df5ff724533f858b8dc73d13f831abec728d1d4f examples/mobile-showcase/minimal/assets/blocks.css +25bb8cc3c567cf5298536c7b870e4b70044cc83fde1ef8ecaedb8c66ff3ae163 examples/mobile-showcase/minimal/assets/commercial.css +ce99b22d93867c3a1ab2d6f8344244f5f476f4b9e3274aaa92612a4d48a6c0cc examples/mobile-showcase/minimal/assets/custom.css +90ee3adaf693525b87e1d95fc49652573decf534a2abf742113ffb620a85897a examples/mobile-showcase/minimal/assets/factory.css +a5f356afed6bf4a4a72a95b5152a8a68ce48f418a7c12aa2b052f511e84751e1 examples/mobile-showcase/minimal/assets/pro-base.css +0d435209536c0c5880c009d7e092dc3e554001b42aa52f83a28d0853d89a54c5 examples/mobile-showcase/minimal/assets/pro.css +f681ff6686f296728c0ec7addd056994f9960ee87e751560c8dc53da339db531 examples/mobile-showcase/minimal/assets/pro.js +4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945 examples/mobile-showcase/minimal/assets/search-index.json +a76917b83e1c305b4d07c1e8fd28cbfdf36e1955a83d36a465f83e572cb6ed7b examples/mobile-showcase/minimal/assets/site-runtime.js +de2d571429238c261a8007c4ab0b9e21248bf86d5a050993795f42d508c4ea6b examples/mobile-showcase/minimal/assets/theme.css +a6354fbf3249d11acf8d3aa77bc9f541a1db37d2f2a5dc37141509635cf428c1 examples/mobile-showcase/minimal/assets/visual/hero.svg +7f0b6cfac7eb54dfa25ebeb9c1bf39019270f65f5909414da9e9b4fd120801cf examples/mobile-showcase/minimal/index.html +bb6aa568cfe3dd88f1a578b97e9c44bb51b40681c29d9b0a5bcceb374e12265f examples/mobile-showcase/minimal/listing.html +c39f5992acb242803fbbb90b4ba471307e3d01b99732aa9044ed271ba2945a5a examples/mobile-showcase/minimal/product.html +e66cddcf207d131a56b27dcb000a61edee12093a4dbf9aacf80a6cf993479fee examples/old_urls.example.txt +1dab822b685885be30fc3d863178aec3d39c63c63f7ded989e203d5f2c2ba3e2 examples/products.csv +085c9abf8a24acabf4926930ff66d59af54db2f67464a33c9ed7259506fa68ce examples/professional-theme-1.0.0.zip +4536502b97660b9e7d4f428fb30799d626df76a3b6282b0fdf895d6e1958e695 examples/ui-preview-v811.html +44124c6090bf9a5cc1cb83b20cd8114aa28f0bf2c621d02e9eb46d647c5fe887 fixtures/v820/wordPress-complex-sample.xml +4ee8162d3036fb75250fe31474ab623ea04d848fd1fefe5e89a88a0ff481ce24 integrations/art-design-pro/README.md +073da020b5d75954912452e4631ce8262cace5c1604fbc456c5e7a3fad98881a integrations/art-design-pro/src/views/siteforge/ConsoleHome.vue +87ab2867880c11e1cf8622c5866bbbc90f64d36d0fd0ea02f1b9c5cf71516eba integrations/art-design-pro/src/views/siteforge/ContentCenter.vue +9033a7d39950ddd2aab946b563b1219aba24a083f4b9db6ef4f14bfb425c5afd integrations/art-design-pro/src/views/siteforge/EnterpriseCenter.vue +d122d4e7e8812592bd068ed6de9ea7e47e4254e96edba3927f4cd03526aab640 integrations/art-design-pro/src/views/siteforge/MigrationCenter.vue +fc40cdd757e74c2a6191f292f6f5942d584b09fa108f6074a5b7f9d384a83766 integrations/art-design-pro/src/views/siteforge/ReleaseCenter.vue +73e487c0332b1cf8c76f4633847132e3c2f7510ed38e667367885608e2140fa9 integrations/art-design-pro/src/views/siteforge/ThemeCenter.vue +883300e6de94bc1273de0b0406b71d6c5ee26e6b67366f5c6d84dd83cfcfe221 integrations/art-design-pro/src/views/siteforge/V8Production.vue +df08341b3de99a068b807d4f9f70b98381da3953703fcfacf8a2182887a00b83 integrations/art-design-pro/src/views/siteforge/VisualEditor.vue +3569d331c2ccc7b938641d20906791ea71d829dfc6bbcd839478c8e575587e97 integrations/art-design-pro/src/views/siteforge/WebsiteFactory.vue +1c330830a66f780d882c4af8d75c4dcd298da0c200c9eb577b8feff4e21e7400 integrations/art-design-pro/src/views/siteforge/_shared.ts +14fb28fdf4ca5b427455c60b5740884eef6403b53448330af8c9e66c497f69de pytest.ini +aed398c04846446a0068e49864b433dc172256a47045fc8cd387f23bc1257b7f reports/V8_21_3_移动端验收总览.html +e34f8dad614495ce4f6d2ac5d2e7a648687b6bb5f5bc4c64a264e129e39ff4ee reports/V8_21_3_移动端验收总览.md +fe85e9bf26f194ca93fff722b762754353e45e3f4793f236c974b5f5126b0312 reports/mobile-v8213-automotive.png +f73fe5b8a039e8ce271d30019c35b66a779ad8b87f0f77e0c5b7bbcacb788279 reports/mobile-v8213-browser-console.log +b7eb359bcb20c7dc02ee5d8f01f25c3505edc8ac2046854f22bb4591a84b0b61 reports/mobile-v8213-browser.json +80eb1be649f258ba492e642c87fdeb111cb0d53e0e2c0d724cb23b1b6613eddb reports/v8213-final-regression.html +2731550949eebf7f1186b739eab480efa9d2a122b1ca4691744349cc1d8a32a0 reports/v8213-final-regression.json +155026cefbcb8f4462bca111b8905630dd553386f6c6eeec2bb24f0256bde763 reports/v8213-final-regression.md +bccd0fe89f389f9c326564b6972f1314d6d070e28cf17843f3aee382f2064e4f reports/v8213-final-regression_logs/round1-batch1.log +2996dea9e66555c38d4542851628fe61e1a80c4eb2ac0329d0e82fce495014f2 reports/v8213-final-regression_logs/round1-batch10.log +81294ee87af2b756b3f9df3b7c9afe615001ad7304ca1447b467c64ad4ea2665 reports/v8213-final-regression_logs/round1-batch11.log +d8c9922ea0fbab88bd1eed0d001ad52ca98b17975d38e8deea4d0d9fe596b35c reports/v8213-final-regression_logs/round1-batch2.log +ccee3d2db6d9ff75baee8b9dbbcb4fdcd91b625e58c5cd836aa2a10efac7911e reports/v8213-final-regression_logs/round1-batch3.log +66c175f4a4b7b3576568651d441da4525db12c47767db3eae02a4b7235444133 reports/v8213-final-regression_logs/round1-batch4.log +34874cfda7987f0684900823766877380611f01ffa0d2c873f1d3f62f3824a05 reports/v8213-final-regression_logs/round1-batch5.log +1349efe3a1e55822e9046da7fcaa69f267ba11d1c1ab2d686ad4c1f16bec1082 reports/v8213-final-regression_logs/round1-batch6.log +11405b9c8284a798c06ddf50a2449044ec75b1c05dab52cb2fa89c01cb97187a reports/v8213-final-regression_logs/round1-batch7.log +8aa1edc5aa0ce2b01868824ab4cf96ed276ce04d9df0dade875489600eb09d1d reports/v8213-final-regression_logs/round1-batch8.log +cb005c22b63c340f23b9e7ecb111adb1569d664c7adc86c17c5f633c2912421f reports/v8213-final-regression_logs/round1-batch9.log +db585d1d9ed9dc7f295f9d3b7e8de6feb404f7a1767a80af55fff013c0f66c1c reports/v8213-regression.html +1c4b559441cd0e23dfcc3cc06cfbdbf498f3c2b8c77d6644b522df24f07f1fa8 reports/v8213-regression.json +fc43c8ec6d31b09ee7c3ed7c66eb38c64adc496db6145549e6356e2fe144bf36 reports/v8213-regression.md +45f589873f5c916eb42add4ab200541cf5420952826ea9c24867df465c27d924 reports/v8213-regression_logs/round1-batch1.log +03480b3f6b08fabf693ac994947849400355a281fd6106cbda1856959fad2c1f reports/v8213-regression_logs/round1-batch10.log +d74edd2dd15c4ab9d486b04cc9d6884af7898430fbaec52b6735dfab8021dda1 reports/v8213-regression_logs/round1-batch11.log +8a47a9eab0220194e1480323a77e540efae2f82c0300876591df5bc5321e3185 reports/v8213-regression_logs/round1-batch2.log +e1470a1a5fcd10be3f13a7504c36476b352c1db04b33922e2ac644eba58ee44e reports/v8213-regression_logs/round1-batch3.log +c0af4e5795fd4d0f3c7c2a0e3bb590f07d7d0bad32ba9112560116c0c0018609 reports/v8213-regression_logs/round1-batch4.log +788b4648d0418ed36d8adfc915087e7ffa04a893948e610f2f6f4b7fd4f61edc reports/v8213-regression_logs/round1-batch5.log +37dc6d8499e020fe985c94a4a0a60c4e0d43ab3ab6398d002bd2865138b9a48a reports/v8213-regression_logs/round1-batch6.log +8e784c828267469a6bbdae17447fd6b67c3a74356e40135e64b09cb293e26eff reports/v8213-regression_logs/round1-batch7.log +72f1188a1c8a390ecb9717abad33af7e54f39e2da75f31a5c3880765a2d8f8e0 reports/v8213-regression_logs/round1-batch8.log +4106fa4b2a15ae04b87be8a5718aa203446b26f04cb0ae66fab5272beb4247da reports/v8213-regression_logs/round1-batch9.log +c3a84856b2f24bc42d1906b9cc13c7183fd60893b5bd3e2584316ba0fbb77aba requirements-browser.txt +b407b691bd09d8971eb740b15c00021e7cf2768e380018314ed37b6dd54b7788 requirements-dev.lock +415388e890176d100337197eecd02090c4c2ed119961b7b33f1dfcc53f3522ca requirements-enterprise.txt +0495f1025cd7943144431002ae4b2ae2e97d1157ab2d3a82809d670afc22bd29 requirements.lock +2ceef8bf20d5bb17820cafef0de12378c734258138625a84b831d8e4f4ecb2b5 requirements.txt +3472ece8dd8c050ca617006abdc59578cfdfd4637a965471285d0af3cb17edec scripts/browser_mobile_v8213.py +b7a6785b246fd03c2f52cc81fc65c1fd6b4854227589affd49f8f65b908d6851 scripts/browser_smoke.py +6f8669b936445cd70e4ef355d0c9aec58c12690889dacd594533cd3b0f011886 scripts/browser_studio_v8211.py +721166cee5860e1c73520fec92340235ed57e8fd2005d8d6b2e9fcd8c012da40 scripts/check.ps1 +064248f80aaa5a6b712a45a7d0ac5713b7a7bbd40c95f571f80f17e8ee281f38 scripts/check.sh +4562fa6d09b05019431844a2580c9c76e7f22ee09485369bf8f37e5daae7e161 scripts/demo_multilingual_v815.py +cb9e388ae3229befbe684a417b225994c73070ccbd7668091a88edcc23c2194a scripts/export_wordpress_url_baseline.py +1418c04906f368de1da191973ec30ab1607b6cf8a19f5e4b919c47581089cfa5 scripts/http_end_to_end.py +f60422bf26c23e55dc579d1faaea29a0f413df3ba7f4b0ba81f2f42660219c93 scripts/init_config.py +8c13463a2b4f90c47f587b27bbc855d08a0bcd0df095c63e67370ea1c1f2a7c0 scripts/install_into_art_design_pro.py +288456a27bfb073ef0f318e699867f09d2e63b63f500f4a2dc454fd8e518553c scripts/make_demo_v87.py +9fe93353fd29e9024bf3ec5b8f5db0aa2299bae95c998644ca1700539d42bad3 scripts/make_offline_preview.py +cb95b024c432d2f0e038e24a8d39921a0ea3c671bd4407372c261d568250812b scripts/make_theme_demo.py +b455260a67f8e7a0d24c3bcf11a9d97e3457c9e5c232cbdc4b1102ad11c0f0ab scripts/migrate_sqlite_to_postgres.py +85d99354794ae3b8d109ab80fd0f14a9f8761938ba0e3d0146421b41e53c0a9c scripts/pg_disaster_recovery.py +ef879522a7767f444479691edf727f85b35164b9a981b86375cab9e548f49851 scripts/pilot_5000.py +0d8cd086eea69171269c529ce47a844b32ccedce0186386cab30de363fa468d3 scripts/regression_v817.py +deb8e1829d3472b7563c3af65545115ed172ccd7cc94fa34302c4c4f86cd08b1 scripts/regression_v820.py +d8521180e05e701045d3baac89119eb23e48559a5a0536f74949efac5763f6e0 scripts/regression_v821.py +5bcd06b744b4e50c9a6e8783df723723588ba42ccab85bbcb5808a5ffb3bebc7 scripts/restore_backup.py +7b08a9c8393cd85bf5b43f90d31824e69152a9ee0aeb85355dc246315f513347 scripts/siteforge_v817_audit.py +94c64376f70178f209966ed64ddd1ef254b22cc17c1d1925dfe48290f8ef0a00 scripts/split_theme_pages.py +d3a11a643472bfa09113dc22a37ba05a44d457050b9831fbf46e2d6f42eb8bef scripts/verify_art_design_pro_v819.py +d5309478ede3ba625d585dc2837f75ca1bcba558de167d1515bf144e222e06a9 scripts/verify_pg_backup_restore.py +fc706a2157f928c2f0c20162833e0ed81a806928a4fd40de75891fb6ef1d93d7 scripts/verify_pg_bootstrap.py +6bbbef44fae6d78bd2bf0cf47da82231ae378ea10109368496ff7ae181a0c8a7 scripts/verify_redis_signal.py +d3b624bf4599f77f2dda3b1270c0ccd67e3b3fd84f7b97ab83a7ef0910915e44 scripts/verify_release.py +12e3ff67f6da300ae4f960815aca55e081fadee785dae293ff18cf3f1b86bf8f scripts/verify_sqlite_pg_transfer.py +d2b8733a3a7b30bf891e26272bbfe117c588f20030695bde7880258b371b606f scripts/wp_v820_preflight.py +b672af10eab58394677df926007198711bb875e220af68240c53a41e8dbdefee scripts/write_v818_acceptance.py +0af611f0ef2abb27424b6e1991d63fabb9b58c715e6c14fde959d4c02fa9b93a scripts/write_v819_acceptance.py +e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 tests/__init__.py +5dfe8c77e631ffe7932d4ac635ae4d1fa497ae79f943e3748100e1516e7df649 tests/legacy.py +e796c595978c128f29fe76659d3abae81f3d925ff1eca4821fdb31438fab6a91 tests/test_commercial_v5.py +24638cd075fc3d43eb9f5c9043b53f51ffda9e0be399b36866b0aeec5da9948b tests/test_connectors_v84.py +192f4733e41451337ff434456fc4fb36a92bb712314b186963eae2c8125da060 tests/test_connectors_v85.py +26aef85e219e62f1052f862789e5c4397f50c2dbebf8b8d7a4f9633f2fe2030f tests/test_console_v819.py +231750efdeab991c8e5250c00f7552f15e770c4d9fa302b9b7079c5c6621d48b tests/test_core_v4.py +a8825db764cd07e622de87cec32ec7b15bcb58157b9bb1ad4bc095b876653200 tests/test_editor_easy_v8212.py +dfa352ac631f2e941dcde007e2276b83ecfab118cf4a5c79e5484b3f01b6ba14 tests/test_editor_ux_v8211.py +52258cce5592a449aa8a6ceb13aee8f013faa4bd7828edd740a652b86012e3ca tests/test_enterprise.py +4ea173ce905b62d83a02347001036acd1dd36c0436fddeebb7af2ee0801e5c07 tests/test_enterprise_v7.py +f3243a938041fbfc8e8657dc3cac3b878069c8a41d05353ac4bdbfd4d0853e13 tests/test_factory.py +8f374a6a1b55e450e571d21906decd27604e48435797fede7f2f946948f66937 tests/test_factory_v2.py +3380435fe0ad3dc7010836720b50b2e06361cfe16ca093278fc4cb431faa4e63 tests/test_mobile_tabs_v8213.py +84fa19aacc1d25308b498413b6f6179f709d4887171334929becd7832200cfe6 tests/test_multilingual_v815.py +c5cf789733593e695153c7a70577b8f83980c37632ca0534ac08fc2a3cb772a5 tests/test_p0_71.py +12cd73d922d1a4bc4b3e244499f7e25595e06b4f141832c4586a80d292923593 tests/test_p0_backup.py +5d64577cd53252404b9ece944a8dc3b7d3aaa1abc2c098c50486bc079b52f631 tests/test_p0_p4_completion_v88.py +53962cf2982b63ea6209235f811b20210811dea87885e9dd73640de5aeb7e4dc tests/test_p0_p4_completion_v89.py +9e010c9808cec332314ecabd982e1dfc616e62021dd9b77e2bf440f59725527e tests/test_p1_platform.py +7df0c88f6676b1a2183011316fe6a6f85c96c012ee7b3aefb268138e138f8199 tests/test_production_v816.py +e03e94aafdbd6c388145591b5ac5261179fad91c92746cab80703bad1139900d tests/test_professional_ui_v811.py +ad87729c5fd185efcdd145a95cc64ab12f17b8744c854747c4216925f3b7021f tests/test_regression_runner_v817.py +c3900769ae4bdc5d37d2d4a7ced3f86c2e6755015d9d238d8cc100c980d2f46f tests/test_release_native_v814.py +17839885f66be132b7ca66e9565317a9efcdff0f8766076909962e9c59759b16 tests/test_release_reviews_v7.py +b48a7f6c5a0dbaf829bec4cf66f47761cc2a304d606b0b2380f1ced05cf0d7a3 tests/test_release_v813.py +dbd245f3149880671821074775e2338137536519ea5d79d17c6b2d7dfc01a189 tests/test_site_design_v87.py +a089b321d9851228e8971d3e171213337d7b8480cda5391831685955893a2e6d tests/test_siteforge_v817_audit.py +77f0d65d506a85c7e6ab3082d7ea319035f1ab63e5ce377d8ed0ec9d1d2c0982 tests/test_studio_v86.py +04599e8b758c632e4e7ad74445e95e875b979d79b37f4c4cbaf33b6665d84841 tests/test_theme_pro_v3.py +65866ccc626f266e2ce84495338080fd5ce37849e009ac128915b8cd4d4ecb09 tests/test_v818_pg_recovery.py +9d4a0a0ddc080bc9af9e4a7e6bae2252d692035388e7f574cb9097fbac4177a6 tests/test_v818_sqlite_pg_transfer.py +fd07a2536975b7267bc97fd6d5b6f2b8f496fc4d24f294bf4f942a4640153ad7 tests/test_v821_editor_history_and_mapping.py +6d1f2d2c45921a76a6cb5b5a3f6bf42c2df10f2c58a0117c40494fa6674c83fa tests/test_v8_art_installer.py +eabbd02268b6aba9a78a810f8dd22d519acb76b9f74068c701fd6bcdeb74d1b4 tests/test_v8_workflows.py +3c2058f4a0e029e4761cf25b532f0999da1b0d1fd2a06b3debb587d7e1707d06 tests/test_wordpress_baseline.py +efa8b6a4f765b73b362e31c4d24e480002a9481168a17f074f4abdeb3d2b56eb tests/test_worker_queue_v6.py +99e68531e65ee03243021850da89ff8b716c21374e81d83e8b068a508985a38a tests/test_workspace_v810.py +f1a0bed80b3ea20fc5743f5a825c9fbde053603172db03ab2b658293c96bf11b tests/test_workspace_v812.py +554299864a6a946601c67d874e0abfbac3ceb99beec81dc7314d2bb0b4df3f2e tests/test_wp_complex_v820.py +f9d4f1734077b8a8cbfa46fd79ecebf9f770f1ce4ff1ab2e32c49a6a2d613de3 tests/test_wp_migration_v81.py +e8c356f904326771e9a9470367e2e42e9cbcbd4dc655fb1b172928fea1753d15 tests/test_wp_migration_v82.py +bd3f32c385264fd93aeae8833f9cb85e9b0fa552d23493eef11074836a0ca174 tests/test_wp_migration_v83.py +82c5b1c9202cfb87a9e5c9ae1254fbb1581d80efb75c3ec066910cc37e34ee6b tests_js/editor_ux.test.cjs +8a16d1e70f9ab6c849ed8c0196eae0125d2f1dac32cf19130e7e078549ab2e9f themes/_professional_components.html +f6e40134b8f5294c7f02b4974808c095a46a99628bb101cdadbe9ed06c5c3e3c themes/automotive/manifest.json +c0e7c5fd1617d48300f0bac5606b1f6b1b5a86f2f51e086a8439de19874a3425 themes/automotive/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/automotive/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/automotive/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/automotive/pages/case.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/automotive/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/automotive/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/pages/faq.html +b7920948d65fb0a2c646993261a4c984a7d76395523cd27f53192164f89024cc themes/automotive/pages/home.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/automotive/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/automotive/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/automotive/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/automotive/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/pages/standard.html +c4fdce0a226a3e952424fc72225d9a48f285783658889aa913c8e065ac0fcdd3 themes/automotive/pro.css +2be448929ddcc4ecde89c0647f593c045d0ae0f962297868b3771e606ebd13da themes/automotive/pro.html +07386d7d71b50f0ea19f85cb2df4b2d717170f13a42176ed446062b6f3e40743 themes/automotive/site.html +7740f6529507f41901eb08e8d923e99e05e918e0ac3eeb35a65cf807da68cdfc themes/automotive/theme.css +5b295f03ca539ece288548541ca00b30458d9433f192d823aa7635c3e56dacdd themes/automotive/versions/0.3.0/manifest.json +f87685b7369d5297dfce6d72bddab9fe4b3d42b66dad84efd3f3a80139a38d4f themes/automotive/versions/0.3.0/page-presets.json +07386d7d71b50f0ea19f85cb2df4b2d717170f13a42176ed446062b6f3e40743 themes/automotive/versions/0.3.0/site.html +7740f6529507f41901eb08e8d923e99e05e918e0ac3eeb35a65cf807da68cdfc themes/automotive/versions/0.3.0/theme.css +91d3cad90009c93c749cfc007f2c162d727ba86f69a9939ea40931cc908aaa53 themes/automotive/versions/1.0.0/manifest.json +c0e7c5fd1617d48300f0bac5606b1f6b1b5a86f2f51e086a8439de19874a3425 themes/automotive/versions/1.0.0/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/versions/1.0.0/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/automotive/versions/1.0.0/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/automotive/versions/1.0.0/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/automotive/versions/1.0.0/pages/case.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/automotive/versions/1.0.0/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/automotive/versions/1.0.0/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/versions/1.0.0/pages/faq.html +b7920948d65fb0a2c646993261a4c984a7d76395523cd27f53192164f89024cc themes/automotive/versions/1.0.0/pages/home.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/automotive/versions/1.0.0/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/automotive/versions/1.0.0/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/automotive/versions/1.0.0/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/automotive/versions/1.0.0/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/versions/1.0.0/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/automotive/versions/1.0.0/pages/standard.html +74181f49b666377638eed3776737d2f54e24f4fb4d8d9172068cc4d21f3654d9 themes/automotive/versions/1.0.0/pro.css +b1f825b6b215257a643919410e39be60f42980cb4e2a10814b90824ae9aea5a5 themes/automotive/versions/1.0.0/pro.html +07386d7d71b50f0ea19f85cb2df4b2d717170f13a42176ed446062b6f3e40743 themes/automotive/versions/1.0.0/site.html +7740f6529507f41901eb08e8d923e99e05e918e0ac3eeb35a65cf807da68cdfc themes/automotive/versions/1.0.0/theme.css +732a3d37ab415f4e877d9c7104b81c3822c931757801ca1f7b1bd57a23579d90 themes/automotive/visual/hero.svg +764a96f305d46b733a450b8139e4dd0f0c752ac3aa97a9255b20025e5ac163d3 themes/corporate/manifest.json +c792f57e830744306047ea7e0db806499d417b08ca30fdd8210c388055f357d5 themes/corporate/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/corporate/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/corporate/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/corporate/pages/case.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/corporate/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/corporate/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/pages/faq.html +e1204a00120a6e769fda3adf510106be3f2f14b51a6ef001f79a977ccb0a9be7 themes/corporate/pages/home.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/corporate/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/corporate/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/corporate/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/corporate/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/pages/standard.html +5cf231b4fb89bb47fd18961214a197823ab24daa3df1c2e445ad9576532f0627 themes/corporate/pro.css +388828da6f27ff2b6b9525b963318b8f5410e8f27a8b322b002b8a64d723ce84 themes/corporate/pro.html +c819c8026fe231497a9287a116e744e368753820a33a7af322226a44ed407e4f themes/corporate/site.html +7421696b8bf8f210a13663e20e6078aa1dcfb35135ddd489eaf4b9a14954aa8a themes/corporate/theme.css +e86b64bd48209d63679a10427cc3e904a8d7f51b196d142c53f636bdf5a09b1b themes/corporate/versions/0.3.0/manifest.json +87ec89878c501eb32008bc20eb9118427aea5b2c180919c77db8d20d8517350f themes/corporate/versions/0.3.0/page-presets.json +c819c8026fe231497a9287a116e744e368753820a33a7af322226a44ed407e4f themes/corporate/versions/0.3.0/site.html +7421696b8bf8f210a13663e20e6078aa1dcfb35135ddd489eaf4b9a14954aa8a themes/corporate/versions/0.3.0/theme.css +e94dc6550b72125f1638e2424a3964f82463f3da88ef8074b23f3aba436efb55 themes/corporate/versions/1.0.0/manifest.json +c792f57e830744306047ea7e0db806499d417b08ca30fdd8210c388055f357d5 themes/corporate/versions/1.0.0/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/versions/1.0.0/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/corporate/versions/1.0.0/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/corporate/versions/1.0.0/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/corporate/versions/1.0.0/pages/case.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/corporate/versions/1.0.0/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/corporate/versions/1.0.0/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/versions/1.0.0/pages/faq.html +e1204a00120a6e769fda3adf510106be3f2f14b51a6ef001f79a977ccb0a9be7 themes/corporate/versions/1.0.0/pages/home.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/corporate/versions/1.0.0/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/corporate/versions/1.0.0/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/corporate/versions/1.0.0/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/corporate/versions/1.0.0/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/versions/1.0.0/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/corporate/versions/1.0.0/pages/standard.html +9a5554aa291de86a7bd4061336a6a3936d2c8f11e625f156742ebf5ed752a945 themes/corporate/versions/1.0.0/pro.css +8b06a52682226604b59fb4217784f10f233f34d1077ac1aafcfaf51d6bb8b19d themes/corporate/versions/1.0.0/pro.html +c819c8026fe231497a9287a116e744e368753820a33a7af322226a44ed407e4f themes/corporate/versions/1.0.0/site.html +7421696b8bf8f210a13663e20e6078aa1dcfb35135ddd489eaf4b9a14954aa8a themes/corporate/versions/1.0.0/theme.css +8eb9ae4b3bdbd778a9931079cb393fbf2789c2ce9f3226e47f903f9dd35cbc3f themes/corporate/visual/hero.svg +ebd36953d821750b8defe25578901f3f00adf8391ae447c16a7ff703b2bf5a01 themes/industrial/manifest.json +191c6ba0f76ae37b990176af254333f10fefb06e72d0ef353ba8b62c0112c534 themes/industrial/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/industrial/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/industrial/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/industrial/pages/case.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/industrial/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/industrial/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/pages/faq.html +70ea2da210acef293c6279168c375b8532cc2347371daff0e2836111b6cd4ca0 themes/industrial/pages/home.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/industrial/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/industrial/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/industrial/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/industrial/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/pages/standard.html +61e5ee68f42e743ae15da56c5f18cafc941e276cdc6c863e45bc8daae1023edf themes/industrial/pro.css +fc753d9d35c96df869e7d5ef18435773e8bab252a57c337deafb4cfb9f7384a9 themes/industrial/pro.html +3ab957e66d9c954c45de8c8b5624942df2d2ca5f4b0591f26a5e1d89ca27a462 themes/industrial/site.html +a2e30bcaa8d4e15658558531329c177c1aecfa980cf36fe001ed5effa38ccd93 themes/industrial/theme.css +e3bd50c633bc55f44c530e31734da0adf28b09a57f11095709f26ca93d47e375 themes/industrial/versions/0.3.0/manifest.json +91107383d370ea4c2646eebb7d54e69f011c9ef97ea8e14f596ec5cdd90f7c4c themes/industrial/versions/0.3.0/page-presets.json +3ab957e66d9c954c45de8c8b5624942df2d2ca5f4b0591f26a5e1d89ca27a462 themes/industrial/versions/0.3.0/site.html +a2e30bcaa8d4e15658558531329c177c1aecfa980cf36fe001ed5effa38ccd93 themes/industrial/versions/0.3.0/theme.css +e0f2b817a043c1e067a1eb06fa7b82214e88152d249c07e75152a03914b1c114 themes/industrial/versions/1.0.0/manifest.json +191c6ba0f76ae37b990176af254333f10fefb06e72d0ef353ba8b62c0112c534 themes/industrial/versions/1.0.0/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/versions/1.0.0/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/industrial/versions/1.0.0/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/industrial/versions/1.0.0/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/industrial/versions/1.0.0/pages/case.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/industrial/versions/1.0.0/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/industrial/versions/1.0.0/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/versions/1.0.0/pages/faq.html +70ea2da210acef293c6279168c375b8532cc2347371daff0e2836111b6cd4ca0 themes/industrial/versions/1.0.0/pages/home.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/industrial/versions/1.0.0/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/industrial/versions/1.0.0/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/industrial/versions/1.0.0/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/industrial/versions/1.0.0/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/versions/1.0.0/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/industrial/versions/1.0.0/pages/standard.html +26bfb1465837ee63ac8c9a9baada75fda533222245d69e36e6e7b0df75429c64 themes/industrial/versions/1.0.0/pro.css +f471223d4480a225f308d2a1d5251101495391554d5263b7ae28313247092d4d themes/industrial/versions/1.0.0/pro.html +3ab957e66d9c954c45de8c8b5624942df2d2ca5f4b0591f26a5e1d89ca27a462 themes/industrial/versions/1.0.0/site.html +a2e30bcaa8d4e15658558531329c177c1aecfa980cf36fe001ed5effa38ccd93 themes/industrial/versions/1.0.0/theme.css +75d4bebbb077e5af36d4f9383f893c91a8b45db1ffd91dc6e2d5107daa849006 themes/industrial/visual/hero.svg +52b7256f3e1eb4801610685b575593f50eb1d8d9146524e10adcd7a195152683 themes/minimal/manifest.json +cfeeadce4397f215aa95d6f210ac913c235da707e1b6215dc274e6ee921cecb4 themes/minimal/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/minimal/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/minimal/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/minimal/pages/case.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/minimal/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/minimal/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/pages/faq.html +f254f6e1cd2c99f9815bbb3771ab327e7a8994cf3963763f829ca53142d4f60f themes/minimal/pages/home.html +4ee5ce55a3c7715c86c63249c3b0b71c99b88d27f6e26fb34206fbc0cae7da3b themes/minimal/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/minimal/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/minimal/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/minimal/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/pages/standard.html +0d435209536c0c5880c009d7e092dc3e554001b42aa52f83a28d0853d89a54c5 themes/minimal/pro.css +d7d923af2e0fca93843eeaeddb4306eeb855b85f8cd33bc1eb500cbee5d0c8aa themes/minimal/pro.html +59dd9ac5e98b580f414585820813e8a8e47053e5e4e75d3a55d26e4f8ed50853 themes/minimal/site.html +de2d571429238c261a8007c4ab0b9e21248bf86d5a050993795f42d508c4ea6b themes/minimal/theme.css +e8ec393149754bfddb2e18cb4cd131a6c22c548f5edff080b56adae779ad64d6 themes/minimal/versions/0.3.0/manifest.json +6afc7fe17dab2d93135e11fdb75347238ab9bfd790882f6d3b0716f2cd4fa66f themes/minimal/versions/0.3.0/page-presets.json +59dd9ac5e98b580f414585820813e8a8e47053e5e4e75d3a55d26e4f8ed50853 themes/minimal/versions/0.3.0/site.html +de2d571429238c261a8007c4ab0b9e21248bf86d5a050993795f42d508c4ea6b themes/minimal/versions/0.3.0/theme.css +48e062bdba9c19403d662dd01f08bd019e60b220edfac385899264b6a7d93e37 themes/minimal/versions/1.0.0/manifest.json +cfeeadce4397f215aa95d6f210ac913c235da707e1b6215dc274e6ee921cecb4 themes/minimal/versions/1.0.0/page-presets.json +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/versions/1.0.0/pages/about.html +fb9d0a3135c9704815775831653517b92f8a966733aa9c89bd98419e16c95fac themes/minimal/versions/1.0.0/pages/article.html +f2adc488fd7a1792e8d9ee78b21b32e914b80f77cbf17dbb1a8158b3ecbfc48a themes/minimal/versions/1.0.0/pages/brand.html +6906a9217a84d1f362d21f185dbd53361e806e5b52d096f1a1ce2b8908a4adbb themes/minimal/versions/1.0.0/pages/case.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/minimal/versions/1.0.0/pages/category.html +981e4242d2b485d764f53291ee2d6774719de7d127b63c405df9f3ac936fb16a themes/minimal/versions/1.0.0/pages/contact.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/versions/1.0.0/pages/faq.html +f254f6e1cd2c99f9815bbb3771ab327e7a8994cf3963763f829ca53142d4f60f themes/minimal/versions/1.0.0/pages/home.html +b9ff9f34dbc4a6f986d1bbccd2253bd4925f2e7dcad7891a129eb40c35117cb0 themes/minimal/versions/1.0.0/pages/listing.html +0cfcedc1a30c09e85f4b4bf5288a713572bec91ae26f54d7c60463dd15b218e2 themes/minimal/versions/1.0.0/pages/notfound.html +b4642518e596399065f00241207b28b0cf1ec3658b9ff8882e7b8a1bb8082966 themes/minimal/versions/1.0.0/pages/product.html +589cb00959c1593ad5999faa079be8cc6dd47c56216f552e0848846e31ea2978 themes/minimal/versions/1.0.0/pages/search.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/versions/1.0.0/pages/service.html +e53e513d4df9fbd19d45562c3c3b6c4ef1da5a0c9b47b6c6dc4b1ddb08008e21 themes/minimal/versions/1.0.0/pages/standard.html +fffe281295fcd095e1f2c9c63e949c633f87f72935df30b3f57c2e80025c6956 themes/minimal/versions/1.0.0/pro.css +68b779284e470cdcd33becb250bdc53b9fd61e8b0005d55caf48431e2ed27de3 themes/minimal/versions/1.0.0/pro.html +59dd9ac5e98b580f414585820813e8a8e47053e5e4e75d3a55d26e4f8ed50853 themes/minimal/versions/1.0.0/site.html +de2d571429238c261a8007c4ab0b9e21248bf86d5a050993795f42d508c4ea6b themes/minimal/versions/1.0.0/theme.css +a6354fbf3249d11acf8d3aa77bc9f541a1db37d2f2a5dc37141509635cf428c1 themes/minimal/visual/hero.svg diff --git a/app/assembly.py b/app/assembly.py index b0821ca..2347188 100644 --- a/app/assembly.py +++ b/app/assembly.py @@ -1,7 +1,7 @@ """Declarative mapping from arbitrary tabular source data to SiteForge content. Never eval mappings, no AI hallucinated fields, preview shows all errors. """ -import json,re +import json,re,hashlib from . import db from .core import route_path,slug_of,save_entry @@ -53,14 +53,41 @@ def suggest(columns): return mapping +def source_column(spec): + return spec if isinstance(spec,str) else spec['source'] + + def validate_rules(rules,columns): if not isinstance(rules,dict) or len(rules)>100:raise ValueError('字段映射规则不合法') - for dest,src in rules.items(): - if not re.fullmatch(r'[\w\-]{1,60}',dest,re.UNICODE):raise ValueError('目标字段名称不合法') + for dest,spec in rules.items(): + if not isinstance(dest,str) or not re.fullmatch(r'[\w\-]{1,60}',dest,re.UNICODE): + raise ValueError('目标字段名称不合法') + if isinstance(spec,dict): + allowed={'source','trim','case','default','prefix','suffix'} + if set(spec)-allowed or 'source' not in spec:raise ValueError('包含不支持的转换配置') + if type(spec.get('trim',True)) is not bool:raise ValueError('trim 必须为布尔值') + if spec.get('case','none') not in ('none','upper','lower'):raise ValueError('不支持的大小写处理') + for key in ('default','prefix','suffix'): + if key in spec and (not isinstance(spec[key],str) or len(spec[key])>500): + raise ValueError('转换字符串过长或格式非法') + elif not isinstance(spec,str):raise ValueError('映射字段格式非法') + src=source_column(spec) if not isinstance(src,str) or src not in columns:raise ValueError(f'来源字段不存在: {src}') if 'title' not in rules:raise ValueError('必须映射标题字段') +def mapped_value(row,spec): + raw=row.get(source_column(spec)) + value=json.dumps(raw,ensure_ascii=False) if isinstance(raw,(dict,list)) else str(raw if raw is not None else '') + if isinstance(spec,str):return value.strip() + if spec.get('trim',True):value=value.strip() + if not value:value=spec.get('default','') + case=spec.get('case','none') + if case=='upper':value=value.upper() + elif case=='lower':value=value.lower() + return spec.get('prefix','')+value+spec.get('suffix','') + + def transform(rows,rules,kind='product',prefix=None): if kind not in ('product','post','page','brand','vehicle','service','case','other'):raise ValueError('不支持的内容类型') columns=set().union(*(r.keys() for r in rows)) if rows else set() @@ -68,9 +95,8 @@ def transform(rows,rules,kind='product',prefix=None): seen=set();out=[];errors=[] for index,row in enumerate(rows): vals={} - for target,src in rules.items(): - raw=row.get(src) - vals[target]=(json.dumps(raw,ensure_ascii=False) if isinstance(raw,(dict,list)) else str(raw if raw is not None else '')).strip() + for target,spec in rules.items(): + vals[target]=mapped_value(row,spec) title=vals.get('title','') if not title: errors.append({'row':index+1,'error':'标题为空'});continue @@ -97,30 +123,61 @@ def transform(rows,rules,kind='product',prefix=None): return out,errors +def _state_token(site_id,items): + """Preview token binds mapped payload and existing rows' revision metadata. + + This is advisory optimistic checking, not a global distributed lock. + """ + routes=[x['route'] for x in items] + existing={r['route']:r for r in + db.rows('SELECT * FROM entries WHERE site_id=?',(site_id,)) + if r['route'] in routes} + state={'site':site_id,'items':items,'existing':existing} + return hashlib.sha256(json.dumps(state,ensure_ascii=False,sort_keys=True, + separators=(',',':')).encode('utf-8')).hexdigest() + + def dry_run(site_id,rows,rules,kind='product',prefix=None): if len(rows)>1000:raise ValueError('单批最多1000条内容') items,errors=transform(rows,rules,kind,prefix) existing={r['route'] for r in db.rows('SELECT route FROM entries WHERE site_id=?',(site_id,))} collisions=[r['route'] for r in items if r['route'] in existing] return {'input':len(rows),'mapped':len(items),'errors':errors,'conflicts':collisions, - 'unmapped_columns':sorted(set().union(*(x.keys() for x in rows)) - set(rules.values())) if rows else [], - 'sample':items[:10], 'items':items} + 'unmapped_columns':sorted(set().union(*(x.keys() for x in rows)) - + {source_column(v) for v in rules.values()}) if rows else [], + 'sample':items[:10], 'items':items, + 'plan_hash':_state_token(site_id,items), + 'supported_transforms':['trim','default','upper','lower','prefix','suffix'], + 'note':'提交时携带 expected_plan_hash 可阻止预检后发生变化的数据覆盖'} -def commit(site_id,rows,rules,kind='product',on_conflict='skip',prefix=None): - if on_conflict not in ('skip','replace'):raise ValueError('冲突策略只能为 skip 或 replace') +def commit(site_id,rows,rules,kind='product',on_conflict='skip',prefix=None,expected_plan_hash=None): + if on_conflict not in ('skip','replace','abort'): + raise ValueError('冲突策略只能为 skip、replace 或 abort') report=dry_run(site_id,rows,rules,kind,prefix) + if expected_plan_hash is not None: + if not isinstance(expected_plan_hash,str) or not re.fullmatch(r'[a-f0-9]{64}',expected_plan_hash): + raise ValueError('预检令牌格式无效') + if expected_plan_hash!=report['plan_hash']: + raise ValueError('导入预检已过期：来源数据或已有内容发生变化，请重新预览') + if on_conflict=='abort' and (report['conflicts'] or report['errors']): + raise ValueError('严格导入被阻断：存在 URL 冲突或无效数据，请处理后重新预览') created=0;updated=0;skipped=0;errors=list(report['errors']) for idx,item in enumerate(report['items'],1): try: existing=db.one('SELECT id FROM entries WHERE site_id=? AND route=?',(site_id,item['route'])) if existing and on_conflict=='skip':skipped+=1;continue + # abort semantics require a preflight without errors; do not turn + # this into an automatic 'replace' policy on a colliding route. + if existing and on_conflict=='abort':raise ValueError('提交期间出现 URL 冲突') save_entry(site_id,item,existing_id=existing['id'] if existing else None,source='mapped-import') if existing:updated+=1 else:created+=1 except Exception as exc: errors.append({'row':idx,'error':str(exc)[:250]}) - summary={'created':created,'updated':updated,'skipped':skipped,'errors':errors,'mapped':report['mapped']} + if on_conflict=='abort':break + summary={'created':created,'updated':updated,'skipped':skipped,'errors':errors,'mapped':report['mapped'], + 'plan_hash':report['plan_hash']} from .core import uid db.insert('INSERT INTO import_batches VALUES (?,?,?,?,?,?)',(uid(),site_id,'',f'content-map:{kind}',json.dumps(summary,ensure_ascii=False),db.now())) return summary diff --git a/app/backup.py b/app/backup.py index 9db28eb..ff36905 100644 --- a/app/backup.py +++ b/app/backup.py @@ -9,6 +9,9 @@ from . import db def backup(): + # Never manufacture an empty SQLite file while the real application uses PostgreSQL. + if db.POSTGRES: + raise RuntimeError('PostgreSQL 模式不得使用 SQLite 备份；请使用 scripts/pg_disaster_recovery.py backup') db.init() storage=Path(db.DATA).resolve() path=storage/'backups' diff --git a/app/builder.py b/app/builder.py index 8ded6b9..2179b45 100644 --- a/app/builder.py +++ b/app/builder.py @@ -14,7 +14,7 @@ import httpx from . import safe_http from jinja2 import Environment, FileSystemLoader, select_autoescape from markupsafe import Markup -from . import db, blueprints, theme_store, static_site, responsive, theme_pro, site_design_v87 +from . import db, blueprints, theme_store, static_site, responsive, theme_pro, site_design_v87, multilingual from .core import uid, route_path, ensure_public_url, sanitize, THEMES ROOT=Path(__file__).resolve().parent.parent @@ -23,6 +23,12 @@ ENV=Environment(loader=FileSystemLoader(str(THEME_DIR)),autoescape=select_autoes TYPE_NAMES={'page':'页面','post':'新闻','product':'产品','service':'服务','case':'案例','brand':'品牌','vehicle':'车型','other':'内容'} +def copy_blocks_css(theme_dir,dist_assets): + """Theme-provided blocks.css wins; platform default is the fallback.""" + candidate=theme_dir/'blocks.css' + src=candidate if candidate.is_file() else ROOT/'app'/'static'/'blocks.css' + shutil.copy2(src,dist_assets/'blocks.css') + def output_path(dist,route): path=route_path(route) if path=='/':return dist/'index.html' @@ -36,12 +42,6 @@ def output_path(dist,route): if not target.is_relative_to(dist.resolve()):raise ValueError('非法生成目标目录') return out -def copy_blocks_css(theme_dir,dist_assets): - """Theme-provided blocks.css wins; platform default is the fallback.""" - candidate=theme_dir/'blocks.css' - src=candidate if candidate.is_file() else ROOT/'app'/'static'/'blocks.css' - shutil.copy2(src,dist_assets/'blocks.css') - def link(path): return (path or '/').lstrip('/') or './' @@ -166,6 +166,9 @@ def build(site_id,mirror=False): site=db.one('SELECT * FROM sites WHERE id=?',(site_id,)) if not site:raise ValueError('网站不存在') if site['theme'] not in theme_store.ids():raise ValueError('无效的主题') + multilingual.assert_build_safe(site_id) + locale=multilingual.site_locale(site_id) + language_alternates=multilingual.alternates(site_id) records=db.rows("SELECT * FROM entries WHERE site_id=? AND status='published' ORDER BY type,title",(site_id,)) redirects=db.rows('SELECT * FROM redirects WHERE site_id=?',(site_id,)) settings=json.loads(site['settings_json'] or '{}') @@ -309,6 +312,7 @@ def build(site_id,mirror=False): # global custom.css. Reused templates can share block IDs safely. html=__import__('re').sub(r'])', ''+xml_escape(public_url(site,r))+'' for r in canonical_routes) - sitemap='\n'+urls+'' + urls='\n'.join(''+xml_escape(public_url(site,r))+''+multilingual.sitemap_alternates(language_alternates.get(r,[]))+'' for r in canonical_routes) + sitemap='\n'+urls+'' (dist/'sitemap.xml').write_text(sitemap,encoding='utf-8') (dist/'robots.txt').write_text('User-agent: *\nAllow: /\n'+(f'Sitemap: {site["domain"].rstrip("/")}/sitemap.xml\n' if site['domain'].startswith('http') else ''),encoding='utf-8') rlist=[] @@ -452,7 +458,7 @@ def build(site_id,mirror=False): if canonical_mismatches:warnings.append(f'{len(canonical_mismatches)} 个页面 canonical 域名与新站域名不一致') if missing:warnings.append(f'{len(missing)} 个本地引用图片缺失') if slashless:warnings.append(f'{len(slashless)} 个无后缀、无尾斜杠 URL 需要按照生成的 Nginx 规则部署') - report={'site':site['name'],'version':bid,'pages':totals,'theme':site['theme'],'theme_version':theme_pin['version'] if theme_pin else theme_store.latest(site['theme']), + report={'site':site['name'],'locale':locale,'alternate_pages':len(language_alternates),'version':bid,'pages':totals,'theme':site['theme'],'theme_version':theme_pin['version'] if theme_pin else theme_store.latest(site['theme']), 'warnings':warnings,'errors':issues,'external_assets':external[:200], 'missing_local_images':missing[:200],'broken_links':broken_links[:200],'legacy_links':legacy_links[:200],'canonical_mismatches':canonical_mismatches[:200],'slashless_routes':slashless, 'redirects':len(redirects),'mirrored_images':len(remote_cache), diff --git a/app/console_v819.py b/app/console_v819.py new file mode 100644 index 0000000..a6ee768 --- /dev/null +++ b/app/console_v819.py @@ -0,0 +1,74 @@ +"""Authorized, versioned navigation contract for the single SiteForge console. + +The frontend is not an authorization authority: every business API keeps its +own server-side membership checks. This endpoint only returns allowed context. +""" +from fastapi import APIRouter, HTTPException, Request +from . import db, enterprise +from .version import VERSION + +router = APIRouter(prefix='/api/console', tags=['Console']) + +NAVIGATION = ( + ('dashboard', '工作台', '/siteforge/dashboard', None), + ('sites', '网站管理', '/siteforge/factory', None), + ('content', '内容管理', '/siteforge/content', 'viewer'), + ('design', '网站设计', '/siteforge/editor', 'viewer'), + ('migration', '数据与迁移', '/siteforge/migration', 'viewer'), + ('release', '构建与发布', '/siteforge/releases', 'viewer'), + ('system', '系统管理', '/siteforge/enterprise', 'owner'), +) + + +def available_sites(request: Request): + if request.state.is_superadmin: + return db.rows('SELECT id,name,domain FROM sites ORDER BY updated_at DESC,id') + return db.rows('''SELECT s.id,s.name,s.domain FROM sites s + JOIN team_memberships m ON m.site_id=s.id + JOIN team_users u ON u.id=m.user_id + WHERE m.user_id=? AND u.disabled=0 + ORDER BY s.updated_at DESC,s.id''', (request.state.account_id,)) + + +def capabilities(request: Request, site_id: str | None): + role = 'superadmin' if request.state.is_superadmin else 'none' + if site_id and not request.state.is_superadmin: + membership = db.one('SELECT role FROM team_memberships WHERE site_id=? AND user_id=?', + (site_id, request.state.account_id)) + role = membership['role'] if membership else 'none' + level = enterprise.ACCESS.get(role, -1) + return dict(role=role, view=level>=0, edit=level>=enterprise.ACCESS['editor'], + review=level>=enterprise.ACCESS['reviewer'], + deploy=level>=enterprise.ACCESS['owner'], + manage_members=level>=enterprise.ACCESS['owner'], + create_site=bool(request.state.is_superadmin), + manage_users=bool(request.state.is_superadmin)) + + +@router.get('/bootstrap') +def bootstrap(request: Request, site_id: str = ''): + """Return user-scoped menus, never expose unassigned websites or credentials.""" + sites = available_sites(request) + ids = {x['id'] for x in sites} + if site_id and site_id not in ids: + raise HTTPException(403, '没有访问该网站的权限') + selected = site_id or (sites[0]['id'] if sites else None) + rights = capabilities(request, selected) + sections = [] + for key, title, path, required in NAVIGATION: + if required and not selected: + continue + if required and not rights['view']: + continue + if key == 'system' and not (rights['manage_members'] or rights['manage_users']): + continue + sections.append({'key': key, 'title': title, 'path': path, 'requires_site': bool(required)}) + return { + 'version': VERSION, + 'user': request.state.actor, + 'superadmin': bool(request.state.is_superadmin), + 'sites': sites, + 'selected_site_id': selected, + 'capabilities': rights, + 'navigation': sections, + } diff --git a/app/core.py b/app/core.py index 71b2b3b..ff65c02 100644 --- a/app/core.py +++ b/app/core.py @@ -4,12 +4,12 @@ import json import re import socket import uuid -from pathlib import Path from urllib.parse import urlparse, unquote import bleach from . import db -ROOT = Path(__file__).resolve().parent.parent +TYPES = ('page','product','post','service','case','brand','vehicle','other') +ROOT = __import__('pathlib').Path(__file__).resolve().parent.parent def discover_themes(): """Discover built-in themes from themes/*/manifest.json (single source of truth).""" @@ -29,7 +29,6 @@ def discover_themes(): found.append(entry.name) return tuple(found) -TYPES = ('page','product','post','service','case','brand','vehicle','other') THEMES = discover_themes() ALLOWED_TAGS = ['p','br','b','i','u','em','strong','h1','h2','h3','h4','h5','h6','ul','ol','li','blockquote','pre','code','a','img','figure','figcaption','table','thead','tbody','tr','th','td','hr','div','span'] ALLOWED_ATTRS = {'a':['href','title','target','rel'], 'img':['src','alt','title','loading','width','height'], 'td':['colspan','rowspan'], 'th':['colspan','rowspan']} diff --git a/app/db.py b/app/db.py index d9d45b4..5434dd2 100644 --- a/app/db.py +++ b/app/db.py @@ -75,9 +75,13 @@ def init(): result_json TEXT NOT NULL DEFAULT '{}' ); ''') - if not POSTGRES: - from . import schema_registry - schema_registry.ensure(c) + # Migration ledger is shared by SQLite and PostgreSQL. + from . import schema_registry + schema_registry.ensure(c) + # The multilingual schema is a non-destructive additive migration. + # Direct CLI builders, tests and web startup all initialize it. + from . import multilingual + multilingual.setup() def rows(sql, params=()): with connect() as c: diff --git a/app/deploy_agent.py b/app/deploy_agent.py index 8f4a008..3a95d69 100644 --- a/app/deploy_agent.py +++ b/app/deploy_agent.py @@ -23,7 +23,12 @@ def signature(secret,site,timestamp,body,method,path): return hmac.new(secret.encode(),envelope,hashlib.sha256).hexdigest() def authorize(site,request,body): - secret=os.environ.get('SITEFORGE_DEPLOY_SECRET','') + ref=os.environ.get('SITEFORGE_DEPLOY_SECRET_REF','') + if ref: + from .secret_refs import resolve,SecretReferenceError + try:secret=resolve(ref) + except SecretReferenceError:raise HTTPException(503,'Release Agent secret unavailable') + else:secret=os.environ.get('SITEFORGE_DEPLOY_SECRET','') if len(secret)<32:raise HTTPException(503,'Release agent secret not configured') stamp=request.headers.get('x-siteforge-timestamp','') try: @@ -37,12 +42,16 @@ def validate_archive(raw): if len(raw)>MAX_ZIP:raise ValueError('Archive too large') with zipfile.ZipFile(io.BytesIO(raw)) as z: if len(z.infolist())>20000:raise ValueError('Too many files') - total=0 + total=0;seen=set() for info in z.infolist(): name=info.filename path=PurePosixPath(name) - if name.startswith('/') or '\\' in name or '..' in path.parts or not name or ':' in name: + if name.startswith('/') or '\\' in name or '..' in path.parts or not name or ':' in name or name.startswith('./'): raise ValueError('Unsafe archive path') + key=name.lower().rstrip('/') + if key in seen or key=='.siteforge-manifest.json': + raise ValueError('Duplicate or reserved file in archive') + seen.add(key) # Unix symlink type is 0o120000. if ((info.external_attr>>16)&0o170000)==0o120000:raise ValueError('Symlinks forbidden') total+=info.file_size @@ -53,7 +62,25 @@ def validate_archive(raw): return True -def install(site,raw): +def _pointer(site): + parent=ROOT/site + current=parent/'current' + version=current.read_text(encoding='ascii').strip() if current.is_file() else None + return version if version and re.fullmatch('[0-9a-f]{20}',version) else None + + +def _manifest(root): + """Hash all files of an immutable release. Called on a limited archive.""" + hashes={} + for path in sorted(root.rglob('*')): + if path.is_symlink() or not path.resolve().is_relative_to(root.resolve()): + raise ValueError('Release contains unsafe link') + if path.is_file():hashes[path.relative_to(root).as_posix()]=hashlib.sha256(path.read_bytes()).hexdigest() + return hashes + + +def stage(site,raw): + """Stage an immutable release without changing current traffic.""" if not SITE.fullmatch(site):raise ValueError('Bad site ID') validate_archive(raw) digest=hashlib.sha256(raw).hexdigest()[:20] @@ -61,19 +88,54 @@ def install(site,raw): releases=parent/'releases' releases.mkdir(parents=True,exist_ok=True) target=releases/digest + if target.is_symlink():raise ValueError('Invalid immutable release directory') if not target.is_dir(): - stage=Path(tempfile.mkdtemp(prefix='.unpacked-',dir=str(parent))) + stage_dir=Path(tempfile.mkdtemp(prefix='.unpacked-',dir=str(parent))) try: - with zipfile.ZipFile(io.BytesIO(raw)) as z:z.extractall(stage) - if not (stage/'index.html').is_file():raise ValueError('Invalid site') - try:stage.rename(target) + with zipfile.ZipFile(io.BytesIO(raw)) as z:z.extractall(stage_dir) + if not (stage_dir/'index.html').is_file():raise ValueError('Invalid site') + hashes=_manifest(stage_dir) + (stage_dir/'.siteforge-manifest.json').write_text(json.dumps({'sha256':hashlib.sha256(raw).hexdigest(), + 'files':hashes},sort_keys=True),encoding='utf-8') + try:stage_dir.rename(target) except FileExistsError:pass finally: - if stage.exists():shutil.rmtree(stage) - pointer=parent/'.current.tmp' - pointer.write_text(digest,encoding='ascii') - os.replace(pointer,parent/'current') - return {'site':site,'release':digest,'sha256':hashlib.sha256(raw).hexdigest(),'published':True} + if stage_dir.exists():shutil.rmtree(stage_dir) + return {'site':site,'release':digest,'sha256':hashlib.sha256(raw).hexdigest(), + 'staged':True,'current':_pointer(site)} + + +def verify_release(site,release): + if not SITE.fullmatch(site) or not re.fullmatch('[0-9a-f]{20}',release):raise ValueError('Invalid release') + folder=ROOT/site/'releases'/release + meta=folder/'.siteforge-manifest.json' + if not meta.is_file():raise ValueError('Release manifest missing') + manifest=json.loads(meta.read_text(encoding='utf-8')) + expected=manifest.get('files',{}) + current=_manifest(folder) + current.pop('.siteforge-manifest.json',None) + if expected != current or 'index.html' not in current:raise ValueError('Release file integrity failure') + return {'site':site,'release':release,'sha256':manifest['sha256'], + 'files':len(current),'verified':True,'active':_pointer(site)==release, + 'current':_pointer(site)} + + +def activate(site,release): + verified=verify_release(site,release) + parent=ROOT/site + previous=_pointer(site) + tmp=parent/('.current-'+re.sub('[^0-9a-f]','',release)+'.tmp') + tmp.write_text(release,encoding='ascii') + os.replace(tmp,parent/'current') + return {**verified,'active':True,'previous':previous,'current':release} + + +def install(site,raw): + """Compatibility endpoint used by existing clients; new Worker uses stage/verify/activate.""" + staged=stage(site,raw) + active=activate(site,staged['release']) + return {**active,'published':True} + @app.get('/health') def health():return {'healthy':True} @@ -92,6 +154,33 @@ async def deploy(site:str,request:Request): try:return install(site,data) except (ValueError,zipfile.BadZipFile) as e:raise HTTPException(400,str(e)) +@app.post('/staging/{site}') +async def stage_upload(site:str,request:Request): + if not SITE.fullmatch(site):raise HTTPException(400) + parts=[];size=0 + async for chunk in request.stream(): + size+=len(chunk) + if size>MAX_ZIP:raise HTTPException(413) + parts.append(chunk) + raw=b''.join(parts) + authorize(site,request,raw) + try:return stage(site,raw) + except (ValueError,zipfile.BadZipFile) as exc:raise HTTPException(400,str(exc)) + +@app.get('/sites/{site}/verify/{release}') +def verify_route(site:str,release:str,request:Request): + if not SITE.fullmatch(site) or not re.fullmatch('[0-9a-f]{20}',release):raise HTTPException(400) + authorize(site,request,b'') + try:return verify_release(site,release) + except (ValueError,OSError,KeyError) as exc:raise HTTPException(409,str(exc)) + +@app.post('/sites/{site}/activate/{release}') +def activate_route(site:str,release:str,request:Request): + if not SITE.fullmatch(site) or not re.fullmatch('[0-9a-f]{20}',release):raise HTTPException(400) + authorize(site,request,b'') + try:return activate(site,release) + except (ValueError,OSError,KeyError) as exc:raise HTTPException(409,str(exc)) + @app.get('/sites/{site}/releases') def versions(site:str,request:Request): # No public access to release inventory. Require same signed request semantics. @@ -107,6 +196,9 @@ async def rollback(site:str,release:str,request:Request): authorize(site,request,b'') parent=ROOT/site if not (parent/'releases'/release/'index.html').is_file():raise HTTPException(404) + if (parent/'releases'/release/'.siteforge-manifest.json').exists(): + try:verify_release(site,release) + except (ValueError,OSError,KeyError):raise HTTPException(409,'Historic release failed integrity verification') tmp=parent/'.current.tmp';tmp.write_text(release);os.replace(tmp,parent/'current') return {'site':site,'release':release,'rolled_back':True} diff --git a/app/enterprise.py b/app/enterprise.py index 0df9985..67f841a 100644 --- a/app/enterprise.py +++ b/app/enterprise.py @@ -134,7 +134,11 @@ def create_user(request:Request,payload:UserCreate): person=uid() db.insert('INSERT INTO team_users(id,username,password_hash,display_name,created_at) VALUES (?,?,?,?,?)', (person,payload.username,hash_password(payload.password),payload.display_name,db.now())) - except sqlite3.IntegrityError:raise HTTPException(409,'用户名已存在') + except Exception as exc: + # PostgreSQL uses psycopg.errors.UniqueViolation rather than sqlite3.IntegrityError. + if isinstance(exc,sqlite3.IntegrityError) or getattr(exc,'sqlstate',None)=='23505': + raise HTTPException(409,'用户名已存在') from exc + raise return {'id':person,'username':payload.username,'display_name':payload.display_name} @router.patch('/team/users/{user_id}/disable') diff --git a/app/factory_api.py b/app/factory_api.py index 2918d94..a94518a 100644 --- a/app/factory_api.py +++ b/app/factory_api.py @@ -1,5 +1,6 @@ """Factory V2 endpoints: themes, mappings, build comparisons, team release readiness.""" import json,csv,io +from typing import Any from pathlib import Path from fastapi import APIRouter, HTTPException, Request, UploadFile, File, Body from fastapi.responses import HTMLResponse, FileResponse @@ -88,10 +89,11 @@ def save_profile(request:Request,site_id:str,payload:dict=Body(...)): class MapRows(BaseModel): rows:list[dict]=Field(max_length=1000) - rules:dict[str,str]=Field(default_factory=dict) + rules:dict[str,Any]=Field(default_factory=dict) content_type:str='product' prefix:str|None=None on_conflict:str='skip' + expected_plan_hash:str|None=None dry_run:bool=True @router.post('/sites/{site_id}/mapping/parse-file') @@ -115,7 +117,7 @@ def suggested_map(request:Request,site_id:str,payload:dict=Body(...)): def map_rows(request:Request,site_id:str,payload:MapRows): enterprise.require(request,site_id,'viewer' if payload.dry_run else 'editor') try: - return assembly.dry_run(site_id,payload.rows,payload.rules,payload.content_type,payload.prefix) if payload.dry_run else assembly.commit(site_id,payload.rows,payload.rules,payload.content_type,payload.on_conflict,payload.prefix) + return assembly.dry_run(site_id,payload.rows,payload.rules,payload.content_type,payload.prefix) if payload.dry_run else assembly.commit(site_id,payload.rows,payload.rules,payload.content_type,payload.on_conflict,payload.prefix,payload.expected_plan_hash) except ValueError as exc:raise HTTPException(400,str(exc)) @router.get('/sites/{site_id}/migration/readiness') diff --git a/app/healthchecks.py b/app/healthchecks.py new file mode 100644 index 0000000..40869b9 --- /dev/null +++ b/app/healthchecks.py @@ -0,0 +1,25 @@ +"""Infrastructure readiness distinct from lightweight process liveness. + +Do not expose DB DSNs, Redis endpoints or filesystem paths in the public response. +Redis wake-ups are optional and are not a readiness requirement. +""" +from pathlib import Path +import tempfile +from . import db + + +def readiness() -> bool: + try: + # SELECT 1 works on SQLite and PostgreSQL and checks actual connectivity. + with db.connect() as conn: + if conn.execute('SELECT 1 AS ready').fetchone()[0] != 1: + return False + data=Path(db.DATA) + data.mkdir(parents=True,exist_ok=True) + # Build artifacts and job results require writable shared storage. + with tempfile.NamedTemporaryFile(dir=data, prefix='.ready-', delete=True) as probe: + probe.write(b'1') + probe.flush() + return True + except Exception: + return False diff --git a/app/importers.py b/app/importers.py index a19b6b6..115448e 100644 --- a/app/importers.py +++ b/app/importers.py @@ -11,7 +11,7 @@ from bs4 import BeautifulSoup import httpx from openpyxl import load_workbook from .core import route_path, save_entry, ensure_public_url, slug_of -from . import db,wordpress_compat,safe_http +from . import db,wordpress_compat,safe_http,wp_complex_v820 KEY_ALIASES={ 'title':('title','name','标题','名称','产品名称','post_title'), @@ -114,7 +114,10 @@ def import_wxr(site_id,content,conflict='skip'): title=it.findtext('title') or slug link=it.findtext('link') or '' path=urlparse(link).path if link.startswith(('http://','https://')) else '' - if not path: path=f'/{slug}/' if typ=='page' else f'/{typ}/{slug}/' + if urlparse(link).query or urlparse(link).fragment: + raise ValueError(f'WXR 记录 {title[:80]} 使用动态参数 URL；请先做 V8.20 预检和显式路由映射') + if not path: + raise ValueError(f'WXR 记录 {title[:80]} 缺少原始 URL，无法保证旧路径不变') wpmeta={} for pm in it.findall('wp:postmeta',ns): key=pm.findtext('wp:meta_key',namespaces=ns) @@ -133,11 +136,16 @@ def import_wxr(site_id,content,conflict='skip'): ('_stock_status','stock_status'),('_weight','weight')): if wpmeta.get(source):fields[dest]=str(wpmeta[source])[:1000] fields.update(taxonomy) + acf=wp_complex_v820.extract_acf(wpmeta) + for key,value in acf['fields'].items(): + fields.setdefault(key,value) + for key,value in acf['repeaters'].items(): + fields[key]=value wp_featured=media_index.get(wpmeta.get('_thumbnail_id',''),'') gallery_ids=[x.strip() for x in wpmeta.get('_product_image_gallery','').split(',') if x.strip()] gallery=[media_index[x] for x in gallery_ids if x in media_index] if gallery:fields['gallery']=gallery - warnings=[] + warnings=list(acf['warnings']) if wpmeta.get('_elementor_data'): elementor=wordpress_compat.elementor_to_html(wpmeta['_elementor_data']) if not body.strip() and elementor['html']: @@ -155,7 +163,7 @@ def import_wxr(site_id,content,conflict='skip'): 'canonical':wpmeta.get('_yoast_wpseo_canonical') or wpmeta.get('rank_math_canonical_url') or '', 'robots':'noindex,follow' if wpmeta.get('_yoast_wpseo_meta-robots-noindex')=='1' or wpmeta.get('rank_math_robots')=='noindex' else 'index,follow', 'status':'published' if status=='publish' else 'draft', - 'meta':{'elementor_widgets':elementor['widgets'] if wpmeta.get('_elementor_data') else 0,'wp_post_id':it.findtext('wp:post_id',default='',namespaces=ns),'wp_type':typ,'wp_metadata':wpmeta,'fields':fields,'migration_warnings':warnings}}) + 'meta':{'elementor_widgets':elementor['widgets'] if wpmeta.get('_elementor_data') else 0,'wp_post_id':it.findtext('wp:post_id',default='',namespaces=ns),'wp_type':typ,'wp_metadata':wpmeta,'fields':fields,'acf_repeaters':acf['repeaters'],'migration_warnings':warnings}}) return import_records(site_id,entries,'wordpress-wxr',conflict) def safe_get(client,url,max_bytes=3_000_000): diff --git a/app/job_runner.py b/app/job_runner.py index 31ee69f..cdb758b 100644 --- a/app/job_runner.py +++ b/app/job_runner.py @@ -24,6 +24,9 @@ def main(): elif row['kind']=='mysql_scan': from . import connectors_v85 value=connectors_v85.run_scan(row['site_id'],opts['source_id'],job_id) + elif row['kind'] in ('remote_deploy','remote_rollback'): + from . import release_api + value=release_api.run_delivery(row['site_id'],row['kind'],opts,job_id) elif row['kind']=='build': value=builder.build(row['site_id'],bool(opts.get('mirror_images',False))) else:raise ValueError('未知任务类型') diff --git a/app/jobs.py b/app/jobs.py index 846acb1..4951859 100644 --- a/app/jobs.py +++ b/app/jobs.py @@ -1,7 +1,7 @@ -'''Durable SQLite build queue. A single job is at most running once per site. +'''Durable build queue: SQLite single-host or PostgreSQL with DB-owned leases. -This implementation is deliberately single-host. For multi-host HA, replace -SQLite with PostgreSQL and Redis (outbox+leases) before production scaling. +Redis is an optional wake-up signal, not an authoritative queue. PostgreSQL +lock/lease semantics require actual multi-worker acceptance on infrastructure. ''' from __future__ import annotations import hashlib @@ -101,9 +101,15 @@ def recover_expired(): if row['cancel_requested']: state='cancelled' else: - state='retrying' if row['attempts']=_limit('SITEFORGE_MAX_PENDING_JOBS',100): + raise JobCapacityError('系统任务队列已满') + if c.execute(f'SELECT COUNT(*) FROM build_jobs WHERE site_id=? AND {active}',(site_id,)).fetchone()[0]>=_limit('SITEFORGE_MAX_PENDING_JOBS_PER_SITE',5): + raise JobCapacityError('网站任务队列已满') + job_id=uuid.uuid4().hex[:16] + c.execute('''INSERT INTO build_jobs(id,site_id,kind,state,created_by,created_at,payload_json, + idempotency_key,max_attempts,timeout_seconds,available_at) + VALUES(?,?,?,?,?,?,?,?,?,?,?)''', + (job_id,site_id,kind,'queued',actor,db.now(),normalized,key,3,900,db.now())) + from . import redis_signal + redis_signal.notify() + return {'id':job_id,'state':'queued','existing':False} diff --git a/app/main.py b/app/main.py index ec21988..f3285a3 100644 --- a/app/main.py +++ b/app/main.py @@ -12,7 +12,7 @@ from fastapi.responses import HTMLResponse, FileResponse, RedirectResponse, Resp from fastapi.staticfiles import StaticFiles from fastapi.middleware.cors import CORSMiddleware from pydantic import BaseModel, Field -from . import db, importers, builder, security, blueprints, enterprise, theme_store, factory_api, migration_audit, reusables, jobs, release_api, cms_pipeline, v8_workflows, v8_templates, wp_migration_v81, wp_migration_v82, wp_migration_v83, connectors_v84, connectors_v85, studio_v86, site_design_v87 +from . import console_v819, wp_complex_v820, db, importers, builder, security, blueprints, enterprise, theme_store, factory_api, migration_audit, reusables, jobs, release_api, cms_pipeline, v8_workflows, v8_templates, wp_migration_v81, wp_migration_v82, wp_migration_v83, connectors_v84, connectors_v85, studio_v86, site_design_v87, multilingual from .version import VERSION, BUILD_SHA from .request_trace import TraceMiddleware from .preview_rewrite import rewrite_preview_html @@ -38,6 +38,7 @@ async def lifespan(app): connectors_v85.setup() studio_v86.setup() site_design_v87.setup() + multilingual.setup() yield app=FastAPI(title='SiteForge 网站工厂',description='Docker-first visual website factory',version=VERSION,lifespan=lifespan) @@ -58,15 +59,18 @@ app.include_router(v8_templates.router) app.include_router(wp_migration_v81.router) app.include_router(wp_migration_v82.router) app.include_router(wp_migration_v83.router) +app.include_router(wp_complex_v820.router) app.include_router(connectors_v84.router) app.include_router(connectors_v85.router) app.include_router(studio_v86.router) app.include_router(site_design_v87.router) +app.include_router(multilingual.router) +app.include_router(console_v819.router) @app.middleware('http') async def require_login(request:Request, call_next): path = request.url.path - public = path in ('/login', '/api/auth/login', '/api/health', '/favicon.ico') or path.startswith('/ui/') + public = path in ('/login', '/api/auth/login', '/api/health', '/api/ready', '/favicon.ico') or path.startswith('/ui/') if not public: session = security.read_session(request.cookies.get(security.COOKIE)) identity = enterprise.account_from_session(session) if session else None @@ -261,6 +265,12 @@ def visual_editor(site_id:str,entry_id:str): @app.get('/api/health') def health():return {'status':'ok','name':'SiteForge','version':VERSION,'commit':BUILD_SHA} +@app.get('/api/ready') +def ready(): + from .healthchecks import readiness + ok=readiness() + return JSONResponse({'status':'ready' if ok else 'unavailable'},status_code=200 if ok else 503) + @app.get('/api/themes') def themes(): manifests=[] @@ -536,7 +546,15 @@ def editor_preview(site_id:str,entry_id:str,payload:BlueprintPayload): html=html.replace('','') bridge = r'''''' # The static site's /media/ assets are hosted by the admin at # /local-media/{site}/. Rewrite only the editor response, never builds. diff --git a/app/multilingual.py b/app/multilingual.py new file mode 100644 index 0000000..3a67dd8 --- /dev/null +++ b/app/multilingual.py @@ -0,0 +1,265 @@ +"""Explicit multilingual relationships. No automatic fact translation. + +One site per locale. Only approved, published and indexed content receives +alternate links. Pending translation records cannot accidentally enter a build. +""" +import json +import re +from urllib.parse import urlparse +from html import escape as html_escape +from xml.sax.saxutils import escape as xml_escape +from fastapi import APIRouter, HTTPException, Request +from pydantic import BaseModel, Field +from . import db, enterprise +from .core import uid + +router=APIRouter(prefix='/api/i18n', tags=['Multilingual']) +LOCALE_PATTERN=re.compile(r'^[a-z]{2,3}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$') +KEY_PATTERN=re.compile(r'^[A-Za-z0-9][A-Za-z0-9._:-]{0,119}$') + +def locale_value(locale): + value=str(locale or '').strip() + if not LOCALE_PATTERN.fullmatch(value): + raise ValueError('语言标识必须是 BCP47 格式，例如 zh-CN、en、fr-FR') + return value + +def _domain(site): + value=(site.get('domain') or '').strip().rstrip('/') + parsed=urlparse(value) + if parsed.scheme!='https' or not parsed.hostname or parsed.username or parsed.password or parsed.path not in ('','/') or parsed.query or parsed.fragment: + raise ValueError('多语言正式站点必须配置独立 HTTPS 域名（不允许路径、账号或查询参数）') + return value + +def setup(): + with db.connect() as c: + c.executescript('''CREATE TABLE IF NOT EXISTS language_groups( + id TEXT PRIMARY KEY, name TEXT NOT NULL, default_locale TEXT NOT NULL, + created_at TEXT NOT NULL); + CREATE TABLE IF NOT EXISTS language_sites( + group_id TEXT NOT NULL REFERENCES language_groups(id) ON DELETE CASCADE, + site_id TEXT NOT NULL REFERENCES sites(id) ON DELETE CASCADE, + locale TEXT NOT NULL, PRIMARY KEY(group_id,site_id), + UNIQUE(group_id,locale), UNIQUE(site_id)); + CREATE TABLE IF NOT EXISTS translation_units( + id TEXT PRIMARY KEY, group_id TEXT NOT NULL REFERENCES language_groups(id) ON DELETE CASCADE, + reference_key TEXT NOT NULL, created_at TEXT NOT NULL, + UNIQUE(group_id,reference_key)); + CREATE TABLE IF NOT EXISTS translation_members( + unit_id TEXT NOT NULL REFERENCES translation_units(id) ON DELETE CASCADE, + site_id TEXT NOT NULL REFERENCES sites(id) ON DELETE CASCADE, + entry_id TEXT NOT NULL REFERENCES entries(id) ON DELETE CASCADE, + state TEXT NOT NULL CHECK(state IN ('pending','approved')), + PRIMARY KEY(unit_id,site_id),UNIQUE(site_id,entry_id)); + CREATE INDEX IF NOT EXISTS idx_translations_site ON translation_members(site_id,state); + ''') + +def require_group(group_id): + group=db.one('SELECT * FROM language_groups WHERE id=?',(group_id,)) + if not group:raise HTTPException(404,'语言组不存在') + return group + +def _authorized(request,group_id,role='viewer'): + sites=db.rows('SELECT site_id FROM language_sites WHERE group_id=?',(group_id,)) + # At least one managed member is needed to read or edit the group. + if not getattr(request.state,'is_superadmin',False): + if not any(enterprise.level(request,s['site_id'])>=enterprise.ACCESS[role] for s in sites): + raise HTTPException(403,'无权管理此语言组') + return sites + +class GroupIn(BaseModel): + name:str=Field(min_length=2,max_length=120) + default_locale:str='en' +class GroupSiteIn(BaseModel): + site_id:str + locale:str +class UnitIn(BaseModel): + reference_key:str +class MemberIn(BaseModel): + site_id:str + entry_id:str + state:str='pending' + +@router.post('/groups',status_code=201) +def create_group(data:GroupIn,request:Request): + if not request.state.is_superadmin:raise HTTPException(403,'仅管理员可创建语言组') + try:locale=locale_value(data.default_locale) + except ValueError as exc:raise HTTPException(400,str(exc)) + gid=uid() + db.insert('INSERT INTO language_groups VALUES (?,?,?,?)',(gid,data.name,locale,db.now())) + return {'id':gid,'name':data.name,'default_locale':locale} + +class LocaleIn(BaseModel): + locale:str + +@router.put('/sites/{site_id}/locale') +def set_site_locale(site_id:str,data:LocaleIn,request:Request): + """Declare this site's content language (BCP47). Used for , defaults zh-CN.""" + enterprise.require(request,site_id,'owner') + try:locale=locale_value(data.locale) + except ValueError as exc:raise HTTPException(400,str(exc)) + site=db.one('SELECT settings_json FROM sites WHERE id=?',(site_id,)) + if not site:raise HTTPException(404,'网站不存在') + settings=json.loads(site['settings_json'] or '{}') + settings['locale']=locale + db.execute('UPDATE sites SET settings_json=?,updated_at=? WHERE id=?',(json.dumps(settings,ensure_ascii=False),db.now(),site_id)) + return {'site_id':site_id,'locale':locale} + +@router.get('/groups') +def groups(request:Request): + gs=db.rows('SELECT * FROM language_groups ORDER BY created_at DESC') + if not request.state.is_superadmin: + gs=[g for g in gs if any(enterprise.level(request,s['site_id'])>=enterprise.ACCESS['viewer'] for s in db.rows('SELECT site_id FROM language_sites WHERE group_id=?',(g['id'],)))] + return gs + +@router.get('/sites/{site_id}') +def site_language(site_id:str,request:Request): + enterprise.require(request,site_id,'viewer') + membership=db.one('''SELECT s.locale,s.group_id,g.name,g.default_locale FROM language_sites s + JOIN language_groups g ON g.id=s.group_id WHERE s.site_id=?''',(site_id,)) + if not membership:return {'group':None,'sites':[],'units':[]} + gid=membership['group_id'] + _authorized(request,gid) + sites=db.rows('''SELECT s.locale,s.site_id,t.name,t.domain FROM language_sites s + JOIN sites t ON t.id=s.site_id WHERE s.group_id=? ORDER BY s.locale''',(gid,)) + units=db.rows('''SELECT u.id,u.reference_key,m.site_id,m.entry_id,m.state,e.title,e.route,s.locale + FROM translation_units u JOIN translation_members m ON m.unit_id=u.id + JOIN entries e ON e.id=m.entry_id JOIN language_sites s ON s.site_id=m.site_id + WHERE u.group_id=? ORDER BY u.reference_key,s.locale''',(gid,)) + return {'group':membership,'sites':sites,'units':units} + +@router.post('/groups/{group_id}/sites',status_code=201) +def join_site(group_id:str,data:GroupSiteIn,request:Request): + require_group(group_id) + _authorized(request,group_id,'owner') + enterprise.require(request,data.site_id,'owner') + site=db.one('SELECT * FROM sites WHERE id=?',(data.site_id,)) + if not site:raise HTTPException(404,'网站不存在') + try: + locale=locale_value(data.locale) + domain=_domain(site) + except ValueError as exc:raise HTTPException(400,str(exc)) + existing=db.rows('''SELECT x.site_id,t.domain FROM language_sites x JOIN sites t ON t.id=x.site_id + WHERE x.group_id=?''',(group_id,)) + if any(_domain(s)==domain and s['site_id']!=data.site_id for s in existing): + raise HTTPException(409,'语言组内两个网站不能使用相同域名') + if db.one('SELECT site_id FROM language_sites WHERE site_id=?',(data.site_id,)): + raise HTTPException(409,'该站点已经属于语言组') + try:db.insert('INSERT INTO language_sites VALUES (?,?,?)',(group_id,data.site_id,locale)) + except Exception as exc: + if 'UNIQUE' in str(exc).upper():raise HTTPException(409,'组内语言标识已存在') + raise + return {'group_id':group_id,'site_id':data.site_id,'locale':locale} + +@router.post('/groups/{group_id}/units',status_code=201) +def create_unit(group_id:str,data:UnitIn,request:Request): + require_group(group_id);_authorized(request,group_id,'editor') + key=data.reference_key.strip() + if not KEY_PATTERN.fullmatch(key):raise HTTPException(400,'翻译组标识只能包含字母、数字、短横线、下划线、点和冒号') + found=db.one('SELECT id FROM translation_units WHERE group_id=? AND reference_key=?',(group_id,key)) + if found:return {'id':found['id'],'reference_key':key,'existing':True} + id=uid();db.insert('INSERT INTO translation_units VALUES (?,?,?,?)',(id,group_id,key,db.now())) + return {'id':id,'reference_key':key,'existing':False} + +@router.post('/groups/{group_id}/units/{unit_id}/members') +def link_member(group_id:str,unit_id:str,data:MemberIn,request:Request): + require_group(group_id);_authorized(request,group_id,'editor') + enterprise.require(request,data.site_id,'editor') + unit=db.one('SELECT * FROM translation_units WHERE id=? AND group_id=?',(unit_id,group_id)) + if not unit:raise HTTPException(404,'翻译内容组不存在') + if not db.one('SELECT site_id FROM language_sites WHERE site_id=? AND group_id=?',(data.site_id,group_id)): + raise HTTPException(400,'网站不属于该语言组') + entry=db.one('SELECT * FROM entries WHERE id=? AND site_id=?',(data.entry_id,data.site_id)) + if not entry:raise HTTPException(404,'内容不存在或不属于该网站') + if data.state not in ('pending','approved'):raise HTTPException(400,'无效的翻译状态') + if data.state=='pending' and entry['status']=='published': + raise HTTPException(409,'待翻译内容必须先保存为草稿，避免泄露未完成翻译') + if data.state=='approved' and entry['status']!='published': + raise HTTPException(409,'只有已发布的正式内容才能审核通过翻译关系') + prior=db.one('SELECT unit_id FROM translation_members WHERE site_id=? AND entry_id=?',(data.site_id,data.entry_id)) + if prior and prior['unit_id']!=unit_id:raise HTTPException(409,'内容已经属于另一翻译组') + # Atomic upsert: one locale / site has at most one entry in a semantic group. + with db.connect() as c: + c.execute('''INSERT INTO translation_members(unit_id,site_id,entry_id,state) VALUES (?,?,?,?) + ON CONFLICT(unit_id,site_id) DO UPDATE SET entry_id=excluded.entry_id,state=excluded.state''', + (unit_id,data.site_id,data.entry_id,data.state)) + return {'unit_id':unit_id,'site_id':data.site_id,'entry_id':data.entry_id,'state':data.state} + +@router.delete('/groups/{group_id}/units/{unit_id}/members/{site_id}') +def unlink_member(group_id:str,unit_id:str,site_id:str,request:Request): + require_group(group_id);_authorized(request,group_id,'editor');enterprise.require(request,site_id,'editor') + deleted=db.execute('DELETE FROM translation_members WHERE unit_id=? AND site_id=?',(unit_id,site_id)) + if not deleted:raise HTTPException(404,'没有匹配的翻译关联') + return {'removed':True} + +def site_locale(site_id): + row=db.one('SELECT locale FROM language_sites WHERE site_id=?',(site_id,)) + if row:return row['locale'] + # Per-site locale override (e.g. standalone English sites outside any language group) + site=db.one('SELECT settings_json FROM sites WHERE id=?',(site_id,)) + try:override=json.loads(site['settings_json'] or '{}').get('locale') if site else None + except ValueError:override=None + if override: + try:return locale_value(override) + except ValueError:pass + return 'zh-CN' + +def assert_build_safe(site_id): + invalid=db.rows('''SELECT e.route,e.title FROM translation_members m JOIN entries e ON e.id=m.entry_id + WHERE m.site_id=? AND m.state='pending' AND e.status='published' ''',(site_id,)) + if invalid: + raise ValueError('有待翻译内容被设为已发布，禁止构建：'+', '.join(x['route'] for x in invalid[:8])) + +def alternates(site_id): + """Get {route: [(locale,absolute_url)]} with approved cross-site peers only. + + Return zero for unlinked/draft/noindex/invalid domain pages, including for + pending translation records. All members use the same symmetric set. + """ + row=db.one('SELECT group_id FROM language_sites WHERE site_id=?',(site_id,)) + if not row:return {} + gid=row['group_id'];group=db.one('SELECT * FROM language_groups WHERE id=?',(gid,)) + members=db.rows('''SELECT m.unit_id,s.locale,e.route,e.status,e.robots,e.canonical,t.domain,t.id AS site_id + FROM translation_members m JOIN entries e ON e.id=m.entry_id AND e.site_id=m.site_id + JOIN language_sites s ON s.site_id=m.site_id JOIN sites t ON t.id=m.site_id + JOIN translation_units u ON u.id=m.unit_id + WHERE u.group_id=? AND m.state='approved' ''',(gid,)) + by_unit={} + for item in members: + if item['status']!='published' or 'noindex' in item['robots'].lower():continue + try:domain=_domain(item) + except ValueError:continue + if item['canonical'] and item['canonical'].rstrip('/') != (domain+item['route']).rstrip('/'): + continue # a canonical elsewhere is not an indexable translation target + by_unit.setdefault(item['unit_id'],[]).append((item['site_id'],item['route'],item['locale'],domain+item['route'])) + result={} + for linked in by_unit.values(): + if len(linked)<2:continue + peers=sorted([(locale,url) for _,_,locale,url in linked],key=lambda x:x[0]) + # x-default is explicit only if an approved default-language peer exists. + default=next((url for locale,url in peers if locale==group['default_locale']),None) + if default:peers.append(('x-default',default)) + for sid,route,_,_ in linked: + if sid==site_id:result[route]=peers + return result + +def inject_seo(html,locale,links): + """Lightweight escape-safe HTML head augmentation without reparsing 5k pages.""" + html=re.sub(r"(]*?\blang=)[\"'\"][^\"']*[\"'\"]",lambda m:m.group(1)+'"'+html_escape(locale,quote=True)+'"',html,count=1,flags=re.I) + if not re.search(r']*\blang=',html,flags=re.I): + html=re.sub(r'' in html.lower(): + tags=''.join('' for language,url in links) + html=re.sub(r'',tags+'',html,count=1,flags=re.I) + # Visible accessible language switch; never fabricate links for missing translations. + labels={'zh-CN':'简体中文','en':'English','fr-FR':'Français','ar':'العربية', + 'es':'Español','ru':'Русский','pt':'Português'} + choices=[(language,url) for language,url in links if language!='x-default'] + nav='' + html=re.sub(r'',lambda _m:nav+'',html,count=1,flags=re.I) + return html + +def sitemap_alternates(links): + return ''.join('' for locale,url in links) diff --git a/app/pg_compat.py b/app/pg_compat.py index 8112f76..9fd7993 100644 --- a/app/pg_compat.py +++ b/app/pg_compat.py @@ -1,32 +1,87 @@ -"""PostgreSQL DB-API bridge for legacy '?' SQL (optional, requires psycopg[binary]). +"""Conservative PostgreSQL DB-API bridge for the existing SQLite-shaped application. -No automatic conversion of existing SQLite files is attempted. Production migration -requires a tested one-time data migration and reconciliation. +The row adapter intentionally supports BOTH row['column'] and row[0], because +several existing queue paths use positional aggregate results while API paths +serialize rows as dictionaries. PostgreSQL data migration remains explicit. """ from __future__ import annotations import re -from contextlib import contextmanager + +class PGRow(dict): + """Mapping-compatible row with SQLite-style positional indexing.""" + __slots__ = ('_values',) + + def __init__(self, columns, values): + values = tuple(values) + super().__init__(zip(columns, values)) + self._values = values + + def __getitem__(self, key): + if isinstance(key, int): + return self._values[key] + return super().__getitem__(key) + + +def row_factory(cursor): + columns = [col.name for col in (cursor.description or ())] + return lambda values: PGRow(columns, values) def placeholders(sql: str) -> str: - """Translate SQLite positional placeholders outside SQL quoted strings.""" - out=[];quote=None;i=0 + """Translate ? placeholders without modifying quoted strings or comments.""" + out=[]; i=0; state='code' while i str: sql=sql.strip() if re.match(r'^INSERT\s+OR\s+IGNORE\s+INTO\b',sql,re.I): @@ -38,8 +93,7 @@ def normalize(sql: str) -> str: class PGConnection: def __init__(self,dsn): import psycopg - from psycopg.rows import dict_row - self.connection=psycopg.connect(dsn,row_factory=dict_row,connect_timeout=5) + self.connection=psycopg.connect(dsn,row_factory=row_factory,connect_timeout=5) self.total_changes=0 def execute(self,sql,params=()): @@ -49,20 +103,19 @@ class PGConnection: if not re.fullmatch(r'[A-Za-z_][A-Za-z0-9_]*',table):raise ValueError('Invalid table name') return self.connection.execute('SELECT column_name AS name FROM information_schema.columns WHERE table_schema=current_schema() AND table_name=%s',(table,)) if stripped.upper()=='BEGIN IMMEDIATE': - # Conservative transaction-wide lock while porting SQLite queue semantics. - # Replace with per-site advisory locks before large multi-worker scale. + # Serialize short queue claim/limit transactions, not the worker execution. + # This prevents per-site races between concurrent enqueuers and claimers. return self.connection.execute('SELECT pg_advisory_xact_lock(823947231)') - if stripped.upper().startswith('PRAGMA '): - return _EmptyResult() + if stripped.upper().startswith('PRAGMA '):return _EmptyResult() cursor=self.connection.execute(normalize(sql),params) if cursor.rowcount and cursor.rowcount>0 and stripped.split(None,1)[0].upper() in ('UPDATE','INSERT','DELETE'): self.total_changes+=cursor.rowcount return cursor def executescript(self,script): - # Schema migrations contain only simple DDL and SQLite PRAGMA statements. - for statement in script.split(';'): - if statement.strip():self.execute(statement) + for statement in statements(script): + if not statement.lstrip().startswith('--') or '\n' in statement: + self.execute(statement) def __enter__(self):return self def __exit__(self,typ,val,tb): diff --git a/app/pg_disaster_recovery.py b/app/pg_disaster_recovery.py new file mode 100644 index 0000000..cfa77aa --- /dev/null +++ b/app/pg_disaster_recovery.py @@ -0,0 +1,239 @@ +"""V8.18 PostgreSQL disaster recovery, deliberately OFFLINE and fail-closed. + +The management process and all Workers must be stopped while backing up the +application database and shared filesystem to guarantee an application-level +consistent pair. No switch-over to production is performed by this module. + +pg_dump/pg_restore must be installed on the operator's administrative host. +Credentials are passed in child environment (not command arguments or logs). +""" +from __future__ import annotations + +import hashlib +import io +import json +import os +import re +import shutil +import stat +import subprocess +import tempfile +import zipfile +from datetime import datetime, timezone +from pathlib import Path, PurePosixPath +from urllib.parse import parse_qsl, unquote, urlsplit + +FORMAT = 'siteforge.pg.offline.v1' +MEDIA_ROOTS = ('media', 'legacy', 'builds', 'archives') +ALLOWED_EXTRA = {'manifest.json', 'database.dump'} +MAX_FILES = 250_000 +MAX_UNCOMPRESSED = 30_000_000_000 +MAX_RATIO = 1000 + +class RecoveryError(RuntimeError): + pass + + +def connection_env(url: str, base: dict | None = None) -> dict: + """PostgreSQL URL => libpq process env; never include password on argv.""" + p = urlsplit(url) + if p.scheme not in ('postgresql', 'postgres') or not p.hostname or not p.path.strip('/'): + raise RecoveryError('Require valid PostgreSQL URL with hostname and database') + if '/' in unquote(p.path[1:]): + raise RecoveryError('Invalid database name') + opts = dict(parse_qsl(p.query, keep_blank_values=True)) + allowed = {'sslmode': 'PGSSLMODE', 'sslrootcert': 'PGSSLROOTCERT', + 'sslcert': 'PGSSLCERT', 'sslkey': 'PGSSLKEY', + 'connect_timeout': 'PGCONNECT_TIMEOUT'} + if set(opts) - set(allowed): + raise RecoveryError('Unsupported PostgreSQL URL options') + try: + port = str(p.port or 5432) + except ValueError as exc: + raise RecoveryError('Invalid PostgreSQL port') from exc + env = dict(os.environ if base is None else base) + env.update({'PGHOST': p.hostname, 'PGPORT': port, + 'PGDATABASE': unquote(p.path[1:]), + 'PGUSER': unquote(p.username or ''), + 'PGPASSWORD': unquote(p.password or ''), + 'PGAPPNAME': 'siteforge-v818-maintenance'}) + env.update({allowed[k]: v for k, v in opts.items()}) + # Maintenance must never silently fall back to a developer's ~/.pgpass. + env['PGPASSFILE'] = os.devnull + return env + + +def run_pg(argv: list[str], env: dict, timeout: int = 1800) -> subprocess.CompletedProcess: + executable = argv[0] + if shutil.which(executable) is None: + raise RecoveryError(f'{executable} not installed on this host') + try: + result = subprocess.run(argv, env=env, stdout=subprocess.PIPE, + stderr=subprocess.PIPE, timeout=timeout, check=False) + except subprocess.TimeoutExpired as exc: + raise RecoveryError(f'{executable} timed out') from exc + except OSError as exc: + raise RecoveryError(f'{executable} execution failed') from exc + if result.returncode: + # pg tools can echo target location or credentials through external configs; + # do not include untrusted tool stderr in user-facing errors. + raise RecoveryError(f'{executable} returned non-zero exit code {result.returncode}') + return result + + +def sha256_stream(stream) -> str: + digest = hashlib.sha256() + for chunk in iter(lambda: stream.read(1024 * 1024), b''): + digest.update(chunk) + return digest.hexdigest() + + +def sha256_path(path: Path) -> str: + with path.open('rb') as f: + return sha256_stream(f) + + +def media_files(source: Path): + for folder in MEDIA_ROOTS: + root = source / folder + if root.is_symlink(): + raise RecoveryError(f'Symlinked storage root not allowed: {folder}') + if not root.exists(): + continue + for node in sorted(root.rglob('*')): + if node.is_symlink(): + raise RecoveryError('Symlinked file in storage tree') + if node.is_file(): + yield node, node.relative_to(source).as_posix() + + +def safe_member(name: str) -> bool: + p = PurePosixPath(name) + return bool(name and not name.endswith('/') and '\\' not in name and '\0' not in name + and not p.is_absolute() and ':' not in name and + all(part not in ('', '.', '..') for part in name.split('/')) and + (name in ALLOWED_EXTRA or p.parts[0] in MEDIA_ROOTS)) + + +def _inspect(path: Path): + try: + with zipfile.ZipFile(path) as z: + infos = z.infolist() + if len(infos) > MAX_FILES or sum(i.file_size for i in infos) > MAX_UNCOMPRESSED: + raise RecoveryError('Backup resource limits exceeded') + items = {} + for info in infos: + if not safe_member(info.filename) or info.filename in items: + raise RecoveryError('Unsafe or duplicate archive member') + if stat.S_ISLNK(info.external_attr >> 16): + raise RecoveryError('Symlink in backup') + if info.file_size > 5_000_000 and info.compress_size == 0: + raise RecoveryError('Invalid compressed member') + if info.file_size > 5_000_000 and info.file_size / max(info.compress_size, 1) > MAX_RATIO: + raise RecoveryError('Unreasonable compression ratio') + items[info.filename] = info + if set(ALLOWED_EXTRA) - set(items): + raise RecoveryError('Database dump or manifest missing') + if items['manifest.json'].file_size > 2_000_000: + raise RecoveryError('Manifest exceeds size limit') + manifest = json.loads(z.read('manifest.json')) + if manifest.get('format') != FORMAT or not isinstance(manifest.get('files'), dict): + raise RecoveryError('Not a compatible SiteForge PG backup') + documented = manifest['files'] + if set(documented) != set(items) - {'manifest.json'}: + raise RecoveryError('Manifest and ZIP files differ') + for name, rec in documented.items(): + if (not isinstance(rec, dict) or not isinstance(rec.get('size'), int) + or rec['size'] != items[name].file_size or + not re.fullmatch('[0-9a-f]{64}', str(rec.get('sha256', '')))): + raise RecoveryError('Invalid file metadata') + with z.open(name) as f: + digest = sha256_stream(f) + if digest != rec['sha256']: + raise RecoveryError('Checksum mismatch: ' + name[:100]) + return manifest + except (zipfile.BadZipFile, json.JSONDecodeError, KeyError, UnicodeError) as exc: + raise RecoveryError('Corrupted PostgreSQL backup') from exc + + +def verify(path: str | Path) -> dict: + return _inspect(Path(path).resolve()) + + +def backup(url: str, data: str | Path, archive: str | Path, *, confirmed_offline: bool = False, + timeout: int = 1800) -> dict: + if not confirmed_offline: + raise RecoveryError('Stop all Web/Workers and pass --confirmed-offline') + env = connection_env(url) + source = Path(data).resolve() + if not source.is_dir(): + raise RecoveryError('Shared storage directory does not exist') + destination = Path(archive).resolve() + if destination.exists(): + raise RecoveryError('Refusing to overwrite an existing backup') + destination.parent.mkdir(parents=True, exist_ok=True) + staging = destination.with_name(destination.name + '.partial') + if staging.exists(): + raise RecoveryError('Partial backup file already exists') + with tempfile.TemporaryDirectory(prefix='sf-pg-backup-') as temp: + dump = Path(temp) / 'database.dump' + run_pg(['pg_dump', '--format=custom', '--no-owner', '--no-acl', + '--file', str(dump)], env, timeout) + if not dump.is_file() or dump.stat().st_size == 0: + raise RecoveryError('Empty database dump') + run_pg(['pg_restore', '--list', str(dump)], env, min(120, timeout)) + members = [(dump, 'database.dump'), *media_files(source)] + if len(members) > MAX_FILES: + raise RecoveryError('Too many storage files') + if sum(p.stat().st_size for p, _ in members) > MAX_UNCOMPRESSED: + raise RecoveryError('Too much data for one backup') + manifest = {'format': FORMAT, 'created_at': datetime.now(timezone.utc).isoformat(), + 'database': 'postgresql', 'consistent': 'operator-confirmed-offline', + 'files': {}} + try: + with zipfile.ZipFile(staging, 'w', compression=zipfile.ZIP_DEFLATED, compresslevel=5, + allowZip64=True) as z: + for path, name in members: + manifest['files'][name] = {'size': path.stat().st_size, 'sha256': sha256_path(path)} + z.write(path, name) + z.writestr('manifest.json', json.dumps(manifest, ensure_ascii=False, sort_keys=True)) + _inspect(staging) + staging.replace(destination) + finally: + staging.unlink(missing_ok=True) + return {'archive': str(destination), 'files': len(members), + 'bytes': sum(x['size'] for x in manifest['files'].values())} + + +def restore_new(url: str, archive: str | Path, data: str | Path, *, confirmed_offline: bool = False, + timeout: int = 1800) -> dict: + """Restore ONLY into new, EMPTY PG database and non-existing storage path.""" + if not confirmed_offline: + raise RecoveryError('Explicit offline confirmation is required') + path = Path(archive).resolve() + manifest = verify(path) + dest = Path(data).resolve() + if dest.exists(): + raise RecoveryError('Target storage must not exist (restore into new directory)') + dest.parent.mkdir(parents=True, exist_ok=True) + env = connection_env(url) + # Empty target database check: exclude PostgreSQL system/extension internals. + sql = "SELECT COUNT(*) FROM pg_catalog.pg_class WHERE relnamespace = 'public'::regnamespace AND relkind IN ('r','p','v','m','S','f')" + result = run_pg(['psql', '--no-psqlrc', '--tuples-only', '--no-align', '--command', sql], env, 40) + if result.stdout.strip() != b'0': + raise RecoveryError('Target database public schema must be empty') + with tempfile.TemporaryDirectory(prefix='.sf-pg-restore-', dir=dest.parent) as tmp: + stage = Path(tmp) / 'siteforge'; stage.mkdir() + with zipfile.ZipFile(path) as z: + for name in manifest['files']: + target = stage / name + target.parent.mkdir(parents=True, exist_ok=True) + with z.open(name) as src, target.open('wb') as out: + shutil.copyfileobj(src, out, 1024 * 1024) + dump = stage / 'database.dump' + run_pg(['pg_restore', '--exit-on-error', '--single-transaction', '--no-owner', '--no-acl', + '--dbname', env['PGDATABASE'], str(dump)], env, timeout) + dump.unlink() + stage.replace(dest) + return {'database': 'restored-into-empty-target', 'storage': str(dest), + 'media_files': len(manifest['files']) - 1} diff --git a/app/release_api.py b/app/release_api.py index 47901d4..0025d68 100644 --- a/app/release_api.py +++ b/app/release_api.py @@ -3,9 +3,9 @@ import hashlib,json,os,time from pathlib import Path from fastapi import APIRouter,HTTPException,Request,Body from pydantic import BaseModel,Field -import httpx -from . import db,enterprise,quality,secret_refs,safe_http +from . import db,enterprise,quality,secret_refs,safe_http,jobs from .deploy_agent import signature +from . import release_targets router=APIRouter(prefix='/api/production',tags=['Production delivery']) @@ -50,55 +50,189 @@ def approved(site_id,build_id): if not request:raise HTTPException(409,'Independent release approval required') return row -@router.post('/sites/{site_id}/deploy') + +def _target_config(target, *, resolve_secret=True): + if target not in ('staging','production'): + raise HTTPException(400,'无效的目标环境') + prefix='SITEFORGE_DEPLOY_'+target.upper() + url=os.environ.get(prefix+'_URL','').rstrip('/') + ref=os.environ.get(prefix+'_SECRET_REF','') + if not resolve_secret: + if ref: + try:secret_refs.validate_reference(ref) + except secret_refs.SecretReferenceError:raise HTTPException(503,'密钥引用格式无效') + if not url.startswith('https://') or not (ref or os.environ.get(prefix+'_SECRET')): + raise HTTPException(503,'请先配置 HTTPS 发布目标和密钥引用') + return url,'' + try:secret=secret_refs.resolve(ref) if ref else os.environ.get(prefix+'_SECRET','') + except secret_refs.SecretReferenceError:raise HTTPException(503,'未能读取远程发布密钥') + if not url.startswith('https://') or len(secret)<32: + raise HTTPException(503,'请先配置 HTTPS 发布目标和长度不少于32位的密钥') + return url,secret + + +def _remote(site,url,secret,method,path,body=b''): + stamp=str(int(time.time())) + headers={'X-SiteForge-Timestamp':stamp,'X-SiteForge-Signature':signature(secret,site,stamp,body,method,path)} + if body:headers['Content-Type']='application/zip' + try: + if method=='POST':response=safe_http.post(url+path,body=body,headers=headers,timeout=120) + else:response=safe_http.fetch(url+path,headers=headers,method='GET',timeout=30) + # 4xx are validation failures, not retryable network errors. + if response.status_code in (400,401,403,404,409,413): + raise HTTPException(409,'远程发布端拒绝操作，请检查签名、存档完整性或版本状态') + response.raise_for_status() + return response.json() + except HTTPException:raise + except (safe_http.OutboundError,OSError,ValueError) as ex: + # Never include URL, secret, request headers or upstream response in error message. + raise HTTPException(502,'远程连接或回应失败，请从任务中心重试') from ex + + +def _archive_for(site_id,record): + archive=Path(record['zip_path']).resolve() + expected_root=(db.DATA/'archives').resolve() + if not archive.is_relative_to(expected_root) or not archive.name.startswith(site_id+'-') or not archive.is_file(): + raise HTTPException(409,'构建 ZIP 不存在或地址不安全') + if archive.stat().st_size>120*1024*1024: + raise HTTPException(409,'构建包超出 Agent 上传限制') + return archive + + +def run_delivery(site_id,kind,opts,job_id): + """Called only by Worker subprocess; re-check approvals before changing live pointer.""" + target=opts['target'] + mode=release_targets.backend(target) + if mode=='agent':url,secret=_target_config(target) + if kind=='remote_deploy': + build_id=opts['build_id'] + record=approved(site_id,build_id) + archive=_archive_for(site_id,record) + if mode!='agent': + value=release_targets.deploy(target,site_id,archive) + db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)', + (enterprise.uid(),site_id,build_id,'worker:'+job_id,'remote:'+target,db.now())) + db.insert('''INSERT INTO remote_releases VALUES (?,?,?,?,?,?) + ON CONFLICT(site_id,target,release_id) DO UPDATE SET + deployed_at=excluded.deployed_at,actor=excluded.actor''', + (site_id,build_id,target,value['release'],'worker:'+job_id,db.now())) + return {**value,'build_id':build_id} + body=archive.read_bytes() + digest=hashlib.sha256(body).hexdigest() + # Stage only: no traffic change on upload or checksum failure. + staged=_remote(site_id,url,secret,'POST',f'/staging/{site_id}',body) + release=staged['release'] + if digest!=staged.get('sha256') or release!=digest[:20]: + raise HTTPException(409,'远程存档摘要不匹配，未激活') + verified=_remote(site_id,url,secret,'GET',f'/sites/{site_id}/verify/{release}') + if not verified.get('verified') or verified.get('sha256')!=digest: + raise HTTPException(409,'远程文件校验失败，未激活') + activated=_remote(site_id,url,secret,'POST',f'/sites/{site_id}/activate/{release}') + if activated.get('current')!=release or not activated.get('active'): + raise HTTPException(502,'远程版本切换未确认') + confirmation=_remote(site_id,url,secret,'GET',f'/sites/{site_id}/verify/{release}') + # Verify public document is actually served, not only that the pointer changed. + with __import__('zipfile').ZipFile(archive) as package: + index_hash=hashlib.sha256(package.read('index.html')).hexdigest() + probe_ok=False + try: + response=safe_http.fetch(f'{url}/public/{site_id}/',timeout=20,max_bytes=8_000_000) + probe_ok=(response.status_code==200 and hashlib.sha256(response.content).hexdigest()==index_hash) + except (safe_http.OutboundError,OSError,ValueError): + pass + if not confirmation.get('active') or confirmation.get('sha256')!=digest or not probe_ok: + previous=activated.get('previous') + if previous and previous!=release: + try:_remote(site_id,url,secret,'POST',f'/sites/{site_id}/rollback/{previous}') + except Exception:pass + raise HTTPException(502,'发布后内容验证未通过，已尝试恢复旧版本，请人工复核') + db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)', + (enterprise.uid(),site_id,build_id,'worker:'+job_id,'remote:'+target,db.now())) + db.insert('''INSERT INTO remote_releases VALUES (?,?,?,?,?,?) + ON CONFLICT(site_id,target,release_id) DO UPDATE SET + deployed_at=excluded.deployed_at,actor=excluded.actor''', + (site_id,build_id,target,release,'worker:'+job_id,db.now())) + return {'published':True,'release':release,'build_id':build_id,'target':target, + 'files':confirmation['files'],'sha256':digest,'previous':activated.get('previous')} + if kind=='remote_rollback': + release=opts['release_id'] + old=db.one('SELECT * FROM remote_releases WHERE site_id=? AND target=? AND release_id=?', + (site_id,target,release)) + if not old:raise HTTPException(404,'只能回滚至本站曾发布的历史版本') + if mode!='agent': + value=release_targets.rollback(target,site_id,release) + db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)', + (enterprise.uid(),site_id,old['build_id'],'worker:'+job_id, + 'remote-rollback:'+target,db.now())) + return {**value,'build_id':old['build_id']} + verified=_remote(site_id,url,secret,'GET',f'/sites/{site_id}/verify/{release}') + if not verified.get('verified'):raise HTTPException(409,'旧版本文件校验失败') + result=_remote(site_id,url,secret,'POST',f'/sites/{site_id}/rollback/{release}') + confirmation=_remote(site_id,url,secret,'GET',f'/sites/{site_id}/verify/{release}') + if not confirmation.get('active'):raise HTTPException(502,'回滚后未能确认线上版本') + db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)', + (enterprise.uid(),site_id,old['build_id'],'worker:'+job_id,'remote-rollback:'+target,db.now())) + return {'rolled_back':True,'target':target,'release':release,'build_id':old['build_id']} + raise ValueError('Unknown delivery job kind') + + +@router.get('/sites/{site_id}/delivery-status') +def delivery_status(request:Request,site_id:str): + enterprise.require(request,site_id,'viewer') + active=db.rows("SELECT id,kind,state,attempts,error,created_at,result_json FROM build_jobs WHERE site_id=? AND kind IN ('remote_deploy','remote_rollback') ORDER BY created_at DESC LIMIT 30",(site_id,)) + history=db.rows('SELECT * FROM remote_releases WHERE site_id=? ORDER BY deployed_at DESC LIMIT 30',(site_id,)) + # Return target readiness without revealing hostnames or credential refs. + configured={} + modes={} + for t in ('staging','production'): + modes[t]=release_targets.backend(t) + try: + if modes[t]=='agent':_target_config(t,resolve_secret=False) + else:release_targets.config(t) + configured[t]=True + except HTTPException:configured[t]=False + return {'jobs':active,'history':history,'configured':configured,'backends':modes} + + +@router.get('/sites/{site_id}/preflight/{build_id}') +def preflight(request:Request,site_id:str,build_id:str): + enterprise.require(request,site_id,'viewer') + try: + record=approved(site_id,build_id) + _archive_for(site_id,record) + return {'ready':True,'build_id':build_id,'message':'已满足构建、质量、迁移和独立审批条件'} + except HTTPException as exc: + return {'ready':False,'build_id':build_id,'message':str(exc.detail)} + + +@router.post('/sites/{site_id}/deploy',status_code=202) def push(request:Request,site_id:str,payload:DeployRequest): enterprise.require(request,site_id,'owner') record=approved(site_id,payload.build_id) - # Environment-specific endpoint is operator managed, never accepted from user JSON. - prefix='SITEFORGE_DEPLOY_'+payload.target.upper() - url=os.environ.get(prefix+'_URL','').rstrip('/') - secret_ref=os.environ.get(prefix+'_SECRET_REF','') - try:secret=secret_refs.resolve(secret_ref) if secret_ref else os.environ.get(prefix+'_SECRET','') - except secret_refs.SecretReferenceError:raise HTTPException(503,'Deployment secret reference unavailable') - if not url.startswith('https://') or len(secret)<32:raise HTTPException(503,'HTTPS deployment target not configured') - archive=Path(record['zip_path']).resolve() - expected_root=(db.DATA/'archives').resolve() - if (not archive.is_relative_to(expected_root) or not archive.name.startswith(site_id+'-') or not archive.is_file()):raise HTTPException(409,'Build artifact not found') - data=archive.read_bytes() - stamp=str(int(time.time())) - headers={'X-SiteForge-Timestamp':stamp,'X-SiteForge-Signature':signature(secret,site_id,stamp,data,'POST',f'/deploy/{site_id}'),'Content-Type':'application/zip'} - try: - response=safe_http.post(f'{url}/deploy/{site_id}',body=data,headers=headers,timeout=120) - response.raise_for_status() - result=response.json() - except (safe_http.OutboundError,OSError,ValueError) as ex:raise HTTPException(502,'Remote release failed') - db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)',(enterprise.uid(),site_id,payload.build_id,request.state.actor,'remote:'+payload.target,db.now())) - db.insert('INSERT INTO remote_releases VALUES (?,?,?,?,?,?)',(site_id,payload.build_id,payload.target,result['release'],request.state.actor,db.now())) - return {'published':True,'target':payload.target,'build':payload.build_id,'remote':result} + _archive_for(site_id,record) + if release_targets.backend(payload.target)=='agent':_target_config(payload.target,resolve_secret=False) + else:release_targets.config(payload.target) + key=request.headers.get('idempotency-key') + try:return jobs.submit_delivery(site_id,'remote_deploy', + {'target':payload.target,'build_id':payload.build_id},request.state.actor,key) + except jobs.JobConflict as exc:raise HTTPException(409,str(exc)) + except jobs.JobCapacityError as exc:raise HTTPException(429,str(exc)) class RollbackRequest(BaseModel): release_id:str=Field(pattern=r'^[0-9a-f]{20}$') target:str=Field(default='staging',pattern='^(staging|production)$') -@router.post('/sites/{site_id}/rollback') +@router.post('/sites/{site_id}/rollback',status_code=202) def rollback_remote(request:Request,site_id:str,payload:RollbackRequest): enterprise.require(request,site_id,'owner') old=db.one('SELECT * FROM remote_releases WHERE site_id=? AND target=? AND release_id=?', (site_id,payload.target,payload.release_id)) - if not old:raise HTTPException(404,'仅允许回滚到本站曾经部署过的版本') - prefix='SITEFORGE_DEPLOY_'+payload.target.upper() - url=os.environ.get(prefix+'_URL','').rstrip('/') - secret_ref=os.environ.get(prefix+'_SECRET_REF','') - try:secret=secret_refs.resolve(secret_ref) if secret_ref else os.environ.get(prefix+'_SECRET','') - except secret_refs.SecretReferenceError:raise HTTPException(503,'Deployment secret reference unavailable') - if not url.startswith('https://') or len(secret)<32:raise HTTPException(503,'HTTPS deployment target not configured') - stamp=str(int(time.time())) - headers={'X-SiteForge-Timestamp':stamp,'X-SiteForge-Signature':signature(secret,site_id,stamp,b'','POST',f'/sites/{site_id}/rollback/{payload.release_id}')} - try: - r=safe_http.post(f'{url}/sites/{site_id}/rollback/{payload.release_id}',headers=headers,timeout=30) - r.raise_for_status() - result=r.json() - except (safe_http.OutboundError,OSError,ValueError) as ex:raise HTTPException(502,'Remote rollback failed') - db.insert('INSERT INTO release_history VALUES (?,?,?,?,?,?)',(enterprise.uid(),site_id,old['build_id'],request.state.actor,'remote-rollback:'+payload.target,db.now())) - return result + if not old:raise HTTPException(404,'仅允许回滚到本站曾部署过的版本') + if release_targets.backend(payload.target)=='agent':_target_config(payload.target,resolve_secret=False) + else:release_targets.config(payload.target) + key=request.headers.get('idempotency-key') + try:return jobs.submit_delivery(site_id,'remote_rollback', + {'target':payload.target,'release_id':payload.release_id},request.state.actor,key) + except jobs.JobConflict as exc:raise HTTPException(409,str(exc)) + except jobs.JobCapacityError as exc:raise HTTPException(429,str(exc)) diff --git a/app/release_targets.py b/app/release_targets.py new file mode 100644 index 0000000..0546a4f --- /dev/null +++ b/app/release_targets.py @@ -0,0 +1,367 @@ +"""Native publication backends. Only Worker calls these methods. + +SFTP: verified immutable directories and an atomic POSIX symlink switch. +S3: verified immutable object prefixes with a conditional current.json pointer. +S3 requires a pointer-aware edge/gateway; it is not a naked S3 website switch. +""" +from __future__ import annotations +import hashlib, io, json, os, posixpath, re, stat, uuid, zipfile +from contextlib import contextmanager +from pathlib import Path +from urllib.parse import urlsplit +from fastapi import HTTPException +from . import secret_refs, safe_http +from .deploy_agent import validate_archive + +SITE_RE=re.compile(r'^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$') +RELEASE_RE=re.compile(r'^[0-9a-f]{20}$') +MAX_ARCHIVE=120*1024*1024 + +def _env(target,field): + return os.getenv(f'SITEFORGE_DEPLOY_{target.upper()}_{field}','').strip() + +def backend(target): + if target not in ('staging','production'):raise HTTPException(400,'未知发布环境') + value=_env(target,'TYPE') or 'agent' + if value not in ('agent','sftp','s3'):raise HTTPException(503,'发布目标类型无效') + return value + +def _root(value): + if not value.startswith('/') or value=='/' or '\\' in value or '..' in value.split('/'): + raise HTTPException(503,'远程发布根目录必须为安全的绝对路径') + normalized=posixpath.normpath(value) + if normalized in ('/','/tmp') or len(normalized)<4:raise HTTPException(503,'远程发布根目录范围过大') + return normalized + +def config(target, *, check_files=False): + kind=backend(target) + if kind=='agent':return {'type':'agent'} + public=_env(target,'PUBLIC_URL') + parsed=urlsplit(public) + if parsed.scheme!='https' or not parsed.netloc or parsed.username or parsed.password: + raise HTTPException(503,'原生 SFTP/S3 发布必须提前配置 HTTPS PUBLIC_URL') + if kind=='sftp': + host=_env(target,'HOST');user=_env(target,'USERNAME') + root=_root(_env(target,'REMOTE_ROOT')) + known=_env(target,'KNOWN_HOSTS_FILE');key=_env(target,'SSH_KEY_FILE') + if not host or not user or not known or not key or '/' in host or ':' in host: + raise HTTPException(503,'SFTP 缺少主机、用户、known_hosts 或私钥配置') + try:port=int(_env(target,'PORT') or 22) + except ValueError:raise HTTPException(503,'SFTP 端口无效') + if not 1<=port<=65535:raise HTTPException(503,'SFTP 端口无效') + if check_files and (not Path(known).is_file() or not Path(key).is_file()): + raise HTTPException(503,'SFTP 私钥或 known_hosts 文件未挂载') + return {'type':kind,'host':host,'user':user,'root':root,'known_hosts':known,'ssh_key':key,'port':port} + bucket=_env(target,'BUCKET');region=_env(target,'REGION');prefix=_env(target,'PREFIX') or 'siteforge' + if not bucket or not region or not re.fullmatch(r'[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}',bucket): + raise HTTPException(503,'S3 存储桶或区域配置不完整') + if prefix.startswith('/') or '..' in prefix.split('/') or not re.fullmatch(r'[a-zA-Z0-9/_-]+',prefix): + raise HTTPException(503,'S3 对象前缀不安全') + endpoint=_env(target,'ENDPOINT_URL') + if endpoint: + parsed=urlsplit(endpoint) + if parsed.scheme!='https' or not parsed.netloc or parsed.username or parsed.password or parsed.path.strip('/'): + raise HTTPException(503,'S3 兼容服务端点必须为 HTTPS 根地址') + if _env(target,'POINTER_AWARE')!='1': + raise HTTPException(503,'S3 必须配置可解析 current.json 的发布网关（POINTER_AWARE=1）') + return {'type':kind,'bucket':bucket,'region':region,'prefix':prefix.strip('/'), 'endpoint':endpoint} + +def _archive(raw:bytes): + if len(raw)>MAX_ARCHIVE:raise ValueError('超出单次发布大小上限') + validate_archive(raw) + output={} + with zipfile.ZipFile(io.BytesIO(raw)) as z: + for member in z.infolist(): + if member.is_dir():continue + path=member.filename + # validate_archive already checked all paths, duplicates, symlinks and size bounds. + output[path]=z.read(member) + hashes={k:hashlib.sha256(v).hexdigest() for k,v in output.items()} + digest=hashlib.sha256(raw).hexdigest() + return digest[:20],digest,output,hashes + +def _manifest(digest,hashes): + return json.dumps({'sha256':digest,'files':hashes},sort_keys=True,separators=(',',':')).encode() + +def _probe(target,site,body): + public_url=_env(target,'PUBLIC_URL') + if not public_url: + raise HTTPException(503,'正式发布必须配置站点 PUBLIC_URL 以执行上线探测') + parsed=urlsplit(public_url) + if parsed.scheme!='https' or not parsed.netloc or parsed.username or parsed.password: + raise HTTPException(503,'PUBLIC_URL 必须为 HTTPS 网站地址') + url=public_url.rstrip('/')+'/' + try: + response=safe_http.fetch(url,timeout=25,max_bytes=8_000_000) + if response.status_code!=200 or hashlib.sha256(response.content).digest()!=hashlib.sha256(body).digest(): + raise HTTPException(502,'上线首页内容与构建版本不一致') + except safe_http.OutboundError as exc: + raise HTTPException(502,'上线地址不可访问，需检查发布和 DNS/CDN 状态') from exc + return True + +# ---------------- SFTP ---------------- +@contextmanager +def _sftp_connection(cfg): + """Strict host-key verification; private key mounted into Worker, never transmitted to API.""" + try:import paramiko + except ImportError as exc:raise HTTPException(503,'缺少可选的 Paramiko SFTP 依赖') from exc + client=paramiko.SSHClient() + client.load_host_keys(cfg['known_hosts']) + client.set_missing_host_key_policy(paramiko.RejectPolicy()) + try: + client.connect(cfg['host'],port=cfg['port'],username=cfg['user'], + key_filename=cfg['ssh_key'],look_for_keys=False,allow_agent=False, + timeout=12,auth_timeout=12,banner_timeout=12) + conn=client.open_sftp() + try:yield conn + finally:conn.close() + finally:client.close() + +def _sftp_type(sftp,path): + try:return sftp.lstat(path).st_mode + except OSError:return None + +def _mkdirs(sftp,path): + cur='' + for part in path.split('/'): + if not part:continue + cur+='/'+part + mode=_sftp_type(sftp,cur) + if mode is None: + sftp.mkdir(cur) + mode=_sftp_type(sftp,cur) + if not mode or not stat.S_ISDIR(mode):raise ValueError('远端目录包含符号链接或非目录') + +def _read(sftp,path,limit=4*1024*1024): + with sftp.file(path,'rb') as f:raw=f.read(limit+1) + if len(raw)>limit:raise ValueError('远程校验文件过大') + return raw + +def _write(sftp,path,data): + with sftp.file(path,'wb') as f:f.write(data);f.flush() + +def _current_sftp(sftp,root): + pointer=root+'/current' + mode=_sftp_type(sftp,pointer) + if mode is None:return None + if not stat.S_ISLNK(mode):raise ValueError('current 不是受管符号链接') + link=sftp.readlink(pointer) + if not re.fullmatch(r'releases/[0-9a-f]{20}',link):raise ValueError('current 指向不安全') + return link.rsplit('/',1)[1] + +def _verify_sftp(sftp,root,release): + folder=root+'/releases/'+release + mode=_sftp_type(sftp,folder) + if mode is None or not stat.S_ISDIR(mode):raise ValueError('远程版本目录缺失或不安全') + raw=_read(sftp,folder+'/.siteforge-manifest.json') + obj=json.loads(raw) + checks=obj.get('files') + if not isinstance(checks,dict) or 'index.html' not in checks:raise ValueError('远端文件清单无效') + for name,expected in checks.items(): + if name.startswith('/') or '..' in name.split('/') or not re.fullmatch('[a-f0-9]{64}',str(expected)): + raise ValueError('远端文件清单包含非法路径或哈希') + mode=_sftp_type(sftp,folder+'/'+name) + if mode is None or not stat.S_ISREG(mode):raise ValueError('远端发布资源缺失或不是普通文件') + with sftp.file(folder+'/'+name,'rb') as f: + dig=hashlib.sha256() + while True: + chunk=f.read(256*1024) + if not chunk:break + dig.update(chunk) + if dig.hexdigest()!=expected:raise ValueError('远端文件哈希不匹配') + return obj + +def _activate_sftp(sftp,root,release): + previous=_current_sftp(sftp,root) + candidate=root+'/current-'+release+'.next' + if _sftp_type(sftp,candidate) is not None:raise ValueError('发现冲突的发布指针临时文件') + sftp.symlink('releases/'+release,candidate) + try: + # OpenSSH posix-rename is atomic and replaces current. Fail closed if unsupported. + sftp.posix_rename(candidate,root+'/current') + finally: + if _sftp_type(sftp,candidate) is not None:sftp.remove(candidate) + if _current_sftp(sftp,root)!=release:raise ValueError('发布指针切换未确认') + return previous + +def deploy_sftp(target,site,raw,cfg=None): + cfg=cfg or config(target,check_files=True) + release,digest,files,hashes=_archive(raw) + root=cfg['root'].rstrip('/')+'/'+site + with _sftp_connection(cfg) as sftp: + _mkdirs(sftp,root+'/releases') + folder=root+'/releases/'+release + if _sftp_type(sftp,folder) is None: + tmp=root+'/releases/.staging-'+release+'-'+uuid.uuid4().hex[:12] + _mkdirs(sftp,tmp) + try: + for name,body in files.items(): + parent=posixpath.dirname(name) + if parent:_mkdirs(sftp,tmp+'/'+parent) + _write(sftp,tmp+'/'+name,body) + _write(sftp,tmp+'/.siteforge-manifest.json',_manifest(digest,hashes)) + # Immutable version path is not overwritten on retry. + sftp.rename(tmp,folder) + except Exception: + # No traffic change on failure. Interrupted transfers leave an + # isolated temporary directory; a retry uses a fresh name. + raise + meta=_verify_sftp(sftp,root,release) + if meta.get('sha256')!=digest:raise ValueError('现有版本摘要与当前构建不一致') + previous=_current_sftp(sftp,root) + if previous!=release:_activate_sftp(sftp,root,release) + try:_probe(target,site,files['index.html']) + except Exception: + if previous and previous!=release: + with _sftp_connection(cfg) as sftp: + _verify_sftp(sftp,root,previous) + _activate_sftp(sftp,root,previous) + raise + return {'published':True,'release':release,'previous':previous,'files':len(files),'sha256':digest,'target':target,'backend':'sftp'} + +def rollback_sftp(target,site,release,cfg=None,expected_home=None): + if not RELEASE_RE.fullmatch(release):raise ValueError('无效的版本号') + cfg=cfg or config(target,check_files=True) + root=cfg['root'].rstrip('/')+'/'+site + with _sftp_connection(cfg) as sftp: + _verify_sftp(sftp,root,release) + previous=_current_sftp(sftp,root) + if previous!=release:_activate_sftp(sftp,root,release) + content=_read(sftp,root+'/releases/'+release+'/index.html',8*1024*1024) + try:_probe(target,site,expected_home if expected_home is not None else content) + except Exception: + if previous and previous!=release: + with _sftp_connection(cfg) as sftp:_activate_sftp(sftp,root,previous) + raise + return {'rolled_back':True,'release':release,'backend':'sftp','target':target} + +# ---------------- S3 / compatible object store ---------------- +def _s3_client(cfg): + try:import boto3 + except ImportError as exc:raise HTTPException(503,'缺少可选的 boto3 S3 依赖') from exc + return boto3.client('s3',region_name=cfg['region'],endpoint_url=cfg['endpoint'] or None) + +def _s3_key(cfg,site,path):return cfg['prefix']+'/sites/'+site+'/'+path + +def _s3_bytes(s3,bucket,key,max_bytes=4*1024*1024): + response=s3.get_object(Bucket=bucket,Key=key) + data=response['Body'].read(max_bytes+1) + if len(data)>max_bytes:raise ValueError('S3 读取超过限制') + return data + +def _s3_current(s3,cfg,site): + key=_s3_key(cfg,site,'current.json') + try: + response=s3.get_object(Bucket=cfg['bucket'],Key=key) + except Exception as exc: + code=getattr(exc,'response',{}).get('Error',{}).get('Code','') + if str(code) in ('404','NoSuchKey','NotFound'):return None,None + raise + data=response['Body'].read(4096) + obj=json.loads(data) + if not RELEASE_RE.fullmatch(obj.get('release','')):raise ValueError('当前 S3 发布指针无效') + return obj['release'],response.get('ETag') + +def _s3_verify(s3,cfg,site,release): + path=_s3_key(cfg,site,'releases/'+release+'/') + obj=json.loads(_s3_bytes(s3,cfg['bucket'],path+'.siteforge-manifest.json')) + checks=obj['files'] + if 'index.html' not in checks:raise ValueError('S3 版本没有入口页') + for name,digest in checks.items(): + if name.startswith('/') or '..' in name.split('/') or not re.fullmatch('[a-f0-9]{64}',str(digest)): + raise ValueError('S3 文件清单路径或哈希非法') + response=s3.get_object(Bucket=cfg['bucket'],Key=path+name) + hasher=hashlib.sha256() + while True: + chunk=response['Body'].read(256*1024) + if not chunk:break + hasher.update(chunk) + if hasher.hexdigest()!=digest:raise ValueError('S3 对象校验失败') + return obj + +def _s3_point(s3,cfg,site,release,previous,etag): + key=_s3_key(cfg,site,'current.json') + body=json.dumps({'release':release,'previous':previous},sort_keys=True).encode() + args={'Bucket':cfg['bucket'],'Key':key,'Body':body,'ContentType':'application/json','CacheControl':'no-store'} + if etag:args['IfMatch']=etag + else:args['IfNoneMatch']='*' + s3.put_object(**args) + current,_=_s3_current(s3,cfg,site) + if current!=release:raise ValueError('S3 发布指针未确认') + +def _s3_immutable_put(s3,bucket,key,body,**extra): + """Create-only object write. A retry can reuse only byte-identical keys.""" + try: + s3.put_object(Bucket=bucket,Key=key,Body=body,IfNoneMatch='*',**extra) + return + except Exception as exc: + code=str(getattr(exc,'response',{}).get('Error',{}).get('Code','')) + if code not in ('PreconditionFailed','412','ConditionalRequestConflict','409'): + raise + existing=_s3_bytes(s3,bucket,key,max_bytes=max(8_000_000,len(body))) + if hashlib.sha256(existing).digest()!=hashlib.sha256(body).digest(): + raise ValueError('现有 S3 对象与当前发布文件不一致，禁止覆盖') + + +def deploy_s3(target,site,raw,cfg=None): + cfg=cfg or config(target) + release,digest,files,hashes=_archive(raw) + s3=_s3_client(cfg);bucket=cfg['bucket'] + base=_s3_key(cfg,site,'releases/'+release+'/') + manifest_key=base+'.siteforge-manifest.json' + try: + exists=_s3_bytes(s3,bucket,manifest_key) + except Exception as exc: + code=getattr(exc,'response',{}).get('Error',{}).get('Code','') + if str(code) not in ('404','NoSuchKey','NotFound'):raise + exists=None + if exists is None: + for name,body in files.items(): + import mimetypes + ct=mimetypes.guess_type(name)[0] or 'application/octet-stream' + cache='no-cache' if name.endswith('.html') else 'public, max-age=31536000, immutable' + _s3_immutable_put(s3,bucket,base+name,body,ContentType=ct,CacheControl=cache) + _s3_immutable_put(s3,bucket,manifest_key,_manifest(digest,hashes), + ContentType='application/json',CacheControl='no-store') + manifest=_s3_verify(s3,cfg,site,release) + if manifest.get('sha256')!=digest:raise ValueError('S3 版本摘要冲突') + previous,etag=_s3_current(s3,cfg,site) + if previous!=release:_s3_point(s3,cfg,site,release,previous,etag) + try:_probe(target,site,files['index.html']) + except Exception: + if previous and previous!=release: + current,next_etag=_s3_current(s3,cfg,site) + if current==release:_s3_point(s3,cfg,site,previous,release,next_etag) + raise + return {'published':True,'release':release,'previous':previous,'files':len(files),'sha256':digest,'target':target,'backend':'s3'} + +def rollback_s3(target,site,release,cfg=None,expected_home=None): + if not RELEASE_RE.fullmatch(release):raise ValueError('无效的版本号') + cfg=cfg or config(target) + s3=_s3_client(cfg) + _s3_verify(s3,cfg,site,release) + previous,etag=_s3_current(s3,cfg,site) + if previous!=release:_s3_point(s3,cfg,site,release,previous,etag) + body=_s3_bytes(s3,cfg['bucket'],_s3_key(cfg,site,'releases/'+release+'/index.html'),8*1024*1024) + try:_probe(target,site,expected_home if expected_home is not None else body) + except Exception: + if previous and previous!=release: + current,new_etag=_s3_current(s3,cfg,site) + if current==release:_s3_point(s3,cfg,site,previous,release,new_etag) + raise + return {'rolled_back':True,'release':release,'target':target,'backend':'s3'} + +def deploy(target,site,archive): + if not SITE_RE.fullmatch(site):raise ValueError('无效的网站标识') + cfg=config(target,check_files=True) + raw=Path(archive).read_bytes() + if cfg['type']=='sftp':return deploy_sftp(target,site,raw,cfg) + if cfg['type']=='s3':return deploy_s3(target,site,raw,cfg) + raise ValueError('不是原生发布目标') + +def rollback(target,site,release): + if not SITE_RE.fullmatch(site):raise ValueError('无效的网站标识') + cfg=config(target,check_files=True) + if cfg['type']=='sftp':return rollback_sftp(target,site,release,cfg) + if cfg['type']=='s3':return rollback_s3(target,site,release,cfg) + raise ValueError('不是原生发布目标') diff --git a/app/s3_gateway.py b/app/s3_gateway.py new file mode 100644 index 0000000..7ee01ce --- /dev/null +++ b/app/s3_gateway.py @@ -0,0 +1,71 @@ +"""Pointer-aware, read-only static website gateway for SiteForge S3 releases. + +This process requires ONLY S3 read permissions. It never takes publishing +credentials and never writes to the bucket. Deploy behind HTTPS reverse proxy. +""" +from __future__ import annotations +import json,os,re +from urllib.parse import unquote +from fastapi import FastAPI, HTTPException +from fastapi.responses import Response +from .release_targets import SITE_RE, RELEASE_RE + +app=FastAPI(title='SiteForge S3 read-only site gateway',docs_url=None,redoc_url=None,openapi_url=None) + +def gateway_config(): + bucket=os.getenv('SITEFORGE_S3_GATEWAY_BUCKET','').strip() + region=os.getenv('SITEFORGE_S3_GATEWAY_REGION','').strip() + prefix=os.getenv('SITEFORGE_S3_GATEWAY_PREFIX','siteforge').strip('/') + if not re.fullmatch(r'[A-Za-z0-9][A-Za-z0-9._-]{1,62}',bucket) or not region: + raise HTTPException(503,'S3 gateway storage not configured') + if not prefix or not re.fullmatch(r'[A-Za-z0-9/_-]+',prefix) or '..' in prefix.split('/'): + raise HTTPException(503,'Invalid S3 gateway prefix') + return bucket,region,prefix + +def client(region): + try:import boto3 + except ImportError as ex:raise HTTPException(503,'boto3 missing from release image') from ex + endpoint=os.getenv('SITEFORGE_S3_GATEWAY_ENDPOINT_URL','').strip() + if endpoint and not endpoint.startswith('https://'): + raise HTTPException(503,'S3 gateway endpoint must use TLS') + return boto3.client('s3',region_name=region,endpoint_url=endpoint or None) + +def _read(s3,bucket,key,limit=32*1024*1024): + try: + result=s3.get_object(Bucket=bucket,Key=key) + body=result['Body'].read(limit+1) + if len(body)>limit:raise HTTPException(413,'Static object exceeds gateway response limit') + return body, result + except HTTPException:raise + except Exception as ex: + code=str(getattr(ex,'response',{}).get('Error',{}).get('Code','')) + if code in ('404','NoSuchKey','NotFound'):raise HTTPException(404,'Static resource not found') from ex + raise HTTPException(502,'Storage unavailable') from ex + +def resolve_object(site,path,s3,bucket,prefix): + if not SITE_RE.fullmatch(site):raise HTTPException(404,'Invalid site') + path=unquote(path or '').lstrip('/') + if '\\' in path or '%' in path or '..' in path.split('/') or len(path)>2048: + raise HTTPException(404,'Invalid static path') + if not path or path.endswith('/'):path+='index.html' + pointer,_=_read(s3,bucket,f'{prefix}/sites/{site}/current.json',4096) + try:release=json.loads(pointer)['release'] + except (ValueError,TypeError,KeyError) as ex:raise HTTPException(502,'Invalid release pointer') from ex + if not RELEASE_RE.fullmatch(release):raise HTTPException(502,'Invalid release pointer') + objkey=f'{prefix}/sites/{site}/releases/{release}/{path}' + body,meta=_read(s3,bucket,objkey) + return body, meta.get('ContentType') or 'application/octet-stream', release + +@app.get('/health') +def health():return {'healthy':True,'gateway':'read-only-s3'} + +@app.get('/{site}/{path:path}') +def static_site(site:str,path:str=''): + bucket,region,prefix=gateway_config() + body,content_type,release=resolve_object(site,path,client(region),bucket,prefix) + return Response(content=body,media_type=content_type,headers={ + # URLs stay stable across releases, therefore cache must be revalidated. + 'Cache-Control':'no-cache, must-revalidate', + 'X-SiteForge-Release':release, + 'X-Content-Type-Options':'nosniff', + }) diff --git a/app/site_design_v87.py b/app/site_design_v87.py index c17db0d..f8b6fae 100644 --- a/app/site_design_v87.py +++ b/app/site_design_v87.py @@ -19,6 +19,7 @@ DEFAULTS={ 'show_cta':True,'cta_text':'联系我们','cta_href':'/contact/'}, 'footer':{'title':'','description':'','email':'','show_nav':True}, 'nav':[], + 'mobile_tabs':{'enabled':False,'items':[]}, 'tokens':{'font':'system','heading_scale':1.0,'radius':12,'section_spacing':72, 'container_width':1200,'button_style':'rounded','header_style':'standard'}, 'responsive':{'tablet_gap':64,'mobile_gap':40,'mobile_hide_announcement':True, @@ -82,6 +83,22 @@ def _nav(rows,depth=0,counter=None): 'children':_nav(children,depth+1,counter) if depth<2 else []}) return result +def _mobile_tab_url(value): + """Allow site-internal routes plus safe, explicit user-facing contact links.""" + from urllib.parse import urlsplit + if not isinstance(value,str) or not value or len(value)>350 or any(c in value for c in ('<','>','"',"'",'\\','\n','\r','\t')): + raise HTTPException(400,'底部导航网址不安全') + if value.startswith('/') and not value.startswith('//'): + return _url(value) + if re.fullmatch(r'tel:\+?[0-9()\- ]{5,30}',value): + return value + if re.fullmatch(r'mailto:[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}',value): + return value + parsed=urlsplit(value) + if parsed.scheme=='https' and parsed.hostname and not parsed.username and not parsed.password and not any(c.isspace() for c in value): + return value + raise HTTPException(400,'仅支持站内路径、HTTPS、电话或邮箱链接') + def validate(raw): if not isinstance(raw,dict) or set(raw)-set(DEFAULTS):raise HTTPException(400,'未知的全站设计设置') normalized={} @@ -117,6 +134,33 @@ def validate(raw): if type(v) not in (float,int) or not lo<=v<=hi:raise HTTPException(400,'设计变量超出范围: '+field) normalized['tokens']=tokens normalized['nav']=_nav(raw.get('nav',[])) + bar=raw.get('mobile_tabs',{}) + if not isinstance(bar,dict) or set(bar)-{'enabled','items'}: + raise HTTPException(400,'底部导航配置格式不正确') + enabled=bar.get('enabled',False) + items=bar.get('items',[]) + if type(enabled) is not bool or not isinstance(items,list) or len(items)>5: + raise HTTPException(400,'底部导航仅支持 0 至 5 项') + allowed_icons={'home','grid','products','news','contact','phone','info','search','menu','star'} + result=[] + for item in items: + if not isinstance(item,dict) or set(item)-{'title','route','icon','action'}: + raise HTTPException(400,'底部导航项目格式不正确') + title=item.get('title') + icon=item.get('icon','grid') + action=item.get('action','link') + if not isinstance(title,str) or not 1<=len(title.strip())<=12: + raise HTTPException(400,'底部导航标题须为 1 至 12 字') + if icon not in allowed_icons or action not in ('link','menu'): + raise HTTPException(400,'底部导航图标或操作不受支持') + if action=='menu': + route='/' + else: + route=_mobile_tab_url(item.get('route','/')) + result.append({'title':title.strip(),'icon':icon,'route':route,'action':action}) + if enabled and not result: + raise HTTPException(400,'启用底部导航时至少添加一项；不需要可直接关闭') + normalized['mobile_tabs']={'enabled':enabled,'items':result} if len(json.dumps(normalized,ensure_ascii=False))>35_000:raise HTTPException(400,'全站设计过大') return normalized diff --git a/app/sqlite_pg_transfer.py b/app/sqlite_pg_transfer.py new file mode 100644 index 0000000..4b9b3d9 --- /dev/null +++ b/app/sqlite_pg_transfer.py @@ -0,0 +1,154 @@ +"""Offline, verifiable SQLite -> EMPTY PostgreSQL database migration (V8.18). + +Data only. Shared files (/data/media, builds, archives, legacy) must be moved +separately, under the same maintenance window, before site activation. + +This never clears target rows. PostgreSQL target schema is bootstrapped by SiteForge +before copying; application must be fully stopped in both installations. +""" +from __future__ import annotations +import hashlib +import json +import re +import sqlite3 +import tempfile +from pathlib import Path + +from .pg_disaster_recovery import RecoveryError + +IDENT=re.compile(r'^[a-z_][a-z0-9_]*$',re.I) +LEDGER='schema_migrations' + + +def quote(name): + if not IDENT.fullmatch(name): + raise RecoveryError('Unsupported table or column identifier') + return '"'+name+'"' + + +def plan_tables(connection: sqlite3.Connection) -> list[str]: + tables=[r[0] for r in connection.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")] + if 'sites' not in tables:raise RecoveryError('SQLite source has no sites table') + graph={t:set() for t in tables} + for table in tables: + for dep in connection.execute(f'PRAGMA foreign_key_list({quote(table)})'): + parent=dep[2] + if parent != table: + if parent not in graph:raise RecoveryError('Missing FK table '+parent) + graph[table].add(parent) + result=[] + while graph: + ready=sorted(name for name,deps in graph.items() if not deps) + if not ready:raise RecoveryError('Circular foreign keys require separate migration') + for name in ready: + result.append(name);graph.pop(name) + for refs in graph.values():refs.difference_update(ready) + return result + + +def columns(conn: sqlite3.Connection, table: str) -> list[str]: + return [row[1] for row in conn.execute('PRAGMA table_info('+quote(table)+')')] + + +def _hash_rows(rows) -> str: + """Order independent deterministic content hash, for migration verification.""" + canonical=[] + for row in rows: + canonical.append(json.dumps(list(row),sort_keys=True,ensure_ascii=False, + separators=(',',':'),default=str)) + digest=hashlib.sha256() + for line in sorted(canonical):digest.update((line+'\n').encode('utf-8')) + return digest.hexdigest() + + +def bootstrap_target(): + # Same ordered migrations as FastAPI lifespan and PostgreSQL bootstrap smoke. + from . import (db,enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86,site_design_v87,multilingual) + if not db.POSTGRES:raise RecoveryError('SITEFORGE_DATABASE_URL must point at PostgreSQL') + db.init() + for module in (enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86,site_design_v87,multilingual): + module.setup() + + +def check_destination_empty(pg, source: sqlite3.Connection, tables: list[str]) -> None: + for table in tables: + name=quote(table) + # Check source column coverage. Unknown source columns mean unsafe truncation. + target_cols={r['column_name'] for r in pg.execute( + 'SELECT column_name FROM information_schema.columns WHERE table_schema=current_schema() AND table_name=?', + (table,)).fetchall()} + src_cols=set(columns(source,table)) + if not src_cols or not src_cols.issubset(target_cols): + raise RecoveryError('PostgreSQL schema mismatch at table '+table) + if table == LEDGER: + # Destination is bootstrapped and has its own required migration ledger. + old=source.execute('SELECT version,checksum FROM schema_migrations').fetchall() + for version,checksum in old: + row=pg.execute('SELECT checksum FROM schema_migrations WHERE version=?',(version,)).fetchone() + if not row or row[0]!=checksum: + raise RecoveryError('Migration ledger mismatch: '+version) + continue + count=pg.execute(f'SELECT COUNT(*) FROM {name}').fetchone()[0] + if count: + raise RecoveryError('Destination is not empty: '+table) + + +def transfer_rows(pg, source, tables, batch=250) -> dict: + if not (1<=batch<=500):raise RecoveryError('Batch size must be between 1 and 500') + result={} + for table in tables: + if table==LEDGER:continue + cols=columns(source,table) + select=f'SELECT {", ".join(map(quote,cols))} FROM {quote(table)}' + original=source.execute(select) + n=0 + # Keep below PostgreSQL's 65,535 bind-parameter limit. + limit=min(batch,max(1,65000//len(cols))) + while True: + rows=original.fetchmany(limit) + if not rows:break + placeholders='('+','.join('?' for _ in cols)+')' + insert=f'INSERT INTO {quote(table)} ({", ".join(map(quote,cols))}) VALUES '+','.join([placeholders]*len(rows)) + pg.execute(insert,[value for row in rows for value in row]) + n+=len(rows) + source_hash=_hash_rows(source.execute(select)) + destination_rows=pg.execute(select).fetchall() + destination_hash=_hash_rows([[row[col] for col in cols] for row in destination_rows]) + if n!=len(destination_rows) or source_hash!=destination_hash: + raise RecoveryError('Data validation failed at table '+table) + result[table]={'rows':n,'sha256':source_hash} + return result + + +def migrate(source_path: str | Path, *, confirmed_offline=False, batch=250, + connect=None, bootstrap=True) -> dict: + """Caller supplies PG connection in tests; production uses app.db.connect.""" + if not confirmed_offline:raise RecoveryError('Stop all services and use --confirmed-offline') + src=Path(source_path).resolve() + if not src.is_file():raise RecoveryError('SQLite source file not found') + from . import db + if connect is None and not db.POSTGRES: + raise RecoveryError('PostgreSQL URL is required') + # Capture an immutable consistent snapshot; does not create or change source DB. + with tempfile.TemporaryDirectory(prefix='siteforge-sqlite-pg-') as temp: + snapshot=Path(temp)/'snapshot.sqlite3' + with sqlite3.connect(src.as_uri()+'?mode=ro',uri=True) as old, sqlite3.connect(snapshot) as new: + old.backup(new) + with sqlite3.connect(snapshot.as_uri()+'?mode=ro',uri=True) as sqlite: + if sqlite.execute('PRAGMA integrity_check').fetchone()[0]!='ok': + raise RecoveryError('SQLite integrity check failed') + ordered=plan_tables(sqlite) + if bootstrap:bootstrap_target() + connect_fn=connect or db.connect + # All data inserts and verification occur inside ONE PG transaction. + with connect_fn() as target: + check_destination_empty(target,sqlite,ordered) + counts=transfer_rows(target,sqlite,ordered,batch) + return {'source':'sqlite', 'destination':'postgresql', + 'tables':len(counts),'records':sum(x['rows'] for x in counts.values()), + 'verified':True,'details':counts, + 'note':'Database only. Transfer shared files before traffic cutover.'} diff --git a/app/static/commercial.css b/app/static/commercial.css index 0e4698a..353bee4 100644 --- a/app/static/commercial.css +++ b/app/static/commercial.css @@ -31,3 +31,54 @@ a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,te .pro-pages-nav a{padding:.7rem 1.1rem;border:1px solid currentColor;border-radius:.4rem;text-decoration:none} .pro-pages-nav a:focus-visible{outline:3px solid var(--accent,#2563eb);outline-offset:3px} .pro-pages-nav span{font-size:.875rem} + +/* P6 international sites: small, keyboard-operable language switch. */ +.sf-language-switch{display:inline-flex;gap:6px;align-items:center;flex-wrap:wrap;margin:8px 12px;padding:4px;border:1px solid rgba(120,130,145,.22);border-radius:10px;background:rgba(255,255,255,.08)} +.sf-language-switch a{font:inherit;font-size:12px;line-height:1.5;padding:4px 7px;border-radius:6px;color:inherit;text-decoration:none} +.sf-language-switch a[aria-current="page"]{font-weight:700;text-decoration:underline;text-underline-offset:3px} +.sf-language-switch a:focus-visible{outline:2px solid #2563eb;outline-offset:3px} +@media(max-width:640px){.sf-language-switch{margin:6px 0;width:auto}} + +/* V8.21.3 — Four-theme unified mobile off-canvas navigation & optional tab bar. + Desktop remains unchanged. Phone / tablet use one accessible drawer. */ +.sf-mobile-tabs{display:none!important} +.sf-drawer-header,.sf-mobile-drawer-backdrop,.sf-drawer-extra{display:none} +@media(max-width:1024px){ + .pro-head-inner{flex-wrap:nowrap!important;gap:12px!important} + .pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto!important;flex:0 0 44px;min-width:44px;min-height:44px;position:relative;z-index:3} + .pro-catalog-toggle{display:none!important} + .pro-navigation,.pro-navigation.is-open{display:flex!important;position:fixed!important;inset:0 0 0 auto!important;width:min(88vw,360px)!important;height:100dvh!important;height:100vh;max-height:100dvh!important;flex:unset!important;flex-direction:column!important;align-items:stretch!important;order:unset!important;margin:0!important;padding:0 0 calc(20px + env(safe-area-inset-bottom,0px))!important;overflow-x:hidden;overflow-y:auto!important;background:var(--pro-background,#fff)!important;color:var(--pro-text,#19283c)!important;border:0!important;border-left:1px solid var(--pro-border,#ddd)!important;box-shadow:-15px 0 45px #0002!important;z-index:1201!important;transform:translateX(105%);visibility:hidden;pointer-events:none;transition:transform .24s ease,visibility .24s ease!important;overscroll-behavior:contain} + .pro-navigation.is-open{transform:translateX(0);visibility:visible;pointer-events:auto} + .sf-drawer-header{display:flex!important;align-items:center;justify-content:space-between;gap:12px;padding:20px 18px;border-bottom:1px solid var(--pro-border,#dde3e9);font-size:17px;font-weight:750;position:sticky;top:0;background:var(--pro-background,#fff);z-index:2} + .sf-drawer-close{min-width:44px;min-height:44px;border:1px solid var(--pro-border,#dde3e9);color:inherit;background:transparent;border-radius:10px;font-size:24px;cursor:pointer} + .sf-mobile-drawer-backdrop{display:block;position:fixed;inset:0;z-index:1200;background:#0b1b31a3;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .24s ease,visibility .24s ease} + .sf-mobile-drawer-backdrop.is-open{opacity:1;visibility:visible;pointer-events:auto} + body.sf-drawer-open{overflow:hidden!important} + .pro-navigation>a,.pro-navigation .pro-nav-group>a,.pro-navigation .sf-drawer-extra>a{display:flex;align-items:center;min-height:50px;padding:13px 20px!important;font-size:15px!important;color:inherit!important;white-space:normal;border-bottom:1px solid var(--pro-border,#dde3e9)!important;text-decoration:none!important} + .pro-navigation .pro-nav-group{display:flex;position:relative;flex-wrap:wrap!important;width:100%;gap:0;align-items:center;justify-content:space-between} + .pro-navigation .pro-nav-group>a{flex:1;min-width:0} + .pro-navigation .pro-nav-disclose{margin-right:12px;min-width:44px;min-height:44px;border-radius:9px;background:var(--pro-surface,#f4f6f8)} + .pro-navigation .pro-nav-children{position:static!important;width:100%!important;max-width:100%!important;box-shadow:none!important;border-left:3px solid var(--pro-accent,#e77730);border-radius:0!important;margin:0 0 8px 14px!important;flex-basis:calc(100% - 14px)!important;background:var(--pro-surface,#f6f8fa)} + .pro-navigation .pro-nav-children a{padding:12px 16px!important;font-size:14px!important;color:inherit!important;min-height:44px} + .sf-drawer-extra{display:block;padding:12px 0 5px}.sf-drawer-extra strong{display:block;font-size:12px;letter-spacing:.06em;padding:12px 20px;opacity:.65}.sf-drawer-extra a{font-size:14px!important} + .sf-drawer-close:focus-visible,.pro-mobile-toggle:focus-visible,.pro-nav-disclose:focus-visible,.sf-mobile-tab:focus-visible{outline:3px solid var(--pro-accent,#ff8200);outline-offset:2px} +} +@media(max-width:767px){ + .pro-header-cta{display:none!important} + .pro-head-inner .pro-logo{min-width:0;max-width:calc(100% - 65px)} + .pro-logo-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .pro-home-hero .pro-home-grid{min-height:0!important} + .pro-home-hero .pro-hero-art{min-height:230px} + .pro-card,.pro-card-cover,.pro-product-media{max-width:100%;min-width:0} + .pro-rich img,.pro-content img,.sf-canvas img{max-width:100%;height:auto} + .pro-rich table{max-width:100%;overflow:auto} + .pro-grid,.pro-footer-top{min-width:0} + .sf-mobile-tabs{display:grid!important;position:fixed;z-index:1100;bottom:0;left:0;right:0;grid-template-columns:repeat(var(--sf-mobile-tab-count,4),minmax(0,1fr));align-items:stretch;padding:5px 6px calc(5px + env(safe-area-inset-bottom,0px));min-height:63px;background:var(--pro-background,#fff);color:var(--pro-text,#263446);border-top:1px solid var(--pro-border,#dfe4eb);box-shadow:0 -6px 24px #13223914} + .sf-mobile-tab{appearance:none;border:0!important;background:transparent!important;color:inherit!important;text-decoration:none!important;padding:6px 2px;min-height:50px;min-width:0;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:2px;border-radius:9px;cursor:pointer;font-family:inherit} + .sf-tab-icon{font-size:23px;line-height:1.15;font-weight:500} + .sf-tab-label{font-size:11px;font-weight:600;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .sf-mobile-tab[aria-current=page]{color:var(--pro-accent,#e47730)!important;background:var(--pro-surface,#f5f6f8)!important} + body:has(> .sf-mobile-tabs){padding-bottom:calc(76px + env(safe-area-inset-bottom,0px))!important} +} +@media(min-width:768px){.sf-mobile-tabs{display:none!important}} +@media(prefers-reduced-motion:reduce){.pro-navigation,.sf-mobile-drawer-backdrop{transition:none!important}} diff --git a/app/static/editor-helpers.js b/app/static/editor-helpers.js new file mode 100644 index 0000000..f0db99e --- /dev/null +++ b/app/static/editor-helpers.js @@ -0,0 +1,39 @@ +/* Safe, deterministic editor operations. Exported for Node regression tests. */ +(function (root, factory) { + const api=factory(); + if(typeof module==='object' && module.exports)module.exports=api; + root.SiteForgeEditorHelpers=api; +})(typeof window!=='undefined'?window:globalThis, function(){ + 'use strict'; + const deepCopy=value=>JSON.parse(JSON.stringify(value)); + function reorder(items, from, to){ + if(!Array.isArray(items)||!Number.isInteger(from)||!Number.isInteger(to)||from<0||to<0||from>=items.length||to>=items.length)return null; + if(from===to)return items.slice(); + const next=items.slice();next.splice(to,0,next.splice(from,1)[0]);return next; + } + function duplicate(block, idFactory){ + if(!block || typeof idFactory!=='function')throw Error('无效的区块'); + const item=deepCopy(block); + const rewrite=node=>{ + node.id=idFactory(); + if(node.type==='layout')for(const col of node.columns||[])for(const child of col.blocks||[])rewrite(child); + }; + rewrite(item);return item; + } + function filterBlocks(blocks, term, names={}){ + const query=String(term||'').trim().toLocaleLowerCase(); + if(!query)return blocks.map((block,index)=>({block,index})); + return blocks.flatMap((block,index)=>{ + const description=[block.title,block.subtitle,block.type,names[block.type]?.name] + .concat(block.type==='layout'?(block.columns||[]).flatMap(c=>(c.blocks||[]).map(b=>b.title||b.type)):[]) + .filter(x=>typeof x==='string').join(' ').toLocaleLowerCase(); + return description.includes(query)?[{block,index}]:[]; + }); + } + function historyState(snapshots,cursor){return {canUndo:cursor>0,canRedo:cursor>=0&&cursora{background:#252e3c;border-radius:10px;color:#ff9959} +.top-center{margin:auto;background:#edf1f6} +.icon-btn.on{color:#b95722} +.ui-btn.primary{background:#dc6b2b;border-color:#dc6b2b} +.ui-btn:focus-visible,.icon-btn:focus-visible,.block-row:focus-visible,.palette button:focus-visible,.row-actions button:focus-visible,.inspector-nav button:focus-visible{outline:2px solid var(--studio-focus);outline-offset:2px} +.ui-btn:disabled,.row-actions button:disabled{opacity:.3;cursor:not-allowed} +.pane-switcher{display:flex;gap:3px} +.pane-switcher .ui-btn{padding:8px 10px} +.studio-body{grid-template-columns:minmax(270px,290px) minmax(0,1fr) minmax(320px,350px)} +.left-pane,.right-pane{background:#fff} +.pane-heading{padding:22px 18px 14px} +.pane-heading h3{font-size:16px;letter-spacing:0} +.section-label{display:flex;justify-content:space-between;align-items:center;padding:14px 19px 9px;color:#56677b;font-size:11px;letter-spacing:0} +.section-caption{font-size:10px;color:#a0abbb;font-weight:500} +.structure-filter{margin:4px 13px 10px;display:flex;align-items:center;border:1px solid #dfe6ee;background:#f7f9fc;border-radius:9px;overflow:hidden;min-height:38px} +.structure-filter:focus-within{border-color:var(--studio-focus);box-shadow:0 0 0 3px #f39a4923} +.structure-filter input{background:transparent;border:0;outline:0;min-width:0;flex:1;padding:9px 12px;font-size:12px;color:#25364e} +.structure-filter button{border:0;background:transparent;font-size:19px;color:#8796a7;width:34px} +.structure-hint{color:#8190a3;font-size:10px;padding:8px 19px 17px;line-height:1.7} +.block-list{padding:0 11px;min-height:60px} +.block-row{background:#fff;box-shadow:0 2px 10px #334b6207;padding:9px 8px;margin-bottom:6px;gap:7px;border-color:#e9edf2;transition:border-color .15s,background .15s} +.block-row:hover{border-color:#c4cedc;background:#fafbfd} +.block-row.selected{background:#fff7f1;border-color:#f19b59;box-shadow:0 0 0 1px #f8e3d5} +.block-row.is-hidden{opacity:.55} +.block-icon{width:29px;height:29px;color:#d67b35;background:#fff8f2;flex-shrink:0} +.block-copy strong{font-size:12px;color:#303e51} +.block-copy small{font-size:10px;color:#7e90a5} +.drag-handle{font-size:14px} +.row-actions{display:flex;gap:0;flex-shrink:0} +.row-actions button{font-size:12px;min-width:18px;padding:4px 2px;border-radius:5px} +.row-actions button:hover:not(:disabled){background:#fff0e4;color:#c96728} +.block-list .no-selection{padding:15px;margin:0 2px 10px} +.palette{grid-template-columns:repeat(2,minmax(0,1fr));padding-inline:13px} +.palette button{padding:10px 9px;border-style:solid} +.palette button:hover{border-color:#e8aa76;background:#fff8f3} +.palette button span{color:#d77936} +.preview-workspace{background:#eff2f6} +.preview-head{padding:0 16px;gap:9px} +.preview-note{max-width:260px;line-height:1.3;text-align:right} +.live-dot{background:#3aa688} +.live-dot.loading{background:#db983a;animation:studio-pulse 1.25s infinite} +.live-dot.error{background:#cb4e4e} +@keyframes studio-pulse{50%{opacity:.3;box-shadow:0 0 0 7px #efab4626}} +.stage{padding:22px 15px} +.device-frame{border-radius:8px;box-shadow:var(--studio-shadow);overflow:hidden;min-height:300px} +.device-frame.tablet,.device-frame.phone{max-width:calc(100% - 4px)} +iframe{min-height:590px;height:calc(100vh - 224px)} +.stage-footer{min-height:35px;display:flex;align-items:center;justify-content:space-between;gap:8px;padding:6px 19px;font-size:10px;color:#8b9bad;border-top:1px solid #e1e7ee} +.inspector-nav{display:grid;grid-template-columns:repeat(3,1fr);gap:5px;padding:4px;margin:0 16px 17px;border-radius:9px;background:#f1f4f8} +.inspector-nav button{background:none;border:0;border-radius:6px;padding:10px 5px;font-size:12px;color:#78869a;font-weight:650} +.inspector-nav button[aria-selected=true]{background:white;box-shadow:0 1px 5px #233d5f12;color:#b95c2b} +.inspector{padding:0 19px} +.inspector [data-inspector-section][hidden]{display:none!important} +.inspector-title{margin:0 0 16px} +.inspector-title h3{font-size:14px} +.right-foot{background:#faf8f5;border-color:#f0e6d7;margin-top:auto} +.studio .section-label,.studio .pane-heading h3{user-select:none} +.sr-only{position:absolute!important;width:1px!important;height:1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important} +@media(max-width:1400px){.studio-body{grid-template-columns:255px minmax(0,1fr) 310px}.studio-top{gap:6px}.studio-top>.ui-btn{padding:9px 10px}} +@media(max-width:1130px){.studio-top>.ui-btn.ghost:not(#studioUndo):not(#studioRedo){display:none}.studio-body{grid-template-columns:245px minmax(0,1fr) 295px}.file-name{max-width:150px}.pane-switcher{display:flex}} +@media(max-width:950px){.studio-body{grid-template-columns:230px minmax(0,1fr)}.right-pane{transform:translateX(105%);transition:transform .2s;display:flex!important;z-index:7;top:72px;width:min(340px,92vw)}body.show-inspector .right-pane{transform:translateX(0)}.preview-note{display:none}.studio-top>.ui-btn.ghost{display:none}} +@media(max-width:650px){.studio{min-height:480px}.studio-body{grid-template-columns:minmax(0,1fr)}.left-pane{display:flex!important;position:fixed;z-index:7;top:72px;bottom:0;left:0;width:min(315px,88vw);transform:translateX(-106%);transition:transform .2s;box-shadow:6px 0 20px #17283f12}body.show-structure .left-pane{transform:translateX(0)}.right-pane{display:flex!important}.studio-top{padding-inline:8px}.pane-switcher .ui-btn{padding:8px}.studio-top .brand{display:none}.top-center{margin-inline:auto}.studio-top .ui-btn.primary{padding:9px 10px}.preview-head{height:42px;min-height:42px;padding:0 9px}.stage{padding:10px 6px}.device-frame.phone,.device-frame.tablet{max-width:100%}.stage-footer{padding:8px 10px}.studio-top .save-status{display:none}} + +@media(max-width:950px){.studio-top>#saveDraftButton.ui-btn.ghost{display:inline-flex!important;align-items:center;padding:9px 10px;color:#c5652d;background:#fff6ed;border-color:#eec49e}} +@media(max-width:430px){.studio-top #saveDraftButton{font-size:11px}.studio-top .ui-btn.primary{font-size:11px}.icon-btn{padding:6px 7px}} + +.studio-actions{position:relative;flex-shrink:0}.studio-actions summary{display:flex;gap:6px;align-items:center;list-style:none;border:1px solid #e5eaf0;border-radius:8px;background:#fff;color:#394a60;padding:10px 13px;font-weight:650;font-size:12px;cursor:pointer;user-select:none}.studio-actions summary::-webkit-details-marker{display:none}.studio-actions[open] summary{border-color:#dbaa89;background:#fff8f1}.studio-actions-menu{position:absolute;right:0;top:calc(100% + 8px);display:grid;gap:5px;min-width:205px;z-index:12;padding:9px;border:1px solid #e2e7ed;border-radius:12px;background:#fff;box-shadow:0 15px 42px #283b5328}.studio-actions-menu .ui-btn{width:100%;text-align:left;border:0;padding:11px 12px;background:transparent}.studio-actions-menu .ui-btn:hover{background:#f5f7fa}.studio-actions-menu .ui-btn.ghost{display:block!important}@media(max-width:650px){.studio-actions summary{font-size:11px;padding:9px 7px}.studio-actions-menu{right:-15px;min-width:185px}} +/* V8.21.2 Easy Studio — task-first UX; no schema or API changes */ +.sf-easy-top{height:70px;min-height:70px;padding:0 20px;gap:12px;z-index:15} +.sf-easy-top .brand{min-width:138px}.sf-easy-top .brand small{font-size:10px;color:#a1aab7}.sf-easy-file{display:flex;flex-direction:column;gap:3px;min-width:130px;max-width:210px}.sf-easy-file small{color:#8b98a9;font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sf-easy-file strong{font-size:14px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sf-easy-device{margin-left:auto;margin-right:auto;flex:0 0 auto;display:flex}.sf-easy-device .icon-btn{font-size:12px;padding:8px 12px;font-weight:700}.sf-easy-save-status{padding:7px 10px;max-width:120px;overflow:hidden;text-overflow:ellipsis;background:#f3f6f9;border-radius:7px}.sf-easy-save-status.dirty{color:#b96d21;background:#fff5e8}.sf-save-btn{border-color:#e7a36d!important;color:#b65d23!important;background:#fffaf5!important;padding-inline:15px}.sf-publish-btn{padding-inline:19px;background:#df752f!important}.sf-easy-top .studio-actions{margin:0}.sf-easy-top .studio-actions summary{padding:10px 11px}.sf-easy-top .studio-actions-menu{min-width:195px;max-height:80vh;overflow-y:auto}.sf-easy-top .studio-actions-menu .ui-btn{font-size:12px} +.sf-steps{display:flex;align-items:center;gap:13px;padding:10px 22px;background:#fffaf6;border-bottom:1px solid #f2e3d7;color:#7d8290;min-height:45px;font-size:12px}.sf-steps-label{color:#b2683a;font-weight:800;flex-shrink:0}.sf-step{white-space:nowrap;font-weight:640;border-radius:8px;padding:5px 8px}.sf-step.active{background:#fce7d7;color:#b85b23}.sf-step-separator{color:#d6ad90}.sf-guide-link{margin-left:auto;border:0;background:none;color:#bc6529;font-weight:750;font-size:12px;white-space:nowrap;padding:5px 8px;text-decoration:underline;text-underline-offset:3px} +.studio-body{min-height:0;grid-template-columns:270px minmax(0,1fr) 320px}.left-pane,.right-pane{min-height:0}.left-pane .pane-heading{padding-bottom:10px}.left-pane .pane-heading h3,.right-pane .pane-heading h3{font-size:17px}.sf-page-picker{margin-bottom:10px!important}.sf-page-picker label{color:#5f7184;font-size:11px}.sf-page-picker select{font-size:12px}.sf-add-area{padding:2px 15px 15px}.sf-add-button{display:block;width:100%;border:1px solid #dc732f;background:#e47b38;color:#fff;border-radius:10px;padding:14px 12px;font-size:14px;font-weight:800;box-shadow:0 4px 11px #dc732f25;text-align:center;cursor:pointer}.sf-add-button:hover{background:#ce6427}.sf-add-area p{margin:9px 1px 0;color:#8a97a8;font-size:11px;line-height:1.6}.sf-library-panel{margin:0 13px 12px;border:1px solid #f2cfb4;background:#fffaf6;border-radius:12px;padding:9px 0;box-shadow:0 7px 15px #b55e1f12}.sf-library-panel[hidden]{display:none!important}.sf-panel-caption{display:flex;justify-content:space-between;gap:5px;align-items:center;padding:4px 12px 10px;font-size:11px;font-weight:700;color:#895b3c}.sf-panel-caption button{border:none;background:transparent;color:#b86327;font-size:11px}.sf-library-panel .palette{grid-template-columns:repeat(2,minmax(0,1fr));padding:2px 9px 12px;gap:7px}.sf-library-panel .palette button{min-height:42px;background:#fff;border-style:solid;font-size:11px}.sf-subsection{margin:0 9px 6px;padding-top:8px;border-top:1px solid #f2ddc7}.sf-subsection>summary{padding:7px 5px;cursor:pointer;color:#85624b;font-size:11px;font-weight:750}.sf-subsection .palette{padding:8px 0;grid-template-columns:1fr}.left-pane .section-label{padding-top:13px;font-size:11px;color:#56677b}.block-list{padding:0 12px;min-height:75px}.block-row{min-height:54px}.block-copy strong{font-size:12px}.row-actions button{min-width:19px}.sf-advanced{margin:6px 13px 18px;border:1px solid #e6eaf0;border-radius:10px;background:#fafbfc}.sf-advanced summary{display:flex;align-items:center;justify-content:space-between;gap:5px;padding:13px;cursor:pointer;font-weight:750;font-size:12px;color:#67758b}.sf-advanced summary::after{content:'⌄';font-size:15px;margin-left:auto;color:#99a7b9}.sf-advanced summary span{font-size:10px;font-weight:400;color:#9aa6b5}.sf-advanced[open]{background:#fff}.sf-advanced[open] summary{border-bottom:1px solid #edf0f4}.sf-advanced .field{margin:13px}.sf-advanced-buttons{display:grid;gap:7px;padding:0 13px 10px}.sf-advanced-buttons button{white-space:normal;text-align:left}.sf-advanced-note{font-size:10px;color:#9aa6b5;line-height:1.7;margin:4px 13px 13px} +.structure-hint{padding-bottom:12px}.preview-workspace{min-width:0}.preview-head{min-height:48px;height:48px}.preview-note{font-size:10px}.right-pane .pane-heading{padding-bottom:15px}.right-pane .overline{letter-spacing:.4px;color:#d67832;font-size:10px}.right-pane .inspector-nav{margin-top:0}.sf-advanced-foot{display:block;padding:0;margin:22px 15px;border:1px solid #eceff2;background:#fafbfc}.sf-advanced-foot summary{padding:13px 15px;cursor:pointer;font-size:11px;font-weight:750;color:#617084}.sf-advanced-foot p{margin:0 15px 14px}.right-pane .no-selection b{display:block;color:#53667d;font-size:14px}.right-pane .no-selection p{font-size:12px;line-height:1.7}.right-pane .no-selection .ui-btn{margin-top:8px}.right-pane .prop label{font-size:12px;color:#5c6a7f}.right-pane .prop input,.right-pane .prop textarea,.right-pane .prop select{font-size:13px;padding:11px 12px}.sf-help-dialog{border:1px solid #dfe4eb;border-radius:18px;width:min(535px,94vw);padding:26px;box-shadow:0 25px 100px #23324835}.sf-help-dialog::backdrop{background:#1c2c405a}.sf-help-head{display:flex;align-items:start;justify-content:space-between;gap:12px}.sf-help-head h2{margin:4px 0 15px;font-size:23px;color:#28364a}.sf-help-steps{padding-left:29px;line-height:1.65}.sf-help-steps li{margin:11px 0 17px;padding-left:5px;font-size:13px}.sf-help-steps b{font-size:15px;color:#c8682a}.sf-help-steps p{margin:5px 0;color:#6a7a8b}.sf-guide-note{border-radius:10px;padding:12px 15px;background:#f6f7f9;color:#718091;font-size:12px;line-height:1.6}.sf-guide-done{width:100%;margin-top:18px;font-size:14px} +@media(max-width:1330px){.studio-body{grid-template-columns:245px minmax(0,1fr) 305px}.sf-easy-top{gap:8px;padding:0 12px}.sf-easy-top .brand{min-width:100px}.sf-easy-file{max-width:148px}.sf-easy-device .icon-btn{padding:8px}} +@media(max-width:1060px){.studio-body{grid-template-columns:230px minmax(0,1fr)}.right-pane{position:fixed;right:0;top:115px;bottom:0;width:min(338px,92vw);display:flex!important;transform:translateX(106%);z-index:11;box-shadow:-10px 0 25px #1c2c4025}body.show-inspector .right-pane{transform:translateX(0)}.sf-easy-top .brand small,.sf-easy-save-status{display:none}.sf-easy-file{max-width:120px}.studio-top .ui-btn.ghost.sf-save-btn{display:inline-flex!important}.sf-steps{font-size:11px;gap:7px}} +@media(max-width:720px){.sf-steps{min-height:39px;padding:5px 10px;gap:5px}.sf-step-separator,.sf-step,.sf-steps-label{display:none}.sf-steps::before{content:'① 选内容 → ② 改文字与样式 → ③ 保存发布';font-weight:700;font-size:11px;color:#a4653b}.sf-guide-link{font-size:11px}.studio-body{grid-template-columns:minmax(0,1fr)}.left-pane{position:fixed;top:109px;bottom:0;left:0;width:min(315px,92vw);z-index:11;display:flex!important;transform:translateX(-106%);box-shadow:10px 0 25px #1c2c4020}body.show-structure .left-pane{transform:translateX(0)}.right-pane{top:109px}.sf-easy-top{height:70px;min-height:70px;padding-inline:8px}.sf-easy-top .brand,.sf-easy-file{display:none}.sf-easy-device{margin-left:0;margin-right:auto}.sf-easy-device .icon-btn{font-size:11px;padding:7px}.sf-save-btn,.sf-publish-btn{font-size:11px;padding:9px!important}.sf-easy-top .studio-actions summary{padding:9px 8px;font-size:11px}.sf-easy-top .studio-actions-menu{right:0}.pane-switcher{display:none}.stage{padding:9px 6px}.device-frame.phone,.device-frame.tablet{max-width:100%}} +@media(max-width:395px){.sf-easy-device .icon-btn{padding:6px;font-size:10px}.sf-guide-link{font-size:10px}.sf-save-btn{padding:8px 6px!important}.sf-publish-btn{padding:8px 6px!important}.sf-steps::before{content:'选区块 → 修改 → 保存发布';font-size:10px}} +/* Responsive panel toggle is always available on narrow screens. */ +.sf-easy-top .sf-pane-controls{display:none;gap:5px} +@media(max-width:1060px){.sf-easy-top .sf-pane-controls{display:flex}.sf-easy-top .sf-pane-controls button{padding:7px 9px;font-size:11px;border:1px solid #e2e6ed;background:white;border-radius:8px}} + +/* Accessible repeated-item forms for galleries, carousels, FAQs and features */ +.sf-array-editor{display:grid;gap:10px}.sf-array-hint{font-size:11px;line-height:1.6;color:#8391a3;margin:0 0 4px}.sf-array-card{border:1px solid #e5eaf0;background:#fafbfd;padding:11px;border-radius:10px}.sf-array-card-head{display:flex;align-items:center;justify-content:space-between;gap:7px;margin-bottom:12px}.sf-array-card-head b{font-size:12px;color:#586a7f}.sf-array-card-head div{display:flex;gap:3px}.sf-array-card-head button{border:1px solid #e2e7ed;border-radius:5px;color:#6c7a8e;background:white;padding:4px 7px;font-size:11px}.sf-array-card-head button:last-child{color:#b95d62}.sf-array-card-head button:disabled{opacity:.3;cursor:not-allowed}.sf-array-field{display:block!important;margin:10px 0!important;font-size:11px!important;font-weight:650!important}.sf-array-field input,.sf-array-field textarea{display:block;width:100%;margin-top:5px;background:white}.sf-array-field textarea{min-height:65px}.sf-array-add{border:1px dashed #e5a77c;border-radius:9px;background:#fff8f2;color:#be672a;padding:13px 9px;font-size:12px;font-weight:800} diff --git a/app/static/editor.js b/app/static/editor.js index 4d8c301..6e45c85 100644 --- a/app/static/editor.js +++ b/app/static/editor.js @@ -8,31 +8,67 @@ const api=async(p,opt={})=>{if(!['GET','HEAD','OPTIONS'].includes((opt.method||' const req=(method,data)=>({method,headers:{'Content-Type':'application/json'},body:JSON.stringify(data)}); const toast=(s,err=false)=>{const t=$('#toast');t.textContent=s;t.style.background=err?'#a23c44':'#1c3555';t.classList.add('show');setTimeout(()=>t.classList.remove('show'),3400)}; const activePage=()=>pages.find(e=>e.id===pageId); +const editorTools=window.SiteForgeEditorHelpers; +let libraryOpen=false; +let inspectorTab='content',blockSearch='',previewRequest=0,previewController=null,savePromise=null,lastContinuousEdit=0; + let snapshots=[],snapshotCursor=-1,draggedChild=null,draftRevision=0,siteDesign=null,siteDesignRevision=0,siteDesignPreview=null; function recordSnapshot(){const current=JSON.stringify({blocks,kind,layoutMode});if(snapshotCursor>=0 && snapshots[snapshotCursor]===current)return;snapshots=snapshots.slice(0,snapshotCursor+1);snapshots.push(current);if(snapshots.length>75)snapshots.shift();snapshotCursor=snapshots.length-1} -function restoreSnapshot(index){if(index<0||index>=snapshots.length)return;snapshotCursor=index;const state=JSON.parse(snapshots[index]);blocks=state.blocks;kind=state.kind;layoutMode=state.layoutMode;selected=Math.min(selected,blocks.length-1);$('#pageTemplate').value=kind;$('#layoutMode').value=layoutMode;dirty=true;$('#saveStatus').textContent='未保存更改';Studio.draw();Studio.refreshPreview()} +function restoreSnapshot(index){if(index<0||index>=snapshots.length)return;snapshotCursor=index;const state=JSON.parse(snapshots[index]);blocks=state.blocks;kind=state.kind;layoutMode=state.layoutMode;selected=Math.min(selected,blocks.length-1);$('#pageTemplate').value=kind;$('#layoutMode').value=layoutMode;dirty=true;$('#saveStatus').textContent='未保存更改';$('#saveStatus').classList.add('dirty');Studio.updateHistoryButtons();Studio.draw();Studio.refreshPreview()} const Studio={ async init(){try{csrf=(await api('/api/auth/me')).csrf;site=await api(`/api/sites/${siteId}`);pages=await api(`/api/sites/${siteId}/entries`);schema=await api('/api/editor/blocks');$('#siteName').textContent=site.name;const select=$('#pageSelect');select.innerHTML=pages.map(e=>``).join('');for(let [k,v] of Object.entries(schema.page_templates))$('#pageTemplate').innerHTML+=``;Studio.renderPalette();await Studio.loadReusables();await Studio.choosePage(pageId||pages[0]?.id)}catch(e){toast('初始化失败：'+e.message,true);console.error(e)}}, - async choosePage(id){if(dirty&&!confirm('当前页面尚未保存，确定切换？')){$('#pageSelect').value=pageId;return}pageId=id;$('#pageSelect').value=id;const data=await api(`/api/sites/${siteId}/pages/${id}/studio-draft`);draftRevision=data.revision;blocks=data.blocks.map(b=>structuredClone(b));kind=data.page_template;layoutMode=data.layout_mode||'append';$('#layoutMode').value=layoutMode;selected=blocks.length?0:-1;$('#pageTemplate').value=kind;$('#pageName').textContent=data.entry.title;$('#routeDisplay').textContent=data.entry.route;dirty=false;snapshots=[];snapshotCursor=-1;recordSnapshot();Studio.draw();Studio.refreshPreview()}, + async choosePage(id){if(savePromise){toast('保存仍在进行，请稍后切换页面',true);$('#pageSelect').value=pageId;return}if(dirty&&!confirm('当前页面尚未保存，确定切换？')){$('#pageSelect').value=pageId;return}pageId=id;$('#pageSelect').value=id;const data=await api(`/api/sites/${siteId}/pages/${id}/studio-draft`);draftRevision=data.revision;blocks=data.blocks.map(b=>structuredClone(b));kind=data.page_template;layoutMode=data.layout_mode||'append';$('#layoutMode').value=layoutMode;selected=blocks.length?0:-1;$('#pageTemplate').value=kind;$('#pageName').textContent=data.entry.title;$('#routeDisplay').textContent=data.entry.route;dirty=false;snapshots=[];snapshotCursor=-1;lastContinuousEdit=0;blockSearch='';$('#blockSearch').value='';recordSnapshot();Studio.updateHistoryButtons();$('#saveStatus').textContent=draftRevision?'草稿 v'+draftRevision:'未修改';$('#saveStatus').classList.remove('dirty');Studio.draw();Studio.refreshPreview()}, async loadReusables(){try{reusables=await api(`/api/sites/${siteId}/components`);$('#reusablePalette').innerHTML=reusables.map(x=>``).join('')||'暂无保存的组件'}catch(e){console.warn(e)}}, async saveReusable(){const block=blocks[selected];if(!block)return toast('请先选择一个区块',true);const name=prompt('为此组件命名',block.title||schema.blocks[block.type]?.name);if(!name?.trim())return;try{await api(`/api/sites/${siteId}/components`,req('POST',{name,block}));await Studio.loadReusables();toast('组件已保存到本站组件库')}catch(e){toast(e.message,true)}}, - insertReusable(id){const saved=reusables.find(x=>x.id===id);if(!saved)return;const copy=structuredClone(saved.block);const refreshIds=item=>{item.id=crypto.randomUUID().replace(/-/g,'').slice(0,10);if(item.type==='layout')(item.columns||[]).forEach(c=>(c.blocks||[]).forEach(refreshIds))};refreshIds(copy);blocks.push(copy);selected=blocks.length-1;Studio.modified();Studio.draw();}, + insertReusable(id){const saved=reusables.find(x=>x.id===id);if(!saved)return;const copy=editorTools.duplicate(saved.block,()=>crypto.randomUUID().replace(/-/g,'').slice(0,10));blocks.push(copy);selected=blocks.length-1;Studio.modified();Studio.draw();}, renderPalette(){let p=$('#palette');p.innerHTML=Object.entries(schema.blocks).map(([key,b])=>``).join('')}, - draw(){let list=$('#blockList');$('#blockCount').textContent=blocks.length+' 区块';list.innerHTML=blocks.map((b,i)=>`
⠿
${html(schema.blocks[b.type]?.icon||'▣')}
${html(schema.blocks[b.type]?.name||b.type)}${html(b.title||b.subtitle||b.type)}
`).join('')||'
当前没有区块，点击下方按钮添加。
';Studio.inspector()}, - select(i){selected=i;Studio.draw()}, - add(type){let data=structuredClone(schema.blocks[type].defaults);data.id=crypto.randomUUID().replace(/-/g,'').slice(0,10);data.type=type;data.visible=true;blocks.push(data);selected=blocks.length-1;Studio.modified();Studio.draw()}, - duplicate(i){let b=structuredClone(blocks[i]);b.id=crypto.randomUUID().replace(/-/g,'').slice(0,10);blocks.splice(i+1,0,b);selected=i+1;Studio.modified();Studio.draw()}, + toggleLibrary(force){libraryOpen=typeof force==='boolean'?force:!libraryOpen;const el=$('#sfLibraryPanel'),btn=$('#sfAddBlock');if(el)el.hidden=!libraryOpen;if(btn){btn.setAttribute('aria-expanded',String(libraryOpen));btn.textContent=libraryOpen?'× 收起区块库':'＋ 添加内容区块'};Studio.updateGuidance()}, + showHelp(){const dlg=$('#sfGuideDialog');if(dlg&&!dlg.open)dlg.showModal()}, + updateGuidance(){const one=$('#sfStep1'),two=$('#sfStep2'),three=$('#sfStep3');if(!one||!two||!three)return;one.classList.toggle('active',selected<0||libraryOpen);two.classList.toggle('active',selected>=0&&!dirty&&!libraryOpen);three.classList.toggle('active',dirty);}, + draw(){ + const list=$('#blockList');$('#blockCount').textContent=blocks.length+' 区块'; + const found=editorTools.filterBlocks(blocks,blockSearch,schema.blocks); + list.innerHTML=found.map(({block:b,index:i})=>`
${html(schema.blocks[b.type]?.icon||'▣')}
${html(schema.blocks[b.type]?.name||b.type)}${html(b.title||b.subtitle||b.type)}
`).join('')||`
${blockSearch?'没有找到匹配区块，试试清除搜索。':'当前没有区块，点击下方按钮添加。'}
`; + Studio.inspector();Studio.updateGuidance(); + }, + filter(value){blockSearch=String(value||'').slice(0,100);Studio.draw()}, + clearFilter(){blockSearch='';$('#blockSearch').value='';Studio.draw();$('#blockSearch').focus()}, + moveBlock(i,offset){const target=i+offset;const next=editorTools.reorder(blocks,i,target);if(!next||target===i)return;blocks=next;selected=target;Studio.modified();Studio.draw();}, + toggleVisible(i){if(!blocks[i])return;blocks[i].visible=blocks[i].visible===false;Studio.modified();Studio.draw()}, + blockKeydown(event,i){if(event.target!==event.currentTarget)return;if(event.key==='Enter'||event.key===' '){event.preventDefault();Studio.select(i)}else if(event.altKey && (event.key==='ArrowUp'||event.key==='ArrowDown')){event.preventDefault();Studio.moveBlock(i,event.key==='ArrowUp'?-1:1)}}, + changeInspectorTab(tab){if(!['content','style','responsive'].includes(tab))return;inspectorTab=tab;Studio.applyInspectorTab()}, + applyInspectorTab(){for(const key of ['content','style','responsive']){const active=key===inspectorTab;const btn=$('#tab'+key.charAt(0).toUpperCase()+key.slice(1));btn?.setAttribute('aria-selected',String(active));const pane=$('[data-inspector-section="'+key+'"]');if(pane)pane.hidden=!active}}, + togglePane(which){const type=which==='left'?'show-structure':'show-inspector';document.body.classList.toggle(type);if(type==='show-structure')document.body.classList.remove('show-inspector');else document.body.classList.remove('show-structure');}, + updateHistoryButtons(){const state=editorTools.historyState(snapshots,snapshotCursor);$('#studioUndo').disabled=!state.canUndo;$('#studioRedo').disabled=!state.canRedo}, + + select(i){selected=i;Studio.draw();if(window.matchMedia('(max-width:950px)').matches){document.body.classList.add('show-inspector');document.body.classList.remove('show-structure')}}, + add(type){let data=structuredClone(schema.blocks[type].defaults);data.id=crypto.randomUUID().replace(/-/g,'').slice(0,10);data.type=type;data.visible=true;blocks.push(data);selected=blocks.length-1;Studio.modified();Studio.draw();Studio.toggleLibrary(false);if(window.matchMedia('(max-width:950px)').matches){document.body.classList.add('show-inspector');document.body.classList.remove('show-structure')}}, + duplicate(i){const b=editorTools.duplicate(blocks[i],()=>crypto.randomUUID().replace(/-/g,'').slice(0,10));blocks.splice(i+1,0,b);selected=i+1;Studio.modified();Studio.draw()}, remove(i){if(!confirm('确定删除这个区块？'))return;blocks.splice(i,1);selected=Math.min(i,blocks.length-1);Studio.modified();Studio.draw()}, drag(e,i){e.dataTransfer.setData('text/plain',String(i));e.dataTransfer.effectAllowed='move';e.currentTarget.classList.add('dragging')}, - drop(e,i){e.preventDefault();let src=Number(e.dataTransfer.getData('text/plain'));if(!Number.isInteger(src)||src<0||src>=blocks.length||src===i)return;let [b]=blocks.splice(src,1);blocks.splice(i,0,b);selected=i;Studio.modified();Studio.draw()}, + drop(e,i){e.preventDefault();let src=Number(e.dataTransfer.getData('text/plain'));if(!Number.isInteger(src)||src<0||src>=blocks.length||src===i)return;const moved=editorTools.reorder(blocks,src,i);if(!moved)return;blocks=moved;selected=i;Studio.modified();Studio.draw()}, field(key,value){const b=blocks[selected];if(!b)return;b[key]=value;Studio.modified();Studio.draw()}, - fieldQuiet(key,value){const b=blocks[selected];if(!b)return;b[key]=value;Studio.modified();const row=$('#blockList').children[selected];if(row)row.querySelector('small').textContent=b.title||b.subtitle||b.type}, + fieldQuiet(key,value){const b=blocks[selected];if(!b)return;b[key]=value;Studio.modified(true);const row=$('#blockList').querySelector(`[data-index="${selected}"]`);if(row)row.querySelector('small').textContent=b.title||b.subtitle||b.type}, + arrayEditor(field,value,type){ + const rows=Array.isArray(value)?value:[]; + const labels={title:'标题',text:'文字介绍',value:'数字',label:'名称',question:'问题',answer:'回答',url:'图片地址',alt:'图片说明',image:'图片地址',caption:'图片说明',name:'名称',price:'价格',features:'方案包含的服务',href:'按钮跳转路径'}; + const spec=schema.blocks[type];const sample=(spec?.defaults?.[field]||[])[0]||{url:'',alt:''}; + const keys=Object.keys(sample); + return `

无需填写 JSON：按顺序编辑每一项，修改会自动显示在预览中。

`+ + rows.map((row,i)=>`
第 ${i+1} 项
`+ + keys.map(key=>``).join('')+ + `
`).join('')+`
`; + }, + itemField(field,index,key,value){const block=blocks[selected],row=block?.[field]?.[index];if(!row)return;row[key]=key==='features'?String(value).split('\n').map(x=>x.trim()).filter(Boolean):String(value).slice(0,1500);Studio.modified(true)}, + addItem(field){const block=blocks[selected];if(!block)return;const rows=block[field];if(!Array.isArray(rows))return;const limit=field==='images'?24:16;if(rows.length>=limit)return toast(`最多添加 ${limit} 项`,true);const sample=schema.blocks[block.type]?.defaults?.[field]?.[0]||{url:'',alt:''};const next={};for(const [key,val] of Object.entries(sample))next[key]=Array.isArray(val)?[]:'';rows.push(next);Studio.modified();Studio.inspector()}, + removeItem(field,index){const rows=blocks[selected]?.[field];if(!Array.isArray(rows)||!rows[index])return;rows.splice(index,1);Studio.modified();Studio.inspector()}, + moveItem(field,index,by){const rows=blocks[selected]?.[field],target=index+by;if(!Array.isArray(rows)||target<0||target>=rows.length)return;[rows[index],rows[target]]=[rows[target],rows[index]];Studio.modified();Studio.inspector()}, jsonField(key,value){try{let data=JSON.parse(value);if(!Array.isArray(data))throw Error('必须为数组');Studio.fieldQuiet(key,data);$('#jsonError').textContent='✓ JSON 格式有效';$('#jsonError').style.color='#238460'}catch(e){$('#jsonError').textContent='JSON 格式有误：'+e.message;$('#jsonError').style.color='#bf5a58'}}, styleField(key,value){const b=blocks[selected];b.style={...(b.style||{}),[key]:value};Studio.modified()}, - inspector(){let target=$('#inspector');let b=blocks[selected];$('#blockTypeLabel').textContent=b?schema.blocks[b.type].name:'页面';if(!b){target.innerHTML='
请从左侧选择区块并编辑属性。
';return}const spec=schema.blocks[b.type];let out=`

${html(spec.name)}

`; + inspector(){let target=$('#inspector');let b=blocks[selected];$('#blockTypeLabel').textContent=b?schema.blocks[b.type].name:'页面';if(!b){target.innerHTML='
还没有选中内容

先到左侧选择一个区块，或点击“添加内容区块”。

';return}const spec=schema.blocks[b.type];let out=`

${html(spec.name)}

`; for(const field of spec.fields){let value=b[field]??'',label=({title:'标题',subtitle:'副标题',description:'简介',image:'图片地址',body:'正文 HTML',button:'按钮文字',href:'跳转路径',source:'绑定内容类型',limit:'显示条数',columns:'每行列数',items:'重复条目',images:'画廊图片',image_side:'图片方向',align:'标题对齐',height:'间隔高度'})[field]||field; out+=`
`; - if(field==='items'||field==='images')out+=`请输入 JSON 数组，可编辑多个项目`; + if(field==='items'||field==='images')out+=Studio.arrayEditor(field,value,b.type); else if(field==='source')out+=`网站已有内容将自动绑定并生成卡片。`; else if(field==='image_side'||field==='align')out+=``; else if(field==='body'||field==='description')out+=``; @@ -41,6 +77,7 @@ const Studio={ if(['title','subtitle','description','image','body'].includes(field))out+='可输入 {{site.name}}、{{page.title}} 等变量。'; out+='
'; } + out+='
'; if(b.type==='layout'){ out+=`
列内组件 · 按设备排版

分别调整平板/手机的列数、顺序、跨度与显隐。保存草稿后在设备预览切换查看效果。

`; b.columns.forEach((column,ci)=>{ @@ -55,20 +92,72 @@ const Studio={ }); out+=''; } - out+=`
区块设计（按设备覆盖）
`; + out+=`
响应式样式
`; + out+=`
外观设置
`; out+='
'; - target.innerHTML=out; + target.innerHTML=out;Studio.applyInspectorTab(); }, undo(){restoreSnapshot(snapshotCursor-1)}, redo(){restoreSnapshot(snapshotCursor+1)}, - modified(){recordSnapshot();dirty=true;$('#saveStatus').textContent='未保存更改';$('#saveStatus').classList.add('dirty');clearTimeout(timer);timer=setTimeout(()=>Studio.refreshPreview(),500)}, - async refreshPreview(){if(!pageId)return;try{let frame=$('#sitePreview');let doc=await api(`/api/sites/${siteId}/pages/${pageId}/editor-preview`,req('POST',{blocks,page_template:kind,layout_mode:layoutMode,site_design:siteDesignPreview}));frame.srcdoc=doc}catch(e){toast('预览失败：'+e.message,true)}}, - device(type){$('#deviceFrame').className='device-frame '+(type==='desktop'?'':type);for(let name of ['Desktop','Tablet','Phone'])$('#device'+name).classList.toggle('on',name.toLowerCase()===type)}, + modified(continuous=false){ + const now=Date.now(),snap=JSON.stringify({blocks,kind,layoutMode}); + if(continuous&&lastContinuousEdit&&now-lastContinuousEdit<850&&snapshotCursor>0&&snapshotCursor===snapshots.length-1){snapshots[snapshotCursor]=snap;} + else recordSnapshot(); + lastContinuousEdit=continuous?now:0; + dirty=true;$('#saveStatus').textContent='未保存更改';$('#saveStatus').classList.add('dirty'); + Studio.updateHistoryButtons();Studio.updateGuidance();clearTimeout(timer);timer=setTimeout(()=>Studio.refreshPreview(),550); + }, + async refreshPreview(){ + if(!pageId)return; + const page=pageId,seq=++previewRequest; + if(previewController)previewController.abort();previewController=new AbortController(); + const frame=$('#sitePreview');$('#previewState').textContent='正在更新预览…';$('#previewDot').classList.add('loading'); + try{ + const doc=await api(`/api/sites/${siteId}/pages/${page}/editor-preview`,{...req('POST',{blocks,page_template:kind,layout_mode:layoutMode,site_design:siteDesignPreview}),signal:previewController.signal}); + if(!editorTools.shouldAcceptPreview(page,seq,pageId,previewRequest))return; + frame.srcdoc=doc;$('#previewState').textContent='实时预览 · 已更新';$('#previewDot').classList.remove('loading','error'); + }catch(e){ + if(!editorTools.shouldAcceptPreview(page,seq,pageId,previewRequest)||e.name==='AbortError')return; + $('#previewState').textContent='预览更新失败';$('#previewDot').classList.remove('loading');$('#previewDot').classList.add('error');toast('预览失败：'+e.message,true); + } + }, + device(type){$('#deviceFrame').className='device-frame '+(type==='desktop'?'':type);$('#deviceDetails').textContent=({desktop:'桌面端 · 自适应宽度',tablet:'平板端 · 780px',phone:'手机端 · 390px'})[type]||'桌面端';for(let name of ['Desktop','Tablet','Phone'])$('#device'+name).classList.toggle('on',name.toLowerCase()===type)}, changeTemplateKind(t){kind=t;Studio.modified()}, setLayoutMode(v){layoutMode=v;Studio.modified()}, async resetPreset(){if(!confirm('用当前主题的预设布局替换草稿？不会更改正式页面。'))return;try{const result=await api(`/api/sites/${siteId}/pages/${pageId}/studio-draft/preset?page_template=${encodeURIComponent(kind)}`);blocks=result.blocks;selected=blocks.length?0:-1;Studio.modified();Studio.draw();toast('已加载预设到草稿，记得保存')}catch(e){toast(e.message,true)}}, - async save(){try{const result=await api(`/api/sites/${siteId}/pages/${pageId}/studio-draft`,req('PUT',{blocks,page_template:kind,layout_mode:layoutMode,expected_revision:draftRevision}));draftRevision=result.revision;dirty=false;$('#saveStatus').textContent='草稿 v'+draftRevision;$('#saveStatus').classList.remove('dirty');toast('设计草稿已保存，正式构建不受影响')}catch(e){toast('草稿保存失败：'+e.message,true)}}, - async publishDesign(){if(dirty){await Studio.save();if(dirty)return}if(!draftRevision)return toast('当前没有待发布草稿');if(!confirm('发布设计将更新内容库中的页面布局，下次静态构建才会生效。是否发布？'))return;try{await api(`/api/sites/${siteId}/pages/${pageId}/studio-draft/publish`,req('POST',{expected_revision:draftRevision}));draftRevision=0;$('#saveStatus').textContent='已发布到内容库';toast('设计已发布；请构建网站生成新的正式静态文件')}catch(e){toast('发布失败：'+e.message,true)}}, + async showHistory(){ + if(!pageId)return toast('请先选择页面',true); + $('#studioHistoryModal').showModal();$('#studioHistoryItems').textContent='读取历史记录中…'; + try{const data=await api(`/api/sites/${siteId}/pages/${pageId}/studio-history?limit=50`); + $('#studioHistoryItems').innerHTML=(data.items||[]).map(x=>`
${x.kind==='published'?'已发布':'草稿'} · v${html(x.revision)}
${html(x.created_at)} · ${html(x.actor)} · SHA ${html(x.snapshot_hash.slice(0,12))}
`).join('')||'

当前页面尚无保存记录。

'; + }catch(e){$('#studioHistoryItems').textContent='读取失败：'+e.message} + }, + async restoreHistory(id){ + if(dirty&&!confirm('当前有未保存的本地修改。恢复历史记录将舍弃这些本地修改，继续吗？'))return; + if(!confirm('确定以这个历史快照创建一个新的设计草稿？已发布的页面不会立即改变。'))return; + try{await api(`/api/sites/${siteId}/pages/${pageId}/studio-history/${encodeURIComponent(id)}/restore`,req('POST',{expected_revision:draftRevision})); + dirty=false;$('#studioHistoryModal').close();await Studio.choosePage(pageId); + toast('历史版本已恢复为新草稿。核对后再点击发布设计。'); + }catch(e){toast('历史恢复失败：'+e.message,true)} + }, + async save(){ + if(savePromise)return savePromise; + const page=pageId;const snapshot=JSON.stringify({blocks,kind,layoutMode});const frozen=JSON.parse(snapshot); + $('#saveStatus').textContent='保存中…'; + savePromise=(async()=>{ + try{ + const result=await api(`/api/sites/${siteId}/pages/${page}/studio-draft`,req('PUT',{blocks:frozen.blocks,page_template:frozen.kind,layout_mode:frozen.layoutMode,expected_revision:draftRevision})); + if(page!==pageId)return; + draftRevision=result.revision; + const unchanged=snapshot===JSON.stringify({blocks,kind,layoutMode}); + dirty=!unchanged;$('#saveStatus').textContent=unchanged?'草稿 v'+draftRevision:'有新修改待保存'; + $('#saveStatus').classList.toggle('dirty',dirty); + toast(unchanged?'设计草稿已保存，正式构建不受影响':'草稿已保存，但有新修改，需再次保存'); + }catch(e){dirty=true;$('#saveStatus').textContent='保存失败';$('#saveStatus').classList.add('dirty');toast('草稿保存失败：'+e.message,true)} + finally{savePromise=null;Studio.updateGuidance()} + })();return savePromise; + }, + async publishDesign(){if(dirty){await Studio.save();if(dirty)return}if(!draftRevision)return toast('当前没有待发布草稿');if(!confirm('发布设计将更新内容库中的页面布局，下次静态构建才会生效。是否发布？'))return;try{await api(`/api/sites/${siteId}/pages/${pageId}/studio-draft/publish`,req('POST',{expected_revision:draftRevision}));draftRevision=0;$('#saveStatus').textContent='已发布到内容库';Studio.updateGuidance();toast('设计已发布到内容库。要更新线上网站，请在“更多”中构建并部署。')}catch(e){toast('发布失败：'+e.message,true)}}, async discardDraft(){if(!draftRevision)return;if(!confirm('确定放弃草稿？'))return;try{await api(`/api/sites/${siteId}/pages/${pageId}/studio-draft`,{method:'DELETE'});dirty=false;await Studio.choosePage(pageId);toast('草稿已放弃')}catch(e){toast(e.message,true)}}, dragChild(event,col,index){draggedChild={container:selected,col,index};event.dataTransfer.setData('application/siteforge-child','1');event.dataTransfer.effectAllowed='move';event.stopPropagation()}, dropChild(event,destCol){if(!draggedChild)return;event.preventDefault();event.stopPropagation();const drag=draggedChild;draggedChild=null;const src=blocks[drag.container],dest=blocks[selected];if(!src||!dest||src.type!=='layout'||dest.type!=='layout')return;const moved=src.columns?.[drag.col]?.blocks.splice(drag.index,1)[0];if(!moved)return;dest.columns[destCol].blocks.push(moved);Studio.modified();Studio.draw()}, @@ -80,15 +169,36 @@ const Studio={ for(const [name,value] of Object.entries(f)){const key='footer_'+name,el=form.elements.namedItem(key);if(el){if(el.type==='checkbox')el.checked=value;else el.value=value}} for(const [name,value] of Object.entries(r)){const el=form.elements.namedItem(name);if(el){if(el.type==='checkbox')el.checked=value;else el.value=value}} form.elements.namedItem('nav').value=JSON.stringify(siteDesign.nav,null,2); + form.elements.namedItem('mobile_tabs_enabled').checked=Boolean(siteDesign.mobile_tabs?.enabled); + Studio.drawMobileTabs(siteDesign.mobile_tabs?.items||[]); + Studio.toggleMobileTabsForm(); $('#siteDesignStatus').textContent=result.state==='draft'?`待发布的全站草稿 v${siteDesignRevision}${result.conflict?' · 网站已被其他人修改':''}`:'当前为已发布设计'; $('#siteDesignModal').showModal(); }catch(e){toast('全站设计读取失败：'+e.message,true)}}, + drawMobileTabs(items){const root=$('#mobileTabsRows');root.replaceChildren();items.forEach((item,i)=>Studio.addMobileTab(item,i));}, + toggleMobileTabsForm(){const on=$('#siteDesignForm').elements.namedItem('mobile_tabs_enabled').checked;$('#mobileTabsEditor').hidden=!on;}, + addMobileTab(item={title:'新导航',icon:'grid',route:'/',action:'link'},index){ + const root=$('#mobileTabsRows');if(root.children.length>=5){toast('底部最多支持 5 个 Tab',true);return} + const n=root.children.length; + const row=document.createElement('div');row.className='mobile-tab-row';row.style.cssText='display:grid;grid-template-columns:1fr 1fr;gap:8px;padding:12px;border:1px solid #dce3ed;border-radius:10px;background:#fafcff'; + const label=document.createElement('label');label.textContent='按钮名称';const title=document.createElement('input');title.className='mt-title';title.maxLength=12;title.value=item.title||'';label.append(title); + const iconLabel=document.createElement('label');iconLabel.textContent='按钮图标';const icon=document.createElement('select');icon.className='mt-icon'; + for(const [v,t] of Object.entries({home:'⌂ 首页',grid:'▦ 栏目',products:'▤ 产品',news:'☷ 文章',contact:'✉ 联系',phone:'☎ 电话',info:'ⓘ 关于',search:'⌕ 搜索',menu:'☰ 菜单',star:'☆ 收藏'})){const opt=document.createElement('option');opt.value=v;opt.textContent=t;icon.append(opt)}icon.value=item.icon||'grid';iconLabel.append(icon); + const actionLabel=document.createElement('label');actionLabel.textContent='点击操作';const action=document.createElement('select');action.className='mt-action';for(const [v,t] of [['link','打开站内页面'],['menu','打开导航抽屉']]){const o=document.createElement('option');o.value=v;o.textContent=t;action.append(o)}action.value=item.action||'link';actionLabel.append(action); + const routeLabel=document.createElement('label');routeLabel.textContent='链接地址';const route=document.createElement('input');route.className='mt-route';route.placeholder='/products/、https://wa.me/... 或 tel:+...';route.value=item.route||'/';routeLabel.append(route); + function updateRoute(){routeLabel.hidden=action.value==='menu'}action.addEventListener('change',updateRoute);updateRoute(); + const tools=document.createElement('div');tools.style.cssText='grid-column:1/-1;display:flex;gap:7px;justify-content:flex-end'; + for(const [name,fn] of [['↑ 上移',()=>{const prev=row.previousElementSibling;if(prev)root.insertBefore(row,prev)}],['↓ 下移',()=>{const next=row.nextElementSibling;if(next)root.insertBefore(next,row)}],['删除',()=>row.remove()]]){const b=document.createElement('button');b.type='button';b.className='ui-btn ghost';b.textContent=name;b.addEventListener('click',fn);tools.append(b)} + row.append(label,iconLabel,actionLabel,routeLabel,tools);root.append(row); + }, collectSiteDesign(){const form=$('#siteDesignForm');if(!siteDesign)throw Error('请先打开全站设计'); const v=(n)=>form.elements.namedItem(n).value; const yes=(n)=>form.elements.namedItem(n).checked; let nav;try{nav=JSON.parse(v('nav'))}catch(e){throw Error('导航必须是合法 JSON：'+e.message)} if(!Array.isArray(nav))throw Error('导航必须是数组'); - return {header:{announcement:v('announcement'),show_announcement:yes('show_announcement'),show_search:yes('show_search'), + const tabs=[...$('#mobileTabsRows').children].map(row=>({title:row.querySelector('.mt-title').value.trim(),icon:row.querySelector('.mt-icon').value,route:row.querySelector('.mt-route').value.trim(),action:row.querySelector('.mt-action').value})); + if(yes('mobile_tabs_enabled')&&!tabs.length)throw Error('开启底部 Tabs 后，请至少添加一个按钮'); + return {tokens:structuredClone(siteDesign.tokens),mobile_tabs:{enabled:yes('mobile_tabs_enabled'),items:tabs},header:{announcement:v('announcement'),show_announcement:yes('show_announcement'),show_search:yes('show_search'), show_cta:yes('show_cta'),cta_text:v('cta_text'),cta_href:v('cta_href')}, footer:{title:v('footer_title'),description:v('footer_description'),email:v('footer_email'),show_nav:yes('footer_show_nav')},nav, responsive:{tablet_gap:Number(v('tablet_gap')),mobile_gap:Number(v('mobile_gap')), @@ -143,6 +253,12 @@ window.addEventListener('message',event=>{ const frame=document.querySelector('#sitePreview'); if(!frame||event.source!==frame.contentWindow)return; const data=event.data||{}; + if(data.source==='siteforge-select-block'){ + if(typeof data.blockId!=='string'||data.blockId.length>150)return; + const findTop=rows=>{for(let i=0;icol.blocks?.some(child=>child.id===data.blockId)))return i}return -1}; + const index=findTop(blocks);if(index>=0){selected=index;Studio.draw();if(window.matchMedia('(max-width:1060px)').matches){document.body.classList.add('show-inspector');document.body.classList.remove('show-structure')}} + return; + } if(data.source!=='siteforge-inline-editor')return; const findChild=rows=>{for(const row of rows){if(row.id===data.blockId)return {block:row,parent:row};if(row.type==='layout'){for(const col of row.columns||[]){const child=findChild(col.blocks||[]);if(child)return {block:child.block,parent:row};}}}return null}; const found=findChild(blocks),b=found?.block; @@ -152,4 +268,12 @@ window.addEventListener('message',event=>{ toast('已修改文字，点击保存页面写入数据库'); }); -window.addEventListener('keydown',event=>{if(!(event.ctrlKey||event.metaKey)||event.altKey)return;const el=document.activeElement;if(el&&['INPUT','TEXTAREA'].includes(el.tagName))return;if(event.key.toLowerCase()==='z'){event.preventDefault();event.shiftKey?Studio.redo():Studio.undo()}else if(event.key.toLowerCase()==='y'){event.preventDefault();Studio.redo()}}); +window.addEventListener('keydown',event=>{ + if(!(event.ctrlKey||event.metaKey)||event.altKey)return; + const key=event.key.toLowerCase(); + if(key==='s'){event.preventDefault();Studio.save();return} + const el=document.activeElement; + if(el&&(['INPUT','TEXTAREA'].includes(el.tagName)||el.isContentEditable))return; + if(key==='z'){event.preventDefault();event.shiftKey?Studio.redo():Studio.undo()} + else if(key==='y'){event.preventDefault();Studio.redo()} +}); diff --git a/app/static/factory-v2.js b/app/static/factory-v2.js index b8d5071..6d9d66e 100644 --- a/app/static/factory-v2.js +++ b/app/static/factory-v2.js @@ -43,11 +43,24 @@ async function readData(){let f=$('#dataFile').files?.[0];if(!f)return toast(' async function previewRelations(){try{const r=await api(factoryUrl('/relationships'));$('#relationReport').innerHTML=`
产品-品牌关联检查

已有品牌 ${r.brands.length} 个、分类 ${r.categories.length} 个；缺少独立品牌页 ${r.brand_pages_missing.length} 个

${H(r.brand_pages_missing.map(x=>x.brand).join(' / ')||'无')}

${r.issues.slice(0,10).map(x=>`

${H(x.route)} · ${H(x.message)}

`).join('')}
`;}catch(e){toast(e.message,true)}} async function assembleRelations(){if(!confirm('依据真实产品品牌字段创建缺少的品牌页面？不会自动生成虚构文案。'))return;try{const r=await api(factoryUrl('/relationships/assemble'),'POST',{});toast(`已创建 ${r.count} 个品牌页面`);await previewRelations()}catch(e){toast(e.message,true)}} -function drawMapping(){let fields=['title','route','summary','body','cover','brand','category','model','energy','range','gallery','specs','sku','price','seo_title','seo_description','canonical'];let labels={title:'标题（必填）',route:'旧站 URL',summary:'摘要',body:'详情正文',cover:'封面',brand:'品牌',category:'分类',seo_title:'SEO标题',seo_description:'SEO描述',canonical:'Canonical',model:'型号',energy:'动力形式',range:'续航',gallery:'图库（JSON数组或分号分隔）',specs:'技术参数',sku:'SKU',price:'价格'}; - $('#mappingUI').innerHTML=`

字段映射（已读取 ${state.importRows.length} 行）

${fields.map(t=>`
${H(labels[t])}
`).join('')}
`;} -function gather(){let rules={};$$('.mapfield').forEach(x=>{if(x.value)rules[x.dataset.target]=x.value});return {rows:state.importRows,rules,content_type:$('#mapKind').value}} -async function mappingPreview(){try{let r=await api(factoryUrl('/mapping/run'),'POST',{...gather(),dry_run:true});$('#mappingReport').innerHTML=`
预览：${r.mapped} 条可映射

错误 ${r.errors.length} 条，URL 冲突 ${r.conflicts.length} 条

${r.sample.map(x=>``).join('')}
标题新 URL内容类型
${H(x.title)}${H(x.route)}${H(x.type)}
${r.errors.length?'

'+H(JSON.stringify(r.errors.slice(0,6)))+'

':''}
`}catch(e){toast(e.message,true)}} -async function mappingCommit(){if(!confirm('确认将已映射的数据写入当前网站？'))return;try{let r=await api(factoryUrl('/mapping/run'),'POST',{...gather(),dry_run:false,on_conflict:'skip'});toast(`新增 ${r.created} 条，跳过 ${r.skipped} 条，错误 ${r.errors.length} 条`);await render()}catch(e){toast(e.message,true)}} +function drawMapping(){ + const fields=['title','route','summary','body','cover','brand','category','model','year','energy','sku','seo_title','seo_description']; + const labels={title:'标题',route:'URL 原路径',summary:'摘要',body:'正文',cover:'封面',brand:'品牌',category:'分类',model:'型号',year:'年份',energy:'动力类型',sku:'SKU',seo_title:'SEO 标题',seo_description:'SEO 描述'}; + state.mappingPlanHash=null; + $('#mappingUI').innerHTML=`

字段映射（已读取 ${state.importRows.length} 行）

可以为每个字段选择大小写变换；所有转换都由固定规则执行，不运行代码。

${fields.map(t=>`
${H(labels[t])}
`).join('')}
`; +} +function gather(){let rules={};$$('.mapfield').forEach(x=>{if(x.value){const mode=document.querySelector(`[data-transform="${x.dataset.target}"]`)?.value||'none';rules[x.dataset.target]=mode==='none'?x.value:{source:x.value,case:mode}}});return {rows:state.importRows,rules,content_type:$('#mapKind').value}} + +async function mappingPreview(){try{const payload=gather(),r=await api(factoryUrl('/mapping/run'),'POST',{...payload,dry_run:true});state.mappingPlanHash=r.plan_hash;$('#mappingReport').innerHTML=`
预览：${r.mapped} 条可映射

错误 ${r.errors.length} 条，URL 冲突 ${r.conflicts.length} 条

预检指纹：${H(r.plan_hash.slice(0,16))}…（提交时验证内容未变化）

${r.sample.map(x=>``).join('')}
标题新 URL内容类型
${H(x.title)}${H(x.route)}${H(x.type)}
${r.errors.length?'

'+H(JSON.stringify(r.errors.slice(0,6)))+'

':''}
`}catch(e){state.mappingPlanHash=null;toast(e.message,true)}} + +async function mappingCommit(){ + if(!state.mappingPlanHash)return toast('请先执行映射预览，确认 URL 和冲突后再导入',true); + const policy=$('#mapConflict').value; + if(policy==='replace'&&!confirm('覆盖模式将修改已有同 URL 内容。请确认已备份并核对预览。'))return; + if(!confirm('将当前预检结果写入当前网站？'))return; + try{const r=await api(factoryUrl('/mapping/run'),'POST',{...gather(),dry_run:false,on_conflict:policy,expected_plan_hash:state.mappingPlanHash});state.mappingPlanHash=null;toast(`新增 ${r.created} 条，更新 ${r.updated} 条，跳过 ${r.skipped} 条，错误 ${r.errors.length} 条`);await render()} + catch(e){state.mappingPlanHash=null;toast('导入失败，请重新预检：'+e.message,true)} +} async function migration(){let [data,assets,builds]=await Promise.all([api(factoryUrl('/migration/readiness')),api(factoryUrl('/assets/inventory')),api(siteUrl('/builds'))]); let audit=builds.length?await api(`/api/audit/sites/${state.site.id}/builds/${builds[0].id}/report`).catch(()=>null):null;const gate=data.gates||[];$('#panel').innerHTML=`
旧站 URL 基线${data.baseline.baseline_count}应保持有效的历史路径
缺失 URL${data.baseline.errors}发布阻断项
SEO 差异${data.baseline.warnings}需要人工核查
资源引用${assets.references}实际已识别的内容图片

迁移验收门禁

${gate.length?gate.map(g=>`
${g.level==='block'?'阻止发布':'需人工复核'}

${H(g.message)}

`).join(''):'

当前已检测范围内未发现阻断项。

'}
资源清单 JSON

提示：完整旧站 URL 基线应来自迁移前的原网站清单，不要用迁移后不完整的网站替代。

实际生成 HTML 与旧站对比

${audit?`

旧站 ${audit.baseline_count} 条 / 已匹配 ${audit.matched_pages||0} 条；阻断 ${audit.errors} 项；待复核 ${audit.unreviewed_warnings||0} 项

下载差异 CSV
${audit.issues.slice(0,40).map(i=>``).join('')}
问题路径操作
${H(i.field)} · ${H(i.message)}${H(i.route)}${i.severity==='warning'&&!i.reviewed?``:i.reviewed?'已复核':'必须修复'}
`:'

请先构建新站，再与旧站基线对比。

'}

前 12 项差异

${data.baseline.issues.slice(0,12).map(x=>`
${H(x.route)}${H(x.field)} · ${H(x.severity)}
`).join('')||'

没有基线差异。

'}
`;} async function saveContactSettings(){try{await api(siteUrl('/contact-settings'),'PUT',{email:$('#configEmail').value,form_endpoint:$('#configForm').value,footer_text:$('#configFooter').value});toast('网站联系配置已保存');await refresh()}catch(e){toast(e.message,true)}} diff --git a/app/static/operations.js b/app/static/operations.js index 2e631b1..8010975 100644 --- a/app/static/operations.js +++ b/app/static/operations.js @@ -14,14 +14,15 @@ function formatJobs(list){return list.length?list.map(j=>`
async function chooseSite(){siteId=$('#site').value;window.SiteForgeShell?.selectSite(siteId);lastPreview=null;$('#commitImport').disabled=true;await reload()} async function init(){try{csrf=(await request('/api/auth/me')).csrf;sites=await request('/api/sites');$('#site').innerHTML=sites.map(s=>``).join('');siteId=sites[0]?.id||'';$('#site').onchange=chooseSite;$('#reload').onclick=reload;$('#previewImport').onclick=()=>importJSON(false);$('#commitImport').onclick=()=>importJSON(true);$('#build').onclick=buildSite;$('#deploy').onclick=deploySite;$('#refreshRelease').onclick=reload;await reload()}catch(e){notify(e.message,true)}} async function reload(){if(!siteId)return;try{ - const [list,jobsData,buildData,approvals,history,reviewData]=await Promise.all([ - request(`/api/sites/${siteId}`),request(`/api/enterprise/sites/${siteId}/jobs`),request(`/api/sites/${siteId}/builds`),request(`/api/factory/sites/${siteId}/release-requests`),request(`/api/enterprise/sites/${siteId}/releases`),request(`/api/migrations/sites/${siteId}/reviews`)]); + const [list,jobsData,buildData,approvals,history,reviewData,deliveryData]=await Promise.all([ + request(`/api/sites/${siteId}`),request(`/api/enterprise/sites/${siteId}/jobs`),request(`/api/sites/${siteId}/builds`),request(`/api/factory/sites/${siteId}/release-requests`),request(`/api/enterprise/sites/${siteId}/releases`),request(`/api/migrations/sites/${siteId}/reviews`),request(`/api/production/sites/${siteId}/delivery-status`)]); jobs=jobsData;builds=buildData;releases=history;$('#statBuild').textContent=builds.length;$('#statJobs').textContent=jobs.filter(j=>['queued','running','retrying'].includes(j.state)).length;$('#statApprovals').textContent=approvals.filter(j=>j.state==='pending').length;$('#statMode').textContent=list.mode==='migration'?'迁移':'新建';$('#jobList').innerHTML=formatJobs(jobs); $('#buildList').innerHTML=builds.length?builds.slice(0,14).map(b=>`
${esc(b.id)}${esc(b.created_at)} · ${esc(b.total_pages)} 页
`).join(''):'当前没有构建'; $('#releaseBuild').innerHTML=builds.map(b=>``).join(''); $('#approvals').innerHTML=approvals.length?approvals.slice(0,12).map(a=>`
${esc(a.build_id)} ${esc(a.state)}由 ${esc(a.requested_by)} 提交
${a.state==='pending'?``:''}
`).join(''):'暂无审批记录'; $('#reviews').innerHTML=reviewData.items.length?reviewData.items.map(x=>`
${esc(x.platform)} · 第 ${esc(x.row_number)} 条${esc(x.issue)}
`).join(''):'暂无待复核事项'; - $('#releases').innerHTML=history.length?history.slice(0,10).map(x=>`
${esc(x.build_id)} · ${esc(x.action)}${esc(x.created_at)}
`).join(''):'暂无部署记录'; + $('#releaseBackend').textContent=['staging','production'].map(t=>`${t}: ${deliveryData.backends?.[t]||'agent'} · ${deliveryData.configured?.[t]?'已配置':'未配置'}`).join(' ｜ '); + $('#releases').innerHTML=deliveryData.history?.length?deliveryData.history.slice(0,10).map(x=>`
${esc(x.build_id)} · ${esc(x.target)} · ${esc(x.release_id)}${esc(x.deployed_at)}
`).join(''): '暂无远程发布记录'; const entries=await request(`/api/sites/${siteId}/entries`);const entry=entries.find(p=>p.route==='/')||entries[0];$('#edit').href=entry?`/editor/${siteId}/${entry.id}`:'/factory-studio'; }catch(e){notify(e.message,true)}} async function importJSON(commit){const file=$('#file').files?.[0];if(!file)return notify('请选择 JSON 文件',true);if(!siteId)return;const platform=$('#platform').value; @@ -37,6 +38,9 @@ async function buildSite(){try{const task=await post(`/api/sites/${siteId}/build async function cancelJob(id){try{await post(`/api/enterprise/sites/${siteId}/jobs/${id}/cancel`,{});await reload()}catch(e){notify(e.message,true)}} async function requestApproval(build){try{await post(`/api/factory/sites/${siteId}/release-requests`,{build_id:build});notify('已提交发布审批');await reload()}catch(e){notify(e.message,true)}} async function approve(id){if(!confirm('审批人必须与申请人不同。确定审批通过吗？'))return;try{await post(`/api/factory/sites/${siteId}/release-requests/${id}/review`,{state:'approved'});notify('审批已完成');await reload()}catch(e){notify(e.message,true)}} -async function deploySite(){if(!confirm('请确保目标环境已配置 HTTPS 和发布 Agent。继续发布？'))return;try{const data=await post(`/api/production/sites/${siteId}/deploy`,{build_id:$('#releaseBuild').value,target:$('#target').value});notify(`已发布：${data.remote.release}`);await reload()}catch(e){notify(e.message,true)}} +async function deploySite(){if(!confirm('系统将使用目标环境预先配置的发布适配器。请确认构建已审批、DNS 与版本回退方案已准备好。继续发布？'))return;try{const data=await post(`/api/production/sites/${siteId}/deploy`,{build_id:$('#releaseBuild').value,target:$('#target').value});notify(`发布任务 ${data.id} 已提交，Worker 将先上传、校验，再切换线上版本。`);await reload()}catch(e){notify(e.message,true)}} +async function rollbackRelease(release,target){if(!confirm(`确认将 ${target} 恢复为历史版本 ${release}？`))return; + try{const result=await post(`/api/production/sites/${siteId}/rollback`,{release_id:release,target});notify(`回滚任务 ${result.id} 已进入队列`);await reload()}catch(e){notify(e.message,true)}} +window.rollbackRelease=rollbackRelease; window.resolveReview=resolveReview;window.cancelJob=cancelJob;window.requestApproval=requestApproval;window.approve=approve; window.addEventListener('DOMContentLoaded',init); diff --git a/app/static/pro.js b/app/static/pro.js index 29312a1..9cf100d 100644 --- a/app/static/pro.js +++ b/app/static/pro.js @@ -1,6 +1,52 @@ 'use strict';(()=>{ const menu=document.querySelector('[data-pro-menu]'); const nav=document.querySelector('#pro-navigation'); if(menu&&nav){menu.addEventListener('click',()=>{const open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));nav.classList.toggle('is-open',open);menu.setAttribute('aria-label',open?'关闭导航':'打开导航');});} + // Drawer navigation. The same markup is used across the four professional themes. + const mobileNav=document.querySelector('#pro-navigation'); + let drawerBackdrop=null,drawerClose=null,returnFocus=null; + if(menu&&mobileNav){ + const originalParent=mobileNav.parentNode,originalNext=mobileNav.nextSibling; + const heading=document.createElement('div');heading.className='sf-drawer-header'; + const title=document.createElement('strong');title.textContent='网站导航'; + drawerClose=document.createElement('button');drawerClose.type='button';drawerClose.className='sf-drawer-close';drawerClose.textContent='×';drawerClose.setAttribute('aria-label','关闭网站导航'); + heading.append(title,drawerClose);mobileNav.prepend(heading); + drawerBackdrop=document.createElement('div');drawerBackdrop.className='sf-mobile-drawer-backdrop';drawerBackdrop.hidden=false;document.body.append(drawerBackdrop); + function setDrawer(open,focusBack=true){ + const isMobile=window.matchMedia('(max-width:1024px)').matches; + open=Boolean(open&&isMobile); + if(open){returnFocus=document.activeElement;document.body.append(mobileNav);} + else if(mobileNav.parentNode!==originalParent){if(originalNext&&originalNext.parentNode===originalParent)originalParent.insertBefore(mobileNav,originalNext);else originalParent.append(mobileNav);} + mobileNav.classList.toggle('is-open',open);drawerBackdrop.classList.toggle('is-open',open); + document.body.classList.toggle('sf-drawer-open',open); + menu.setAttribute('aria-expanded',String(open));menu.setAttribute('aria-label',open?'关闭导航':'打开导航'); + mobileNav.setAttribute('aria-hidden',String(!open&&isMobile)); + if('inert' in mobileNav)mobileNav.inert=!open&&isMobile; + if(open)drawerClose.focus(); + else if(focusBack&&returnFocus instanceof HTMLElement){returnFocus.focus();returnFocus=null;} + } + // Replace the old inline-expansion listener: use capture to stop the old listener. + menu.addEventListener('click',e=>{if(!window.matchMedia('(max-width:1024px)').matches)return;e.stopImmediatePropagation();setDrawer(!mobileNav.classList.contains('is-open'));},true); + drawerClose.addEventListener('click',()=>setDrawer(false)); + drawerBackdrop.addEventListener('click',()=>setDrawer(false)); + document.querySelectorAll('[data-mobile-open-menu]').forEach(b=>b.addEventListener('click',()=>setDrawer(true))); + mobileNav.addEventListener('click',e=>{if(e.target.closest('a'))setDrawer(false,false)}); + document.addEventListener('keydown',e=>{ + if(e.key==='Escape'&&mobileNav.classList.contains('is-open')){e.preventDefault();setDrawer(false);} + if(e.key!=='Tab'||!mobileNav.classList.contains('is-open'))return; + const els=[...mobileNav.querySelectorAll('button:not([disabled]),a[href]')].filter(el=>el.getClientRects().length&&!el.closest('[hidden]')); + if(!els.length)return;const first=els[0],last=els[els.length-1]; + if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();} + else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();} + }); + window.matchMedia('(max-width:1024px)').addEventListener('change',()=>setDrawer(false,false)); + if('inert' in mobileNav&&window.matchMedia('(max-width:1024px)').matches)mobileNav.inert=true; + // Do not strand catalogue links when the old mobile mega-button is hidden. + const megaLinks=document.querySelectorAll('[data-pro-mega] a'); + if(megaLinks.length){const wrap=document.createElement('div');wrap.className='sf-drawer-extra';const h=document.createElement('strong');h.textContent='更多分类与系列';wrap.append(h); + [...megaLinks].slice(0,20).forEach(a=>{const clone=a.cloneNode(true);wrap.append(clone);});mobileNav.append(wrap);} + } + const tabbar=document.querySelector('[data-mobile-tabs]'); + if(tabbar){tabbar.style.setProperty('--sf-mobile-tab-count',String(tabbar.children.length));} const megaButton=document.querySelector('[data-pro-catalog]'), mega=document.querySelector('[data-pro-mega]'); if(megaButton&&mega){function setMega(open){mega.hidden=!open;mega.classList.toggle('is-open',open);megaButton.setAttribute('aria-expanded',String(open));} megaButton.addEventListener('click',()=>setMega(mega.hidden)); diff --git a/app/static/workspace.css b/app/static/workspace.css index c03a9cb..a3f3fb9 100644 --- a/app/static/workspace.css +++ b/app/static/workspace.css @@ -2,4 +2,5 @@ /* V8.12: task progress and dangerous actions, consistent focus and mobile sizing */ .btn-danger{border:1px solid #f1c3c7;color:#a92840;background:#fff5f6}.btn-danger:hover{background:#feecee}.btn:disabled{opacity:.55;cursor:not-allowed}.build-row{min-width:0}.build-meta{overflow-wrap:anywhere}.site-card:focus-visible,.quick-card:focus-visible{outline:3px solid #80aaf6;outline-offset:2px}@media(max-width:570px){.build-row{align-items:flex-start;flex-wrap:wrap}.build-row>.inline-actions{width:100%;padding-left:0}.site-picker-wrap select{max-width:130px}} + .theme-preview.trade-pro{background:linear-gradient(125deg,#0b3d91,#3d6dc1);color:#e8f1fb}.site-icon.trade-pro{background:#e8f1fb;color:#0b3d91} diff --git a/app/static/workspace.js b/app/static/workspace.js index 4c79288..e9b78a5 100644 --- a/app/static/workspace.js +++ b/app/static/workspace.js @@ -7,8 +7,8 @@ const typeName={page:'页面',product:'产品',vehicle:'车型',post:'新闻',br const fmtDate=t=>{if(!t)return '—';const d=new Date(t);return Number.isNaN(d.getTime())?String(t).slice(0,16):d.toLocaleDateString('zh-CN',{year:'numeric',month:'2-digit',day:'2-digit'})}; const sfSiteKey='siteforge:selected-site'; const sfRemember=id=>{try{if(id)localStorage.setItem(sfSiteKey,id)}catch{}}; -const state={sites:[],site:null,entries:[],builds:[],jobs:[],view:'home',csrf:'',search:'',typ:'',loading:false,job:null,selectionToken:0,building:false}; -const headings={home:'工作台',sites:'我的网站',overview:'网站概览',content:'内容与页面',design:'外观与设计',import:'导入与迁移',build:'构建与交付',settings:'网站设置'}; +const state={sites:[],site:null,entries:[],builds:[],jobs:[],view:'home',csrf:'',search:'',typ:'',loading:false,job:null,selectionToken:0,building:false,delivery:{jobs:[],history:[],configured:{}},language:{group:null,sites:[],units:[]},languageGroups:[],languageEntries:[]}; +const headings={home:'工作台',sites:'我的网站',overview:'网站概览',content:'内容与页面',design:'外观与设计',import:'导入与迁移',build:'构建与交付',languages:'多语言管理',settings:'网站设置'}; async function api(url,method='GET',data=null,extraHeaders={}){ const headers={...extraHeaders};if(method!=='GET'&&method!=='HEAD')headers['X-SiteForge-CSRF']=state.csrf; let body=data;if(data!=null && !(data instanceof FormData)){headers['Content-Type']='application/json';body=JSON.stringify(data)} @@ -86,28 +86,61 @@ function builds(){if(!currentSite())return noSite();const latest=latestDone();co (state.jobs.length?state.jobs.slice(0,8).map(j=>`
${j.state==='done'?'✓':j.state==='failed'?'!':'◷'}

${esc(buildStatusLabel(j.state))}

${esc(fmtDate(j.created_at))} · 任务 ${esc(j.id.slice(0,12))}${j.state==='failed'&&j.error?' · '+esc(j.error):''}

${['queued','running','retrying'].includes(j.state)?``:''}
`).join(''):'

当前网站还没有后台构建任务。

')+`
`+ `

构建版本

建议先预览和核对质量报告，再下载 ZIP。预览不代表正式发布。

`+ (state.builds.length?state.builds.slice(0,20).map(b=>`
${['done','completed','success','complete'].includes(b.status)?'✓':'◷'}

${esc(fmtDate(b.created_at))} · ${esc(b.total_pages||'—')} 个页面

版本 ${esc(b.id.slice(0,12))} · ${esc(b.status||'未知')}

${['done','completed','success','complete'].includes(b.status)?`预览 ↗下载 ZIP`:'尚未完成，暂不能下载'}
`).join(''):emptyState('尚无完成版本','准备好网站数据后，在上方提交构建任务。'))+ - `
`; + `
`+ + `

正式发布与回滚

先完成质量检查与独立审批，Worker 负责上传、校验和切换版本。没有配置目标服务器时不能发布。

审批与复核工具 ↗
+
+
+
+ +

最近发布任务

${(state.delivery.jobs||[]).length?state.delivery.jobs.slice(0,8).map(j=>`
${j.kind==='remote_rollback'?'回滚':'部署'} · ${esc(buildStatusLabel(j.state))}

${esc(j.id.slice(0,12))} · ${esc(j.created_at)}${j.error?' · '+esc(j.error):''}

${['queued','running','retrying'].includes(j.state)?``:''}
`).join(''):'

暂无发布任务。

'} +

已发布版本

${(state.delivery.history||[]).length?state.delivery.history.slice(0,8).map(r=>`
${esc(r.target)} · ${esc(r.release_id)}

构建 ${esc(r.build_id.slice(0,12))} · ${esc(r.deployed_at)}

`).join(''):'

当前没有远程部署记录。

'}
`; } function settings(){if(!currentSite())return noSite();const s=state.site;return htmlHeading('网站设置','这里只管理公司资料、域名与站点属性。网页样式请到“外观与设计”修改。')+ `

基本资料

没有域名也可以制作与预览网站，正式上线前再填写即可。

`; } +function languages(){ + if(!currentSite())return noSite(); + const d=state.language||{group:null,sites:[],units:[]};const g=d.group; + const groups=state.languageGroups||[]; + const header=htmlHeading('多语言管理','多个语言版本分别拥有独立的网站、域名和内容。系统只关联已审核的翻译，不会自动翻译企业事实。',''); + if(!g)return header+`

第一步 · 建立语言组

例如“集团全球网站”包含中文版、英文版、法文版。创建语言组后将网站加入对应语言。

`+ + (groups.length?`

加入已有语言组

仅可关联您有管理权限、且已配置独立 HTTPS 域名的网站。

`:'')+ + `
上线前提示：网站设置中的正式域名应为 https://example.com 形式；不同语言网站不能共用一个域名。当前域名：${esc(state.site.domain||'未设置')}
`; + const groupSites=d.sites||[]; const uniqueUnits=[...new Map((d.units||[]).map(u=>[u.id,u])).values()]; + const canJoin=state.sites.filter(x=>!groupSites.some(m=>m.site_id===x.id)); + return header+`

${esc(g.name)}

当前站语言 ${esc(g.locale)} · 默认语言 ${esc(g.default_locale)} · ${groupSites.length} 个语言站点

${groupSites.map(x=>``).join('')}
语言网站正式域名
${esc(x.locale)}${esc(x.name)}${esc(x.domain)}
`+ + `

第二步 · 添加其他语言网站

先通过“我的网站”创建另一语言站并设置 HTTPS 域名，再加入语言组。

`+ + `

第三步 · 建立翻译内容关系

相同产品、文章或页面可以使用不同 URL。用一个内容标识关联它们，只有正式发布且审核通过的内容才会生成 hreflang。

`+ + `

第四步 · 关联各语言的实际内容

`+ + `

已有语言关系

没有已审核的双向内容关系，就不会输出假语言链接。

${d.units.length?`
${d.units.map(u=>``).join('')}
内容组语言内容 / URL状态
${esc(u.reference_key)}${esc(u.locale)}${esc(u.title)}
${esc(u.route)}		${u.state==='approved'?'已审核':'待翻译'}
`:'

还没有关联内容。

'}
`; +} +async function loadLanguage(){const sid=state.site?.id;if(!sid)return;try{ + const [data,groups]=await Promise.all([api('/api/i18n/sites/'+encodeURIComponent(sid)),api('/api/i18n/groups')]); + if(state.site?.id!==sid)return;state.language=data;state.languageGroups=groups;await loadLanguageEntries(sid,false);if(state.view==='languages')rerender(); + }catch(e){notifyError(e)}} +async function loadLanguageEntries(siteId,redraw=true){if(!siteId)return;try{const rows=await api('/api/sites/'+encodeURIComponent(siteId)+'/entries');state.languageEntries=rows;if(redraw){const target=$('#langMemberEntry');if(target)target.innerHTML=rows.map(x=>``).join('')}}catch(e){notifyError(e);state.languageEntries=[]}} +async function submitLanguageGroup(ev){ev.preventDefault();if(!state.site)return;try{const d=Object.fromEntries(new FormData(ev.target));const locale=d.current_locale;delete d.current_locale;const group=await api('/api/i18n/groups','POST',d);await api('/api/i18n/groups/'+group.id+'/sites','POST',{site_id:state.site.id,locale});toast('语言组已创建');await loadLanguage()}catch(e){notifyError(e)}} +async function submitLanguageJoin(ev){ev.preventDefault();try{const d=Object.fromEntries(new FormData(ev.target));await api('/api/i18n/groups/'+d.group_id+'/sites','POST',{site_id:d.site_id||state.site.id,locale:d.locale});toast('语言站已关联');await loadLanguage()}catch(e){notifyError(e)}} +async function submitLanguageUnit(ev){ev.preventDefault();const d=Object.fromEntries(new FormData(ev.target));try{await api('/api/i18n/groups/'+state.language.group.group_id+'/units','POST',d);toast('翻译组已创建');await loadLanguage()}catch(e){notifyError(e)}} +async function submitLanguageLink(ev){ev.preventDefault();const d=Object.fromEntries(new FormData(ev.target));try{await api('/api/i18n/groups/'+state.language.group.group_id+'/units/'+encodeURIComponent(d.unit_id)+'/members','POST',{site_id:d.site_id,entry_id:d.entry_id,state:d.state});toast('内容翻译关系已保存');await loadLanguage()}catch(e){notifyError(e)}} function rerender(){const area=$('#mainContent');const selected=state.view;$('#breadcrumbTitle').textContent=headings[selected]||'工作台';$('#sideSiteName').textContent=state.site?.name||'请先选择网站'; document.querySelectorAll('[data-view].nav-item').forEach(el=>{const yes=el.dataset.view===selected;el.classList.toggle('active',yes);yes?el.setAttribute('aria-current','page'):el.removeAttribute('aria-current')}); - area.innerHTML=({home,sites,overview,content,design,import:imports,build:builds,settings}[selected]||home)(); + area.innerHTML=({home,sites,overview,content,design,import:imports,build:builds,languages,settings}[selected]||home)(); } async function loadSites(){state.sites=await api('/api/sites');const picker=$('#sitePicker'),prev=state.site?.id||'';picker.innerHTML=''+state.sites.map(s=>``).join('');picker.value=state.sites.some(s=>s.id===prev)?prev:''} +async function readDelivery(siteId){try{return await api(`/api/production/sites/${encodeURIComponent(siteId)}/delivery-status`)}catch(e){return {jobs:[],history:[],configured:{}}}} async function readJobs(siteId){try{return await api(`/api/enterprise/sites/${encodeURIComponent(siteId)}/jobs`)}catch(e){if(![403,404].includes(Number(e.status)))console.warn('加载任务状态失败',e);return []}} async function selectSite(id,go='overview',historyMode='push'){ const token=++state.selectionToken; - if(!id){state.site=null;state.entries=[];state.builds=[];state.jobs=[];state.job=null;state.view=go==='home'?'home':'sites';$('#sitePicker').value='';rerender();if(historyMode!=='none')rememberView(historyMode==='replace');return} + if(!id){state.site=null;state.entries=[];state.builds=[];state.jobs=[];state.delivery={jobs:[],history:[],configured:{}};state.job=null;state.view=go==='home'?'home':'sites';$('#sitePicker').value='';rerender();if(historyMode!=='none')rememberView(historyMode==='replace');return} if(!state.sites.some(x=>x.id===id)){toast('该网站不在您的可见列表中',true);return} - try{const [site,entries,builds,jobs]=await Promise.all([api(`/api/sites/${encodeURIComponent(id)}`),api(`/api/sites/${encodeURIComponent(id)}/entries`),api(`/api/sites/${encodeURIComponent(id)}/builds`),readJobs(id)]); + try{const [site,entries,builds,jobs,delivery]=await Promise.all([api(`/api/sites/${encodeURIComponent(id)}`),api(`/api/sites/${encodeURIComponent(id)}/entries`),api(`/api/sites/${encodeURIComponent(id)}/builds`),readJobs(id),readDelivery(id)]); if(token!==state.selectionToken)return; - state.site=site;sfRemember(id);state.entries=entries;state.builds=builds;state.jobs=jobs;state.job=null;state.view=go;state.search='';state.typ='';$('#sitePicker').value=id;rerender();if(historyMode!=='none')rememberView(historyMode==='replace');closeMobile();window.scrollTo({top:0,behavior:'instant'}); + state.site=site;sfRemember(id);state.entries=entries;state.builds=builds;state.jobs=jobs;state.delivery=delivery;state.job=null;state.view=go;state.search='';state.typ='';$('#sitePicker').value=id;rerender();if(historyMode!=='none')rememberView(historyMode==='replace');if(go==='languages')loadLanguage();closeMobile();window.scrollTo({top:0,behavior:'instant'}); }catch(e){if(token===state.selectionToken)notifyError(e)} } -function navigate(to,historyMode='push'){if(!state.site&&!['home','sites'].includes(to)){state.view='sites';rerender();toast('请先选择网站项目');return}state.view=to;rerender();closeMobile();if(historyMode!=='none')rememberView(historyMode==='replace');if(to==='build')refreshBuilds();window.scrollTo({top:0,behavior:'instant'})} -async function refreshBuilds(){const id=state.site?.id;if(!id)return;try{const previouslyRunning=activeJobs().length>0;const [jobs,builds]=await Promise.all([readJobs(id),api(`/api/sites/${encodeURIComponent(id)}/builds`)]);if(state.site?.id!==id)return;state.jobs=jobs;state.builds=builds;if(previouslyRunning&&!activeJobs().length){const last=jobs[0];state.job=last?.state==='done'?'后台构建已完成，请预览并查看质量报告。':last?.state==='failed'?'本次构建失败，请在任务中心检查原因。':last?.state==='cancelled'?'本次构建已取消。':null}if(state.view==='build')rerender()}catch(e){notifyError(e)}} +function navigate(to,historyMode='push'){if(!state.site&&!['home','sites'].includes(to)){state.view='sites';rerender();toast('请先选择网站项目');return}state.view=to;rerender();closeMobile();if(historyMode!=='none')rememberView(historyMode==='replace');if(to==='build')refreshBuilds();if(to==='languages')loadLanguage();window.scrollTo({top:0,behavior:'instant'})} +async function refreshBuilds(){const id=state.site?.id;if(!id)return;try{const previouslyRunning=activeJobs().length>0;const [jobs,builds,delivery]=await Promise.all([readJobs(id),api(`/api/sites/${encodeURIComponent(id)}/builds`),readDelivery(id)]);if(state.site?.id!==id)return;state.jobs=jobs;state.builds=builds;state.delivery=delivery;if(previouslyRunning&&!activeJobs().length){const last=jobs[0];state.job=last?.state==='done'?'后台构建已完成，请预览并查看质量报告。':last?.state==='failed'?'本次构建失败，请在任务中心检查原因。':last?.state==='cancelled'?'本次构建已取消。':null}if(state.view==='build')rerender()}catch(e){notifyError(e)}} function openModal(name){const node=$('#'+name);node.showModal();node.querySelector('input:not([type=hidden]),select')?.focus()} function closeModal(name){$('#'+name)?.close()} function openEntry(id){const form=$('#entryForm');form.reset();form.elements.entry_id.value='';$('#entryModalTitle').textContent=id?'修改内容':'添加内容';if(id){const e=state.entries.find(x=>x.id===id);if(!e)return toast('这条内容不存在',true);for(const field of ['title','route','summary','body','seo_title','seo_description','type','status']){if(form.elements[field])form.elements[field].value=e[field]||''}form.elements.entry_id.value=id}openModal('entryModal')} @@ -125,6 +158,12 @@ async function buildNow(){if(!state.site)return toast('请先选择网站',true) try{navigate('build');state.job='正在提交构建任务…';rerender();const job=await api(`/api/sites/${encodeURIComponent(id)}/builds`,'POST',{mirror_images:false},{'Idempotency-Key':crypto.randomUUID()}); if(state.site?.id!==id)return;state.job=`任务 ${job.id?.slice(0,12)||'已提交'} 已进入队列，可以离开页面；重新打开“构建与交付”查看结果。`;toast('已提交构建任务');await refreshBuilds(); }catch(e){notifyError(e)}finally{state.building=false;if(state.site?.id===id&&state.view==='build')rerender()}} +function selectedReleaseBuild(){const id=$('#deliveryBuild')?.value;if(!id)throw Error('没有可发布的构建版本，请先完成网站构建');return id} +function showDeliveryMessage(message){const el=$('#deliveryNotice');if(el){el.hidden=false;el.textContent=message}toast(message)} +async function releasePreflight(){if(!state.site)return;try{const id=selectedReleaseBuild(),s=state.site.id;const r=await api(`/api/production/sites/${encodeURIComponent(s)}/preflight/${encodeURIComponent(id)}`);if(state.site?.id!==s)return;showDeliveryMessage(r.ready?'已通过发布前置检查：'+r.message:'尚不能发布：'+r.message)}catch(e){notifyError(e)}} +async function releaseApproval(){if(!state.site)return;try{const id=selectedReleaseBuild(),s=state.site.id;const r=await api(`/api/factory/sites/${encodeURIComponent(s)}/release-requests`,'POST',{build_id:id});showDeliveryMessage('审批申请已创建，请由另一名有审核权限的人员批准。申请编号：'+r.id)}catch(e){notifyError(e)}} +async function releaseDeploy(){if(!state.site)return;try{const id=selectedReleaseBuild(),s=state.site.id,target=$('#deliveryTarget')?.value;if(!state.delivery.configured?.[target])throw Error('尚未配置此目标服务器，请管理员配置目标发布方式（Agent/SFTP/S3）、服务器凭据与 HTTPS 验证地址');if(!confirm(`确定将构建 ${id.slice(0,12)} 提交到${target==='production'?'正式':'测试'}环境吗？必须已有独立审批。`))return;const r=await api(`/api/production/sites/${encodeURIComponent(s)}/deploy`,'POST',{build_id:id,target},{'Idempotency-Key':crypto.randomUUID()});showDeliveryMessage(`发布任务 ${r.id} 已排队。Worker 会先暂存和校验，再激活新版本。`);await refreshBuilds()}catch(e){notifyError(e)}} +async function releaseRollback(target,release){if(!state.site)return;if(!confirm(`确定在 ${target} 环境恢复历史版本 ${release} 吗？请确认其内容仍符合当前业务要求。`))return;try{const r=await api(`/api/production/sites/${encodeURIComponent(state.site.id)}/rollback`,'POST',{target,release_id:release},{'Idempotency-Key':crypto.randomUUID()});showDeliveryMessage(`回滚任务 ${r.id} 已排队，请在任务列表查看结果。`);await refreshBuilds()}catch(e){notifyError(e)}} async function checkReadiness(){if(!state.site)return;const siteId=state.site.id; try{const result=await api(`/api/factory/sites/${encodeURIComponent(siteId)}/migration/readiness`); if(state.site?.id!==siteId)return; @@ -139,21 +178,21 @@ function closeMobile(){$('#sideMenu').classList.remove('open');$('#mobileBackdro async function init(){try{const me=await api('/api/auth/me');state.csrf=me.csrf;await loadSites();const health=await api('/api/health');$('#appVersion').textContent='版本 '+health.version; // Restore URL first, then a previously selected site *only* after verifying /api/sites. const params=new URLSearchParams(location.search),requested=params.get('site'); - const target=params.get('view');const allowed=new Set(['home','sites','overview','content','design','import','build','settings']); + const target=params.get('view');const allowed=new Set(['home','sites','overview','content','design','import','build','languages','settings']); let stored='';try{stored=localStorage.getItem(sfSiteKey)||''}catch{} const chosen=[requested,stored].find(id=>id&&state.sites.some(x=>x.id===id)); if(chosen){await selectSite(chosen,allowed.has(target)?target:'overview','replace')} else {state.view=target==='sites'?'sites':'home';rerender();rememberView(true)} }catch(e){notifyError(e);$('#mainContent').innerHTML=emptyState('后台加载失败',e.message,'')}} // Delegated UI interactions keep navigation and form actions centrally auditable. -document.addEventListener('click',async ev=>{const control=ev.target.closest('[data-action]');if(!control)return;const action=control.dataset.action;try{if(action==='navigate')navigate(control.dataset.view);if(action==='new-site')openModal('siteModal');if(action==='select-site')await selectSite(control.dataset.id);if(action==='new-entry')openEntry();if(action==='edit-entry')openEntry(control.dataset.id);if(action==='set-theme')await setTheme(control.dataset.theme);if(action==='build-now')await buildNow();if(action==='refresh-builds')await refreshBuilds();if(action==='check-readiness')await checkReadiness();if(action==='cancel-job')await cancelJob(control.dataset.id);if(action==='report')await showReport(control.dataset.id)}catch(e){notifyError(e)}}); +document.addEventListener('click',async ev=>{const control=ev.target.closest('[data-action]');if(!control)return;const action=control.dataset.action;try{if(action==='navigate')navigate(control.dataset.view);if(action==='language-refresh')await loadLanguage();if(action==='new-site')openModal('siteModal');if(action==='select-site')await selectSite(control.dataset.id);if(action==='new-entry')openEntry();if(action==='edit-entry')openEntry(control.dataset.id);if(action==='set-theme')await setTheme(control.dataset.theme);if(action==='build-now')await buildNow();if(action==='refresh-builds')await refreshBuilds();if(action==='check-readiness')await checkReadiness();if(action==='cancel-job')await cancelJob(control.dataset.id);if(action==='report')await showReport(control.dataset.id);if(action==='release-preflight')await releasePreflight();if(action==='release-approval')await releaseApproval();if(action==='release-deploy')await releaseDeploy();if(action==='release-rollback')await releaseRollback(control.dataset.target,control.dataset.id)}catch(e){notifyError(e)}}); document.addEventListener('click',ev=>{const btn=ev.target.closest('[data-close]');if(btn)closeModal(btn.dataset.close)}); $('#siteForm').addEventListener('submit',saveSite);$('#entryForm').addEventListener('submit',saveEntry); -document.addEventListener('submit',ev=>{if(ev.target.id==='settingsForm')saveSettings(ev);if(ev.target.id==='importForm')importFile(ev)}); +document.addEventListener('submit',ev=>{if(ev.target.id==='settingsForm')saveSettings(ev);if(ev.target.id==='importForm')importFile(ev);if(ev.target.id==='langGroupForm')submitLanguageGroup(ev);if(ev.target.id==='langJoinForm')submitLanguageJoin(ev);if(ev.target.id==='langUnitForm')submitLanguageUnit(ev);if(ev.target.id==='langLinkForm')submitLanguageLink(ev)}); document.addEventListener('input',ev=>{if(ev.target.id==='contentSearch'){state.search=ev.target.value;const cursor=ev.target.selectionStart;const type=state.typ;rerender();const el=$('#contentSearch');el.focus();el.setSelectionRange(cursor,cursor);state.typ=type}}); -document.addEventListener('change',ev=>{if(ev.target.id==='contentType'){state.typ=ev.target.value;rerender()}}); +document.addEventListener('change',ev=>{if(ev.target.id==='contentType'){state.typ=ev.target.value;rerender()}if(ev.target.id==='langMemberSite')loadLanguageEntries(ev.target.value)}); $('#sitePicker').addEventListener('change',ev=>selectSite(ev.target.value)); -window.addEventListener('popstate',async()=>{const p=new URLSearchParams(location.search);const site=p.get('site'),view=p.get('view')||'home';const allowed=['home','sites','overview','content','design','import','build','settings'];if(site&&state.sites.some(s=>s.id===site))await selectSite(site,allowed.includes(view)?view:'overview','none');else{state.selectionToken++;state.site=null;state.entries=[];state.jobs=[];state.builds=[];state.view=view==='sites'?'sites':'home';rerender()}}); +window.addEventListener('popstate',async()=>{const p=new URLSearchParams(location.search);const site=p.get('site'),view=p.get('view')||'home';const allowed=['home','sites','overview','content','design','import','build','languages','settings'];if(site&&state.sites.some(s=>s.id===site))await selectSite(site,allowed.includes(view)?view:'overview','none');else{state.selectionToken++;state.site=null;state.entries=[];state.jobs=[];state.builds=[];state.view=view==='sites'?'sites':'home';rerender()}}); setInterval(()=>{if(!document.hidden&&state.view==='build'&&activeJobs().length)refreshBuilds()},5000); $('#newSiteTop').addEventListener('click',()=>openModal('siteModal')); $('#logoutBtn').addEventListener('click',async()=>{try{await api('/api/auth/logout','POST');location.href='/login'}catch(e){notifyError(e)}}); diff --git a/app/studio_v86.py b/app/studio_v86.py index d1cb6ff..661482d 100644 --- a/app/studio_v86.py +++ b/app/studio_v86.py @@ -6,6 +6,7 @@ studio uses only /studio-draft endpoints; a build never consumes these drafts. from __future__ import annotations import hashlib import json +import uuid from fastapi import APIRouter, Body, HTTPException, Request from . import db, blueprints, enterprise from .core import save_entry @@ -24,6 +25,14 @@ def setup(): id TEXT PRIMARY KEY, site_id TEXT NOT NULL, entry_id TEXT NOT NULL, revision INTEGER NOT NULL, actor TEXT NOT NULL, published_at TEXT NOT NULL, blueprint_hash TEXT NOT NULL)''') + c.execute('''CREATE TABLE IF NOT EXISTS studio_history ( + id TEXT PRIMARY KEY,site_id TEXT NOT NULL REFERENCES sites(id) ON DELETE CASCADE, + entry_id TEXT NOT NULL REFERENCES entries(id) ON DELETE CASCADE, + revision INTEGER NOT NULL,kind TEXT NOT NULL, + snapshot_json TEXT NOT NULL,snapshot_hash TEXT NOT NULL, + actor TEXT NOT NULL,created_at TEXT NOT NULL)''') + c.execute('''CREATE INDEX IF NOT EXISTS idx_studio_history_site_page + ON studio_history(site_id,entry_id,created_at,revision)''') def _entry(site_id, entry_id): @@ -59,7 +68,7 @@ def read(site_id,entry_id): 'layout_mode':meta.get('layout_mode','append'),'revision':0,'conflict':False,'state':'published', 'entry':{'id':row['id'],'title':row['title'],'route':row['route']}} -def write(site_id,entry_id,payload): +def write(site_id,entry_id,payload,actor="system"): row=_entry(site_id,entry_id) plan=_validate(payload) # A draft is detached from the public entry. Only the final publish @@ -76,6 +85,7 @@ def write(site_id,entry_id,payload): ON CONFLICT(site_id,entry_id) DO UPDATE SET revision=excluded.revision, blueprint_json=excluded.blueprint_json,updated_at=excluded.updated_at''', (site_id,entry_id,next_rev,base,json.dumps(plan,ensure_ascii=False),db.now())) + _journal(c,site_id,entry_id,next_rev,'draft',plan,actor) return {'saved':True,'state':'draft','revision':next_rev,'published_unchanged':True} @@ -101,11 +111,69 @@ def publish(site_id,entry_id,expected_revision,actor): pid=uuid.uuid4().hex c.execute('INSERT INTO studio_publications VALUES (?,?,?,?,?,?,?)', (pid,site_id,entry_id,draft['revision'],actor,db.now(),hashlib.sha256(json.dumps(plan,sort_keys=True).encode()).hexdigest())) + _journal(c,site_id,entry_id,draft['revision'],'published',plan,actor) c.execute('DELETE FROM studio_drafts WHERE site_id=? AND entry_id=?',(site_id,entry_id)) return {'published':True,'publication_id':pid,'revision':draft['revision'], 'build_required':True,'message':'页面设计已发布到内容库；需要重新构建静态站点才会上线'} +def _journal(connection, site_id, entry_id, revision, kind, plan, actor): + # Store a complete, immutable validated snapshot; never executable user code. + canonical=json.dumps(plan,ensure_ascii=False,sort_keys=True,separators=(',',':')) + connection.execute('''INSERT INTO studio_history VALUES (?,?,?,?,?,?,?,?,?)''', + (uuid.uuid4().hex,site_id,entry_id,revision,kind,canonical, + hashlib.sha256(canonical.encode('utf-8')).hexdigest(),actor,db.now())) + + +def history(site_id,entry_id,limit=30): + _entry(site_id,entry_id) + if type(limit) is not int or not 1<=limit<=100:raise HTTPException(400,'历史条数必须为1-100') + rows=db.rows('''SELECT id,revision,kind,snapshot_hash,actor,created_at + FROM studio_history WHERE site_id=? AND entry_id=? + ORDER BY created_at DESC, revision DESC, id DESC LIMIT ?''',(site_id,entry_id,limit)) + return {'items':rows,'note':'历史记录不会直接修改已发布页面；恢复时只生成新的草稿修订'} + + +def history_snapshot(site_id,entry_id,history_id): + _entry(site_id,entry_id) + row=db.one('SELECT * FROM studio_history WHERE site_id=? AND entry_id=? AND id=?', + (site_id,entry_id,history_id)) + if not row:raise HTTPException(404,'历史记录不存在') + if hashlib.sha256(row['snapshot_json'].encode('utf-8')).hexdigest()!=row['snapshot_hash']: + raise HTTPException(409,'历史快照完整性校验失败，不允许恢复') + plan=_validate(json.loads(row['snapshot_json'])) + return {'id':row['id'],'revision':row['revision'],'kind':row['kind'], + 'snapshot_hash':row['snapshot_hash'],'plan':plan} + + +def restore_history(site_id,entry_id,history_id,expected_revision,actor): + if type(expected_revision) is not int:raise HTTPException(400,'必须指定当前草稿修订号') + previous=history_snapshot(site_id,entry_id,history_id) + # Optimistic revision is enforced by write(). Restore never directly alters + # published content and cannot bypass a conflicting published page. + plan={**previous['plan'],'expected_revision':expected_revision} + result=write(site_id,entry_id,plan,actor) + return {**result,'restored_from':history_id,'requires_publish':True} + + +@router.get('/{site_id}/pages/{entry_id}/studio-history') +def api_history(request:Request,site_id:str,entry_id:str,limit:int=30): + enterprise.require(request,site_id,'viewer') + return history(site_id,entry_id,limit) + + +@router.get('/{site_id}/pages/{entry_id}/studio-history/{history_id}') +def api_history_snapshot(request:Request,site_id:str,entry_id:str,history_id:str): + enterprise.require(request,site_id,'viewer') + return history_snapshot(site_id,entry_id,history_id) + + +@router.post('/{site_id}/pages/{entry_id}/studio-history/{history_id}/restore') +def api_history_restore(request:Request,site_id:str,entry_id:str,history_id:str,payload:dict=Body(...)): + enterprise.require(request,site_id,'editor') + return restore_history(site_id,entry_id,history_id,payload.get('expected_revision'),enterprise.actor(request)) + + @router.get('/{site_id}/pages/{entry_id}/studio-draft') def api_read(request:Request,site_id:str,entry_id:str): enterprise.require(request,site_id,'viewer') @@ -115,7 +183,7 @@ def api_read(request:Request,site_id:str,entry_id:str): @router.put('/{site_id}/pages/{entry_id}/studio-draft') def api_write(request:Request,site_id:str,entry_id:str,payload:dict=Body(...)): enterprise.require(request,site_id,'editor') - return write(site_id,entry_id,payload) + return write(site_id,entry_id,payload,enterprise.actor(request)) @router.post('/{site_id}/pages/{entry_id}/studio-draft/publish') diff --git a/app/templates/editor.html b/app/templates/editor.html index d2f84c7..37e47bf 100644 --- a/app/templates/editor.html +++ b/app/templates/editor.html @@ -1,27 +1,61 @@ -SiteForge Studio · 可视化建站 +SiteForge Studio · 可视化建站
-
-
◈
SiteForgeVISUAL STUDIO
-
加载中 / 页面编辑器
-
- 未修改 +
+
◈
SiteForge页面编辑
+
加载中页面编辑器
+
+
+ + + +
+ 读取中… + + +
更多 ▾
+ + + + + + + + +
+
只需 3 步
① 选择或添加区块→② 修改右侧内容→③ 保存并发布
-
+ +
新手指南

3 分钟学会编辑页面

+
  1. 先选页面

    左侧顶部切换要编辑的页面；选择现有内容区块，或点击橙色的“添加内容区块”。

  2. 修改内容

    在右侧“内容”里改标题、文案和图片；切换“样式”或“手机/平板”调整外观。中间自动展示效果。

  3. 保存草稿，再发布

    点击右上角“保存草稿”可以保留工作。核对后点击“发布设计”，它会更新内容库；正式网站还需要执行静态构建和部署。

+
撤销、版本历史、全站页眉、静态构建等低频功能在右上角「更多」。
+ +

全站设计规范

调整后保存并刷新预览，发布构建自动采用该规范。

 @@ -53,6 +87,15 @@ +
手机底部快捷导航 Tabs（可选） +

默认关闭。需要时开启后添加 1–5 个按钮。它们只显示在手机上，平板和电脑不显示。

+ + +
@@ -67,5 +110,11 @@
-
+ +

页面设计版本历史

+

保存草稿、发布设计都会创建不可变快照。恢复只写入新草稿，不会直接修改已发布站点。

+
+ + +
diff --git a/app/templates/login.html b/app/templates/login.html index 4e57b82..02bd183 100644 --- a/app/templates/login.html +++ b/app/templates/login.html @@ -1,5 +1,5 @@ 登录 · SiteForge 网站工厂
S✳

欢迎使用 SiteForge

登录网站生产工作台，管理网站、内容、主题和静态构建版本。

SiteForge Web · Factory 7.1.0
diff --git a/app/templates/operations.html b/app/templates/operations.html index 7bf1d1e..8340b84 100644 --- a/app/templates/operations.html +++ b/app/templates/operations.html @@ -5,6 +5,6 @@

01 · CMS 数据迁移

先预演，再写入网站数据库
选择文件后，预演将显示内容数量、URL 错误和复杂字段待复核事项。

02 · 导入风险复核

处理插件字段与内容关系；迁移站上线前必须清零
暂无待复核事项

复核人必须填写处理说明；仅更改记录状态不会自动修复旧站内容，请人工检查预览。

03 · 生产构建任务

由独立 Worker 处理

保存内容后提交任务。相同的构建请求会去重，构建可取消、重试或在超时后恢复。

打开网站编辑器 ↗
加载中…
-

04 · 构建质量与审批

分权审核发布

发布审批记录

05 · 远程发布

HTTPS 签名发布 Agent

仅能部署已审批、质量检查通过的构建；目标服务器地址由管理员提前设置，不能在这里随意填写。

已发布版本

暂无部署记录
+

04 · 构建质量与审批

分权审核发布

发布审批记录

05 · 远程发布

Agent / SFTP / S3

只能部署已审批且质量检查通过的构建；发布方式由管理员预先配置，S3 需指针感知的 HTTPS 网关。

读取发布目标配置…

已发布版本与回滚

暂无部署记录
企业运行与迁移中心 · 第三方 CMS 复杂插件、PostgreSQL/Redis 和公网部署应分别完成真实环境验收。
diff --git a/app/templates/production-v8.html b/app/templates/production-v8.html index 1bdd79e..4043afd 100644 --- a/app/templates/production-v8.html +++ b/app/templates/production-v8.html @@ -4,7 +4,7 @@ [hidden]{display:none!important}.tool-switch{display:flex;flex-wrap:wrap;gap:9px;background:#fff;padding:12px;margin:18px 0 0;border-radius:12px;border:1px solid #e1e8f1}.tool-btn{background:#f6f8fc;color:#50627c;border-color:transparent;padding:11px 14px}.tool-btn.active{background:#e8f0ff;color:#174ea7;border:1px solid #a5c5f5}.tool-help{font-size:12px;color:#64748b;margin:12px 5px 16px}.advanced-layout{grid-template-columns:minmax(0,1fr)}.advanced-layout>.panel{width:100%}.nav a:first-child{border:1px solid #7793bd;padding:9px 11px;border-radius:7px;background:#fff1}@media(max-width:720px){.tool-switch{gap:5px}.tool-btn{padding:9px 11px}} -

SiteForge · 网站生产控制台 V8.11 · 高级工具

整站模板 · 数据批次导入 · 可审计回滚 · 静态构建
返回网站工作台页面编辑器主题中心任务中心
+

SiteForge · 网站生产控制台 V8.21 · 高级工具

整站模板 · 数据批次导入 · 可审计回滚 · 静态构建
返回网站工作台页面编辑器主题中心任务中心

选择要操作的网站

所有批次、模板和构建记录均按网站隔离；新网站可先在网站工作台创建。
当前网站—
内容记录—
导入批次—
@@ -51,6 +51,11 @@ +
+
+ +
+ 
上传有权迁移的 WordPress WXR 文件，可检查路径冲突、复杂字段和动态功能。预检不等于迁移完成。
选择站点并新建迁移会话。每页请求独立保存检查点；采集完成后可明确审核 URL、SEO、缺失内容。
@@ -128,6 +133,7 @@ $('preflight').onclick=()=>applyTemplate(false);$('apply').onclick=()=>applyTemp $('build').onclick=async()=>{try{show('buildResult',await api(`/api/sites/${current()}/builds`,'POST',{mirror_images:false}))}catch(e){show('buildResult','错误：'+e.message)}}; async function loadWpSessions(){try{if(!current())return;const result=await api(`/api/migrations/sites/${current()}/wordpress/sessions`);const select=$('wpSession');const chosen=select.value;select.replaceChildren(...result.items.map(s=>opt(s.id,`${s.origin} · ${s.state} · ${s.fetched} 条`)));if(result.items.some(s=>s.id===chosen))select.value=chosen;if(select.value){const item=await api(`/api/migrations/sites/${current()}/wordpress/sessions/${select.value}`);show('wpResult',item)}}catch(e){show('wpResult','查询错误：'+e.message)}} async function wpAction(action){const sid=$('wpSession').value;if(!sid)throw Error('请先创建迁移会话');return api(`/api/migrations/sites/${current()}/wordpress/sessions/${sid}/${action}`,'POST',{})} +$('wpPreflight').onclick=async()=>{try{if(!current())throw Error('请先选择网站');const file=$('wpPreflightFile').files[0];if(!file)throw Error('请选择 WordPress WXR XML 文件');const form=new FormData();form.append('file',file);const result=await api(`/api/migrations/sites/${current()}/wordpress/wxr-preflight`,'POST',form);show('wpPreflightResult',result)}catch(e){show('wpPreflightResult','兼容性预检失败：'+e.message)}}; $('wpCreate').onclick=async()=>{try{const data=await api(`/api/migrations/sites/${current()}/wordpress/sessions`,'POST',{origin:$('wpOrigin').value,max_items:Number($('wpLimit').value)});await loadWpSessions();$('wpSession').value=data.id;show('wpResult',data)}catch(e){show('wpResult','错误：'+e.message)}}; let wpAutoRunning=false; $('wpAuto').onclick=async()=>{if(wpAutoRunning)return;wpAutoRunning=true;let count=0;try{while(wpAutoRunning&&count<200){const r=await wpAction('advance');show('wpResult',r);count++;if(['ready','completed','cancelled','limit_reached'].includes(r.state))break;await new Promise(done=>setTimeout(done,350))}await loadWpSessions()}catch(e){show('wpResult','暂停：'+e.message)}finally{wpAutoRunning=false}}; diff --git a/app/templates/workspace.html b/app/templates/workspace.html index be67c9f..a08dd11 100644 --- a/app/templates/workspace.html +++ b/app/templates/workspace.html @@ -16,6 +16,7 @@ +
⌘高级工具 ⌄ diff --git a/app/theme_pro.py b/app/theme_pro.py index cd2f16e..49c30e1 100644 --- a/app/theme_pro.py +++ b/app/theme_pro.py @@ -16,15 +16,15 @@ from markupsafe import Markup from .core import sanitize, route_path, THEMES ROOT=Path(__file__).resolve().parent.parent +LOADER=Environment(loader=FileSystemLoader(str(ROOT/'themes')),autoescape=select_autoescape(['html','xml'])) + _ENVS={} def env_for(theme): """Per-theme Jinja env: theme dir first, shared themes/ root as fallback. Lets a theme override shared macros (_professional_components.html) while - inheriting everything else. Cached: one env per theme across large builds. - Only built-in theme names are accepted; callers are expected to enforce the - THEMES whitelist too (render does), this is defense in depth. + inheriting everything else. Cached per theme; degraded envs are not cached. """ if theme not in THEMES:raise ValueError('未知主题') env=_ENVS.get(theme) @@ -33,7 +33,7 @@ def env_for(theme): canonical=theme_dir.is_dir() search=[str(theme_dir),str(ROOT/'themes')] if canonical else [str(ROOT/'themes')] env=Environment(loader=FileSystemLoader(search),autoescape=select_autoescape(['html','xml'])) - if canonical:_ENVS[theme]=env # degraded envs are not cached + if canonical:_ENVS[theme]=env return env TITLES={'product':'产品中心','vehicle':'车型中心','post':'新闻资讯','case':'项目案例','brand':'品牌中心','service':'服务与解决方案'} @@ -189,6 +189,7 @@ def make_context(site,page,records,mode='detail',listing_items=None,prepared=Non 'features':groups['service'][:3], 'stories':groups['post'][:3], 'cases':groups['case'][:3], 'brands':assets['brands'],'categories':assets['categories'], 'nav':nav, 'chrome':chrome,'chrome_is_custom':bool(settings.get('site_design')), + 'mobile_tab_icons':{'home':'⌂','grid':'▦','products':'▤','news':'☷','contact':'✉','phone':'☎','info':'ⓘ','search':'⌕','menu':'☰','star':'☆'}, 'footer_nav':nav if chrome['footer']['show_nav'] else [],'specs':spec, 'related':related,'fields':detail_fields,'content':Markup(sanitize(pg.get('body') or '')), 'title':title, 'seo_title':pg.get('seo_title') or title,'seo_description':pg.get('seo_description') or pg.get('summary') or site.get('tagline') or '', diff --git a/app/theme_store.py b/app/theme_store.py index 6536327..3be3a1e 100644 --- a/app/theme_store.py +++ b/app/theme_store.py @@ -8,10 +8,10 @@ from __future__ import annotations import io, json, re, zipfile, shutil from pathlib import Path from . import db -from .core import THEMES as BUILTIN BASE=Path(__file__).resolve().parent.parent/'themes' THEME_ROOT=db.DATA/'theme_packages' +from .core import THEMES as BUILTIN THEME_ID=re.compile(r'^[a-z][a-z0-9-]{2,39}$') VERSION=re.compile(r'^\d+\.\d+\.\d+$') diff --git a/app/v8_workflows.py b/app/v8_workflows.py index cd1acb3..81ff642 100644 --- a/app/v8_workflows.py +++ b/app/v8_workflows.py @@ -192,6 +192,13 @@ def parse_wxr(content): if len(content)>MAX_UPLOAD:raise ValueError('XML 文件超过限制') root=ET.fromstring(content) if root.tag!='rss':raise ValueError('这不是 WordPress WXR RSS 导出') + # Stage only unambiguous permanent paths; dynamic functions remain review items. + from .wp_complex_v820 import inspect_wxr + checks=inspect_wxr(content) + blockers=[x for x in checks['issues'] if x['code'] in ('invalid_permalink','duplicate_route')] + if blockers or (checks['findings_truncated'] and checks['blocking_issues']): + raise ValueError('存在不能安全映射的 WordPress URL，请先运行 V8.20 WXR 预检并修正：'+ + ', '.join(x['code']+':'+x['route'] for x in blockers[:5])) rows=[];ids=[];warnings=[] for it in root.findall('./channel/item'): get=lambda name:next((str(node.text or '') for node in it if node.tag.endswith('}'+name) or node.tag==name),'') @@ -216,12 +223,23 @@ def parse_wxr(content): if k:metas[k]=v[:10000] if any(k in metas for k in ('_elementor_data','_product_attributes')): warnings.append({'row':len(rows)+1,'issue':'含复杂 Elementor/WooCommerce 组件，导入后需人工核对'}) - rows.append({'标题':title,'路径':route,'正文':get('encoded'), + rows.append({'标题':title,'路径':route,'正文':get('encoded'),'类型':raw_typ, + 'SEO标题':metas.get('_yoast_wpseo_title') or metas.get('rank_math_title',''), 'SEO描述':metas.get('_yoast_wpseo_metadesc') or metas.get('rank_math_description',''), '分类':raw_typ}) ids.append(f'wordpress:{wid}' if wid else f'wordpress:path:{route}') - return rows,ids,warnings + for finding in checks['issues']: + if finding['severity'] not in ('review','blocker'):continue + if finding['code'] in ('invalid_permalink','duplicate_route'):continue + route=finding['route'] + index=next((i+1 for i,row in enumerate(rows) if row['路径']==route),0) + if index: + if finding['code'].startswith('elementor') and any(w.get('row')==index and 'Elementor' in w.get('issue','') for w in warnings): + continue + warnings.append({'row':index,'issue':finding['code']+': '+finding['message']}) + # Bound warnings written into batch metadata and shown for human review. + return rows,ids,warnings[:200] @router.post('/{site_id}/staging') def api_stage(request:Request,site_id:str,payload:dict=Body(...)): diff --git a/app/version.py b/app/version.py index 8daa9d3..f995492 100644 --- a/app/version.py +++ b/app/version.py @@ -1,5 +1,5 @@ """Single source of truth for the SiteForge platform release identity.""" import os -VERSION = "8.12.0-dev.1" +VERSION = "8.21.3-dev.1" PLATFORM_NAME = "SiteForge Factory" BUILD_SHA = os.environ.get("SITEFORGE_GIT_SHA", "unknown").strip()[:40] or "unknown" diff --git a/app/worker.py b/app/worker.py index 70203de..48bd122 100644 --- a/app/worker.py +++ b/app/worker.py @@ -6,7 +6,7 @@ import subprocess import sys import time import uuid -from . import db, enterprise, builder, jobs +from . import db, enterprise, builder, jobs, worker_health running=True WORKER_ID=uuid.uuid4().hex[:12] @@ -17,7 +17,7 @@ def heartbeat(): This single-worker probe is deliberately not used as a multi-worker membership system; multi-worker orchestration needs separate leases. """ - path=db.DATA/'worker-heartbeat' + path=worker_health.heartbeat_path() path.parent.mkdir(parents=True,exist_ok=True) temp=path.with_suffix(f'.{WORKER_ID}.tmp') temp.write_text(WORKER_ID,encoding='ascii') @@ -49,11 +49,17 @@ def complete(job, value=None, error=None, retryable=False, cancelled=False, time current=c.execute('SELECT * FROM build_jobs WHERE id=?',(job['id'],)).fetchone() if not current or current['state']!='running' or current['worker_id']!=WORKER_ID: return + # A networked release may already have changed the remote pointer. + # Cancellation/timeout/crash is UNKNOWN remote outcome, not safe retry. + external=current['kind'] in ('remote_deploy','remote_rollback') if cancelled or current['cancel_requested']: - state='cancelled' + if external: + state='failed' + error='Release interrupted; reconcile target before manual retry' + else:state='cancelled' elif error is None: state='done' - elif retryable and current['attempts']MAX_META:raise ValueError('单篇文章元数据字段超过安全上限') + return result,duplicate[:30] + + +def extract_acf(meta): + """Bounded, literal ACF postmeta extraction. Never PHP-unserialize or infer field schema. + + Can safely represent flat fields and simple `repeater_0_subfield` records. + Repeater field types are not guaranteed by the exported meta alone. + """ + if len(meta)>MAX_META:raise ValueError('ACF meta exceeds safety limit') + scalar={};repeaters={};warnings=[] + referenced={k[1:] for k,v in meta.items() if k.startswith('_') and isinstance(v,str) and v.startswith('field_')} + for key in sorted(referenced): + if not key or key not in meta:continue + value=meta[key] + if not isinstance(value,str):continue + if SERIALIZED.match(value.strip()): + warnings.append(f'ACF 字段 {key[:75]} 含 PHP 序列化结构，未进行反序列化') + continue + if len(value.encode('utf-8'))>10_000: + warnings.append(f'ACF 字段 {key[:75]} 超出单值安全上限') + continue + match=re.fullmatch(r'(.{1,80})_(\d{1,2})_([A-Za-z][A-Za-z0-9_]*)',key) + if match: + group,index,field=match.group(1),int(match.group(2)),match.group(3) + if index>=50:continue + repeaters.setdefault(group,{}).setdefault(index,{})[field]=value + elif re.fullmatch(r'[A-Za-z][A-Za-z0-9_]{0,100}',key): + scalar[key]=value + result={} + for group,values in sorted(repeaters.items()): + count=meta.get(group) + if not (isinstance(count,str) and count.isdigit() and 1<=int(count)<=50): + warnings.append(f'ACF 类重复字段 {group} 缺少有效行数，保留原始键供人工核对') + continue + expected=int(count) + if any(i>=expected for i in values): + warnings.append(f'ACF 类重复字段 {group} 存在超出声明行数的字段') + # Only expose a complete contiguous set. Partial repeaters remain metadata-only. + if any(i not in values for i in range(expected)): + warnings.append(f'ACF 类重复字段 {group} 行不连续，必须人工复核') + continue + if sum(len(x) for x in values.values())>1500: + warnings.append(f'ACF 类重复字段 {group} 子字段超出安全上限') + continue + result[group]=[values[i] for i in range(expected)] + if repeaters: + warnings.append('ACF Repeater 由字段命名模式推断；必须与源站字段组定义核对') + return {'fields':scalar,'repeaters':result,'warnings':list(dict.fromkeys(warnings))[:80]} + + +def inspect_wxr(data:bytes): + if not data or len(data)>MAX_XML:raise ValueError('WXR 必须非空且不超过 16 MB') + root=SafeET.fromstring(data) + if root.tag.rsplit('}',1)[-1]!='rss':raise ValueError('需要 WordPress WXR RSS XML') + items=root.findall('./channel/item') + if not items:raise ValueError('WXR 缺少 channel/item 记录') + if len(items)>MAX_ITEMS:raise ValueError('WXR 超过 20000 条记录上限') + counts=Counter();issues=[];routes={};features=Counter();example=[];hosts=set() + def issue(severity,code,wp_id,message,route=''): + counts['findings_'+severity]+=1 + if len(issues)10:break + if meta.get('_elementor_data'): + features['elementor']+=1 + result=wordpress_compat.elementor_to_html(meta['_elementor_data']) + if result['warnings']: + issue('review','elementor',wp_id,'Elementor 非无损转换：'+result['warnings'][0],route) + else:issue('review','elementor_layout',wp_id,'Elementor 样式、容器、响应式布局需要视觉对照验收',route) + body=next((e.text or '' for e in node if e.tag.startswith('{http://purl.org/rss/1.0/modules/content/}') and e.tag.endswith('encoded')),'') + s=BeautifulSoup(body,'html.parser') + if SHORTCODE.search(body): + features['dynamic_shortcodes']+=1 + issue('blocker','dynamic_shortcode',wp_id,'存在动态短代码，纯静态导出不能提供同等业务行为',route) + if s.select('form,iframe'): + features['dynamic_html']+=1 + issue('review','dynamic_html',wp_id,'表单或 iframe 需单独确认服务、第三方依赖与可用性',route) + if any(n.get('src','').startswith(('http://','https://')) for n in s.select('img[src]')): + features['external_images']+=1 + issue('review','external_media',wp_id,'正文使用远程图片；需执行本地化及完整性对账',route) + if kind not in ('post','page','product','service','case','brand','vehicle'): + features['custom_post_types']+=1 + issue('review','custom_post_type',wp_id,'自定义文章类型 '+kind[:60]+' 将映射 other；模板/字段关系需人工确认',route) + blocked=counts['findings_blocker'] + from .version import VERSION + return {'version':VERSION,'input_bytes':len(data),'counts':dict(counts), + 'unique_published_routes':len(routes),'features':dict(features), + 'issues':issues,'findings_truncated':sum(v for k,v in counts.items() if k.startswith('findings_'))>len(issues), + 'sample_routes':example,'source_hosts':sorted(hosts),'ready_for_automatic_publish':False, + 'blocking_issues':blocked, + 'note':'仅离线识别兼容性与风险；预检不改动站点、不执行 PHP，不构成 1:1 迁移验收。'} + + +@router.post('/{site_id}/wordpress/wxr-preflight') +async def wxr_preflight(request:Request,site_id:str,file:UploadFile=File(...)): + enterprise.require(request,site_id,'editor') + data=await file.read(MAX_XML+1) + try:return inspect_wxr(data) + except (ValueError,SafeET.ParseError) as exc:raise HTTPException(400,str(exc)) diff --git a/app/wp_migration_v82.py b/app/wp_migration_v82.py index d391102..340982f 100644 --- a/app/wp_migration_v82.py +++ b/app/wp_migration_v82.py @@ -3,6 +3,7 @@ and durable worker-backed REST scanning. All flows require explicit authorizatio and remain subject to the existing SiteForge release-review gates. """ from __future__ import annotations +import re import hashlib import json import uuid @@ -160,15 +161,36 @@ def _srcset_urls(value): return result +# CSS background images are common in Elementor containers and ACF galleries. +# Restrict to syntactically explicit remote URLs, never evaluate arbitrary CSS. +CSS_URL = re.compile(r'''url\(\s*([\"\']?)((?:https?:)?//[^\"\')\s]+)\1\s*\)''', re.I) + + +def _css_urls(raw): + return [match.group(2) for match in CSS_URL.finditer(str(raw or ''))] + + +def _rewrite_css_urls(raw,converted): + def replace(match): + url=match.group(2) + if url not in converted:return match.group(0) + quote=match.group(1) + return f'url({quote}{converted[url]}{quote})' + updated=CSS_URL.sub(replace,str(raw or '')) + return updated,updated!=str(raw or '') + + def _media_urls(content): - """Collect all remote media references, including responsive and lazy images.""" + """Collect images plus responsive/lazy/CSS backgrounds for explicit review.""" urls=[content.get('cover') or ''] soup=BeautifulSoup(content.get('body') or '','html.parser') - for tag in soup.find_all(['img','source','video']): - for key in ('src','data-src','poster'): + for tag in soup.find_all(True): + for key in ('src','data-src','poster','data-background','data-background-image'): if tag.get(key):urls.append(tag[key]) for key in ('srcset','data-srcset'): urls.extend(_srcset_urls(tag.get(key))) + if tag.get('style'):urls.extend(_css_urls(tag['style'])) + if tag.name=='style':urls.extend(_css_urls(tag.get_text())) return list(dict.fromkeys(u for u in urls if isinstance(u,str) and u.startswith(('https://','http://','//')))) @@ -187,8 +209,8 @@ def _rewrite_srcset(value,converted): def _rewrite_media_html(body,converted): soup=BeautifulSoup(body,'html.parser');changed=False - for tag in soup.find_all(['img','source','video']): - for key in ('src','data-src','poster'): + for tag in soup.find_all(True): + for key in ('src','data-src','poster','data-background','data-background-image'): if tag.get(key) in converted: tag[key]=converted[tag[key]];changed=True for key in ('srcset','data-srcset'): @@ -196,11 +218,16 @@ def _rewrite_media_html(body,converted): new,updated=_rewrite_srcset(tag[key],converted) if updated: tag[key]=new;changed=True - # A single redundant srcset has no value and can be removed. if tag.name=='img' and key=='srcset' and len(new.split(','))==1: fields=new.strip().split() if fields and fields[0]==tag.get('src'): tag.attrs.pop(key,None) + if tag.get('style'): + value,updated=_rewrite_css_urls(tag['style'],converted) + if updated:tag['style']=value;changed=True + if tag.name=='style': + value,updated=_rewrite_css_urls(tag.string if tag.string is not None else tag.get_text(),converted) + if updated:tag.string=value;changed=True return str(soup) if changed else body,changed diff --git a/compose.agent-secrets.example.yaml b/compose.agent-secrets.example.yaml new file mode 100644 index 0000000..4abfb0a --- /dev/null +++ b/compose.agent-secrets.example.yaml @@ -0,0 +1,5 @@ +# Run on the isolated remote Agent host; never commit ./private-secrets. +services: + agent: + volumes: + - ./private-secrets:/run/secrets:ro diff --git a/compose.enterprise.yaml b/compose.enterprise.yaml index 76b6a5c..f886952 100644 --- a/compose.enterprise.yaml +++ b/compose.enterprise.yaml @@ -1,4 +1,4 @@ -name: siteforge-v8-12-enterprise +name: siteforge-v8-18-enterprise services: siteforge: build: @@ -6,7 +6,7 @@ services: dockerfile: Dockerfile.enterprise args: SITEFORGE_GIT_SHA: ${SITEFORGE_GIT_SHA:-unknown} - image: siteforge/web:8.12.0-dev.1 + image: siteforge/web:8.21.3-dev.1 init: true restart: unless-stopped ports: @@ -42,13 +42,13 @@ services: cap_drop: [ALL] security_opt: ['no-new-privileges:true'] healthcheck: - test: ['CMD','python','-c',"import urllib.request; urllib.request.urlopen('http://127.0.0.1:8787/api/health',timeout=3)"] + test: ['CMD','python','-c',"import urllib.request; urllib.request.urlopen('http://127.0.0.1:8787/api/ready',timeout=3)"] interval: 30s timeout: 5s retries: 3 start_period: 30s worker: - image: siteforge/web:8.12.0-dev.1 + image: siteforge/web:8.21.3-dev.1 command: ['python','-m','app.worker'] init: true restart: unless-stopped @@ -64,6 +64,12 @@ services: SITEFORGE_MYSQL_READ_PASSWORD: ${SITEFORGE_MYSQL_READ_PASSWORD:-} SITEFORGE_DATABASE_URL: postgresql://${SITEFORGE_PG_USER:-siteforge}:${SITEFORGE_PG_PASSWORD:?Set PG password}@postgres:5432/${SITEFORGE_PG_DB:-siteforge} SITEFORGE_REDIS_URL: redis://redis:6379/0 + SITEFORGE_DEPLOY_STAGING_URL: ${SITEFORGE_DEPLOY_STAGING_URL:-} + SITEFORGE_DEPLOY_STAGING_SECRET_REF: ${SITEFORGE_DEPLOY_STAGING_SECRET_REF:-} + SITEFORGE_DEPLOY_PRODUCTION_URL: ${SITEFORGE_DEPLOY_PRODUCTION_URL:-} + SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF: ${SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF:-} + SITEFORGE_STAGING_TOKEN: ${SITEFORGE_STAGING_TOKEN:-} + SITEFORGE_PRODUCTION_TOKEN: ${SITEFORGE_PRODUCTION_TOKEN:-} SITEFORGE_BUILD_TIMEOUT_SECONDS: ${SITEFORGE_BUILD_TIMEOUT_SECONDS:-300} SITEFORGE_BUILD_MAX_ATTEMPTS: ${SITEFORGE_BUILD_MAX_ATTEMPTS:-3} depends_on: diff --git a/compose.publish-targets.example.yaml b/compose.publish-targets.example.yaml new file mode 100644 index 0000000..01b0a07 --- /dev/null +++ b/compose.publish-targets.example.yaml @@ -0,0 +1,40 @@ +# Example only: enable with docker compose -f compose.yaml -f compose.publish-targets.example.yaml up -d --build +# Web receives metadata/config; private keys and IAM credentials are used ONLY by worker. +services: + siteforge: + environment: + SITEFORGE_DEPLOY_STAGING_TYPE: sftp + SITEFORGE_DEPLOY_STAGING_HOST: ${SITEFORGE_STAGING_SFTP_HOST:?Provide authorized host} + SITEFORGE_DEPLOY_STAGING_PORT: "${SITEFORGE_STAGING_SFTP_PORT:-22}" + SITEFORGE_DEPLOY_STAGING_USERNAME: ${SITEFORGE_STAGING_SFTP_USER:?Provide publisher account} + SITEFORGE_DEPLOY_STAGING_REMOTE_ROOT: ${SITEFORGE_STAGING_REMOTE_ROOT:-/srv/siteforge/sites} + SITEFORGE_DEPLOY_STAGING_KNOWN_HOSTS_FILE: /run/secrets/siteforge_known_hosts + SITEFORGE_DEPLOY_STAGING_SSH_KEY_FILE: /run/secrets/siteforge_publish_key + SITEFORGE_DEPLOY_STAGING_PUBLIC_URL: ${SITEFORGE_STAGING_PUBLIC_URL:?Set HTTPS public site URL} + SITEFORGE_DEPLOY_PRODUCTION_TYPE: s3 + SITEFORGE_DEPLOY_PRODUCTION_BUCKET: ${SITEFORGE_PRODUCTION_S3_BUCKET:?Set bucket} + SITEFORGE_DEPLOY_PRODUCTION_REGION: ${SITEFORGE_PRODUCTION_S3_REGION:?Set AWS region} + SITEFORGE_DEPLOY_PRODUCTION_PREFIX: ${SITEFORGE_PRODUCTION_S3_PREFIX:-siteforge} + SITEFORGE_DEPLOY_PRODUCTION_POINTER_AWARE: "1" + SITEFORGE_DEPLOY_PRODUCTION_PUBLIC_URL: ${SITEFORGE_PRODUCTION_PUBLIC_URL:?Set pointer-aware gateway HTTPS URL} + worker: + environment: + SITEFORGE_DEPLOY_STAGING_TYPE: sftp + SITEFORGE_DEPLOY_STAGING_HOST: ${SITEFORGE_STAGING_SFTP_HOST:?Provide authorized host} + SITEFORGE_DEPLOY_STAGING_PORT: "${SITEFORGE_STAGING_SFTP_PORT:-22}" + SITEFORGE_DEPLOY_STAGING_USERNAME: ${SITEFORGE_STAGING_SFTP_USER:?Provide publisher account} + SITEFORGE_DEPLOY_STAGING_REMOTE_ROOT: ${SITEFORGE_STAGING_REMOTE_ROOT:-/srv/siteforge/sites} + SITEFORGE_DEPLOY_STAGING_KNOWN_HOSTS_FILE: /run/secrets/siteforge_known_hosts + SITEFORGE_DEPLOY_STAGING_SSH_KEY_FILE: /run/secrets/siteforge_publish_key + SITEFORGE_DEPLOY_STAGING_PUBLIC_URL: ${SITEFORGE_STAGING_PUBLIC_URL:?Set HTTPS public site URL} + SITEFORGE_DEPLOY_PRODUCTION_TYPE: s3 + SITEFORGE_DEPLOY_PRODUCTION_BUCKET: ${SITEFORGE_PRODUCTION_S3_BUCKET:?Set bucket} + SITEFORGE_DEPLOY_PRODUCTION_REGION: ${SITEFORGE_PRODUCTION_S3_REGION:?Set AWS region} + SITEFORGE_DEPLOY_PRODUCTION_PREFIX: ${SITEFORGE_PRODUCTION_S3_PREFIX:-siteforge} + SITEFORGE_DEPLOY_PRODUCTION_POINTER_AWARE: "1" + SITEFORGE_DEPLOY_PRODUCTION_PUBLIC_URL: ${SITEFORGE_PRODUCTION_PUBLIC_URL:?Set pointer-aware gateway HTTPS URL} + AWS_REGION: ${SITEFORGE_PRODUCTION_S3_REGION:?Set AWS region} + # Prefer IAM instance/service role; never put AWS static keys into .env. + volumes: + - ./secrets/publish_known_hosts:/run/secrets/siteforge_known_hosts:ro + - ./secrets/publish_key:/run/secrets/siteforge_publish_key:ro diff --git a/compose.release-agent.yaml b/compose.release-agent.yaml index 1833b2a..192a2a4 100644 --- a/compose.release-agent.yaml +++ b/compose.release-agent.yaml @@ -6,11 +6,12 @@ services: dockerfile: Dockerfile.enterprise args: SITEFORGE_GIT_SHA: ${SITEFORGE_GIT_SHA:-unknown} - image: siteforge/web:8.12.0-dev.1 + image: siteforge/web:8.21.0-dev.1 command: ['python','-m','uvicorn','app.deploy_agent:app','--host','0.0.0.0','--port','8790'] restart: unless-stopped environment: - SITEFORGE_DEPLOY_SECRET: ${SITEFORGE_DEPLOY_SECRET:?Set 32+ character release secret} + SITEFORGE_DEPLOY_SECRET: ${SITEFORGE_DEPLOY_SECRET:-} + SITEFORGE_DEPLOY_SECRET_REF: ${SITEFORGE_DEPLOY_SECRET_REF:-} SITEFORGE_DEPLOY_ROOT: /srv/releases volumes: - releases:/srv/releases diff --git a/compose.release-secrets.example.yaml b/compose.release-secrets.example.yaml new file mode 100644 index 0000000..6a3cfbd --- /dev/null +++ b/compose.release-secrets.example.yaml @@ -0,0 +1,6 @@ +# OPTIONAL deployment overlay; copy/rename and adjust paths under local administrator control. +# WARNING: Do not place private keys or real tokens in this repository. +services: + worker: + volumes: + - ./private-secrets:/run/secrets:ro diff --git a/compose.s3-gateway.example.yaml b/compose.s3-gateway.example.yaml new file mode 100644 index 0000000..60c28d0 --- /dev/null +++ b/compose.s3-gateway.example.yaml @@ -0,0 +1,27 @@ +# Deploy separately behind a proper TLS proxy. No publication credentials. +# Example: docker compose -f compose.yaml -f compose.s3-gateway.example.yaml up -d --build +services: + s3-site-gateway: + image: siteforge/web:8.21.0-dev.1 + depends_on: + siteforge: {condition: service_started} + command: ["python", "-m", "uvicorn", "app.s3_gateway:app", "--host", "0.0.0.0", "--port", "8791"] + restart: unless-stopped + environment: + SITEFORGE_S3_GATEWAY_BUCKET: ${SITEFORGE_PRODUCTION_S3_BUCKET:?Set S3 bucket} + SITEFORGE_S3_GATEWAY_REGION: ${SITEFORGE_PRODUCTION_S3_REGION:?Set region} + SITEFORGE_S3_GATEWAY_PREFIX: ${SITEFORGE_PRODUCTION_S3_PREFIX:-siteforge} + # Supply read-only IAM role via workload identity; do not put keys in source files. + ports: + - "127.0.0.1:${SITEFORGE_GATEWAY_PORT:-8791}:8791" + read_only: true + tmpfs: + - /tmp:size=64m,mode=1777 + cap_drop: [ALL] + security_opt: ["no-new-privileges:true"] + pids_limit: 64 + healthcheck: + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8791/health', timeout=3)"] + interval: 30s + timeout: 5s + retries: 3 diff --git a/compose.yaml b/compose.yaml index 192966b..25d47ee 100644 --- a/compose.yaml +++ b/compose.yaml @@ -6,7 +6,7 @@ services: dockerfile: Dockerfile args: SITEFORGE_GIT_SHA: ${SITEFORGE_GIT_SHA:-unknown} - image: siteforge/web:8.12.0-dev.1 + image: siteforge/web:8.21.3-dev.1 init: true restart: unless-stopped ports: @@ -21,6 +21,10 @@ services: SITEFORGE_ADMIN_PASSWORD: ${SITEFORGE_ADMIN_PASSWORD:?Set SITEFORGE_ADMIN_PASSWORD in .env} SITEFORGE_SESSION_SECRET: ${SITEFORGE_SESSION_SECRET:?Set SITEFORGE_SESSION_SECRET in .env} SITEFORGE_COOKIE_SECURE: "${SITEFORGE_COOKIE_SECURE:-false}" + SITEFORGE_DEPLOY_STAGING_URL: ${SITEFORGE_DEPLOY_STAGING_URL:-} + SITEFORGE_DEPLOY_STAGING_SECRET_REF: ${SITEFORGE_DEPLOY_STAGING_SECRET_REF:-} + SITEFORGE_DEPLOY_PRODUCTION_URL: ${SITEFORGE_DEPLOY_PRODUCTION_URL:-} + SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF: ${SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF:-} SITEFORGE_PUBLISH_ROOT: /published SITEFORGE_REQUIRE_RELEASE_APPROVAL: "true" volumes: @@ -35,13 +39,13 @@ services: - ALL pids_limit: 128 healthcheck: - test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8787/api/health', timeout=3)"] + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8787/api/ready', timeout=3)"] interval: 30s timeout: 5s retries: 3 start_period: 30s worker: - image: siteforge/web:8.12.0-dev.1 + image: siteforge/web:8.21.3-dev.1 depends_on: siteforge: {condition: service_started} init: true @@ -58,6 +62,12 @@ services: # Development-only env secret references; use compose.mysql-secrets.yaml for production files. SITEFORGE_MYSQL_READ_USER: ${SITEFORGE_MYSQL_READ_USER:-} SITEFORGE_MYSQL_READ_PASSWORD: ${SITEFORGE_MYSQL_READ_PASSWORD:-} + SITEFORGE_DEPLOY_STAGING_URL: ${SITEFORGE_DEPLOY_STAGING_URL:-} + SITEFORGE_DEPLOY_STAGING_SECRET_REF: ${SITEFORGE_DEPLOY_STAGING_SECRET_REF:-} + SITEFORGE_DEPLOY_PRODUCTION_URL: ${SITEFORGE_DEPLOY_PRODUCTION_URL:-} + SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF: ${SITEFORGE_DEPLOY_PRODUCTION_SECRET_REF:-} + SITEFORGE_STAGING_TOKEN: ${SITEFORGE_STAGING_TOKEN:-} + SITEFORGE_PRODUCTION_TOKEN: ${SITEFORGE_PRODUCTION_TOKEN:-} SITEFORGE_JOB_POLL_SECONDS: "1.5" SITEFORGE_BUILD_TIMEOUT_SECONDS: "${SITEFORGE_BUILD_TIMEOUT_SECONDS:-300}" SITEFORGE_BUILD_MAX_ATTEMPTS: "${SITEFORGE_BUILD_MAX_ATTEMPTS:-3}" diff --git a/deploy/art-design-pro/siteforge-nginx.conf.example b/deploy/art-design-pro/siteforge-nginx.conf.example new file mode 100644 index 0000000..70e29fe --- /dev/null +++ b/deploy/art-design-pro/siteforge-nginx.conf.example @@ -0,0 +1,40 @@ +# EXAMPLE ONLY. Replace DOMAIN, absolute path, and upstream host before use. +# The Art Design Pro SPA and SiteForge FastAPI MUST share an HTTPS origin. +# Restrict this admin hostname with your organization's access policy. +upstream siteforge_api { + server 127.0.0.1:8787; + keepalive 16; +} +server { + listen 443 ssl http2; + server_name admin.example.com; + ssl_certificate /etc/letsencrypt/live/admin.example.com/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/admin.example.com/privkey.pem; + root /srv/siteforge-art/dist; + index index.html; + add_header X-Content-Type-Options nosniff always; + add_header Referrer-Policy strict-origin-when-cross-origin always; + # Configure organization-specific access control, HSTS, rate limits and logs. + + # Do not cache API responses or auth redirects. + location ~ ^/(api/|login$|editor/|preview/|ui/|local-media/|favicon\.ico$|factory-studio$|operations$|theme-gallery$|production-v8$) { + proxy_pass http://siteforge_api; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-Host $host; + proxy_set_header X-Forwarded-Proto https; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_connect_timeout 8s; + proxy_read_timeout 90s; + add_header Cache-Control "private, no-store" always; + } + location / { + try_files $uri $uri/ /index.html; + } +} +server { + listen 80; + server_name admin.example.com; + return 301 https://$host$request_uri; +} diff --git a/deploy/native-release/README.md b/deploy/native-release/README.md new file mode 100644 index 0000000..2d47cac --- /dev/null +++ b/deploy/native-release/README.md @@ -0,0 +1,64 @@ +# V8.14 原生发布目标（SFTP / S3）运行配置 + +> 本文件包含可以部署的代码与操作步骤。真实服务器、证书、IAM、DNS 和缓存策略必须由部署人员配置并验证。 + +## 运行方式 + +默认仍采用原 V8.13 HTTPS 发布 Agent，不修改已有目标配置即可继续使用。每个目标分别设定 `SITEFORGE_DEPLOY_{STAGING|PRODUCTION}_TYPE` 为 `agent`、`sftp` 或 `s3`。 + +可选适配器及依赖版本已纳入 `requirements.lock` 和 Docker 镜像；如果镜像构建不能联网获取依赖，不会自动降级成无校验发布。 + +### SFTP + +1. 创建**专用无 shell/受限权限**的发布账号，仅允许访问专属发布根目录；安装并配置支持 OpenSSH `posix-rename@openssh.com` 扩展的 SFTP 服务器。Worker 不执行任意远程 shell 命令。 +2. 在管理服务器上由管理员手动核对目标主机 SSH 公钥指纹，保存 `secrets/publish_known_hosts`。不可使用 `AutoAddPolicy` 或 `StrictHostKeyChecking=no`。 +3. 为 Worker 安装只读私钥文件 `secrets/publish_key`；强烈建议独立测试/生产密钥及不同账号，挂载到 `/run/secrets/siteforge_publish_key`。 +4. 设置目标 `HOST`、`PORT`、`USERNAME`、`REMOTE_ROOT`、`KNOWN_HOSTS_FILE`、`SSH_KEY_FILE`、`PUBLIC_URL`；`PUBLIC_URL` 必须是**真实 HTTPS 站点首页地址**（如 `https://staging.example.com/`），必须映射到该站点 `current` 目录。 +5. 执行 `docker compose -f compose.yaml -f compose.publish-targets.example.yaml up -d --build`。示例同时演示 Staging SFTP、Production S3，实际部署时应依安全需求拆分环境和变量。 +6. 执行两次不同版本的审批发布、模拟校验失败与回滚；确认当前站点始终是已经完整验证的版本。 + +SFTP 文件布局：`REMOTE_ROOT/{site}/releases/{sha256[:20]}/...`，`current -> releases/{sha256[:20]}`。生成临时符号链接后使用原子 `posix_rename` 切换；若目标服务器不支持该扩展，则**拒绝部署**，不会使用有中间空窗的 fallback。 + +当前原生 SFTP 使用不带口令交互的 SSH 私钥文件。如果组织要求硬件密钥、交互式证书或私钥密码，需要在运维方案中对接安全代理，不要把口令写入前端或数据库。 + +### S3 / S3-compatible + +1. 创建独立存储桶或隔离前缀，赋予发布 Worker 最小必要的对象读写权限；站点网关使用**不同的、只读** IAM 身份（建议使用实例角色/工作负载身份，不要硬编码 Access Key）。 +2. 设置 `SITEFORGE_DEPLOY_PRODUCTION_TYPE=s3`、`BUCKET`、`REGION`、`PREFIX`、`POINTER_AWARE=1`、`PUBLIC_URL`。可选 `ENDPOINT_URL` 必须是 HTTPS 根地址。 +3. 发布会上传不可变 `sites/{site}/releases/{digest}/` 对象，对每个文件进行 SHA256 复核；最后条件更新 `sites/{site}/current.json`。并发指针修改会被 S3 ETag/If-Match 限制阻断。 +4. **必须部署指针感知网站网关** `app.s3_gateway:app`（示例 `compose.s3-gateway.example.yaml`），让 `https://web.example.com/{site}/` 根据 `current.json` 读取正确版本。不能直接把裸 S3 Static Website Hosting 端点当作已经实现原子切换。 +5. 网关示例为读路径提供 no-cache 和安全路径验证。对 CDN 的改写规则、主站根目录映射、缓存失效与回滚速度，必须在真实域名上验收。S3-compatible 需要支持条件写入；不支持的供应商不得声明原子发布。 + +### 发布安全门禁 + +- 构建状态必须是 `complete`，ZIP 路径必须处于系统归档根目录，静态质量和迁移审计满足要求。 +- 由独立审批人批准的版本才能部署；网页只提交异步任务，发布由 Worker 执行。 +- 上传/完整性校验失败不得改变当前发布指针；上线后首页内容哈希不匹配会尝试切换回旧版本。 +- 当前系统仍不保证 Worker 被强制杀死、网络分区发生在指针切换瞬间时具有跨进程数据库+远程站点的**严格分布式事务**；应当增加带审计的 reconciliation 机制后才能视为生产最终验收通过。 + +### 测试和运维验收 + +本地测试：`python -m pytest -q tests/test_release_native_v814.py tests/test_release_v813.py`。 + +生产验收必须测试：凭据错误、SSH 主机密钥变化、上传中断、哈希错误、审批撤销、重复任务、目标网关故障、回滚、旧版本路径、500/超时、CDN 缓存以及 API 日志中无凭据泄漏。 + +### S3 网站独立域名的反向代理（必做） + +本项目生成的静态网站可能使用 `/products/`、`/about/` 等**根路径链接**。示例网关的内部路由是 `/{site}/products/`。正式域名必须在反向代理层把根路径映射到正确的站点前缀，不能直接将网关根目录暴露为某个企业网站。 + +以下仅是 Nginx 的 HTTP 内网转发结构示例，真实外网必须先配置受信 HTTPS 证书和正确的 DNS： + +```nginx +server { + listen 127.0.0.1:8088; + server_name www.example.com; + location / { + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:8791/my_site_id/; + } +} +``` + +这样 `https://www.example.com/products/` 才会被反代为网关的 `/my_site_id/products/`。公网 443/TLS、缓存层和域名验证需由实际反向代理负责，**不要原样复制演示域名到生产环境**。 + +针对每个独立网站设置不同的 server_name、站点 ID 和相应的 `PUBLIC_URL`。使用 CDN 时，对根路径 HTML、current.json 的旧版本缓存必须进行专项验证；无明确缓存失效机制前使用 `no-cache` 更安全。 diff --git a/docs/HISTORY_V8_12_README.md b/docs/HISTORY_V8_12_README.md new file mode 100644 index 0000000..a5d7491 --- /dev/null +++ b/docs/HISTORY_V8_12_README.md @@ -0,0 +1,298 @@ +# SiteForge Enterprise V8.12.0-dev.1 — 工作台流程与任务状态增强 + +> **开发集成版，尚未通过 P0–P4 全部生产验收门禁。** 完整工程在 V8.11 基线上升级；P5/多语言和 Art Design Pro 官方工程等未在本轮解决。 + + +## V8.11：管理后台重新设计（本轮重点） + +默认 `http://localhost:8787/` 现使用 **简洁工作台**，保留原有业务 API 和数据结构，不迁移数据库。 + +- **工作台**：网站数量、操作引导、最近网站；不要求初学者理解 Worker/SEO/主题 Schema。 +- **我的网站**：一个地方选择所有网站；创建新站的表单只保留必要字段。 +- **网站概览**：四步流程（建立网站、准备内容、完善设计、构建预览），动态提示下一步。 +- **内容与页面**：页面、产品、新闻统一管理，可快捷修改文字或进入可视化设计器。 +- **外观与设计**：行业主题选择与实际页面编辑；草稿/发布隔离仍由原编辑器负责。 +- **导入与迁移**：默认进入带预演、复核与批次回滚的导入工作台；小文件直写保留为高级操作且必须确认。 +- **构建与交付**：使用既有异步 Worker，预览、静态 ZIP、质量报告集中呈现；正式审批和远程发布保留在企业交付中心。 +- **网站设置**：站点名称、域名、公司标语、Logo、类型等从设计功能中独立出来。 +- **高级工具**：折叠保留原有生产控制台、任务与审批、主题预览以及历史后台 `/classic`，确保不丢功能。 + +新增页面在 `app/templates/workspace.html`，样式和功能逻辑在 `app/static/workspace.css`、`app/static/workspace.js`。 +专业页面已经使用 V8.11 的统一导航与分组交互；Art Design Pro 官方完整工程仍未正式编译整合。 + +**运行前后检查**：登录、创建站点、内容编辑、主题切换、文件导入、异步构建、预览/ZIP、手机宽度侧边栏。 + +**注意**：新 UI 不改变业务 API 或权限模型；`/classic` 留作过渡。真实浏览器/生产 Docker 的全面实机回归仍应在目标服务器执行。 + +--- + +## V8.9 已有能力（原样保留） + + + +1. **P0 离线恢复安全**：恢复前校验 ZIP 路径、内容范围和数据库完整性；同文件系统暂存目录重命名切换，保留原数据目录以便回退，失败不先覆盖旧数据库。使用 `python scripts/restore_backup.py backup.zip --data /path --confirmed-offline`（务必先停 Web/Worker），完整备份生成用 `python -m app.backup`。 +2. **P2 WordPress 响应式图片**：解析 `srcset`、`data-src`、`data-srcset`、`picture/source` 和视频 poster 的外部资源引用；受限本地化后保留宽度/倍数提示及懒加载 URL，无法处理的外链进入迁移复核，绝不静默删除 CDN 引用。外部 CSS 背景图、任意复杂插件布局仍未全面迁移。 +3. **P3 5000 条真实构建**：独立 SQLite 夹具 10×500 记录实际导入 5,000 条并生成超 5,000 个静态 HTML；构建器预计算品牌/分类索引，交付检查和质量审计改为流式处理，避免随内容数平方增长；正式 SEO 警告仍需清理。 +4. **P4 维持现有设计器与模板**：保留跨设备列设置、页面草稿、全站设计草稿、Owner 整站套版与事务回滚；针对优化过的构建器/质量检查加入回归测试。 + +**验收报告与限制：** [P0–P4 V8.9 评估](docs/P0_P4_V8_9_VERIFICATION.md) | [原验收矩阵](docs/P0_P4_ACCEPTANCE_MATRIX.md) + +## 启动与测试（Windows PowerShell / Docker Desktop） + +```powershell +# 在解压后的项目根目录执行，首次生成 .env +# 不能直接覆写旧项目数据；务必使用新测试卷 +docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py +docker compose up -d --build +docker compose ps +``` + +- 简洁管理后台（默认推荐）：`http://localhost:8787/` +- 旧版专业操作页：`http://localhost:8787/classic` +- 高级数据与迁移工具：`http://localhost:8787/production-v8` +- 主题中心：`http://localhost:8787/theme-gallery` +- `/api/health` 应返回平台版本 `8.10.0-dev.1` 和构建提交标识。 +- 本地测试：`bash scripts/check.sh` 或 Windows PowerShell `scripts/check.ps1`。 +- 独立 5000 条验收：`python scripts/pilot_5000.py --report pilot.json`（默认只验证 5,000 条导入）。有足够资源的测试机上加 `--build` 同时检查整站构建；仍需分开核查 SEO 警告。。 + +## 迁移及回滚注意 + +离线恢复在目标目录旁保留 `*.pre-restore-*` 原数据目录；恢复完成后先验证旧构建、媒体、权限和管理员登录，再确认是否可以清理原目录。请先把备份 ZIP 拷贝到 Docker 卷之外。此恢复脚本适用于 SQLite 单机数据；**不是 PostgreSQL 恢复工具**。恢复前 Web 与 Worker 必须全部停止。 + +## 开发验收边界 + +此版本未在当前环境执行 Docker Engine、GitHub Actions 云端 CI、真实授权 WordPress 全站迁移、MySQL TLS 实机、生产密钥轮换以及桌面/移动浏览器完整视觉验收。P0–P4 尚不能全部标为生产交付完成。跨域 CDN、CSS 背景资源、付费/私有 WordPress 数据及复杂 WooCommerce/Elementor 页仍需定制适配与人工复核。 + +--- + +## 历史功能说明（原 V8.8/之前版本，仅供追溯） + +# SiteForge Enterprise V8.8.0-dev.1 — P0–P4 集成增强版 + +> **交付状态：开发集成版，尚未通过 P0–P4 全部门禁，不应作为正式商业验收报告。** + +本版延续 V8.7 的完整源码，聚焦 P4（响应式独立列布局、图片素材库、整站模板两步审核与多页原子操作），同时修复深层页面 CTA/媒体根路径问题、版本与 Compose 遗留问题。旧站迁移、数据装配、安全 HTTP、Worker、四套主题继续保留。 + +- **P4 设备布局**：页面中的多列区块可设置平板/手机独立列数、排序、跨度和显示隐藏；所有自定义 CSS 经过严格参数校验，并按页面作用域生成。 +- **P4 模板套版**：生产控制台先预检、再暂存，最后 Owner 发布；冲突拒绝、失败回滚，同步保证数据与 SEO 不被模板业务内容覆盖。旧版直接应用 API 需显式设置开发兼容开关。 +- **P4 媒体素材**：编辑器新增本站图片库选择，支持图片组件、画廊和轮播；深层页面正确使用根路径。 +- **验证状态与全部遗留**：[P0–P4 验收矩阵](docs/P0_P4_ACCEPTANCE_MATRIX.md)。 +- **运行**：与 V8.7 一样，首先在独立测试目录执行 `python scripts/init_config.py`（或 Docker 运行该脚本），再 `docker compose up -d --build`。不得覆盖运行中的旧版数据卷。 + +--- + +## V8.7 历史项目说明（保留升级依据） + +# SiteForge Enterprise V8.7.0-dev.1 — 全站设计草稿与响应式管理 + +> **交付状态：开发试点版。** 本轮基于 V8.6 延续原 Web + Docker 工程，不是单独演示网站。 + +## V8.7 本轮实际实现 + +- **全站设计草稿**：`GET/PUT/DELETE /api/sites/{site}/site-design` 管理独立草稿；`POST /site-design/publish` 才更新用于正式构建的全站配置。对 `revision` 和底层设置指纹做并发冲突检查，发布记录保存在 `site_design_publications`。 +- **统一页眉/页脚/导航**：支持安全的三级导航、搜索显示、顶部公告、联系 CTA、页脚标题/介绍/邮箱、页脚菜单显示选项；四套专业主题的最终 HTML 均消费同一份配置。导航只允许站内路径，严禁任意脚本、外部链接注入。 +- **响应式控制**：平板与手机的区块间距、手机内容左右内边距、移动端公告和页脚导航显隐；已写入最终静态 `assets/custom.css` 和可视化编辑器预览 CSS。它是可交付的响应式参数编辑，**并非**完整独立设备画布。 +- **设计令牌统一入草稿**：字体、标题缩放、版心宽度、圆角等改为全站草稿保存/发布；未经发布不会更改新构建。编辑器内可在“设计规范”和“全站页眉与页脚”面板操作。 +- **关闭旧版直写绕过**：`/blueprint` 直写、旧导航直写、旧设计令牌直写及 `PATCH entry.meta` 的布局直写，在生产环境默认返回 HTTP 409。旧脚本若必须临时过渡，可显式设 `SITEFORGE_ALLOW_LEGACY_DIRECT_DESIGN_WRITE=1`；**正式生产不应启用此选项**。原后台导航表单与企业设计令牌页已改写全站草稿。 +- **测试**：在现有 168 项回归基础上新增 13 项专项测试，验证四主题、草稿构建隔离、发布、设计令牌、安全输入、跨站隔离、并发拒绝、旧接口安全门禁。 + +### 使用方法 + +1. 解压后先在**独立测试环境**启动 Docker（以下为 PowerShell）： + + ```powershell + docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py + docker compose up -d --build + ``` + +2. 登录 `http://localhost:8787/`，进入任意站点页面的 `/editor/{site_id}/{entry_id}` 设计器。 +3. 点击 **全站页眉与页脚**，调整导航/页眉/页脚/手机与平板设置，点击 **预览草稿**，随后 **保存全站草稿**。 +4. 由网站 Owner 点击 **发布全站设计**，然后触发 Worker 网站构建。现有已发布静态版本不会因保存或发布设计而被原位篡改。 +5. CI 中可执行 `pytest`、Python 编译检查、`node --check`；Docker、真实浏览器和服务器发布需要独立实机验收。 + +### API 及兼容性 + +| 方法与路径 | 行为 | +|---|---| +| `GET /api/sites/{site}/site-design` | 返回已发布配置或草稿、版本、冲突状态 | +| `PUT /api/sites/{site}/site-design` | 携带 `config` 与 `expected_revision` 保存草稿 | +| `POST /api/sites/{site}/site-design/publish` | Owner 审核发布，要求版本号 | +| `DELETE /api/sites/{site}/site-design` | 删除未发布草稿 | +| `GET /api/sites/{site}/site-design/publications` | 查询最近的发布审计记录 | +| `POST /api/sites/{site}/pages/{entry}/editor-preview` | 请求体的 `site_design` 可预览未发布的整站草稿 | + +### 明确未完成 + +- 目前并非 Figma 式自由定位编辑；完整 PC/平板/手机**独立布局**、全站模板可视化拖拽、实时跨设备视觉验收仍待开发。 +- 旧版批量套版及部分内容创建接口仍可能更新布局，需在后续将所有设计变更统一纳入发布工作流；本次仅限制上述直接绕过入口。 +- Art Design Pro 官方工程、复杂 CMS 无损迁移、PostgreSQL/Redis 多实例、SFTP/S3 正式发布仍未完成完整实机验收。 +- 当前环境无 Docker Engine，**不能宣称** `docker compose up` 已实机通过；亦未完成 GitHub 云端 CI 和真机 Chrome 视觉回归。 + +--- + +## 上一版 V8.6 的开发记录（保留供升级追踪） + +# SiteForge Enterprise V8.6.0-dev.1 + +> **状态：开发试点版，P4 设计器与整站模板增强。** 同一主线延续 V8.5 的认证 API、只读 MySQL、V8.4 XML/API、WordPress 迁移、四套主题、构建 Worker 和发布审批。尚未完成正式商业/生产验收。 + +## 这一轮新增（P4） + +- **六种声明式组件**：`carousel` 图片滚动展示、`video` YouTube/Vimeo 白名单视频、`tabs` 可访问详情分组、`pricing` 服务方案、`map` 可信地图外链、`form_link` 询盘入口。都使用可信渲染器输出，不允许用户提交 JavaScript。 +- **独立设计草稿**：V8.6 可视化编辑器的“保存草稿”只写入 `studio_drafts`，不会修改正式 entries 或被静态构建读取；“发布设计”才会原子写入正式页面，随后需重新构建静态网站。 +- **并发保护**：每次草稿更新携带 `expected_revision`；正式页面被其他人改动后，拒绝发布，防止静默覆盖。放弃草稿会恢复正式版设计。操作支持站点权限隔离与审计。 +- **整站模板兼容性**：模板带主题版本声明；新增 `/whole-site-templates/preflight` 无副作用检查，验证主题是否存在、指定版本是否可用、已安装组件、已有路径，后台预检后再应用。 +- **前端操作入口**：原 `/editor/{site_id}/{entry_id}` 页面新增保存草稿、发布设计、放弃草稿；整站模板控制台在应用前执行独立兼容性检查。原 `/blueprint` 直写接口保留兼容旧系统，尚未完全禁用。 + +### Docker 运行 + +Windows PowerShell（在解压后的项目根目录）： + +```powershell +docker run --rm -v "${PWD}:/project" -w /project python:3.12-slim python scripts/init_config.py +docker compose up -d --build +docker compose ps +``` + +页面：管理台 `http://localhost:8787/`；生产控制台 `/production-v8`；主题 `/theme-gallery`；设计器从网站页面进入 `/editor/{site_id}/{entry_id}`；API 版本 `/api/health`。 + +首次升级必须使用**独立测试环境和数据副本**，备份 `.env`、数据库、媒体及归档。草稿表通过幂等方式初始化，未在原有生产数据库上完成实际迁移演练。 + +### P4 接口 + +| HTTP 接口 | 用途 | +|---|---| +| `GET /api/editor/blocks` | 读取组件注册表与属性契约 | +| `GET /api/sites/{site}/pages/{entry}/studio-draft` | 获取当前草稿或正式布局 | +| `GET /api/sites/{site}/pages/{entry}/studio-draft/preset?page_template=home` | 获取主题预设，不修改正式页 | +| `PUT /api/sites/{site}/pages/{entry}/studio-draft` | 保存草稿，要求 `expected_revision` | +| `POST /api/sites/{site}/pages/{entry}/studio-draft/publish` | 发布设计，需要 owner 角色和 `expected_revision` | +| `DELETE /api/sites/{site}/pages/{entry}/studio-draft` | 放弃草稿 | +| `POST /api/factory/sites/{site}/whole-site-templates/preflight` | 整站模板无副作用兼容检查 | + +开发环境已经完成 **168 项本地 pytest**、全部 JavaScript 语法与版本检查，另有“草稿构建不包含未发布内容 → 发布后重新构建包含内容”的实测回归。 + +**未验收**：Docker Engine 实机、GitHub 云端 CI、浏览器 PC/手机端手工交互、真实客户内容视觉检查、Art Design Pro 官方工程编译、复杂 WordPress 无损迁移、PostgreSQL/Redis 多实例能力、SFTP/S3 正式发布。 + +详细信息见 [V8.6 验收与剩余需求](docs/V8_6_RELEASE_STATUS.md)。 + +--- + +## 历史版本功能参考（以下内容为 V8.5 及更早阶段的开发记录，不是 V8.6 最新状态） + +--- + +## V8.4 历史能力（继续保留） + + +> 当前阶段：统一网站生产工厂，**P3 数据连接器第一轮（安全 XML、公开 JSON API + Worker）**。本版本是开发试点版，并非所有网站工厂需求均已实现。 + +## V8.4 本轮新增 + +- **安全 XML 导入**：`/production-v8` 可以上传 XML，选择记录节点、内容类型和字段映射，支持扁平或两级结构；使用 `defusedxml` 禁用 DTD 与外部实体，并限制最大 8 MB、1000 条记录及节点/深度上限。 +- **公开 HTTPS JSON API**：设置 `url`、JSON 列表路径（例如 `data.items`）、字段映射和分页；创建后提交 Worker 后台采集，使用既有租约/取消/重试/超时机制。每页形成独立暂存批次，可以审批提交或回滚。所有采集均不自动上线。 +- **进度和误差边界**：最多 50 页 × 每页 100 条，合计 5000 条；发生中断从已保存页码继续，复用已有同页批次避免重试重复写入；达到最大页数而上页满额会显示 `limit_reached`，不能视为采集完整。 +- **统一后台**：新增 XML 文件上传、API 创建、采集任务、取消和进度查询操作区域，并保留 WordPress 迁移、主题和编辑器。 +- **版本与 CI**：统一应用版本标记、Compose 名称、脚本和 CI 版本断言为 `8.5.0-dev.1`；**144 项本地自动化测试通过**。 + +[详细功能、接口、安全限制与剩余需求](docs/V8_4_RELEASE_STATUS.md) + +**边界**：目前 API **只支持无需认证的公开 JSON**，不支持带密钥 API；MySQL 只读连接器、完整 Art Design Pro 编译和生产级外部发布也尚未完成。没有运行 Docker 实机或云端 CI，因此不得将该版本称为企业正式上线完成版。 + +--- + +## 既有 V8.3 迁移与建站功能（本轮保留） + + +> SiteForge Enterprise 统一开发主线：**WordPress 可恢复迁移 + Sitemap 完整性审计 + 有界媒体本地化 + Worker 后台采集**。 +> +> 版本状态：开发试点候选版，不可直接对外宣称完整 WordPress 无损迁移或企业生产部署已验收。V8.1 网站、主题、编辑器、导入批次和静态构建功能均在此版本继续维护。 + +## 快速启动（Docker Desktop / Linux Docker） + +项目根目录第一次初始化： + +```bash +# PowerShell 将 `$(pwd)` 改为 `${PWD}` +docker run --rm -v "$(pwd):/project" -w /project python:3.12-slim python scripts/init_config.py +docker compose up -d --build +docker compose ps +``` + +- 登录：`http://localhost:8787/` +- **V8.4 生产控制台**：`http://localhost:8787/production-v8` +- 主题管理：`http://localhost:8787/theme-gallery` +- 页面编辑：`http://localhost:8787/factory-studio` +- 任务中心：`http://localhost:8787/operations` +- 构建版本：`http://localhost:8787/api/health`；当前应显示 `8.5.0-dev.1`。 + +**升级注意：** 不要直接覆盖 V8.1 正在运行的存储卷。先备份 `.env`、数据库、媒体和生成文件，在独立 Compose 项目中完成验收，然后安排升级与回滚。新版本表结构采用幂等的 `CREATE TABLE IF NOT EXISTS`，但并未进行真实旧数据库原地升级演练。 + +## V8.3 新增：WordPress 关系数据与归档 URL 保真 + +- 为每次 WordPress 迁移会话采集公开 REST 分类、标签和媒体库**元数据**，分别保存页码和已采集数量。关闭页面后可以继续下一页。 +- 原始 WordPress ID、分类/标签/特色图片的关联 ID 写入批次记录和关系索引；导入确认前，在已同步名称的情况下补充分类/标签字段；绝不凭空创建不存在的分类内容。 +- 分类/标签来源归档 URL 纳入旧站 SEO 基线。无对应的新页面或批准重定向时，需要通过差异检查处理。 +- 对缺失的标签/分类、未知特色图片、ACF 和页面构建器内容保留人工审核事项。公开 ACF 只保留有界快照，不承诺原样转换。 +- 控制台按钮：选择“分类 / 标签 / 媒体库”→ “同步目录下一页”→ “目录进度”，完成后再核对媒体和 Sitemap，最后确认导入。 + +详细的操作与验收边界见 [V8.3 开发验收报告](docs/V8_3_RELEASE_STATUS.md)。 + +## V8.3 迁移流程与增强 + +1. 创建迁移会话：指定授权 WordPress 来源和最多采集条数。 +2. **提交 Worker 后台采集**：一次提交到统一数据库任务队列，Worker 子进程逐页采集 WordPress REST `pages/posts`，保持每页检查点。浏览器关闭后可以继续执行。 +3. 在任务中心监控扫描的排队、执行、取消、重试、超时等状态。扫描任务不会自动提交暂存内容、不会直接上线。 +4. **发现 Sitemap**：单独读取 WordPress `wp-sitemap.xml`；支持 `sitemapindex` 嵌套与有界 gzip XML，记录未从 REST 采集到的 URL。若使用 Yoast 或 RankMath 自定义 Sitemap，可以通过 API 指定同源 URL。 +5. **媒体本地化**：在最终导入前，手动分批读取（每次最多 40 个）暂存文章中的图片，限制大小、格式、原站域名，自动重写正文及特色图片路径。其他 CDN 域名默认拒绝自动下载，并形成待复核项。 +6. 检查扫描结果、Sitemap 缺页和图片缺失，明确点击“确认并导入”。将旧 URL / SEO 清单加入审计；存在未处理差异的迁移站继续受发布审批门禁限制。 +7. 选择主题后使用原有 Worker 构建网站，查看 QA 和 ZIP。 + +**重要边界**：Sitemap 只用于发现遗漏，并不自动解析任意 Sitemap 页面内容；完整的 `srcset`、CSS 背景图片、跨域 CDN、附件、视频、登录后数据及复杂 Elementor/ACF/WooCommerce 迁移仍需要额外适配和人工复核。未运行 Sitemap 完整性审计时，系统不能保证完整发现旧站 URL。WP 媒体本地化是用户主动触发的、同步分批执行的步骤，不会在后台无界下载资源。 + +## V8.3 主要接口 + +所有接口需要原有 Session + CSRF + 网站权限；`POST` 不允许匿名调用。 + +| 接口 | 说明 | +|---|---| +| `POST /api/migrations/sites/{site}/wordpress/sessions` | 创建迁移会话 | +| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/scan` | 将 REST 扫描加入 Worker 队列；可传 `idempotency_key` | +| `GET /api/migrations/sites/{site}/wordpress/sessions/{session}` | 查询检查点、页数和警告 | +| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/sitemap` | 安全发现同源 Sitemap，JSON 可传 `url` | +| `GET /api/migrations/sites/{site}/wordpress/sessions/{session}/sitemap` | 已发现 URL 数、缺失计数、前 100 项示例 | +| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/media/localize` | 分批媒体本地化，JSON `limit` 1–40 | +| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/finalize` | 明确确认提交，建立 URL/SEO 基线与复核项 | +| `POST /api/migrations/sites/{site}/wordpress/sessions/{session}/cancel` | 取消会话；正在运行的任务另在任务中心申请取消 | + +后台扫描任务使用 `build_jobs.kind='wordpress_scan'`，与原网站构建共享 Worker/容量限制/租约/退避。可使用 `/operations` 监控或使用既有企业任务 API。**扫描完成不代表迁移交付完成**。 + +## 测试与已知限制 + +```bash +bash scripts/check.sh +python scripts/verify_release.py +``` + +截至本次代码交付，130 项自动化测试在当前开发环境全部通过，包含 V8.2 的 120 项和本轮的 10 项专项测试。测试覆盖嵌套 Sitemap、压缩炸弹、XXE、缺页审计、媒体格式与同源限制、子进程任务派发、幂等、容量门禁、API 鉴权等。 + +本环境没有 Docker Engine；没有实际执行 Docker 实机启动、GitHub 云端 CI、官方 Art Design Pro 编译、真实 WordPress 全量迁移、浏览器全流程或远端正式发布。是否能交付企业生产仍需上述验收。 + +接下来的 P2 收尾任务：自动尝试多种 Sitemap 路径、WordPress 媒体库/分类标签迁移、REST 采集的统计/重试监控、媒体 CDN 授权白名单和批量迁移压测。之后再推进 P3 XML/API/只读数据库连接器、P4 整站编辑器、P5 安全发布、多语言与 PostgreSQL/Redis 生产化。 + +更多细节：[V8.3 验收与剩余功能](docs/V8_3_RELEASE_STATUS.md)。 + +## V8.11：统一专业管理体验 + +本版在 V8.10 基础上统一五个专业工具页面的导航、当前网站选择、业务提示、表单焦点和操作按钮。编辑器将“草稿/预览/正式发布”分组，平板和手机提供结构/预览/属性面板切换；任务中心按迁移、构建、审批发布分为三个阶段。所有原业务 API 与 Docker 服务保持不变。 + +- 默认工作台：`http://localhost:8787/` +- 主题预览：`/theme-gallery` +- 页面编辑器：从工作台的“外观与设计”进入 +- 高级建站：`/factory-studio` +- 数据迁移：`/production-v8` +- 任务与交付：`/operations` + +详细功能对照与人工验收清单见 [`docs/V8_11_UNIFIED_ADMIN.md`](docs/V8_11_UNIFIED_ADMIN.md)。 + +运行测试：`python -m pytest -q --disable-warnings`。本版在当前环境通过 218 项测试。Docker 实机与浏览器跨设备回归仍需部署后完成。 diff --git a/docs/P6_QUICKSTART.md b/docs/P6_QUICKSTART.md new file mode 100644 index 0000000..9dba395 --- /dev/null +++ b/docs/P6_QUICKSTART.md @@ -0,0 +1,12 @@ +# P6 快速操作 + +登录 `http://localhost:8787/` → 我的站点 → 建立中文与英文两个独立 HTTPS 站。 + +1. 进入“多语言管理”，创建语言组与两个语言站成员。 +2. 在中文站与英文站分别录入已翻译页面，各自设置 `status=published`。 +3. 建立翻译内容组（例如 `product:example`），将两个实际页面 ID 分别关联为 `approved`。 +4. 重新构建两个站点，并查看生成 HTML 与 Sitemap；无对应翻译的页面不会显示语言互链。 +5. 待翻译文案先存为 `draft`，可以关联为 `pending`，待审核确认以后改为 `published` 并设为 `approved`。 +6. 使用“构建与交付”审批发布。上线前仍需在真实域名上逐一核对 canonical、链接、翻译质量和 SEO。 + +数据库升级为加法建表，不会自动复制或修改原网站内容。升级前请先备份现有卷。 diff --git a/docs/V8_13_P5_ACCEPTANCE.md b/docs/V8_13_P5_ACCEPTANCE.md new file mode 100644 index 0000000..5da086b --- /dev/null +++ b/docs/V8_13_P5_ACCEPTANCE.md @@ -0,0 +1,43 @@ +# SiteForge V8.13 — P5 发布闭环的交付与验收清单 + +版本：`8.13.0-dev.1`。此报告区分 **源代码实现/本地自动化测试** 与 **Docker/外部生产实机验收**。 + +## 本轮实现与已有能力 + +| 验收点 | 当前状态 | 证据 / 限制 | +|---|---|---| +| 构建完成且 ZIP 可用 | 已实现与单元测试 | `release_api.approved` + `_archive_for` | +| 静态质量、SEO 迁移审核、独立审批 | 已有代码 + 本轮 API 专项测试 | 未审批返回 409，迁移站差异会阻断 | +| Web 不执行远程大文件上传 | 已实现 | API 提交 `remote_deploy` / `remote_rollback` 任务，返回 HTTP 202 | +| 任务超时、幂等、容量、取消 | 已有 Worker + 本轮补充测试 | 单机 SQLite 租约；不是多区域事务 | +| 远程 ZIP 不可变暂存 | 已实现与签名 Agent 模拟测试 | 按存档 SHA256 前 20 位命名，不更改 current | +| 远程文件 SHA256、清单核验 | 已实现与模拟测试 | 篡改文件后拒绝激活 | +| 单次版本切换 | 已实现与模拟测试 | `current` 指针文件通过 `os.replace` 原子替换 | +| 激活后二次校验与首页探针 | 已实现与模拟测试 | 比对 Agent 公开首页的 SHA256；不等于真实域名探测 | +| 异步历史版本回滚 | 已实现与模拟测试 | 仅回滚数据库记录中该站点该目标的版本；验真后切换 | +| 目标密钥不进入前端 | 已实现的环境引用方案 | 推荐挂载到 `/run/secrets`，待生产轮换验收 | +| SFTP / S3 原生连接器 | **未实现** | HTTPS 发布 Agent 为当前唯一可运行的远程目标类型 | +| 真实 Docker、外网 TLS、CDN、域名 | **待实机验收** | 当前环境无 Docker Engine；没有公网发布测试服务器 | +| 发布取消在切换瞬间的跨服务一致性 | **未完全解决** | 需增加远程状态 reconciliation / 运维确认 | +| PostgreSQL/Redis 多 Worker | **待生产验收** | 独立 Compose 已配置但未完成真实高可用测试 | + +## 确定性专项测试 + +- 不经过激活就上传两个版本时，当前线上指针保持不变。 +- 篡改 staging 文件后，Agent 拒绝激活且旧站保持可访问。 +- 伪造签名、非法 ZIP 路径、保留文件名、同名冲突会被拒绝。 +- 已批准构建通过异步 API 提交，在队列中去重；未批准构建禁止提交。 +- 运行签名 Agent 的完整暂存、校验、激活、再次验证、回滚逻辑（本地 TestClient 模拟）。 +- 任务数量达到上限时拒绝新任务；取消排队任务不影响已发布内容。 + +## 正式上线前需要的人工/环境门禁 + +1. Docker 一条命令在全新宿主机成功启动 Web 与 Worker，并验证 `/api/health` 精确报告版本/提交。 +2. 将 Agent 部署于真实 HTTPS 测试域名，独立密钥及 TLS 证书有效；仅开放预期入口。 +3. 在授权测试网站完成两轮发布，故障注入覆盖上传中断、校验失败、切换成功后 Web 超时、Worker 取消。 +4. 核对站点正式域名的首页、产品详情、404、canonical、sitemap、robots、媒体与链接。 +5. 验证真实站点切换/回滚并确认时间、缓存失效、老 URL 保留。 +6. 审计密钥轮换、管理员/审核人权限、备份/恢复和日志中的敏感数据。 +7. 完成 SFTP/S3 等其它发布方式后，逐个通过等价事务性/故障恢复门禁。 + +**结论**：V8.13 的 HTTPS Agent 远程发布形成了本地可测试的发布闭环；尚不符合全部 P5 生产验收条件。 diff --git a/docs/V8_14_P5_ACCEPTANCE.md b/docs/V8_14_P5_ACCEPTANCE.md new file mode 100644 index 0000000..85e8315 --- /dev/null +++ b/docs/V8_14_P5_ACCEPTANCE.md @@ -0,0 +1,32 @@ +# SiteForge Enterprise V8.14 — P5 原生发布验收记录 + +版本：`8.14.0-dev.1`。本版在 V8.13 上添加 SFTP / S3 原生发布适配器、只读 S3 发布指针网关、统一发布目标状态与回滚入口。 + +## 本轮已实现且有确定性测试覆盖 + +| 能力 | 实际实现 | 测试边界 | +|---|---|---| +| 默认 HTTPS 签名 Agent 向后兼容 | 原发布 API、队列、签名与审批不变 | 继承 V8.13 专项回归 | +| SFTP 主机密钥校验 | Paramiko RejectPolicy + 必须预置 known_hosts 和 SSH 私钥文件 | 配置与仿真 SFTP 文件系统测试，**未真实握手** | +| SFTP 不可变目录与原子激活 | 分版本目录、SHA256 manifest、原子符号链接切换与回滚 | 本地仿真、注入损坏/探针失败；OpenSSH 实机待验收 | +| S3 分版本对象上传 | 不变对象键、SHA256 内容校验、条件写入 current.json | FakeS3 条件语义测试，真实 AWS API 待验收 | +| S3 网站读取服务 | 只读 gateway 根据版本指针解析站点资源，不直接曝光存储凭据 | ASGI TestClient + FakeS3 测试 | +| 远端失败恢复 | 上传/校验失败保持旧版本；探针失败尝试恢复前一版本 | 本地故障注入测试 | +| 审批、Worker、部署记录 | 原 API 选择后端、异步执行、记录发布与回滚 | 自动化测试 | +| 后台展示 | 新增发布类型/目标配置状态、已发布版本回滚按钮 | JS 语法与组件级回归，真实浏览器待验证 | +| 依赖与 Docker | 添加 boto3/Paramiko 完整依赖与 Compose 使用示例 | 配置审查；无 Docker Engine 实机验证 | + +## 不应宣称已完成的事项 + +- SFTP 真实 SSH/TLS、主机指纹、私钥权限与 OpenSSH 原子扩展实测；环境中无法安装 Paramiko 验证真实服务器操作。 +- AWS/S3 真实凭据、桶 IAM、S3-compatible 条件写入能力及 CDN/域名部署。 +- Docker 单机真实启动、Linux CI 云端执行、浏览器桌面/移动端流程、各生产环境实际回滚演练。 +- 发布切换瞬间 Worker 崩溃的跨系统状态对账、长时间任务协调、完整运维监控、缓存刷新和 DNS 自动化。 + +## 后续门禁 + +1. 实际 Docker Compose clean room 部署+版本核查；两个账户完成一次分权审批。 +2. SFTP 容器夹具：上传、异常断网、错误 host key、目录符号链接攻击、原子切换和回滚。 +3. MinIO/S3 实机夹具：不可变对象校验、并发指针更新、被篡改对象、只读网关、旧版本回滚。 +4. 正式测试域名：主页、产品详情、404、canonical、sitemap、robots、媒体、缓存状态、安全响应头。 +5. 中断/重试后远端实际 current 与数据库发布历史 reconciliation；完成后才能标记 P5 生产通过。 diff --git a/docs/V8_15_P6_ACCEPTANCE.md b/docs/V8_15_P6_ACCEPTANCE.md new file mode 100644 index 0000000..2f4436b --- /dev/null +++ b/docs/V8_15_P6_ACCEPTANCE.md @@ -0,0 +1,34 @@ +# SiteForge Enterprise V8.15 — P6 多语言建设与验收 + +## 本轮完成的能力 + +| 验收点 | 状态 | 证据 | +|---|---|---| +| 多语言站点组和默认语言 | 本地通过 | `language_groups` / `language_sites` / API | +| 同一内容关联不同语言页面 | 本地通过 | `translation_units` / `translation_members` | +| 已审核、已发布页面生成双向 hreflang | 本地通过 | 中英两站实际构建 + 自动化测试 | +| sitemap 含 XHTML hreflang | 本地通过 | 两站 sitemap.xml 验证 | +| 不存在的翻译不生成伪造链接 | 本地通过 | 缺失、草稿、noindex 测试 | +| 待翻译内容不能意外发布 | 本地通过 | 仅 draft 可 pending，误设 published 时拒绝静态构建 | +| x-default 指向默认语言 | 本地通过 | 明确默认语且存在审批页面才输出 | +| 前台语言切换导航 | 代码完成 | 动态注入，并需真实浏览器视觉验收 | +| 后台多语言菜单及表单 | 代码完成 | 集成 JS / API，真实浏览器端操作仍待验收 | +| 原 243 项测试兼容 | 本地通过 | 本地 pytest 248 passed（含 5 项 P6 专项） | +| 真实 Docker、Chrome、正式域名 | 待验收 | 当前环境无完整 Docker/远程域名实机测试 | + +## 主要限制 + +1. **域名模式**：目前一个语言站一个独立 HTTPS 域名或子域名；同域子路径需进一步设计反向代理、站点构建根路径和 sitemap。 +2. **翻译质量**：不自动翻译事实，`approved` 表示人工确认的状态标记，不包含另一人独立翻译审批的完整审计流程。 +3. **动态语言链接**：已发布数据可生成对应 URL；必须额外核对真正上线服务器是否已有该版本，不等于远程可访问性证明。 +4. **各主题国际化**：四套主题中部分组件和预设仍为中文。正式外语商业交付需按语言提供真实导航、字段标题和空状态文案。 +5. **企业生产**：Art Design Pro 官方完整工程、PostgreSQL/Redis 多实例、真实 SFTP/S3 等依旧需要实机验收。 + +## 手工部署验收步骤 + +1. 在新 Docker 项目卷启动 V8.15；核对 `/api/health` 返回 `8.15.0-dev.1` 与期望提交 SHA。 +2. 创建两个真实的 HTTPS 语言域名站，填写翻译过的公司主页和产品页。 +3. 建立一组真实对应关系；分别构建和下载静态站，验证 URL、html lang、canonical、sitemap、hreflang 的对称性。 +4. 随机挑选缺翻译、草稿和 noindex 的页面，确认其不会产生无效的互链；将 pending 内容错误设为 published，确认构建被拒绝。 +5. Chrome/手机端点击前台语言切换，验证页面存在、焦点可达、移动布局无溢出。 +6. 正式发布前审批，两站完成远程发布后从公网检查首页和内页的 hreflang 相互指向，不将示例 `.example.org` 域名当作有效服务。 diff --git a/docs/V8_16_PRODUCTION_ACCEPTANCE.md b/docs/V8_16_PRODUCTION_ACCEPTANCE.md new file mode 100644 index 0000000..6dc61b5 --- /dev/null +++ b/docs/V8_16_PRODUCTION_ACCEPTANCE.md @@ -0,0 +1,40 @@ +# SiteForge Enterprise V8.16 — 企业部署基础验收记录 + +版本：`8.16.0-dev.1`；阶段：**开发集成（非生产认证）**。 + +## 本轮新增与测试门禁 + +| 验收项 | 验证路径 | 当前结果 | +| --- | --- | --- | +| PostgreSQL 查询行数字/字段访问 | `tests/test_production_v816.py` | 本地模拟测试通过 | +| PostgreSQL SQL 占位符、注释及 DDL 分句 | 同上 | 本地单元测试通过 | +| PostgreSQL 初始化及 schema ledger | `scripts/verify_pg_bootstrap.py` | 脚本已扩展；需要 PostgreSQL 实例实测 | +| PostgreSQL Worker `FOR UPDATE SKIP LOCKED`、事务与任务恢复 | CI `postgres-smoke` | 自动检查代码已接入；本机没有 PG 服务，未实际通过 | +| Worker 按实例隔离心跳 | `tests/test_production_v816.py` | 本地通过 | +| `/api/ready` 探针成功/失败及脱敏 | `tests/test_production_v816.py` | 本地通过 | +| 全平台自动化回归 | `scripts/check.sh` | 按模块三组通过：95+82+78 = **255 项** | +| HTTP + Worker 实际建站链路 | `python scripts/http_end_to_end.py` | **本地通过**：建站、保存、队列、静态 ZIP、预览 | +| Chromium 桌面/移动端真实交互 | `scripts/browser_smoke.py` | **环境阻断**：`ERR_BLOCKED_BY_ADMINISTRATOR`，未通过 | +| Docker Engine Web + Worker | `docker compose up -d --build` | 本机无 Docker Engine，未运行 | +| Redis 通知故障降级 | 历史单元测试 | 通过；真实 Redis 容器未运行 | +| Art Design Pro 官方构建 | 用户提供官方完整源码后执行 pnpm/构建 | **未完成**；交付包含安装脚本/适配页面，不含官方完整项目 | +| 公网 SFTP/S3/HTTPS 上线和回滚 | 独立预生产环境 | **未完成** | + +说明：单进程连续执行所有 pytest 在约 84% 时超时；上述 255 项是三个独立 pytest 进程（95/82/78）分别完成并通过，不等同于单进程全量成功。新增真实 HTTP 集成构建了 10 个 HTML 页面，仍有缺少正式域名、未填充栏目内容的质量警告；只证明代码路径畅通。 + +## 生产环境验收操作建议（必须在预生产进行） + +1. 对 V8.15 的 SQLite 数据卷和所有媒体、归档、发布目录做完整备份，先演练恢复；保留生产回退窗口。 +2. 在独立 PG 16+ 测试数据库执行 `scripts/verify_pg_bootstrap.py`。验证 Web、Worker 启动与并发 claim；**不把原 SQLite 文件当作 PostgreSQL 数据迁移**。SQLite → PG 的正式数据迁移、外键校验、内容数量和媒体对账还未实现为可一键生产执行的迁移器。 +3. `docker compose -f compose.enterprise.yaml config`、`up -d --build`，分别核对 Web `/api/ready`、Worker 本地健康以及 PostgreSQL/Redis 服务健康。 +4. 将两个 Worker 实例分别配置唯一的 `SITEFORGE_WORKER_INSTANCE`，断开其中一个，确认另一个健康状态不会使坏实例误报正常；断电中断后要检查租约回收与远程发布状态对账。 +5. 用完整真实数据做创建网站、WordPress 迁移、5000 条产品导入、构建、主题预览和多语言 SEO 检验。在 Chromium 1440/1024/390/360 视口进行后台与前台访问性/响应式验证。 +6. 在预生产的实际 SFTP/S3/HTTPS Agent 发布，逐步演练上传失败、激活失败、CDN 缓存、健康检查失败及人工回滚；审批人与执行人分离。 +7. 获取合法的 Art Design Pro 官方工程后执行 `scripts/install_into_art_design_pro.py`，完成实际路由/会话/CSRF 联调及 `pnpm build`。目前属于可选桥接，不要把它计为完成。 + +## 风险边界 + +- PostgreSQL 兼容桥目前在 PG + Psycopg 真机上仍需完整持续验证，不能因为 SQLite 测试通过就宣称 PG 生产稳定。 +- Redis 当前主要用于任务唤醒，任务权威状态仍在数据库；并非完整的分布式消息可靠性交付。 +- SFTP/S3 原生发布已支持本地仿真，但公网环境、强制 TLS、服务端权限和切换时缓存行为仍需验收。 +- 新版未添加 SSO、MFA 或企业级集中监控系统，也未完成 Art Design Pro 官方源码集成。 diff --git a/docs/V8_17_ACCEPTANCE_RUNBOOK.md b/docs/V8_17_ACCEPTANCE_RUNBOOK.md new file mode 100644 index 0000000..4a589f9 --- /dev/null +++ b/docs/V8_17_ACCEPTANCE_RUNBOOK.md @@ -0,0 +1,92 @@ +# SiteForge V8.17 — 生产交付门禁执行手册 + +> 状态：独立增量验收工具；不包含 V8.16 原项目源码、Art Design Pro 官方完整工程或真实测试环境。本文的项目结构以所获 V8.16 README 为依据。生产演练与授权审批必须由真实环境执行并存档。 + +## 一、目标与范围 + +- V8.16 具备 HTTP `/api/health`、`/api/ready`，PG 兼容层、Worker 实例标识与 HTTP/PG 浏览器测试脚本。 +- V8.17 增量提供不侵入应用数据的统一检查入口，报告 JSON + Markdown + 离线可视化 HTML。 +- **不替代** `scripts/check.sh`、`scripts/http_end_to_end.py`、`scripts/browser_smoke.py`、`scripts/verify_pg_bootstrap.py`；这些是应用级端到端验证。 +- **不会执行** Docker up/down/build、数据库迁移、写入、发布/回滚、备份/恢复、人工审批。 + +## 二、集成路径 + +1. 解压原 V8.16 完整工程到**隔离测试目录**，不要覆盖正式数据卷。 +2. 将本补充包 `scripts/siteforge_v817_audit.py` 和 `tests/test_siteforge_v817_audit.py` 分别复制到原项目同名目录中；不会替换已有模块。 +3. 按需复制 `docs/V8_17_ACCEPTANCE_RUNBOOK.md` 和 `examples/`。 +4. 运行 `python -m unittest discover -s tests -p 'test_siteforge_v817_audit.py' -v`，再执行以下命令。 + +## 三、执行命令 + +最小安全检查（无网络、无需 Docker）： + +```bash +python scripts/siteforge_v817_audit.py --repo . --output reports/siteforge-v817 +``` + +隔离 Docker 企业 Compose 已启动后： + +```bash +python scripts/siteforge_v817_audit.py \ + --repo . --docker --url http://127.0.0.1:8787 \ + --output reports/enterprise-staging +``` + +使用已有隔离数据库配置；**PG 仅执行 SELECT 1（事务只读），Redis 仅执行 PING**： + +```bash +# 以下环境变量需由运维通过私密渠道事先配置，切勿提交 .env 或 DSN 到仓库。 +python scripts/siteforge_v817_audit.py \ + --postgres --redis --output reports/datastores +``` + +静态构建产物 URL 校验（old_urls.txt 需人工从旧站导出，不自动抓取）： + +```bash +python scripts/siteforge_v817_audit.py \ + --build-dir /path/to/generated/site \ + --url-baseline old_urls.txt \ + --output reports/static-seo +``` + +验收报告：`reports/*.html` 离线打开、`reports/*.json` 可机器读取、`reports/*.md` 可归档。返回码 2 代表存在 FAIL；WARN/SKIP 仅表示需要进一步处理，不视为生产通过。 + +## 四、关键门禁和接受标准 + +| 门禁 | 自动审计可做 | 仍需人工与真实环境执行 | +|---|---|---| +| 代码与 Compose | 文件完整性、Python AST、Compose 配置、容器状态 | 应用全测试集、供应链审计、CI 与镜像签名 | +| Web 与 Worker | HTTP readiness、容器运行/health、Worker 服务发现 | 真实异步任务、租约竞争、断网恢复、容量压测 | +| PostgreSQL | 真正连通后的 `SELECT 1` | **隔离测试库**运行原项目 PG bootstrap、迁移校验、恢复演练 | +| Redis | PING | 队列可靠性、幂等、故障切换、持久化和告警演练 | +| URL / SEO | html lang、canonical 规则、内部链接、旧路径覆盖、sitemap | 迁移映射审定、301/404、robots、实际源站比对、GSC 验收 | +| 多语言 | hreflang 格式与语言标签 | 关联双方对称、翻译审核、独立域名 HTTPS | +| 发布与回滚 | 读取人工证据表 | 真实 staging 激活、不可变版本、校验 SHA、回滚演练、审批隔离 | +| Art Design Pro | 检查当前 `workspace` 静态入口 | **获得官方工程并构建**，完成组件/路由/权限/API 接入和验收 | + +## 五、证据记录规范 + +以 `examples/evidence.template.json` 为模板记录 10 个阶段。每阶段保留 `status`、`operator`、`date`、`evidence`，例如证据可以是带日期的运行日志路径或测试报告 URL。工具只验证字段存在，**不核验证据内容真实性**。`pending` 永远不等同 `passed`。 + +**回滚演练**：先备份隔离测试环境，生成构建 A，部署到 staging，生成 B，再回滚至 A；比对前后首页和关键 URL 的 SHA/状态码，确认旧版恢复。测试的真实日志由人工归档。不得自动在生产环境执行此脚本包的任何写入动作。 + +**SSRF 风险**：HTTP 模式默认仅 localhost。远端只允许在操作者明确指定 `--allow-remote` 且获得目标授权时检查；URL 不得包含用户名、密码、查询或 fragment。代理/CDN 的响应和 TLS 配置需人工复核。 + +## 六、管理后台 UX 接入约定（下一层） + +- 导航继续沿用“工作台 / 我的网站 / 内容页面 / 外观设计 / 导入迁移 / 构建交付 / 网站设置”；技术工具统一收纳高级工具。 +- 验收中心可在**构建交付 > 验收报告**展示 JSON：优先级为 FAIL、WARN、SKIP、PASS，附修复建议，保留站点上下文。 +- 不在编辑页弹出多层确认；破坏性/正式发布才要求明确确认或审批。 +- 未获得 Art Design Pro 官方完整源码前，该交付**不能称为官方集成**；正式集成需基于实际 Vue 项目文件、授权版本、组件结构和构建配置开展。 + +## 七、Known limitations + +- 文件可用性为当前 V8.16 README 描述，不保证用户本地工程文件路径完全相同，缺项会被标注 WARN。 +- 报告 **不是渗透测试、上线证明、真实发布演练或真实数据备份报告**。 +- 单站静态链接检查不能证明跨语言站的双向 hreflang；多语言配对需单独验证。 +- 对于在 CDN 或独立路径进行的预览，构建本地链接存在不代表预览 rewrite 逻辑完全正确，需要另行浏览器检查。 +- 使用 JSON 证据表并不代表完成任何业务审批或合规认证。 + +## 八、隔离 CI + +提供 `.github/workflows/siteforge-v817-acceptance.yml` 作为**人工触发**的独立验收工作流：一组运行只读源码检查/测试，一组在临时 PostgreSQL 16 和 Redis 7 容器中执行最小存活检查，并上传脱敏报告。该 CI **不能替代**在实际 SiteForge 企业 Compose 下的完整业务链路和故障注入。 diff --git a/docs/V8_17_INTEGRATION_RELEASE_NOTES.md b/docs/V8_17_INTEGRATION_RELEASE_NOTES.md new file mode 100644 index 0000000..01af231 --- /dev/null +++ b/docs/V8_17_INTEGRATION_RELEASE_NOTES.md @@ -0,0 +1,17 @@ +# V8.17 Integration Release Notes + +## 基线 +- V8.16.0-dev.1 完整源码，提供 30 个 pytest 测试模块；V8.16 既有报告记录 255 例通过，但官方脚本曾偶发卡住。 +- V8.17 以真实源码整合，而非仅以 Markdown 方案代替实现。 + +## 变更范围 +- 新增 `scripts/regression_v817.py` 并统一 `.sh/.ps1` 回归入口；逐批超时、隔离诊断、可机器读取报告、失败保留证据。 +- V8.17 audit、WordPress URL baseline 工具及单元测试集成。 +- 修复 Chromium desktop/mobile 登录上下文共享，CI 增加真实浏览器检查。 +- 主项目版本、Compose 镜像版本、相关断言同步更新。 + +## 未完成 +- 当前工作容器不具备 Docker Engine、隔离 PostgreSQL/Redis 服务器和正常可访问 localhost 的 Chromium policy；这些并不作为通过项。 +- 不自动覆盖生产卷或执行现有部署迁移。 +- 不包含 Art Design Pro 官方可编译完整工程，不声称完成前后端集成。 +- 完整历史版本说明保留在 README 后半部分。 diff --git a/docs/V8_17_INTEGRATION_TEST_RESULTS.md b/docs/V8_17_INTEGRATION_TEST_RESULTS.md new file mode 100644 index 0000000..fbb9d34 --- /dev/null +++ b/docs/V8_17_INTEGRATION_TEST_RESULTS.md @@ -0,0 +1,31 @@ +# SiteForge Enterprise V8.17.0-dev.1 — 源码集成回归结论 + +**结论：V8.17 完整源码已整合并通过隔离本地集成回归。生产上线验收尚未完成。** + +## 已实际执行 + +- 完整项目现有 + 新增自动化测试：**288 项/轮，连续 2 轮均通过**（总计 576 次通过，0 失败、0 超时）。详细见 `reports/v817-regression.json` / `*.html` 与 8 份 verbose 日志。 +- V8.17 新增 33 项专项测试包含异常超时检测、报告落地与旧 URL 路径一致性检查。 +- HTTP 真实端到端：`/api/ready` → 登录/CSRF → 新建站点、页面 → Worker 异步构建 → ZIP 下载 → HTML 预览，通过。 +- `scripts/verify_release.py`、全体应用 Python 编译、前端 JS 语法检查：通过。 +- V8.17 只读仓库审计：**12 PASS / 0 FAIL / 0 WARN / 2 SKIP**（未提供实际 `.env` 和正式发布证据）。 +- GitHub Actions 两套 CI YAML 结构能正常解析，但**没有在 GitHub Actions 运行**。 + +## 仍然未通过 / 尚未执行 + +- Chromium 当前环境：使用 `/usr/bin/chromium` 仍遇到 `net::ERR_BLOCKED_BY_ADMINISTRATOR`，属于执行环境策略限制；新增独立浏览器 CI，需在允许访问 localhost 的 Runner 中验收。 +- 当前容器没有 Docker Engine；PostgreSQL/Redis、多 Worker、远程 SFTP/S3/Agent 发布与真实回滚，均未执行真实集成验收。 +- Art Design Pro 官方完整源代码未提供；没有进行官方前端编译集成。 +- V8.16 曾完成的 5,000 车型导入/构建压力测试，本轮未重复执行，不把历史结果标记为新版本重测结果。 + +## 修改范围 + +- `scripts/regression_v817.py`、`.sh/.ps1`：可终止的批量回归和逐模块异常隔离，报告 JSON/Markdown/HTML + 日志。 +- `scripts/siteforge_v817_audit.py`、`scripts/export_wordpress_url_baseline.py`：无写入生产副作用的验收与 URL 路径检查。 +- `scripts/browser_smoke.py`：登录上下文复用、Playwright Chromium 自动查找、用户可覆写可执行文件路径。 +- `.github/workflows/`：连续两轮 Python 测试、真实 Chromium CI 以及独立 PostgreSQL/Redis 只读检查。 +- `app/version.py`、Compose 镜像、相关测试断言、README、文档：版本升级与项目交付文档。 + +## 推荐下一验收步骤 + +将此 ZIP 在隔离环境部署，先跑 `bash scripts/check.sh` 与 `python scripts/http_end_to_end.py`，随后用已配置安全凭据的独立测试 PG/Redis + Docker 验收，确认浏览器和部署链路；最后复核真实 WordPress URL 及正式发布、回滚和备份恢复。 diff --git a/docs/V8_18_ENTERPRISE_HARDENING.md b/docs/V8_18_ENTERPRISE_HARDENING.md new file mode 100644 index 0000000..642b491 --- /dev/null +++ b/docs/V8_18_ENTERPRISE_HARDENING.md @@ -0,0 +1,65 @@ +# SiteForge Enterprise V8.18 — 企业底座实现与验收说明 + +> 2026-10-23 · 版本 `8.18.0-dev.1` · **开发集成版（不是生产上线批准）** + +## 本轮已实施代码 + +1. **PostgreSQL 灾备误操作保护**：当 `SITEFORGE_DATABASE_URL` 指向 PostgreSQL，原 SQLite `python -m app.backup` 立即拒绝执行，不会错误创建一份空 SQLite 备份。 +2. **PostgreSQL 专属离线灾备**：`app.pg_disaster_recovery` + `scripts/pg_disaster_recovery.py` 使用客户端 `pg_dump` custom 格式、`pg_restore --list`、媒体/构建文件清单和 SHA-256 校验，最后原子更名 ZIP；离线校验无需数据库。恢复仅允许**空 PostgreSQL 数据库 + 不存在的数据目录**，使用单事务 `pg_restore`，不覆盖线上站点。机密信息不会放在子进程命令行参数中。 +3. **SQLite→PostgreSQL 内容迁移**：`app.sqlite_pg_transfer` + `scripts/migrate_sqlite_to_postgres.py`：SQLite 在线备份 API 制作快照（前提仍要求业务停写），按外键顺序处理当前 51 张表，检查列覆盖和目标表为空（迁移登记表例外、必须 checksum 匹配），单 PostgreSQL 事务写入，逐表行数与 SHA-256 对账。目标库必须在停机维护期间运行全套初始化。 +4. **发布状态不确定时防重复执行**：`remote_deploy`/`remote_rollback` 在 Worker 租约过期、网络失败、超时或运行中取消后标记失败并要求管理员核对远端指针，禁止自动重试外部副作用。普通构建仍保留原有重试能力。 +5. **CI 验收扩充**：新增隔离 PostgreSQL 数据迁移端到端验证脚本；本地测试使用模拟 PG 协议和工具进程，并且严格区分模拟与真实 PG 证据。 + +## 一、禁止直接更新生产卷 + +新建独立测试环境，备份 V8.17 的数据库和共享存储。切换 SQLite→PG 是**运维迁移**而非自动覆盖 `.env`：不能仅把 SQLite 环境变量指向 PostgreSQL 后直接运行现有容器。系统代码、数据库、媒体目录和 `published` 卷是不同组件，必须统一维护窗口。 + +## 二、PostgreSQL 备份（维护窗口） + +以下命令在有 `pg_dump`、`pg_restore`、`psql` 的管理主机执行；客户端版本应不低于数据库服务器主版本（示例 PG 16）。须先停 Web 和所有 Worker，阻止数据库写入与媒体上传。 + +```bash +export SITEFORGE_DATABASE_URL='postgresql://backup_user:***@db-host:5432/siteforge?sslmode=verify-full&sslrootcert=/secure/ca.pem' +python scripts/pg_disaster_recovery.py backup --data /path/to/siteforge-data --output /external/backup-20261023.zip --confirmed-offline +python scripts/pg_disaster_recovery.py verify /external/backup-20261023.zip +``` + +不要把真实密码写到共享日志或 shell 历史；上例为占位符。建议使用安全的环境注入或管理员端凭据文件。`manifest.json` 的 SHA-256 证明读取后的完整性，**不证明备份来自可信发布者，也不代表进行了加密**。备份需转移到其他设备，配置保留策略和访问限制；`published` 独立卷还需要独立备份。 + +恢复必须**事先创建空 PostgreSQL 目标库**和**不存在的共享数据目录**，并使用新测试实例恢复验证： + +```bash +python scripts/pg_disaster_recovery.py restore-new /external/backup-20261023.zip --data /path/to/new-storage --confirmed-offline +``` + +不会自动切换服务或覆盖目标数据库。恢复后需再跑 `/api/ready`、内容/媒体、构建和发布链路的 E2E。数据库恢复和文件重命名跨系统不属于一个原子事务，失败时目标必须保持隔离，直到人工对账完成。 + +## 三、SQLite 数据升级到 PostgreSQL（数据库部分） + +1. **停站**：关闭 Web、所有 Worker、文件上传与计划任务，确保 SQLite 和媒体不再变动。 +2. **双重备份**：运行既有 SQLite 备份与源文件目录副本；将外部备份单独存储。 +3. **全新 PostgreSQL 库**：使用独立新库运行完整 SiteForge schema 初始化；允许 ledger 的既定行，其他业务表必须为空。 +4. **迁移数据**： + +```bash +export SITEFORGE_DATABASE_URL='postgresql://migration_user:***@db-host:5432/siteforge_stage?sslmode=require' +python scripts/migrate_sqlite_to_postgres.py --source /path/to/old/siteforge.sqlite3 --confirmed-offline --report /external/migration-evidence.json +``` + +5. **同步外部文件**：`/data/media`、`legacy`、`builds`、`archives` 与 `published` 卷独立同步/校验（迁移工具**不会**代替 rsync/对象存储迁移）；不要把两个新旧服务同时指向可写目录。 +6. **验证**：逐表行数/哈希、媒体 URL、静态质量报告和线上正式域名一致性；如有失败保持旧站继续服务。 +7. **切换**：预生产全部通过后再人工批准业务切换，保留源库与可回滚路径。 + +工具对旧 SQLite 数据库进行**只读备份快照**；向新 PostgreSQL 写入是显式 `--confirmed-offline` 才能执行的操作。导入使用单事务；建表（初始化）先于该事务，不等于整个目标库已经过生产级迁移验收。 + +## 四、多 Worker / Redis + +PostgreSQL 是权威任务队列，Redis 只负责唤醒通知；Redis 不可用时 Worker 回退数据库轮询，不能把 Redis 看作持久化任务存储。V8.18 对发布任务加上“结果不确定则不重试”防护，但**未获得真实 Docker 2+ Worker 并发、断电、丢包和故障切换证明**，不能宣布多实例高可用。 + +## 五、本轮验收证据限制 + +本地环境未安装 Docker Engine、PostgreSQL 客户端或 psycopg，无法声称完成真实 PG/Redis Docker 验收。新增脚本和自动化测试提供代码及 CI 入口；应在 GitHub Actions 隔离 postgres 服务上实际运行 `scripts/verify_pg_bootstrap.py` 和 `scripts/verify_sqlite_pg_transfer.py`，保存日志，然后在运维侧完成正式恢复演练。 + +## 六、尚未关闭的 V9.0 要求 + +Art Design Pro 官方前端完整工程编译集成、复杂 WordPress 插件迁移、企业 SSO/MFA、长期容灾、同域路径多语言、真实服务器发布验收，以及完整移动端体验均仍在后续工作范围内。 diff --git a/docs/V8_19_ART_UNIFIED_BACKEND.md b/docs/V8_19_ART_UNIFIED_BACKEND.md new file mode 100644 index 0000000..2490765 --- /dev/null +++ b/docs/V8_19_ART_UNIFIED_BACKEND.md @@ -0,0 +1,78 @@ +# SiteForge Enterprise V8.19 — 统一管理后台集成与验收手册 + +**版本**：8.19.0-dev.1（开发集成版） +**基线**：V8.18 完整源码 +**日期**：2026-10-23 +**状态**：业务代码、路由适配及后端接口已集成；Art Design Pro 官方完整源码不在交付包内，因此未执行官方 `pnpm build`，也未通过真实浏览器/线上反代验收。 + +## 1. 范围与已实现 + +- 新增 FastAPI `GET /api/console/bootstrap`：会话绑定的管理菜单、可见站点清单、指定站点权限能力清单；未授权站点返回 403。纯查询，不传递密钥或 CSRF token。 +- 新增 Vue `ConsoleHome.vue` 工作台、`ContentCenter.vue` 内容 CRUD 页面（调用已有 API，不复制业务数据库逻辑）。 +- 统一 Art 前端七个既有页面的请求错误/CSRF 同源处理与当前网站选择；通过 `_shared.ts` 获取服务端会话，权限**仍由后端检查**。 +- 官方路由只注册 **一个 `/siteforge` 导航树**，含工作台、网站管理、内容管理、网站设计、数据与迁移、构建与发布、系统管理；主题与 V8 高级工具隐藏为子路由，避免重复一级菜单。 +- 安装器支持 dry-run、幂等、文件冲突保护、备份、显式升级旧标记、SHA-256 安装核对。 +- SiteForge 登录页支持同站安全 `next=/siteforge/...` 返回路径；无跨域任意跳转。 + +## 2. 前置要求 + +1. 从官方网站获取 **Art Design Pro 官方完整源代码**、合法依赖和版本锁文件，确认对应的 `src/router/routes/asyncRoutes.ts` 结构。未提供源码时不得称为官方已经集成、编译成功。 +2. Node、pnpm 版本以该 Art 官方提交/锁文件要求为准。 +3. 采用 **一个 HTTPS 域名**承载 Art SPA 和 FastAPI API，统一 Session Cookie、CSRF 与 Host；不要通过跨域代理绕过后端 Session 与 CSRF。 +4. FastAPI 需保留 `/api/auth/login`、`/api/auth/me`、`/api/auth/logout` 权威登录路径。Art 演示账户和假 Token 不可作为正式 SiteForge 认证。 + +## 3. 安装程序 + +```bash +# 在 SiteForge 根目录（以下路径自行替换） +python scripts/install_into_art_design_pro.py /path/to/art-design-pro +python scripts/install_into_art_design_pro.py /path/to/art-design-pro --apply +python scripts/verify_art_design_pro_v819.py /path/to/art-design-pro + +# 安装了官方 npm 依赖后运行真正的编译（不是模拟） +cd /path/to/art-design-pro +pnpm install --frozen-lockfile +cd /path/to/siteforge +python scripts/verify_art_design_pro_v819.py /path/to/art-design-pro --build --report reports/v819-art-build.json +``` + +如果官方源码里已经存在旧 SiteForge 路由，**先备份源码**，并显式执行： + +```bash +python scripts/install_into_art_design_pro.py /path/to/art-design-pro --apply --migrate-legacy --overwrite-views +``` + +安装器不会删除第三方业务路由；当人工调整过已经安装的 V8.19 路由时，会拒绝自动覆盖，并要求人工审查差异。若旧业务页面曾被人工修改，升级前先对比 `.siteforge-backup`。 + +## 4. 同源反代 + +使用 `deploy/art-design-pro/siteforge-nginx.conf.example` 作为 **示例**，人工配置证书、SPA 根目录、Host、上游 IP。正式生产必须启用 `SITEFORGE_COOKIE_SECURE=true`。完整反向代理后逐一检查： + +- 登录页 `/login`、认证 `/api/auth/me`、管理接口 `/api/console/bootstrap`； +- Art 页面 `/siteforge/dashboard` 与 `/siteforge/content`； +- 页面设计 `/editor/{site}/{entry}`、预览 `/preview/...`、媒体 `/local-media/...`； +- 静态站构建与文件下载； +- 401/403 行为、CSRF POST 保护、Session 过期后跳转，以及移动端导航。 + +注意：Art 自带演示登录/用户菜单与 SiteForge 账户是**两套系统**。正式部署时必须关闭演示权限作为真实权限的假设，使用 SiteForge 会话作为权威身份；Art 路由的可见性只是界面提示，不可替代服务端授权。尚未实施企业 SSO。 + +## 5. 已完成/未完成门禁 + +| 验收项 | 状态 | +|---|---| +| 原项目自动化测试 | 本地可重复回归通过；原始日志随包交付 | +| 新工作台授权 API | 自动化测试通过 | +| Art 安装器模拟工程测试 | 自动化测试通过（仅验证适配逻辑） | +| HTTP 站点创建 → Worker 构建 → 下载 → 预览 | 本地端到端通过 | +| Art 官方 `pnpm build` | **未执行**（官方完整源码/依赖未提供） | +| PC 与移动端真实 Art UI | **未执行**（需官方工程构建和正常浏览器环境） | +| Nginx HTTPS + SameSite + Cookie/CSRF | **未执行**（需独立测试域名） | +| PostgreSQL/Redis/多 Worker/发布灾备 | 延续 V8.18 的独立生产验收门禁 | + +## 6. 尚需完善（下阶段） + +- 将 Art 登录体验与 SiteForge 后端 Session 完整合一（实际官方仓库必须可编译、完成端到端路由守卫）。 +- 企业功能导航按站点角色动态显示（本轮后端已提供能力清单，但 Art 全局动态菜单权限筛选未能在官方工程中实测）。 +- 完整移动端和桌面端视觉验收、内容编辑历史、发布审批操作的一致性审查。 +- 将高级生产控制台原有大部分遗留界面彻底迁入统一模块，避免跳出 SPA。 +- 生产 Nginx、真实 Art build、数据库、Redis 和部署回滚的独立环境验收。 diff --git a/docs/V8_20_COMPLEX_WORDPRESS.md b/docs/V8_20_COMPLEX_WORDPRESS.md new file mode 100644 index 0000000..8a8b35b --- /dev/null +++ b/docs/V8_20_COMPLEX_WORDPRESS.md @@ -0,0 +1,48 @@ +# SiteForge Enterprise V8.20 — WordPress 复杂迁移增强 + +版本：`8.20.0-dev.1`。此版本属于**开发集成版**，在 V8.19 完整源码上增加离线兼容预检、简单 ACF Repeater 结构保留、CSS 背景图本地化、批次暂存路径阻断。**不代表复杂 Elementor/ACF/WooCommerce 功能或设计已实现无损迁移。** + +## 1. 新增实际功能 + +- 新增 `app/wp_complex_v820.py`，使用 `defusedxml` 安全解析最多 16 MB、20,000 条记录的 WXR，按已发布内容发现 URL 冲突、动态参数 URL、复杂 Elementor、ACF 字段、PHP 序列化、自定义文章类型、WooCommerce 和动态短代码。 +- 新增后台 `POST /api/migrations/sites/{site_id}/wordpress/wxr-preflight`：`multipart/form-data` 的 `file` 字段，登录、CSRF 和站点 Editor 权限均必需。只读返回 JSON，不写站点数据，不访问外网。 +- 现有 `/production-v8` WordPress 面板新增“兼容性预检”按钮和结果区。 +- `app/importers.py` 直接 WXR 导入：带参数的动态 URL 或缺失原始路径现在拒绝导入，不再凭 slug 猜测路径；ACF 简单 Repeater 结构保留在 `meta.fields` 和 `meta.acf_repeaters` 中，原始字段仍保留供核对。 +- `app/v8_workflows.py` WXR 暂存：复用预检阻断危险旧 URL；不再将自定义文章类型错当成分类；复杂组件形成发布审核项。 +- `app/wp_migration_v82.py` 媒体本地化扩展至行内 CSS `url(https://...)`、`data-background`、`data-background-image` 与已有 `srcset`。只允许已授权主机的资源进入自动下载，其他 URL 需要单独审核。 +- 新增 `scripts/wp_v820_preflight.py`：离线生成 JSON/HTML 风险报告；可选 `--dist` 对比静态 HTML 路径覆盖。 + +## 2. 直接运行 + +在项目根目录： + +```bash +python scripts/wp_v820_preflight.py fixtures/v820/wordPress-complex-sample.xml --output reports/v820-demo.json +# 可选，待已经执行静态构建后： +python scripts/wp_v820_preflight.py export.xml --dist /absolute/path/to/build/dist --output reports/my-site.json +``` + +脚本返回码：`0` 表示没有识别到阻断问题且（如指定 `--dist`）没有发现缺失的 HTML 路径；`1` 表示出现阻断或缺失路径；`2` 表示输入、读取或 XML 解析失败。**退出码 0 不意味着布局或业务功能无损，人工审核仍是发布条件。** + +在统一后台选择网站 → 网站生产控制台 → WordPress 迁移 → 选择 WXR 文件 → 点击“检查旧 URL / Elementor / ACF / 动态功能”。 + +## 3. 风险与未完成项目 + +| 方向 | 当前实现 | 未完成的生产验收 | +|---|---|---| +| Elementor | 识别已支持/未知组件，有限静态 HTML 转换，保留原始 JSON | 容器布局、动态标签、全局样式、响应式精确还原、交互插件 | +| ACF | 单值字段、简单 Repeater 的有界结构提取；PHP 序列化只标记，不执行 | 字段组 schema、Flexible Content、嵌套 Repeater、关系字段、文件字段 | +| WooCommerce | 识别产品相关数据并列入审核 | 变体、价格策略、库存、购物车、结算、订单等动态服务 | +| 媒体 | 同源 HTTPS/HTTP 图片与 CSS 背景图引用分析及本地化 | 跨域 CDN 授权、尺寸变体资源、未引用附件、CSS 外链文件及版权许可 | +| URL/SEO | WXR 旧路径预检，静态构建路径核查，原有 SEO 差异工具 | 真正旧站的完整 Sitemap + robots + 分页 + 301 + Canonical 实测核对 | +| 插件功能 | 表单、动态短代码、iframe 标为风险 | CRM/表单业务重建与实际浏览器 E2E | + +WXR XML **不包含附件原文件，也不包含完整站点设置和全部插件配置**；需另行取得对应 WordPress 资源以及已获授权的插件数据。 + +## 4. 迁移作业建议 + +先备份 WordPress 原站、数据库与媒体文件；离线预检 WXR 和 Sitemap；修复阻断问题后按站点逐步暂存/提交数据；迁移 CSS/响应式图片及全部媒体；新旧站逐 URL 对账，再在独立预生产环境实测 PC/移动端布局、交互、SEO、动态表单及发布回滚。上线前必须完成每一个已识别风险的人工复核。 + +## 5. 测试证据边界 + +自动化使用本地固定 WXR、TestClient 和模拟媒体，禁止把这些结果描述为真实客户网站的迁移通过。V8.18 生产 PostgreSQL/Redis/Docker 多 Worker 与 Art Design Pro 官方工程编译仍未完成真实现场验收。本包不会自行连接或更改用户的生产网站。 diff --git a/docs/V8_21_1_STUDIO_UX.md b/docs/V8_21_1_STUDIO_UX.md new file mode 100644 index 0000000..54bf50b --- /dev/null +++ b/docs/V8_21_1_STUDIO_UX.md @@ -0,0 +1,51 @@ +# SiteForge V8.21.1 — 可视化编辑器体验增强 + +状态：`8.21.1-dev.1`，在 V8.21 源码基础上做前端编辑器的向后兼容升级。 + +## 已实际开发的内容 + +1. **页面区块面板**：按标题、类型、嵌套区块内容搜索；拖拽排序继续保留；新增上/下移动、显隐、复制和删除快捷操作；支持 Alt+↑/↓ 按键移动聚焦的结构行。 +2. **属性分区**：从单一长滚动面板拆分为「内容」「样式」「响应式」，多列布局与平板/手机跨度和显隐均放在响应式面板。 +3. **PC/平板/手机预览**：桌面自适应宽度、平板 780px、手机 390px；展示明确设备标签，窄屏可分别展开区块侧栏和属性侧栏。 +4. **页面刷新安全性**：所有预览请求使用 `AbortController` 取消上一个请求，并通过请求序号和页面 ID 双重核对；旧请求不得覆盖新预览。 +5. **草稿可靠保存**：调用保存接口前冻结请求数据，写入过程中若发生额外本地修改不会错误清除 dirty 标志；同一时间仅处理一项保存请求，页面切换时阻止混淆。 +6. **撤销与重做**：历史操作按钮可用状态实时更新；连续输入编辑合并短时间内的快照，提供 Ctrl/Cmd+S 快捷保存（前端输入框内保留浏览器默认编辑撤销行为）。 +7. **顶部操作层级**：保留高频保存/发布操作，低频的版本历史、全站设计、构建等放入「更多操作」菜单。移动端保存按钮仍可见。 +8. **测试辅助**：纯函数 `editor-helpers.js` 以 Node Test Runner 检验，新增浏览器烟测脚本（需要运行环境允许本机 HTTP）和可离线打开的静态交互演示。 + +## 安全与兼容约束 + +- 不修改已有页面 `blocks` JSON 数据模型、不新增生产数据库迁移；旧页面和已有 V8.21 草稿可以继续使用。 +- 仍使用原有 `PUT /studio-draft` 的 `expected_revision` 乐观锁、发布接口、站点权限及审批逻辑。页面草稿保存不会自动发布静态网站。 +- 编辑器 iframe 仍使用 `sandbox="allow-scripts"`，未添加 `allow-same-origin`。UI 表单不执行用户自定义代码。 +- **没有**实现无限自由定位、Figma 式像素编辑、复杂组件级协作锁、跨页面模板继承或官方 Art Design Pro 全工程真实编译。相关模块需要后续专项开发。 + +## 本次验证结果 + +- JavaScript 纯函数：6/6 通过（`node --test tests_js/editor_ux.test.cjs`）。 +- Python 编辑器专项和既有历史/映射：9/9 通过；新静态界面测试：3/3。 +- 现有 39 个 Python 测试模块**分段或独立运行**，累计 328 个用例通过；其中前六批计 215 项、批次 7 拆分运行计 26 项、余下独立模块 87 项。 +- HTTP + Worker 实际建站构建：通过（隔离临时 SQLite 环境）。 +- Python 编译、全部 `app/static/*.js` 语法校验、工程静态发布检查：通过。 +- 一键完整回归：**未通过完整单次执行门槛**，第七批发生进程停滞，已记录。独立模块通过不代表一键执行器稳定。 +- 真实 Chromium 操作：当前执行环境 `ERR_BLOCKED_BY_ADMINISTRATOR`，不计为通过；保留 `scripts/browser_studio_v8211.py` 供在 CI/开发机复测。 +- Docker/PostgreSQL/Redis/Art Design Pro 官方工程：未进行本轮真实环境验收。 + +## 运行与使用 + +```bash +python scripts/http_end_to_end.py +node --test tests_js/editor_ux.test.cjs +python -m pytest -q tests/test_editor_ux_v8211.py +python scripts/browser_studio_v8211.py # 需本地 Chromium、Playwright、本机 HTTP 访问权限 +``` + +网站编辑器继续通过 `/editor/{site_id}/{entry_id}` 访问。单独查看视觉交互可直接在浏览器打开 `examples/Studio_V8_21_1_交互预览.html`，该文件为**示例 UI**，不访问数据库也不是真实发布端。 + +## 后续计划 + +- 进行真实浏览器的 PC/平板/手机 E2E，并按操作可用性修复视觉缺陷； +- 实现嵌套 layout 子组件的独立属性选择、拖拽落点可视化与组件版本继承； +- 增加数据源联动的结构化表单编辑，而非复杂 JSON 文本框； +- 拿到 Art Design Pro 官方项目后进行完整编译及权限/路由集成验收； +- 排查一键测试执行器跨模块进程停滞并在 CI 设置稳定性门槛。 diff --git a/docs/V8_21_2_EASY_STUDIO.md b/docs/V8_21_2_EASY_STUDIO.md new file mode 100644 index 0000000..e19e6a1 --- /dev/null +++ b/docs/V8_21_2_EASY_STUDIO.md @@ -0,0 +1,61 @@ +# SiteForge V8.21.2 — 新手友好可视化编辑器 + +> 基于 V8.21.1 完整源码的易用性专项迭代。交付性质：**开发集成版**，未改动正式生产数据和已有网站区块 JSON 模型。 + +## 一、面向使用者的新操作流程 + +**1. 选择内容**：左侧选择正在编辑的页面；点击一个已有内容区块，或点击醒目的「＋ 添加内容区块」。区块库在不使用时自动折叠，左侧结构支持搜索和排序。 + +**2. 修改内容**：右侧默认展示内容字段；只有需要时才点击「样式」或「手机/平板」。支持在中间预览区直接单击一个带有 `data-block` 的区块，自动定位到右侧属性面板；原有双击文字编辑继续保留。 + +**3. 保存与发布**：右上角固定显示「保存草稿」「发布设计」。保存草稿使用原有 CSRF 与 `expected_revision` 乐观锁，不会自动改变正式构建；发布设计更新内容库，网站仍需完成后续静态构建与正式部署。版本历史、全站设置、构建等较少使用的操作集中在「更多」。 + +页眉下方新增 3 步提示，以及自愿打开的「新手使用指南」对话框，避免强制遮挡使用者。 + +## 二、实现改动 + +| 文件 | 说明 | +|---|---| +| `app/templates/editor.html` | 重排顶部主操作、三级简洁步骤、左侧页面/内容优先、结构化侧栏、帮助对话框；修复旧版更多菜单标记不清晰问题 | +| `app/static/editor.css` | 桌面/平板/手机布局、表单可读性、强调主操作、低频内容折叠、表单列表样式 | +| `app/static/editor.js` | 区块库显隐、步骤反馈、选择后定位属性面板、逐项编辑重复内容、预览点击区块的父页面消息处理 | +| `app/main.py` | 对编辑器预览中的 `[data-block]` 添加点击选择的桥接消息，并保持 `sandbox="allow-scripts"`（不启用同源权限） | +| `tests/test_editor_easy_v8212.py` | 布局唯一 ID、主操作位置、预览消息限制、后端兼容性等静态检查 | +| `examples/Studio_V8_21_2_新手友好版交互预览.html` | 离线、模拟数据的可操作示例；不写入任何真实站点 | + +### 对非技术人员的重大改善 + +- `features` 核心优势、`stats` 数字指标、`faq` 常见问题、`gallery` 图片画廊、`carousel` 轮播、`tabs` 标签页、`pricing` 服务方案：从 JSON 数组文本框改为「第 N 项 / 普通输入框 / 添加 / 删除 / 上下移动」。 +- 原有项目后台接口、页面数据结构、草稿快照及发布审批流程保持兼容；列表编辑只是前端输入方式改变。 +- 中间预览可点击区块实现选中；安全边界在父窗口同时检查 `event.source === frame.contentWindow` 与真实已加载 block ID。 + +## 三、当前测试记录 + +- 编辑器/设计器相关 pytest：28 项通过。 +- 内容历史、核心业务、旧版流程 pytest：30 项通过。 +- Node.js 编辑器工具函数：6 项通过。 +- Python 源码编译和 `editor.js` 语法检查通过；离线示例 JS 通过 Node.js 语法检查。 +- `python scripts/http_end_to_end.py`：通过 HTTP/CSRF/建站/Worker 构建/ZIP/预览。 +- **未执行**全项目一次性回归；既有版本的回归执行器有过偶发进程停滞，需在隔离 CI 上再做全量测试。 +- **未完成**完整 Chromium PC/移动端操作验收：本运行环境的 Chromium 截图启动超时，故不能宣称浏览器 E2E 通过。 +- **未完成**官方 Art Design Pro 全工程编译、生产 PostgreSQL/Redis 与真实发布环境验收。 + +## 四、运行方法 + +```bash +# 运行原 SiteForge 后端（环境配置保持原项目方式） +# 编辑器入口：/editor/{site_id}/{entry_id} +python -m pytest -q tests/test_editor_easy_v8212.py tests/test_editor_ux_v8211.py tests/test_studio_v86.py tests/test_site_design_v87.py +node --test tests_js/editor_ux.test.cjs +python scripts/http_end_to_end.py +``` + +离线预览可直接双击 `examples/Studio_V8_21_2_新手友好版交互预览.html`。演示中的保存/发布仅改变页面临时示例状态，不会调用任何线上 API。 + +## 五、仍需产品验收的体验问题 + +1. 真实 PC/移动端浏览器中验证侧栏展开、点击画布选中、键盘和焦点移动。 +2. 对复杂 `layout` 嵌套子组件实现更细的画布选中与属性编辑（当前点击子组件会定位其父布局区块）。 +3. 对图片上传和媒体选择增加直观的缩略图与拖拽；当前仍沿用旧媒体库交互。 +4. 组织非技术同事完成一次创建区块→修改→保存→发布的实操测试，依据其反馈再做收敛。 +5. 后续将本版业务页面真正装入 Art Design Pro 官方工程并执行 `pnpm build` 与浏览器集成。 diff --git a/docs/V8_21_3_MOBILE_THEMES.md b/docs/V8_21_3_MOBILE_THEMES.md new file mode 100644 index 0000000..a1848f1 --- /dev/null +++ b/docs/V8_21_3_MOBILE_THEMES.md @@ -0,0 +1,46 @@ +# SiteForge V8.21.3 — 四套主题移动端统一优化说明 + +## 当前基线结论 + +原 V8.21.2 的 automotive、industrial、corporate、minimal 四套内置专业主题具有基本响应式 CSS（移动端单列卡片、缩小标题、部分间距调整），但原导航在手机上是页眉下方的纵向展开列表，**不是独立抽屉**；没有底部快捷 Tabs 配置；因此不能将旧版称为全面完成移动端优化。V8.21.3 针对这些明确缺口做了源码级修改，并完成指定场景的浏览器验收。不能把 4 种代表页的验收当成所有页面和所有机型的充分验收。 + +## 新版功能 + +- 四套主题在 1024px 及以下使用右侧抽屉，点击汉堡按钮展开，多级目录可单独展开；移动端原“分类 Mega 菜单”链接合并进入抽屉。 +- 抽屉支持关闭按钮、遮罩、Escape、Tab 焦点约束以及关闭时焦点返回；支持页面跳转时关闭菜单。桌面导航保持原有样式。 +- 手机 767px 及以下可显示可选底部 Tabs，**默认关闭**，无任何按钮时也无需配置。启用后可添加 1–5 项，删除、上下排序、选择标题和预置图标、填写 URL，也可以配置一个“打开菜单”操作。 +- 链接允许站内路径（`/products/`）、`https://` 安全外链（如 WhatsApp）、`tel:` 与 `mailto:`；不允许 `javascript:`、`data:`、`http:`、协议相对地址或带用户名/密码的 HTTPS URL。存入数据库前全部由服务端校验。 +- 底栏自动适配设备安全区，启用时为页面底部预留空间以免遮挡内容；停用后没有额外留白。 +- 手机端卡片、图片、标题和文字区域增强窄屏 CSS；保留桌面模板、页面路径、SEO 数据、全站设计版本及发布审批模型。 + +## 管理后台操作 + +1. 进入目标网站的“可视化编辑器”，打开“全站页眉与页脚”。 +2. 找到“手机底部快捷导航 Tabs（可选）”。不开启时，手机页面**不显示**底栏。 +3. 开启后添加 1–5 个项目，分别填写文字、选择图标和点击操作；可上移、下移和删除。 +4. 可点击“预览草稿”查看当前编辑器预览；“保存全站草稿”**不会**修改已生成的网站；“发布全站设计”后，还需要重新构建网站并按既有流程部署。 +5. 手机菜单仍使用全站导航树，并继承二级、三级菜单结构。高级导航树的内容编辑入口仍保留原有 JSON 编辑方式；本轮重点是手机导航呈现，不是完全替换所有导航的配置方式。 + +## 实现文件 + +- `app/site_design_v87.py`：增加 `mobile_tabs` 配置、默认关闭、链接与图标字段校验、草稿隔离。 +- `app/theme_pro.py`：四套主题渲染上下文与预置图标。 +- `themes/{automotive,industrial,corporate,minimal}/pro.html`：按配置渲染底部栏与激活态。 +- `app/static/commercial.css`：统一右侧抽屉、遮罩、Tabs、手机端布局。 +- `app/static/pro.js`：菜单打开/关闭、焦点管理、Esc、滚动锁定、抽屉分类链接及底部菜单按钮。 +- `app/templates/editor.html`、`app/static/editor.js`：非 JSON 的 Tabs 增删、排序、名称、图标、路径配置。 +- `tests/test_mobile_tabs_v8213.py`、`scripts/browser_mobile_v8213.py`：专项验证。 + +## 验证范围 + +- Python：四个内置主题的真实静态构建、草稿隔离、发布生效、关闭后无 Tabs、非法链接与数据结构拦截。 +- Chromium：利用实际模板 HTML/CSS/JS 在 `page.set_content` 离线渲染，验证抽屉、遮罩、Esc、底栏菜单、桌面隐藏、脚本错误。对首页、产品列表、产品详情、文章详情分别用 375/390/430px 宽度检测水平溢出。 +- HTTP+Worker：原有登录、CSRF、建站、后台任务、构建、ZIP 和预览链路再次通过。 +- 浏览器执行环境不允许 Chrome 导航到 `file://` 和 localhost，因此浏览器检查采用 HTML/CSS/JS 内联加载方式；这**不等于**真实域名/CDN/移动设备端到端验收。 + +## 未关闭事项 + +- 用户上传的自定义第三方主题不在本轮四套内置主题的统一抽屉改造范围内。 +- 真实 iOS Safari、Android Chrome 实机和全部内页（如询盘、搜索、案例、FAQ）仍需专项验收。 +- Art Design Pro 官方完整工程的构建验证、正式 PostgreSQL/Redis/Docker 生产环境验收沿用前一版未关闭项。 +- 本版本只是开发集成版；发布静态站不会自动覆盖线上生产数据。 diff --git a/docs/V8_21_EDITOR_AND_MAPPING.md b/docs/V8_21_EDITOR_AND_MAPPING.md new file mode 100644 index 0000000..01ce017 --- /dev/null +++ b/docs/V8_21_EDITOR_AND_MAPPING.md @@ -0,0 +1,50 @@ +# SiteForge V8.21：可执行开发说明和验收边界 + +状态：**8.21.0-dev.1 开发集成版**。基于 V8.20 完整源码开发，未对用户生产环境执行升级。 + +## 页面编辑器历史 + +- 数据表 `studio_history`：site_id / entry_id / revision / kind(draft,published) / snapshot_json / snapshot_hash / actor / created_at。支持删除站点/页面后的级联清理，不额外泄露其他站点记录。 +- `GET /api/sites/{site}/pages/{entry}/studio-history?limit=30`：查看当前网站当前页面最近版本（1–100）；最低 viewer 权限。 +- `GET .../studio-history/{history_id}`：读取单个历史快照并验证 SHA-256；最低 viewer 权限。 +- `POST .../studio-history/{history_id}/restore`：请求体 `{"expected_revision":2}`；最低 editor 权限；采用乐观修订检查，只创建新的 studio_drafts 草稿，不调用静态构建，也不修改已发布内容。 +- 发布仍需要 owner 权限；发布后的页面必须单独执行正式静态构建和审批才能上线。 +- 历史表目前**未配置保留上限/外部归档**，大规模多人协作前应定义存储周期与审计导出策略。原先保存在本机浏览器会话里的撤销/重做仍可用，不属于持久化历史。 + +## 数据映射 + +旧式 `{ "title": "name" }` 规则保持兼容。新增可声明的字段处理（不能传入任意 SQL、JavaScript 或 Python）： + +```json +{ + "title": {"source":"name", "trim":true, "case":"upper", "prefix":"MODEL: "}, + "brand": {"source":"brand", "case":"lower", "default":"Unspecified"}, + "route": "old_url" +} +``` + +- `POST /api/factory/sites/{site}/mapping/run` 带 `dry_run:true` 返回 `plan_hash`、冲突列表、错误、示例数据。 +- 再调用该 API，传 `dry_run:false`、`expected_plan_hash` 及 `on_conflict: "abort"|"skip"|"replace"`。预检被其他人修改后拒绝旧指纹。建议以 `abort` 开始试点，数据修改需要明确选择 `replace`。 +- `plan_hash` 包含映射后的内容及相关已有记录完整状态，不包含远程认证信息；它是乐观变更检查**不是防篡改签名**，也不是跨进程数据库锁。 +- **限制**：当前装配持久化沿用原有逐条 `save_entry` 路径，不保证批次级 ACID 原子回滚。`abort` 可阻止预检时已知的错误和冲突，但不能承诺极端并发写入期间整批原子提交。批次回滚及并发事务化属于后续 P1 任务。 +- 每批最多 1,000 条，保持原有容量上限；映射不运行代码，也不会自动创造业务数据。 + +## UI + +- 原生编辑器 `/editor/{site}/{entry}` 新增「版本历史」弹窗与确认恢复；所有文案提示恢复仅生成草稿。 +- 原生网站工厂 `/factory-studio` 的内容导入新增字段变换、严格冲突策略和预检绑定；原有 Art Design Pro 官方工程尚未获得，因此未验证其实际 `pnpm build` 和完整业务端集成。 + +## 本地验收记录 + +- `38` 个测试模块分 10 组独立运行，共 `325 passed`；所有分组原始输出见 `reports/v821_manual_verified/`。 +- `python scripts/http_end_to_end.py`：通过登录/CSRF → 创建网站与页面 → Worker 构建 → ZIP → 预览。 +- `python scripts/verify_release.py`、`python -m compileall -q app` 以及 `node --check app/static/*.js`：通过。 +- 一键长流程在当前环境出现过停滞。已对 V8.21 执行器增加进程组超时清理，但其完整单次运行稳定性仍需独立 CI 复验；不计入上面的“通过”判定。 +- **未验收**：真实 PostgreSQL/Redis、Docker 多 Worker、浏览器/移动端视觉交互、真实 WordPress 复杂迁移、官方 Art Design Pro 编译、远程发布与回滚。 + +## 后续门槛 + +1. 建立隔离生产仿真环境，在 PostgreSQL 模式跑迁移/数据装配/编辑历史多进程用例并演练恢复。 +2. 使批量导入具有数据库级事务一致性、导入版本差异和可回滚工作流。 +3. 将编辑器版本历史组件并入 **官方** Art Design Pro 工程，覆盖桌面与移动端真实浏览器 E2E。 +4. 扩展整站模板与组件级版本继承、协作审批及内容设计依赖图。 diff --git a/examples/Studio_V8_21_1_交互预览.html b/examples/Studio_V8_21_1_交互预览.html new file mode 100644 index 0000000..3bdfca9 --- /dev/null +++ b/examples/Studio_V8_21_1_交互预览.html @@ -0,0 +1,13 @@ +SiteForge Studio UX · 离线演示 + +
Visual Studio · V8.21.1首页 / 版式编辑
+
+
实时预览 / 桌面端
演示数据 · 不连接网站
HESU AUTOHOME　PRODUCTS　 GLOBAL NETWORK　 ABOUT　CONTACT
CHINA SOURCING · GLOBAL DELIVERY

Your Global Automotive Partner

Connecting vehicle sourcing, global logistics and local delivery through one integrated solution.

EXPLORE SOLUTIONS →
Global Sourcing

Discover a wide range of automotive solutions.

Reliable Delivery

International logistics and export expertise.

Local Support

After-sales and overseas delivery network.

预览不等于发布PC / Tablet / Mobile
+
+ diff --git a/examples/Studio_V8_21_2_新手友好版交互预览.html b/examples/Studio_V8_21_2_新手友好版交互预览.html new file mode 100644 index 0000000..8008118 --- /dev/null +++ b/examples/Studio_V8_21_2_新手友好版交互预览.html @@ -0,0 +1,37 @@ +SiteForge · 简洁可视化编辑器交互预览 +
HESU Auto首页 / 页面设计
已载入演示
更多 ▾
+
只需 3 步① 选择或添加内容→② 修改右侧属性→③ 保存并发布
+
+
实时预览 · 已更新/
HESU AUTO · China Sourcing. Global Delivery.
电脑预览 · 内容修改实时显示；演示操作不会修改正式网站
+
+

3 分钟学会页面编辑

  1. 选择页面内容：左侧点一个区块，或者点橙色“添加内容区块”。
  2. 修改文字和样式：在右侧改标题、简介、颜色；中间预览会同步更新。
  3. 保存与发布：保存草稿并不更新正式网站。正式项目还需要发布设计、构建和部署。

本页面是可独立操作的 UI 演示，数据只保留在当前浏览器页面，不连接服务器。

 + diff --git a/examples/evidence.template.json b/examples/evidence.template.json new file mode 100644 index 0000000..0edce6b --- /dev/null +++ b/examples/evidence.template.json @@ -0,0 +1,12 @@ +{ + "isolated_pg": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "redis_ping": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "docker_health": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "backup_restore": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "browser_smoke": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "wordpress_url_parity": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "staging_deploy": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "rollback": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "production_approval": {"status": "pending", "operator": "", "date": "", "evidence": ""}, + "art_design_pro": {"status": "pending", "operator": "", "date": "", "evidence": ""} +} diff --git a/examples/mobile-showcase/automotive/article.html b/examples/mobile-showcase/automotive/article.html new file mode 100644 index 0000000..c140fbf --- /dev/null +++ b/examples/mobile-showcase/automotive/article.html @@ -0,0 +1,13 @@ +企业动态与行业资讯跳转至正文 + + +
联系我们 ↗
+
LATEST NEWS / INSIGHTS

企业动态与行业资讯

了解最新项目与服务进展

项目背景

这是一段用于检查手机端资讯排版的样例正文。适当的字距、行距和图片宽度能够提升移动阅读体验。

← 返回新闻
+ +
+
LET'S CONNECT

从这里开始下一步。

专业车辆采购与全球交付

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/automotive/assets/blocks.css b/examples/mobile-showcase/automotive/assets/blocks.css new file mode 100644 index 0000000..9ce1279 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/blocks.css @@ -0,0 +1,29 @@ +/* Portable SiteForge blocks, loaded with every theme (all styles scoped to sf-). */ +.sf-section{background:var(--sf-bg,transparent);color:var(--sf-fg,inherit);padding:var(--sf-pad,82px) 0;margin:0}.sf-section:nth-of-type(even){background:var(--sf-bg,#f4f6f9)}.sf-container{max-width:1200px;margin:auto;padding:0 32px}.sf-section h1,.sf-section h2,.sf-section h3,.sf-section p{color:inherit;line-height:1.3}.sf-section h1{font-size:clamp(38px,5vw,76px);font-weight:790;letter-spacing:-.052em}.sf-section h2{font-size:clamp(27px,3.2vw,44px);font-weight:760;letter-spacing:-.037em}.sf-kicker{display:block;font-size:12px;letter-spacing:.17em;text-transform:uppercase;font-weight:740;color:var(--accent,#3569d3);margin-bottom:18px}.sf-hero-grid,.sf-image-text{display:grid;grid-template-columns:1.08fr .92fr;gap:68px;align-items:center}.sf-hero-copy p{font-size:18px;line-height:1.75;max-width:520px;opacity:.75}.sf-hero-img,.sf-image-side{overflow:hidden;border-radius:9px;min-height:380px;background:linear-gradient(130deg,#d5e1ee,#eef3f9);display:grid;place-items:center}.sf-hero-img img,.sf-image-side img{width:100%;height:100%;max-height:580px;object-fit:cover}.sf-hero-abstract{font-size:110px;color:#a7bdd4}.sf-button{display:inline-flex;align-items:center;justify-content:center;gap:28px;background:var(--accent,#315ee2);color:white!important;padding:16px 26px;border-radius:6px;font-size:14px;text-decoration:none;font-weight:720;margin-top:24px}.sf-section-head{display:flex;align-items:end;justify-content:space-between;margin-bottom:32px;gap:24px}.sf-section-head h2{margin:0}.sf-section-head>a,.sf-link{color:var(--accent,#3569d3);font-weight:700;text-decoration:none}.sf-prose{font-size:16px;line-height:1.85;max-width:930px}.sf-prose p{line-height:1.85}.sf-features,.sf-collection,.sf-stats{display:grid;gap:20px}.sf-features{grid-template-columns:repeat(3,minmax(0,1fr))}.sf-feature{border:1px solid #e0e6eb;padding:32px 28px;border-radius:8px;background:#fff;color:#253247}.sf-feature>span{font-size:12px;font-weight:800;color:var(--accent,#346add)}.sf-feature h3{font-size:22px;margin:30px 0 8px}.sf-feature p{font-size:14px;line-height:1.7;color:#647181}.sf-stats{grid-template-columns:repeat(4,1fr);padding:40px 0;border-top:1px solid #b7c0cd66;border-bottom:1px solid #b7c0cd66}.sf-stats>div{display:flex;flex-direction:column;gap:8px}.sf-stats strong{font-size:clamp(28px,4vw,53px);letter-spacing:-.04em}.sf-stats span{font-size:12px;opacity:.65;letter-spacing:.04em}.sf-collection{grid-template-columns:repeat(var(--sf-cols,3),minmax(0,1fr))}.sf-item{display:block;text-decoration:none;color:#233044;background:#fff;border:1px solid #e8edf1;border-radius:8px;overflow:hidden;transition:transform .2s,box-shadow .2s}.sf-item:hover{transform:translateY(-4px);box-shadow:0 18px 38px #344d7018}.sf-item-img{height:210px;overflow:hidden;background:#e4eaf0}.sf-item-img img{height:100%;width:100%;object-fit:cover}.sf-placeholder{display:grid;place-items:center;width:100%;height:100%;min-height:190px;background:linear-gradient(130deg,#e2eaf2,#c9d7e6);font-size:72px;color:#8399b2;font-weight:800}.sf-large{min-height:360px}.sf-item-copy{padding:25px}.sf-item-copy small{text-transform:uppercase;letter-spacing:.13em;color:var(--accent,#376edc)}.sf-item-copy h3{font-size:22px;margin:12px 0 7px}.sf-item-copy p{font-size:14px;line-height:1.6;color:#7a8796;min-height:42px}.sf-item-copy span{font-size:12px;color:var(--accent,#376edc);font-weight:800}.sf-image-text>div>p{font-size:17px;line-height:1.8;max-width:520px;opacity:.7}.sf-reverse>div:first-child{order:2}.sf-gallery{display:grid;grid-template-columns:repeat(3,1fr);gap:15px}.sf-gallery img{width:100%;height:230px;object-fit:cover;border-radius:6px}.sf-faq{max-width:920px}.sf-faq details{border-bottom:1px solid #dce3eb;padding:22px 0}.sf-faq summary{font-size:17px;cursor:pointer;font-weight:700}.sf-faq p{color:#647181;line-height:1.75}.sf-cta-wrap{display:flex;justify-content:space-between;align-items:center;gap:24px}.sf-cta-wrap h2{margin:0}.sf-cta-wrap p{font-size:16px;opacity:.75}.sf-section a{cursor:pointer}.sf-muted{opacity:.65} +@media(max-width:820px){.sf-container{padding:0 20px}.sf-section{padding:50px 0}.sf-hero-grid,.sf-image-text{grid-template-columns:1fr;gap:26px}.sf-reverse>div:first-child{order:initial}.sf-hero-img,.sf-image-side{min-height:250px}.sf-features,.sf-collection{grid-template-columns:repeat(2,minmax(0,1fr))}.sf-stats{grid-template-columns:repeat(2,1fr)}.sf-cta-wrap{align-items:flex-start;flex-direction:column}} +@media(max-width:540px){.sf-features,.sf-collection,.sf-gallery{grid-template-columns:1fr}.sf-section-head{display:block}.sf-section-head>a{display:block;margin-top:13px}.sf-item-img{height:220px}.sf-hero-grid{gap:22px}.sf-hero-copy p{font-size:16px}.sf-stats{gap:28px}} + +.sf-attributes{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:0 32px;border-top:1px solid #e5eaf0}.sf-attribute{display:flex;justify-content:space-between;align-items:center;gap:18px;border-bottom:1px solid #e5eaf0;padding:19px 10px;font-size:14px}.sf-attribute span{color:#748497}.sf-attribute strong{font-weight:720;text-align:right}@media(max-width:640px){.sf-attributes{grid-template-columns:1fr}} + +/* SiteForge responsive no-code grid container */ +.sf-layout-grid{display:grid;grid-template-columns:var(--sf-layout-cols,1fr 1fr);gap:var(--sf-layout-gap,24px);align-items:stretch} +.sf-layout-column{min-width:0}.sf-layout-column>.sf-section{padding:0;margin:0 0 18px}.sf-layout-column .sf-container{width:100%;padding:0} +.sf-layout-column>.sf-section:last-child{margin-bottom:0} +@media(max-width:820px){.sf-layout-grid{grid-template-columns:repeat(2,minmax(0,1fr))!important}} +@media(max-width:540px){.sf-layout-grid{grid-template-columns:minmax(0,1fr)!important}} + +/* V8.6: accessible, script-free commercial design blocks */ +.sf-slides{display:flex;gap:18px;overflow-x:auto;scroll-snap-type:x mandatory;padding:6px 0 18px;scrollbar-width:thin} +.sf-slide{flex:0 0 min(78%,720px);min-width:220px;margin:0;scroll-snap-align:start} +.sf-slide img{width:100%;aspect-ratio:16/9;object-fit:cover;border-radius:10px} +.sf-slide figcaption{padding:10px 2px;opacity:.7;font-size:14px} +.sf-video{aspect-ratio:16/9;max-width:1000px;background:#ebf0f5;border-radius:10px;overflow:hidden} +.sf-video iframe{width:100%;height:100%;border:0} +.sf-tab{padding:19px 0;border-bottom:1px solid #dde4ec;max-width:960px} +.sf-tab summary{font-size:18px;font-weight:700;cursor:pointer}.sf-tab p{max-width:850px;line-height:1.8} +.sf-prices{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:18px} +.sf-price{padding:28px;background:#fff;border:1px solid #dee5ef;border-radius:10px;color:#29394b} +.sf-price strong{display:block;font-size:27px;margin:14px 0}.sf-price li{margin:11px 0}.sf-price ul{padding-left:19px} +.sf-map-address{font-style:normal;font-size:18px;white-space:pre-line;line-height:1.8} +@media (prefers-reduced-motion:reduce){.sf-slides{scroll-behavior:auto}.sf-item{transition:none}} +@media(max-width:540px){.sf-slide{flex-basis:92%}} diff --git a/examples/mobile-showcase/automotive/assets/commercial.css b/examples/mobile-showcase/automotive/assets/commercial.css new file mode 100644 index 0000000..353bee4 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/commercial.css @@ -0,0 +1,84 @@ +/* SiteForge commercial theme UX layer: accessibility, layout rhythm, media, responsive navigation. */ +:root{--sf-shadow:0 20px 55px rgba(17,33,55,.08);--sf-shadow-hover:0 26px 65px rgba(17,33,55,.15)} +html{scroll-padding-top:104px}body{font-feature-settings:"kern";text-rendering:optimizeLegibility} +a,button,input,select,textarea{-webkit-tap-highlight-color:transparent} +a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:3px solid var(--pro-accent);outline-offset:4px} +.pro-wrap{width:100%;max-width:min(var(--pro-wide),100%)}.pro-header{isolation:isolate;box-shadow:0 1px 0 rgba(15,35,60,.035)}.pro-head-inner{gap:clamp(15px,2vw,29px)}.pro-logo{min-width:0;flex-shrink:0;gap:12px}.pro-brand-logo{max-width:155px;max-height:46px;width:auto;height:auto;object-fit:contain}.pro-logo-name{overflow-wrap:anywhere}.pro-navigation{gap:clamp(11px,1.6vw,24px)}.pro-header-cta{white-space:nowrap} +.pro-mobile-toggle,.pro-catalog-toggle,.pro-nav-disclose{border:0;background:transparent;color:inherit;line-height:1.2} +.pro-mobile-toggle{min-height:44px;min-width:44px;border:1px solid currentColor;border-radius:6px;font-size:19px}.pro-nav-group{position:relative;display:flex;align-items:center;gap:2px} +.pro-nav-disclose{padding:9px;font-size:13px}.pro-nav-children{position:absolute;top:100%;left:0;min-width:215px;max-width:330px;display:grid;gap:2px;padding:13px;box-shadow:var(--sf-shadow);border-radius:10px;z-index:45;background:var(--pro-background);border:1px solid var(--pro-border);color:var(--pro-text)} +.pro-nav-children[hidden],.pro-mega[hidden]{display:none!important}.pro-nav-children a{display:block;font-size:13px;white-space:normal;padding:10px;border-radius:5px}.pro-nav-children a:hover{background:var(--pro-surface)} +.pro-catalog-toggle{padding:11px 3px;white-space:nowrap;font-size:12px;font-weight:700}.pro-mega{position:absolute;top:100%;left:50%;transform:translateX(-50%);width:min(100%,var(--pro-wide));box-shadow:var(--sf-shadow);z-index:41;display:grid;grid-template-columns:215px 1fr;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);border-radius:0 0 15px 15px;padding:29px;align-items:start}.pro-mega>span{font-size:12px;letter-spacing:.06em}.pro-mega>div{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:9px 22px;overflow:visible}.pro-mega>div a{white-space:normal;padding:10px 5px;border-bottom:1px solid var(--pro-border)} +.pro-home-hero{overflow:hidden}.pro-home-hero .pro-home-grid{min-height:660px;gap:5%}.pro-home-hero .pro-hero-copy{position:relative;z-index:2}.pro-home-hero .pro-hero-copy h1{font-size:clamp(46px,5.7vw,92px);line-height:1.06;letter-spacing:-.064em;max-width:15ch}.pro-home-hero .pro-hero-copy h1 em{font-style:normal;display:block}.pro-home-hero .pro-hero-copy p{font-size:clamp(15px,1.3vw,19px);line-height:1.75;max-width:44ch}.pro-home-hero .pro-hero-art{min-width:0;min-height:425px;position:relative;isolation:isolate}.pro-home-hero .pro-hero-art>img{width:100%;height:100%;object-fit:cover;position:absolute;inset:0}.pro-hero-art:has(.pro-abstract-car),.pro-hero-art:has(.pro-technical),.pro-hero-art:has(.pro-corporate-shape){background-position:center;background-size:cover;background-repeat:no-repeat}.pro-abstract-car,.pro-technical,.pro-corporate-shape{position:relative;z-index:1;pointer-events:none} +.pro-hero-actions{display:flex;flex-wrap:wrap;align-items:center;gap:15px}.pro-button,.pro-header-cta,.pro-outline-button{min-height:48px;transition:transform .24s ease,box-shadow .24s ease,opacity .24s ease}.pro-button:hover,.pro-header-cta:hover,.pro-outline-button:hover{transform:translateY(-2px);box-shadow:0 10px 22px rgba(0,0,0,.10)} +.pro-section{padding-top:clamp(76px,7vw,112px)!important;padding-bottom:clamp(76px,7vw,112px)!important}.pro-section-head{gap:16px}.pro-section-head h2{font-size:clamp(32px,3.5vw,53px);max-width:22ch}.pro-section-head .pro-text-link{align-self:end} +.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.pro-card{min-width:0;display:flex;flex-direction:column;transition:transform .28s ease,box-shadow .28s ease;border:1px solid var(--pro-border);background:var(--pro-background);overflow:hidden}.pro-card:hover{transform:translateY(-6px);box-shadow:var(--sf-shadow-hover)}.pro-card-cover{aspect-ratio:1.42;overflow:hidden;background:var(--pro-surface);position:relative}.pro-card-cover .pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .45s ease}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-card-body{display:flex;flex-direction:column;flex:1}.pro-card-body h3{font-size:clamp(19px,1.6vw,24px);line-height:1.26}.pro-card-body p{font-size:14px}.pro-card-link{margin-top:auto;padding-top:14px;font-size:13px;font-weight:700} +.pro-art{min-height:100%;width:100%;position:relative;overflow:hidden;display:grid;place-items:center;isolation:isolate}.pro-art-ring{width:60%;aspect-ratio:1;border:1px solid currentColor;opacity:.13;border-radius:50%;transform:rotate(20deg);box-shadow:0 0 0 23px #ffffff10,0 0 0 57px #ffffff07}.pro-art-center{font-size:clamp(38px,5vw,80px);position:absolute;font-weight:800;letter-spacing:-.065em;opacity:.65}.pro-art-label{position:absolute;bottom:19px;left:22px;font-size:10px;letter-spacing:.22em;opacity:.7} +.pro-breadcrumb{display:flex;gap:11px;flex-wrap:wrap;font-size:12px;align-items:center}.pro-breadcrumb a{text-decoration:underline;text-underline-offset:4px}.pro-product-hero{align-items:start;gap:clamp(28px,5vw,80px)}.pro-product-media{aspect-ratio:1.12;background:var(--pro-surface);overflow:hidden}.pro-product-media>img,.pro-product-media>.pro-art{width:100%;height:100%;object-fit:contain}.pro-product-summary{padding:clamp(12px,3vw,50px) 0}.pro-product-summary h1{font-size:clamp(36px,4.3vw,72px)}.pro-detail-layout{border-top:1px solid var(--pro-border);padding-top:50px}.pro-specs>div{display:grid;grid-template-columns:minmax(100px,40%) 1fr;gap:10px;align-items:baseline;padding:15px 0;border-bottom:1px solid var(--pro-border)}.pro-specs strong{overflow-wrap:anywhere}.pro-gallery-thumbs button{flex-basis:96px;height:76px}.pro-gallery-lightbox{backdrop-filter:blur(6px)} +.pro-filter-panel{display:flex;align-items:end;flex-wrap:wrap;gap:16px;background:var(--pro-surface);border:1px solid var(--pro-border);padding:20px;margin-bottom:25px;border-radius:var(--pro-radius)}.pro-filter-panel label{display:grid;gap:7px;min-width:180px;flex:1}.pro-filter-panel input,.pro-filter-panel select{width:100%;background:var(--pro-background);border:1px solid var(--pro-border);padding:12px 14px;color:var(--pro-text);border-radius:6px}.pro-filter-count{white-space:nowrap;font-size:13px;padding:12px 0}.pro-card[hidden]{display:none!important}.pro-filter-empty{padding:38px;border:1px dashed var(--pro-border);text-align:center;grid-column:1/-1} +.pro-inquiry input,.pro-inquiry textarea{min-height:46px}.pro-inquiry textarea{min-height:150px}.pro-inquiry-wrap{gap:clamp(32px,7vw,110px)}.pro-inquiry .pro-button{border:0;justify-self:start}.pro-footer-links a{padding-block:5px;display:inline-block} +.pro-end-cta{overflow:hidden}.pro-end-cta h2{font-size:clamp(30px,4vw,64px)} +.pro-rich{line-height:1.85}.pro-rich img{border-radius:var(--pro-radius);margin-block:24px}.pro-rich table{width:100%;display:block;overflow:auto;border-collapse:collapse}.pro-rich td,.pro-rich th{border:1px solid var(--pro-border);padding:10px 14px}.pro-rich a{text-decoration:underline;text-underline-offset:3px} +@media(min-width:1025px){.pro-navigation>.pro-nav-group:hover .pro-nav-children:not([hidden]){visibility:visible}} +@media(max-width:1150px){.pro-head-inner{gap:15px}.pro-navigation{gap:12px}.pro-logo-name{font-size:15px}.pro-header-cta{padding:13px 16px}} +@media(max-width:1024px){.pro-head-inner{min-height:72px;flex-wrap:wrap}.pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto}.pro-navigation{display:none;width:100%;flex-basis:100%;flex-direction:column;align-items:stretch;gap:0;order:5;margin:0;padding:8px 0 20px;border-top:1px solid var(--pro-border)}.pro-navigation.is-open{display:flex}.pro-navigation>a,.pro-nav-group>a{padding:14px 8px;font-size:15px}.pro-nav-group{display:flex;flex-wrap:wrap;justify-content:space-between}.pro-nav-children{position:static;flex-basis:100%;max-width:none;width:100%;box-shadow:none;border-radius:0;border-left:2px solid var(--pro-accent);margin:0 0 12px 8px}.pro-nav-disclose{min-width:44px;min-height:44px}.pro-catalog-toggle{margin-left:auto}.pro-mega{top:100%;display:block;padding:20px}.pro-mega>div{grid-template-columns:repeat(2,minmax(0,1fr));margin-top:12px}.pro-home-hero .pro-home-grid{min-height:560px}.pro-home-hero .pro-hero-art{min-height:325px}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}} +@media(max-width:700px){.pro-wrap{padding-left:20px;padding-right:20px}.pro-utility{display:none}.pro-head-inner{min-height:66px}.pro-logo-name{max-width:140px;font-size:14px}.pro-brand-logo{max-width:125px}.pro-header-cta{display:none}.pro-catalog-toggle{font-size:11px;padding-inline:7px;margin-left:0}.pro-home-hero .pro-home-grid{display:flex;flex-direction:column;gap:36px;padding-top:48px;padding-bottom:48px}.pro-home-hero .pro-hero-copy h1{font-size:clamp(43px,10vw,68px)}.pro-home-hero .pro-hero-copy p{font-size:15px}.pro-home-hero .pro-hero-art{width:100%;min-height:290px}.pro-home-hero .pro-hero-bottom{display:none}.pro-section{padding-top:68px!important;padding-bottom:68px!important}.pro-section-head{align-items:flex-start}.pro-grid{grid-template-columns:1fr;gap:18px}.pro-card-cover{aspect-ratio:1.45}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-inquiry-wrap{display:grid;grid-template-columns:1fr;gap:30px}.pro-product-summary{padding:0}.pro-specs>div{grid-template-columns:1fr 1fr}.pro-mega{top:100%;max-height:65vh;overflow-y:auto}.pro-mega>div{grid-template-columns:1fr}.pro-filter-panel{display:grid;grid-template-columns:1fr;gap:12px}.pro-filter-panel label{min-width:0}.pro-footer-top{display:grid;grid-template-columns:1fr;gap:27px}.pro-footer-bottom{gap:12px;flex-wrap:wrap}} +@media(max-width:410px){.pro-logo-name{max-width:115px}.pro-logo-symbol{font-size:28px}.pro-catalog-toggle{font-size:10px}.pro-mobile-toggle{min-width:42px}} +@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*:before,*:after{animation-duration:.01ms!important;transition-duration:.01ms!important;scroll-behavior:auto!important}} + +/* Accessible static catalogue pagination for large inventories. */ +.pro-pages-nav{display:flex;gap:1rem;justify-content:center;align-items:center;margin:2rem 0;flex-wrap:wrap} +.pro-pages-nav a{padding:.7rem 1.1rem;border:1px solid currentColor;border-radius:.4rem;text-decoration:none} +.pro-pages-nav a:focus-visible{outline:3px solid var(--accent,#2563eb);outline-offset:3px} +.pro-pages-nav span{font-size:.875rem} + +/* P6 international sites: small, keyboard-operable language switch. */ +.sf-language-switch{display:inline-flex;gap:6px;align-items:center;flex-wrap:wrap;margin:8px 12px;padding:4px;border:1px solid rgba(120,130,145,.22);border-radius:10px;background:rgba(255,255,255,.08)} +.sf-language-switch a{font:inherit;font-size:12px;line-height:1.5;padding:4px 7px;border-radius:6px;color:inherit;text-decoration:none} +.sf-language-switch a[aria-current="page"]{font-weight:700;text-decoration:underline;text-underline-offset:3px} +.sf-language-switch a:focus-visible{outline:2px solid #2563eb;outline-offset:3px} +@media(max-width:640px){.sf-language-switch{margin:6px 0;width:auto}} + +/* V8.21.3 — Four-theme unified mobile off-canvas navigation & optional tab bar. + Desktop remains unchanged. Phone / tablet use one accessible drawer. */ +.sf-mobile-tabs{display:none!important} +.sf-drawer-header,.sf-mobile-drawer-backdrop,.sf-drawer-extra{display:none} +@media(max-width:1024px){ + .pro-head-inner{flex-wrap:nowrap!important;gap:12px!important} + .pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto!important;flex:0 0 44px;min-width:44px;min-height:44px;position:relative;z-index:3} + .pro-catalog-toggle{display:none!important} + .pro-navigation,.pro-navigation.is-open{display:flex!important;position:fixed!important;inset:0 0 0 auto!important;width:min(88vw,360px)!important;height:100dvh!important;height:100vh;max-height:100dvh!important;flex:unset!important;flex-direction:column!important;align-items:stretch!important;order:unset!important;margin:0!important;padding:0 0 calc(20px + env(safe-area-inset-bottom,0px))!important;overflow-x:hidden;overflow-y:auto!important;background:var(--pro-background,#fff)!important;color:var(--pro-text,#19283c)!important;border:0!important;border-left:1px solid var(--pro-border,#ddd)!important;box-shadow:-15px 0 45px #0002!important;z-index:1201!important;transform:translateX(105%);visibility:hidden;pointer-events:none;transition:transform .24s ease,visibility .24s ease!important;overscroll-behavior:contain} + .pro-navigation.is-open{transform:translateX(0);visibility:visible;pointer-events:auto} + .sf-drawer-header{display:flex!important;align-items:center;justify-content:space-between;gap:12px;padding:20px 18px;border-bottom:1px solid var(--pro-border,#dde3e9);font-size:17px;font-weight:750;position:sticky;top:0;background:var(--pro-background,#fff);z-index:2} + .sf-drawer-close{min-width:44px;min-height:44px;border:1px solid var(--pro-border,#dde3e9);color:inherit;background:transparent;border-radius:10px;font-size:24px;cursor:pointer} + .sf-mobile-drawer-backdrop{display:block;position:fixed;inset:0;z-index:1200;background:#0b1b31a3;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .24s ease,visibility .24s ease} + .sf-mobile-drawer-backdrop.is-open{opacity:1;visibility:visible;pointer-events:auto} + body.sf-drawer-open{overflow:hidden!important} + .pro-navigation>a,.pro-navigation .pro-nav-group>a,.pro-navigation .sf-drawer-extra>a{display:flex;align-items:center;min-height:50px;padding:13px 20px!important;font-size:15px!important;color:inherit!important;white-space:normal;border-bottom:1px solid var(--pro-border,#dde3e9)!important;text-decoration:none!important} + .pro-navigation .pro-nav-group{display:flex;position:relative;flex-wrap:wrap!important;width:100%;gap:0;align-items:center;justify-content:space-between} + .pro-navigation .pro-nav-group>a{flex:1;min-width:0} + .pro-navigation .pro-nav-disclose{margin-right:12px;min-width:44px;min-height:44px;border-radius:9px;background:var(--pro-surface,#f4f6f8)} + .pro-navigation .pro-nav-children{position:static!important;width:100%!important;max-width:100%!important;box-shadow:none!important;border-left:3px solid var(--pro-accent,#e77730);border-radius:0!important;margin:0 0 8px 14px!important;flex-basis:calc(100% - 14px)!important;background:var(--pro-surface,#f6f8fa)} + .pro-navigation .pro-nav-children a{padding:12px 16px!important;font-size:14px!important;color:inherit!important;min-height:44px} + .sf-drawer-extra{display:block;padding:12px 0 5px}.sf-drawer-extra strong{display:block;font-size:12px;letter-spacing:.06em;padding:12px 20px;opacity:.65}.sf-drawer-extra a{font-size:14px!important} + .sf-drawer-close:focus-visible,.pro-mobile-toggle:focus-visible,.pro-nav-disclose:focus-visible,.sf-mobile-tab:focus-visible{outline:3px solid var(--pro-accent,#ff8200);outline-offset:2px} +} +@media(max-width:767px){ + .pro-header-cta{display:none!important} + .pro-head-inner .pro-logo{min-width:0;max-width:calc(100% - 65px)} + .pro-logo-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .pro-home-hero .pro-home-grid{min-height:0!important} + .pro-home-hero .pro-hero-art{min-height:230px} + .pro-card,.pro-card-cover,.pro-product-media{max-width:100%;min-width:0} + .pro-rich img,.pro-content img,.sf-canvas img{max-width:100%;height:auto} + .pro-rich table{max-width:100%;overflow:auto} + .pro-grid,.pro-footer-top{min-width:0} + .sf-mobile-tabs{display:grid!important;position:fixed;z-index:1100;bottom:0;left:0;right:0;grid-template-columns:repeat(var(--sf-mobile-tab-count,4),minmax(0,1fr));align-items:stretch;padding:5px 6px calc(5px + env(safe-area-inset-bottom,0px));min-height:63px;background:var(--pro-background,#fff);color:var(--pro-text,#263446);border-top:1px solid var(--pro-border,#dfe4eb);box-shadow:0 -6px 24px #13223914} + .sf-mobile-tab{appearance:none;border:0!important;background:transparent!important;color:inherit!important;text-decoration:none!important;padding:6px 2px;min-height:50px;min-width:0;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:2px;border-radius:9px;cursor:pointer;font-family:inherit} + .sf-tab-icon{font-size:23px;line-height:1.15;font-weight:500} + .sf-tab-label{font-size:11px;font-weight:600;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .sf-mobile-tab[aria-current=page]{color:var(--pro-accent,#e47730)!important;background:var(--pro-surface,#f5f6f8)!important} + body:has(> .sf-mobile-tabs){padding-bottom:calc(76px + env(safe-area-inset-bottom,0px))!important} +} +@media(min-width:768px){.sf-mobile-tabs{display:none!important}} +@media(prefers-reduced-motion:reduce){.pro-navigation,.sf-mobile-drawer-backdrop{transition:none!important}} diff --git a/examples/mobile-showcase/automotive/assets/custom.css b/examples/mobile-showcase/automotive/assets/custom.css new file mode 100644 index 0000000..e18a2d4 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/custom.css @@ -0,0 +1 @@ +body .pro-utility[hidden]{display:none!important}@media(max-width:1023px){.sf-canvas .sf-section{padding-block:64px}}@media(max-width:767px){.sf-canvas .sf-section{padding-block:40px}.pro-wrap,.sf-container{padding-left:20px;padding-right:20px}body .pro-utility{display:none!important}} \ No newline at end of file diff --git a/examples/mobile-showcase/automotive/assets/factory.css b/examples/mobile-showcase/automotive/assets/factory.css new file mode 100644 index 0000000..154ffb3 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/factory.css @@ -0,0 +1,27 @@ +/* SiteForge trusted global shell. Site themes remain visually independent. */ +:root{--sf-shell:#12243d;--sf-shell-accent:#dcae71;--sf-shell-soft:#edf2f8;--sf-shell-fg:#173049} +html{scroll-behavior:smooth}body{overflow-x:hidden}body>.header,body>.utility,body>.top,body>header,body>footer{display:none!important} +.sf-theme-industrial{--sf-shell:#114e79;--sf-shell-accent:#92d5ed;--sf-shell-soft:#ebf6fa;--sf-shell-fg:#0c4267} +.sf-theme-corporate{--sf-shell:#232d62;--sf-shell-accent:#b8bdff;--sf-shell-soft:#f3f3fa;--sf-shell-fg:#333468} +.sf-theme-minimal{--sf-shell:#1e1e1c;--sf-shell-accent:#ded6c5;--sf-shell-soft:#f6f4ef;--sf-shell-fg:#252520} +.sf-site-head{position:relative;z-index:25;background:var(--sf-shell);color:#fff;font-family:system-ui,-apple-system,sans-serif} +.sf-head-inner{max-width:1240px;margin:0 auto;min-height:78px;padding:0 28px;display:flex;align-items:center;gap:28px} +.sf-logo{display:flex;align-items:center;gap:11px;font-size:18px;text-decoration:none!important;color:#fff!important;white-space:nowrap} +.sf-logo-mark{width:36px;height:36px;display:grid;place-items:center;background:var(--sf-shell-accent);color:var(--sf-shell);font-size:22px;font-weight:900;border-radius:9px} +.sf-primary-links{display:flex;gap:23px;margin-left:auto;align-items:center} +.sf-primary-links a,.sf-mega a{color:#fff!important;text-decoration:none!important;font-size:13px;font-weight:650;white-space:nowrap} +.sf-primary-links a:hover{color:var(--sf-shell-accent)!important} +.sf-head-cta{font-size:13px;font-weight:750;text-decoration:none;background:var(--sf-shell-accent);color:var(--sf-shell)!important;padding:13px 18px;border-radius:4px;white-space:nowrap} +.sf-menu-toggle{display:none;margin-left:auto;color:white;border:1px solid #ffffff55;background:none;border-radius:4px;padding:8px 12px;font-size:19px;cursor:pointer} +.sf-mega{display:flex;gap:18px;max-width:1240px;margin:auto;padding:0 28px 9px;overflow-x:auto} +.sf-mega a{display:block;min-width:120px;border-top:1px solid #ffffff2e;padding:12px 8px}.sf-mega small{display:block;color:#ffffff99;max-width:160px;overflow:hidden;text-overflow:ellipsis;font-size:10px;margin-top:6px} +.sf-site-foot{background:var(--sf-shell);color:white!important;font:14px/1.7 system-ui,-apple-system,sans-serif;padding:72px 28px 26px} +.sf-foot-grid{max-width:1200px;margin:auto;display:grid;grid-template-columns:2fr 1fr 1fr;gap:70px}.sf-foot-grid h2{font-size:25px;color:white;margin:0 0 17px}.sf-foot-grid h4{font-size:13px;color:var(--sf-shell-accent);letter-spacing:.07em;margin:0 0 17px}.sf-foot-grid p{color:#ffffffae;max-width:380px}.sf-foot-grid a{display:block;width:fit-content;color:#fff!important;text-decoration:none;margin-bottom:8px}.sf-foot-lower{border-top:1px solid #ffffff33;max-width:1200px;margin:45px auto 0;padding-top:20px;display:flex;justify-content:space-between;color:#ffffff9e;font-size:12px} +.sf-filters{display:flex;align-items:center;flex-wrap:wrap;gap:12px;margin:0 0 30px}.sf-filters input,.sf-filters select{padding:11px 13px;border-radius:6px;border:1px solid #cfd9e4;background:#fff;color:#263a51;max-width:280px}.sf-filter-empty{padding:22px;color:#778598} +.sf-search-page{min-height:76vh;max-width:1060px;padding:90px 24px;margin:auto;font-family:system-ui,sans-serif;color:var(--sf-shell-fg)}.sf-search-page h1{font-size:clamp(35px,5vw,62px);margin:20px 0}.sf-search-page>label{display:block;margin:18px 0 8px}.sf-search-page input{display:block;width:100%;padding:17px;font-size:18px;border:1px solid #b7c6d7;border-radius:8px}.sf-search-page #sf-search-count{margin:22px 0;color:#607589}.sf-search-result{padding:22px 0;border-bottom:1px solid #dae1ea}.sf-search-result a{color:var(--sf-shell-fg);font-size:21px;font-weight:750;text-decoration:none}.sf-search-result small{display:block;color:#7992a7}.sf-search-result p{margin:7px 0;color:#657487} +@media(max-width:1050px){.sf-head-inner{gap:13px}.sf-primary-links{gap:12px}.sf-primary-links a{font-size:12px}.sf-head-cta{padding:10px}} +@media(max-width:850px){.sf-head-inner{min-height:68px}.sf-menu-toggle{display:block}.sf-head-cta{display:none}.sf-primary-links{display:none;position:absolute;top:68px;left:0;right:0;margin:0;background:var(--sf-shell);padding:20px 28px;flex-direction:column;align-items:stretch;box-shadow:0 20px 24px #0002}.sf-primary-links.is-open{display:flex}.sf-mega{display:none}.sf-foot-grid{grid-template-columns:1fr 1fr;gap:35px}} +@media(max-width:560px){.sf-foot-grid{grid-template-columns:1fr}.sf-foot-lower{display:block}.sf-site-foot{padding-top:48px}.sf-head-inner{padding:0 16px}} + +.sf-page-intro{padding:80px 28px;background:var(--sf-shell-soft);color:var(--sf-shell-fg);font-family:system-ui,sans-serif}.sf-page-intro>div{max-width:1200px;margin:auto}.sf-page-intro p{font-size:11px;font-weight:850;letter-spacing:.19em;text-transform:uppercase;color:var(--sf-shell-fg);opacity:.58}.sf-page-intro h1{font-size:clamp(38px,5vw,67px);letter-spacing:-.04em;line-height:1.08;margin:13px 0}.sf-page-intro span{font-size:16px;opacity:.72} +.sf-item[hidden]{display:none!important} diff --git a/examples/mobile-showcase/automotive/assets/pro-base.css b/examples/mobile-showcase/automotive/assets/pro-base.css new file mode 100644 index 0000000..c2c4f61 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/pro-base.css @@ -0,0 +1,21 @@ +/* SiteForge V3 professional theme primitives. Each commercial theme adds its own art direction. */ +:root{--pro-text:#19283a;--pro-muted:#687587;--pro-border:#dfe5ea;--pro-background:#fff;--pro-surface:#f5f7fa;--pro-accent:#365cb7;--pro-hero:#15263d;--pro-hero-fg:#fff;--pro-radius:12px;--pro-headings:system-ui,-apple-system,sans-serif;--pro-font:system-ui,-apple-system,sans-serif;--pro-wide:1270px} +*,*:before,*:after{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--pro-background);color:var(--pro-text);font-family:var(--pro-font);-webkit-font-smoothing:antialiased;overflow-x:hidden}button,input,select{font:inherit}button,a{touch-action:manipulation}button{cursor:pointer}a{text-decoration:none;color:inherit}a:hover{color:var(--pro-accent)}img{max-width:100%;display:block}h1,h2,h3,h4,p{margin-top:0}h1,h2,h3{font-family:var(--pro-headings);line-height:1.09}h1{letter-spacing:-.052em}h2{letter-spacing:-.042em}h3{letter-spacing:-.028em}p{line-height:1.72}.pro-wrap{max-width:var(--pro-wide);margin:0 auto;padding-left:32px;padding-right:32px}.pro-skip{position:absolute;left:-9999px;z-index:90;background:#fff;color:#000;padding:12px}.pro-skip:focus{left:10px;top:10px}.pro-eyebrow{font-weight:750;font-size:11px;letter-spacing:.17em;text-transform:uppercase;display:block;line-height:1.6;color:var(--pro-accent)}.pro-muted{opacity:.7}.pro-utility{min-height:30px;background:var(--pro-hero);color:#c5d2db;font-size:10px;letter-spacing:.16em}.pro-utility .pro-wrap{display:flex;justify-content:space-between;padding-block:8px}.pro-utility i{font-style:normal;color:var(--pro-accent)}.pro-header{background:var(--pro-background);color:var(--pro-text);border-bottom:1px solid var(--pro-border);position:relative;z-index:35}.pro-head-inner{min-height:84px;display:flex;align-items:center;gap:28px}.pro-logo{display:flex;align-items:center;gap:12px;min-width:170px}.pro-logo-symbol{font-size:32px;line-height:1;font-weight:800;letter-spacing:-.07em;color:var(--pro-accent)}.pro-logo-name{max-width:220px;font-weight:820;font-size:17px;line-height:1.1;letter-spacing:-.035em}.pro-logo-name small{display:block;font-weight:650;font-size:9px;letter-spacing:.19em;margin-top:7px;color:var(--pro-muted)}.pro-navigation{display:flex;align-items:center;gap:24px;margin-left:auto}.pro-navigation a{font-size:13px;font-weight:650;white-space:nowrap;transition:opacity .2s}.pro-navigation a:hover{opacity:.6}.pro-header-cta,.pro-button{display:inline-flex;align-items:center;justify-content:center;gap:22px;background:var(--pro-accent);color:#fff!important;border-radius:var(--pro-radius);font-size:13px;letter-spacing:.01em;font-weight:750;padding:16px 24px;white-space:nowrap;transition:transform .2s,background .2s}.pro-header-cta:hover,.pro-button:hover{transform:translateY(-2px)}.pro-mobile-toggle{display:none}.pro-mega{display:flex;align-items:center;gap:22px;min-height:37px;border-top:1px solid var(--pro-border);padding-block:10px;font-size:11px}.pro-mega>span{font-weight:750;color:var(--pro-muted);white-space:nowrap}.pro-mega>div{display:flex;gap:16px;overflow:auto;scrollbar-width:none}.pro-mega a{white-space:nowrap;font-weight:650}.pro-search-link{font-size:19px!important}.pro-home-hero{position:relative;overflow:hidden}.pro-home-grid{display:grid;grid-template-columns:1.02fr .98fr;align-items:center;gap:5%;min-height:580px;padding-top:85px;padding-bottom:85px}.pro-hero-copy{position:relative;z-index:2}.pro-hero-copy h1{font-size:clamp(48px,6.2vw,91px);line-height:1.03;margin:20px 0 25px;max-width:730px}.pro-hero-copy h1 em{font-style:normal;display:block;color:var(--pro-accent)}.pro-hero-copy p{font-size:17px;max-width:495px;color:var(--pro-muted)}.pro-hero-actions{display:flex;align-items:center;flex-wrap:wrap;gap:25px;margin-top:34px}.pro-outline-button{font-weight:700;border-bottom:1px solid currentColor;padding:12px 0}.pro-hero-art{width:100%;height:435px;position:relative;overflow:hidden;border-radius:var(--pro-radius)}.pro-hero-art>img{width:100%;height:100%;object-fit:cover}.pro-hero-bottom{display:flex;justify-content:space-between;font-size:10px;letter-spacing:.18em;padding-block:22px;border-top:1px solid #ffffff32}.pro-section{padding:106px 0}.pro-section-head{display:flex;align-items:end;justify-content:space-between;gap:25px;margin-bottom:34px}.pro-section-head h2{font-size:clamp(36px,4vw,57px);margin:12px 0 0}.pro-text-link{font-size:13px;font-weight:750;display:inline-flex;gap:18px;align-items:center;border-bottom:1px solid;padding-bottom:7px;color:var(--pro-accent)}.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:22px}.pro-card{display:block;min-width:0;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);overflow:hidden;border-radius:var(--pro-radius);transition:transform .25s,box-shadow .25s}.pro-card:hover{transform:translateY(-6px);box-shadow:0 24px 45px #0f25431b}.pro-card-cover{width:100%;height:244px;overflow:hidden;background:var(--pro-surface)}.pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .5s}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-art{width:100%;height:100%;overflow:hidden;display:grid;place-items:center;position:relative;background:linear-gradient(130deg,#d8e1ed,#f3f6f9)}.pro-art-ring{width:55%;aspect-ratio:1;border:28px solid #ffffff5f;border-radius:50%;box-shadow:0 0 0 42px #ffffff30;transform:rotate(-25deg)}.pro-art-center{position:absolute;font-family:var(--pro-headings);font-weight:800;font-size:76px;letter-spacing:-.08em;color:#45647d90}.pro-art-label{position:absolute;bottom:16px;left:18px;letter-spacing:.16em;font-size:9px;color:#435773}.pro-card-body{padding:25px 25px 28px}.pro-card-meta{display:flex;justify-content:space-between;gap:20px;font-size:10px;font-weight:750;letter-spacing:.1em;text-transform:uppercase;color:var(--pro-accent)}.pro-card h3{font-size:23px;margin:14px 0 9px}.pro-card p{font-size:13px;color:var(--pro-muted);margin-bottom:24px;min-height:44px}.pro-card-link{font-size:12px;font-weight:800;display:flex;justify-content:space-between;color:var(--pro-text);padding-top:14px;border-top:1px solid var(--pro-border)}.pro-empty{grid-column:1/-1;padding:45px;border:1px dashed var(--pro-border);background:var(--pro-surface);color:var(--pro-muted)}.pro-statement{background:var(--pro-surface)}.pro-statement-layout{display:grid;grid-template-columns:1fr 2fr;gap:60px}.pro-statement h2{font-size:clamp(36px,4.5vw,63px);max-width:760px}.pro-statement p{max-width:520px;color:var(--pro-muted)}.pro-brand-pills{display:flex;flex-wrap:wrap;gap:12px}.pro-brand-pills a{padding:18px 28px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);font-weight:750}.pro-brand-pills a:hover{border-color:var(--pro-accent)}.pro-inner-hero{background:var(--pro-surface);padding:92px 0 65px;position:relative;overflow:hidden}.pro-inner-hero h1{max-width:870px;font-size:clamp(43px,6vw,85px);margin:18px 0}.pro-inner-hero p{max-width:650px;color:var(--pro-muted);font-size:17px}.pro-breadcrumb{font-size:12px;color:var(--pro-muted);margin-top:25px;display:flex;gap:12px;align-items:center;flex-wrap:wrap}.pro-breadcrumb strong{color:var(--pro-text)}.pro-list-section{padding:65px 0 110px}.pro-filter-panel{display:grid;grid-template-columns:minmax(220px,2fr) 1fr 1fr auto;align-items:end;gap:14px;margin-bottom:35px}.pro-filter-panel label>span{display:block;font-size:11px;margin-bottom:8px;color:var(--pro-muted);font-weight:750}.pro-filter-panel input,.pro-filter-panel select{display:block;width:100%;padding:14px 15px;border-radius:var(--pro-radius);border:1px solid var(--pro-border);background:var(--pro-background);color:var(--pro-text);outline-offset:2px}.pro-filter-count{font-size:12px;padding-bottom:17px;color:var(--pro-muted)}.pro-filter-scope .pro-card[hidden]{display:none}.pro-product-layout{padding-top:38px}.pro-product-layout .pro-breadcrumb{margin-bottom:38px}.pro-product-hero{display:grid;grid-template-columns:1.18fr .82fr;gap:6%;align-items:center}.pro-product-media{height:460px;overflow:hidden;background:var(--pro-surface);border-radius:var(--pro-radius)}.pro-product-media .pro-photo{height:100%}.pro-product-summary h1{font-size:clamp(45px,5vw,72px);margin:16px 0}.pro-product-summary p{font-size:16px;color:var(--pro-muted)}.pro-product-brand{font-weight:700;color:var(--pro-text)!important}.pro-detail-layout{border-top:1px solid var(--pro-border);display:grid;grid-template-columns:1fr 1fr;gap:8%;margin-top:80px;padding-top:55px}.pro-detail-layout h2{font-size:32px;margin-top:13px}.pro-specs{margin-top:25px}.pro-specs>div{display:grid;grid-template-columns:1fr 1fr;gap:22px;padding:16px 0;border-bottom:1px solid var(--pro-border)}.pro-specs span{color:var(--pro-muted)}.pro-rich{line-height:1.85;font-size:16px;overflow-wrap:anywhere}.pro-rich img{border-radius:var(--pro-radius);margin:25px 0}.pro-rich a{text-decoration:underline}.pro-rich h2{margin-top:30px}.pro-lead{font-size:20px;color:var(--pro-muted)}.pro-brand-hero-grid{display:grid;grid-template-columns:1.1fr .9fr;gap:7%;align-items:center}.pro-brand-media{height:300px;overflow:hidden;border-radius:var(--pro-radius)}.pro-article-hero{text-align:center;padding:110px 0 75px;background:var(--pro-surface)}.pro-article-width{max-width:900px}.pro-article-hero h1{font-size:clamp(40px,5vw,75px);margin:15px 0 25px}.pro-article-hero p{color:var(--pro-muted);font-size:18px}.pro-article-hero time{font-size:12px;color:var(--pro-muted)}.pro-article-content{max-width:930px;padding-top:70px;padding-bottom:90px}.pro-article-cover{width:100%;max-height:530px;object-fit:cover;margin-bottom:40px;border-radius:var(--pro-radius)}.pro-article-content>.pro-text-link{margin-top:35px}.pro-case-detail{max-width:1020px}.pro-case-detail>img{width:100%;max-height:620px;object-fit:cover}.pro-case-meta{display:flex;gap:35px;margin:35px 0;color:var(--pro-muted);font-size:13px}.pro-case-meta strong{display:block;color:var(--pro-text);font-size:18px;margin-top:7px}.pro-info-grid{display:grid;grid-template-columns:.8fr 1.2fr;gap:12%}.pro-info-grid h2{font-size:clamp(31px,4.5vw,54px);margin-top:15px}.pro-contact-email{font-size:20px;color:var(--pro-accent);font-weight:750;word-break:break-word}.pro-info-photo{max-height:450px;object-fit:cover;margin-top:35px;border-radius:var(--pro-radius)}.pro-custom-content .sf-section{background:transparent}.pro-custom-content .sf-section:nth-of-type(even){background:var(--pro-surface)}.pro-end-cta{padding:76px 0;background:var(--pro-hero);color:#fff}.pro-end-cta .pro-wrap{display:flex;align-items:center;justify-content:space-between;gap:40px}.pro-end-cta h2{font-size:clamp(32px,4vw,53px);margin:13px 0}.pro-end-cta p{color:#c5c9d1}.pro-end-cta a{background:var(--pro-accent);color:#fff;font-weight:800;padding:19px 30px;border-radius:var(--pro-radius);white-space:nowrap}.pro-404{text-align:center;padding-block:125px}.pro-404>span{font-size:12px;letter-spacing:.3em}.pro-404 h1{font-size:clamp(150px,20vw,320px);margin:10px 0;letter-spacing:-.08em}.pro-404 p{font-size:18px;color:var(--pro-muted)}.pro-404 a{margin-top:22px}.pro-footer{background:#15212d;color:#fff;padding:75px 0 22px}.pro-footer-top{display:grid;grid-template-columns:1.45fr 1fr 1fr;gap:55px}.pro-footer h2{font-size:32px;margin:12px 0}.pro-footer p{max-width:350px;font-size:13px;color:#afbbc8}.pro-footer .pro-eyebrow{color:#b6c3d2}.pro-footer-links ul{margin:0;padding:0;list-style:none;display:grid;grid-template-columns:1fr 1fr;gap:15px}.pro-footer-links a{font-size:13px;color:#d6e0e8}.pro-footer-bottom{border-top:1px solid #ffffff29;margin-top:60px;padding-top:20px;font-size:10px;letter-spacing:.12em;color:#adb9c3;display:flex;justify-content:space-between}.pro-anchor{display:block;height:0}.pro-category-tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}.pro-category-tiles a{padding:35px 28px;min-height:155px;background:var(--pro-surface);display:flex;flex-direction:column;justify-content:space-between}.pro-category-tiles span{font-size:11px;color:var(--pro-muted)}.pro-category-tiles strong{font-size:24px}.pro-category-tiles b{align-self:end}.sf-site-head .sf-head-inner,.sf-site-head .sf-primary-links{display:none} +@media(max-width:1100px){.pro-head-inner{gap:17px}.pro-navigation{gap:14px}.pro-navigation a{font-size:12px}.pro-home-grid{min-height:500px}.pro-hero-copy h1{font-size:60px}.pro-hero-art{height:350px}} +@media(max-width:860px){.pro-wrap{padding-left:22px;padding-right:22px}.pro-utility{display:none}.pro-head-inner{min-height:70px;flex-wrap:wrap;gap:12px}.pro-mobile-toggle{display:block;margin-left:auto;border:1px solid var(--pro-border);padding:8px 12px;background:transparent;color:var(--pro-text);border-radius:5px}.pro-navigation{display:none;order:10;width:100%;flex-direction:column;align-items:stretch;gap:0;padding-bottom:12px}.pro-navigation.is-open{display:flex}.pro-navigation a{padding:11px 2px;border-bottom:1px solid var(--pro-border)}.pro-header-cta{display:none}.pro-mega{display:none}.pro-home-grid{grid-template-columns:1fr;gap:35px;padding-top:60px;padding-bottom:60px}.pro-hero-art{height:350px}.pro-hero-copy h1{font-size:clamp(45px,9vw,73px)}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-brand-hero-grid{grid-template-columns:1fr;gap:35px}.pro-product-media{height:380px}.pro-filter-panel{grid-template-columns:1fr 1fr}.pro-filter-panel label:first-child{grid-column:1/-1}.pro-end-cta .pro-wrap{align-items:start;flex-direction:column}.pro-section{padding:72px 0}.pro-footer-top{grid-template-columns:1fr 1fr}.pro-footer-top>div:first-child{grid-column:1/-1}.pro-category-tiles{grid-template-columns:repeat(2,1fr)}} +@media(max-width:560px){.pro-wrap{padding-left:18px;padding-right:18px}.pro-logo-name{font-size:15px}.pro-hero-copy h1{font-size:43px}.pro-hero-art{height:255px}.pro-hero-bottom{display:none}.pro-home-grid{min-height:0}.pro-grid{grid-template-columns:1fr}.pro-section-head{align-items:start;flex-direction:column}.pro-section-head h2{font-size:37px}.pro-card-cover{height:230px}.pro-filter-panel{grid-template-columns:1fr}.pro-filter-panel label:first-child{grid-column:auto}.pro-filter-count{padding-bottom:4px}.pro-statement-layout,.pro-footer-top{grid-template-columns:1fr;gap:25px}.pro-footer-top>div:first-child{grid-column:auto}.pro-footer-bottom{flex-direction:column;gap:8px}.pro-inner-hero{padding:60px 0}.pro-product-media{height:270px}.pro-product-summary h1{font-size:43px}.pro-category-tiles{grid-template-columns:1fr}.pro-end-cta h2{font-size:38px}.pro-minimal-meta{display:block!important}} + +/* V2 compatibility stylesheet hides direct headers/footers; full themes restore their own. */ +body>header.sf-site-head.pro-header,body>footer.sf-site-foot.pro-footer{display:block!important} + +/* Accessible desktop mega-navigation and mobile disclosure */ +.pro-catalog-toggle{font-size:12px;font-weight:750;border:1px solid var(--pro-border);background:transparent;color:inherit;border-radius:var(--pro-radius);padding:10px 14px;white-space:nowrap} +.pro-mega[hidden]{display:none!important}.pro-mega.is-open{display:flex}.pro-mega>div{padding-block:3px} +@media(max-width:1060px){.pro-catalog-toggle{display:none}} +@media(max-width:860px){.pro-mega.is-open{display:block!important}.pro-mega.is-open>div{display:flex;flex-wrap:wrap;gap:14px;padding:12px 0}.pro-mega>span{white-space:normal}} + +/* V4: responsive nested navigation, gallery and opt-in inquiry integration */ +.pro-nav-group{position:relative;display:flex;align-items:center;gap:3px}.pro-nav-disclose{border:0;background:none;color:inherit;font-size:12px;padding:8px}.pro-nav-children[hidden]{display:none!important}.pro-nav-children{position:absolute;left:0;top:100%;z-index:45;min-width:230px;max-width:360px;padding:10px;background:var(--pro-background);border:1px solid var(--pro-border);box-shadow:0 18px 35px #0002;border-radius:var(--pro-radius);display:flex;flex-direction:column}.pro-nav-children a{padding:10px 12px;white-space:nowrap}.pro-nav-children .pro-nav-leaf{padding-left:28px;color:var(--pro-muted)} +.pro-product-gallery{min-width:0}.pro-gallery-thumbs{display:flex;gap:8px;margin-top:12px;overflow:auto;scrollbar-width:thin;padding-bottom:5px}.pro-gallery-thumbs button{flex:0 0 86px;height:67px;border:2px solid transparent;padding:3px;border-radius:8px;background:var(--pro-surface)}.pro-gallery-thumbs button:focus-visible,.pro-gallery-thumbs button[aria-pressed=true]{border-color:var(--pro-accent)}.pro-gallery-thumbs img{width:100%;height:100%;object-fit:cover;border-radius:4px}.pro-gallery-lightbox{position:fixed;inset:0;background:rgba(10,16,30,.92);z-index:1000;display:grid;place-items:center;padding:6vw}.pro-gallery-lightbox[hidden]{display:none}.pro-gallery-lightbox img{max-width:92vw;max-height:80vh;object-fit:contain}.pro-gallery-lightbox button{position:absolute;right:25px;top:25px;border:1px solid #fff8;background:#222;color:#fff;padding:10px 15px;border-radius:5px} +.pro-inquiry-wrap{display:grid;grid-template-columns:1fr 1fr;gap:70px}.pro-inquiry{display:grid;gap:17px}.pro-inquiry label{display:grid;gap:7px;font-weight:650}.pro-inquiry input,.pro-inquiry textarea{padding:13px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);background:var(--pro-background);color:var(--pro-text);width:100%}.pro-inquiry textarea{min-height:140px}.pro-inquiry .pro-honeypot{position:absolute;left:-10000px;width:1px;height:1px}.pro-inquiry p{font-size:12px;color:var(--pro-muted)} +@media(max-width:860px){.pro-nav-group{display:block}.pro-nav-children{position:static;max-width:none;width:100%;box-shadow:none;border:0;border-left:2px solid var(--pro-accent);padding-left:8px}.pro-nav-group>a{display:inline-block}.pro-inquiry-wrap{grid-template-columns:1fr;gap:20px}} diff --git a/examples/mobile-showcase/automotive/assets/pro.css b/examples/mobile-showcase/automotive/assets/pro.css new file mode 100644 index 0000000..9d84384 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/pro.css @@ -0,0 +1,8 @@ +:root{--pro-text:#1c2a3b;--pro-muted:#718094;--pro-border:#e2e8ef;--pro-background:#fff;--pro-surface:#f2f5f9;--pro-accent:#bb8d50;--pro-hero:#0c1b2e;--pro-radius:5px;--pro-headings:'Arial Narrow',Arial,sans-serif;--pro-wide:1320px} +.pro-header{background:#0e1e30;color:#fff;border-color:#26374b}.pro-logo-symbol{color:#e0ae6c}.pro-logo-symbol span{color:#fff}.pro-logo-name small{color:#b3bfcf}.pro-header-cta{background:#c59b63;color:#0f1a26!important}.pro-navigation a:hover{color:#dfb97d}.pro-mega{background:#13263b;border-color:#2a4058;color:#c2d0de}.pro-mega>span{color:#d5aa72}.pro-mobile-toggle{color:#fff} +.pro-auto-hero{background:radial-gradient(circle at 68% 50%,#243b54 0%,#112539 34%,#081728 100%);color:#fff}.pro-auto-hero .pro-eyebrow{color:#d5a366}.pro-auto-hero .pro-hero-copy h1 em{color:#d2a16b}.pro-auto-hero .pro-hero-copy p{color:#b9c7d6}.pro-auto-hero .pro-button{color:#0d1b2d!important;background:#d8ad72}.pro-link-light{color:#d8e4ec;font-size:13px;font-weight:750}.pro-auto-hero .pro-hero-art{background:linear-gradient(160deg,#243e59,#0f2033);border:1px solid #ffffff25;box-shadow:0 50px 80px #0005;border-radius:3px;overflow:visible}.pro-abstract-car{position:absolute;inset:0;overflow:hidden;background:radial-gradient(ellipse at 50% 80%,#45648599,transparent 63%)}.pro-abstract-car:before{content:'';position:absolute;left:10%;right:9%;bottom:29%;height:29%;border:3px solid #d3dfefad;border-radius:53% 49% 10% 12%;transform:skewX(-9deg);box-shadow:0 23px 15px #05121f88,0 0 0 3px #182c41 inset}.pro-abstract-car:after{content:'';position:absolute;left:23%;right:23%;bottom:56%;height:17%;border:3px solid #d3dfef72;border-radius:85% 85% 0 0;transform:skewX(-20deg)}.pro-abstract-car>span{position:absolute;top:26px;right:22px;font-size:10px;letter-spacing:.2em;color:#ccd9e5}.auto-wheel{position:absolute;bottom:18%;width:16%;aspect-ratio:1;border-radius:50%;border:11px solid #6f8499;background:#111e2c;box-shadow:0 0 0 4px #111a25}.auto-wheel.a{left:19%}.auto-wheel.b{right:17%}.pro-hero-art>b{position:absolute;bottom:-31px;right:0;font-size:11px;letter-spacing:.2em;color:#bdcde0}.pro-featured{background:#f4f6f8}.pro-featured .pro-card{border:0;box-shadow:0 7px 30px #0f2e4710}.pro-featured .pro-card-cover{background:#d9e2eb}.pro-featured .pro-art{background:linear-gradient(140deg,#dce5ed,#a9baca)}.pro-featured .pro-art-ring{border-color:#eef3f8bb}.pro-statement{background:#12243b;color:#fff}.pro-statement .pro-eyebrow{color:#d3a975}.pro-statement p{color:#aebfd3}.pro-statement h2{font-size:clamp(42px,5vw,70px);max-width:700px}.pro-statement .pro-text-link{color:#dfba83}.pro-brand-section{background:white}.pro-brand-pills a{min-width:150px;text-align:center;background:#f5f7fa}.pro-inner-hero{background:linear-gradient(120deg,#101e31,#273b51);color:#fff}.pro-inner-hero .pro-eyebrow{color:#d0a46b}.pro-inner-hero p,.pro-inner-hero .pro-breadcrumb{color:#c9d1df}.pro-inner-hero .pro-breadcrumb strong{color:#fff}.pro-article-hero{background:#14243a;color:#fff}.pro-article-hero p{color:#bed0df}.pro-footer{background:#071421}.pro-footer-bottom{color:#98aebf}.pro-end-cta{background:#1a324b}.pro-end-cta a{background:#d4a56d;color:#132339!important}.pro-404 h1{color:#b8905c} + +/* SiteForge V5 commercial signature */ +.pro-auto-hero .pro-hero-art{background-image:url("./visual/hero.svg")!important;background-position:center;background-size:cover;} + +.pro-auto-hero{background:linear-gradient(117deg,#081729 0%,#102a43 100%)}.pro-auto-hero .pro-hero-art{border:1px solid #52667a55;border-radius:3px;box-shadow:0 30px 90px #0004;transform:translateX(0)}.pro-auto-hero .pro-hero-art .pro-abstract-car{opacity:0}.pro-hero-bottom{border-top:1px solid #ffffff1c}.pro-brand-pills a{transition:background .2s}.pro-brand-pills a:hover{background:#d6a974;color:#10233a}.pro-card{border-color:#e0e6ee;border-radius:5px}.pro-card-cover{background:linear-gradient(135deg,#edf1f6,#dbe4eb)}.pro-art{background:linear-gradient(130deg,#e0e8ee,#c4d0dc);color:#37536b}.pro-featured{background:#f8fafc}.pro-statement{background:#0d2134;color:white}.pro-statement p{color:#c6d0dd}.pro-statement .pro-text-link{color:#f0b870}.pro-section-head h2{font-weight:800}.pro-footer{background:#08182a;color:#e5e9ed} diff --git a/examples/mobile-showcase/automotive/assets/pro.js b/examples/mobile-showcase/automotive/assets/pro.js new file mode 100644 index 0000000..9cf100d --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/pro.js @@ -0,0 +1,72 @@ +'use strict';(()=>{ + const menu=document.querySelector('[data-pro-menu]'); const nav=document.querySelector('#pro-navigation'); + if(menu&&nav){menu.addEventListener('click',()=>{const open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));nav.classList.toggle('is-open',open);menu.setAttribute('aria-label',open?'关闭导航':'打开导航');});} + // Drawer navigation. The same markup is used across the four professional themes. + const mobileNav=document.querySelector('#pro-navigation'); + let drawerBackdrop=null,drawerClose=null,returnFocus=null; + if(menu&&mobileNav){ + const originalParent=mobileNav.parentNode,originalNext=mobileNav.nextSibling; + const heading=document.createElement('div');heading.className='sf-drawer-header'; + const title=document.createElement('strong');title.textContent='网站导航'; + drawerClose=document.createElement('button');drawerClose.type='button';drawerClose.className='sf-drawer-close';drawerClose.textContent='×';drawerClose.setAttribute('aria-label','关闭网站导航'); + heading.append(title,drawerClose);mobileNav.prepend(heading); + drawerBackdrop=document.createElement('div');drawerBackdrop.className='sf-mobile-drawer-backdrop';drawerBackdrop.hidden=false;document.body.append(drawerBackdrop); + function setDrawer(open,focusBack=true){ + const isMobile=window.matchMedia('(max-width:1024px)').matches; + open=Boolean(open&&isMobile); + if(open){returnFocus=document.activeElement;document.body.append(mobileNav);} + else if(mobileNav.parentNode!==originalParent){if(originalNext&&originalNext.parentNode===originalParent)originalParent.insertBefore(mobileNav,originalNext);else originalParent.append(mobileNav);} + mobileNav.classList.toggle('is-open',open);drawerBackdrop.classList.toggle('is-open',open); + document.body.classList.toggle('sf-drawer-open',open); + menu.setAttribute('aria-expanded',String(open));menu.setAttribute('aria-label',open?'关闭导航':'打开导航'); + mobileNav.setAttribute('aria-hidden',String(!open&&isMobile)); + if('inert' in mobileNav)mobileNav.inert=!open&&isMobile; + if(open)drawerClose.focus(); + else if(focusBack&&returnFocus instanceof HTMLElement){returnFocus.focus();returnFocus=null;} + } + // Replace the old inline-expansion listener: use capture to stop the old listener. + menu.addEventListener('click',e=>{if(!window.matchMedia('(max-width:1024px)').matches)return;e.stopImmediatePropagation();setDrawer(!mobileNav.classList.contains('is-open'));},true); + drawerClose.addEventListener('click',()=>setDrawer(false)); + drawerBackdrop.addEventListener('click',()=>setDrawer(false)); + document.querySelectorAll('[data-mobile-open-menu]').forEach(b=>b.addEventListener('click',()=>setDrawer(true))); + mobileNav.addEventListener('click',e=>{if(e.target.closest('a'))setDrawer(false,false)}); + document.addEventListener('keydown',e=>{ + if(e.key==='Escape'&&mobileNav.classList.contains('is-open')){e.preventDefault();setDrawer(false);} + if(e.key!=='Tab'||!mobileNav.classList.contains('is-open'))return; + const els=[...mobileNav.querySelectorAll('button:not([disabled]),a[href]')].filter(el=>el.getClientRects().length&&!el.closest('[hidden]')); + if(!els.length)return;const first=els[0],last=els[els.length-1]; + if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();} + else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();} + }); + window.matchMedia('(max-width:1024px)').addEventListener('change',()=>setDrawer(false,false)); + if('inert' in mobileNav&&window.matchMedia('(max-width:1024px)').matches)mobileNav.inert=true; + // Do not strand catalogue links when the old mobile mega-button is hidden. + const megaLinks=document.querySelectorAll('[data-pro-mega] a'); + if(megaLinks.length){const wrap=document.createElement('div');wrap.className='sf-drawer-extra';const h=document.createElement('strong');h.textContent='更多分类与系列';wrap.append(h); + [...megaLinks].slice(0,20).forEach(a=>{const clone=a.cloneNode(true);wrap.append(clone);});mobileNav.append(wrap);} + } + const tabbar=document.querySelector('[data-mobile-tabs]'); + if(tabbar){tabbar.style.setProperty('--sf-mobile-tab-count',String(tabbar.children.length));} + const megaButton=document.querySelector('[data-pro-catalog]'), mega=document.querySelector('[data-pro-mega]'); + if(megaButton&&mega){function setMega(open){mega.hidden=!open;mega.classList.toggle('is-open',open);megaButton.setAttribute('aria-expanded',String(open));} + megaButton.addEventListener('click',()=>setMega(mega.hidden)); + document.addEventListener('keydown',e=>{if(e.key==='Escape')setMega(false);}); + document.addEventListener('click',e=>{if(!mega.hidden&&!mega.contains(e.target)&&!megaButton.contains(e.target))setMega(false);}); + } + document.querySelectorAll('.pro-nav-disclose').forEach(button=>{button.addEventListener('click',()=>{let panel=button.parentElement.querySelector('.pro-nav-children');let visible=button.getAttribute('aria-expanded')==='true';button.setAttribute('aria-expanded',String(!visible));panel.hidden=visible;});}); + document.querySelectorAll('.pro-gallery-thumbs').forEach(container=>{const main=container.parentElement.querySelector('.pro-product-media img');const buttons=[...container.querySelectorAll('[data-gallery-image]')]; + buttons.forEach(b=>{b.addEventListener('click',()=>{buttons.forEach(x=>x.setAttribute('aria-pressed',String(x===b)));if(main){main.src=b.dataset.galleryImage;main.alt=b.querySelector('img')?.alt||'';}});}); + if(!main)return;main.tabIndex=0;main.style.cursor='zoom-in';const open=()=>{const pane=document.createElement('div');pane.className='pro-gallery-lightbox';pane.setAttribute('role','dialog');pane.setAttribute('aria-label','产品大图预览');let img=document.createElement('img');img.src=main.src;img.alt=main.alt;const close=document.createElement('button');close.type='button';close.textContent='关闭 ×';pane.append(img,close);document.body.append(pane);const done=()=>{pane.remove();document.removeEventListener('keydown',esc);main.focus();};const esc=e=>{if(e.key==='Escape')done();};document.addEventListener('keydown',esc);close.addEventListener('click',done);pane.addEventListener('click',e=>{if(e.target===pane)done();});close.focus();};main.addEventListener('click',open);main.addEventListener('keydown',e=>{if(e.key==='Enter')open();}); + }); + document.querySelectorAll('.pro-filter-scope').forEach(scope=>{ + const panel=scope.previousElementSibling;if(!panel||!panel.classList.contains('pro-filter-panel'))return; + const cards=Array.from(scope.querySelectorAll('.pro-card')); + const blank=document.createElement('div');blank.className='pro-filter-empty';blank.hidden=true;blank.textContent='没有找到符合条件的内容，请调整关键词或筛选条件。';scope.append(blank); + const q=panel.querySelector('[data-pro-filter-search]'),b=panel.querySelector('[data-pro-filter-brand]'),c=panel.querySelector('[data-pro-filter-category]'),count=panel.querySelector('[data-pro-filter-count]'); + function options(sel,key){const vals=[...new Set(cards.map(x=>x.dataset[key]||'').filter(Boolean))].sort();vals.forEach(x=>sel.add(new Option(x,x)));if(!vals.length)sel.closest('label').hidden=true;} + options(b,'brand');options(c,'category'); + function run(){const str=q.value.trim().toLocaleLowerCase();let visible=0; + cards.forEach(el=>{const hit=el.textContent.toLocaleLowerCase().includes(str)&&(!b.value||el.dataset.brand===b.value)&&(!c.value||el.dataset.category===c.value);el.hidden=!hit;visible+=Number(hit);});count.textContent=`共 ${visible} 条`;blank.hidden=visible!==0;} + [q,b,c].forEach(x=>x.addEventListener(x===q?'input':'change',run));run(); + }); +})(); diff --git a/examples/mobile-showcase/automotive/assets/search-index.json b/examples/mobile-showcase/automotive/assets/search-index.json new file mode 100644 index 0000000..0637a08 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/search-index.json @@ -0,0 +1 @@ +[] \ No newline at end of file diff --git a/examples/mobile-showcase/automotive/assets/site-runtime.js b/examples/mobile-showcase/automotive/assets/site-runtime.js new file mode 100644 index 0000000..e4715e8 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/site-runtime.js @@ -0,0 +1,31 @@ +'use strict'; +(()=>{ + const $=s=>document.querySelector(s), $$=s=>[...document.querySelectorAll(s)]; + const menu=$('.sf-menu-toggle');if(menu){menu.addEventListener('click',()=>{let open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));$('#sf-primary-links')?.classList.toggle('is-open',open);});} + // Filter actual static content cards, no API is needed at runtime. + $$('.sf-collection').forEach(grid=>{ + const cards=$$('.sf-item',grid); + if(cards.length<2)return; + const toolbar=document.createElement('div');toolbar.className='sf-filters'; + const search=document.createElement('input');search.type='search';search.placeholder='筛选当前列表';search.setAttribute('aria-label','筛选当前列表'); + const status=document.createElement('span');status.setAttribute('aria-live','polite');status.style.fontSize='12px'; + const brand=document.createElement('select');brand.setAttribute('aria-label','按品牌筛选'); + const category=document.createElement('select');category.setAttribute('aria-label','按分类筛选'); + function fill(el,field,all){el.append(new Option(all,''));const vals=[...new Set(cards.map(x=>x.dataset[field]||'').filter(Boolean))].sort();vals.forEach(v=>el.append(new Option(v,v)));if(!vals.length)el.hidden=true;} + fill(brand,'brand','全部品牌');fill(category,'category','全部分类'); + toolbar.append(search,brand,category,status);grid.parentNode.insertBefore(toolbar,grid); + function apply(){let val=search.value.trim().toLocaleLowerCase();let visible=0;cards.forEach(card=>{let hit=card.textContent.toLocaleLowerCase().includes(val)&&(!brand.value||card.dataset.brand===brand.value)&&(!category.value||card.dataset.category===category.value);card.hidden=!hit;if(hit)visible++;});status.textContent=`共 ${visible} 项`;} + search.addEventListener('input',apply);brand.addEventListener('change',apply);category.addEventListener('change',apply);apply(); + }); + const input=$('#sf-search'),root=$('#sf-search-results'),count=$('#sf-search-count'); + if(input&&root){ + let data=[];const params=new URLSearchParams(location.search);input.value=params.get('q')||''; + let debounce=null; + const render=()=>{let q=input.value.trim().toLocaleLowerCase();let found=q?data.filter(d=>`${d.title} ${d.summary} ${d.brand} ${d.type}`.toLocaleLowerCase().includes(q)).slice(0,100):data.slice(0,30); + root.replaceChildren();count.textContent=`${found.length} 条结果${!q?'（显示前30条）':''}`; + found.forEach(d=>{let article=document.createElement('article'),a=document.createElement('a'),small=document.createElement('small'),p=document.createElement('p');article.className='sf-search-result';a.textContent=d.title;a.href=d.url.replace(/^\//,'');small.textContent=d.type;p.textContent=d.summary;article.append(a,small,p);root.append(article);}); + };const base=document.querySelector('base')?.href||location.href; + fetch(new URL('search-index.json',base)).then(r=>{if(!r.ok)throw Error('index unavailable');return r.json();}).then(v=>{data=v;render()}).catch(()=>{count.textContent='搜索索引加载失败，请检查站点文件部署路径';}); + input.addEventListener('input',()=>{clearTimeout(debounce);debounce=setTimeout(render,100)}); + } +})(); diff --git a/examples/mobile-showcase/automotive/assets/theme.css b/examples/mobile-showcase/automotive/assets/theme.css new file mode 100644 index 0000000..2786b24 --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/theme.css @@ -0,0 +1 @@ +:root{--accent:#ecb75c;--ink:#f6f7fa;--body:#101318}*{box-sizing:border-box}body{margin:0;background:#f7f7f7;color:#1b232c;font:16px/1.65 Inter,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}a{text-decoration:none;color:inherit}img{max-width:100%;object-fit:cover}.utility{height:32px;display:flex;justify-content:space-between;align-items:center;background:#090d13;color:#919da8;padding:0 5%;font-size:10px;letter-spacing:2px}.header{height:90px;background:#121922;color:#fff;display:flex;align-items:center;justify-content:space-between;padding:0 5%;gap:24px}.brand{font-size:22px;font-weight:780;display:flex;align-items:center;gap:14px;line-height:1.15}.brand small{display:block;font-size:9px;color:#9ba4b4;letter-spacing:2.5px;margin-top:5px}.mark{background:var(--accent);border-radius:3px;color:#111;padding:10px;font-size:19px}.header nav{display:flex;flex-wrap:wrap;gap:26px;font-size:12px;letter-spacing:1px}.header nav a:hover{color:var(--accent)}.nav-cta{border:1px solid #505a62;padding:12px 17px;color:#e6c893;font-size:11px;letter-spacing:1px}.hero{background:radial-gradient(circle at 80% 55%,#2d4359 0%,#141e2c 34%,#0b121b 75%);color:white;min-height:580px}.hero-inner{max-width:1450px;margin:auto;padding:70px 5% 50px;display:grid;grid-template-columns:51% 49%;align-items:center;min-height:520px}.eyebrow{font-size:11px;letter-spacing:3px;font-weight:700;color:#e9b962}.glow{display:inline-block;width:8px;height:8px;background:#efbf6e;border-radius:100%;margin-right:12px;box-shadow:0 0 16px #edc36d}.hero h1{font-size:clamp(54px,7.2vw,116px);font-weight:850;letter-spacing:-6px;line-height:.95;margin:29px 0}.hero p{font-size:17px;color:#b6c4d1;max-width:470px}.hero-actions{display:flex;align-items:center;gap:30px;margin-top:34px}.btn{display:inline-flex;align-items:center;justify-content:space-between;gap:32px;padding:17px 23px;background:#d5a962;color:#12181d;font-size:12px;font-weight:850;letter-spacing:.8px}.hero-hint{color:#89929b;font-size:12px}.hero-visual{height:330px;position:relative;display:flex;align-items:center;justify-content:center}.hero-visual img{max-height:360px;width:100%;object-fit:contain;filter:drop-shadow(0 16px 23px #0008)}.hero-no{position:absolute;right:0;bottom:-70px;color:#fff6;font-size:10px;letter-spacing:3px}.car-shape{height:220px;width:100%;position:relative;filter:drop-shadow(0 28px 16px #0007)}.car-body{position:absolute;inset:45px 0 24px;border-radius:90px 130px 36px 35px;background:linear-gradient(170deg,#c7d0d9,#60788a 37%,#142433 48%,#202d3d 70%);clip-path:polygon(0 70%,13% 47%,31% 38%,47% 6%,75% 6%,88% 39%,100% 56%,98% 95%,3% 95%)}.wheel{position:absolute;width:80px;height:80px;bottom:0;border-radius:100%;background:radial-gradient(circle,#71808b 0 25%,#101722 28% 50%,#354355 54% 61%,#0a0d13 64%)}.wheel-one{left:19%}.wheel-two{right:13%}.hero-bottom{border-top:1px solid #344052;padding:18px 5%;display:flex;justify-content:space-between;color:#9fa9b5;font-size:10px;letter-spacing:2px}.inner-hero{background:linear-gradient(110deg,#0d1925,#2a3f50);color:white;padding:100px 6% 90px}.inner-hero h1{font-size:clamp(40px,6vw,84px);line-height:1.1;letter-spacing:-2px;margin:16px 0}.inner-hero p{color:#c0ccd7}.container{max-width:1220px;margin:auto;padding:0 24px}.main{padding:75px 0 110px}.section-title{display:flex;align-items:end;gap:20px;justify-content:space-between;margin:30px 0 28px}.section-title span{font-size:11px;letter-spacing:2px;color:#9f7844}.section-title h2{font-size:37px;letter-spacing:-1.5px;flex:1;margin:0}.section-title a{font-size:12px;font-weight:700}.card-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:24px}.model-card{background:#fff;transition:transform .2s,box-shadow .2s;min-width:0}.model-card:hover{transform:translateY(-4px);box-shadow:0 14px 35px #15273822}.card-visual{height:210px;background:linear-gradient(120deg,#dae2e8,#abbcc7);display:flex;align-items:center;justify-content:center;overflow:hidden}.card-visual img{height:100%;width:100%;object-fit:contain}.card-monogram{font-size:75px;font-weight:900;letter-spacing:-8px;color:#ffffff77}.card-copy{padding:24px}.card-copy span{color:#ae854c;font-size:10px;letter-spacing:2px}.card-copy h3{font-size:24px;margin:8px 0}.card-copy p{font-size:13px;color:#73808b}.card-copy b{font-size:11px;letter-spacing:1px;color:#a6793f}.detail-media{margin:40px auto;text-align:center;max-height:600px}.detail-media img{max-height:600px}.rich-content{margin-bottom:55px}.prose{max-width:860px}.rich-content p{color:#596574}.section{padding:45px 0}.section-heading h2{font-size:38px}.block-hero{padding:60px 0}.block-hero h1{font-size:52px}.feature-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:20px}.feature{padding:26px;background:white}.feature-mark{color:#b08756;font-size:12px}.stats{display:grid;grid-template-columns:repeat(4,1fr);gap:20px}.stat strong{display:block;font-size:35px}.stat span{color:#71808c}.cta{background:#19283a;color:white;padding:55px}.cta p{color:#b8c8d6}footer{background:#0d151f;color:white;padding:70px 5% 25px}.footer-brand{font-size:25px;font-weight:750}.footer-brand span{font-size:11px;font-weight:400;color:#aeb8c2}footer p{color:#8593a2}.footer-bottom{border-top:1px solid #30404c;padding-top:25px;margin-top:65px;display:flex;justify-content:space-between;font-size:10px;letter-spacing:1px;color:#8995a3}@media(max-width:860px){.utility{font-size:8px}.header{height:auto;padding:18px 5%;align-items:flex-start;flex-wrap:wrap}.header nav{order:3;width:100%;gap:18px}.nav-cta{display:none}.hero-inner{grid-template-columns:1fr;padding-top:55px}.hero h1{letter-spacing:-3px}.hero-visual{height:210px}.hero-no{bottom:0}.card-grid,.feature-grid{grid-template-columns:repeat(2,1fr)}}@media(max-width:560px){.card-grid,.feature-grid,.stats{grid-template-columns:1fr}.hero h1{font-size:56px}.hero-actions{flex-wrap:wrap}.section-title{align-items:start;flex-direction:column}.inner-hero{padding:75px 6%}.hero-bottom{font-size:8px}} diff --git a/examples/mobile-showcase/automotive/assets/visual/hero.svg b/examples/mobile-showcase/automotive/assets/visual/hero.svg new file mode 100644 index 0000000..4ba145a --- /dev/null +++ b/examples/mobile-showcase/automotive/assets/visual/hero.svg @@ -0,0 +1 @@ +CONCEPT / MOBILITY diff --git a/examples/mobile-showcase/automotive/index.html b/examples/mobile-showcase/automotive/index.html new file mode 100644 index 0000000..912369f --- /dev/null +++ b/examples/mobile-showcase/automotive/index.html @@ -0,0 +1,24 @@ +汽车出口跳转至正文 + + +
联系我们 ↗
+
01 / THE WORLD IN MOTION

汽车出口 MOVE BEYOND.

专业车辆采购与全球交付

探索车型 ↗了解企业 →
THE NEXT CHAPTER
DRIVE / 01
DESIGN / TRUST / DELIVERYSCROLL TO DISCOVER ↓
+
02 / COLLECTION

探索精选车型

浏览全部 ↗
+ +
+
标准VEHICLE
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+
THE COMPANY

把产品带向更广阔的市场。

专业车辆采购与全球交付

认识我们 ↗
+
03 / BRANDS

品牌与合作伙伴

浏览全部 ↗
EXAMPLE ↗
+ +
+
LET'S CONNECT

从这里开始下一步。

专业车辆采购与全球交付

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/automotive/listing.html b/examples/mobile-showcase/automotive/listing.html new file mode 100644 index 0000000..bae7222 --- /dev/null +++ b/examples/mobile-showcase/automotive/listing.html @@ -0,0 +1,22 @@ +全部产品跳转至正文 + + +
联系我们 ↗
+
DISCOVER / COLLECTION

全部产品

分类查看产品与解决方案

首页／全部产品
+
+ +
+
标准CATALOG
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+ +
+
LET'S CONNECT

从这里开始下一步。

专业车辆采购与全球交付

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/automotive/product.html b/examples/mobile-showcase/automotive/product.html new file mode 100644 index 0000000..138d4e3 --- /dev/null +++ b/examples/mobile-showcase/automotive/product.html @@ -0,0 +1,17 @@ +标准系列产品跳转至正文 + + +
联系我们 ↗
+
首页／产品中心／标准系列产品
+
+
标准PRODUCT
+
PRODUCT DETAILS / EXAMPLE

标准系列产品

面向全球客户的精选示范产品

品牌 · EXAMPLE

咨询该产品 ↗
+
OVERVIEW

产品介绍

规格、优势与适用场景的示例描述。

SPECIFICATIONS

规格参数

Capacity可定制
Material高品质
+ +
+
LET'S CONNECT

从这里开始下一步。

专业车辆采购与全球交付

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/article.html b/examples/mobile-showcase/corporate/article.html new file mode 100644 index 0000000..0b35888 --- /dev/null +++ b/examples/mobile-showcase/corporate/article.html @@ -0,0 +1,13 @@ +企业动态与行业资讯跳转至正文 + + +
联系我们 ↗
+
LATEST NEWS / INSIGHTS

企业动态与行业资讯

了解最新项目与服务进展

项目背景

这是一段用于检查手机端资讯排版的样例正文。适当的字距、行距和图片宽度能够提升移动阅读体验。

← 返回新闻
+ +
+
LET'S CONNECT

从这里开始下一步。

连接更可靠的全球业务

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/assets/blocks.css b/examples/mobile-showcase/corporate/assets/blocks.css new file mode 100644 index 0000000..9ce1279 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/blocks.css @@ -0,0 +1,29 @@ +/* Portable SiteForge blocks, loaded with every theme (all styles scoped to sf-). */ +.sf-section{background:var(--sf-bg,transparent);color:var(--sf-fg,inherit);padding:var(--sf-pad,82px) 0;margin:0}.sf-section:nth-of-type(even){background:var(--sf-bg,#f4f6f9)}.sf-container{max-width:1200px;margin:auto;padding:0 32px}.sf-section h1,.sf-section h2,.sf-section h3,.sf-section p{color:inherit;line-height:1.3}.sf-section h1{font-size:clamp(38px,5vw,76px);font-weight:790;letter-spacing:-.052em}.sf-section h2{font-size:clamp(27px,3.2vw,44px);font-weight:760;letter-spacing:-.037em}.sf-kicker{display:block;font-size:12px;letter-spacing:.17em;text-transform:uppercase;font-weight:740;color:var(--accent,#3569d3);margin-bottom:18px}.sf-hero-grid,.sf-image-text{display:grid;grid-template-columns:1.08fr .92fr;gap:68px;align-items:center}.sf-hero-copy p{font-size:18px;line-height:1.75;max-width:520px;opacity:.75}.sf-hero-img,.sf-image-side{overflow:hidden;border-radius:9px;min-height:380px;background:linear-gradient(130deg,#d5e1ee,#eef3f9);display:grid;place-items:center}.sf-hero-img img,.sf-image-side img{width:100%;height:100%;max-height:580px;object-fit:cover}.sf-hero-abstract{font-size:110px;color:#a7bdd4}.sf-button{display:inline-flex;align-items:center;justify-content:center;gap:28px;background:var(--accent,#315ee2);color:white!important;padding:16px 26px;border-radius:6px;font-size:14px;text-decoration:none;font-weight:720;margin-top:24px}.sf-section-head{display:flex;align-items:end;justify-content:space-between;margin-bottom:32px;gap:24px}.sf-section-head h2{margin:0}.sf-section-head>a,.sf-link{color:var(--accent,#3569d3);font-weight:700;text-decoration:none}.sf-prose{font-size:16px;line-height:1.85;max-width:930px}.sf-prose p{line-height:1.85}.sf-features,.sf-collection,.sf-stats{display:grid;gap:20px}.sf-features{grid-template-columns:repeat(3,minmax(0,1fr))}.sf-feature{border:1px solid #e0e6eb;padding:32px 28px;border-radius:8px;background:#fff;color:#253247}.sf-feature>span{font-size:12px;font-weight:800;color:var(--accent,#346add)}.sf-feature h3{font-size:22px;margin:30px 0 8px}.sf-feature p{font-size:14px;line-height:1.7;color:#647181}.sf-stats{grid-template-columns:repeat(4,1fr);padding:40px 0;border-top:1px solid #b7c0cd66;border-bottom:1px solid #b7c0cd66}.sf-stats>div{display:flex;flex-direction:column;gap:8px}.sf-stats strong{font-size:clamp(28px,4vw,53px);letter-spacing:-.04em}.sf-stats span{font-size:12px;opacity:.65;letter-spacing:.04em}.sf-collection{grid-template-columns:repeat(var(--sf-cols,3),minmax(0,1fr))}.sf-item{display:block;text-decoration:none;color:#233044;background:#fff;border:1px solid #e8edf1;border-radius:8px;overflow:hidden;transition:transform .2s,box-shadow .2s}.sf-item:hover{transform:translateY(-4px);box-shadow:0 18px 38px #344d7018}.sf-item-img{height:210px;overflow:hidden;background:#e4eaf0}.sf-item-img img{height:100%;width:100%;object-fit:cover}.sf-placeholder{display:grid;place-items:center;width:100%;height:100%;min-height:190px;background:linear-gradient(130deg,#e2eaf2,#c9d7e6);font-size:72px;color:#8399b2;font-weight:800}.sf-large{min-height:360px}.sf-item-copy{padding:25px}.sf-item-copy small{text-transform:uppercase;letter-spacing:.13em;color:var(--accent,#376edc)}.sf-item-copy h3{font-size:22px;margin:12px 0 7px}.sf-item-copy p{font-size:14px;line-height:1.6;color:#7a8796;min-height:42px}.sf-item-copy span{font-size:12px;color:var(--accent,#376edc);font-weight:800}.sf-image-text>div>p{font-size:17px;line-height:1.8;max-width:520px;opacity:.7}.sf-reverse>div:first-child{order:2}.sf-gallery{display:grid;grid-template-columns:repeat(3,1fr);gap:15px}.sf-gallery img{width:100%;height:230px;object-fit:cover;border-radius:6px}.sf-faq{max-width:920px}.sf-faq details{border-bottom:1px solid #dce3eb;padding:22px 0}.sf-faq summary{font-size:17px;cursor:pointer;font-weight:700}.sf-faq p{color:#647181;line-height:1.75}.sf-cta-wrap{display:flex;justify-content:space-between;align-items:center;gap:24px}.sf-cta-wrap h2{margin:0}.sf-cta-wrap p{font-size:16px;opacity:.75}.sf-section a{cursor:pointer}.sf-muted{opacity:.65} +@media(max-width:820px){.sf-container{padding:0 20px}.sf-section{padding:50px 0}.sf-hero-grid,.sf-image-text{grid-template-columns:1fr;gap:26px}.sf-reverse>div:first-child{order:initial}.sf-hero-img,.sf-image-side{min-height:250px}.sf-features,.sf-collection{grid-template-columns:repeat(2,minmax(0,1fr))}.sf-stats{grid-template-columns:repeat(2,1fr)}.sf-cta-wrap{align-items:flex-start;flex-direction:column}} +@media(max-width:540px){.sf-features,.sf-collection,.sf-gallery{grid-template-columns:1fr}.sf-section-head{display:block}.sf-section-head>a{display:block;margin-top:13px}.sf-item-img{height:220px}.sf-hero-grid{gap:22px}.sf-hero-copy p{font-size:16px}.sf-stats{gap:28px}} + +.sf-attributes{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:0 32px;border-top:1px solid #e5eaf0}.sf-attribute{display:flex;justify-content:space-between;align-items:center;gap:18px;border-bottom:1px solid #e5eaf0;padding:19px 10px;font-size:14px}.sf-attribute span{color:#748497}.sf-attribute strong{font-weight:720;text-align:right}@media(max-width:640px){.sf-attributes{grid-template-columns:1fr}} + +/* SiteForge responsive no-code grid container */ +.sf-layout-grid{display:grid;grid-template-columns:var(--sf-layout-cols,1fr 1fr);gap:var(--sf-layout-gap,24px);align-items:stretch} +.sf-layout-column{min-width:0}.sf-layout-column>.sf-section{padding:0;margin:0 0 18px}.sf-layout-column .sf-container{width:100%;padding:0} +.sf-layout-column>.sf-section:last-child{margin-bottom:0} +@media(max-width:820px){.sf-layout-grid{grid-template-columns:repeat(2,minmax(0,1fr))!important}} +@media(max-width:540px){.sf-layout-grid{grid-template-columns:minmax(0,1fr)!important}} + +/* V8.6: accessible, script-free commercial design blocks */ +.sf-slides{display:flex;gap:18px;overflow-x:auto;scroll-snap-type:x mandatory;padding:6px 0 18px;scrollbar-width:thin} +.sf-slide{flex:0 0 min(78%,720px);min-width:220px;margin:0;scroll-snap-align:start} +.sf-slide img{width:100%;aspect-ratio:16/9;object-fit:cover;border-radius:10px} +.sf-slide figcaption{padding:10px 2px;opacity:.7;font-size:14px} +.sf-video{aspect-ratio:16/9;max-width:1000px;background:#ebf0f5;border-radius:10px;overflow:hidden} +.sf-video iframe{width:100%;height:100%;border:0} +.sf-tab{padding:19px 0;border-bottom:1px solid #dde4ec;max-width:960px} +.sf-tab summary{font-size:18px;font-weight:700;cursor:pointer}.sf-tab p{max-width:850px;line-height:1.8} +.sf-prices{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:18px} +.sf-price{padding:28px;background:#fff;border:1px solid #dee5ef;border-radius:10px;color:#29394b} +.sf-price strong{display:block;font-size:27px;margin:14px 0}.sf-price li{margin:11px 0}.sf-price ul{padding-left:19px} +.sf-map-address{font-style:normal;font-size:18px;white-space:pre-line;line-height:1.8} +@media (prefers-reduced-motion:reduce){.sf-slides{scroll-behavior:auto}.sf-item{transition:none}} +@media(max-width:540px){.sf-slide{flex-basis:92%}} diff --git a/examples/mobile-showcase/corporate/assets/commercial.css b/examples/mobile-showcase/corporate/assets/commercial.css new file mode 100644 index 0000000..353bee4 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/commercial.css @@ -0,0 +1,84 @@ +/* SiteForge commercial theme UX layer: accessibility, layout rhythm, media, responsive navigation. */ +:root{--sf-shadow:0 20px 55px rgba(17,33,55,.08);--sf-shadow-hover:0 26px 65px rgba(17,33,55,.15)} +html{scroll-padding-top:104px}body{font-feature-settings:"kern";text-rendering:optimizeLegibility} +a,button,input,select,textarea{-webkit-tap-highlight-color:transparent} +a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:3px solid var(--pro-accent);outline-offset:4px} +.pro-wrap{width:100%;max-width:min(var(--pro-wide),100%)}.pro-header{isolation:isolate;box-shadow:0 1px 0 rgba(15,35,60,.035)}.pro-head-inner{gap:clamp(15px,2vw,29px)}.pro-logo{min-width:0;flex-shrink:0;gap:12px}.pro-brand-logo{max-width:155px;max-height:46px;width:auto;height:auto;object-fit:contain}.pro-logo-name{overflow-wrap:anywhere}.pro-navigation{gap:clamp(11px,1.6vw,24px)}.pro-header-cta{white-space:nowrap} +.pro-mobile-toggle,.pro-catalog-toggle,.pro-nav-disclose{border:0;background:transparent;color:inherit;line-height:1.2} +.pro-mobile-toggle{min-height:44px;min-width:44px;border:1px solid currentColor;border-radius:6px;font-size:19px}.pro-nav-group{position:relative;display:flex;align-items:center;gap:2px} +.pro-nav-disclose{padding:9px;font-size:13px}.pro-nav-children{position:absolute;top:100%;left:0;min-width:215px;max-width:330px;display:grid;gap:2px;padding:13px;box-shadow:var(--sf-shadow);border-radius:10px;z-index:45;background:var(--pro-background);border:1px solid var(--pro-border);color:var(--pro-text)} +.pro-nav-children[hidden],.pro-mega[hidden]{display:none!important}.pro-nav-children a{display:block;font-size:13px;white-space:normal;padding:10px;border-radius:5px}.pro-nav-children a:hover{background:var(--pro-surface)} +.pro-catalog-toggle{padding:11px 3px;white-space:nowrap;font-size:12px;font-weight:700}.pro-mega{position:absolute;top:100%;left:50%;transform:translateX(-50%);width:min(100%,var(--pro-wide));box-shadow:var(--sf-shadow);z-index:41;display:grid;grid-template-columns:215px 1fr;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);border-radius:0 0 15px 15px;padding:29px;align-items:start}.pro-mega>span{font-size:12px;letter-spacing:.06em}.pro-mega>div{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:9px 22px;overflow:visible}.pro-mega>div a{white-space:normal;padding:10px 5px;border-bottom:1px solid var(--pro-border)} +.pro-home-hero{overflow:hidden}.pro-home-hero .pro-home-grid{min-height:660px;gap:5%}.pro-home-hero .pro-hero-copy{position:relative;z-index:2}.pro-home-hero .pro-hero-copy h1{font-size:clamp(46px,5.7vw,92px);line-height:1.06;letter-spacing:-.064em;max-width:15ch}.pro-home-hero .pro-hero-copy h1 em{font-style:normal;display:block}.pro-home-hero .pro-hero-copy p{font-size:clamp(15px,1.3vw,19px);line-height:1.75;max-width:44ch}.pro-home-hero .pro-hero-art{min-width:0;min-height:425px;position:relative;isolation:isolate}.pro-home-hero .pro-hero-art>img{width:100%;height:100%;object-fit:cover;position:absolute;inset:0}.pro-hero-art:has(.pro-abstract-car),.pro-hero-art:has(.pro-technical),.pro-hero-art:has(.pro-corporate-shape){background-position:center;background-size:cover;background-repeat:no-repeat}.pro-abstract-car,.pro-technical,.pro-corporate-shape{position:relative;z-index:1;pointer-events:none} +.pro-hero-actions{display:flex;flex-wrap:wrap;align-items:center;gap:15px}.pro-button,.pro-header-cta,.pro-outline-button{min-height:48px;transition:transform .24s ease,box-shadow .24s ease,opacity .24s ease}.pro-button:hover,.pro-header-cta:hover,.pro-outline-button:hover{transform:translateY(-2px);box-shadow:0 10px 22px rgba(0,0,0,.10)} +.pro-section{padding-top:clamp(76px,7vw,112px)!important;padding-bottom:clamp(76px,7vw,112px)!important}.pro-section-head{gap:16px}.pro-section-head h2{font-size:clamp(32px,3.5vw,53px);max-width:22ch}.pro-section-head .pro-text-link{align-self:end} +.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.pro-card{min-width:0;display:flex;flex-direction:column;transition:transform .28s ease,box-shadow .28s ease;border:1px solid var(--pro-border);background:var(--pro-background);overflow:hidden}.pro-card:hover{transform:translateY(-6px);box-shadow:var(--sf-shadow-hover)}.pro-card-cover{aspect-ratio:1.42;overflow:hidden;background:var(--pro-surface);position:relative}.pro-card-cover .pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .45s ease}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-card-body{display:flex;flex-direction:column;flex:1}.pro-card-body h3{font-size:clamp(19px,1.6vw,24px);line-height:1.26}.pro-card-body p{font-size:14px}.pro-card-link{margin-top:auto;padding-top:14px;font-size:13px;font-weight:700} +.pro-art{min-height:100%;width:100%;position:relative;overflow:hidden;display:grid;place-items:center;isolation:isolate}.pro-art-ring{width:60%;aspect-ratio:1;border:1px solid currentColor;opacity:.13;border-radius:50%;transform:rotate(20deg);box-shadow:0 0 0 23px #ffffff10,0 0 0 57px #ffffff07}.pro-art-center{font-size:clamp(38px,5vw,80px);position:absolute;font-weight:800;letter-spacing:-.065em;opacity:.65}.pro-art-label{position:absolute;bottom:19px;left:22px;font-size:10px;letter-spacing:.22em;opacity:.7} +.pro-breadcrumb{display:flex;gap:11px;flex-wrap:wrap;font-size:12px;align-items:center}.pro-breadcrumb a{text-decoration:underline;text-underline-offset:4px}.pro-product-hero{align-items:start;gap:clamp(28px,5vw,80px)}.pro-product-media{aspect-ratio:1.12;background:var(--pro-surface);overflow:hidden}.pro-product-media>img,.pro-product-media>.pro-art{width:100%;height:100%;object-fit:contain}.pro-product-summary{padding:clamp(12px,3vw,50px) 0}.pro-product-summary h1{font-size:clamp(36px,4.3vw,72px)}.pro-detail-layout{border-top:1px solid var(--pro-border);padding-top:50px}.pro-specs>div{display:grid;grid-template-columns:minmax(100px,40%) 1fr;gap:10px;align-items:baseline;padding:15px 0;border-bottom:1px solid var(--pro-border)}.pro-specs strong{overflow-wrap:anywhere}.pro-gallery-thumbs button{flex-basis:96px;height:76px}.pro-gallery-lightbox{backdrop-filter:blur(6px)} +.pro-filter-panel{display:flex;align-items:end;flex-wrap:wrap;gap:16px;background:var(--pro-surface);border:1px solid var(--pro-border);padding:20px;margin-bottom:25px;border-radius:var(--pro-radius)}.pro-filter-panel label{display:grid;gap:7px;min-width:180px;flex:1}.pro-filter-panel input,.pro-filter-panel select{width:100%;background:var(--pro-background);border:1px solid var(--pro-border);padding:12px 14px;color:var(--pro-text);border-radius:6px}.pro-filter-count{white-space:nowrap;font-size:13px;padding:12px 0}.pro-card[hidden]{display:none!important}.pro-filter-empty{padding:38px;border:1px dashed var(--pro-border);text-align:center;grid-column:1/-1} +.pro-inquiry input,.pro-inquiry textarea{min-height:46px}.pro-inquiry textarea{min-height:150px}.pro-inquiry-wrap{gap:clamp(32px,7vw,110px)}.pro-inquiry .pro-button{border:0;justify-self:start}.pro-footer-links a{padding-block:5px;display:inline-block} +.pro-end-cta{overflow:hidden}.pro-end-cta h2{font-size:clamp(30px,4vw,64px)} +.pro-rich{line-height:1.85}.pro-rich img{border-radius:var(--pro-radius);margin-block:24px}.pro-rich table{width:100%;display:block;overflow:auto;border-collapse:collapse}.pro-rich td,.pro-rich th{border:1px solid var(--pro-border);padding:10px 14px}.pro-rich a{text-decoration:underline;text-underline-offset:3px} +@media(min-width:1025px){.pro-navigation>.pro-nav-group:hover .pro-nav-children:not([hidden]){visibility:visible}} +@media(max-width:1150px){.pro-head-inner{gap:15px}.pro-navigation{gap:12px}.pro-logo-name{font-size:15px}.pro-header-cta{padding:13px 16px}} +@media(max-width:1024px){.pro-head-inner{min-height:72px;flex-wrap:wrap}.pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto}.pro-navigation{display:none;width:100%;flex-basis:100%;flex-direction:column;align-items:stretch;gap:0;order:5;margin:0;padding:8px 0 20px;border-top:1px solid var(--pro-border)}.pro-navigation.is-open{display:flex}.pro-navigation>a,.pro-nav-group>a{padding:14px 8px;font-size:15px}.pro-nav-group{display:flex;flex-wrap:wrap;justify-content:space-between}.pro-nav-children{position:static;flex-basis:100%;max-width:none;width:100%;box-shadow:none;border-radius:0;border-left:2px solid var(--pro-accent);margin:0 0 12px 8px}.pro-nav-disclose{min-width:44px;min-height:44px}.pro-catalog-toggle{margin-left:auto}.pro-mega{top:100%;display:block;padding:20px}.pro-mega>div{grid-template-columns:repeat(2,minmax(0,1fr));margin-top:12px}.pro-home-hero .pro-home-grid{min-height:560px}.pro-home-hero .pro-hero-art{min-height:325px}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}} +@media(max-width:700px){.pro-wrap{padding-left:20px;padding-right:20px}.pro-utility{display:none}.pro-head-inner{min-height:66px}.pro-logo-name{max-width:140px;font-size:14px}.pro-brand-logo{max-width:125px}.pro-header-cta{display:none}.pro-catalog-toggle{font-size:11px;padding-inline:7px;margin-left:0}.pro-home-hero .pro-home-grid{display:flex;flex-direction:column;gap:36px;padding-top:48px;padding-bottom:48px}.pro-home-hero .pro-hero-copy h1{font-size:clamp(43px,10vw,68px)}.pro-home-hero .pro-hero-copy p{font-size:15px}.pro-home-hero .pro-hero-art{width:100%;min-height:290px}.pro-home-hero .pro-hero-bottom{display:none}.pro-section{padding-top:68px!important;padding-bottom:68px!important}.pro-section-head{align-items:flex-start}.pro-grid{grid-template-columns:1fr;gap:18px}.pro-card-cover{aspect-ratio:1.45}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-inquiry-wrap{display:grid;grid-template-columns:1fr;gap:30px}.pro-product-summary{padding:0}.pro-specs>div{grid-template-columns:1fr 1fr}.pro-mega{top:100%;max-height:65vh;overflow-y:auto}.pro-mega>div{grid-template-columns:1fr}.pro-filter-panel{display:grid;grid-template-columns:1fr;gap:12px}.pro-filter-panel label{min-width:0}.pro-footer-top{display:grid;grid-template-columns:1fr;gap:27px}.pro-footer-bottom{gap:12px;flex-wrap:wrap}} +@media(max-width:410px){.pro-logo-name{max-width:115px}.pro-logo-symbol{font-size:28px}.pro-catalog-toggle{font-size:10px}.pro-mobile-toggle{min-width:42px}} +@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*:before,*:after{animation-duration:.01ms!important;transition-duration:.01ms!important;scroll-behavior:auto!important}} + +/* Accessible static catalogue pagination for large inventories. */ +.pro-pages-nav{display:flex;gap:1rem;justify-content:center;align-items:center;margin:2rem 0;flex-wrap:wrap} +.pro-pages-nav a{padding:.7rem 1.1rem;border:1px solid currentColor;border-radius:.4rem;text-decoration:none} +.pro-pages-nav a:focus-visible{outline:3px solid var(--accent,#2563eb);outline-offset:3px} +.pro-pages-nav span{font-size:.875rem} + +/* P6 international sites: small, keyboard-operable language switch. */ +.sf-language-switch{display:inline-flex;gap:6px;align-items:center;flex-wrap:wrap;margin:8px 12px;padding:4px;border:1px solid rgba(120,130,145,.22);border-radius:10px;background:rgba(255,255,255,.08)} +.sf-language-switch a{font:inherit;font-size:12px;line-height:1.5;padding:4px 7px;border-radius:6px;color:inherit;text-decoration:none} +.sf-language-switch a[aria-current="page"]{font-weight:700;text-decoration:underline;text-underline-offset:3px} +.sf-language-switch a:focus-visible{outline:2px solid #2563eb;outline-offset:3px} +@media(max-width:640px){.sf-language-switch{margin:6px 0;width:auto}} + +/* V8.21.3 — Four-theme unified mobile off-canvas navigation & optional tab bar. + Desktop remains unchanged. Phone / tablet use one accessible drawer. */ +.sf-mobile-tabs{display:none!important} +.sf-drawer-header,.sf-mobile-drawer-backdrop,.sf-drawer-extra{display:none} +@media(max-width:1024px){ + .pro-head-inner{flex-wrap:nowrap!important;gap:12px!important} + .pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto!important;flex:0 0 44px;min-width:44px;min-height:44px;position:relative;z-index:3} + .pro-catalog-toggle{display:none!important} + .pro-navigation,.pro-navigation.is-open{display:flex!important;position:fixed!important;inset:0 0 0 auto!important;width:min(88vw,360px)!important;height:100dvh!important;height:100vh;max-height:100dvh!important;flex:unset!important;flex-direction:column!important;align-items:stretch!important;order:unset!important;margin:0!important;padding:0 0 calc(20px + env(safe-area-inset-bottom,0px))!important;overflow-x:hidden;overflow-y:auto!important;background:var(--pro-background,#fff)!important;color:var(--pro-text,#19283c)!important;border:0!important;border-left:1px solid var(--pro-border,#ddd)!important;box-shadow:-15px 0 45px #0002!important;z-index:1201!important;transform:translateX(105%);visibility:hidden;pointer-events:none;transition:transform .24s ease,visibility .24s ease!important;overscroll-behavior:contain} + .pro-navigation.is-open{transform:translateX(0);visibility:visible;pointer-events:auto} + .sf-drawer-header{display:flex!important;align-items:center;justify-content:space-between;gap:12px;padding:20px 18px;border-bottom:1px solid var(--pro-border,#dde3e9);font-size:17px;font-weight:750;position:sticky;top:0;background:var(--pro-background,#fff);z-index:2} + .sf-drawer-close{min-width:44px;min-height:44px;border:1px solid var(--pro-border,#dde3e9);color:inherit;background:transparent;border-radius:10px;font-size:24px;cursor:pointer} + .sf-mobile-drawer-backdrop{display:block;position:fixed;inset:0;z-index:1200;background:#0b1b31a3;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .24s ease,visibility .24s ease} + .sf-mobile-drawer-backdrop.is-open{opacity:1;visibility:visible;pointer-events:auto} + body.sf-drawer-open{overflow:hidden!important} + .pro-navigation>a,.pro-navigation .pro-nav-group>a,.pro-navigation .sf-drawer-extra>a{display:flex;align-items:center;min-height:50px;padding:13px 20px!important;font-size:15px!important;color:inherit!important;white-space:normal;border-bottom:1px solid var(--pro-border,#dde3e9)!important;text-decoration:none!important} + .pro-navigation .pro-nav-group{display:flex;position:relative;flex-wrap:wrap!important;width:100%;gap:0;align-items:center;justify-content:space-between} + .pro-navigation .pro-nav-group>a{flex:1;min-width:0} + .pro-navigation .pro-nav-disclose{margin-right:12px;min-width:44px;min-height:44px;border-radius:9px;background:var(--pro-surface,#f4f6f8)} + .pro-navigation .pro-nav-children{position:static!important;width:100%!important;max-width:100%!important;box-shadow:none!important;border-left:3px solid var(--pro-accent,#e77730);border-radius:0!important;margin:0 0 8px 14px!important;flex-basis:calc(100% - 14px)!important;background:var(--pro-surface,#f6f8fa)} + .pro-navigation .pro-nav-children a{padding:12px 16px!important;font-size:14px!important;color:inherit!important;min-height:44px} + .sf-drawer-extra{display:block;padding:12px 0 5px}.sf-drawer-extra strong{display:block;font-size:12px;letter-spacing:.06em;padding:12px 20px;opacity:.65}.sf-drawer-extra a{font-size:14px!important} + .sf-drawer-close:focus-visible,.pro-mobile-toggle:focus-visible,.pro-nav-disclose:focus-visible,.sf-mobile-tab:focus-visible{outline:3px solid var(--pro-accent,#ff8200);outline-offset:2px} +} +@media(max-width:767px){ + .pro-header-cta{display:none!important} + .pro-head-inner .pro-logo{min-width:0;max-width:calc(100% - 65px)} + .pro-logo-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .pro-home-hero .pro-home-grid{min-height:0!important} + .pro-home-hero .pro-hero-art{min-height:230px} + .pro-card,.pro-card-cover,.pro-product-media{max-width:100%;min-width:0} + .pro-rich img,.pro-content img,.sf-canvas img{max-width:100%;height:auto} + .pro-rich table{max-width:100%;overflow:auto} + .pro-grid,.pro-footer-top{min-width:0} + .sf-mobile-tabs{display:grid!important;position:fixed;z-index:1100;bottom:0;left:0;right:0;grid-template-columns:repeat(var(--sf-mobile-tab-count,4),minmax(0,1fr));align-items:stretch;padding:5px 6px calc(5px + env(safe-area-inset-bottom,0px));min-height:63px;background:var(--pro-background,#fff);color:var(--pro-text,#263446);border-top:1px solid var(--pro-border,#dfe4eb);box-shadow:0 -6px 24px #13223914} + .sf-mobile-tab{appearance:none;border:0!important;background:transparent!important;color:inherit!important;text-decoration:none!important;padding:6px 2px;min-height:50px;min-width:0;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:2px;border-radius:9px;cursor:pointer;font-family:inherit} + .sf-tab-icon{font-size:23px;line-height:1.15;font-weight:500} + .sf-tab-label{font-size:11px;font-weight:600;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .sf-mobile-tab[aria-current=page]{color:var(--pro-accent,#e47730)!important;background:var(--pro-surface,#f5f6f8)!important} + body:has(> .sf-mobile-tabs){padding-bottom:calc(76px + env(safe-area-inset-bottom,0px))!important} +} +@media(min-width:768px){.sf-mobile-tabs{display:none!important}} +@media(prefers-reduced-motion:reduce){.pro-navigation,.sf-mobile-drawer-backdrop{transition:none!important}} diff --git a/examples/mobile-showcase/corporate/assets/custom.css b/examples/mobile-showcase/corporate/assets/custom.css new file mode 100644 index 0000000..e18a2d4 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/custom.css @@ -0,0 +1 @@ +body .pro-utility[hidden]{display:none!important}@media(max-width:1023px){.sf-canvas .sf-section{padding-block:64px}}@media(max-width:767px){.sf-canvas .sf-section{padding-block:40px}.pro-wrap,.sf-container{padding-left:20px;padding-right:20px}body .pro-utility{display:none!important}} \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/assets/factory.css b/examples/mobile-showcase/corporate/assets/factory.css new file mode 100644 index 0000000..154ffb3 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/factory.css @@ -0,0 +1,27 @@ +/* SiteForge trusted global shell. Site themes remain visually independent. */ +:root{--sf-shell:#12243d;--sf-shell-accent:#dcae71;--sf-shell-soft:#edf2f8;--sf-shell-fg:#173049} +html{scroll-behavior:smooth}body{overflow-x:hidden}body>.header,body>.utility,body>.top,body>header,body>footer{display:none!important} +.sf-theme-industrial{--sf-shell:#114e79;--sf-shell-accent:#92d5ed;--sf-shell-soft:#ebf6fa;--sf-shell-fg:#0c4267} +.sf-theme-corporate{--sf-shell:#232d62;--sf-shell-accent:#b8bdff;--sf-shell-soft:#f3f3fa;--sf-shell-fg:#333468} +.sf-theme-minimal{--sf-shell:#1e1e1c;--sf-shell-accent:#ded6c5;--sf-shell-soft:#f6f4ef;--sf-shell-fg:#252520} +.sf-site-head{position:relative;z-index:25;background:var(--sf-shell);color:#fff;font-family:system-ui,-apple-system,sans-serif} +.sf-head-inner{max-width:1240px;margin:0 auto;min-height:78px;padding:0 28px;display:flex;align-items:center;gap:28px} +.sf-logo{display:flex;align-items:center;gap:11px;font-size:18px;text-decoration:none!important;color:#fff!important;white-space:nowrap} +.sf-logo-mark{width:36px;height:36px;display:grid;place-items:center;background:var(--sf-shell-accent);color:var(--sf-shell);font-size:22px;font-weight:900;border-radius:9px} +.sf-primary-links{display:flex;gap:23px;margin-left:auto;align-items:center} +.sf-primary-links a,.sf-mega a{color:#fff!important;text-decoration:none!important;font-size:13px;font-weight:650;white-space:nowrap} +.sf-primary-links a:hover{color:var(--sf-shell-accent)!important} +.sf-head-cta{font-size:13px;font-weight:750;text-decoration:none;background:var(--sf-shell-accent);color:var(--sf-shell)!important;padding:13px 18px;border-radius:4px;white-space:nowrap} +.sf-menu-toggle{display:none;margin-left:auto;color:white;border:1px solid #ffffff55;background:none;border-radius:4px;padding:8px 12px;font-size:19px;cursor:pointer} +.sf-mega{display:flex;gap:18px;max-width:1240px;margin:auto;padding:0 28px 9px;overflow-x:auto} +.sf-mega a{display:block;min-width:120px;border-top:1px solid #ffffff2e;padding:12px 8px}.sf-mega small{display:block;color:#ffffff99;max-width:160px;overflow:hidden;text-overflow:ellipsis;font-size:10px;margin-top:6px} +.sf-site-foot{background:var(--sf-shell);color:white!important;font:14px/1.7 system-ui,-apple-system,sans-serif;padding:72px 28px 26px} +.sf-foot-grid{max-width:1200px;margin:auto;display:grid;grid-template-columns:2fr 1fr 1fr;gap:70px}.sf-foot-grid h2{font-size:25px;color:white;margin:0 0 17px}.sf-foot-grid h4{font-size:13px;color:var(--sf-shell-accent);letter-spacing:.07em;margin:0 0 17px}.sf-foot-grid p{color:#ffffffae;max-width:380px}.sf-foot-grid a{display:block;width:fit-content;color:#fff!important;text-decoration:none;margin-bottom:8px}.sf-foot-lower{border-top:1px solid #ffffff33;max-width:1200px;margin:45px auto 0;padding-top:20px;display:flex;justify-content:space-between;color:#ffffff9e;font-size:12px} +.sf-filters{display:flex;align-items:center;flex-wrap:wrap;gap:12px;margin:0 0 30px}.sf-filters input,.sf-filters select{padding:11px 13px;border-radius:6px;border:1px solid #cfd9e4;background:#fff;color:#263a51;max-width:280px}.sf-filter-empty{padding:22px;color:#778598} +.sf-search-page{min-height:76vh;max-width:1060px;padding:90px 24px;margin:auto;font-family:system-ui,sans-serif;color:var(--sf-shell-fg)}.sf-search-page h1{font-size:clamp(35px,5vw,62px);margin:20px 0}.sf-search-page>label{display:block;margin:18px 0 8px}.sf-search-page input{display:block;width:100%;padding:17px;font-size:18px;border:1px solid #b7c6d7;border-radius:8px}.sf-search-page #sf-search-count{margin:22px 0;color:#607589}.sf-search-result{padding:22px 0;border-bottom:1px solid #dae1ea}.sf-search-result a{color:var(--sf-shell-fg);font-size:21px;font-weight:750;text-decoration:none}.sf-search-result small{display:block;color:#7992a7}.sf-search-result p{margin:7px 0;color:#657487} +@media(max-width:1050px){.sf-head-inner{gap:13px}.sf-primary-links{gap:12px}.sf-primary-links a{font-size:12px}.sf-head-cta{padding:10px}} +@media(max-width:850px){.sf-head-inner{min-height:68px}.sf-menu-toggle{display:block}.sf-head-cta{display:none}.sf-primary-links{display:none;position:absolute;top:68px;left:0;right:0;margin:0;background:var(--sf-shell);padding:20px 28px;flex-direction:column;align-items:stretch;box-shadow:0 20px 24px #0002}.sf-primary-links.is-open{display:flex}.sf-mega{display:none}.sf-foot-grid{grid-template-columns:1fr 1fr;gap:35px}} +@media(max-width:560px){.sf-foot-grid{grid-template-columns:1fr}.sf-foot-lower{display:block}.sf-site-foot{padding-top:48px}.sf-head-inner{padding:0 16px}} + +.sf-page-intro{padding:80px 28px;background:var(--sf-shell-soft);color:var(--sf-shell-fg);font-family:system-ui,sans-serif}.sf-page-intro>div{max-width:1200px;margin:auto}.sf-page-intro p{font-size:11px;font-weight:850;letter-spacing:.19em;text-transform:uppercase;color:var(--sf-shell-fg);opacity:.58}.sf-page-intro h1{font-size:clamp(38px,5vw,67px);letter-spacing:-.04em;line-height:1.08;margin:13px 0}.sf-page-intro span{font-size:16px;opacity:.72} +.sf-item[hidden]{display:none!important} diff --git a/examples/mobile-showcase/corporate/assets/pro-base.css b/examples/mobile-showcase/corporate/assets/pro-base.css new file mode 100644 index 0000000..c2c4f61 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/pro-base.css @@ -0,0 +1,21 @@ +/* SiteForge V3 professional theme primitives. Each commercial theme adds its own art direction. */ +:root{--pro-text:#19283a;--pro-muted:#687587;--pro-border:#dfe5ea;--pro-background:#fff;--pro-surface:#f5f7fa;--pro-accent:#365cb7;--pro-hero:#15263d;--pro-hero-fg:#fff;--pro-radius:12px;--pro-headings:system-ui,-apple-system,sans-serif;--pro-font:system-ui,-apple-system,sans-serif;--pro-wide:1270px} +*,*:before,*:after{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--pro-background);color:var(--pro-text);font-family:var(--pro-font);-webkit-font-smoothing:antialiased;overflow-x:hidden}button,input,select{font:inherit}button,a{touch-action:manipulation}button{cursor:pointer}a{text-decoration:none;color:inherit}a:hover{color:var(--pro-accent)}img{max-width:100%;display:block}h1,h2,h3,h4,p{margin-top:0}h1,h2,h3{font-family:var(--pro-headings);line-height:1.09}h1{letter-spacing:-.052em}h2{letter-spacing:-.042em}h3{letter-spacing:-.028em}p{line-height:1.72}.pro-wrap{max-width:var(--pro-wide);margin:0 auto;padding-left:32px;padding-right:32px}.pro-skip{position:absolute;left:-9999px;z-index:90;background:#fff;color:#000;padding:12px}.pro-skip:focus{left:10px;top:10px}.pro-eyebrow{font-weight:750;font-size:11px;letter-spacing:.17em;text-transform:uppercase;display:block;line-height:1.6;color:var(--pro-accent)}.pro-muted{opacity:.7}.pro-utility{min-height:30px;background:var(--pro-hero);color:#c5d2db;font-size:10px;letter-spacing:.16em}.pro-utility .pro-wrap{display:flex;justify-content:space-between;padding-block:8px}.pro-utility i{font-style:normal;color:var(--pro-accent)}.pro-header{background:var(--pro-background);color:var(--pro-text);border-bottom:1px solid var(--pro-border);position:relative;z-index:35}.pro-head-inner{min-height:84px;display:flex;align-items:center;gap:28px}.pro-logo{display:flex;align-items:center;gap:12px;min-width:170px}.pro-logo-symbol{font-size:32px;line-height:1;font-weight:800;letter-spacing:-.07em;color:var(--pro-accent)}.pro-logo-name{max-width:220px;font-weight:820;font-size:17px;line-height:1.1;letter-spacing:-.035em}.pro-logo-name small{display:block;font-weight:650;font-size:9px;letter-spacing:.19em;margin-top:7px;color:var(--pro-muted)}.pro-navigation{display:flex;align-items:center;gap:24px;margin-left:auto}.pro-navigation a{font-size:13px;font-weight:650;white-space:nowrap;transition:opacity .2s}.pro-navigation a:hover{opacity:.6}.pro-header-cta,.pro-button{display:inline-flex;align-items:center;justify-content:center;gap:22px;background:var(--pro-accent);color:#fff!important;border-radius:var(--pro-radius);font-size:13px;letter-spacing:.01em;font-weight:750;padding:16px 24px;white-space:nowrap;transition:transform .2s,background .2s}.pro-header-cta:hover,.pro-button:hover{transform:translateY(-2px)}.pro-mobile-toggle{display:none}.pro-mega{display:flex;align-items:center;gap:22px;min-height:37px;border-top:1px solid var(--pro-border);padding-block:10px;font-size:11px}.pro-mega>span{font-weight:750;color:var(--pro-muted);white-space:nowrap}.pro-mega>div{display:flex;gap:16px;overflow:auto;scrollbar-width:none}.pro-mega a{white-space:nowrap;font-weight:650}.pro-search-link{font-size:19px!important}.pro-home-hero{position:relative;overflow:hidden}.pro-home-grid{display:grid;grid-template-columns:1.02fr .98fr;align-items:center;gap:5%;min-height:580px;padding-top:85px;padding-bottom:85px}.pro-hero-copy{position:relative;z-index:2}.pro-hero-copy h1{font-size:clamp(48px,6.2vw,91px);line-height:1.03;margin:20px 0 25px;max-width:730px}.pro-hero-copy h1 em{font-style:normal;display:block;color:var(--pro-accent)}.pro-hero-copy p{font-size:17px;max-width:495px;color:var(--pro-muted)}.pro-hero-actions{display:flex;align-items:center;flex-wrap:wrap;gap:25px;margin-top:34px}.pro-outline-button{font-weight:700;border-bottom:1px solid currentColor;padding:12px 0}.pro-hero-art{width:100%;height:435px;position:relative;overflow:hidden;border-radius:var(--pro-radius)}.pro-hero-art>img{width:100%;height:100%;object-fit:cover}.pro-hero-bottom{display:flex;justify-content:space-between;font-size:10px;letter-spacing:.18em;padding-block:22px;border-top:1px solid #ffffff32}.pro-section{padding:106px 0}.pro-section-head{display:flex;align-items:end;justify-content:space-between;gap:25px;margin-bottom:34px}.pro-section-head h2{font-size:clamp(36px,4vw,57px);margin:12px 0 0}.pro-text-link{font-size:13px;font-weight:750;display:inline-flex;gap:18px;align-items:center;border-bottom:1px solid;padding-bottom:7px;color:var(--pro-accent)}.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:22px}.pro-card{display:block;min-width:0;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);overflow:hidden;border-radius:var(--pro-radius);transition:transform .25s,box-shadow .25s}.pro-card:hover{transform:translateY(-6px);box-shadow:0 24px 45px #0f25431b}.pro-card-cover{width:100%;height:244px;overflow:hidden;background:var(--pro-surface)}.pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .5s}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-art{width:100%;height:100%;overflow:hidden;display:grid;place-items:center;position:relative;background:linear-gradient(130deg,#d8e1ed,#f3f6f9)}.pro-art-ring{width:55%;aspect-ratio:1;border:28px solid #ffffff5f;border-radius:50%;box-shadow:0 0 0 42px #ffffff30;transform:rotate(-25deg)}.pro-art-center{position:absolute;font-family:var(--pro-headings);font-weight:800;font-size:76px;letter-spacing:-.08em;color:#45647d90}.pro-art-label{position:absolute;bottom:16px;left:18px;letter-spacing:.16em;font-size:9px;color:#435773}.pro-card-body{padding:25px 25px 28px}.pro-card-meta{display:flex;justify-content:space-between;gap:20px;font-size:10px;font-weight:750;letter-spacing:.1em;text-transform:uppercase;color:var(--pro-accent)}.pro-card h3{font-size:23px;margin:14px 0 9px}.pro-card p{font-size:13px;color:var(--pro-muted);margin-bottom:24px;min-height:44px}.pro-card-link{font-size:12px;font-weight:800;display:flex;justify-content:space-between;color:var(--pro-text);padding-top:14px;border-top:1px solid var(--pro-border)}.pro-empty{grid-column:1/-1;padding:45px;border:1px dashed var(--pro-border);background:var(--pro-surface);color:var(--pro-muted)}.pro-statement{background:var(--pro-surface)}.pro-statement-layout{display:grid;grid-template-columns:1fr 2fr;gap:60px}.pro-statement h2{font-size:clamp(36px,4.5vw,63px);max-width:760px}.pro-statement p{max-width:520px;color:var(--pro-muted)}.pro-brand-pills{display:flex;flex-wrap:wrap;gap:12px}.pro-brand-pills a{padding:18px 28px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);font-weight:750}.pro-brand-pills a:hover{border-color:var(--pro-accent)}.pro-inner-hero{background:var(--pro-surface);padding:92px 0 65px;position:relative;overflow:hidden}.pro-inner-hero h1{max-width:870px;font-size:clamp(43px,6vw,85px);margin:18px 0}.pro-inner-hero p{max-width:650px;color:var(--pro-muted);font-size:17px}.pro-breadcrumb{font-size:12px;color:var(--pro-muted);margin-top:25px;display:flex;gap:12px;align-items:center;flex-wrap:wrap}.pro-breadcrumb strong{color:var(--pro-text)}.pro-list-section{padding:65px 0 110px}.pro-filter-panel{display:grid;grid-template-columns:minmax(220px,2fr) 1fr 1fr auto;align-items:end;gap:14px;margin-bottom:35px}.pro-filter-panel label>span{display:block;font-size:11px;margin-bottom:8px;color:var(--pro-muted);font-weight:750}.pro-filter-panel input,.pro-filter-panel select{display:block;width:100%;padding:14px 15px;border-radius:var(--pro-radius);border:1px solid var(--pro-border);background:var(--pro-background);color:var(--pro-text);outline-offset:2px}.pro-filter-count{font-size:12px;padding-bottom:17px;color:var(--pro-muted)}.pro-filter-scope .pro-card[hidden]{display:none}.pro-product-layout{padding-top:38px}.pro-product-layout .pro-breadcrumb{margin-bottom:38px}.pro-product-hero{display:grid;grid-template-columns:1.18fr .82fr;gap:6%;align-items:center}.pro-product-media{height:460px;overflow:hidden;background:var(--pro-surface);border-radius:var(--pro-radius)}.pro-product-media .pro-photo{height:100%}.pro-product-summary h1{font-size:clamp(45px,5vw,72px);margin:16px 0}.pro-product-summary p{font-size:16px;color:var(--pro-muted)}.pro-product-brand{font-weight:700;color:var(--pro-text)!important}.pro-detail-layout{border-top:1px solid var(--pro-border);display:grid;grid-template-columns:1fr 1fr;gap:8%;margin-top:80px;padding-top:55px}.pro-detail-layout h2{font-size:32px;margin-top:13px}.pro-specs{margin-top:25px}.pro-specs>div{display:grid;grid-template-columns:1fr 1fr;gap:22px;padding:16px 0;border-bottom:1px solid var(--pro-border)}.pro-specs span{color:var(--pro-muted)}.pro-rich{line-height:1.85;font-size:16px;overflow-wrap:anywhere}.pro-rich img{border-radius:var(--pro-radius);margin:25px 0}.pro-rich a{text-decoration:underline}.pro-rich h2{margin-top:30px}.pro-lead{font-size:20px;color:var(--pro-muted)}.pro-brand-hero-grid{display:grid;grid-template-columns:1.1fr .9fr;gap:7%;align-items:center}.pro-brand-media{height:300px;overflow:hidden;border-radius:var(--pro-radius)}.pro-article-hero{text-align:center;padding:110px 0 75px;background:var(--pro-surface)}.pro-article-width{max-width:900px}.pro-article-hero h1{font-size:clamp(40px,5vw,75px);margin:15px 0 25px}.pro-article-hero p{color:var(--pro-muted);font-size:18px}.pro-article-hero time{font-size:12px;color:var(--pro-muted)}.pro-article-content{max-width:930px;padding-top:70px;padding-bottom:90px}.pro-article-cover{width:100%;max-height:530px;object-fit:cover;margin-bottom:40px;border-radius:var(--pro-radius)}.pro-article-content>.pro-text-link{margin-top:35px}.pro-case-detail{max-width:1020px}.pro-case-detail>img{width:100%;max-height:620px;object-fit:cover}.pro-case-meta{display:flex;gap:35px;margin:35px 0;color:var(--pro-muted);font-size:13px}.pro-case-meta strong{display:block;color:var(--pro-text);font-size:18px;margin-top:7px}.pro-info-grid{display:grid;grid-template-columns:.8fr 1.2fr;gap:12%}.pro-info-grid h2{font-size:clamp(31px,4.5vw,54px);margin-top:15px}.pro-contact-email{font-size:20px;color:var(--pro-accent);font-weight:750;word-break:break-word}.pro-info-photo{max-height:450px;object-fit:cover;margin-top:35px;border-radius:var(--pro-radius)}.pro-custom-content .sf-section{background:transparent}.pro-custom-content .sf-section:nth-of-type(even){background:var(--pro-surface)}.pro-end-cta{padding:76px 0;background:var(--pro-hero);color:#fff}.pro-end-cta .pro-wrap{display:flex;align-items:center;justify-content:space-between;gap:40px}.pro-end-cta h2{font-size:clamp(32px,4vw,53px);margin:13px 0}.pro-end-cta p{color:#c5c9d1}.pro-end-cta a{background:var(--pro-accent);color:#fff;font-weight:800;padding:19px 30px;border-radius:var(--pro-radius);white-space:nowrap}.pro-404{text-align:center;padding-block:125px}.pro-404>span{font-size:12px;letter-spacing:.3em}.pro-404 h1{font-size:clamp(150px,20vw,320px);margin:10px 0;letter-spacing:-.08em}.pro-404 p{font-size:18px;color:var(--pro-muted)}.pro-404 a{margin-top:22px}.pro-footer{background:#15212d;color:#fff;padding:75px 0 22px}.pro-footer-top{display:grid;grid-template-columns:1.45fr 1fr 1fr;gap:55px}.pro-footer h2{font-size:32px;margin:12px 0}.pro-footer p{max-width:350px;font-size:13px;color:#afbbc8}.pro-footer .pro-eyebrow{color:#b6c3d2}.pro-footer-links ul{margin:0;padding:0;list-style:none;display:grid;grid-template-columns:1fr 1fr;gap:15px}.pro-footer-links a{font-size:13px;color:#d6e0e8}.pro-footer-bottom{border-top:1px solid #ffffff29;margin-top:60px;padding-top:20px;font-size:10px;letter-spacing:.12em;color:#adb9c3;display:flex;justify-content:space-between}.pro-anchor{display:block;height:0}.pro-category-tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}.pro-category-tiles a{padding:35px 28px;min-height:155px;background:var(--pro-surface);display:flex;flex-direction:column;justify-content:space-between}.pro-category-tiles span{font-size:11px;color:var(--pro-muted)}.pro-category-tiles strong{font-size:24px}.pro-category-tiles b{align-self:end}.sf-site-head .sf-head-inner,.sf-site-head .sf-primary-links{display:none} +@media(max-width:1100px){.pro-head-inner{gap:17px}.pro-navigation{gap:14px}.pro-navigation a{font-size:12px}.pro-home-grid{min-height:500px}.pro-hero-copy h1{font-size:60px}.pro-hero-art{height:350px}} +@media(max-width:860px){.pro-wrap{padding-left:22px;padding-right:22px}.pro-utility{display:none}.pro-head-inner{min-height:70px;flex-wrap:wrap;gap:12px}.pro-mobile-toggle{display:block;margin-left:auto;border:1px solid var(--pro-border);padding:8px 12px;background:transparent;color:var(--pro-text);border-radius:5px}.pro-navigation{display:none;order:10;width:100%;flex-direction:column;align-items:stretch;gap:0;padding-bottom:12px}.pro-navigation.is-open{display:flex}.pro-navigation a{padding:11px 2px;border-bottom:1px solid var(--pro-border)}.pro-header-cta{display:none}.pro-mega{display:none}.pro-home-grid{grid-template-columns:1fr;gap:35px;padding-top:60px;padding-bottom:60px}.pro-hero-art{height:350px}.pro-hero-copy h1{font-size:clamp(45px,9vw,73px)}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-brand-hero-grid{grid-template-columns:1fr;gap:35px}.pro-product-media{height:380px}.pro-filter-panel{grid-template-columns:1fr 1fr}.pro-filter-panel label:first-child{grid-column:1/-1}.pro-end-cta .pro-wrap{align-items:start;flex-direction:column}.pro-section{padding:72px 0}.pro-footer-top{grid-template-columns:1fr 1fr}.pro-footer-top>div:first-child{grid-column:1/-1}.pro-category-tiles{grid-template-columns:repeat(2,1fr)}} +@media(max-width:560px){.pro-wrap{padding-left:18px;padding-right:18px}.pro-logo-name{font-size:15px}.pro-hero-copy h1{font-size:43px}.pro-hero-art{height:255px}.pro-hero-bottom{display:none}.pro-home-grid{min-height:0}.pro-grid{grid-template-columns:1fr}.pro-section-head{align-items:start;flex-direction:column}.pro-section-head h2{font-size:37px}.pro-card-cover{height:230px}.pro-filter-panel{grid-template-columns:1fr}.pro-filter-panel label:first-child{grid-column:auto}.pro-filter-count{padding-bottom:4px}.pro-statement-layout,.pro-footer-top{grid-template-columns:1fr;gap:25px}.pro-footer-top>div:first-child{grid-column:auto}.pro-footer-bottom{flex-direction:column;gap:8px}.pro-inner-hero{padding:60px 0}.pro-product-media{height:270px}.pro-product-summary h1{font-size:43px}.pro-category-tiles{grid-template-columns:1fr}.pro-end-cta h2{font-size:38px}.pro-minimal-meta{display:block!important}} + +/* V2 compatibility stylesheet hides direct headers/footers; full themes restore their own. */ +body>header.sf-site-head.pro-header,body>footer.sf-site-foot.pro-footer{display:block!important} + +/* Accessible desktop mega-navigation and mobile disclosure */ +.pro-catalog-toggle{font-size:12px;font-weight:750;border:1px solid var(--pro-border);background:transparent;color:inherit;border-radius:var(--pro-radius);padding:10px 14px;white-space:nowrap} +.pro-mega[hidden]{display:none!important}.pro-mega.is-open{display:flex}.pro-mega>div{padding-block:3px} +@media(max-width:1060px){.pro-catalog-toggle{display:none}} +@media(max-width:860px){.pro-mega.is-open{display:block!important}.pro-mega.is-open>div{display:flex;flex-wrap:wrap;gap:14px;padding:12px 0}.pro-mega>span{white-space:normal}} + +/* V4: responsive nested navigation, gallery and opt-in inquiry integration */ +.pro-nav-group{position:relative;display:flex;align-items:center;gap:3px}.pro-nav-disclose{border:0;background:none;color:inherit;font-size:12px;padding:8px}.pro-nav-children[hidden]{display:none!important}.pro-nav-children{position:absolute;left:0;top:100%;z-index:45;min-width:230px;max-width:360px;padding:10px;background:var(--pro-background);border:1px solid var(--pro-border);box-shadow:0 18px 35px #0002;border-radius:var(--pro-radius);display:flex;flex-direction:column}.pro-nav-children a{padding:10px 12px;white-space:nowrap}.pro-nav-children .pro-nav-leaf{padding-left:28px;color:var(--pro-muted)} +.pro-product-gallery{min-width:0}.pro-gallery-thumbs{display:flex;gap:8px;margin-top:12px;overflow:auto;scrollbar-width:thin;padding-bottom:5px}.pro-gallery-thumbs button{flex:0 0 86px;height:67px;border:2px solid transparent;padding:3px;border-radius:8px;background:var(--pro-surface)}.pro-gallery-thumbs button:focus-visible,.pro-gallery-thumbs button[aria-pressed=true]{border-color:var(--pro-accent)}.pro-gallery-thumbs img{width:100%;height:100%;object-fit:cover;border-radius:4px}.pro-gallery-lightbox{position:fixed;inset:0;background:rgba(10,16,30,.92);z-index:1000;display:grid;place-items:center;padding:6vw}.pro-gallery-lightbox[hidden]{display:none}.pro-gallery-lightbox img{max-width:92vw;max-height:80vh;object-fit:contain}.pro-gallery-lightbox button{position:absolute;right:25px;top:25px;border:1px solid #fff8;background:#222;color:#fff;padding:10px 15px;border-radius:5px} +.pro-inquiry-wrap{display:grid;grid-template-columns:1fr 1fr;gap:70px}.pro-inquiry{display:grid;gap:17px}.pro-inquiry label{display:grid;gap:7px;font-weight:650}.pro-inquiry input,.pro-inquiry textarea{padding:13px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);background:var(--pro-background);color:var(--pro-text);width:100%}.pro-inquiry textarea{min-height:140px}.pro-inquiry .pro-honeypot{position:absolute;left:-10000px;width:1px;height:1px}.pro-inquiry p{font-size:12px;color:var(--pro-muted)} +@media(max-width:860px){.pro-nav-group{display:block}.pro-nav-children{position:static;max-width:none;width:100%;box-shadow:none;border:0;border-left:2px solid var(--pro-accent);padding-left:8px}.pro-nav-group>a{display:inline-block}.pro-inquiry-wrap{grid-template-columns:1fr;gap:20px}} diff --git a/examples/mobile-showcase/corporate/assets/pro.css b/examples/mobile-showcase/corporate/assets/pro.css new file mode 100644 index 0000000..acb5e27 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/pro.css @@ -0,0 +1,7 @@ +:root{--pro-text:#292d50;--pro-muted:#737793;--pro-border:#e1e2ed;--pro-background:#fff;--pro-surface:#f3f3f9;--pro-accent:#6054c5;--pro-hero:#272b61;--pro-radius:18px;--pro-headings:system-ui,Arial,sans-serif;--pro-wide:1250px} +.pro-utility{background:#343771;color:#f6f6ff}.pro-header{background:#fff}.pro-logo-symbol{color:#655dc0;font-size:35px}.pro-logo-name{letter-spacing:-.07em}.pro-navigation a{font-weight:600}.pro-header-cta{background:#4e4aa4;border-radius:999px}.pro-corporate-hero{background:linear-gradient(135deg,#fafafe 0%,#f0f0fc 55%,#e9e8fa 100%)}.pro-corporate-hero .pro-home-grid{min-height:630px}.pro-corporate-hero .pro-hero-copy h1{font-weight:810}.pro-corporate-hero .pro-hero-copy h1 em{color:#6763c3}.pro-corporate-hero .pro-hero-art{border-radius:25px 160px 25px 160px;background:#dad9f7;box-shadow:25px 35px 0 #c3bde655}.pro-corporate-shape{position:absolute;inset:0;display:grid;place-items:center;background:radial-gradient(circle at 70% 40%,#8079dc 0%,#4d4aab 55%,#333576 100%)}.pro-corporate-shape:before{content:'';position:absolute;width:62%;aspect-ratio:1;border:65px solid #a19dfb77;border-radius:50%;left:-15%;top:-27%}.pro-corporate-shape:after{content:'';position:absolute;width:53%;aspect-ratio:1;border:50px solid #9994e955;border-radius:50%;right:-16%;bottom:-33%}.pro-corporate-shape span{z-index:1;color:#fff;font-size:clamp(26px,3vw,42px);font-weight:850;text-align:center;line-height:1.15;letter-spacing:-.06em}.pro-featured{background:#fff}.pro-featured .pro-card{border-color:#e6e5f0;box-shadow:0 18px 35px #30327a0e}.pro-card-cover{background:#e9eaf7}.pro-art-service{background:linear-gradient(120deg,#d5d2f8,#e9e8fa)}.pro-art-center{color:#716eb69c}.pro-statement{background:#f3f2fa;color:#2a2d50}.pro-statement h2{max-width:820px}.pro-statement .pro-text-link{color:#5e56bc}.pro-case-section{background:#f9f9fc}.pro-inner-hero{background:linear-gradient(140deg,#f3f3fc,#dfdff5)}.pro-inner-hero:after{content:'';position:absolute;right:-5%;bottom:-55%;width:400px;aspect-ratio:1;border:80px solid #8780e41a;border-radius:50%}.pro-article-hero{background:#eeedfa}.pro-footer{background:#242750}.pro-end-cta{background:#34366e}.pro-end-cta a{background:#fff;color:#383776!important}.pro-404 h1{color:#8a84d9} + +/* SiteForge V5 commercial signature */ +.pro-corporate-hero .pro-hero-art{background-image:url("./visual/hero.svg")!important;background-position:center;background-size:cover;} + +.pro-corporate-hero .pro-hero-art{background-color:#f5f4ff;border-radius:38px 120px 40px 120px;overflow:hidden;box-shadow:30px 35px 70px #565baa21}.pro-corporate-hero .pro-hero-art .pro-corporate-shape{opacity:0}.pro-card{border:1px solid #e5e2f2;border-radius:20px;box-shadow:0 10px 40px #3d3b8110}.pro-card-cover{border-radius:20px 20px 0 0;background:#edeafa}.pro-art{background:radial-gradient(circle at 75% 32%,#dad5f7,#eceafa 74%);color:#7772c1}.pro-featured{background:#fff}.pro-statement{background:linear-gradient(120deg,#f2f1fc,#e9e7fb)}.pro-brand-section{background:#f6f5fb}.pro-footer{background:#232658;color:#fff}.pro-header-cta{border-radius:100px}.pro-section-head h2{font-weight:760} diff --git a/examples/mobile-showcase/corporate/assets/pro.js b/examples/mobile-showcase/corporate/assets/pro.js new file mode 100644 index 0000000..9cf100d --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/pro.js @@ -0,0 +1,72 @@ +'use strict';(()=>{ + const menu=document.querySelector('[data-pro-menu]'); const nav=document.querySelector('#pro-navigation'); + if(menu&&nav){menu.addEventListener('click',()=>{const open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));nav.classList.toggle('is-open',open);menu.setAttribute('aria-label',open?'关闭导航':'打开导航');});} + // Drawer navigation. The same markup is used across the four professional themes. + const mobileNav=document.querySelector('#pro-navigation'); + let drawerBackdrop=null,drawerClose=null,returnFocus=null; + if(menu&&mobileNav){ + const originalParent=mobileNav.parentNode,originalNext=mobileNav.nextSibling; + const heading=document.createElement('div');heading.className='sf-drawer-header'; + const title=document.createElement('strong');title.textContent='网站导航'; + drawerClose=document.createElement('button');drawerClose.type='button';drawerClose.className='sf-drawer-close';drawerClose.textContent='×';drawerClose.setAttribute('aria-label','关闭网站导航'); + heading.append(title,drawerClose);mobileNav.prepend(heading); + drawerBackdrop=document.createElement('div');drawerBackdrop.className='sf-mobile-drawer-backdrop';drawerBackdrop.hidden=false;document.body.append(drawerBackdrop); + function setDrawer(open,focusBack=true){ + const isMobile=window.matchMedia('(max-width:1024px)').matches; + open=Boolean(open&&isMobile); + if(open){returnFocus=document.activeElement;document.body.append(mobileNav);} + else if(mobileNav.parentNode!==originalParent){if(originalNext&&originalNext.parentNode===originalParent)originalParent.insertBefore(mobileNav,originalNext);else originalParent.append(mobileNav);} + mobileNav.classList.toggle('is-open',open);drawerBackdrop.classList.toggle('is-open',open); + document.body.classList.toggle('sf-drawer-open',open); + menu.setAttribute('aria-expanded',String(open));menu.setAttribute('aria-label',open?'关闭导航':'打开导航'); + mobileNav.setAttribute('aria-hidden',String(!open&&isMobile)); + if('inert' in mobileNav)mobileNav.inert=!open&&isMobile; + if(open)drawerClose.focus(); + else if(focusBack&&returnFocus instanceof HTMLElement){returnFocus.focus();returnFocus=null;} + } + // Replace the old inline-expansion listener: use capture to stop the old listener. + menu.addEventListener('click',e=>{if(!window.matchMedia('(max-width:1024px)').matches)return;e.stopImmediatePropagation();setDrawer(!mobileNav.classList.contains('is-open'));},true); + drawerClose.addEventListener('click',()=>setDrawer(false)); + drawerBackdrop.addEventListener('click',()=>setDrawer(false)); + document.querySelectorAll('[data-mobile-open-menu]').forEach(b=>b.addEventListener('click',()=>setDrawer(true))); + mobileNav.addEventListener('click',e=>{if(e.target.closest('a'))setDrawer(false,false)}); + document.addEventListener('keydown',e=>{ + if(e.key==='Escape'&&mobileNav.classList.contains('is-open')){e.preventDefault();setDrawer(false);} + if(e.key!=='Tab'||!mobileNav.classList.contains('is-open'))return; + const els=[...mobileNav.querySelectorAll('button:not([disabled]),a[href]')].filter(el=>el.getClientRects().length&&!el.closest('[hidden]')); + if(!els.length)return;const first=els[0],last=els[els.length-1]; + if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();} + else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();} + }); + window.matchMedia('(max-width:1024px)').addEventListener('change',()=>setDrawer(false,false)); + if('inert' in mobileNav&&window.matchMedia('(max-width:1024px)').matches)mobileNav.inert=true; + // Do not strand catalogue links when the old mobile mega-button is hidden. + const megaLinks=document.querySelectorAll('[data-pro-mega] a'); + if(megaLinks.length){const wrap=document.createElement('div');wrap.className='sf-drawer-extra';const h=document.createElement('strong');h.textContent='更多分类与系列';wrap.append(h); + [...megaLinks].slice(0,20).forEach(a=>{const clone=a.cloneNode(true);wrap.append(clone);});mobileNav.append(wrap);} + } + const tabbar=document.querySelector('[data-mobile-tabs]'); + if(tabbar){tabbar.style.setProperty('--sf-mobile-tab-count',String(tabbar.children.length));} + const megaButton=document.querySelector('[data-pro-catalog]'), mega=document.querySelector('[data-pro-mega]'); + if(megaButton&&mega){function setMega(open){mega.hidden=!open;mega.classList.toggle('is-open',open);megaButton.setAttribute('aria-expanded',String(open));} + megaButton.addEventListener('click',()=>setMega(mega.hidden)); + document.addEventListener('keydown',e=>{if(e.key==='Escape')setMega(false);}); + document.addEventListener('click',e=>{if(!mega.hidden&&!mega.contains(e.target)&&!megaButton.contains(e.target))setMega(false);}); + } + document.querySelectorAll('.pro-nav-disclose').forEach(button=>{button.addEventListener('click',()=>{let panel=button.parentElement.querySelector('.pro-nav-children');let visible=button.getAttribute('aria-expanded')==='true';button.setAttribute('aria-expanded',String(!visible));panel.hidden=visible;});}); + document.querySelectorAll('.pro-gallery-thumbs').forEach(container=>{const main=container.parentElement.querySelector('.pro-product-media img');const buttons=[...container.querySelectorAll('[data-gallery-image]')]; + buttons.forEach(b=>{b.addEventListener('click',()=>{buttons.forEach(x=>x.setAttribute('aria-pressed',String(x===b)));if(main){main.src=b.dataset.galleryImage;main.alt=b.querySelector('img')?.alt||'';}});}); + if(!main)return;main.tabIndex=0;main.style.cursor='zoom-in';const open=()=>{const pane=document.createElement('div');pane.className='pro-gallery-lightbox';pane.setAttribute('role','dialog');pane.setAttribute('aria-label','产品大图预览');let img=document.createElement('img');img.src=main.src;img.alt=main.alt;const close=document.createElement('button');close.type='button';close.textContent='关闭 ×';pane.append(img,close);document.body.append(pane);const done=()=>{pane.remove();document.removeEventListener('keydown',esc);main.focus();};const esc=e=>{if(e.key==='Escape')done();};document.addEventListener('keydown',esc);close.addEventListener('click',done);pane.addEventListener('click',e=>{if(e.target===pane)done();});close.focus();};main.addEventListener('click',open);main.addEventListener('keydown',e=>{if(e.key==='Enter')open();}); + }); + document.querySelectorAll('.pro-filter-scope').forEach(scope=>{ + const panel=scope.previousElementSibling;if(!panel||!panel.classList.contains('pro-filter-panel'))return; + const cards=Array.from(scope.querySelectorAll('.pro-card')); + const blank=document.createElement('div');blank.className='pro-filter-empty';blank.hidden=true;blank.textContent='没有找到符合条件的内容，请调整关键词或筛选条件。';scope.append(blank); + const q=panel.querySelector('[data-pro-filter-search]'),b=panel.querySelector('[data-pro-filter-brand]'),c=panel.querySelector('[data-pro-filter-category]'),count=panel.querySelector('[data-pro-filter-count]'); + function options(sel,key){const vals=[...new Set(cards.map(x=>x.dataset[key]||'').filter(Boolean))].sort();vals.forEach(x=>sel.add(new Option(x,x)));if(!vals.length)sel.closest('label').hidden=true;} + options(b,'brand');options(c,'category'); + function run(){const str=q.value.trim().toLocaleLowerCase();let visible=0; + cards.forEach(el=>{const hit=el.textContent.toLocaleLowerCase().includes(str)&&(!b.value||el.dataset.brand===b.value)&&(!c.value||el.dataset.category===c.value);el.hidden=!hit;visible+=Number(hit);});count.textContent=`共 ${visible} 条`;blank.hidden=visible!==0;} + [q,b,c].forEach(x=>x.addEventListener(x===q?'input':'change',run));run(); + }); +})(); diff --git a/examples/mobile-showcase/corporate/assets/search-index.json b/examples/mobile-showcase/corporate/assets/search-index.json new file mode 100644 index 0000000..0637a08 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/search-index.json @@ -0,0 +1 @@ +[] \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/assets/site-runtime.js b/examples/mobile-showcase/corporate/assets/site-runtime.js new file mode 100644 index 0000000..e4715e8 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/site-runtime.js @@ -0,0 +1,31 @@ +'use strict'; +(()=>{ + const $=s=>document.querySelector(s), $$=s=>[...document.querySelectorAll(s)]; + const menu=$('.sf-menu-toggle');if(menu){menu.addEventListener('click',()=>{let open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));$('#sf-primary-links')?.classList.toggle('is-open',open);});} + // Filter actual static content cards, no API is needed at runtime. + $$('.sf-collection').forEach(grid=>{ + const cards=$$('.sf-item',grid); + if(cards.length<2)return; + const toolbar=document.createElement('div');toolbar.className='sf-filters'; + const search=document.createElement('input');search.type='search';search.placeholder='筛选当前列表';search.setAttribute('aria-label','筛选当前列表'); + const status=document.createElement('span');status.setAttribute('aria-live','polite');status.style.fontSize='12px'; + const brand=document.createElement('select');brand.setAttribute('aria-label','按品牌筛选'); + const category=document.createElement('select');category.setAttribute('aria-label','按分类筛选'); + function fill(el,field,all){el.append(new Option(all,''));const vals=[...new Set(cards.map(x=>x.dataset[field]||'').filter(Boolean))].sort();vals.forEach(v=>el.append(new Option(v,v)));if(!vals.length)el.hidden=true;} + fill(brand,'brand','全部品牌');fill(category,'category','全部分类'); + toolbar.append(search,brand,category,status);grid.parentNode.insertBefore(toolbar,grid); + function apply(){let val=search.value.trim().toLocaleLowerCase();let visible=0;cards.forEach(card=>{let hit=card.textContent.toLocaleLowerCase().includes(val)&&(!brand.value||card.dataset.brand===brand.value)&&(!category.value||card.dataset.category===category.value);card.hidden=!hit;if(hit)visible++;});status.textContent=`共 ${visible} 项`;} + search.addEventListener('input',apply);brand.addEventListener('change',apply);category.addEventListener('change',apply);apply(); + }); + const input=$('#sf-search'),root=$('#sf-search-results'),count=$('#sf-search-count'); + if(input&&root){ + let data=[];const params=new URLSearchParams(location.search);input.value=params.get('q')||''; + let debounce=null; + const render=()=>{let q=input.value.trim().toLocaleLowerCase();let found=q?data.filter(d=>`${d.title} ${d.summary} ${d.brand} ${d.type}`.toLocaleLowerCase().includes(q)).slice(0,100):data.slice(0,30); + root.replaceChildren();count.textContent=`${found.length} 条结果${!q?'（显示前30条）':''}`; + found.forEach(d=>{let article=document.createElement('article'),a=document.createElement('a'),small=document.createElement('small'),p=document.createElement('p');article.className='sf-search-result';a.textContent=d.title;a.href=d.url.replace(/^\//,'');small.textContent=d.type;p.textContent=d.summary;article.append(a,small,p);root.append(article);}); + };const base=document.querySelector('base')?.href||location.href; + fetch(new URL('search-index.json',base)).then(r=>{if(!r.ok)throw Error('index unavailable');return r.json();}).then(v=>{data=v;render()}).catch(()=>{count.textContent='搜索索引加载失败，请检查站点文件部署路径';}); + input.addEventListener('input',()=>{clearTimeout(debounce);debounce=setTimeout(render,100)}); + } +})(); diff --git a/examples/mobile-showcase/corporate/assets/theme.css b/examples/mobile-showcase/corporate/assets/theme.css new file mode 100644 index 0000000..a081c46 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/theme.css @@ -0,0 +1 @@ +:root{--ink:#152040;--blue:#283d8c;--purple:#6558b9;--light:#f6f7fb}*{box-sizing:border-box}body{margin:0;background:white;color:#172347;font-family:Inter,"Segoe UI",Arial,sans-serif;line-height:1.65}a{color:inherit;text-decoration:none}img{max-width:100%}.shell{width:min(1200px,89%);margin:auto}.announcement{height:35px;background:#262d70;color:white;display:flex;justify-content:center;align-items:center;gap:12px;font-size:10px;letter-spacing:1.3px}.announcement span{color:#b8d6fd}.header{height:94px;display:flex;align-items:center;justify-content:space-between;gap:20px}.logo{font-size:23px;font-weight:850;letter-spacing:-1px;display:flex;align-items:center;gap:12px}.logo-box{display:grid;place-items:center;width:43px;height:43px;color:#fff;font-size:25px;background:linear-gradient(135deg,#5b6ce0,#7c4dc3);border-radius:13px}.header nav{display:flex;gap:28px;font-size:13px;font-weight:600;flex-wrap:wrap}.header nav a:hover{color:#585cca}.nav-btn{background:#243475;color:#fff;padding:13px 20px;border-radius:8px;font-size:12px;font-weight:700}.nav-btn span{margin-left:18px}.hero{background:linear-gradient(120deg,#f5f7ff,#ebeeff 45%,#f8f6fc);overflow:hidden}.hero-grid{min-height:580px;display:grid;grid-template-columns:53% 47%;align-items:center}.hero-text{padding:70px 0}.pill{font-size:10px;letter-spacing:1.5px;color:#5549ac;background:#e5e5fa;border-radius:50px;display:inline-block;padding:8px 15px;font-weight:750}.hero h1{font-size:clamp(52px,6.2vw,87px);line-height:1.06;letter-spacing:-4px;margin:32px 0 20px;max-width:620px;color:#19265e}.hero p{font-size:18px;line-height:1.8;color:#69718f;max-width:520px}.actions{display:flex;gap:14px;flex-wrap:wrap;margin-top:34px}.primary,.secondary{padding:14px 24px;border-radius:8px;font-size:13px;font-weight:750}.primary{background:#38489e;color:#fff}.secondary{background:white;border:1px solid #d2d7ed}.trusted{font-size:10px;color:#9b9db6;letter-spacing:2px;margin-top:77px}.trusted span{padding:0 9px}.abstract-art{position:relative;height:100%;min-height:440px;display:grid;place-items:center}.abstract-art img{max-height:510px;object-fit:contain;filter:drop-shadow(0 25px 30px #33376620)}.orb{position:absolute;border-radius:50%;filter:drop-shadow(18px 15px 25px #5b69b125)}.orb-main{width:350px;height:350px;background:radial-gradient(circle at 30% 25%,#d9ddff,#8493e4 40%,#3d539e 70%,#1c3079);transform:rotate(-20deg)}.orb-inner{width:250px;height:250px;background:radial-gradient(circle at 30% 35%,#fff9,#a1aff366 38%,#5c68aa9c 65%);border:1px solid #ffffffc4;transform:translate(80px,60px)}.orb-small{width:93px;height:93px;background:linear-gradient(125deg,#c59fff,#6851a6);transform:translate(-155px,-155px)}.art-caption{position:relative;z-index:3;color:#fff;font-size:15px;line-height:1.4;letter-spacing:3px;text-align:center;font-weight:800;transform:translate(5px,20px)}.inner-hero{padding:85px 0;background:#f0f2ff}.inner-hero h1{font-size:clamp(40px,6vw,70px);letter-spacing:-2px;line-height:1.1;margin:20px 0}.inner-hero p{color:#69748c}.content{padding:60px 0 100px}.nudge{color:#6b6c95;font-size:10px;letter-spacing:2px;font-weight:750}.nudge span{color:#7b58d0;margin-right:7px}.section-header{margin:62px 0 25px;display:flex;justify-content:space-between;align-items:end}.section-header h2{font-size:40px;letter-spacing:-1.5px;margin:7px 0}.section-header>span{font-size:12px;color:#858eaa}.kicker{font-size:11px;color:#685dba;letter-spacing:2px}.tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:22px}.tile{border:1px solid #eceef8;border-radius:15px;overflow:hidden;transition:box-shadow .2s,transform .2s}.tile:hover{box-shadow:0 18px 32px #323c7c18;transform:translateY(-4px)}.tile-image{height:195px;background:linear-gradient(130deg,#cbd3f5,#929de0);display:grid;place-items:center}.tile-image img{width:100%;height:100%;object-fit:contain}.tile-image>span{font-size:85px;color:#ffffffa8}.tile-info{padding:25px}.tile-info>span{font-size:10px;color:#7d6eba;letter-spacing:1.5px}.tile-info h3{font-size:23px;margin:9px 0}.tile-info p{font-size:13px;color:#7c859b;min-height:40px}.tile-info b{font-size:12px;color:#4e51a3}.rich-content{margin:30px 0}.section{padding:40px 0}.feature-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:15px}.feature{padding:27px;background:#f5f6fd;border-radius:10px}.feature-mark{color:#6e68c7}.stat strong{display:block;font-size:38px}.stats{display:grid;grid-template-columns:repeat(4,1fr);gap:20px}.cta{padding:50px;background:#252d73;color:white;border-radius:18px}.cta p{color:#c2c6ec}.big-cta{background:#293788;color:white;border-radius:20px;padding:60px;margin-top:90px;position:relative;overflow:hidden}.big-cta:after{content:'✦';position:absolute;right:-15px;top:-110px;font-size:410px;opacity:.10}.big-cta span{font-size:10px;letter-spacing:2px}.big-cta h2{font-size:45px;line-height:1.2;letter-spacing:-2px}.big-cta a{display:inline-block;background:white;color:#313e9a;padding:14px 20px;border-radius:9px;font-size:12px;font-weight:800}.detail-image{text-align:center;margin:30px 0}.detail-image img{max-height:520px}footer{background:#151c3c;color:white;padding:70px 0 30px}.footer-upper{display:flex;align-items:center;justify-content:space-between}.footer-upper h2{font-size:30px}.footer-upper p{color:#a6acce}.footer-line{border-top:1px solid #424866;padding-top:28px;margin-top:60px;display:flex;justify-content:space-between;color:#a7aed4;font-size:10px;letter-spacing:1.4px}@media(max-width:900px){.header{height:auto;padding:20px 0;flex-wrap:wrap}.header nav{order:3;width:100%}.hero-grid{grid-template-columns:1fr}.abstract-art{min-height:340px}.trusted{margin-top:40px}.tiles{grid-template-columns:repeat(2,1fr)}}@media(max-width:560px){.tiles,.feature-grid,.stats{grid-template-columns:1fr}.hero h1{font-size:54px}.footer-upper,.footer-line,.section-header{align-items:start;flex-direction:column}.announcement{padding:0 8px;font-size:8px}.big-cta h2{font-size:34px}} diff --git a/examples/mobile-showcase/corporate/assets/visual/hero.svg b/examples/mobile-showcase/corporate/assets/visual/hero.svg new file mode 100644 index 0000000..f89e148 --- /dev/null +++ b/examples/mobile-showcase/corporate/assets/visual/hero.svg @@ -0,0 +1 @@ +IDEAS / PROGRESS diff --git a/examples/mobile-showcase/corporate/index.html b/examples/mobile-showcase/corporate/index.html new file mode 100644 index 0000000..ff2e90b --- /dev/null +++ b/examples/mobile-showcase/corporate/index.html @@ -0,0 +1,16 @@ +企业服务跳转至正文 + + +
联系我们 ↗
+
STRATEGY · PARTNERSHIP · DELIVERY

企业服务 IDEAS INTO IMPACT.

连接更可靠的全球业务

探索业务 ↗关于企业
BRINGING
IDEAS TO LIFE
+ +
ABOUT THE COMPANY

以专业连接价值，以合作创造可能。

连接更可靠的全球业务

了解我们 ↗
+ + +
+
LET'S CONNECT

从这里开始下一步。

连接更可靠的全球业务

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/listing.html b/examples/mobile-showcase/corporate/listing.html new file mode 100644 index 0000000..482f353 --- /dev/null +++ b/examples/mobile-showcase/corporate/listing.html @@ -0,0 +1,22 @@ +全部产品跳转至正文 + + +
联系我们 ↗
+
DISCOVER / COLLECTION

全部产品

分类查看产品与解决方案

首页／全部产品
+
+ +
+
标准CATALOG
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+ +
+
LET'S CONNECT

从这里开始下一步。

连接更可靠的全球业务

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/corporate/product.html b/examples/mobile-showcase/corporate/product.html new file mode 100644 index 0000000..778d2b5 --- /dev/null +++ b/examples/mobile-showcase/corporate/product.html @@ -0,0 +1,17 @@ +标准系列产品跳转至正文 + + +
联系我们 ↗
+
首页／产品中心／标准系列产品
+
+
标准PRODUCT
+
PRODUCT DETAILS / EXAMPLE

标准系列产品

面向全球客户的精选示范产品

品牌 · EXAMPLE

咨询该产品 ↗
+
OVERVIEW

产品介绍

规格、优势与适用场景的示例描述。

SPECIFICATIONS

规格参数

Capacity可定制
Material高品质
+ +
+
LET'S CONNECT

从这里开始下一步。

连接更可靠的全球业务

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/index.html b/examples/mobile-showcase/index.html new file mode 100644 index 0000000..eb3e61a --- /dev/null +++ b/examples/mobile-showcase/index.html @@ -0,0 +1,3 @@ +四套主题移动端实际模板预览 | SiteForge

SiteForge · 四套主题手机布局

V8.21.3 真实模板离线演示 · 右上角汉堡菜单打开抽屉，底部 Tabs 仅在手机宽度显示

\ No newline at end of file diff --git a/examples/mobile-showcase/industrial/article.html b/examples/mobile-showcase/industrial/article.html new file mode 100644 index 0000000..86fe13c --- /dev/null +++ b/examples/mobile-showcase/industrial/article.html @@ -0,0 +1,13 @@ +企业动态与行业资讯跳转至正文 + + +
联系我们 ↗
+
LATEST NEWS / INSIGHTS

企业动态与行业资讯

了解最新项目与服务进展

项目背景

这是一段用于检查手机端资讯排版的样例正文。适当的字距、行距和图片宽度能够提升移动阅读体验。

← 返回新闻
+ +
+
LET'S CONNECT

从这里开始下一步。

高性能工程材料与解决方案

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/industrial/assets/blocks.css b/examples/mobile-showcase/industrial/assets/blocks.css new file mode 100644 index 0000000..9ce1279 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/blocks.css @@ -0,0 +1,29 @@ +/* Portable SiteForge blocks, loaded with every theme (all styles scoped to sf-). */ +.sf-section{background:var(--sf-bg,transparent);color:var(--sf-fg,inherit);padding:var(--sf-pad,82px) 0;margin:0}.sf-section:nth-of-type(even){background:var(--sf-bg,#f4f6f9)}.sf-container{max-width:1200px;margin:auto;padding:0 32px}.sf-section h1,.sf-section h2,.sf-section h3,.sf-section p{color:inherit;line-height:1.3}.sf-section h1{font-size:clamp(38px,5vw,76px);font-weight:790;letter-spacing:-.052em}.sf-section h2{font-size:clamp(27px,3.2vw,44px);font-weight:760;letter-spacing:-.037em}.sf-kicker{display:block;font-size:12px;letter-spacing:.17em;text-transform:uppercase;font-weight:740;color:var(--accent,#3569d3);margin-bottom:18px}.sf-hero-grid,.sf-image-text{display:grid;grid-template-columns:1.08fr .92fr;gap:68px;align-items:center}.sf-hero-copy p{font-size:18px;line-height:1.75;max-width:520px;opacity:.75}.sf-hero-img,.sf-image-side{overflow:hidden;border-radius:9px;min-height:380px;background:linear-gradient(130deg,#d5e1ee,#eef3f9);display:grid;place-items:center}.sf-hero-img img,.sf-image-side img{width:100%;height:100%;max-height:580px;object-fit:cover}.sf-hero-abstract{font-size:110px;color:#a7bdd4}.sf-button{display:inline-flex;align-items:center;justify-content:center;gap:28px;background:var(--accent,#315ee2);color:white!important;padding:16px 26px;border-radius:6px;font-size:14px;text-decoration:none;font-weight:720;margin-top:24px}.sf-section-head{display:flex;align-items:end;justify-content:space-between;margin-bottom:32px;gap:24px}.sf-section-head h2{margin:0}.sf-section-head>a,.sf-link{color:var(--accent,#3569d3);font-weight:700;text-decoration:none}.sf-prose{font-size:16px;line-height:1.85;max-width:930px}.sf-prose p{line-height:1.85}.sf-features,.sf-collection,.sf-stats{display:grid;gap:20px}.sf-features{grid-template-columns:repeat(3,minmax(0,1fr))}.sf-feature{border:1px solid #e0e6eb;padding:32px 28px;border-radius:8px;background:#fff;color:#253247}.sf-feature>span{font-size:12px;font-weight:800;color:var(--accent,#346add)}.sf-feature h3{font-size:22px;margin:30px 0 8px}.sf-feature p{font-size:14px;line-height:1.7;color:#647181}.sf-stats{grid-template-columns:repeat(4,1fr);padding:40px 0;border-top:1px solid #b7c0cd66;border-bottom:1px solid #b7c0cd66}.sf-stats>div{display:flex;flex-direction:column;gap:8px}.sf-stats strong{font-size:clamp(28px,4vw,53px);letter-spacing:-.04em}.sf-stats span{font-size:12px;opacity:.65;letter-spacing:.04em}.sf-collection{grid-template-columns:repeat(var(--sf-cols,3),minmax(0,1fr))}.sf-item{display:block;text-decoration:none;color:#233044;background:#fff;border:1px solid #e8edf1;border-radius:8px;overflow:hidden;transition:transform .2s,box-shadow .2s}.sf-item:hover{transform:translateY(-4px);box-shadow:0 18px 38px #344d7018}.sf-item-img{height:210px;overflow:hidden;background:#e4eaf0}.sf-item-img img{height:100%;width:100%;object-fit:cover}.sf-placeholder{display:grid;place-items:center;width:100%;height:100%;min-height:190px;background:linear-gradient(130deg,#e2eaf2,#c9d7e6);font-size:72px;color:#8399b2;font-weight:800}.sf-large{min-height:360px}.sf-item-copy{padding:25px}.sf-item-copy small{text-transform:uppercase;letter-spacing:.13em;color:var(--accent,#376edc)}.sf-item-copy h3{font-size:22px;margin:12px 0 7px}.sf-item-copy p{font-size:14px;line-height:1.6;color:#7a8796;min-height:42px}.sf-item-copy span{font-size:12px;color:var(--accent,#376edc);font-weight:800}.sf-image-text>div>p{font-size:17px;line-height:1.8;max-width:520px;opacity:.7}.sf-reverse>div:first-child{order:2}.sf-gallery{display:grid;grid-template-columns:repeat(3,1fr);gap:15px}.sf-gallery img{width:100%;height:230px;object-fit:cover;border-radius:6px}.sf-faq{max-width:920px}.sf-faq details{border-bottom:1px solid #dce3eb;padding:22px 0}.sf-faq summary{font-size:17px;cursor:pointer;font-weight:700}.sf-faq p{color:#647181;line-height:1.75}.sf-cta-wrap{display:flex;justify-content:space-between;align-items:center;gap:24px}.sf-cta-wrap h2{margin:0}.sf-cta-wrap p{font-size:16px;opacity:.75}.sf-section a{cursor:pointer}.sf-muted{opacity:.65} +@media(max-width:820px){.sf-container{padding:0 20px}.sf-section{padding:50px 0}.sf-hero-grid,.sf-image-text{grid-template-columns:1fr;gap:26px}.sf-reverse>div:first-child{order:initial}.sf-hero-img,.sf-image-side{min-height:250px}.sf-features,.sf-collection{grid-template-columns:repeat(2,minmax(0,1fr))}.sf-stats{grid-template-columns:repeat(2,1fr)}.sf-cta-wrap{align-items:flex-start;flex-direction:column}} +@media(max-width:540px){.sf-features,.sf-collection,.sf-gallery{grid-template-columns:1fr}.sf-section-head{display:block}.sf-section-head>a{display:block;margin-top:13px}.sf-item-img{height:220px}.sf-hero-grid{gap:22px}.sf-hero-copy p{font-size:16px}.sf-stats{gap:28px}} + +.sf-attributes{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:0 32px;border-top:1px solid #e5eaf0}.sf-attribute{display:flex;justify-content:space-between;align-items:center;gap:18px;border-bottom:1px solid #e5eaf0;padding:19px 10px;font-size:14px}.sf-attribute span{color:#748497}.sf-attribute strong{font-weight:720;text-align:right}@media(max-width:640px){.sf-attributes{grid-template-columns:1fr}} + +/* SiteForge responsive no-code grid container */ +.sf-layout-grid{display:grid;grid-template-columns:var(--sf-layout-cols,1fr 1fr);gap:var(--sf-layout-gap,24px);align-items:stretch} +.sf-layout-column{min-width:0}.sf-layout-column>.sf-section{padding:0;margin:0 0 18px}.sf-layout-column .sf-container{width:100%;padding:0} +.sf-layout-column>.sf-section:last-child{margin-bottom:0} +@media(max-width:820px){.sf-layout-grid{grid-template-columns:repeat(2,minmax(0,1fr))!important}} +@media(max-width:540px){.sf-layout-grid{grid-template-columns:minmax(0,1fr)!important}} + +/* V8.6: accessible, script-free commercial design blocks */ +.sf-slides{display:flex;gap:18px;overflow-x:auto;scroll-snap-type:x mandatory;padding:6px 0 18px;scrollbar-width:thin} +.sf-slide{flex:0 0 min(78%,720px);min-width:220px;margin:0;scroll-snap-align:start} +.sf-slide img{width:100%;aspect-ratio:16/9;object-fit:cover;border-radius:10px} +.sf-slide figcaption{padding:10px 2px;opacity:.7;font-size:14px} +.sf-video{aspect-ratio:16/9;max-width:1000px;background:#ebf0f5;border-radius:10px;overflow:hidden} +.sf-video iframe{width:100%;height:100%;border:0} +.sf-tab{padding:19px 0;border-bottom:1px solid #dde4ec;max-width:960px} +.sf-tab summary{font-size:18px;font-weight:700;cursor:pointer}.sf-tab p{max-width:850px;line-height:1.8} +.sf-prices{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:18px} +.sf-price{padding:28px;background:#fff;border:1px solid #dee5ef;border-radius:10px;color:#29394b} +.sf-price strong{display:block;font-size:27px;margin:14px 0}.sf-price li{margin:11px 0}.sf-price ul{padding-left:19px} +.sf-map-address{font-style:normal;font-size:18px;white-space:pre-line;line-height:1.8} +@media (prefers-reduced-motion:reduce){.sf-slides{scroll-behavior:auto}.sf-item{transition:none}} +@media(max-width:540px){.sf-slide{flex-basis:92%}} diff --git a/examples/mobile-showcase/industrial/assets/commercial.css b/examples/mobile-showcase/industrial/assets/commercial.css new file mode 100644 index 0000000..353bee4 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/commercial.css @@ -0,0 +1,84 @@ +/* SiteForge commercial theme UX layer: accessibility, layout rhythm, media, responsive navigation. */ +:root{--sf-shadow:0 20px 55px rgba(17,33,55,.08);--sf-shadow-hover:0 26px 65px rgba(17,33,55,.15)} +html{scroll-padding-top:104px}body{font-feature-settings:"kern";text-rendering:optimizeLegibility} +a,button,input,select,textarea{-webkit-tap-highlight-color:transparent} +a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:3px solid var(--pro-accent);outline-offset:4px} +.pro-wrap{width:100%;max-width:min(var(--pro-wide),100%)}.pro-header{isolation:isolate;box-shadow:0 1px 0 rgba(15,35,60,.035)}.pro-head-inner{gap:clamp(15px,2vw,29px)}.pro-logo{min-width:0;flex-shrink:0;gap:12px}.pro-brand-logo{max-width:155px;max-height:46px;width:auto;height:auto;object-fit:contain}.pro-logo-name{overflow-wrap:anywhere}.pro-navigation{gap:clamp(11px,1.6vw,24px)}.pro-header-cta{white-space:nowrap} +.pro-mobile-toggle,.pro-catalog-toggle,.pro-nav-disclose{border:0;background:transparent;color:inherit;line-height:1.2} +.pro-mobile-toggle{min-height:44px;min-width:44px;border:1px solid currentColor;border-radius:6px;font-size:19px}.pro-nav-group{position:relative;display:flex;align-items:center;gap:2px} +.pro-nav-disclose{padding:9px;font-size:13px}.pro-nav-children{position:absolute;top:100%;left:0;min-width:215px;max-width:330px;display:grid;gap:2px;padding:13px;box-shadow:var(--sf-shadow);border-radius:10px;z-index:45;background:var(--pro-background);border:1px solid var(--pro-border);color:var(--pro-text)} +.pro-nav-children[hidden],.pro-mega[hidden]{display:none!important}.pro-nav-children a{display:block;font-size:13px;white-space:normal;padding:10px;border-radius:5px}.pro-nav-children a:hover{background:var(--pro-surface)} +.pro-catalog-toggle{padding:11px 3px;white-space:nowrap;font-size:12px;font-weight:700}.pro-mega{position:absolute;top:100%;left:50%;transform:translateX(-50%);width:min(100%,var(--pro-wide));box-shadow:var(--sf-shadow);z-index:41;display:grid;grid-template-columns:215px 1fr;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);border-radius:0 0 15px 15px;padding:29px;align-items:start}.pro-mega>span{font-size:12px;letter-spacing:.06em}.pro-mega>div{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:9px 22px;overflow:visible}.pro-mega>div a{white-space:normal;padding:10px 5px;border-bottom:1px solid var(--pro-border)} +.pro-home-hero{overflow:hidden}.pro-home-hero .pro-home-grid{min-height:660px;gap:5%}.pro-home-hero .pro-hero-copy{position:relative;z-index:2}.pro-home-hero .pro-hero-copy h1{font-size:clamp(46px,5.7vw,92px);line-height:1.06;letter-spacing:-.064em;max-width:15ch}.pro-home-hero .pro-hero-copy h1 em{font-style:normal;display:block}.pro-home-hero .pro-hero-copy p{font-size:clamp(15px,1.3vw,19px);line-height:1.75;max-width:44ch}.pro-home-hero .pro-hero-art{min-width:0;min-height:425px;position:relative;isolation:isolate}.pro-home-hero .pro-hero-art>img{width:100%;height:100%;object-fit:cover;position:absolute;inset:0}.pro-hero-art:has(.pro-abstract-car),.pro-hero-art:has(.pro-technical),.pro-hero-art:has(.pro-corporate-shape){background-position:center;background-size:cover;background-repeat:no-repeat}.pro-abstract-car,.pro-technical,.pro-corporate-shape{position:relative;z-index:1;pointer-events:none} +.pro-hero-actions{display:flex;flex-wrap:wrap;align-items:center;gap:15px}.pro-button,.pro-header-cta,.pro-outline-button{min-height:48px;transition:transform .24s ease,box-shadow .24s ease,opacity .24s ease}.pro-button:hover,.pro-header-cta:hover,.pro-outline-button:hover{transform:translateY(-2px);box-shadow:0 10px 22px rgba(0,0,0,.10)} +.pro-section{padding-top:clamp(76px,7vw,112px)!important;padding-bottom:clamp(76px,7vw,112px)!important}.pro-section-head{gap:16px}.pro-section-head h2{font-size:clamp(32px,3.5vw,53px);max-width:22ch}.pro-section-head .pro-text-link{align-self:end} +.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.pro-card{min-width:0;display:flex;flex-direction:column;transition:transform .28s ease,box-shadow .28s ease;border:1px solid var(--pro-border);background:var(--pro-background);overflow:hidden}.pro-card:hover{transform:translateY(-6px);box-shadow:var(--sf-shadow-hover)}.pro-card-cover{aspect-ratio:1.42;overflow:hidden;background:var(--pro-surface);position:relative}.pro-card-cover .pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .45s ease}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-card-body{display:flex;flex-direction:column;flex:1}.pro-card-body h3{font-size:clamp(19px,1.6vw,24px);line-height:1.26}.pro-card-body p{font-size:14px}.pro-card-link{margin-top:auto;padding-top:14px;font-size:13px;font-weight:700} +.pro-art{min-height:100%;width:100%;position:relative;overflow:hidden;display:grid;place-items:center;isolation:isolate}.pro-art-ring{width:60%;aspect-ratio:1;border:1px solid currentColor;opacity:.13;border-radius:50%;transform:rotate(20deg);box-shadow:0 0 0 23px #ffffff10,0 0 0 57px #ffffff07}.pro-art-center{font-size:clamp(38px,5vw,80px);position:absolute;font-weight:800;letter-spacing:-.065em;opacity:.65}.pro-art-label{position:absolute;bottom:19px;left:22px;font-size:10px;letter-spacing:.22em;opacity:.7} +.pro-breadcrumb{display:flex;gap:11px;flex-wrap:wrap;font-size:12px;align-items:center}.pro-breadcrumb a{text-decoration:underline;text-underline-offset:4px}.pro-product-hero{align-items:start;gap:clamp(28px,5vw,80px)}.pro-product-media{aspect-ratio:1.12;background:var(--pro-surface);overflow:hidden}.pro-product-media>img,.pro-product-media>.pro-art{width:100%;height:100%;object-fit:contain}.pro-product-summary{padding:clamp(12px,3vw,50px) 0}.pro-product-summary h1{font-size:clamp(36px,4.3vw,72px)}.pro-detail-layout{border-top:1px solid var(--pro-border);padding-top:50px}.pro-specs>div{display:grid;grid-template-columns:minmax(100px,40%) 1fr;gap:10px;align-items:baseline;padding:15px 0;border-bottom:1px solid var(--pro-border)}.pro-specs strong{overflow-wrap:anywhere}.pro-gallery-thumbs button{flex-basis:96px;height:76px}.pro-gallery-lightbox{backdrop-filter:blur(6px)} +.pro-filter-panel{display:flex;align-items:end;flex-wrap:wrap;gap:16px;background:var(--pro-surface);border:1px solid var(--pro-border);padding:20px;margin-bottom:25px;border-radius:var(--pro-radius)}.pro-filter-panel label{display:grid;gap:7px;min-width:180px;flex:1}.pro-filter-panel input,.pro-filter-panel select{width:100%;background:var(--pro-background);border:1px solid var(--pro-border);padding:12px 14px;color:var(--pro-text);border-radius:6px}.pro-filter-count{white-space:nowrap;font-size:13px;padding:12px 0}.pro-card[hidden]{display:none!important}.pro-filter-empty{padding:38px;border:1px dashed var(--pro-border);text-align:center;grid-column:1/-1} +.pro-inquiry input,.pro-inquiry textarea{min-height:46px}.pro-inquiry textarea{min-height:150px}.pro-inquiry-wrap{gap:clamp(32px,7vw,110px)}.pro-inquiry .pro-button{border:0;justify-self:start}.pro-footer-links a{padding-block:5px;display:inline-block} +.pro-end-cta{overflow:hidden}.pro-end-cta h2{font-size:clamp(30px,4vw,64px)} +.pro-rich{line-height:1.85}.pro-rich img{border-radius:var(--pro-radius);margin-block:24px}.pro-rich table{width:100%;display:block;overflow:auto;border-collapse:collapse}.pro-rich td,.pro-rich th{border:1px solid var(--pro-border);padding:10px 14px}.pro-rich a{text-decoration:underline;text-underline-offset:3px} +@media(min-width:1025px){.pro-navigation>.pro-nav-group:hover .pro-nav-children:not([hidden]){visibility:visible}} +@media(max-width:1150px){.pro-head-inner{gap:15px}.pro-navigation{gap:12px}.pro-logo-name{font-size:15px}.pro-header-cta{padding:13px 16px}} +@media(max-width:1024px){.pro-head-inner{min-height:72px;flex-wrap:wrap}.pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto}.pro-navigation{display:none;width:100%;flex-basis:100%;flex-direction:column;align-items:stretch;gap:0;order:5;margin:0;padding:8px 0 20px;border-top:1px solid var(--pro-border)}.pro-navigation.is-open{display:flex}.pro-navigation>a,.pro-nav-group>a{padding:14px 8px;font-size:15px}.pro-nav-group{display:flex;flex-wrap:wrap;justify-content:space-between}.pro-nav-children{position:static;flex-basis:100%;max-width:none;width:100%;box-shadow:none;border-radius:0;border-left:2px solid var(--pro-accent);margin:0 0 12px 8px}.pro-nav-disclose{min-width:44px;min-height:44px}.pro-catalog-toggle{margin-left:auto}.pro-mega{top:100%;display:block;padding:20px}.pro-mega>div{grid-template-columns:repeat(2,minmax(0,1fr));margin-top:12px}.pro-home-hero .pro-home-grid{min-height:560px}.pro-home-hero .pro-hero-art{min-height:325px}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}} +@media(max-width:700px){.pro-wrap{padding-left:20px;padding-right:20px}.pro-utility{display:none}.pro-head-inner{min-height:66px}.pro-logo-name{max-width:140px;font-size:14px}.pro-brand-logo{max-width:125px}.pro-header-cta{display:none}.pro-catalog-toggle{font-size:11px;padding-inline:7px;margin-left:0}.pro-home-hero .pro-home-grid{display:flex;flex-direction:column;gap:36px;padding-top:48px;padding-bottom:48px}.pro-home-hero .pro-hero-copy h1{font-size:clamp(43px,10vw,68px)}.pro-home-hero .pro-hero-copy p{font-size:15px}.pro-home-hero .pro-hero-art{width:100%;min-height:290px}.pro-home-hero .pro-hero-bottom{display:none}.pro-section{padding-top:68px!important;padding-bottom:68px!important}.pro-section-head{align-items:flex-start}.pro-grid{grid-template-columns:1fr;gap:18px}.pro-card-cover{aspect-ratio:1.45}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-inquiry-wrap{display:grid;grid-template-columns:1fr;gap:30px}.pro-product-summary{padding:0}.pro-specs>div{grid-template-columns:1fr 1fr}.pro-mega{top:100%;max-height:65vh;overflow-y:auto}.pro-mega>div{grid-template-columns:1fr}.pro-filter-panel{display:grid;grid-template-columns:1fr;gap:12px}.pro-filter-panel label{min-width:0}.pro-footer-top{display:grid;grid-template-columns:1fr;gap:27px}.pro-footer-bottom{gap:12px;flex-wrap:wrap}} +@media(max-width:410px){.pro-logo-name{max-width:115px}.pro-logo-symbol{font-size:28px}.pro-catalog-toggle{font-size:10px}.pro-mobile-toggle{min-width:42px}} +@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*:before,*:after{animation-duration:.01ms!important;transition-duration:.01ms!important;scroll-behavior:auto!important}} + +/* Accessible static catalogue pagination for large inventories. */ +.pro-pages-nav{display:flex;gap:1rem;justify-content:center;align-items:center;margin:2rem 0;flex-wrap:wrap} +.pro-pages-nav a{padding:.7rem 1.1rem;border:1px solid currentColor;border-radius:.4rem;text-decoration:none} +.pro-pages-nav a:focus-visible{outline:3px solid var(--accent,#2563eb);outline-offset:3px} +.pro-pages-nav span{font-size:.875rem} + +/* P6 international sites: small, keyboard-operable language switch. */ +.sf-language-switch{display:inline-flex;gap:6px;align-items:center;flex-wrap:wrap;margin:8px 12px;padding:4px;border:1px solid rgba(120,130,145,.22);border-radius:10px;background:rgba(255,255,255,.08)} +.sf-language-switch a{font:inherit;font-size:12px;line-height:1.5;padding:4px 7px;border-radius:6px;color:inherit;text-decoration:none} +.sf-language-switch a[aria-current="page"]{font-weight:700;text-decoration:underline;text-underline-offset:3px} +.sf-language-switch a:focus-visible{outline:2px solid #2563eb;outline-offset:3px} +@media(max-width:640px){.sf-language-switch{margin:6px 0;width:auto}} + +/* V8.21.3 — Four-theme unified mobile off-canvas navigation & optional tab bar. + Desktop remains unchanged. Phone / tablet use one accessible drawer. */ +.sf-mobile-tabs{display:none!important} +.sf-drawer-header,.sf-mobile-drawer-backdrop,.sf-drawer-extra{display:none} +@media(max-width:1024px){ + .pro-head-inner{flex-wrap:nowrap!important;gap:12px!important} + .pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto!important;flex:0 0 44px;min-width:44px;min-height:44px;position:relative;z-index:3} + .pro-catalog-toggle{display:none!important} + .pro-navigation,.pro-navigation.is-open{display:flex!important;position:fixed!important;inset:0 0 0 auto!important;width:min(88vw,360px)!important;height:100dvh!important;height:100vh;max-height:100dvh!important;flex:unset!important;flex-direction:column!important;align-items:stretch!important;order:unset!important;margin:0!important;padding:0 0 calc(20px + env(safe-area-inset-bottom,0px))!important;overflow-x:hidden;overflow-y:auto!important;background:var(--pro-background,#fff)!important;color:var(--pro-text,#19283c)!important;border:0!important;border-left:1px solid var(--pro-border,#ddd)!important;box-shadow:-15px 0 45px #0002!important;z-index:1201!important;transform:translateX(105%);visibility:hidden;pointer-events:none;transition:transform .24s ease,visibility .24s ease!important;overscroll-behavior:contain} + .pro-navigation.is-open{transform:translateX(0);visibility:visible;pointer-events:auto} + .sf-drawer-header{display:flex!important;align-items:center;justify-content:space-between;gap:12px;padding:20px 18px;border-bottom:1px solid var(--pro-border,#dde3e9);font-size:17px;font-weight:750;position:sticky;top:0;background:var(--pro-background,#fff);z-index:2} + .sf-drawer-close{min-width:44px;min-height:44px;border:1px solid var(--pro-border,#dde3e9);color:inherit;background:transparent;border-radius:10px;font-size:24px;cursor:pointer} + .sf-mobile-drawer-backdrop{display:block;position:fixed;inset:0;z-index:1200;background:#0b1b31a3;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .24s ease,visibility .24s ease} + .sf-mobile-drawer-backdrop.is-open{opacity:1;visibility:visible;pointer-events:auto} + body.sf-drawer-open{overflow:hidden!important} + .pro-navigation>a,.pro-navigation .pro-nav-group>a,.pro-navigation .sf-drawer-extra>a{display:flex;align-items:center;min-height:50px;padding:13px 20px!important;font-size:15px!important;color:inherit!important;white-space:normal;border-bottom:1px solid var(--pro-border,#dde3e9)!important;text-decoration:none!important} + .pro-navigation .pro-nav-group{display:flex;position:relative;flex-wrap:wrap!important;width:100%;gap:0;align-items:center;justify-content:space-between} + .pro-navigation .pro-nav-group>a{flex:1;min-width:0} + .pro-navigation .pro-nav-disclose{margin-right:12px;min-width:44px;min-height:44px;border-radius:9px;background:var(--pro-surface,#f4f6f8)} + .pro-navigation .pro-nav-children{position:static!important;width:100%!important;max-width:100%!important;box-shadow:none!important;border-left:3px solid var(--pro-accent,#e77730);border-radius:0!important;margin:0 0 8px 14px!important;flex-basis:calc(100% - 14px)!important;background:var(--pro-surface,#f6f8fa)} + .pro-navigation .pro-nav-children a{padding:12px 16px!important;font-size:14px!important;color:inherit!important;min-height:44px} + .sf-drawer-extra{display:block;padding:12px 0 5px}.sf-drawer-extra strong{display:block;font-size:12px;letter-spacing:.06em;padding:12px 20px;opacity:.65}.sf-drawer-extra a{font-size:14px!important} + .sf-drawer-close:focus-visible,.pro-mobile-toggle:focus-visible,.pro-nav-disclose:focus-visible,.sf-mobile-tab:focus-visible{outline:3px solid var(--pro-accent,#ff8200);outline-offset:2px} +} +@media(max-width:767px){ + .pro-header-cta{display:none!important} + .pro-head-inner .pro-logo{min-width:0;max-width:calc(100% - 65px)} + .pro-logo-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .pro-home-hero .pro-home-grid{min-height:0!important} + .pro-home-hero .pro-hero-art{min-height:230px} + .pro-card,.pro-card-cover,.pro-product-media{max-width:100%;min-width:0} + .pro-rich img,.pro-content img,.sf-canvas img{max-width:100%;height:auto} + .pro-rich table{max-width:100%;overflow:auto} + .pro-grid,.pro-footer-top{min-width:0} + .sf-mobile-tabs{display:grid!important;position:fixed;z-index:1100;bottom:0;left:0;right:0;grid-template-columns:repeat(var(--sf-mobile-tab-count,4),minmax(0,1fr));align-items:stretch;padding:5px 6px calc(5px + env(safe-area-inset-bottom,0px));min-height:63px;background:var(--pro-background,#fff);color:var(--pro-text,#263446);border-top:1px solid var(--pro-border,#dfe4eb);box-shadow:0 -6px 24px #13223914} + .sf-mobile-tab{appearance:none;border:0!important;background:transparent!important;color:inherit!important;text-decoration:none!important;padding:6px 2px;min-height:50px;min-width:0;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:2px;border-radius:9px;cursor:pointer;font-family:inherit} + .sf-tab-icon{font-size:23px;line-height:1.15;font-weight:500} + .sf-tab-label{font-size:11px;font-weight:600;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .sf-mobile-tab[aria-current=page]{color:var(--pro-accent,#e47730)!important;background:var(--pro-surface,#f5f6f8)!important} + body:has(> .sf-mobile-tabs){padding-bottom:calc(76px + env(safe-area-inset-bottom,0px))!important} +} +@media(min-width:768px){.sf-mobile-tabs{display:none!important}} +@media(prefers-reduced-motion:reduce){.pro-navigation,.sf-mobile-drawer-backdrop{transition:none!important}} diff --git a/examples/mobile-showcase/industrial/assets/custom.css b/examples/mobile-showcase/industrial/assets/custom.css new file mode 100644 index 0000000..e18a2d4 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/custom.css @@ -0,0 +1 @@ +body .pro-utility[hidden]{display:none!important}@media(max-width:1023px){.sf-canvas .sf-section{padding-block:64px}}@media(max-width:767px){.sf-canvas .sf-section{padding-block:40px}.pro-wrap,.sf-container{padding-left:20px;padding-right:20px}body .pro-utility{display:none!important}} \ No newline at end of file diff --git a/examples/mobile-showcase/industrial/assets/factory.css b/examples/mobile-showcase/industrial/assets/factory.css new file mode 100644 index 0000000..154ffb3 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/factory.css @@ -0,0 +1,27 @@ +/* SiteForge trusted global shell. Site themes remain visually independent. */ +:root{--sf-shell:#12243d;--sf-shell-accent:#dcae71;--sf-shell-soft:#edf2f8;--sf-shell-fg:#173049} +html{scroll-behavior:smooth}body{overflow-x:hidden}body>.header,body>.utility,body>.top,body>header,body>footer{display:none!important} +.sf-theme-industrial{--sf-shell:#114e79;--sf-shell-accent:#92d5ed;--sf-shell-soft:#ebf6fa;--sf-shell-fg:#0c4267} +.sf-theme-corporate{--sf-shell:#232d62;--sf-shell-accent:#b8bdff;--sf-shell-soft:#f3f3fa;--sf-shell-fg:#333468} +.sf-theme-minimal{--sf-shell:#1e1e1c;--sf-shell-accent:#ded6c5;--sf-shell-soft:#f6f4ef;--sf-shell-fg:#252520} +.sf-site-head{position:relative;z-index:25;background:var(--sf-shell);color:#fff;font-family:system-ui,-apple-system,sans-serif} +.sf-head-inner{max-width:1240px;margin:0 auto;min-height:78px;padding:0 28px;display:flex;align-items:center;gap:28px} +.sf-logo{display:flex;align-items:center;gap:11px;font-size:18px;text-decoration:none!important;color:#fff!important;white-space:nowrap} +.sf-logo-mark{width:36px;height:36px;display:grid;place-items:center;background:var(--sf-shell-accent);color:var(--sf-shell);font-size:22px;font-weight:900;border-radius:9px} +.sf-primary-links{display:flex;gap:23px;margin-left:auto;align-items:center} +.sf-primary-links a,.sf-mega a{color:#fff!important;text-decoration:none!important;font-size:13px;font-weight:650;white-space:nowrap} +.sf-primary-links a:hover{color:var(--sf-shell-accent)!important} +.sf-head-cta{font-size:13px;font-weight:750;text-decoration:none;background:var(--sf-shell-accent);color:var(--sf-shell)!important;padding:13px 18px;border-radius:4px;white-space:nowrap} +.sf-menu-toggle{display:none;margin-left:auto;color:white;border:1px solid #ffffff55;background:none;border-radius:4px;padding:8px 12px;font-size:19px;cursor:pointer} +.sf-mega{display:flex;gap:18px;max-width:1240px;margin:auto;padding:0 28px 9px;overflow-x:auto} +.sf-mega a{display:block;min-width:120px;border-top:1px solid #ffffff2e;padding:12px 8px}.sf-mega small{display:block;color:#ffffff99;max-width:160px;overflow:hidden;text-overflow:ellipsis;font-size:10px;margin-top:6px} +.sf-site-foot{background:var(--sf-shell);color:white!important;font:14px/1.7 system-ui,-apple-system,sans-serif;padding:72px 28px 26px} +.sf-foot-grid{max-width:1200px;margin:auto;display:grid;grid-template-columns:2fr 1fr 1fr;gap:70px}.sf-foot-grid h2{font-size:25px;color:white;margin:0 0 17px}.sf-foot-grid h4{font-size:13px;color:var(--sf-shell-accent);letter-spacing:.07em;margin:0 0 17px}.sf-foot-grid p{color:#ffffffae;max-width:380px}.sf-foot-grid a{display:block;width:fit-content;color:#fff!important;text-decoration:none;margin-bottom:8px}.sf-foot-lower{border-top:1px solid #ffffff33;max-width:1200px;margin:45px auto 0;padding-top:20px;display:flex;justify-content:space-between;color:#ffffff9e;font-size:12px} +.sf-filters{display:flex;align-items:center;flex-wrap:wrap;gap:12px;margin:0 0 30px}.sf-filters input,.sf-filters select{padding:11px 13px;border-radius:6px;border:1px solid #cfd9e4;background:#fff;color:#263a51;max-width:280px}.sf-filter-empty{padding:22px;color:#778598} +.sf-search-page{min-height:76vh;max-width:1060px;padding:90px 24px;margin:auto;font-family:system-ui,sans-serif;color:var(--sf-shell-fg)}.sf-search-page h1{font-size:clamp(35px,5vw,62px);margin:20px 0}.sf-search-page>label{display:block;margin:18px 0 8px}.sf-search-page input{display:block;width:100%;padding:17px;font-size:18px;border:1px solid #b7c6d7;border-radius:8px}.sf-search-page #sf-search-count{margin:22px 0;color:#607589}.sf-search-result{padding:22px 0;border-bottom:1px solid #dae1ea}.sf-search-result a{color:var(--sf-shell-fg);font-size:21px;font-weight:750;text-decoration:none}.sf-search-result small{display:block;color:#7992a7}.sf-search-result p{margin:7px 0;color:#657487} +@media(max-width:1050px){.sf-head-inner{gap:13px}.sf-primary-links{gap:12px}.sf-primary-links a{font-size:12px}.sf-head-cta{padding:10px}} +@media(max-width:850px){.sf-head-inner{min-height:68px}.sf-menu-toggle{display:block}.sf-head-cta{display:none}.sf-primary-links{display:none;position:absolute;top:68px;left:0;right:0;margin:0;background:var(--sf-shell);padding:20px 28px;flex-direction:column;align-items:stretch;box-shadow:0 20px 24px #0002}.sf-primary-links.is-open{display:flex}.sf-mega{display:none}.sf-foot-grid{grid-template-columns:1fr 1fr;gap:35px}} +@media(max-width:560px){.sf-foot-grid{grid-template-columns:1fr}.sf-foot-lower{display:block}.sf-site-foot{padding-top:48px}.sf-head-inner{padding:0 16px}} + +.sf-page-intro{padding:80px 28px;background:var(--sf-shell-soft);color:var(--sf-shell-fg);font-family:system-ui,sans-serif}.sf-page-intro>div{max-width:1200px;margin:auto}.sf-page-intro p{font-size:11px;font-weight:850;letter-spacing:.19em;text-transform:uppercase;color:var(--sf-shell-fg);opacity:.58}.sf-page-intro h1{font-size:clamp(38px,5vw,67px);letter-spacing:-.04em;line-height:1.08;margin:13px 0}.sf-page-intro span{font-size:16px;opacity:.72} +.sf-item[hidden]{display:none!important} diff --git a/examples/mobile-showcase/industrial/assets/pro-base.css b/examples/mobile-showcase/industrial/assets/pro-base.css new file mode 100644 index 0000000..c2c4f61 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/pro-base.css @@ -0,0 +1,21 @@ +/* SiteForge V3 professional theme primitives. Each commercial theme adds its own art direction. */ +:root{--pro-text:#19283a;--pro-muted:#687587;--pro-border:#dfe5ea;--pro-background:#fff;--pro-surface:#f5f7fa;--pro-accent:#365cb7;--pro-hero:#15263d;--pro-hero-fg:#fff;--pro-radius:12px;--pro-headings:system-ui,-apple-system,sans-serif;--pro-font:system-ui,-apple-system,sans-serif;--pro-wide:1270px} +*,*:before,*:after{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--pro-background);color:var(--pro-text);font-family:var(--pro-font);-webkit-font-smoothing:antialiased;overflow-x:hidden}button,input,select{font:inherit}button,a{touch-action:manipulation}button{cursor:pointer}a{text-decoration:none;color:inherit}a:hover{color:var(--pro-accent)}img{max-width:100%;display:block}h1,h2,h3,h4,p{margin-top:0}h1,h2,h3{font-family:var(--pro-headings);line-height:1.09}h1{letter-spacing:-.052em}h2{letter-spacing:-.042em}h3{letter-spacing:-.028em}p{line-height:1.72}.pro-wrap{max-width:var(--pro-wide);margin:0 auto;padding-left:32px;padding-right:32px}.pro-skip{position:absolute;left:-9999px;z-index:90;background:#fff;color:#000;padding:12px}.pro-skip:focus{left:10px;top:10px}.pro-eyebrow{font-weight:750;font-size:11px;letter-spacing:.17em;text-transform:uppercase;display:block;line-height:1.6;color:var(--pro-accent)}.pro-muted{opacity:.7}.pro-utility{min-height:30px;background:var(--pro-hero);color:#c5d2db;font-size:10px;letter-spacing:.16em}.pro-utility .pro-wrap{display:flex;justify-content:space-between;padding-block:8px}.pro-utility i{font-style:normal;color:var(--pro-accent)}.pro-header{background:var(--pro-background);color:var(--pro-text);border-bottom:1px solid var(--pro-border);position:relative;z-index:35}.pro-head-inner{min-height:84px;display:flex;align-items:center;gap:28px}.pro-logo{display:flex;align-items:center;gap:12px;min-width:170px}.pro-logo-symbol{font-size:32px;line-height:1;font-weight:800;letter-spacing:-.07em;color:var(--pro-accent)}.pro-logo-name{max-width:220px;font-weight:820;font-size:17px;line-height:1.1;letter-spacing:-.035em}.pro-logo-name small{display:block;font-weight:650;font-size:9px;letter-spacing:.19em;margin-top:7px;color:var(--pro-muted)}.pro-navigation{display:flex;align-items:center;gap:24px;margin-left:auto}.pro-navigation a{font-size:13px;font-weight:650;white-space:nowrap;transition:opacity .2s}.pro-navigation a:hover{opacity:.6}.pro-header-cta,.pro-button{display:inline-flex;align-items:center;justify-content:center;gap:22px;background:var(--pro-accent);color:#fff!important;border-radius:var(--pro-radius);font-size:13px;letter-spacing:.01em;font-weight:750;padding:16px 24px;white-space:nowrap;transition:transform .2s,background .2s}.pro-header-cta:hover,.pro-button:hover{transform:translateY(-2px)}.pro-mobile-toggle{display:none}.pro-mega{display:flex;align-items:center;gap:22px;min-height:37px;border-top:1px solid var(--pro-border);padding-block:10px;font-size:11px}.pro-mega>span{font-weight:750;color:var(--pro-muted);white-space:nowrap}.pro-mega>div{display:flex;gap:16px;overflow:auto;scrollbar-width:none}.pro-mega a{white-space:nowrap;font-weight:650}.pro-search-link{font-size:19px!important}.pro-home-hero{position:relative;overflow:hidden}.pro-home-grid{display:grid;grid-template-columns:1.02fr .98fr;align-items:center;gap:5%;min-height:580px;padding-top:85px;padding-bottom:85px}.pro-hero-copy{position:relative;z-index:2}.pro-hero-copy h1{font-size:clamp(48px,6.2vw,91px);line-height:1.03;margin:20px 0 25px;max-width:730px}.pro-hero-copy h1 em{font-style:normal;display:block;color:var(--pro-accent)}.pro-hero-copy p{font-size:17px;max-width:495px;color:var(--pro-muted)}.pro-hero-actions{display:flex;align-items:center;flex-wrap:wrap;gap:25px;margin-top:34px}.pro-outline-button{font-weight:700;border-bottom:1px solid currentColor;padding:12px 0}.pro-hero-art{width:100%;height:435px;position:relative;overflow:hidden;border-radius:var(--pro-radius)}.pro-hero-art>img{width:100%;height:100%;object-fit:cover}.pro-hero-bottom{display:flex;justify-content:space-between;font-size:10px;letter-spacing:.18em;padding-block:22px;border-top:1px solid #ffffff32}.pro-section{padding:106px 0}.pro-section-head{display:flex;align-items:end;justify-content:space-between;gap:25px;margin-bottom:34px}.pro-section-head h2{font-size:clamp(36px,4vw,57px);margin:12px 0 0}.pro-text-link{font-size:13px;font-weight:750;display:inline-flex;gap:18px;align-items:center;border-bottom:1px solid;padding-bottom:7px;color:var(--pro-accent)}.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:22px}.pro-card{display:block;min-width:0;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);overflow:hidden;border-radius:var(--pro-radius);transition:transform .25s,box-shadow .25s}.pro-card:hover{transform:translateY(-6px);box-shadow:0 24px 45px #0f25431b}.pro-card-cover{width:100%;height:244px;overflow:hidden;background:var(--pro-surface)}.pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .5s}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-art{width:100%;height:100%;overflow:hidden;display:grid;place-items:center;position:relative;background:linear-gradient(130deg,#d8e1ed,#f3f6f9)}.pro-art-ring{width:55%;aspect-ratio:1;border:28px solid #ffffff5f;border-radius:50%;box-shadow:0 0 0 42px #ffffff30;transform:rotate(-25deg)}.pro-art-center{position:absolute;font-family:var(--pro-headings);font-weight:800;font-size:76px;letter-spacing:-.08em;color:#45647d90}.pro-art-label{position:absolute;bottom:16px;left:18px;letter-spacing:.16em;font-size:9px;color:#435773}.pro-card-body{padding:25px 25px 28px}.pro-card-meta{display:flex;justify-content:space-between;gap:20px;font-size:10px;font-weight:750;letter-spacing:.1em;text-transform:uppercase;color:var(--pro-accent)}.pro-card h3{font-size:23px;margin:14px 0 9px}.pro-card p{font-size:13px;color:var(--pro-muted);margin-bottom:24px;min-height:44px}.pro-card-link{font-size:12px;font-weight:800;display:flex;justify-content:space-between;color:var(--pro-text);padding-top:14px;border-top:1px solid var(--pro-border)}.pro-empty{grid-column:1/-1;padding:45px;border:1px dashed var(--pro-border);background:var(--pro-surface);color:var(--pro-muted)}.pro-statement{background:var(--pro-surface)}.pro-statement-layout{display:grid;grid-template-columns:1fr 2fr;gap:60px}.pro-statement h2{font-size:clamp(36px,4.5vw,63px);max-width:760px}.pro-statement p{max-width:520px;color:var(--pro-muted)}.pro-brand-pills{display:flex;flex-wrap:wrap;gap:12px}.pro-brand-pills a{padding:18px 28px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);font-weight:750}.pro-brand-pills a:hover{border-color:var(--pro-accent)}.pro-inner-hero{background:var(--pro-surface);padding:92px 0 65px;position:relative;overflow:hidden}.pro-inner-hero h1{max-width:870px;font-size:clamp(43px,6vw,85px);margin:18px 0}.pro-inner-hero p{max-width:650px;color:var(--pro-muted);font-size:17px}.pro-breadcrumb{font-size:12px;color:var(--pro-muted);margin-top:25px;display:flex;gap:12px;align-items:center;flex-wrap:wrap}.pro-breadcrumb strong{color:var(--pro-text)}.pro-list-section{padding:65px 0 110px}.pro-filter-panel{display:grid;grid-template-columns:minmax(220px,2fr) 1fr 1fr auto;align-items:end;gap:14px;margin-bottom:35px}.pro-filter-panel label>span{display:block;font-size:11px;margin-bottom:8px;color:var(--pro-muted);font-weight:750}.pro-filter-panel input,.pro-filter-panel select{display:block;width:100%;padding:14px 15px;border-radius:var(--pro-radius);border:1px solid var(--pro-border);background:var(--pro-background);color:var(--pro-text);outline-offset:2px}.pro-filter-count{font-size:12px;padding-bottom:17px;color:var(--pro-muted)}.pro-filter-scope .pro-card[hidden]{display:none}.pro-product-layout{padding-top:38px}.pro-product-layout .pro-breadcrumb{margin-bottom:38px}.pro-product-hero{display:grid;grid-template-columns:1.18fr .82fr;gap:6%;align-items:center}.pro-product-media{height:460px;overflow:hidden;background:var(--pro-surface);border-radius:var(--pro-radius)}.pro-product-media .pro-photo{height:100%}.pro-product-summary h1{font-size:clamp(45px,5vw,72px);margin:16px 0}.pro-product-summary p{font-size:16px;color:var(--pro-muted)}.pro-product-brand{font-weight:700;color:var(--pro-text)!important}.pro-detail-layout{border-top:1px solid var(--pro-border);display:grid;grid-template-columns:1fr 1fr;gap:8%;margin-top:80px;padding-top:55px}.pro-detail-layout h2{font-size:32px;margin-top:13px}.pro-specs{margin-top:25px}.pro-specs>div{display:grid;grid-template-columns:1fr 1fr;gap:22px;padding:16px 0;border-bottom:1px solid var(--pro-border)}.pro-specs span{color:var(--pro-muted)}.pro-rich{line-height:1.85;font-size:16px;overflow-wrap:anywhere}.pro-rich img{border-radius:var(--pro-radius);margin:25px 0}.pro-rich a{text-decoration:underline}.pro-rich h2{margin-top:30px}.pro-lead{font-size:20px;color:var(--pro-muted)}.pro-brand-hero-grid{display:grid;grid-template-columns:1.1fr .9fr;gap:7%;align-items:center}.pro-brand-media{height:300px;overflow:hidden;border-radius:var(--pro-radius)}.pro-article-hero{text-align:center;padding:110px 0 75px;background:var(--pro-surface)}.pro-article-width{max-width:900px}.pro-article-hero h1{font-size:clamp(40px,5vw,75px);margin:15px 0 25px}.pro-article-hero p{color:var(--pro-muted);font-size:18px}.pro-article-hero time{font-size:12px;color:var(--pro-muted)}.pro-article-content{max-width:930px;padding-top:70px;padding-bottom:90px}.pro-article-cover{width:100%;max-height:530px;object-fit:cover;margin-bottom:40px;border-radius:var(--pro-radius)}.pro-article-content>.pro-text-link{margin-top:35px}.pro-case-detail{max-width:1020px}.pro-case-detail>img{width:100%;max-height:620px;object-fit:cover}.pro-case-meta{display:flex;gap:35px;margin:35px 0;color:var(--pro-muted);font-size:13px}.pro-case-meta strong{display:block;color:var(--pro-text);font-size:18px;margin-top:7px}.pro-info-grid{display:grid;grid-template-columns:.8fr 1.2fr;gap:12%}.pro-info-grid h2{font-size:clamp(31px,4.5vw,54px);margin-top:15px}.pro-contact-email{font-size:20px;color:var(--pro-accent);font-weight:750;word-break:break-word}.pro-info-photo{max-height:450px;object-fit:cover;margin-top:35px;border-radius:var(--pro-radius)}.pro-custom-content .sf-section{background:transparent}.pro-custom-content .sf-section:nth-of-type(even){background:var(--pro-surface)}.pro-end-cta{padding:76px 0;background:var(--pro-hero);color:#fff}.pro-end-cta .pro-wrap{display:flex;align-items:center;justify-content:space-between;gap:40px}.pro-end-cta h2{font-size:clamp(32px,4vw,53px);margin:13px 0}.pro-end-cta p{color:#c5c9d1}.pro-end-cta a{background:var(--pro-accent);color:#fff;font-weight:800;padding:19px 30px;border-radius:var(--pro-radius);white-space:nowrap}.pro-404{text-align:center;padding-block:125px}.pro-404>span{font-size:12px;letter-spacing:.3em}.pro-404 h1{font-size:clamp(150px,20vw,320px);margin:10px 0;letter-spacing:-.08em}.pro-404 p{font-size:18px;color:var(--pro-muted)}.pro-404 a{margin-top:22px}.pro-footer{background:#15212d;color:#fff;padding:75px 0 22px}.pro-footer-top{display:grid;grid-template-columns:1.45fr 1fr 1fr;gap:55px}.pro-footer h2{font-size:32px;margin:12px 0}.pro-footer p{max-width:350px;font-size:13px;color:#afbbc8}.pro-footer .pro-eyebrow{color:#b6c3d2}.pro-footer-links ul{margin:0;padding:0;list-style:none;display:grid;grid-template-columns:1fr 1fr;gap:15px}.pro-footer-links a{font-size:13px;color:#d6e0e8}.pro-footer-bottom{border-top:1px solid #ffffff29;margin-top:60px;padding-top:20px;font-size:10px;letter-spacing:.12em;color:#adb9c3;display:flex;justify-content:space-between}.pro-anchor{display:block;height:0}.pro-category-tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}.pro-category-tiles a{padding:35px 28px;min-height:155px;background:var(--pro-surface);display:flex;flex-direction:column;justify-content:space-between}.pro-category-tiles span{font-size:11px;color:var(--pro-muted)}.pro-category-tiles strong{font-size:24px}.pro-category-tiles b{align-self:end}.sf-site-head .sf-head-inner,.sf-site-head .sf-primary-links{display:none} +@media(max-width:1100px){.pro-head-inner{gap:17px}.pro-navigation{gap:14px}.pro-navigation a{font-size:12px}.pro-home-grid{min-height:500px}.pro-hero-copy h1{font-size:60px}.pro-hero-art{height:350px}} +@media(max-width:860px){.pro-wrap{padding-left:22px;padding-right:22px}.pro-utility{display:none}.pro-head-inner{min-height:70px;flex-wrap:wrap;gap:12px}.pro-mobile-toggle{display:block;margin-left:auto;border:1px solid var(--pro-border);padding:8px 12px;background:transparent;color:var(--pro-text);border-radius:5px}.pro-navigation{display:none;order:10;width:100%;flex-direction:column;align-items:stretch;gap:0;padding-bottom:12px}.pro-navigation.is-open{display:flex}.pro-navigation a{padding:11px 2px;border-bottom:1px solid var(--pro-border)}.pro-header-cta{display:none}.pro-mega{display:none}.pro-home-grid{grid-template-columns:1fr;gap:35px;padding-top:60px;padding-bottom:60px}.pro-hero-art{height:350px}.pro-hero-copy h1{font-size:clamp(45px,9vw,73px)}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-brand-hero-grid{grid-template-columns:1fr;gap:35px}.pro-product-media{height:380px}.pro-filter-panel{grid-template-columns:1fr 1fr}.pro-filter-panel label:first-child{grid-column:1/-1}.pro-end-cta .pro-wrap{align-items:start;flex-direction:column}.pro-section{padding:72px 0}.pro-footer-top{grid-template-columns:1fr 1fr}.pro-footer-top>div:first-child{grid-column:1/-1}.pro-category-tiles{grid-template-columns:repeat(2,1fr)}} +@media(max-width:560px){.pro-wrap{padding-left:18px;padding-right:18px}.pro-logo-name{font-size:15px}.pro-hero-copy h1{font-size:43px}.pro-hero-art{height:255px}.pro-hero-bottom{display:none}.pro-home-grid{min-height:0}.pro-grid{grid-template-columns:1fr}.pro-section-head{align-items:start;flex-direction:column}.pro-section-head h2{font-size:37px}.pro-card-cover{height:230px}.pro-filter-panel{grid-template-columns:1fr}.pro-filter-panel label:first-child{grid-column:auto}.pro-filter-count{padding-bottom:4px}.pro-statement-layout,.pro-footer-top{grid-template-columns:1fr;gap:25px}.pro-footer-top>div:first-child{grid-column:auto}.pro-footer-bottom{flex-direction:column;gap:8px}.pro-inner-hero{padding:60px 0}.pro-product-media{height:270px}.pro-product-summary h1{font-size:43px}.pro-category-tiles{grid-template-columns:1fr}.pro-end-cta h2{font-size:38px}.pro-minimal-meta{display:block!important}} + +/* V2 compatibility stylesheet hides direct headers/footers; full themes restore their own. */ +body>header.sf-site-head.pro-header,body>footer.sf-site-foot.pro-footer{display:block!important} + +/* Accessible desktop mega-navigation and mobile disclosure */ +.pro-catalog-toggle{font-size:12px;font-weight:750;border:1px solid var(--pro-border);background:transparent;color:inherit;border-radius:var(--pro-radius);padding:10px 14px;white-space:nowrap} +.pro-mega[hidden]{display:none!important}.pro-mega.is-open{display:flex}.pro-mega>div{padding-block:3px} +@media(max-width:1060px){.pro-catalog-toggle{display:none}} +@media(max-width:860px){.pro-mega.is-open{display:block!important}.pro-mega.is-open>div{display:flex;flex-wrap:wrap;gap:14px;padding:12px 0}.pro-mega>span{white-space:normal}} + +/* V4: responsive nested navigation, gallery and opt-in inquiry integration */ +.pro-nav-group{position:relative;display:flex;align-items:center;gap:3px}.pro-nav-disclose{border:0;background:none;color:inherit;font-size:12px;padding:8px}.pro-nav-children[hidden]{display:none!important}.pro-nav-children{position:absolute;left:0;top:100%;z-index:45;min-width:230px;max-width:360px;padding:10px;background:var(--pro-background);border:1px solid var(--pro-border);box-shadow:0 18px 35px #0002;border-radius:var(--pro-radius);display:flex;flex-direction:column}.pro-nav-children a{padding:10px 12px;white-space:nowrap}.pro-nav-children .pro-nav-leaf{padding-left:28px;color:var(--pro-muted)} +.pro-product-gallery{min-width:0}.pro-gallery-thumbs{display:flex;gap:8px;margin-top:12px;overflow:auto;scrollbar-width:thin;padding-bottom:5px}.pro-gallery-thumbs button{flex:0 0 86px;height:67px;border:2px solid transparent;padding:3px;border-radius:8px;background:var(--pro-surface)}.pro-gallery-thumbs button:focus-visible,.pro-gallery-thumbs button[aria-pressed=true]{border-color:var(--pro-accent)}.pro-gallery-thumbs img{width:100%;height:100%;object-fit:cover;border-radius:4px}.pro-gallery-lightbox{position:fixed;inset:0;background:rgba(10,16,30,.92);z-index:1000;display:grid;place-items:center;padding:6vw}.pro-gallery-lightbox[hidden]{display:none}.pro-gallery-lightbox img{max-width:92vw;max-height:80vh;object-fit:contain}.pro-gallery-lightbox button{position:absolute;right:25px;top:25px;border:1px solid #fff8;background:#222;color:#fff;padding:10px 15px;border-radius:5px} +.pro-inquiry-wrap{display:grid;grid-template-columns:1fr 1fr;gap:70px}.pro-inquiry{display:grid;gap:17px}.pro-inquiry label{display:grid;gap:7px;font-weight:650}.pro-inquiry input,.pro-inquiry textarea{padding:13px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);background:var(--pro-background);color:var(--pro-text);width:100%}.pro-inquiry textarea{min-height:140px}.pro-inquiry .pro-honeypot{position:absolute;left:-10000px;width:1px;height:1px}.pro-inquiry p{font-size:12px;color:var(--pro-muted)} +@media(max-width:860px){.pro-nav-group{display:block}.pro-nav-children{position:static;max-width:none;width:100%;box-shadow:none;border:0;border-left:2px solid var(--pro-accent);padding-left:8px}.pro-nav-group>a{display:inline-block}.pro-inquiry-wrap{grid-template-columns:1fr;gap:20px}} diff --git a/examples/mobile-showcase/industrial/assets/pro.css b/examples/mobile-showcase/industrial/assets/pro.css new file mode 100644 index 0000000..a3b4f8f --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/pro.css @@ -0,0 +1,7 @@ +:root{--pro-text:#173a57;--pro-muted:#6b8191;--pro-border:#d8e3eb;--pro-background:#fff;--pro-surface:#edf3f7;--pro-accent:#16629a;--pro-hero:#0e3959;--pro-radius:2px;--pro-headings:Arial,sans-serif;--pro-wide:1290px} +.pro-header{background:#fff}.pro-logo-symbol{color:#14649b;font-size:38px}.pro-utility{background:#0d3a5a;color:#c6e2f1}.pro-header-cta{border-radius:2px;background:#0c5b94}.pro-industrial-hero{background:linear-gradient(90deg,#eff4f8 0%,#e6eef5 60%,#d7e5f0 100%);color:#123b59}.pro-industrial-hero .pro-hero-copy{padding-right:6%}.pro-industrial-hero .pro-hero-copy h1{font-size:clamp(45px,5.3vw,80px)}.pro-industrial-hero .pro-hero-copy h1 em{color:#186fa4}.pro-industrial-hero .pro-hero-art{border-radius:0;background:#0c466d}.pro-technical{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;gap:3%;overflow:hidden;background:repeating-linear-gradient(0deg,transparent,transparent 39px,#ffffff0b 40px),repeating-linear-gradient(90deg,transparent,transparent 39px,#ffffff0b 40px)}.pro-technical>div{width:21%;height:55%;border-radius:60px;border:27px solid #6ba6d4;transform:skewY(-13deg) rotate(-5deg);box-shadow:18px 17px 0 #14324a,0 0 0 9px #bde2fb inset,12px 22px 50px #081c30}.pro-technical>div:nth-child(2){height:72%;width:27%;border-width:34px}.pro-technical strong{position:absolute;bottom:24px;left:28px;color:#aed1e8;font-size:13px;letter-spacing:.17em}.pro-outline-button{color:#0f5988}.pro-category-band{background:#fff}.pro-category-tiles a{background:#eaf2f7;border-top:4px solid #2176aa;min-height:185px;transition:background .2s}.pro-category-tiles a:hover{background:#dce9f2}.pro-category-tiles strong{font-size:21px}.pro-featured{background:#edf3f7}.pro-card{background:#fff;border-radius:2px}.pro-card-cover{background:#d8e6ef}.pro-art-industrial,.pro-art-product{background:linear-gradient(135deg,#aecadf,#e1f1fb)}.pro-art-center{color:#45789b99}.pro-statement{background:#103e5e;color:#fff}.pro-statement .pro-eyebrow{color:#8dc8eb}.pro-statement p{color:#d3e1e9}.pro-statement .pro-text-link{color:#9cdaff}.pro-inner-hero{background:linear-gradient(115deg,#edf4f9 0%,#d9e9f4 100%)}.pro-inner-hero:after{content:'+';position:absolute;right:11%;top:6%;font-size:350px;font-weight:100;color:#15699b10;line-height:1}.pro-article-hero{background:#dceaf4}.pro-article-hero p{color:#537088}.pro-footer{background:#092c45}.pro-end-cta{background:#0a4772}.pro-end-cta a{background:#fff;color:#144b75!important}.pro-404 h1{color:#156d9d} + +/* SiteForge V5 commercial signature */ +.pro-industrial-hero .pro-hero-art{background-image:url("./visual/hero.svg")!important;background-position:center;background-size:cover;} + +.pro-industrial-hero .pro-hero-art{border-radius:0;box-shadow:25px 25px 0 #ffffff9c}.pro-industrial-hero .pro-hero-art .pro-technical{opacity:0}.pro-category-tiles a{transition:transform .2s,background .2s}.pro-category-tiles a:hover{transform:translateY(-4px);background:#ddeef9}.pro-card{border-radius:0;border:1px solid #cddfe9}.pro-card-cover{background:linear-gradient(145deg,#dceaf0,#c3d9e7)}.pro-art{background:repeating-linear-gradient(0deg,#e2edf4,#e2edf4 24px,#d6e7ef 25px);color:#20577e}.pro-featured{background:#f4f8fb}.pro-statement{background:#103b57;color:#fff}.pro-statement p{color:#d4e5ed}.pro-statement .pro-text-link{color:#a8d8ee}.pro-footer{background:#0e3046;color:#eff5f9} diff --git a/examples/mobile-showcase/industrial/assets/pro.js b/examples/mobile-showcase/industrial/assets/pro.js new file mode 100644 index 0000000..9cf100d --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/pro.js @@ -0,0 +1,72 @@ +'use strict';(()=>{ + const menu=document.querySelector('[data-pro-menu]'); const nav=document.querySelector('#pro-navigation'); + if(menu&&nav){menu.addEventListener('click',()=>{const open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));nav.classList.toggle('is-open',open);menu.setAttribute('aria-label',open?'关闭导航':'打开导航');});} + // Drawer navigation. The same markup is used across the four professional themes. + const mobileNav=document.querySelector('#pro-navigation'); + let drawerBackdrop=null,drawerClose=null,returnFocus=null; + if(menu&&mobileNav){ + const originalParent=mobileNav.parentNode,originalNext=mobileNav.nextSibling; + const heading=document.createElement('div');heading.className='sf-drawer-header'; + const title=document.createElement('strong');title.textContent='网站导航'; + drawerClose=document.createElement('button');drawerClose.type='button';drawerClose.className='sf-drawer-close';drawerClose.textContent='×';drawerClose.setAttribute('aria-label','关闭网站导航'); + heading.append(title,drawerClose);mobileNav.prepend(heading); + drawerBackdrop=document.createElement('div');drawerBackdrop.className='sf-mobile-drawer-backdrop';drawerBackdrop.hidden=false;document.body.append(drawerBackdrop); + function setDrawer(open,focusBack=true){ + const isMobile=window.matchMedia('(max-width:1024px)').matches; + open=Boolean(open&&isMobile); + if(open){returnFocus=document.activeElement;document.body.append(mobileNav);} + else if(mobileNav.parentNode!==originalParent){if(originalNext&&originalNext.parentNode===originalParent)originalParent.insertBefore(mobileNav,originalNext);else originalParent.append(mobileNav);} + mobileNav.classList.toggle('is-open',open);drawerBackdrop.classList.toggle('is-open',open); + document.body.classList.toggle('sf-drawer-open',open); + menu.setAttribute('aria-expanded',String(open));menu.setAttribute('aria-label',open?'关闭导航':'打开导航'); + mobileNav.setAttribute('aria-hidden',String(!open&&isMobile)); + if('inert' in mobileNav)mobileNav.inert=!open&&isMobile; + if(open)drawerClose.focus(); + else if(focusBack&&returnFocus instanceof HTMLElement){returnFocus.focus();returnFocus=null;} + } + // Replace the old inline-expansion listener: use capture to stop the old listener. + menu.addEventListener('click',e=>{if(!window.matchMedia('(max-width:1024px)').matches)return;e.stopImmediatePropagation();setDrawer(!mobileNav.classList.contains('is-open'));},true); + drawerClose.addEventListener('click',()=>setDrawer(false)); + drawerBackdrop.addEventListener('click',()=>setDrawer(false)); + document.querySelectorAll('[data-mobile-open-menu]').forEach(b=>b.addEventListener('click',()=>setDrawer(true))); + mobileNav.addEventListener('click',e=>{if(e.target.closest('a'))setDrawer(false,false)}); + document.addEventListener('keydown',e=>{ + if(e.key==='Escape'&&mobileNav.classList.contains('is-open')){e.preventDefault();setDrawer(false);} + if(e.key!=='Tab'||!mobileNav.classList.contains('is-open'))return; + const els=[...mobileNav.querySelectorAll('button:not([disabled]),a[href]')].filter(el=>el.getClientRects().length&&!el.closest('[hidden]')); + if(!els.length)return;const first=els[0],last=els[els.length-1]; + if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();} + else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();} + }); + window.matchMedia('(max-width:1024px)').addEventListener('change',()=>setDrawer(false,false)); + if('inert' in mobileNav&&window.matchMedia('(max-width:1024px)').matches)mobileNav.inert=true; + // Do not strand catalogue links when the old mobile mega-button is hidden. + const megaLinks=document.querySelectorAll('[data-pro-mega] a'); + if(megaLinks.length){const wrap=document.createElement('div');wrap.className='sf-drawer-extra';const h=document.createElement('strong');h.textContent='更多分类与系列';wrap.append(h); + [...megaLinks].slice(0,20).forEach(a=>{const clone=a.cloneNode(true);wrap.append(clone);});mobileNav.append(wrap);} + } + const tabbar=document.querySelector('[data-mobile-tabs]'); + if(tabbar){tabbar.style.setProperty('--sf-mobile-tab-count',String(tabbar.children.length));} + const megaButton=document.querySelector('[data-pro-catalog]'), mega=document.querySelector('[data-pro-mega]'); + if(megaButton&&mega){function setMega(open){mega.hidden=!open;mega.classList.toggle('is-open',open);megaButton.setAttribute('aria-expanded',String(open));} + megaButton.addEventListener('click',()=>setMega(mega.hidden)); + document.addEventListener('keydown',e=>{if(e.key==='Escape')setMega(false);}); + document.addEventListener('click',e=>{if(!mega.hidden&&!mega.contains(e.target)&&!megaButton.contains(e.target))setMega(false);}); + } + document.querySelectorAll('.pro-nav-disclose').forEach(button=>{button.addEventListener('click',()=>{let panel=button.parentElement.querySelector('.pro-nav-children');let visible=button.getAttribute('aria-expanded')==='true';button.setAttribute('aria-expanded',String(!visible));panel.hidden=visible;});}); + document.querySelectorAll('.pro-gallery-thumbs').forEach(container=>{const main=container.parentElement.querySelector('.pro-product-media img');const buttons=[...container.querySelectorAll('[data-gallery-image]')]; + buttons.forEach(b=>{b.addEventListener('click',()=>{buttons.forEach(x=>x.setAttribute('aria-pressed',String(x===b)));if(main){main.src=b.dataset.galleryImage;main.alt=b.querySelector('img')?.alt||'';}});}); + if(!main)return;main.tabIndex=0;main.style.cursor='zoom-in';const open=()=>{const pane=document.createElement('div');pane.className='pro-gallery-lightbox';pane.setAttribute('role','dialog');pane.setAttribute('aria-label','产品大图预览');let img=document.createElement('img');img.src=main.src;img.alt=main.alt;const close=document.createElement('button');close.type='button';close.textContent='关闭 ×';pane.append(img,close);document.body.append(pane);const done=()=>{pane.remove();document.removeEventListener('keydown',esc);main.focus();};const esc=e=>{if(e.key==='Escape')done();};document.addEventListener('keydown',esc);close.addEventListener('click',done);pane.addEventListener('click',e=>{if(e.target===pane)done();});close.focus();};main.addEventListener('click',open);main.addEventListener('keydown',e=>{if(e.key==='Enter')open();}); + }); + document.querySelectorAll('.pro-filter-scope').forEach(scope=>{ + const panel=scope.previousElementSibling;if(!panel||!panel.classList.contains('pro-filter-panel'))return; + const cards=Array.from(scope.querySelectorAll('.pro-card')); + const blank=document.createElement('div');blank.className='pro-filter-empty';blank.hidden=true;blank.textContent='没有找到符合条件的内容，请调整关键词或筛选条件。';scope.append(blank); + const q=panel.querySelector('[data-pro-filter-search]'),b=panel.querySelector('[data-pro-filter-brand]'),c=panel.querySelector('[data-pro-filter-category]'),count=panel.querySelector('[data-pro-filter-count]'); + function options(sel,key){const vals=[...new Set(cards.map(x=>x.dataset[key]||'').filter(Boolean))].sort();vals.forEach(x=>sel.add(new Option(x,x)));if(!vals.length)sel.closest('label').hidden=true;} + options(b,'brand');options(c,'category'); + function run(){const str=q.value.trim().toLocaleLowerCase();let visible=0; + cards.forEach(el=>{const hit=el.textContent.toLocaleLowerCase().includes(str)&&(!b.value||el.dataset.brand===b.value)&&(!c.value||el.dataset.category===c.value);el.hidden=!hit;visible+=Number(hit);});count.textContent=`共 ${visible} 条`;blank.hidden=visible!==0;} + [q,b,c].forEach(x=>x.addEventListener(x===q?'input':'change',run));run(); + }); +})(); diff --git a/examples/mobile-showcase/industrial/assets/search-index.json b/examples/mobile-showcase/industrial/assets/search-index.json new file mode 100644 index 0000000..0637a08 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/search-index.json @@ -0,0 +1 @@ +[] \ No newline at end of file diff --git a/examples/mobile-showcase/industrial/assets/site-runtime.js b/examples/mobile-showcase/industrial/assets/site-runtime.js new file mode 100644 index 0000000..e4715e8 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/site-runtime.js @@ -0,0 +1,31 @@ +'use strict'; +(()=>{ + const $=s=>document.querySelector(s), $$=s=>[...document.querySelectorAll(s)]; + const menu=$('.sf-menu-toggle');if(menu){menu.addEventListener('click',()=>{let open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));$('#sf-primary-links')?.classList.toggle('is-open',open);});} + // Filter actual static content cards, no API is needed at runtime. + $$('.sf-collection').forEach(grid=>{ + const cards=$$('.sf-item',grid); + if(cards.length<2)return; + const toolbar=document.createElement('div');toolbar.className='sf-filters'; + const search=document.createElement('input');search.type='search';search.placeholder='筛选当前列表';search.setAttribute('aria-label','筛选当前列表'); + const status=document.createElement('span');status.setAttribute('aria-live','polite');status.style.fontSize='12px'; + const brand=document.createElement('select');brand.setAttribute('aria-label','按品牌筛选'); + const category=document.createElement('select');category.setAttribute('aria-label','按分类筛选'); + function fill(el,field,all){el.append(new Option(all,''));const vals=[...new Set(cards.map(x=>x.dataset[field]||'').filter(Boolean))].sort();vals.forEach(v=>el.append(new Option(v,v)));if(!vals.length)el.hidden=true;} + fill(brand,'brand','全部品牌');fill(category,'category','全部分类'); + toolbar.append(search,brand,category,status);grid.parentNode.insertBefore(toolbar,grid); + function apply(){let val=search.value.trim().toLocaleLowerCase();let visible=0;cards.forEach(card=>{let hit=card.textContent.toLocaleLowerCase().includes(val)&&(!brand.value||card.dataset.brand===brand.value)&&(!category.value||card.dataset.category===category.value);card.hidden=!hit;if(hit)visible++;});status.textContent=`共 ${visible} 项`;} + search.addEventListener('input',apply);brand.addEventListener('change',apply);category.addEventListener('change',apply);apply(); + }); + const input=$('#sf-search'),root=$('#sf-search-results'),count=$('#sf-search-count'); + if(input&&root){ + let data=[];const params=new URLSearchParams(location.search);input.value=params.get('q')||''; + let debounce=null; + const render=()=>{let q=input.value.trim().toLocaleLowerCase();let found=q?data.filter(d=>`${d.title} ${d.summary} ${d.brand} ${d.type}`.toLocaleLowerCase().includes(q)).slice(0,100):data.slice(0,30); + root.replaceChildren();count.textContent=`${found.length} 条结果${!q?'（显示前30条）':''}`; + found.forEach(d=>{let article=document.createElement('article'),a=document.createElement('a'),small=document.createElement('small'),p=document.createElement('p');article.className='sf-search-result';a.textContent=d.title;a.href=d.url.replace(/^\//,'');small.textContent=d.type;p.textContent=d.summary;article.append(a,small,p);root.append(article);}); + };const base=document.querySelector('base')?.href||location.href; + fetch(new URL('search-index.json',base)).then(r=>{if(!r.ok)throw Error('index unavailable');return r.json();}).then(v=>{data=v;render()}).catch(()=>{count.textContent='搜索索引加载失败，请检查站点文件部署路径';}); + input.addEventListener('input',()=>{clearTimeout(debounce);debounce=setTimeout(render,100)}); + } +})(); diff --git a/examples/mobile-showcase/industrial/assets/theme.css b/examples/mobile-showcase/industrial/assets/theme.css new file mode 100644 index 0000000..7bd34c1 --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/theme.css @@ -0,0 +1 @@ +:root{--blue:#0a3d5c;--sky:#daeaf2;--orange:#ef8f35;--text:#1d3441}*{box-sizing:border-box}body{margin:0;color:var(--text);background:#f8fafb;font-family:Inter,"Segoe UI",Arial,sans-serif;line-height:1.6}a{color:inherit;text-decoration:none}img{max-width:100%;object-fit:contain}.wrap{width:min(1300px,90%);margin:auto}.top{background:#153d56;color:#a7c5d5;font-size:10px;letter-spacing:2px}.top .wrap{display:flex;justify-content:space-between;padding:9px 0}header{background:white;border-bottom:1px solid #e0e8ea}.header-inner{min-height:94px;display:flex;justify-content:space-between;align-items:center;gap:20px}.brand{display:flex;align-items:center;gap:12px;font-size:21px;font-weight:800;letter-spacing:-.5px;line-height:1}.brand-icon{display:grid;place-items:center;width:43px;height:43px;background:var(--blue);color:white;font-size:26px}.brand small{display:block;font-size:10px;color:#718793;letter-spacing:2px;margin-top:9px;font-weight:500}nav{display:flex;gap:25px;font-size:13px;font-weight:650;flex-wrap:wrap}nav a:hover{color:#eb8725}.request{background:#e88c36;color:white;padding:15px 20px;font-size:11px;font-weight:800;white-space:nowrap;letter-spacing:.5px}.hero{background:linear-gradient(107deg,#073653 0%,#0e5270 51%,#14748c 100%);color:white;overflow:hidden}.hero-grid{display:grid;grid-template-columns:55% 45%;min-height:530px}.hero-text{padding:76px 25px 60px 0;position:relative;z-index:1}.kicker{font-size:11px;letter-spacing:2px;font-weight:750;color:#ce882e}.hero .kicker{color:#f5ac57}.kicker i{display:inline-block;width:22px;height:2px;background:#f5ac57;vertical-align:middle;margin-right:10px}.hero h1{font-size:clamp(48px,6vw,86px);letter-spacing:-3px;line-height:1.02;max-width:700px;margin:35px 0 26px}.hero p{max-width:470px;color:#c6e1e9;font-size:17px}.button{display:inline-flex;gap:55px;align-items:center;background:#ef9136;padding:18px 22px;font-size:12px;letter-spacing:1px;font-weight:800;margin-top:26px}.button b{font-size:18px}.hero-tags{display:flex;gap:22px;margin-top:60px;font-size:10px;color:#85bfcb;letter-spacing:1px}.hero-art{position:relative;display:grid;place-items:center;overflow:hidden;background:radial-gradient(circle at center,#2c94a6 2%,#11617b 45%,transparent 70%)}.hero-art:before,.hero-art:after{content:"";position:absolute;width:540px;height:540px;border:1px solid #ffffff25;transform:rotate(45deg)}.hero-art:after{width:380px;height:380px}.hero-art img{position:relative;z-index:3;width:100%;max-height:480px;filter:drop-shadow(0 20px 20px #002a3b55)}.hero-art>span{position:relative;z-index:3;color:#c6eaf0;font-size:25px;letter-spacing:8px;text-align:center;font-weight:300}.ring{position:absolute;width:430px;height:430px;border:28px solid #ffffff13;border-radius:50%;transform:rotateX(55deg) rotate(45deg)}.ring-2{width:290px;height:290px;border-color:#ffffff1d}.ring-3{width:150px;height:150px;border-color:#fba74b55}.subhero{padding:80px 0;background:linear-gradient(110deg,#073e5d,#0d6981);color:white}.subhero h1{font-size:clamp(40px,5.3vw,68px);line-height:1.1;margin:20px 0}.subhero p{color:#b8d6df}.main{padding:58px 0 100px}.metrics{display:grid;grid-template-columns:repeat(3,1fr);background:white;margin-top:-90px;position:relative;box-shadow:0 15px 45px #0b4f7515}.metrics>div{padding:25px 34px;display:flex;align-items:center;gap:18px;border-right:1px solid #eef3f5}.metrics strong{color:#dc7e2d;font-size:30px}.metrics span{letter-spacing:1px;font-size:11px;font-weight:800}.titlebar{margin:65px 0 28px;display:flex;justify-content:space-between;align-items:end}.titlebar h2{font-size:37px;margin:12px 0 0}.titlebar>a{color:#ba6d2f;font-size:12px;font-weight:800}.product-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:23px}.product{border:1px solid #e0e8ed;background:white}.product:hover{box-shadow:0 15px 35px #194b6518}.product-img{height:225px;display:flex;align-items:center;justify-content:center;background:linear-gradient(125deg,#e8f0f4,#cadce6);overflow:hidden}.product-img img{height:100%;width:100%;object-fit:contain}.technical-graphic{width:110px;height:110px;border:18px solid #96b8c8;border-radius:50%;position:relative;box-shadow:0 20px 0 #244d6120}.technical-graphic span{position:absolute;color:#e9fbff}.technical-graphic span:first-child{top:-56px;left:-50px}.technical-graphic span:nth-child(2){top:-56px;right:-50px}.technical-graphic span:nth-child(3){bottom:-55px;left:-45px}.technical-graphic span:nth-child(4){bottom:-55px;right:-45px}.product-info{padding:25px}.product-info>span{font-size:9px;color:#c17a38;letter-spacing:1.5px;font-weight:700}.product-info h3{font-size:21px;margin:8px 0}.product-info p{color:#6d8792;font-size:13px}.arrow{border-top:1px solid #e6eef1;margin-top:25px;padding-top:18px;display:flex;justify-content:space-between;font-size:11px;letter-spacing:1px;font-weight:800;color:#0c6788}.rich-content{margin:30px 0}.rich-content p{color:#617787}.section{padding:40px 0}.feature-grid,.stats{display:grid;grid-template-columns:repeat(3,1fr);gap:20px}.feature{background:white;padding:25px;border-top:4px solid #f09c52}.stat strong{display:block;font-size:40px}.stat span{color:#78909c}.cta{padding:50px;background:#0e5675;color:white}.detail-image img{max-height:560px}footer{background:#0f334a;color:white;padding:65px 0 25px}.footer-cols{display:flex;justify-content:space-between;gap:40px}.footer-cols h2{font-size:26px}.footer-cols p{color:#96b1bf}.bottom{border-top:1px solid #36596d;margin-top:65px;padding-top:22px;display:flex;justify-content:space-between;letter-spacing:1px;font-size:10px;color:#9cb9c7}@media(max-width:940px){.header-inner{flex-wrap:wrap;padding:16px 0}nav{order:3;width:100%}.request{display:none}.hero-grid{grid-template-columns:1fr}.hero-text{padding-right:0}.hero-art{min-height:300px}.metrics{margin-top:0}}@media(max-width:660px){.product-grid,.metrics,.feature-grid,.stats{grid-template-columns:1fr}.hero h1{font-size:51px}.hero-tags{flex-wrap:wrap}.footer-cols,.bottom{flex-direction:column}.top span:last-child{display:none}.subhero{padding:60px 0}} diff --git a/examples/mobile-showcase/industrial/assets/visual/hero.svg b/examples/mobile-showcase/industrial/assets/visual/hero.svg new file mode 100644 index 0000000..5c363ca --- /dev/null +++ b/examples/mobile-showcase/industrial/assets/visual/hero.svg @@ -0,0 +1 @@ +MATERIAL SYSTEMS diff --git a/examples/mobile-showcase/industrial/index.html b/examples/mobile-showcase/industrial/index.html new file mode 100644 index 0000000..d2a92ca --- /dev/null +++ b/examples/mobile-showcase/industrial/index.html @@ -0,0 +1,24 @@ +建筑材料跳转至正文 + + +
联系我们 ↗
+
ENGINEERED FOR WHAT'S NEXT / 001

建筑材料 BUILT TO PERFORM.

高性能工程材料与解决方案

查看产品系列 ↗获取方案
FORM / FUNCTION
+
PRODUCT SYSTEMS

从类别开始探索

浏览全部 ↗
01精选产品↗
+
PRODUCT PORTFOLIO

核心产品

浏览全部 ↗
+ +
+
标准INDUSTRIAL
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+
APPLICATIONS & SUPPORT

专注可靠交付，服务多元项目。

高性能工程材料与解决方案

服务与解决方案 ↗
+ +
+
LET'S CONNECT

从这里开始下一步。

高性能工程材料与解决方案

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/industrial/listing.html b/examples/mobile-showcase/industrial/listing.html new file mode 100644 index 0000000..a91fefa --- /dev/null +++ b/examples/mobile-showcase/industrial/listing.html @@ -0,0 +1,22 @@ +全部产品跳转至正文 + + +
联系我们 ↗
+
DISCOVER / COLLECTION

全部产品

分类查看产品与解决方案

首页／全部产品
+
+ +
+
标准CATALOG
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+ +
+
LET'S CONNECT

从这里开始下一步。

高性能工程材料与解决方案

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/industrial/product.html b/examples/mobile-showcase/industrial/product.html new file mode 100644 index 0000000..1cc203f --- /dev/null +++ b/examples/mobile-showcase/industrial/product.html @@ -0,0 +1,17 @@ +标准系列产品跳转至正文 + + +
联系我们 ↗
+
首页／产品中心／标准系列产品
+
+
标准PRODUCT
+
PRODUCT DETAILS / EXAMPLE

标准系列产品

面向全球客户的精选示范产品

品牌 · EXAMPLE

咨询该产品 ↗
+
OVERVIEW

产品介绍

规格、优势与适用场景的示例描述。

SPECIFICATIONS

规格参数

Capacity可定制
Material高品质
+ +
+
LET'S CONNECT

从这里开始下一步。

高性能工程材料与解决方案

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/article.html b/examples/mobile-showcase/minimal/article.html new file mode 100644 index 0000000..c5a1cdb --- /dev/null +++ b/examples/mobile-showcase/minimal/article.html @@ -0,0 +1,13 @@ +企业动态与行业资讯跳转至正文 + + +
联系我们 ↗
+
LATEST NEWS / INSIGHTS

企业动态与行业资讯

了解最新项目与服务进展

项目背景

这是一段用于检查手机端资讯排版的样例正文。适当的字距、行距和图片宽度能够提升移动阅读体验。

← 返回新闻
+ +
+
LET'S CONNECT

从这里开始下一步。

简单而精致的产品体验

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/assets/blocks.css b/examples/mobile-showcase/minimal/assets/blocks.css new file mode 100644 index 0000000..9ce1279 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/blocks.css @@ -0,0 +1,29 @@ +/* Portable SiteForge blocks, loaded with every theme (all styles scoped to sf-). */ +.sf-section{background:var(--sf-bg,transparent);color:var(--sf-fg,inherit);padding:var(--sf-pad,82px) 0;margin:0}.sf-section:nth-of-type(even){background:var(--sf-bg,#f4f6f9)}.sf-container{max-width:1200px;margin:auto;padding:0 32px}.sf-section h1,.sf-section h2,.sf-section h3,.sf-section p{color:inherit;line-height:1.3}.sf-section h1{font-size:clamp(38px,5vw,76px);font-weight:790;letter-spacing:-.052em}.sf-section h2{font-size:clamp(27px,3.2vw,44px);font-weight:760;letter-spacing:-.037em}.sf-kicker{display:block;font-size:12px;letter-spacing:.17em;text-transform:uppercase;font-weight:740;color:var(--accent,#3569d3);margin-bottom:18px}.sf-hero-grid,.sf-image-text{display:grid;grid-template-columns:1.08fr .92fr;gap:68px;align-items:center}.sf-hero-copy p{font-size:18px;line-height:1.75;max-width:520px;opacity:.75}.sf-hero-img,.sf-image-side{overflow:hidden;border-radius:9px;min-height:380px;background:linear-gradient(130deg,#d5e1ee,#eef3f9);display:grid;place-items:center}.sf-hero-img img,.sf-image-side img{width:100%;height:100%;max-height:580px;object-fit:cover}.sf-hero-abstract{font-size:110px;color:#a7bdd4}.sf-button{display:inline-flex;align-items:center;justify-content:center;gap:28px;background:var(--accent,#315ee2);color:white!important;padding:16px 26px;border-radius:6px;font-size:14px;text-decoration:none;font-weight:720;margin-top:24px}.sf-section-head{display:flex;align-items:end;justify-content:space-between;margin-bottom:32px;gap:24px}.sf-section-head h2{margin:0}.sf-section-head>a,.sf-link{color:var(--accent,#3569d3);font-weight:700;text-decoration:none}.sf-prose{font-size:16px;line-height:1.85;max-width:930px}.sf-prose p{line-height:1.85}.sf-features,.sf-collection,.sf-stats{display:grid;gap:20px}.sf-features{grid-template-columns:repeat(3,minmax(0,1fr))}.sf-feature{border:1px solid #e0e6eb;padding:32px 28px;border-radius:8px;background:#fff;color:#253247}.sf-feature>span{font-size:12px;font-weight:800;color:var(--accent,#346add)}.sf-feature h3{font-size:22px;margin:30px 0 8px}.sf-feature p{font-size:14px;line-height:1.7;color:#647181}.sf-stats{grid-template-columns:repeat(4,1fr);padding:40px 0;border-top:1px solid #b7c0cd66;border-bottom:1px solid #b7c0cd66}.sf-stats>div{display:flex;flex-direction:column;gap:8px}.sf-stats strong{font-size:clamp(28px,4vw,53px);letter-spacing:-.04em}.sf-stats span{font-size:12px;opacity:.65;letter-spacing:.04em}.sf-collection{grid-template-columns:repeat(var(--sf-cols,3),minmax(0,1fr))}.sf-item{display:block;text-decoration:none;color:#233044;background:#fff;border:1px solid #e8edf1;border-radius:8px;overflow:hidden;transition:transform .2s,box-shadow .2s}.sf-item:hover{transform:translateY(-4px);box-shadow:0 18px 38px #344d7018}.sf-item-img{height:210px;overflow:hidden;background:#e4eaf0}.sf-item-img img{height:100%;width:100%;object-fit:cover}.sf-placeholder{display:grid;place-items:center;width:100%;height:100%;min-height:190px;background:linear-gradient(130deg,#e2eaf2,#c9d7e6);font-size:72px;color:#8399b2;font-weight:800}.sf-large{min-height:360px}.sf-item-copy{padding:25px}.sf-item-copy small{text-transform:uppercase;letter-spacing:.13em;color:var(--accent,#376edc)}.sf-item-copy h3{font-size:22px;margin:12px 0 7px}.sf-item-copy p{font-size:14px;line-height:1.6;color:#7a8796;min-height:42px}.sf-item-copy span{font-size:12px;color:var(--accent,#376edc);font-weight:800}.sf-image-text>div>p{font-size:17px;line-height:1.8;max-width:520px;opacity:.7}.sf-reverse>div:first-child{order:2}.sf-gallery{display:grid;grid-template-columns:repeat(3,1fr);gap:15px}.sf-gallery img{width:100%;height:230px;object-fit:cover;border-radius:6px}.sf-faq{max-width:920px}.sf-faq details{border-bottom:1px solid #dce3eb;padding:22px 0}.sf-faq summary{font-size:17px;cursor:pointer;font-weight:700}.sf-faq p{color:#647181;line-height:1.75}.sf-cta-wrap{display:flex;justify-content:space-between;align-items:center;gap:24px}.sf-cta-wrap h2{margin:0}.sf-cta-wrap p{font-size:16px;opacity:.75}.sf-section a{cursor:pointer}.sf-muted{opacity:.65} +@media(max-width:820px){.sf-container{padding:0 20px}.sf-section{padding:50px 0}.sf-hero-grid,.sf-image-text{grid-template-columns:1fr;gap:26px}.sf-reverse>div:first-child{order:initial}.sf-hero-img,.sf-image-side{min-height:250px}.sf-features,.sf-collection{grid-template-columns:repeat(2,minmax(0,1fr))}.sf-stats{grid-template-columns:repeat(2,1fr)}.sf-cta-wrap{align-items:flex-start;flex-direction:column}} +@media(max-width:540px){.sf-features,.sf-collection,.sf-gallery{grid-template-columns:1fr}.sf-section-head{display:block}.sf-section-head>a{display:block;margin-top:13px}.sf-item-img{height:220px}.sf-hero-grid{gap:22px}.sf-hero-copy p{font-size:16px}.sf-stats{gap:28px}} + +.sf-attributes{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:0 32px;border-top:1px solid #e5eaf0}.sf-attribute{display:flex;justify-content:space-between;align-items:center;gap:18px;border-bottom:1px solid #e5eaf0;padding:19px 10px;font-size:14px}.sf-attribute span{color:#748497}.sf-attribute strong{font-weight:720;text-align:right}@media(max-width:640px){.sf-attributes{grid-template-columns:1fr}} + +/* SiteForge responsive no-code grid container */ +.sf-layout-grid{display:grid;grid-template-columns:var(--sf-layout-cols,1fr 1fr);gap:var(--sf-layout-gap,24px);align-items:stretch} +.sf-layout-column{min-width:0}.sf-layout-column>.sf-section{padding:0;margin:0 0 18px}.sf-layout-column .sf-container{width:100%;padding:0} +.sf-layout-column>.sf-section:last-child{margin-bottom:0} +@media(max-width:820px){.sf-layout-grid{grid-template-columns:repeat(2,minmax(0,1fr))!important}} +@media(max-width:540px){.sf-layout-grid{grid-template-columns:minmax(0,1fr)!important}} + +/* V8.6: accessible, script-free commercial design blocks */ +.sf-slides{display:flex;gap:18px;overflow-x:auto;scroll-snap-type:x mandatory;padding:6px 0 18px;scrollbar-width:thin} +.sf-slide{flex:0 0 min(78%,720px);min-width:220px;margin:0;scroll-snap-align:start} +.sf-slide img{width:100%;aspect-ratio:16/9;object-fit:cover;border-radius:10px} +.sf-slide figcaption{padding:10px 2px;opacity:.7;font-size:14px} +.sf-video{aspect-ratio:16/9;max-width:1000px;background:#ebf0f5;border-radius:10px;overflow:hidden} +.sf-video iframe{width:100%;height:100%;border:0} +.sf-tab{padding:19px 0;border-bottom:1px solid #dde4ec;max-width:960px} +.sf-tab summary{font-size:18px;font-weight:700;cursor:pointer}.sf-tab p{max-width:850px;line-height:1.8} +.sf-prices{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:18px} +.sf-price{padding:28px;background:#fff;border:1px solid #dee5ef;border-radius:10px;color:#29394b} +.sf-price strong{display:block;font-size:27px;margin:14px 0}.sf-price li{margin:11px 0}.sf-price ul{padding-left:19px} +.sf-map-address{font-style:normal;font-size:18px;white-space:pre-line;line-height:1.8} +@media (prefers-reduced-motion:reduce){.sf-slides{scroll-behavior:auto}.sf-item{transition:none}} +@media(max-width:540px){.sf-slide{flex-basis:92%}} diff --git a/examples/mobile-showcase/minimal/assets/commercial.css b/examples/mobile-showcase/minimal/assets/commercial.css new file mode 100644 index 0000000..353bee4 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/commercial.css @@ -0,0 +1,84 @@ +/* SiteForge commercial theme UX layer: accessibility, layout rhythm, media, responsive navigation. */ +:root{--sf-shadow:0 20px 55px rgba(17,33,55,.08);--sf-shadow-hover:0 26px 65px rgba(17,33,55,.15)} +html{scroll-padding-top:104px}body{font-feature-settings:"kern";text-rendering:optimizeLegibility} +a,button,input,select,textarea{-webkit-tap-highlight-color:transparent} +a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:3px solid var(--pro-accent);outline-offset:4px} +.pro-wrap{width:100%;max-width:min(var(--pro-wide),100%)}.pro-header{isolation:isolate;box-shadow:0 1px 0 rgba(15,35,60,.035)}.pro-head-inner{gap:clamp(15px,2vw,29px)}.pro-logo{min-width:0;flex-shrink:0;gap:12px}.pro-brand-logo{max-width:155px;max-height:46px;width:auto;height:auto;object-fit:contain}.pro-logo-name{overflow-wrap:anywhere}.pro-navigation{gap:clamp(11px,1.6vw,24px)}.pro-header-cta{white-space:nowrap} +.pro-mobile-toggle,.pro-catalog-toggle,.pro-nav-disclose{border:0;background:transparent;color:inherit;line-height:1.2} +.pro-mobile-toggle{min-height:44px;min-width:44px;border:1px solid currentColor;border-radius:6px;font-size:19px}.pro-nav-group{position:relative;display:flex;align-items:center;gap:2px} +.pro-nav-disclose{padding:9px;font-size:13px}.pro-nav-children{position:absolute;top:100%;left:0;min-width:215px;max-width:330px;display:grid;gap:2px;padding:13px;box-shadow:var(--sf-shadow);border-radius:10px;z-index:45;background:var(--pro-background);border:1px solid var(--pro-border);color:var(--pro-text)} +.pro-nav-children[hidden],.pro-mega[hidden]{display:none!important}.pro-nav-children a{display:block;font-size:13px;white-space:normal;padding:10px;border-radius:5px}.pro-nav-children a:hover{background:var(--pro-surface)} +.pro-catalog-toggle{padding:11px 3px;white-space:nowrap;font-size:12px;font-weight:700}.pro-mega{position:absolute;top:100%;left:50%;transform:translateX(-50%);width:min(100%,var(--pro-wide));box-shadow:var(--sf-shadow);z-index:41;display:grid;grid-template-columns:215px 1fr;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);border-radius:0 0 15px 15px;padding:29px;align-items:start}.pro-mega>span{font-size:12px;letter-spacing:.06em}.pro-mega>div{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:9px 22px;overflow:visible}.pro-mega>div a{white-space:normal;padding:10px 5px;border-bottom:1px solid var(--pro-border)} +.pro-home-hero{overflow:hidden}.pro-home-hero .pro-home-grid{min-height:660px;gap:5%}.pro-home-hero .pro-hero-copy{position:relative;z-index:2}.pro-home-hero .pro-hero-copy h1{font-size:clamp(46px,5.7vw,92px);line-height:1.06;letter-spacing:-.064em;max-width:15ch}.pro-home-hero .pro-hero-copy h1 em{font-style:normal;display:block}.pro-home-hero .pro-hero-copy p{font-size:clamp(15px,1.3vw,19px);line-height:1.75;max-width:44ch}.pro-home-hero .pro-hero-art{min-width:0;min-height:425px;position:relative;isolation:isolate}.pro-home-hero .pro-hero-art>img{width:100%;height:100%;object-fit:cover;position:absolute;inset:0}.pro-hero-art:has(.pro-abstract-car),.pro-hero-art:has(.pro-technical),.pro-hero-art:has(.pro-corporate-shape){background-position:center;background-size:cover;background-repeat:no-repeat}.pro-abstract-car,.pro-technical,.pro-corporate-shape{position:relative;z-index:1;pointer-events:none} +.pro-hero-actions{display:flex;flex-wrap:wrap;align-items:center;gap:15px}.pro-button,.pro-header-cta,.pro-outline-button{min-height:48px;transition:transform .24s ease,box-shadow .24s ease,opacity .24s ease}.pro-button:hover,.pro-header-cta:hover,.pro-outline-button:hover{transform:translateY(-2px);box-shadow:0 10px 22px rgba(0,0,0,.10)} +.pro-section{padding-top:clamp(76px,7vw,112px)!important;padding-bottom:clamp(76px,7vw,112px)!important}.pro-section-head{gap:16px}.pro-section-head h2{font-size:clamp(32px,3.5vw,53px);max-width:22ch}.pro-section-head .pro-text-link{align-self:end} +.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:20px}.pro-card{min-width:0;display:flex;flex-direction:column;transition:transform .28s ease,box-shadow .28s ease;border:1px solid var(--pro-border);background:var(--pro-background);overflow:hidden}.pro-card:hover{transform:translateY(-6px);box-shadow:var(--sf-shadow-hover)}.pro-card-cover{aspect-ratio:1.42;overflow:hidden;background:var(--pro-surface);position:relative}.pro-card-cover .pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .45s ease}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-card-body{display:flex;flex-direction:column;flex:1}.pro-card-body h3{font-size:clamp(19px,1.6vw,24px);line-height:1.26}.pro-card-body p{font-size:14px}.pro-card-link{margin-top:auto;padding-top:14px;font-size:13px;font-weight:700} +.pro-art{min-height:100%;width:100%;position:relative;overflow:hidden;display:grid;place-items:center;isolation:isolate}.pro-art-ring{width:60%;aspect-ratio:1;border:1px solid currentColor;opacity:.13;border-radius:50%;transform:rotate(20deg);box-shadow:0 0 0 23px #ffffff10,0 0 0 57px #ffffff07}.pro-art-center{font-size:clamp(38px,5vw,80px);position:absolute;font-weight:800;letter-spacing:-.065em;opacity:.65}.pro-art-label{position:absolute;bottom:19px;left:22px;font-size:10px;letter-spacing:.22em;opacity:.7} +.pro-breadcrumb{display:flex;gap:11px;flex-wrap:wrap;font-size:12px;align-items:center}.pro-breadcrumb a{text-decoration:underline;text-underline-offset:4px}.pro-product-hero{align-items:start;gap:clamp(28px,5vw,80px)}.pro-product-media{aspect-ratio:1.12;background:var(--pro-surface);overflow:hidden}.pro-product-media>img,.pro-product-media>.pro-art{width:100%;height:100%;object-fit:contain}.pro-product-summary{padding:clamp(12px,3vw,50px) 0}.pro-product-summary h1{font-size:clamp(36px,4.3vw,72px)}.pro-detail-layout{border-top:1px solid var(--pro-border);padding-top:50px}.pro-specs>div{display:grid;grid-template-columns:minmax(100px,40%) 1fr;gap:10px;align-items:baseline;padding:15px 0;border-bottom:1px solid var(--pro-border)}.pro-specs strong{overflow-wrap:anywhere}.pro-gallery-thumbs button{flex-basis:96px;height:76px}.pro-gallery-lightbox{backdrop-filter:blur(6px)} +.pro-filter-panel{display:flex;align-items:end;flex-wrap:wrap;gap:16px;background:var(--pro-surface);border:1px solid var(--pro-border);padding:20px;margin-bottom:25px;border-radius:var(--pro-radius)}.pro-filter-panel label{display:grid;gap:7px;min-width:180px;flex:1}.pro-filter-panel input,.pro-filter-panel select{width:100%;background:var(--pro-background);border:1px solid var(--pro-border);padding:12px 14px;color:var(--pro-text);border-radius:6px}.pro-filter-count{white-space:nowrap;font-size:13px;padding:12px 0}.pro-card[hidden]{display:none!important}.pro-filter-empty{padding:38px;border:1px dashed var(--pro-border);text-align:center;grid-column:1/-1} +.pro-inquiry input,.pro-inquiry textarea{min-height:46px}.pro-inquiry textarea{min-height:150px}.pro-inquiry-wrap{gap:clamp(32px,7vw,110px)}.pro-inquiry .pro-button{border:0;justify-self:start}.pro-footer-links a{padding-block:5px;display:inline-block} +.pro-end-cta{overflow:hidden}.pro-end-cta h2{font-size:clamp(30px,4vw,64px)} +.pro-rich{line-height:1.85}.pro-rich img{border-radius:var(--pro-radius);margin-block:24px}.pro-rich table{width:100%;display:block;overflow:auto;border-collapse:collapse}.pro-rich td,.pro-rich th{border:1px solid var(--pro-border);padding:10px 14px}.pro-rich a{text-decoration:underline;text-underline-offset:3px} +@media(min-width:1025px){.pro-navigation>.pro-nav-group:hover .pro-nav-children:not([hidden]){visibility:visible}} +@media(max-width:1150px){.pro-head-inner{gap:15px}.pro-navigation{gap:12px}.pro-logo-name{font-size:15px}.pro-header-cta{padding:13px 16px}} +@media(max-width:1024px){.pro-head-inner{min-height:72px;flex-wrap:wrap}.pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto}.pro-navigation{display:none;width:100%;flex-basis:100%;flex-direction:column;align-items:stretch;gap:0;order:5;margin:0;padding:8px 0 20px;border-top:1px solid var(--pro-border)}.pro-navigation.is-open{display:flex}.pro-navigation>a,.pro-nav-group>a{padding:14px 8px;font-size:15px}.pro-nav-group{display:flex;flex-wrap:wrap;justify-content:space-between}.pro-nav-children{position:static;flex-basis:100%;max-width:none;width:100%;box-shadow:none;border-radius:0;border-left:2px solid var(--pro-accent);margin:0 0 12px 8px}.pro-nav-disclose{min-width:44px;min-height:44px}.pro-catalog-toggle{margin-left:auto}.pro-mega{top:100%;display:block;padding:20px}.pro-mega>div{grid-template-columns:repeat(2,minmax(0,1fr));margin-top:12px}.pro-home-hero .pro-home-grid{min-height:560px}.pro-home-hero .pro-hero-art{min-height:325px}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}} +@media(max-width:700px){.pro-wrap{padding-left:20px;padding-right:20px}.pro-utility{display:none}.pro-head-inner{min-height:66px}.pro-logo-name{max-width:140px;font-size:14px}.pro-brand-logo{max-width:125px}.pro-header-cta{display:none}.pro-catalog-toggle{font-size:11px;padding-inline:7px;margin-left:0}.pro-home-hero .pro-home-grid{display:flex;flex-direction:column;gap:36px;padding-top:48px;padding-bottom:48px}.pro-home-hero .pro-hero-copy h1{font-size:clamp(43px,10vw,68px)}.pro-home-hero .pro-hero-copy p{font-size:15px}.pro-home-hero .pro-hero-art{width:100%;min-height:290px}.pro-home-hero .pro-hero-bottom{display:none}.pro-section{padding-top:68px!important;padding-bottom:68px!important}.pro-section-head{align-items:flex-start}.pro-grid{grid-template-columns:1fr;gap:18px}.pro-card-cover{aspect-ratio:1.45}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-inquiry-wrap{display:grid;grid-template-columns:1fr;gap:30px}.pro-product-summary{padding:0}.pro-specs>div{grid-template-columns:1fr 1fr}.pro-mega{top:100%;max-height:65vh;overflow-y:auto}.pro-mega>div{grid-template-columns:1fr}.pro-filter-panel{display:grid;grid-template-columns:1fr;gap:12px}.pro-filter-panel label{min-width:0}.pro-footer-top{display:grid;grid-template-columns:1fr;gap:27px}.pro-footer-bottom{gap:12px;flex-wrap:wrap}} +@media(max-width:410px){.pro-logo-name{max-width:115px}.pro-logo-symbol{font-size:28px}.pro-catalog-toggle{font-size:10px}.pro-mobile-toggle{min-width:42px}} +@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*:before,*:after{animation-duration:.01ms!important;transition-duration:.01ms!important;scroll-behavior:auto!important}} + +/* Accessible static catalogue pagination for large inventories. */ +.pro-pages-nav{display:flex;gap:1rem;justify-content:center;align-items:center;margin:2rem 0;flex-wrap:wrap} +.pro-pages-nav a{padding:.7rem 1.1rem;border:1px solid currentColor;border-radius:.4rem;text-decoration:none} +.pro-pages-nav a:focus-visible{outline:3px solid var(--accent,#2563eb);outline-offset:3px} +.pro-pages-nav span{font-size:.875rem} + +/* P6 international sites: small, keyboard-operable language switch. */ +.sf-language-switch{display:inline-flex;gap:6px;align-items:center;flex-wrap:wrap;margin:8px 12px;padding:4px;border:1px solid rgba(120,130,145,.22);border-radius:10px;background:rgba(255,255,255,.08)} +.sf-language-switch a{font:inherit;font-size:12px;line-height:1.5;padding:4px 7px;border-radius:6px;color:inherit;text-decoration:none} +.sf-language-switch a[aria-current="page"]{font-weight:700;text-decoration:underline;text-underline-offset:3px} +.sf-language-switch a:focus-visible{outline:2px solid #2563eb;outline-offset:3px} +@media(max-width:640px){.sf-language-switch{margin:6px 0;width:auto}} + +/* V8.21.3 — Four-theme unified mobile off-canvas navigation & optional tab bar. + Desktop remains unchanged. Phone / tablet use one accessible drawer. */ +.sf-mobile-tabs{display:none!important} +.sf-drawer-header,.sf-mobile-drawer-backdrop,.sf-drawer-extra{display:none} +@media(max-width:1024px){ + .pro-head-inner{flex-wrap:nowrap!important;gap:12px!important} + .pro-mobile-toggle{display:inline-flex;align-items:center;justify-content:center;margin-left:auto!important;flex:0 0 44px;min-width:44px;min-height:44px;position:relative;z-index:3} + .pro-catalog-toggle{display:none!important} + .pro-navigation,.pro-navigation.is-open{display:flex!important;position:fixed!important;inset:0 0 0 auto!important;width:min(88vw,360px)!important;height:100dvh!important;height:100vh;max-height:100dvh!important;flex:unset!important;flex-direction:column!important;align-items:stretch!important;order:unset!important;margin:0!important;padding:0 0 calc(20px + env(safe-area-inset-bottom,0px))!important;overflow-x:hidden;overflow-y:auto!important;background:var(--pro-background,#fff)!important;color:var(--pro-text,#19283c)!important;border:0!important;border-left:1px solid var(--pro-border,#ddd)!important;box-shadow:-15px 0 45px #0002!important;z-index:1201!important;transform:translateX(105%);visibility:hidden;pointer-events:none;transition:transform .24s ease,visibility .24s ease!important;overscroll-behavior:contain} + .pro-navigation.is-open{transform:translateX(0);visibility:visible;pointer-events:auto} + .sf-drawer-header{display:flex!important;align-items:center;justify-content:space-between;gap:12px;padding:20px 18px;border-bottom:1px solid var(--pro-border,#dde3e9);font-size:17px;font-weight:750;position:sticky;top:0;background:var(--pro-background,#fff);z-index:2} + .sf-drawer-close{min-width:44px;min-height:44px;border:1px solid var(--pro-border,#dde3e9);color:inherit;background:transparent;border-radius:10px;font-size:24px;cursor:pointer} + .sf-mobile-drawer-backdrop{display:block;position:fixed;inset:0;z-index:1200;background:#0b1b31a3;opacity:0;visibility:hidden;pointer-events:none;transition:opacity .24s ease,visibility .24s ease} + .sf-mobile-drawer-backdrop.is-open{opacity:1;visibility:visible;pointer-events:auto} + body.sf-drawer-open{overflow:hidden!important} + .pro-navigation>a,.pro-navigation .pro-nav-group>a,.pro-navigation .sf-drawer-extra>a{display:flex;align-items:center;min-height:50px;padding:13px 20px!important;font-size:15px!important;color:inherit!important;white-space:normal;border-bottom:1px solid var(--pro-border,#dde3e9)!important;text-decoration:none!important} + .pro-navigation .pro-nav-group{display:flex;position:relative;flex-wrap:wrap!important;width:100%;gap:0;align-items:center;justify-content:space-between} + .pro-navigation .pro-nav-group>a{flex:1;min-width:0} + .pro-navigation .pro-nav-disclose{margin-right:12px;min-width:44px;min-height:44px;border-radius:9px;background:var(--pro-surface,#f4f6f8)} + .pro-navigation .pro-nav-children{position:static!important;width:100%!important;max-width:100%!important;box-shadow:none!important;border-left:3px solid var(--pro-accent,#e77730);border-radius:0!important;margin:0 0 8px 14px!important;flex-basis:calc(100% - 14px)!important;background:var(--pro-surface,#f6f8fa)} + .pro-navigation .pro-nav-children a{padding:12px 16px!important;font-size:14px!important;color:inherit!important;min-height:44px} + .sf-drawer-extra{display:block;padding:12px 0 5px}.sf-drawer-extra strong{display:block;font-size:12px;letter-spacing:.06em;padding:12px 20px;opacity:.65}.sf-drawer-extra a{font-size:14px!important} + .sf-drawer-close:focus-visible,.pro-mobile-toggle:focus-visible,.pro-nav-disclose:focus-visible,.sf-mobile-tab:focus-visible{outline:3px solid var(--pro-accent,#ff8200);outline-offset:2px} +} +@media(max-width:767px){ + .pro-header-cta{display:none!important} + .pro-head-inner .pro-logo{min-width:0;max-width:calc(100% - 65px)} + .pro-logo-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .pro-home-hero .pro-home-grid{min-height:0!important} + .pro-home-hero .pro-hero-art{min-height:230px} + .pro-card,.pro-card-cover,.pro-product-media{max-width:100%;min-width:0} + .pro-rich img,.pro-content img,.sf-canvas img{max-width:100%;height:auto} + .pro-rich table{max-width:100%;overflow:auto} + .pro-grid,.pro-footer-top{min-width:0} + .sf-mobile-tabs{display:grid!important;position:fixed;z-index:1100;bottom:0;left:0;right:0;grid-template-columns:repeat(var(--sf-mobile-tab-count,4),minmax(0,1fr));align-items:stretch;padding:5px 6px calc(5px + env(safe-area-inset-bottom,0px));min-height:63px;background:var(--pro-background,#fff);color:var(--pro-text,#263446);border-top:1px solid var(--pro-border,#dfe4eb);box-shadow:0 -6px 24px #13223914} + .sf-mobile-tab{appearance:none;border:0!important;background:transparent!important;color:inherit!important;text-decoration:none!important;padding:6px 2px;min-height:50px;min-width:0;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:2px;border-radius:9px;cursor:pointer;font-family:inherit} + .sf-tab-icon{font-size:23px;line-height:1.15;font-weight:500} + .sf-tab-label{font-size:11px;font-weight:600;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + .sf-mobile-tab[aria-current=page]{color:var(--pro-accent,#e47730)!important;background:var(--pro-surface,#f5f6f8)!important} + body:has(> .sf-mobile-tabs){padding-bottom:calc(76px + env(safe-area-inset-bottom,0px))!important} +} +@media(min-width:768px){.sf-mobile-tabs{display:none!important}} +@media(prefers-reduced-motion:reduce){.pro-navigation,.sf-mobile-drawer-backdrop{transition:none!important}} diff --git a/examples/mobile-showcase/minimal/assets/custom.css b/examples/mobile-showcase/minimal/assets/custom.css new file mode 100644 index 0000000..e18a2d4 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/custom.css @@ -0,0 +1 @@ +body .pro-utility[hidden]{display:none!important}@media(max-width:1023px){.sf-canvas .sf-section{padding-block:64px}}@media(max-width:767px){.sf-canvas .sf-section{padding-block:40px}.pro-wrap,.sf-container{padding-left:20px;padding-right:20px}body .pro-utility{display:none!important}} \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/assets/factory.css b/examples/mobile-showcase/minimal/assets/factory.css new file mode 100644 index 0000000..154ffb3 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/factory.css @@ -0,0 +1,27 @@ +/* SiteForge trusted global shell. Site themes remain visually independent. */ +:root{--sf-shell:#12243d;--sf-shell-accent:#dcae71;--sf-shell-soft:#edf2f8;--sf-shell-fg:#173049} +html{scroll-behavior:smooth}body{overflow-x:hidden}body>.header,body>.utility,body>.top,body>header,body>footer{display:none!important} +.sf-theme-industrial{--sf-shell:#114e79;--sf-shell-accent:#92d5ed;--sf-shell-soft:#ebf6fa;--sf-shell-fg:#0c4267} +.sf-theme-corporate{--sf-shell:#232d62;--sf-shell-accent:#b8bdff;--sf-shell-soft:#f3f3fa;--sf-shell-fg:#333468} +.sf-theme-minimal{--sf-shell:#1e1e1c;--sf-shell-accent:#ded6c5;--sf-shell-soft:#f6f4ef;--sf-shell-fg:#252520} +.sf-site-head{position:relative;z-index:25;background:var(--sf-shell);color:#fff;font-family:system-ui,-apple-system,sans-serif} +.sf-head-inner{max-width:1240px;margin:0 auto;min-height:78px;padding:0 28px;display:flex;align-items:center;gap:28px} +.sf-logo{display:flex;align-items:center;gap:11px;font-size:18px;text-decoration:none!important;color:#fff!important;white-space:nowrap} +.sf-logo-mark{width:36px;height:36px;display:grid;place-items:center;background:var(--sf-shell-accent);color:var(--sf-shell);font-size:22px;font-weight:900;border-radius:9px} +.sf-primary-links{display:flex;gap:23px;margin-left:auto;align-items:center} +.sf-primary-links a,.sf-mega a{color:#fff!important;text-decoration:none!important;font-size:13px;font-weight:650;white-space:nowrap} +.sf-primary-links a:hover{color:var(--sf-shell-accent)!important} +.sf-head-cta{font-size:13px;font-weight:750;text-decoration:none;background:var(--sf-shell-accent);color:var(--sf-shell)!important;padding:13px 18px;border-radius:4px;white-space:nowrap} +.sf-menu-toggle{display:none;margin-left:auto;color:white;border:1px solid #ffffff55;background:none;border-radius:4px;padding:8px 12px;font-size:19px;cursor:pointer} +.sf-mega{display:flex;gap:18px;max-width:1240px;margin:auto;padding:0 28px 9px;overflow-x:auto} +.sf-mega a{display:block;min-width:120px;border-top:1px solid #ffffff2e;padding:12px 8px}.sf-mega small{display:block;color:#ffffff99;max-width:160px;overflow:hidden;text-overflow:ellipsis;font-size:10px;margin-top:6px} +.sf-site-foot{background:var(--sf-shell);color:white!important;font:14px/1.7 system-ui,-apple-system,sans-serif;padding:72px 28px 26px} +.sf-foot-grid{max-width:1200px;margin:auto;display:grid;grid-template-columns:2fr 1fr 1fr;gap:70px}.sf-foot-grid h2{font-size:25px;color:white;margin:0 0 17px}.sf-foot-grid h4{font-size:13px;color:var(--sf-shell-accent);letter-spacing:.07em;margin:0 0 17px}.sf-foot-grid p{color:#ffffffae;max-width:380px}.sf-foot-grid a{display:block;width:fit-content;color:#fff!important;text-decoration:none;margin-bottom:8px}.sf-foot-lower{border-top:1px solid #ffffff33;max-width:1200px;margin:45px auto 0;padding-top:20px;display:flex;justify-content:space-between;color:#ffffff9e;font-size:12px} +.sf-filters{display:flex;align-items:center;flex-wrap:wrap;gap:12px;margin:0 0 30px}.sf-filters input,.sf-filters select{padding:11px 13px;border-radius:6px;border:1px solid #cfd9e4;background:#fff;color:#263a51;max-width:280px}.sf-filter-empty{padding:22px;color:#778598} +.sf-search-page{min-height:76vh;max-width:1060px;padding:90px 24px;margin:auto;font-family:system-ui,sans-serif;color:var(--sf-shell-fg)}.sf-search-page h1{font-size:clamp(35px,5vw,62px);margin:20px 0}.sf-search-page>label{display:block;margin:18px 0 8px}.sf-search-page input{display:block;width:100%;padding:17px;font-size:18px;border:1px solid #b7c6d7;border-radius:8px}.sf-search-page #sf-search-count{margin:22px 0;color:#607589}.sf-search-result{padding:22px 0;border-bottom:1px solid #dae1ea}.sf-search-result a{color:var(--sf-shell-fg);font-size:21px;font-weight:750;text-decoration:none}.sf-search-result small{display:block;color:#7992a7}.sf-search-result p{margin:7px 0;color:#657487} +@media(max-width:1050px){.sf-head-inner{gap:13px}.sf-primary-links{gap:12px}.sf-primary-links a{font-size:12px}.sf-head-cta{padding:10px}} +@media(max-width:850px){.sf-head-inner{min-height:68px}.sf-menu-toggle{display:block}.sf-head-cta{display:none}.sf-primary-links{display:none;position:absolute;top:68px;left:0;right:0;margin:0;background:var(--sf-shell);padding:20px 28px;flex-direction:column;align-items:stretch;box-shadow:0 20px 24px #0002}.sf-primary-links.is-open{display:flex}.sf-mega{display:none}.sf-foot-grid{grid-template-columns:1fr 1fr;gap:35px}} +@media(max-width:560px){.sf-foot-grid{grid-template-columns:1fr}.sf-foot-lower{display:block}.sf-site-foot{padding-top:48px}.sf-head-inner{padding:0 16px}} + +.sf-page-intro{padding:80px 28px;background:var(--sf-shell-soft);color:var(--sf-shell-fg);font-family:system-ui,sans-serif}.sf-page-intro>div{max-width:1200px;margin:auto}.sf-page-intro p{font-size:11px;font-weight:850;letter-spacing:.19em;text-transform:uppercase;color:var(--sf-shell-fg);opacity:.58}.sf-page-intro h1{font-size:clamp(38px,5vw,67px);letter-spacing:-.04em;line-height:1.08;margin:13px 0}.sf-page-intro span{font-size:16px;opacity:.72} +.sf-item[hidden]{display:none!important} diff --git a/examples/mobile-showcase/minimal/assets/pro-base.css b/examples/mobile-showcase/minimal/assets/pro-base.css new file mode 100644 index 0000000..c2c4f61 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/pro-base.css @@ -0,0 +1,21 @@ +/* SiteForge V3 professional theme primitives. Each commercial theme adds its own art direction. */ +:root{--pro-text:#19283a;--pro-muted:#687587;--pro-border:#dfe5ea;--pro-background:#fff;--pro-surface:#f5f7fa;--pro-accent:#365cb7;--pro-hero:#15263d;--pro-hero-fg:#fff;--pro-radius:12px;--pro-headings:system-ui,-apple-system,sans-serif;--pro-font:system-ui,-apple-system,sans-serif;--pro-wide:1270px} +*,*:before,*:after{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--pro-background);color:var(--pro-text);font-family:var(--pro-font);-webkit-font-smoothing:antialiased;overflow-x:hidden}button,input,select{font:inherit}button,a{touch-action:manipulation}button{cursor:pointer}a{text-decoration:none;color:inherit}a:hover{color:var(--pro-accent)}img{max-width:100%;display:block}h1,h2,h3,h4,p{margin-top:0}h1,h2,h3{font-family:var(--pro-headings);line-height:1.09}h1{letter-spacing:-.052em}h2{letter-spacing:-.042em}h3{letter-spacing:-.028em}p{line-height:1.72}.pro-wrap{max-width:var(--pro-wide);margin:0 auto;padding-left:32px;padding-right:32px}.pro-skip{position:absolute;left:-9999px;z-index:90;background:#fff;color:#000;padding:12px}.pro-skip:focus{left:10px;top:10px}.pro-eyebrow{font-weight:750;font-size:11px;letter-spacing:.17em;text-transform:uppercase;display:block;line-height:1.6;color:var(--pro-accent)}.pro-muted{opacity:.7}.pro-utility{min-height:30px;background:var(--pro-hero);color:#c5d2db;font-size:10px;letter-spacing:.16em}.pro-utility .pro-wrap{display:flex;justify-content:space-between;padding-block:8px}.pro-utility i{font-style:normal;color:var(--pro-accent)}.pro-header{background:var(--pro-background);color:var(--pro-text);border-bottom:1px solid var(--pro-border);position:relative;z-index:35}.pro-head-inner{min-height:84px;display:flex;align-items:center;gap:28px}.pro-logo{display:flex;align-items:center;gap:12px;min-width:170px}.pro-logo-symbol{font-size:32px;line-height:1;font-weight:800;letter-spacing:-.07em;color:var(--pro-accent)}.pro-logo-name{max-width:220px;font-weight:820;font-size:17px;line-height:1.1;letter-spacing:-.035em}.pro-logo-name small{display:block;font-weight:650;font-size:9px;letter-spacing:.19em;margin-top:7px;color:var(--pro-muted)}.pro-navigation{display:flex;align-items:center;gap:24px;margin-left:auto}.pro-navigation a{font-size:13px;font-weight:650;white-space:nowrap;transition:opacity .2s}.pro-navigation a:hover{opacity:.6}.pro-header-cta,.pro-button{display:inline-flex;align-items:center;justify-content:center;gap:22px;background:var(--pro-accent);color:#fff!important;border-radius:var(--pro-radius);font-size:13px;letter-spacing:.01em;font-weight:750;padding:16px 24px;white-space:nowrap;transition:transform .2s,background .2s}.pro-header-cta:hover,.pro-button:hover{transform:translateY(-2px)}.pro-mobile-toggle{display:none}.pro-mega{display:flex;align-items:center;gap:22px;min-height:37px;border-top:1px solid var(--pro-border);padding-block:10px;font-size:11px}.pro-mega>span{font-weight:750;color:var(--pro-muted);white-space:nowrap}.pro-mega>div{display:flex;gap:16px;overflow:auto;scrollbar-width:none}.pro-mega a{white-space:nowrap;font-weight:650}.pro-search-link{font-size:19px!important}.pro-home-hero{position:relative;overflow:hidden}.pro-home-grid{display:grid;grid-template-columns:1.02fr .98fr;align-items:center;gap:5%;min-height:580px;padding-top:85px;padding-bottom:85px}.pro-hero-copy{position:relative;z-index:2}.pro-hero-copy h1{font-size:clamp(48px,6.2vw,91px);line-height:1.03;margin:20px 0 25px;max-width:730px}.pro-hero-copy h1 em{font-style:normal;display:block;color:var(--pro-accent)}.pro-hero-copy p{font-size:17px;max-width:495px;color:var(--pro-muted)}.pro-hero-actions{display:flex;align-items:center;flex-wrap:wrap;gap:25px;margin-top:34px}.pro-outline-button{font-weight:700;border-bottom:1px solid currentColor;padding:12px 0}.pro-hero-art{width:100%;height:435px;position:relative;overflow:hidden;border-radius:var(--pro-radius)}.pro-hero-art>img{width:100%;height:100%;object-fit:cover}.pro-hero-bottom{display:flex;justify-content:space-between;font-size:10px;letter-spacing:.18em;padding-block:22px;border-top:1px solid #ffffff32}.pro-section{padding:106px 0}.pro-section-head{display:flex;align-items:end;justify-content:space-between;gap:25px;margin-bottom:34px}.pro-section-head h2{font-size:clamp(36px,4vw,57px);margin:12px 0 0}.pro-text-link{font-size:13px;font-weight:750;display:inline-flex;gap:18px;align-items:center;border-bottom:1px solid;padding-bottom:7px;color:var(--pro-accent)}.pro-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:22px}.pro-card{display:block;min-width:0;background:var(--pro-background);color:var(--pro-text);border:1px solid var(--pro-border);overflow:hidden;border-radius:var(--pro-radius);transition:transform .25s,box-shadow .25s}.pro-card:hover{transform:translateY(-6px);box-shadow:0 24px 45px #0f25431b}.pro-card-cover{width:100%;height:244px;overflow:hidden;background:var(--pro-surface)}.pro-photo{width:100%;height:100%;object-fit:cover;transition:transform .5s}.pro-card:hover .pro-photo{transform:scale(1.045)}.pro-art{width:100%;height:100%;overflow:hidden;display:grid;place-items:center;position:relative;background:linear-gradient(130deg,#d8e1ed,#f3f6f9)}.pro-art-ring{width:55%;aspect-ratio:1;border:28px solid #ffffff5f;border-radius:50%;box-shadow:0 0 0 42px #ffffff30;transform:rotate(-25deg)}.pro-art-center{position:absolute;font-family:var(--pro-headings);font-weight:800;font-size:76px;letter-spacing:-.08em;color:#45647d90}.pro-art-label{position:absolute;bottom:16px;left:18px;letter-spacing:.16em;font-size:9px;color:#435773}.pro-card-body{padding:25px 25px 28px}.pro-card-meta{display:flex;justify-content:space-between;gap:20px;font-size:10px;font-weight:750;letter-spacing:.1em;text-transform:uppercase;color:var(--pro-accent)}.pro-card h3{font-size:23px;margin:14px 0 9px}.pro-card p{font-size:13px;color:var(--pro-muted);margin-bottom:24px;min-height:44px}.pro-card-link{font-size:12px;font-weight:800;display:flex;justify-content:space-between;color:var(--pro-text);padding-top:14px;border-top:1px solid var(--pro-border)}.pro-empty{grid-column:1/-1;padding:45px;border:1px dashed var(--pro-border);background:var(--pro-surface);color:var(--pro-muted)}.pro-statement{background:var(--pro-surface)}.pro-statement-layout{display:grid;grid-template-columns:1fr 2fr;gap:60px}.pro-statement h2{font-size:clamp(36px,4.5vw,63px);max-width:760px}.pro-statement p{max-width:520px;color:var(--pro-muted)}.pro-brand-pills{display:flex;flex-wrap:wrap;gap:12px}.pro-brand-pills a{padding:18px 28px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);font-weight:750}.pro-brand-pills a:hover{border-color:var(--pro-accent)}.pro-inner-hero{background:var(--pro-surface);padding:92px 0 65px;position:relative;overflow:hidden}.pro-inner-hero h1{max-width:870px;font-size:clamp(43px,6vw,85px);margin:18px 0}.pro-inner-hero p{max-width:650px;color:var(--pro-muted);font-size:17px}.pro-breadcrumb{font-size:12px;color:var(--pro-muted);margin-top:25px;display:flex;gap:12px;align-items:center;flex-wrap:wrap}.pro-breadcrumb strong{color:var(--pro-text)}.pro-list-section{padding:65px 0 110px}.pro-filter-panel{display:grid;grid-template-columns:minmax(220px,2fr) 1fr 1fr auto;align-items:end;gap:14px;margin-bottom:35px}.pro-filter-panel label>span{display:block;font-size:11px;margin-bottom:8px;color:var(--pro-muted);font-weight:750}.pro-filter-panel input,.pro-filter-panel select{display:block;width:100%;padding:14px 15px;border-radius:var(--pro-radius);border:1px solid var(--pro-border);background:var(--pro-background);color:var(--pro-text);outline-offset:2px}.pro-filter-count{font-size:12px;padding-bottom:17px;color:var(--pro-muted)}.pro-filter-scope .pro-card[hidden]{display:none}.pro-product-layout{padding-top:38px}.pro-product-layout .pro-breadcrumb{margin-bottom:38px}.pro-product-hero{display:grid;grid-template-columns:1.18fr .82fr;gap:6%;align-items:center}.pro-product-media{height:460px;overflow:hidden;background:var(--pro-surface);border-radius:var(--pro-radius)}.pro-product-media .pro-photo{height:100%}.pro-product-summary h1{font-size:clamp(45px,5vw,72px);margin:16px 0}.pro-product-summary p{font-size:16px;color:var(--pro-muted)}.pro-product-brand{font-weight:700;color:var(--pro-text)!important}.pro-detail-layout{border-top:1px solid var(--pro-border);display:grid;grid-template-columns:1fr 1fr;gap:8%;margin-top:80px;padding-top:55px}.pro-detail-layout h2{font-size:32px;margin-top:13px}.pro-specs{margin-top:25px}.pro-specs>div{display:grid;grid-template-columns:1fr 1fr;gap:22px;padding:16px 0;border-bottom:1px solid var(--pro-border)}.pro-specs span{color:var(--pro-muted)}.pro-rich{line-height:1.85;font-size:16px;overflow-wrap:anywhere}.pro-rich img{border-radius:var(--pro-radius);margin:25px 0}.pro-rich a{text-decoration:underline}.pro-rich h2{margin-top:30px}.pro-lead{font-size:20px;color:var(--pro-muted)}.pro-brand-hero-grid{display:grid;grid-template-columns:1.1fr .9fr;gap:7%;align-items:center}.pro-brand-media{height:300px;overflow:hidden;border-radius:var(--pro-radius)}.pro-article-hero{text-align:center;padding:110px 0 75px;background:var(--pro-surface)}.pro-article-width{max-width:900px}.pro-article-hero h1{font-size:clamp(40px,5vw,75px);margin:15px 0 25px}.pro-article-hero p{color:var(--pro-muted);font-size:18px}.pro-article-hero time{font-size:12px;color:var(--pro-muted)}.pro-article-content{max-width:930px;padding-top:70px;padding-bottom:90px}.pro-article-cover{width:100%;max-height:530px;object-fit:cover;margin-bottom:40px;border-radius:var(--pro-radius)}.pro-article-content>.pro-text-link{margin-top:35px}.pro-case-detail{max-width:1020px}.pro-case-detail>img{width:100%;max-height:620px;object-fit:cover}.pro-case-meta{display:flex;gap:35px;margin:35px 0;color:var(--pro-muted);font-size:13px}.pro-case-meta strong{display:block;color:var(--pro-text);font-size:18px;margin-top:7px}.pro-info-grid{display:grid;grid-template-columns:.8fr 1.2fr;gap:12%}.pro-info-grid h2{font-size:clamp(31px,4.5vw,54px);margin-top:15px}.pro-contact-email{font-size:20px;color:var(--pro-accent);font-weight:750;word-break:break-word}.pro-info-photo{max-height:450px;object-fit:cover;margin-top:35px;border-radius:var(--pro-radius)}.pro-custom-content .sf-section{background:transparent}.pro-custom-content .sf-section:nth-of-type(even){background:var(--pro-surface)}.pro-end-cta{padding:76px 0;background:var(--pro-hero);color:#fff}.pro-end-cta .pro-wrap{display:flex;align-items:center;justify-content:space-between;gap:40px}.pro-end-cta h2{font-size:clamp(32px,4vw,53px);margin:13px 0}.pro-end-cta p{color:#c5c9d1}.pro-end-cta a{background:var(--pro-accent);color:#fff;font-weight:800;padding:19px 30px;border-radius:var(--pro-radius);white-space:nowrap}.pro-404{text-align:center;padding-block:125px}.pro-404>span{font-size:12px;letter-spacing:.3em}.pro-404 h1{font-size:clamp(150px,20vw,320px);margin:10px 0;letter-spacing:-.08em}.pro-404 p{font-size:18px;color:var(--pro-muted)}.pro-404 a{margin-top:22px}.pro-footer{background:#15212d;color:#fff;padding:75px 0 22px}.pro-footer-top{display:grid;grid-template-columns:1.45fr 1fr 1fr;gap:55px}.pro-footer h2{font-size:32px;margin:12px 0}.pro-footer p{max-width:350px;font-size:13px;color:#afbbc8}.pro-footer .pro-eyebrow{color:#b6c3d2}.pro-footer-links ul{margin:0;padding:0;list-style:none;display:grid;grid-template-columns:1fr 1fr;gap:15px}.pro-footer-links a{font-size:13px;color:#d6e0e8}.pro-footer-bottom{border-top:1px solid #ffffff29;margin-top:60px;padding-top:20px;font-size:10px;letter-spacing:.12em;color:#adb9c3;display:flex;justify-content:space-between}.pro-anchor{display:block;height:0}.pro-category-tiles{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}.pro-category-tiles a{padding:35px 28px;min-height:155px;background:var(--pro-surface);display:flex;flex-direction:column;justify-content:space-between}.pro-category-tiles span{font-size:11px;color:var(--pro-muted)}.pro-category-tiles strong{font-size:24px}.pro-category-tiles b{align-self:end}.sf-site-head .sf-head-inner,.sf-site-head .sf-primary-links{display:none} +@media(max-width:1100px){.pro-head-inner{gap:17px}.pro-navigation{gap:14px}.pro-navigation a{font-size:12px}.pro-home-grid{min-height:500px}.pro-hero-copy h1{font-size:60px}.pro-hero-art{height:350px}} +@media(max-width:860px){.pro-wrap{padding-left:22px;padding-right:22px}.pro-utility{display:none}.pro-head-inner{min-height:70px;flex-wrap:wrap;gap:12px}.pro-mobile-toggle{display:block;margin-left:auto;border:1px solid var(--pro-border);padding:8px 12px;background:transparent;color:var(--pro-text);border-radius:5px}.pro-navigation{display:none;order:10;width:100%;flex-direction:column;align-items:stretch;gap:0;padding-bottom:12px}.pro-navigation.is-open{display:flex}.pro-navigation a{padding:11px 2px;border-bottom:1px solid var(--pro-border)}.pro-header-cta{display:none}.pro-mega{display:none}.pro-home-grid{grid-template-columns:1fr;gap:35px;padding-top:60px;padding-bottom:60px}.pro-hero-art{height:350px}.pro-hero-copy h1{font-size:clamp(45px,9vw,73px)}.pro-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.pro-product-hero,.pro-detail-layout,.pro-info-grid,.pro-brand-hero-grid{grid-template-columns:1fr;gap:35px}.pro-product-media{height:380px}.pro-filter-panel{grid-template-columns:1fr 1fr}.pro-filter-panel label:first-child{grid-column:1/-1}.pro-end-cta .pro-wrap{align-items:start;flex-direction:column}.pro-section{padding:72px 0}.pro-footer-top{grid-template-columns:1fr 1fr}.pro-footer-top>div:first-child{grid-column:1/-1}.pro-category-tiles{grid-template-columns:repeat(2,1fr)}} +@media(max-width:560px){.pro-wrap{padding-left:18px;padding-right:18px}.pro-logo-name{font-size:15px}.pro-hero-copy h1{font-size:43px}.pro-hero-art{height:255px}.pro-hero-bottom{display:none}.pro-home-grid{min-height:0}.pro-grid{grid-template-columns:1fr}.pro-section-head{align-items:start;flex-direction:column}.pro-section-head h2{font-size:37px}.pro-card-cover{height:230px}.pro-filter-panel{grid-template-columns:1fr}.pro-filter-panel label:first-child{grid-column:auto}.pro-filter-count{padding-bottom:4px}.pro-statement-layout,.pro-footer-top{grid-template-columns:1fr;gap:25px}.pro-footer-top>div:first-child{grid-column:auto}.pro-footer-bottom{flex-direction:column;gap:8px}.pro-inner-hero{padding:60px 0}.pro-product-media{height:270px}.pro-product-summary h1{font-size:43px}.pro-category-tiles{grid-template-columns:1fr}.pro-end-cta h2{font-size:38px}.pro-minimal-meta{display:block!important}} + +/* V2 compatibility stylesheet hides direct headers/footers; full themes restore their own. */ +body>header.sf-site-head.pro-header,body>footer.sf-site-foot.pro-footer{display:block!important} + +/* Accessible desktop mega-navigation and mobile disclosure */ +.pro-catalog-toggle{font-size:12px;font-weight:750;border:1px solid var(--pro-border);background:transparent;color:inherit;border-radius:var(--pro-radius);padding:10px 14px;white-space:nowrap} +.pro-mega[hidden]{display:none!important}.pro-mega.is-open{display:flex}.pro-mega>div{padding-block:3px} +@media(max-width:1060px){.pro-catalog-toggle{display:none}} +@media(max-width:860px){.pro-mega.is-open{display:block!important}.pro-mega.is-open>div{display:flex;flex-wrap:wrap;gap:14px;padding:12px 0}.pro-mega>span{white-space:normal}} + +/* V4: responsive nested navigation, gallery and opt-in inquiry integration */ +.pro-nav-group{position:relative;display:flex;align-items:center;gap:3px}.pro-nav-disclose{border:0;background:none;color:inherit;font-size:12px;padding:8px}.pro-nav-children[hidden]{display:none!important}.pro-nav-children{position:absolute;left:0;top:100%;z-index:45;min-width:230px;max-width:360px;padding:10px;background:var(--pro-background);border:1px solid var(--pro-border);box-shadow:0 18px 35px #0002;border-radius:var(--pro-radius);display:flex;flex-direction:column}.pro-nav-children a{padding:10px 12px;white-space:nowrap}.pro-nav-children .pro-nav-leaf{padding-left:28px;color:var(--pro-muted)} +.pro-product-gallery{min-width:0}.pro-gallery-thumbs{display:flex;gap:8px;margin-top:12px;overflow:auto;scrollbar-width:thin;padding-bottom:5px}.pro-gallery-thumbs button{flex:0 0 86px;height:67px;border:2px solid transparent;padding:3px;border-radius:8px;background:var(--pro-surface)}.pro-gallery-thumbs button:focus-visible,.pro-gallery-thumbs button[aria-pressed=true]{border-color:var(--pro-accent)}.pro-gallery-thumbs img{width:100%;height:100%;object-fit:cover;border-radius:4px}.pro-gallery-lightbox{position:fixed;inset:0;background:rgba(10,16,30,.92);z-index:1000;display:grid;place-items:center;padding:6vw}.pro-gallery-lightbox[hidden]{display:none}.pro-gallery-lightbox img{max-width:92vw;max-height:80vh;object-fit:contain}.pro-gallery-lightbox button{position:absolute;right:25px;top:25px;border:1px solid #fff8;background:#222;color:#fff;padding:10px 15px;border-radius:5px} +.pro-inquiry-wrap{display:grid;grid-template-columns:1fr 1fr;gap:70px}.pro-inquiry{display:grid;gap:17px}.pro-inquiry label{display:grid;gap:7px;font-weight:650}.pro-inquiry input,.pro-inquiry textarea{padding:13px;border:1px solid var(--pro-border);border-radius:var(--pro-radius);background:var(--pro-background);color:var(--pro-text);width:100%}.pro-inquiry textarea{min-height:140px}.pro-inquiry .pro-honeypot{position:absolute;left:-10000px;width:1px;height:1px}.pro-inquiry p{font-size:12px;color:var(--pro-muted)} +@media(max-width:860px){.pro-nav-group{display:block}.pro-nav-children{position:static;max-width:none;width:100%;box-shadow:none;border:0;border-left:2px solid var(--pro-accent);padding-left:8px}.pro-nav-group>a{display:inline-block}.pro-inquiry-wrap{grid-template-columns:1fr;gap:20px}} diff --git a/examples/mobile-showcase/minimal/assets/pro.css b/examples/mobile-showcase/minimal/assets/pro.css new file mode 100644 index 0000000..e9ec81c --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/pro.css @@ -0,0 +1,8 @@ +:root{--pro-text:#272722;--pro-muted:#797972;--pro-border:#d9d8d0;--pro-background:#fafaf7;--pro-surface:#f0f0eb;--pro-accent:#282923;--pro-hero:#272722;--pro-radius:0;--pro-headings:Georgia,Times New Roman,serif;--pro-font:Arial,sans-serif;--pro-wide:1380px} +.pro-header{background:#fafaf7;color:#292920}.pro-head-inner{min-height:96px}.pro-logo{min-width:200px}.pro-logo-symbol{font-family:Georgia,serif;color:#272722;font-size:40px;font-weight:400}.pro-logo-name{font-family:Georgia,serif;font-size:23px;font-weight:500}.pro-logo-name small{font-family:Arial,sans-serif;font-size:9px}.pro-navigation a{font-size:12px;font-weight:550}.pro-header-cta{border-radius:0;background:transparent;color:#262621!important;border-bottom:1px solid #222;padding:10px 0}.pro-minimal-hero{background:#f4f3ec;color:#252521;border-bottom:1px solid #d7d7cc}.pro-minimal-hero>.pro-wrap{padding-top:68px;padding-bottom:90px}.pro-minimal-meta{display:flex;justify-content:space-between;color:#727267;font-size:10px;letter-spacing:.16em}.pro-minimal-hero h1{font-weight:400;font-family:Georgia,serif;letter-spacing:-.072em;font-size:clamp(65px,10vw,153px);line-height:1.03;margin:100px 0 85px}.pro-minimal-hero h1 em{font-weight:400;font-style:italic;color:#8f8e82}.pro-minimal-bottom{display:flex;justify-content:space-between;align-items:end;gap:40px;border-top:1px solid #c9c8bf;padding-top:28px}.pro-minimal-bottom p{font-size:17px;max-width:450px;margin:0}.pro-minimal-bottom a{font-weight:750;font-size:11px;letter-spacing:.11em;white-space:nowrap}.pro-minimal-bottom a span{padding-left:25px}.pro-section-head h2{font-weight:400;font-size:clamp(40px,5vw,70px)}.pro-grid{gap:34px 20px}.pro-card{border:0;background:transparent;border-radius:0}.pro-card:hover{box-shadow:none}.pro-card-cover{height:310px;background:#eae9e1}.pro-card-body{padding:23px 0}.pro-card h3{font-family:Georgia,serif;font-size:27px;font-weight:400}.pro-art{background:linear-gradient(145deg,#deddd2,#ebeae5)}.pro-art-ring{border-color:#ffffff8a}.pro-art-center{color:#aba89b}.pro-card-link{border-color:#c7c6bf}.pro-statement{background:#e9e7dc}.pro-statement h2{font-family:Georgia,serif;font-weight:400;font-size:clamp(43px,6vw,83px)}.pro-statement .pro-text-link{color:#292a22}.pro-inner-hero{background:#f0efe8;border-bottom:1px solid #deddd3}.pro-inner-hero h1{font-family:Georgia,serif;font-weight:400;font-size:clamp(60px,9vw,117px)}.pro-article-hero{background:#eeede5}.pro-article-hero h1{font-family:Georgia,serif;font-weight:400}.pro-article-content{max-width:830px}.pro-product-summary h1{font-family:Georgia,serif;font-weight:400}.pro-footer{background:#242520}.pro-footer h2{font-family:Georgia,serif;font-size:40px;font-weight:400}.pro-end-cta{background:#282822}.pro-end-cta h2{font-family:Georgia,serif;font-weight:400}.pro-end-cta a{background:#fff;color:#242520!important}.pro-404 h1{font-family:Georgia,serif;font-weight:400;color:#8f8e82}.pro-dot{color:#a8a595} + +/* SiteForge V5 commercial signature */ +.pro-minimal-hero .pro-hero-art{background-image:url("./visual/hero.svg")!important;background-position:center;background-size:cover;} + +.pro-minimal-hero{background:#efeee8!important}.pro-minimal-hero .pro-wrap{background-image:url("./visual/hero.svg");background-repeat:no-repeat;background-size:48% auto;background-position:right 56%}.pro-minimal-hero h1{max-width:930px;position:relative;text-shadow:0 1px #ffffff70}.pro-card{border:0;border-bottom:1px solid #c8c7c0;background:transparent;border-radius:0}.pro-card-cover{background:#e7e5dc}.pro-art{background:linear-gradient(155deg,#e8e7e0,#c8c9bd);color:#585d55}.pro-card-body{padding-left:0;padding-right:0}.pro-featured{background:#faf9f5}.pro-section-head h2{font-weight:400}.pro-statement{border-block:1px solid #dddcd2;background:#f1efe7}.pro-footer{background:#22251e;color:#f6f4ec}.pro-button,.pro-header-cta{border-radius:0} +@media(max-width:700px){.pro-minimal-hero .pro-wrap{background-size:80% auto;background-position:center bottom;padding-bottom:250px}} diff --git a/examples/mobile-showcase/minimal/assets/pro.js b/examples/mobile-showcase/minimal/assets/pro.js new file mode 100644 index 0000000..9cf100d --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/pro.js @@ -0,0 +1,72 @@ +'use strict';(()=>{ + const menu=document.querySelector('[data-pro-menu]'); const nav=document.querySelector('#pro-navigation'); + if(menu&&nav){menu.addEventListener('click',()=>{const open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));nav.classList.toggle('is-open',open);menu.setAttribute('aria-label',open?'关闭导航':'打开导航');});} + // Drawer navigation. The same markup is used across the four professional themes. + const mobileNav=document.querySelector('#pro-navigation'); + let drawerBackdrop=null,drawerClose=null,returnFocus=null; + if(menu&&mobileNav){ + const originalParent=mobileNav.parentNode,originalNext=mobileNav.nextSibling; + const heading=document.createElement('div');heading.className='sf-drawer-header'; + const title=document.createElement('strong');title.textContent='网站导航'; + drawerClose=document.createElement('button');drawerClose.type='button';drawerClose.className='sf-drawer-close';drawerClose.textContent='×';drawerClose.setAttribute('aria-label','关闭网站导航'); + heading.append(title,drawerClose);mobileNav.prepend(heading); + drawerBackdrop=document.createElement('div');drawerBackdrop.className='sf-mobile-drawer-backdrop';drawerBackdrop.hidden=false;document.body.append(drawerBackdrop); + function setDrawer(open,focusBack=true){ + const isMobile=window.matchMedia('(max-width:1024px)').matches; + open=Boolean(open&&isMobile); + if(open){returnFocus=document.activeElement;document.body.append(mobileNav);} + else if(mobileNav.parentNode!==originalParent){if(originalNext&&originalNext.parentNode===originalParent)originalParent.insertBefore(mobileNav,originalNext);else originalParent.append(mobileNav);} + mobileNav.classList.toggle('is-open',open);drawerBackdrop.classList.toggle('is-open',open); + document.body.classList.toggle('sf-drawer-open',open); + menu.setAttribute('aria-expanded',String(open));menu.setAttribute('aria-label',open?'关闭导航':'打开导航'); + mobileNav.setAttribute('aria-hidden',String(!open&&isMobile)); + if('inert' in mobileNav)mobileNav.inert=!open&&isMobile; + if(open)drawerClose.focus(); + else if(focusBack&&returnFocus instanceof HTMLElement){returnFocus.focus();returnFocus=null;} + } + // Replace the old inline-expansion listener: use capture to stop the old listener. + menu.addEventListener('click',e=>{if(!window.matchMedia('(max-width:1024px)').matches)return;e.stopImmediatePropagation();setDrawer(!mobileNav.classList.contains('is-open'));},true); + drawerClose.addEventListener('click',()=>setDrawer(false)); + drawerBackdrop.addEventListener('click',()=>setDrawer(false)); + document.querySelectorAll('[data-mobile-open-menu]').forEach(b=>b.addEventListener('click',()=>setDrawer(true))); + mobileNav.addEventListener('click',e=>{if(e.target.closest('a'))setDrawer(false,false)}); + document.addEventListener('keydown',e=>{ + if(e.key==='Escape'&&mobileNav.classList.contains('is-open')){e.preventDefault();setDrawer(false);} + if(e.key!=='Tab'||!mobileNav.classList.contains('is-open'))return; + const els=[...mobileNav.querySelectorAll('button:not([disabled]),a[href]')].filter(el=>el.getClientRects().length&&!el.closest('[hidden]')); + if(!els.length)return;const first=els[0],last=els[els.length-1]; + if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();} + else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();} + }); + window.matchMedia('(max-width:1024px)').addEventListener('change',()=>setDrawer(false,false)); + if('inert' in mobileNav&&window.matchMedia('(max-width:1024px)').matches)mobileNav.inert=true; + // Do not strand catalogue links when the old mobile mega-button is hidden. + const megaLinks=document.querySelectorAll('[data-pro-mega] a'); + if(megaLinks.length){const wrap=document.createElement('div');wrap.className='sf-drawer-extra';const h=document.createElement('strong');h.textContent='更多分类与系列';wrap.append(h); + [...megaLinks].slice(0,20).forEach(a=>{const clone=a.cloneNode(true);wrap.append(clone);});mobileNav.append(wrap);} + } + const tabbar=document.querySelector('[data-mobile-tabs]'); + if(tabbar){tabbar.style.setProperty('--sf-mobile-tab-count',String(tabbar.children.length));} + const megaButton=document.querySelector('[data-pro-catalog]'), mega=document.querySelector('[data-pro-mega]'); + if(megaButton&&mega){function setMega(open){mega.hidden=!open;mega.classList.toggle('is-open',open);megaButton.setAttribute('aria-expanded',String(open));} + megaButton.addEventListener('click',()=>setMega(mega.hidden)); + document.addEventListener('keydown',e=>{if(e.key==='Escape')setMega(false);}); + document.addEventListener('click',e=>{if(!mega.hidden&&!mega.contains(e.target)&&!megaButton.contains(e.target))setMega(false);}); + } + document.querySelectorAll('.pro-nav-disclose').forEach(button=>{button.addEventListener('click',()=>{let panel=button.parentElement.querySelector('.pro-nav-children');let visible=button.getAttribute('aria-expanded')==='true';button.setAttribute('aria-expanded',String(!visible));panel.hidden=visible;});}); + document.querySelectorAll('.pro-gallery-thumbs').forEach(container=>{const main=container.parentElement.querySelector('.pro-product-media img');const buttons=[...container.querySelectorAll('[data-gallery-image]')]; + buttons.forEach(b=>{b.addEventListener('click',()=>{buttons.forEach(x=>x.setAttribute('aria-pressed',String(x===b)));if(main){main.src=b.dataset.galleryImage;main.alt=b.querySelector('img')?.alt||'';}});}); + if(!main)return;main.tabIndex=0;main.style.cursor='zoom-in';const open=()=>{const pane=document.createElement('div');pane.className='pro-gallery-lightbox';pane.setAttribute('role','dialog');pane.setAttribute('aria-label','产品大图预览');let img=document.createElement('img');img.src=main.src;img.alt=main.alt;const close=document.createElement('button');close.type='button';close.textContent='关闭 ×';pane.append(img,close);document.body.append(pane);const done=()=>{pane.remove();document.removeEventListener('keydown',esc);main.focus();};const esc=e=>{if(e.key==='Escape')done();};document.addEventListener('keydown',esc);close.addEventListener('click',done);pane.addEventListener('click',e=>{if(e.target===pane)done();});close.focus();};main.addEventListener('click',open);main.addEventListener('keydown',e=>{if(e.key==='Enter')open();}); + }); + document.querySelectorAll('.pro-filter-scope').forEach(scope=>{ + const panel=scope.previousElementSibling;if(!panel||!panel.classList.contains('pro-filter-panel'))return; + const cards=Array.from(scope.querySelectorAll('.pro-card')); + const blank=document.createElement('div');blank.className='pro-filter-empty';blank.hidden=true;blank.textContent='没有找到符合条件的内容，请调整关键词或筛选条件。';scope.append(blank); + const q=panel.querySelector('[data-pro-filter-search]'),b=panel.querySelector('[data-pro-filter-brand]'),c=panel.querySelector('[data-pro-filter-category]'),count=panel.querySelector('[data-pro-filter-count]'); + function options(sel,key){const vals=[...new Set(cards.map(x=>x.dataset[key]||'').filter(Boolean))].sort();vals.forEach(x=>sel.add(new Option(x,x)));if(!vals.length)sel.closest('label').hidden=true;} + options(b,'brand');options(c,'category'); + function run(){const str=q.value.trim().toLocaleLowerCase();let visible=0; + cards.forEach(el=>{const hit=el.textContent.toLocaleLowerCase().includes(str)&&(!b.value||el.dataset.brand===b.value)&&(!c.value||el.dataset.category===c.value);el.hidden=!hit;visible+=Number(hit);});count.textContent=`共 ${visible} 条`;blank.hidden=visible!==0;} + [q,b,c].forEach(x=>x.addEventListener(x===q?'input':'change',run));run(); + }); +})(); diff --git a/examples/mobile-showcase/minimal/assets/search-index.json b/examples/mobile-showcase/minimal/assets/search-index.json new file mode 100644 index 0000000..0637a08 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/search-index.json @@ -0,0 +1 @@ +[] \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/assets/site-runtime.js b/examples/mobile-showcase/minimal/assets/site-runtime.js new file mode 100644 index 0000000..e4715e8 --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/site-runtime.js @@ -0,0 +1,31 @@ +'use strict'; +(()=>{ + const $=s=>document.querySelector(s), $$=s=>[...document.querySelectorAll(s)]; + const menu=$('.sf-menu-toggle');if(menu){menu.addEventListener('click',()=>{let open=menu.getAttribute('aria-expanded')!=='true';menu.setAttribute('aria-expanded',String(open));$('#sf-primary-links')?.classList.toggle('is-open',open);});} + // Filter actual static content cards, no API is needed at runtime. + $$('.sf-collection').forEach(grid=>{ + const cards=$$('.sf-item',grid); + if(cards.length<2)return; + const toolbar=document.createElement('div');toolbar.className='sf-filters'; + const search=document.createElement('input');search.type='search';search.placeholder='筛选当前列表';search.setAttribute('aria-label','筛选当前列表'); + const status=document.createElement('span');status.setAttribute('aria-live','polite');status.style.fontSize='12px'; + const brand=document.createElement('select');brand.setAttribute('aria-label','按品牌筛选'); + const category=document.createElement('select');category.setAttribute('aria-label','按分类筛选'); + function fill(el,field,all){el.append(new Option(all,''));const vals=[...new Set(cards.map(x=>x.dataset[field]||'').filter(Boolean))].sort();vals.forEach(v=>el.append(new Option(v,v)));if(!vals.length)el.hidden=true;} + fill(brand,'brand','全部品牌');fill(category,'category','全部分类'); + toolbar.append(search,brand,category,status);grid.parentNode.insertBefore(toolbar,grid); + function apply(){let val=search.value.trim().toLocaleLowerCase();let visible=0;cards.forEach(card=>{let hit=card.textContent.toLocaleLowerCase().includes(val)&&(!brand.value||card.dataset.brand===brand.value)&&(!category.value||card.dataset.category===category.value);card.hidden=!hit;if(hit)visible++;});status.textContent=`共 ${visible} 项`;} + search.addEventListener('input',apply);brand.addEventListener('change',apply);category.addEventListener('change',apply);apply(); + }); + const input=$('#sf-search'),root=$('#sf-search-results'),count=$('#sf-search-count'); + if(input&&root){ + let data=[];const params=new URLSearchParams(location.search);input.value=params.get('q')||''; + let debounce=null; + const render=()=>{let q=input.value.trim().toLocaleLowerCase();let found=q?data.filter(d=>`${d.title} ${d.summary} ${d.brand} ${d.type}`.toLocaleLowerCase().includes(q)).slice(0,100):data.slice(0,30); + root.replaceChildren();count.textContent=`${found.length} 条结果${!q?'（显示前30条）':''}`; + found.forEach(d=>{let article=document.createElement('article'),a=document.createElement('a'),small=document.createElement('small'),p=document.createElement('p');article.className='sf-search-result';a.textContent=d.title;a.href=d.url.replace(/^\//,'');small.textContent=d.type;p.textContent=d.summary;article.append(a,small,p);root.append(article);}); + };const base=document.querySelector('base')?.href||location.href; + fetch(new URL('search-index.json',base)).then(r=>{if(!r.ok)throw Error('index unavailable');return r.json();}).then(v=>{data=v;render()}).catch(()=>{count.textContent='搜索索引加载失败，请检查站点文件部署路径';}); + input.addEventListener('input',()=>{clearTimeout(debounce);debounce=setTimeout(render,100)}); + } +})(); diff --git a/examples/mobile-showcase/minimal/assets/theme.css b/examples/mobile-showcase/minimal/assets/theme.css new file mode 100644 index 0000000..1547baa --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/theme.css @@ -0,0 +1 @@ +*{box-sizing:border-box}body{margin:0;color:#171717;background:#faf9f6;font:16px/1.6 Arial,Helvetica,sans-serif}a{color:inherit;text-decoration:none}.container{width:min(1260px,90%);margin:auto}.header{height:110px;display:flex;align-items:center;justify-content:space-between;gap:20px;border-bottom:1px solid #cccac4}.brand{font-family:Georgia,"Times New Roman",serif;font-size:30px;font-weight:bold;letter-spacing:-1px}.brand span{font-size:12px;vertical-align:top}.header nav{display:flex;gap:33px;font-size:12px;flex-wrap:wrap}.header nav a:hover{text-decoration:underline}.contact{font-size:12px;font-weight:bold;border-bottom:1px solid black;padding-bottom:5px}.hero{padding:48px 0 0}.topline{display:flex;justify-content:space-between;font-size:10px;letter-spacing:2.3px;font-weight:bold}.hero h1,.inner-hero h1{font-family:Georgia,"Times New Roman",serif;font-size:clamp(65px,9.1vw,155px);line-height:1;letter-spacing:-8px;font-weight:400;margin:85px 0 40px}.hero-bottom{display:flex;justify-content:space-between;align-items:end;margin:35px 0 64px;gap:25px}.hero-bottom p{font-size:18px;max-width:490px;margin:0}.hero-bottom a{font-size:12px;letter-spacing:1.5px;border-bottom:1px solid black;padding-bottom:8px}.hero-image{height:425px;background:#deddd4;overflow:hidden;position:relative;display:flex;align-items:center;justify-content:center}.hero-image img{height:100%;width:100%;object-fit:cover}.graphic{background:#cec8bc}.shape{position:absolute;border-radius:50%;background:linear-gradient(125deg,#ede9e1,#98918a);box-shadow:25px 30px 40px #59544c22}.shape.a{height:550px;width:550px;left:5%;top:-230px}.shape.b{width:280px;height:280px;right:15%;bottom:-120px;background:#989e97}.shape.c{width:160px;height:160px;right:40%;top:0;background:#ece9e3}.graphic>span{position:relative;font-size:25px;letter-spacing:7px;font-weight:500;line-height:1.5}.inner-hero{padding:80px 0;border-bottom:1px solid #d3d0ca}.inner-hero h1{font-size:clamp(48px,8vw,115px);margin:40px 0}.inner-hero p{font-size:18px;color:#777;max-width:660px}.content{padding:70px 0 130px}.list-head{display:grid;grid-template-columns:1fr 2fr;align-items:center;margin:30px 0 40px;border-bottom:1px solid black}.list-head span{font-size:10px;letter-spacing:2px}.list-head h2{font-family:Georgia,serif;font-weight:400;font-size:54px;letter-spacing:-2px}.list{display:grid;grid-template-columns:repeat(2,1fr);gap:80px 35px}.item{display:block}.item:hover h3{text-decoration:underline}.thumb{height:290px;background:#e3e1d8;display:grid;place-items:center}.thumb img{width:100%;height:100%;object-fit:contain}.thumb span{font-family:Georgia,serif;font-size:140px;color:#c0bcb2}.info{padding:25px 0}.info>span{font-size:10px;letter-spacing:1.5px}.info h3{font-family:Georgia,serif;font-size:36px;font-weight:400;margin:12px 0}.info p{color:#666;max-width:400px}.info b{font-size:11px;letter-spacing:1px}.rich-content{margin:25px 0}.section{padding:45px 0}.block-hero{padding:50px 0}.block-hero h1{font-family:Georgia,serif;font-size:60px;font-weight:400}.feature-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:30px}.feature{border-top:1px solid #8f8a84;padding-top:20px}.feature-mark{font-size:12px}.stats{display:grid;grid-template-columns:repeat(4,1fr)}.stat strong{font-family:Georgia,serif;display:block;font-size:47px;font-weight:400}.stat span{font-size:11px;letter-spacing:1px}.cta{padding:55px;background:#e4e0d8}.cta h2{font-family:Georgia,serif;font-weight:400;font-size:44px}.btn{display:inline-block;background:#222;color:white;padding:13px 20px;font-size:12px}.detail-img img{max-width:100%;max-height:550px}footer{border-top:1px solid #b9b5ae;padding:70px 0 25px}.footer-lead{font-family:Georgia,serif;font-size:clamp(45px,6vw,90px);line-height:1.05;letter-spacing:-4px}.footer-lead span{color:#909084}.footer-bottom{display:flex;justify-content:space-between;border-top:1px solid #d5d1c9;margin-top:90px;padding-top:25px;font-size:11px;color:#777}@media(max-width:850px){.header{height:auto;padding:26px 0;flex-wrap:wrap}.header nav{order:3;width:100%}.hero h1{letter-spacing:-4px;margin-top:60px}.hero-image{height:320px}.list{gap:35px}.list-head{grid-template-columns:1fr}.footer-lead{letter-spacing:-2px}}@media(max-width:560px){.list,.feature-grid,.stats{grid-template-columns:1fr}.hero h1{font-size:67px}.hero-bottom,.topline,.footer-bottom{flex-direction:column;align-items:start;gap:15px}.hero-image{height:240px}.list-head h2{font-size:40px}.inner-hero{padding:50px 0}} diff --git a/examples/mobile-showcase/minimal/assets/visual/hero.svg b/examples/mobile-showcase/minimal/assets/visual/hero.svg new file mode 100644 index 0000000..f43879d --- /dev/null +++ b/examples/mobile-showcase/minimal/assets/visual/hero.svg @@ -0,0 +1 @@ +STUDIES IN FORM diff --git a/examples/mobile-showcase/minimal/index.html b/examples/mobile-showcase/minimal/index.html new file mode 100644 index 0000000..08b160c --- /dev/null +++ b/examples/mobile-showcase/minimal/index.html @@ -0,0 +1,23 @@ +精选产品跳转至正文 + + +
联系我们 ↗
+
INDEPENDENT / CREATIVE / CONSIDEREDNO. 001 — ESTABLISH A PRESENCE

精选产品
MAKE IT MATTER.

简单而精致的产品体验

EXPLORE WORK ↗
+
01 / INDEX

精选展示

浏览全部 ↗
+ +
+
标准CASE
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+
02 / ABOUT

少一点噪音，多一点重点。

简单而精致的产品体验

READ OUR STORY ↗
+ +
+
LET'S CONNECT

从这里开始下一步。

简单而精致的产品体验

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/listing.html b/examples/mobile-showcase/minimal/listing.html new file mode 100644 index 0000000..6bb15f3 --- /dev/null +++ b/examples/mobile-showcase/minimal/listing.html @@ -0,0 +1,22 @@ +全部产品跳转至正文 + + +
联系我们 ↗
+
DISCOVER / COLLECTION

全部产品

分类查看产品与解决方案

首页／全部产品
+
+ +
+
标准CATALOG
+
+
EXAMPLE01
+

标准系列产品

面向全球客户的精选示范产品

查看详情
+ +
+ +
+
LET'S CONNECT

从这里开始下一步。

简单而精致的产品体验

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/mobile-showcase/minimal/product.html b/examples/mobile-showcase/minimal/product.html new file mode 100644 index 0000000..4a596f1 --- /dev/null +++ b/examples/mobile-showcase/minimal/product.html @@ -0,0 +1,17 @@ +标准系列产品跳转至正文 + + +
联系我们 ↗
+
首页／产品中心／标准系列产品
+
+
标准PRODUCT
+
PRODUCT DETAILS / EXAMPLE

标准系列产品

面向全球客户的精选示范产品

品牌 · EXAMPLE

咨询该产品 ↗
+
OVERVIEW

产品介绍

规格、优势与适用场景的示例描述。

SPECIFICATIONS

规格参数

Capacity可定制
Material高品质
+ +
+
LET'S CONNECT

从这里开始下一步。

简单而精致的产品体验

联系我们 ↗
+ + + + \ No newline at end of file diff --git a/examples/old_urls.example.txt b/examples/old_urls.example.txt new file mode 100644 index 0000000..c941329 --- /dev/null +++ b/examples/old_urls.example.txt @@ -0,0 +1,6 @@ +# 从旧站 sitemap / WordPress 页面导出的相对路径，保留大小写和尾斜杠 +/ +/about/ +/products/ +/pickup-truck/ +/contact/ diff --git a/fixtures/v820/wordPress-complex-sample.xml b/fixtures/v820/wordPress-complex-sample.xml new file mode 100644 index 0000000..fcb3776 --- /dev/null +++ b/fixtures/v820/wordPress-complex-sample.xml @@ -0,0 +1,13 @@ + + +Abouthttps://old.example.org/about/101pagepublishAbout us

]]> +_featuresfield_parent +features2 +_features_0_namefield_name +features_0_nameLogistics +_features_1_namefield_name +features_1_nameOverseas delivery + +Contacthttps://old.example.org/contact/102pagepublish +Legacy dynamichttps://old.example.org/?p=103103postpublish + diff --git a/integrations/art-design-pro/README.md b/integrations/art-design-pro/README.md index a62db44..bcb5a54 100644 --- a/integrations/art-design-pro/README.md +++ b/integrations/art-design-pro/README.md @@ -1,28 +1,14 @@ -# Art Design Pro 官方工程对接（可执行安装器） +# SiteForge V8.19 → Art Design Pro 集成模块 -SiteForge V2 随包提供三个 Vue 3 + Element Plus 业务页面：`WebsiteFactory.vue`、`ThemeCenter.vue`、`EnterpriseCenter.vue`。 +当前交付包含 9 个 Vue 业务页面（含新工作台和内容管理）、共享请求/会话工具 `_shared.ts`、正式单一导航树安装器，以及 FastAPI 授权菜单 `/api/console/bootstrap`。**未包含 Art Design Pro 官方完整源代码及依赖**，故不能直接执行 Art 的正式 `pnpm build`。 -> **重要：** 由于本次代码执行环境无法访问 GitHub 与 npm，无法直接打包或编译 Art Design Pro 官方完整仓库。以下对接脚本已实现源码复制和路由注册逻辑，但尚未针对官方实际项目执行 `pnpm build`。默认可运行的 `/factory-studio` Web 管理台不依赖这些文件。 +正式接入说明、所需反向代理和权限边界见 [`docs/V8_19_ART_UNIFIED_BACKEND.md`](../../docs/V8_19_ART_UNIFIED_BACKEND.md)。所有后台写操作由 SiteForge FastAPI 服务端会话、CSRF、站点角色权限控制；Art 演示登录/菜单不能代替服务端授权。官方项目从 按适用许可证获取。 -## 在联网设备对接 +快速验证： -1. 依官方文档克隆 `https://github.com/Daymychen/art-design-pro`，使用符合要求的 Node 版本和 pnpm。 -2. 在 SiteForge 根目录执行： - - ```bash - python scripts/install_into_art_design_pro.py /path/to/art-design-pro - python scripts/install_into_art_design_pro.py /path/to/art-design-pro --apply - ``` - -3. 使用同域反向代理： - - - Art 前端 `/` 为网站工厂管理 UI - - `/api` → SiteForge FastAPI - - `/editor`、`/preview`、`/ui`、`/local-media`、`/login`、`/factory-studio` → SiteForge FastAPI - -4. 在 Art 工程目录执行 `pnpm install && pnpm build`，访问 `/siteforge/factory`、`/siteforge/themes`、`/siteforge/enterprise`。 -5. SiteForge API 仍使用自己的服务端 Session、CSRF、站点级 RBAC；前端的隐藏菜单不构成授权。`/api/auth/me` 必须在同一 Cookie 域名可访问。正式发布需统一登录体验，并补齐 Art 当前版本的路由/权限约定。 - -安装脚本不会覆盖已有配置而不备份：原 `asyncRoutes.ts` 会先保存 `.ts.siteforge-backup`，同名 Vue 文件另存 `.vue.siteforge-backup`。重复执行不会重复插入路由。 - -官方路由结构和本项目的适配规则以 [Art Design Pro 官方路由文档](https://www.artd.pro/docs/zh/guide/essentials/route.html) 为准。 +```bash +python scripts/install_into_art_design_pro.py /path/to/art-design-pro +python scripts/install_into_art_design_pro.py /path/to/art-design-pro --apply +python scripts/verify_art_design_pro_v819.py /path/to/art-design-pro +# 官方源码依赖安装后，才可额外执行 --build +``` diff --git a/integrations/art-design-pro/src/views/siteforge/ConsoleHome.vue b/integrations/art-design-pro/src/views/siteforge/ConsoleHome.vue new file mode 100644 index 0000000..0a7817f --- /dev/null +++ b/integrations/art-design-pro/src/views/siteforge/ConsoleHome.vue @@ -0,0 +1,34 @@ + + + diff --git a/integrations/art-design-pro/src/views/siteforge/ContentCenter.vue b/integrations/art-design-pro/src/views/siteforge/ContentCenter.vue new file mode 100644 index 0000000..6352816 --- /dev/null +++ b/integrations/art-design-pro/src/views/siteforge/ContentCenter.vue @@ -0,0 +1,40 @@ + + + diff --git a/integrations/art-design-pro/src/views/siteforge/EnterpriseCenter.vue b/integrations/art-design-pro/src/views/siteforge/EnterpriseCenter.vue index facef24..68af114 100644 --- a/integrations/art-design-pro/src/views/siteforge/EnterpriseCenter.vue +++ b/integrations/art-design-pro/src/views/siteforge/EnterpriseCenter.vue @@ -11,21 +11,23 @@ diff --git a/integrations/art-design-pro/src/views/siteforge/ReleaseCenter.vue b/integrations/art-design-pro/src/views/siteforge/ReleaseCenter.vue index 3e3836e..ab90511 100644 --- a/integrations/art-design-pro/src/views/siteforge/ReleaseCenter.vue +++ b/integrations/art-design-pro/src/views/siteforge/ReleaseCenter.vue @@ -4,15 +4,17 @@ diff --git a/integrations/art-design-pro/src/views/siteforge/ThemeCenter.vue b/integrations/art-design-pro/src/views/siteforge/ThemeCenter.vue index e437650..16acd8f 100644 --- a/integrations/art-design-pro/src/views/siteforge/ThemeCenter.vue +++ b/integrations/art-design-pro/src/views/siteforge/ThemeCenter.vue @@ -10,23 +10,21 @@ diff --git a/integrations/art-design-pro/src/views/siteforge/VisualEditor.vue b/integrations/art-design-pro/src/views/siteforge/VisualEditor.vue index c0a6574..3580601 100644 --- a/integrations/art-design-pro/src/views/siteforge/VisualEditor.vue +++ b/integrations/art-design-pro/src/views/siteforge/VisualEditor.vue @@ -13,15 +13,17 @@
SiteForge Enterprise · 8.21.3-dev.1

四套主题移动端与抽屉导航验收

真实源码集成版 · 自动化测试与离线 Chromium 实测 · 2026-10-23

Python 全量回归
346
41 个测试模块 · 0 失败
四套内置主题
4/4
抽屉菜单和可选底部 Tabs 通过
手机布局组合
48
4 主题 × 4 页面类型 × 3 宽度

主题及布局检查

主题页面类型手机宽度水平溢出结果
汽车主题4 类页面375 / 390 / 430px0px通过
建材主题4 类页面375 / 390 / 430px0px通过
企业主题4 类页面375 / 390 / 430px0px通过
简约主题4 类页面375 / 390 / 430px0px通过

交互逻辑

汽车主题移动端示意截图
  • 手机右侧抽屉导航，多级目录可展开；支持遮罩、关闭按钮、Esc、焦点返回与滚动锁定。
  • 手机底部 Tabs 默认关闭；可以从后台添加 1–5 个入口，并编辑文字、图标、顺序、链接。
  • 可配置站内页面、HTTPS（WhatsApp 等）、拨号、邮箱，或“打开导航菜单”操作。
  • 桌面版不显示手机底栏；已有导航和页脚保留。
  • 配置先保存草稿，发布后在下一次静态构建中生效，不直接更新线上站点。

打开四套主题离线互动预览 · 分批回归原始报告

验收限制

Chromium 通过 page.set_content 对真实 HTML、CSS、JavaScript 模板离线渲染，以适配运行环境对 file:// 和 localhost 导航的限制；图片使用示例数据。并非真实线上网站、CDN、iOS Safari 或 Android 真机验收。

本次覆盖四套内置专业主题的四种代表性页面，不代表所有页面、所有设备或额外安装的第三方主题均已逐一审核。Art Design Pro 官方工程和 PostgreSQL/Redis 生产验收仍需独立完成。

技术文档：docs/V8_21_3_MOBILE_THEMES.md；原始浏览器日志：reports/mobile-v8213-browser.json。

\ No newline at end of file diff --git a/reports/V8_21_3_移动端验收总览.md b/reports/V8_21_3_移动端验收总览.md new file mode 100644 index 0000000..d204c15 --- /dev/null +++ b/reports/V8_21_3_移动端验收总览.md @@ -0,0 +1,10 @@ +# SiteForge V8.21.3 移动端四套主题验收报告 + +- 版本：8.21.3-dev.1 +- 全量回归：346 项通过 / 41 模块，11 个隔离批次，0 失败 +- Chromium：汽车、建材、企业、简约四主题抽屉和 Tabs 实测通过，0 JS 错误 +- 布局：4 套主题 × 4 页面类型 × 3 手机宽度 = 48 组合，0px 横向溢出 +- HTTP/Worker：登录、CSRF、建站、构建、ZIP、预览通过 +- 真实 iOS/Android、域名部署、第三方主题、正式 Art/PG/Redis 未验收 + +详见 docs/V8_21_3_MOBILE_THEMES.md 和 reports/v8213-final-regression.json。 diff --git a/reports/mobile-v8213-automotive.png b/reports/mobile-v8213-automotive.png new file mode 100644 index 0000000..9ef17a1 Binary files /dev/null and b/reports/mobile-v8213-automotive.png differ diff --git a/reports/mobile-v8213-browser.json b/reports/mobile-v8213-browser.json new file mode 100644 index 0000000..f8450b6 --- /dev/null +++ b/reports/mobile-v8213-browser.json @@ -0,0 +1,38 @@ +[ + { + "theme": "automotive", + "drawer": "PASS", + "tabs": "PASS", + "responsive": "PASS", + "mobile_horizontal_overflow_px": 0, + "page_types_tested": 4, + "javascript_errors": 0 + }, + { + "theme": "industrial", + "drawer": "PASS", + "tabs": "PASS", + "responsive": "PASS", + "mobile_horizontal_overflow_px": 0, + "page_types_tested": 4, + "javascript_errors": 0 + }, + { + "theme": "corporate", + "drawer": "PASS", + "tabs": "PASS", + "responsive": "PASS", + "mobile_horizontal_overflow_px": 0, + "page_types_tested": 4, + "javascript_errors": 0 + }, + { + "theme": "minimal", + "drawer": "PASS", + "tabs": "PASS", + "responsive": "PASS", + "mobile_horizontal_overflow_px": 0, + "page_types_tested": 4, + "javascript_errors": 0 + } +] \ No newline at end of file diff --git a/reports/v8213-final-regression.html b/reports/v8213-final-regression.html new file mode 100644 index 0000000..842ff22 --- /dev/null +++ b/reports/v8213-final-regression.html @@ -0,0 +1 @@ +V8.21 回归报告

SiteForge V8.21 回归验收

PASS

每轮 346 项自动化测试 · 1 轮 · 无外部环境实测保证

批次结果通过秒数
round1-batch1PASS435.12
round1-batch2PASS226.14
round1-batch3PASS509.34
round1-batch4PASS284.66
round1-batch5PASS296.06
round1-batch6PASS254.44
round1-batch7PASS518.35
round1-batch8PASS183.31
round1-batch9PASS296.98
round1-batch10PASS416.22
round1-batch11PASS103.31

请参阅 JSON、Markdown 和原始测试日志。真实客户站点迁移仍需专项验收。

\ No newline at end of file diff --git a/reports/v8213-final-regression.json b/reports/v8213-final-regression.json new file mode 100644 index 0000000..6918765 --- /dev/null +++ b/reports/v8213-final-regression.json @@ -0,0 +1,163 @@ +{ + "version": "8.21.3-dev.1", + "generated_at": "2026-10-23T03:23:52.298283+00:00", + "status": "PASS", + "test_modules": 41, + "repeats": 1, + "tests_per_round": 346, + "total_passes": 346, + "batches": [ + { + "status": "PASS", + "passed": 43, + "duration_seconds": 5.12, + "exit_code": 0, + "name": "round1-batch1", + "modules": [ + "tests/test_commercial_v5.py", + "tests/test_connectors_v84.py", + "tests/test_connectors_v85.py", + "tests/test_console_v819.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch1.log" + }, + { + "status": "PASS", + "passed": 22, + "duration_seconds": 6.14, + "exit_code": 0, + "name": "round1-batch2", + "modules": [ + "tests/test_core_v4.py", + "tests/test_editor_easy_v8212.py", + "tests/test_editor_ux_v8211.py", + "tests/test_enterprise.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch2.log" + }, + { + "status": "PASS", + "passed": 50, + "duration_seconds": 9.34, + "exit_code": 0, + "name": "round1-batch3", + "modules": [ + "tests/test_enterprise_v7.py", + "tests/test_factory.py", + "tests/test_factory_v2.py", + "tests/test_mobile_tabs_v8213.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch3.log" + }, + { + "status": "PASS", + "passed": 28, + "duration_seconds": 4.66, + "exit_code": 0, + "name": "round1-batch4", + "modules": [ + "tests/test_multilingual_v815.py", + "tests/test_p0_71.py", + "tests/test_p0_backup.py", + "tests/test_p0_p4_completion_v88.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch4.log" + }, + { + "status": "PASS", + "passed": 29, + "duration_seconds": 6.06, + "exit_code": 0, + "name": "round1-batch5", + "modules": [ + "tests/test_p0_p4_completion_v89.py", + "tests/test_p1_platform.py", + "tests/test_production_v816.py", + "tests/test_professional_ui_v811.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch5.log" + }, + { + "status": "PASS", + "passed": 25, + "duration_seconds": 4.44, + "exit_code": 0, + "name": "round1-batch6", + "modules": [ + "tests/test_regression_runner_v817.py", + "tests/test_release_native_v814.py", + "tests/test_release_reviews_v7.py", + "tests/test_release_v813.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch6.log" + }, + { + "status": "PASS", + "passed": 51, + "duration_seconds": 8.35, + "exit_code": 0, + "name": "round1-batch7", + "modules": [ + "tests/test_site_design_v87.py", + "tests/test_siteforge_v817_audit.py", + "tests/test_studio_v86.py", + "tests/test_theme_pro_v3.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch7.log" + }, + { + "status": "PASS", + "passed": 18, + "duration_seconds": 3.31, + "exit_code": 0, + "name": "round1-batch8", + "modules": [ + "tests/test_v818_pg_recovery.py", + "tests/test_v818_sqlite_pg_transfer.py", + "tests/test_v821_editor_history_and_mapping.py", + "tests/test_v8_art_installer.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch8.log" + }, + { + "status": "PASS", + "passed": 29, + "duration_seconds": 6.98, + "exit_code": 0, + "name": "round1-batch9", + "modules": [ + "tests/test_v8_workflows.py", + "tests/test_wordpress_baseline.py", + "tests/test_worker_queue_v6.py", + "tests/test_workspace_v810.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch9.log" + }, + { + "status": "PASS", + "passed": 41, + "duration_seconds": 6.22, + "exit_code": 0, + "name": "round1-batch10", + "modules": [ + "tests/test_workspace_v812.py", + "tests/test_wp_complex_v820.py", + "tests/test_wp_migration_v81.py", + "tests/test_wp_migration_v82.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch10.log" + }, + { + "status": "PASS", + "passed": 10, + "duration_seconds": 3.31, + "exit_code": 0, + "name": "round1-batch11", + "modules": [ + "tests/test_wp_migration_v83.py" + ], + "log": "reports/v8213-final-regression_logs/round1-batch11.log" + } + ], + "environment_note": "pytest local fixtures only; Docker/PG/Redis/browser/real WordPress not inferred as passed." +} \ No newline at end of file diff --git a/reports/v8213-final-regression.md b/reports/v8213-final-regression.md new file mode 100644 index 0000000..16cd740 --- /dev/null +++ b/reports/v8213-final-regression.md @@ -0,0 +1,19 @@ +# SiteForge V8.21 完整自动化回归 + +**PASS** — 41 模块 / 346 项每轮 / 1 轮 + +| 批次 | 结果 | 通过用例 | 耗时 | 日志 | +|---|---|---:|---:|---| +| round1-batch1 | PASS | 43 | 5.12 秒 | reports/v8213-final-regression_logs/round1-batch1.log | +| round1-batch2 | PASS | 22 | 6.14 秒 | reports/v8213-final-regression_logs/round1-batch2.log | +| round1-batch3 | PASS | 50 | 9.34 秒 | reports/v8213-final-regression_logs/round1-batch3.log | +| round1-batch4 | PASS | 28 | 4.66 秒 | reports/v8213-final-regression_logs/round1-batch4.log | +| round1-batch5 | PASS | 29 | 6.06 秒 | reports/v8213-final-regression_logs/round1-batch5.log | +| round1-batch6 | PASS | 25 | 4.44 秒 | reports/v8213-final-regression_logs/round1-batch6.log | +| round1-batch7 | PASS | 51 | 8.35 秒 | reports/v8213-final-regression_logs/round1-batch7.log | +| round1-batch8 | PASS | 18 | 3.31 秒 | reports/v8213-final-regression_logs/round1-batch8.log | +| round1-batch9 | PASS | 29 | 6.98 秒 | reports/v8213-final-regression_logs/round1-batch9.log | +| round1-batch10 | PASS | 41 | 6.22 秒 | reports/v8213-final-regression_logs/round1-batch10.log | +| round1-batch11 | PASS | 10 | 3.31 秒 | reports/v8213-final-regression_logs/round1-batch11.log | + +真实部署与外部服务另行验收。 diff --git a/reports/v8213-regression.html b/reports/v8213-regression.html new file mode 100644 index 0000000..45c6950 --- /dev/null +++ b/reports/v8213-regression.html @@ -0,0 +1 @@ +V8.21 回归报告

SiteForge V8.21 回归验收

PASS

每轮 345 项自动化测试 · 1 轮 · 无外部环境实测保证

批次结果通过秒数
round1-batch1PASS435.03
round1-batch2PASS226.43
round1-batch3PASS498.64
round1-batch4PASS284.91
round1-batch5PASS295.82
round1-batch6PASS254.51
round1-batch7PASS518.36
round1-batch8PASS183.14
round1-batch9PASS296.99
round1-batch10PASS416.29
round1-batch11PASS103.12

请参阅 JSON、Markdown 和原始测试日志。真实客户站点迁移仍需专项验收。

\ No newline at end of file diff --git a/reports/v8213-regression.json b/reports/v8213-regression.json new file mode 100644 index 0000000..bc86e35 --- /dev/null +++ b/reports/v8213-regression.json @@ -0,0 +1,163 @@ +{ + "version": "8.21.3-dev.1", + "generated_at": "2026-10-23T03:21:40.077265+00:00", + "status": "PASS", + "test_modules": 41, + "repeats": 1, + "tests_per_round": 345, + "total_passes": 345, + "batches": [ + { + "status": "PASS", + "passed": 43, + "duration_seconds": 5.03, + "exit_code": 0, + "name": "round1-batch1", + "modules": [ + "tests/test_commercial_v5.py", + "tests/test_connectors_v84.py", + "tests/test_connectors_v85.py", + "tests/test_console_v819.py" + ], + "log": "reports/v8213-regression_logs/round1-batch1.log" + }, + { + "status": "PASS", + "passed": 22, + "duration_seconds": 6.43, + "exit_code": 0, + "name": "round1-batch2", + "modules": [ + "tests/test_core_v4.py", + "tests/test_editor_easy_v8212.py", + "tests/test_editor_ux_v8211.py", + "tests/test_enterprise.py" + ], + "log": "reports/v8213-regression_logs/round1-batch2.log" + }, + { + "status": "PASS", + "passed": 49, + "duration_seconds": 8.64, + "exit_code": 0, + "name": "round1-batch3", + "modules": [ + "tests/test_enterprise_v7.py", + "tests/test_factory.py", + "tests/test_factory_v2.py", + "tests/test_mobile_tabs_v8213.py" + ], + "log": "reports/v8213-regression_logs/round1-batch3.log" + }, + { + "status": "PASS", + "passed": 28, + "duration_seconds": 4.91, + "exit_code": 0, + "name": "round1-batch4", + "modules": [ + "tests/test_multilingual_v815.py", + "tests/test_p0_71.py", + "tests/test_p0_backup.py", + "tests/test_p0_p4_completion_v88.py" + ], + "log": "reports/v8213-regression_logs/round1-batch4.log" + }, + { + "status": "PASS", + "passed": 29, + "duration_seconds": 5.82, + "exit_code": 0, + "name": "round1-batch5", + "modules": [ + "tests/test_p0_p4_completion_v89.py", + "tests/test_p1_platform.py", + "tests/test_production_v816.py", + "tests/test_professional_ui_v811.py" + ], + "log": "reports/v8213-regression_logs/round1-batch5.log" + }, + { + "status": "PASS", + "passed": 25, + "duration_seconds": 4.51, + "exit_code": 0, + "name": "round1-batch6", + "modules": [ + "tests/test_regression_runner_v817.py", + "tests/test_release_native_v814.py", + "tests/test_release_reviews_v7.py", + "tests/test_release_v813.py" + ], + "log": "reports/v8213-regression_logs/round1-batch6.log" + }, + { + "status": "PASS", + "passed": 51, + "duration_seconds": 8.36, + "exit_code": 0, + "name": "round1-batch7", + "modules": [ + "tests/test_site_design_v87.py", + "tests/test_siteforge_v817_audit.py", + "tests/test_studio_v86.py", + "tests/test_theme_pro_v3.py" + ], + "log": "reports/v8213-regression_logs/round1-batch7.log" + }, + { + "status": "PASS", + "passed": 18, + "duration_seconds": 3.14, + "exit_code": 0, + "name": "round1-batch8", + "modules": [ + "tests/test_v818_pg_recovery.py", + "tests/test_v818_sqlite_pg_transfer.py", + "tests/test_v821_editor_history_and_mapping.py", + "tests/test_v8_art_installer.py" + ], + "log": "reports/v8213-regression_logs/round1-batch8.log" + }, + { + "status": "PASS", + "passed": 29, + "duration_seconds": 6.99, + "exit_code": 0, + "name": "round1-batch9", + "modules": [ + "tests/test_v8_workflows.py", + "tests/test_wordpress_baseline.py", + "tests/test_worker_queue_v6.py", + "tests/test_workspace_v810.py" + ], + "log": "reports/v8213-regression_logs/round1-batch9.log" + }, + { + "status": "PASS", + "passed": 41, + "duration_seconds": 6.29, + "exit_code": 0, + "name": "round1-batch10", + "modules": [ + "tests/test_workspace_v812.py", + "tests/test_wp_complex_v820.py", + "tests/test_wp_migration_v81.py", + "tests/test_wp_migration_v82.py" + ], + "log": "reports/v8213-regression_logs/round1-batch10.log" + }, + { + "status": "PASS", + "passed": 10, + "duration_seconds": 3.12, + "exit_code": 0, + "name": "round1-batch11", + "modules": [ + "tests/test_wp_migration_v83.py" + ], + "log": "reports/v8213-regression_logs/round1-batch11.log" + } + ], + "environment_note": "pytest local fixtures only; Docker/PG/Redis/browser/real WordPress not inferred as passed." +} \ No newline at end of file diff --git a/reports/v8213-regression.md b/reports/v8213-regression.md new file mode 100644 index 0000000..ae607a9 --- /dev/null +++ b/reports/v8213-regression.md @@ -0,0 +1,19 @@ +# SiteForge V8.21 完整自动化回归 + +**PASS** — 41 模块 / 345 项每轮 / 1 轮 + +| 批次 | 结果 | 通过用例 | 耗时 | 日志 | +|---|---|---:|---:|---| +| round1-batch1 | PASS | 43 | 5.03 秒 | reports/v8213-regression_logs/round1-batch1.log | +| round1-batch2 | PASS | 22 | 6.43 秒 | reports/v8213-regression_logs/round1-batch2.log | +| round1-batch3 | PASS | 49 | 8.64 秒 | reports/v8213-regression_logs/round1-batch3.log | +| round1-batch4 | PASS | 28 | 4.91 秒 | reports/v8213-regression_logs/round1-batch4.log | +| round1-batch5 | PASS | 29 | 5.82 秒 | reports/v8213-regression_logs/round1-batch5.log | +| round1-batch6 | PASS | 25 | 4.51 秒 | reports/v8213-regression_logs/round1-batch6.log | +| round1-batch7 | PASS | 51 | 8.36 秒 | reports/v8213-regression_logs/round1-batch7.log | +| round1-batch8 | PASS | 18 | 3.14 秒 | reports/v8213-regression_logs/round1-batch8.log | +| round1-batch9 | PASS | 29 | 6.99 秒 | reports/v8213-regression_logs/round1-batch9.log | +| round1-batch10 | PASS | 41 | 6.29 秒 | reports/v8213-regression_logs/round1-batch10.log | +| round1-batch11 | PASS | 10 | 3.12 秒 | reports/v8213-regression_logs/round1-batch11.log | + +真实部署与外部服务另行验收。 diff --git a/requirements-browser.txt b/requirements-browser.txt new file mode 100644 index 0000000..362a8db --- /dev/null +++ b/requirements-browser.txt @@ -0,0 +1,2 @@ +# CI-only Playwright browser smoke dependency; Chromium installed via playwright CLI. +playwright==1.57.0 diff --git a/requirements-dev.lock b/requirements-dev.lock index 588aab5..092a8e6 100644 --- a/requirements-dev.lock +++ b/requirements-dev.lock @@ -35,3 +35,16 @@ webencodings==0.5.1 PyYAML==6.0.3 PyMySQL==1.1.2 + +# Native P5 publish connectors (SFTP + S3), pinned for CI/Docker. +boto3==1.43.18 +botocore==1.43.18 +s3transfer==0.18.0 +jmespath==1.1.0 +python-dateutil==2.9.0.post0 +urllib3==2.7.0 +paramiko==4.0.0 +bcrypt==4.3.0 +cryptography==46.0.4 +cffi==2.0.0 +pycparser==3.0 diff --git a/requirements.lock b/requirements.lock index 23c6b2f..3557109 100644 --- a/requirements.lock +++ b/requirements.lock @@ -30,3 +30,16 @@ typing-inspection==0.4.4 uvicorn==0.48.0 webencodings==0.5.1 PyMySQL==1.1.2 + +# Native P5 publish connectors (SFTP + S3), pinned for CI/Docker. +boto3==1.43.18 +botocore==1.43.18 +s3transfer==0.18.0 +jmespath==1.1.0 +python-dateutil==2.9.0.post0 +urllib3==2.7.0 +paramiko==4.0.0 +bcrypt==4.3.0 +cryptography==46.0.4 +cffi==2.0.0 +pycparser==3.0 diff --git a/requirements.txt b/requirements.txt index 13c8f08..48e8aab 100644 --- a/requirements.txt +++ b/requirements.txt @@ -10,3 +10,7 @@ openpyxl==3.1.5 python-multipart==0.0.29 uvicorn==0.48.0 PyMySQL==1.1.2 + +# P5 native deployment backends +paramiko==4.0.0 +boto3==1.43.18 diff --git a/scripts/browser_mobile_v8213.py b/scripts/browser_mobile_v8213.py new file mode 100644 index 0000000..9b943d9 --- /dev/null +++ b/scripts/browser_mobile_v8213.py @@ -0,0 +1,71 @@ +"""Offline Chromium check for real four-theme mobile templates without localhost/file navigation. + +Uses page.set_content to work in CI sandboxes that block navigation to localhost/file URLs. +Tests actual rendered HTML, CSS, and JS; external image loading is not asserted. +""" +from pathlib import Path +import json,re,sys +from playwright.sync_api import sync_playwright, expect +ROOT=Path(__file__).resolve().parents[1] +SAMPLE=ROOT/'examples'/'mobile-showcase' + +def inline(theme,page_name="index.html"): + path=SAMPLE/theme + html=(path/page_name).read_text('utf-8') + css='\n'.join((path/'assets'/name).read_text('utf-8') for name in + ['theme.css','blocks.css','factory.css','pro-base.css','pro.css','commercial.css','custom.css']) + html=re.sub(r']*rel="stylesheet"[^>]*>', '',html) + html=re.sub(r'', '',html) + html=html.replace('','') + js=(path/'assets/pro.js').read_text('utf-8') + html=html.replace('','') + return html + +def run(): + results=[] + with sync_playwright() as pw: + browser=pw.chromium.launch(executable_path='/usr/bin/chromium',headless=True,args=['--no-sandbox','--disable-dev-shm-usage']) + try: + for theme in ['automotive','industrial','corporate','minimal']: + page=browser.new_page(viewport={'width':390,'height':844},device_scale_factor=1) + errors=[] + page.on('pageerror',lambda e:errors.append(str(e))) + page.set_content(inline(theme),wait_until='domcontentloaded') + assert page.locator('.sf-mobile-tabs').is_visible(),theme+' tabs absent' + assert page.locator('[data-mobile-open-menu]').count()==1 + assert not page.locator('#pro-navigation').is_visible(),theme+' drawer initially visible' + page.locator('[data-pro-menu]').click() + assert page.locator('#pro-navigation').is_visible(),theme+' drawer not open' + expect(page.locator('.sf-mobile-drawer-backdrop')).to_be_visible(timeout=3000) + assert page.locator('[data-pro-menu]').get_attribute('aria-expanded')=='true' + page.keyboard.press('Escape') + assert not page.locator('#pro-navigation').is_visible(),theme+' Esc fails' + page.locator('[data-mobile-open-menu]').click() + assert page.locator('#pro-navigation').is_visible(),theme+' tabs menu failed' + page.locator('.sf-mobile-drawer-backdrop').click(position={'x':4,'y':100}) + assert not page.locator('#pro-navigation').is_visible(),theme+' backdrop close fails' + assert page.locator('.sf-mobile-tabs').evaluate('(el)=>getComputedStyle(el).display')=='grid' + overflow=page.evaluate('document.documentElement.scrollWidth - window.innerWidth') + for filename in ['index.html','listing.html','product.html','article.html']: + for width in (375,390,430): + sub=browser.new_page(viewport={'width':width,'height':844}) + sub.set_content(inline(theme,filename),wait_until='domcontentloaded') + assert sub.locator('.sf-mobile-tabs').is_visible(),f'{theme}/{filename}: tabs missing' + excess=sub.evaluate('document.documentElement.scrollWidth - window.innerWidth') + assert excess<=1,f'{theme}/{filename} width={width} overflow={excess}' + sub.close() + page.set_viewport_size({'width':1440,'height':900}) + assert not page.locator('.sf-mobile-tabs').is_visible(),theme+' desktop tabs leakage' + assert page.locator('#pro-navigation').is_visible(),theme+' desktop nav hidden' + assert not errors,theme+' script errors: '+str(errors) + results.append({'theme':theme,'drawer':'PASS','tabs':'PASS','responsive':'PASS','mobile_horizontal_overflow_px':overflow,'page_types_tested':4,'javascript_errors':len(errors)}) + if theme=='automotive': + page.set_viewport_size({'width':390,'height':844}) + page.wait_for_timeout(350);page.screenshot(path=str(ROOT/'reports'/'mobile-v8213-automotive.png'),full_page=True) + page.close() + finally:browser.close() + out=ROOT/'reports'/'mobile-v8213-browser.json';out.parent.mkdir(exist_ok=True,parents=True) + out.write_text(json.dumps(results,ensure_ascii=False,indent=2),encoding='utf-8') + print(json.dumps(results,ensure_ascii=False,indent=2)) + return 0 +if __name__=='__main__':sys.exit(run()) diff --git a/scripts/browser_smoke.py b/scripts/browser_smoke.py new file mode 100644 index 0000000..8f559ff --- /dev/null +++ b/scripts/browser_smoke.py @@ -0,0 +1,87 @@ +"""Real Chromium browser smoke test for the unified management console. + +Requires optional `playwright` and Chromium. Uses an isolated SQLite directory; +does not touch live sites, data, or deployment targets. +""" +from __future__ import annotations +import os +import socket +import subprocess +import sys +import tempfile +import time +import urllib.request +from pathlib import Path +from playwright.sync_api import sync_playwright + +ROOT=Path(__file__).resolve().parent.parent + + +def run(screenshot_dir=None): + with tempfile.TemporaryDirectory(prefix='siteforge-browser-') as data: + with socket.socket() as sock: + sock.bind(('127.0.0.1',0)) + port=sock.getsockname()[1] + root_url=f'http://127.0.0.1:{port}' + env=os.environ.copy() + env.update(SITEFORGE_ADMIN_PASSWORD='browser-smoke-only-strong-password', + SITEFORGE_SESSION_SECRET='browser-smoke-secret-key-strong-long-enough', + SITEFORGE_DATA_DIR=data, SITEFORGE_DB_FILE=str(Path(data)/'browser.sqlite3'), + SITEFORGE_DATABASE_URL='',SITEFORGE_REDIS_URL='') + server=subprocess.Popen([sys.executable,'-m','uvicorn','app.main:app','--host','127.0.0.1','--port',str(port)], + cwd=ROOT,env=env,stdout=subprocess.DEVNULL,stderr=subprocess.PIPE) + try: + ready=False + for _ in range(100): + if server.poll() is not None: + raise RuntimeError(f'Web app stopped during startup: {server.stderr.read().decode(errors="replace")[-3000:]}') + try: + with urllib.request.urlopen(root_url+'/api/ready',timeout=0.5) as res: + ready=res.status==200 + if ready:break + except Exception:time.sleep(0.1) + if not ready:raise RuntimeError('Web readiness timeout') + with sync_playwright() as pw: + launch_settings={'executable_path':os.environ['SITEFORGE_CHROMIUM']} if os.environ.get('SITEFORGE_CHROMIUM') else {} + browser=pw.chromium.launch(**launch_settings,headless=True,args=['--no-sandbox','--no-proxy-server','--proxy-server=direct://','--proxy-bypass-list=*','--disable-features=ProxyPacHttpsUrlStripping']) + context=browser.new_context(viewport={'width':1440,'height':900},device_scale_factor=1) + page=context.new_page() + errors=[] + page.on('pageerror',lambda error:errors.append(str(error))) + page.goto(root_url+'/login',wait_until='domcontentloaded') + page.locator('#pass').fill(env['SITEFORGE_ADMIN_PASSWORD']) + page.locator('#submit').click() + page.wait_for_url(root_url+'/',timeout=12000) + page.get_by_text('我的网站',exact=True).first.wait_for(timeout=10000) + page.locator('#newSiteTop').click() + assert page.locator('#siteModal').evaluate('(element)=>element.open') + page.locator('#siteForm [name=name]').fill('浏览器验收站') + page.locator('#siteForm button[type=submit]').click() + page.locator('#siteModal').wait_for(state='hidden',timeout=10000) + page.get_by_text('浏览器验收站',exact=True).first.wait_for(timeout=10000) + page.locator('button[data-view="content"]').click() + page.locator('#breadcrumbTitle').get_by_text('内容与页面').wait_for() + page.locator('button[data-view="design"]').click() + page.locator('#breadcrumbTitle').get_by_text('外观与设计').wait_for() + if screenshot_dir: + d=Path(screenshot_dir);d.mkdir(parents=True,exist_ok=True) + page.screenshot(path=str(d/'desktop.png'),full_page=True) + mobile=context.new_page() + mobile.set_viewport_size({'width':390,'height':844}) + mobile.goto(root_url+'/',wait_until='domcontentloaded') + assert mobile.url.rstrip('/') == root_url, 'Mobile session unexpectedly lost authentication' + mobile.locator('#mainContent').wait_for(timeout=10000) + mobile.locator('#menuToggle').click() + assert 'nav-open' in mobile.locator('body').get_attribute('class') or mobile.locator('#sideMenu').is_visible() + if screenshot_dir: + mobile.screenshot(path=str(d/'mobile.png'),full_page=True) + assert not errors,errors + print('PASS: Chromium login, create site, navigate content/design, mobile menu, no page exceptions') + browser.close() + finally: + server.terminate() + try:server.communicate(timeout=5) + except subprocess.TimeoutExpired:server.kill();server.communicate() + +if __name__=='__main__': + run(sys.argv[1] if len(sys.argv)>1 else None) diff --git a/scripts/browser_studio_v8211.py b/scripts/browser_studio_v8211.py new file mode 100644 index 0000000..f6796e6 --- /dev/null +++ b/scripts/browser_studio_v8211.py @@ -0,0 +1,69 @@ +"""Optional actual Chromium smoke on disposable site. Never contacts production.""" +import json, os, socket, subprocess, sys, tempfile, time +from pathlib import Path +from urllib.request import urlopen +import httpx +from playwright.sync_api import sync_playwright +ROOT=Path(__file__).resolve().parent.parent +OUT=ROOT/'reports'/'studio-ux' +OUT.mkdir(parents=True,exist_ok=True) + +def main(): + with tempfile.TemporaryDirectory(prefix='sf-studio-ui-') as folder: + with socket.socket() as s:s.bind(('127.0.0.1',0));port=s.getsockname()[1] + base=f'http://127.0.0.1:{port}' + env={**os.environ,'SITEFORGE_ADMIN_PASSWORD':'studio-smoke-only-password','SITEFORGE_SESSION_SECRET':'studio-smoke-only-secret-very-long','SITEFORGE_DATA_DIR':folder,'SITEFORGE_DB_FILE':str(Path(folder)/'siteforge.sqlite3'),'SITEFORGE_DATABASE_URL':'','SITEFORGE_REDIS_URL':'','SITEFORGE_COOKIE_SECURE':'false','NO_PROXY':'127.0.0.1,localhost','no_proxy':'127.0.0.1,localhost'} + proc=subprocess.Popen([sys.executable,'-m','uvicorn','app.main:app','--host','127.0.0.1','--port',str(port)],cwd=ROOT,env=env,stdout=subprocess.DEVNULL,stderr=subprocess.PIPE) + try: + for i in range(120): + if proc.poll() is not None:raise RuntimeError('server exited: '+proc.stderr.read().decode()[-1200:]) + try: + with urlopen(base+'/api/ready',timeout=0.4) as response: + if response.status==200:break + except Exception:time.sleep(.1) + else:raise RuntimeError('readiness timed out') + with httpx.Client(base_url=base,trust_env=False) as client: + login=client.post('/api/auth/login',json={'username':'admin','password':env['SITEFORGE_ADMIN_PASSWORD']});login.raise_for_status() + csrf=client.get('/api/auth/me').json()['csrf'] + site=client.post('/api/sites',json={'name':'V8.21 Studio UI 验收站点','theme':'corporate'},headers={'X-SiteForge-CSRF':csrf});site.raise_for_status();sid=site.json()['id'] + entries=client.get(f'/api/sites/{sid}/entries').json();page_id=next(x['id'] for x in entries if x['route']=='/') + cookie_names={c.name:c.value for c in client.cookies.jar} + with sync_playwright() as play: + browser=play.chromium.launch(executable_path='/usr/bin/chromium',headless=True,args=['--no-sandbox','--disable-dev-shm-usage','--no-proxy-server','--disable-gpu']) + context=browser.new_context(viewport={'width':1600,'height':950},device_scale_factor=1) + context.add_cookies([{'name':k,'value':v,'url':base} for k,v in cookie_names.items()]) + page=context.new_page() + errors=[];page.on('pageerror',lambda e:errors.append(str(e))) + page.goto(base+f'/editor/{sid}/{page_id}',wait_until='domcontentloaded',timeout=20000) + page.locator('#blockList .block-row').first.wait_for(timeout=12000) + page.screenshot(path=str(OUT/'editor-desktop.png'),full_page=True) + page.locator('#tabResponsive').click() + assert page.locator('#tabResponsive').get_attribute('aria-selected')=='true' + assert not page.locator('[data-inspector-section="responsive"]').is_hidden() + page.locator('#tabContent').click() + total=page.locator('.block-row').count() + page.locator('#blockSearch').fill('not-find-anything') + assert page.locator('.block-row').count()==0 + page.locator('#blockSearch').fill('') + assert page.locator('.block-row').count()==total + page.locator('.block-row').first.locator('button[title="隐藏"]').click() + assert page.locator('#saveStatus').inner_text().startswith('未保存') + page.locator('#saveDraftButton').click() + page.wait_for_function("document.querySelector('#saveStatus').textContent.startsWith('草稿')",timeout=12000) + page.locator('#devicePhone').click() + page.screenshot(path=str(OUT/'editor-phone-preview.png'),full_page=True) + assert not errors,errors + mobile=browser.new_context(viewport={'width':390,'height':844},device_scale_factor=1) + mobile.add_cookies([{'name':k,'value':v,'url':base} for k,v in cookie_names.items()]) + mp=mobile.new_page();mp.goto(base+f'/editor/{sid}/{page_id}',wait_until='domcontentloaded',timeout=20000) + mp.locator('#blockCount').wait_for(timeout=12000) + mp.locator('.pane-switcher button').first.click() + assert 'show-structure' in mp.locator('body').get_attribute('class') + mp.screenshot(path=str(OUT/'editor-mobile-ui.png'),full_page=True) + mobile.close();browser.close() + print(json.dumps({'result':'PASS','desktop_blocks':total,'browser_errors':errors,'screenshots':[str(x) for x in OUT.glob('*.png')]},ensure_ascii=False)) + finally: + proc.terminate() + try:proc.wait(timeout=5) + except subprocess.TimeoutExpired:proc.kill();proc.wait() +if __name__=='__main__':main() diff --git a/scripts/check.ps1 b/scripts/check.ps1 index 0b8b16c..a4012a0 100644 --- a/scripts/check.ps1 +++ b/scripts/check.ps1 @@ -2,7 +2,7 @@ $ErrorActionPreference = 'Stop' Set-Location (Join-Path $PSScriptRoot '..') python -m compileall -q app if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } -python -m pytest -q +python scripts/regression_v821.py --report reports/v821-regression if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } Get-ChildItem app/static -Filter *.js | ForEach-Object { node --check $_.FullName diff --git a/scripts/check.sh b/scripts/check.sh index 20b5738..b1038d7 100644 --- a/scripts/check.sh +++ b/scripts/check.sh @@ -2,7 +2,10 @@ set -euo pipefail cd "$(dirname "${BASH_SOURCE[0]}")/.." python -m compileall -q app -python -m pytest -q +# Each batch has a hard deadline and failed batches are isolated for diagnosis. +# Reports are generated outside test output; do not commit logs without review. +python scripts/regression_v821.py --repeat "${SITEFORGE_REGRESSION_REPEAT:-1}" --timeout "${SITEFORGE_REGRESSION_TIMEOUT:-90}" --report reports/v821-regression +python scripts/verify_release.py if command -v node >/dev/null 2>&1; then for f in app/static/*.js; do node --check "$f"; done else diff --git a/scripts/demo_multilingual_v815.py b/scripts/demo_multilingual_v815.py new file mode 100644 index 0000000..59ca75d --- /dev/null +++ b/scripts/demo_multilingual_v815.py @@ -0,0 +1,32 @@ +"""Deterministic demo, only writes to an explicitly isolated SITEFORGE_DATA_DIR.""" +import json +import os +from pathlib import Path +if not os.getenv('SITEFORGE_DATA_DIR'): + raise SystemExit('Please set SITEFORGE_DATA_DIR to a disposable directory first') +import sys +sys.path.insert(0,str(Path(__file__).resolve().parents[1])) +from app import db, multilingual, builder, theme_store +from app.core import save_entry, uid + +db.init() +theme_store.setup() +multilingual.setup() +records=[('zh-CN','中文官网','https://zh.demo.example.org','/about/','关于我们','全球服务网络'), + ('en','Global Website','https://en.demo.example.org','/company/','About Our Company','Worldwide service network')] +ids={}; content={} +for locale,name,domain,about,title,body in records: + sid=uid(); ids[locale]=sid + db.insert('''INSERT INTO sites VALUES (?,?,?,?,?,?,?,?,?,?,?)''', + (sid,name,domain,'SiteForge P6 international demonstration','corporate','#2563eb','','new','{}',db.now(),db.now())) + home=save_entry(sid,{'type':'page','title':name,'route':'/','body':f'

{body}

'}) + detail=save_entry(sid,{'type':'page','title':title,'route':about,'body':f'

{body}

'}) + content[locale]={'home':home,'about':detail} +gid=uid();db.insert('INSERT INTO language_groups VALUES (?,?,?,?)',(gid,'HESU multilingual demo','en',db.now())) +for locale in ids:db.insert('INSERT INTO language_sites VALUES (?,?,?)',(gid,ids[locale],locale)) +for key in ('home','about'): + unit=uid();db.insert('INSERT INTO translation_units VALUES (?,?,?,?)',(unit,gid,key,db.now())) + for locale in ids:db.insert('INSERT INTO translation_members VALUES (?,?,?,?)',(unit,ids[locale],content[locale][key],'approved')) +for locale,sid in ids.items(): + report=builder.build(sid) + print(json.dumps({'locale':locale,'site_id':sid,'build':report['version'],'pages':report['pages'],'alternates':report['alternate_pages'],'errors':report['errors'],'warnings':report['warnings'][:3]},ensure_ascii=False)) diff --git a/scripts/export_wordpress_url_baseline.py b/scripts/export_wordpress_url_baseline.py new file mode 100644 index 0000000..9582813 --- /dev/null +++ b/scripts/export_wordpress_url_baseline.py @@ -0,0 +1,100 @@ +#!/usr/bin/env python3 +"""Convert an authorized WXR or Sitemap XML file into a URL-preservation baseline. + +Offline only. Uses defusedxml; hard input limit 32 MiB. Does not download sites. +""" +import argparse +import sys +from pathlib import Path +from urllib.parse import urlsplit, unquote + +try: + from defusedxml import ElementTree as DET +except ImportError: + print('需要先安装 defusedxml：python -m pip install defusedxml', file=sys.stderr) + raise SystemExit(3) + +WP_NS = '{http://wordpress.org/export/1.2/}' +SITEMAP_NS = '{http://www.sitemaps.org/schemas/sitemap/0.9}' +MAX_XML = 32 * 1024 * 1024 + + +def route_from_url(raw, allowed_hosts): + p = urlsplit(raw.strip()) + if p.scheme not in ('http', 'https') or not p.hostname: + return None + if p.hostname.lower().rstrip('.') not in allowed_hosts: + return None + # Encoded dots/slashes would introduce ambiguous paths, so reject them. + path = unquote(p.path or '/') + if '\\' in path or '\x00' in path or '//' in path or any(seg in ('.', '..') for seg in path.split('/')): + return None + # Query-based legacy WordPress URLs require explicit redirect mapping. + if p.query or p.fragment: + return None + return path + + +def extract(root, hosts, include_unpublished=False): + routes = set() + ignored = [] + if root.tag.endswith('urlset'): + items = root.findall(f'.//{SITEMAP_NS}url') or root.findall('.//url') + for item in items: + loc = item.findtext(f'{SITEMAP_NS}loc') or item.findtext('loc') or '' + route = route_from_url(loc, hosts) + if route: routes.add(route) + elif loc: ignored.append('sitemap: 无法映射的 loc') + elif root.tag == 'rss' or root.tag.endswith('rss'): + items = root.findall('./channel/item') + for item in items: + status = (item.findtext(f'{WP_NS}status') or '').strip() + kind = (item.findtext(f'{WP_NS}post_type') or '').strip() + # WXR can contain attachments and revision records: only published content pages. + if kind in ('attachment', 'revision', 'nav_menu_item'): + continue + if not include_unpublished and status != 'publish': + continue + link = item.findtext('link') or '' + route = route_from_url(link, hosts) + if route: routes.add(route) + elif link: ignored.append('WXR: 无法映射的 link') + else: + raise ValueError('仅支持 WXR RSS 或 sitemap urlset XML（不支持 sitemapindex 的递归远端访问）') + return sorted(routes), ignored + + +def main(argv=None): + ap = argparse.ArgumentParser(description='从授权的 WordPress WXR 或 Sitemap 导出原始 URL 基线，离线运行') + ap.add_argument('xml', type=Path) + ap.add_argument('--host', required=True, help='旧站域名，不带 scheme 或路径，例如 example.com') + ap.add_argument('--allow-host', action='append', default=[], help='手动允许其他同站主机名（例如 www.example.com）') + ap.add_argument('--include-unpublished', action='store_true', help='WXR 包含草稿（默认仅 publish）') + ap.add_argument('--output', type=Path, required=True) + args = ap.parse_args(argv) + allowed = set() + for host in [args.host] + args.allow_host: + if not host or any(c in host for c in '/:@?#') or any(c.isspace() for c in host): + ap.error('--host/--allow-host 只接受域名，不接受 URL、端口或路径') + allowed.add(host.lower().rstrip('.')) + try: + size = args.xml.stat().st_size + if size > MAX_XML: raise ValueError('XML 超过 32 MiB 上限，请分割或使用离线批处理') + if not size: raise ValueError('XML 文件为空') + root = DET.parse(args.xml).getroot() + routes, ignored = extract(root, allowed, args.include_unpublished) + except (OSError, ValueError, DET.ParseError, DET.EntitiesForbidden, DET.DTDForbidden) as e: + print('导入失败：' + str(e), file=sys.stderr) + return 2 + if not routes: + print('没有找到匹配已发布内容的 URL，请检查旧站域名和 XML 格式', file=sys.stderr) + return 2 + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text('# WordPress 旧站原始 URL 路径基线（不可修改路径语义）\n' + '\n'.join(routes) + '\n', encoding='utf-8') + print(f'导出 {len(routes)} 条；无法映射 {len(ignored)} 条。保存：{args.output}') + if ignored: + print('警告：有 URL 包含查询参数或使用了非指定域名；需人工建立 301 路径映射。', file=sys.stderr) + return 0 + +if __name__ == '__main__': + raise SystemExit(main()) diff --git a/scripts/http_end_to_end.py b/scripts/http_end_to_end.py new file mode 100644 index 0000000..18e99cf --- /dev/null +++ b/scripts/http_end_to_end.py @@ -0,0 +1,77 @@ +"""End-to-end HTTP + Worker smoke test on an isolated disposable SQLite database. + +Launches an actual uvicorn process, calls authenticated HTTP APIs, runs a real +Worker claim + isolated subprocess build, then downloads and checks the archive. +Never points at production data or remote deployment services. +""" +from __future__ import annotations +import io +import json +import os +import socket +import subprocess +import sys +import tempfile +import time +import zipfile +from pathlib import Path +from urllib.error import URLError +from urllib.request import urlopen +import httpx + +ROOT=Path(__file__).resolve().parent.parent + +def run(): + with tempfile.TemporaryDirectory(prefix='siteforge-e2e-') as folder: + with socket.socket() as sock: + sock.bind(('127.0.0.1',0)); port=sock.getsockname()[1] + base=f'http://127.0.0.1:{port}' + env=os.environ.copy() + env.update(SITEFORGE_ADMIN_PASSWORD='e2e-only-dummy-password-123456', + SITEFORGE_SESSION_SECRET='e2e-only-session-secret-long-value-123456', + SITEFORGE_DATA_DIR=folder,SITEFORGE_DB_FILE=str(Path(folder)/'siteforge.sqlite3'), + SITEFORGE_DATABASE_URL='',SITEFORGE_REDIS_URL='',SITEFORGE_COOKIE_SECURE='false') + proc=subprocess.Popen([sys.executable,'-m','uvicorn','app.main:app','--host','127.0.0.1','--port',str(port)], + cwd=ROOT,env=env,stdout=subprocess.DEVNULL,stderr=subprocess.PIPE) + try: + for n in range(120): + if proc.poll() is not None:raise RuntimeError('Web startup failed: '+proc.stderr.read().decode(errors='replace')[-3000:]) + try: + with urlopen(base+'/api/ready',timeout=0.5) as result: + if result.status==200:break + except (OSError,URLError):time.sleep(0.1) + else:raise RuntimeError('Web readiness timeout') + with httpx.Client(base_url=base,timeout=20,follow_redirects=False) as client: + auth=client.post('/api/auth/login',json={'username':'admin','password':env['SITEFORGE_ADMIN_PASSWORD']}) + assert auth.status_code==200,auth.text + me=client.get('/api/auth/me') + assert me.status_code==200,me.text + client.headers['X-SiteForge-CSRF']=me.json()['csrf'] + site=client.post('/api/sites',json={'name':'E2E Production Smoke','theme':'corporate'}) + assert site.status_code==201,site.text + sid=site.json()['id'] + page=client.post(f'/api/sites/{sid}/entries',json={'type':'page','title':'Test about','route':'/about/','body':'E2E smoke content'}) + assert page.status_code==201,page.text + job=client.post(f'/api/sites/{sid}/builds',json={'mirror_images':False},headers={'Idempotency-Key':'e2e-build-000001'}) + assert job.status_code==202,job.text + completed=subprocess.run([sys.executable,'-c','from app import db,enterprise,worker; db.init(); enterprise.setup(); assert worker.run_once()'],cwd=ROOT,env=env,capture_output=True,text=True,timeout=70) + assert completed.returncode==0,completed.stderr[-2500:] + builds=client.get(f'/api/sites/{sid}/builds') + assert builds.status_code==200,builds.text + done=[x for x in builds.json() if x['status']=='complete'] + if not done: + raise AssertionError('No completed static build: '+str(builds.json())[:1200]) + archive=client.get(f"/api/sites/{sid}/builds/{done[0]['id']}/download") + assert archive.status_code==200,archive.text[:300] + with zipfile.ZipFile(io.BytesIO(archive.content)) as z: + assert 'index.html' in z.namelist() + assert 'about/index.html' in z.namelist() + preview=client.get(f"/preview/{sid}/{done[0]['id']}/about/") + assert preview.status_code==200 and 'E2E smoke content' in preview.text + print('PASS: ready -> login/CSRF -> create site/page -> enqueue -> Worker build -> ZIP -> preview') + finally: + proc.terminate() + try:proc.communicate(timeout=5) + except subprocess.TimeoutExpired:proc.kill();proc.communicate() + +if __name__=='__main__':run() diff --git a/scripts/init_config.py b/scripts/init_config.py index 5b96fd1..7e98cbd 100644 --- a/scripts/init_config.py +++ b/scripts/init_config.py @@ -12,7 +12,7 @@ password=secrets.token_urlsafe(24) secret=secrets.token_urlsafe(48) pg_password=secrets.token_urlsafe(30) deploy_secret=secrets.token_urlsafe(48) -config.write_text(f'''# SiteForge Factory 8.12.0-dev.1 - 不要上传至代码仓库\nSITEFORGE_PORT=8787\nSITEFORGE_ADMIN_PASSWORD={password}\nSITEFORGE_SESSION_SECRET={secret}\nSITEFORGE_COOKIE_SECURE=false\nSITEFORGE_DOMAIN=siteforge.example.com\nSITEFORGE_PG_USER=siteforge\nSITEFORGE_PG_PASSWORD={pg_password}\nSITEFORGE_PG_DB=siteforge\nSITEFORGE_DEPLOY_SECRET={deploy_secret}\n# Remote deployment target: configure HTTPS URLs and corresponding secrets manually.\nSITEFORGE_DEPLOY_STAGING_URL=\nSITEFORGE_DEPLOY_STAGING_SECRET=\nSITEFORGE_DEPLOY_PRODUCTION_URL=\nSITEFORGE_DEPLOY_PRODUCTION_SECRET=\n''', encoding='utf-8') +config.write_text(f'''# SiteForge Factory 8.21.3-dev.1 - 不要上传至代码仓库\nSITEFORGE_PORT=8787\nSITEFORGE_ADMIN_PASSWORD={password}\nSITEFORGE_SESSION_SECRET={secret}\nSITEFORGE_COOKIE_SECURE=false\nSITEFORGE_DOMAIN=siteforge.example.com\nSITEFORGE_PG_USER=siteforge\nSITEFORGE_PG_PASSWORD={pg_password}\nSITEFORGE_PG_DB=siteforge\nSITEFORGE_DEPLOY_SECRET={deploy_secret}\n# Remote deployment target: configure HTTPS URLs and corresponding secrets manually.\nSITEFORGE_DEPLOY_STAGING_URL=\nSITEFORGE_DEPLOY_STAGING_SECRET_REF=\nSITEFORGE_DEPLOY_PRODUCTION_URL=\nSITEFORGE_DEPLOY_PRODUCTION_SECRET_REF=\n''', encoding='utf-8') try:os.chmod(config,0o600) except OSError:pass print('SiteForge 已生成 .env 配置。') diff --git a/scripts/install_into_art_design_pro.py b/scripts/install_into_art_design_pro.py index 3499060..f811b96 100644 --- a/scripts/install_into_art_design_pro.py +++ b/scripts/install_into_art_design_pro.py @@ -1,52 +1,158 @@ -"""Offline installer for SiteForge components into a user-provided official Art Design Pro checkout. +"""Install the SiteForge V8.19 module into a user-provided Art Design Pro checkout. -Run with --dry-run first. It does NOT download, modify auth schemes, or -pretend to have compiled the official repository in this sandbox. +No network, npm, or destructive operations. Route insertion is deterministic; the +official Art checkout is not bundled. Usage: --apply, --verify, --migrate-legacy. """ -import argparse,shutil,re +from __future__ import annotations +import argparse +import hashlib +import json +import os from pathlib import Path +import re +import shutil -SOURCE=Path(__file__).resolve().parents[1]/'integrations'/'art-design-pro'/'src'/'views'/'siteforge' -MARKER='// SITEFORGE_FACTORY_V7_REGISTERED' -V8_MARKER='// SITEFORGE_FACTORY_V8_REGISTERED' -V8_ROUTES=""" +ROOT = Path(__file__).resolve().parents[1] +SOURCE = ROOT / 'integrations/art-design-pro/src/views/siteforge' +ROUTE_MARKER = '// SITEFORGE_FACTORY_V8_REGISTERED' +BEGIN = '// SITEFORGE_V819_ROUTES_BEGIN' +END = '// SITEFORGE_V819_ROUTES_END' +LEGACY = ('// SITEFORGE_FACTORY_V7_REGISTERED', ROUTE_MARKER) +ROUTES = ''' + // SITEFORGE_V819_ROUTES_BEGIN // SITEFORGE_FACTORY_V8_REGISTERED - { path:'/siteforge/production', name:'SiteForgeV8Production', component:'/siteforge/V8Production', - meta:{title:'V8 生产控制台',icon:'ri:factory-line'} }, -""" -ROUTES='''\n // SITEFORGE_FACTORY_V7_REGISTERED\n {\n path: '/siteforge', name: 'SiteForge', component: '/index/index',\n meta: {title:'网站工厂',icon:'ri:layout-grid-line'},\n children: [\n {path:'factory',name:'SiteForgeFactory',component:'/siteforge/WebsiteFactory',meta:{title:'网站项目'}},\n {path:'themes',name:'SiteForgeThemes',component:'/siteforge/ThemeCenter',meta:{title:'主题与版本'}},\n {path:'enterprise',name:'SiteForgeEnterprise',component:'/siteforge/EnterpriseCenter',meta:{title:'企业控制'}}, - {path:'editor',name:'SiteForgeEditor',component:'/siteforge/VisualEditor',meta:{title:'可视化编辑'}}, - {path:'migration',name:'SiteForgeMigration',component:'/siteforge/MigrationCenter',meta:{title:'CMS 迁移'}}, - {path:'releases',name:'SiteForgeReleases',component:'/siteforge/ReleaseCenter',meta:{title:'审批与发布'}},\n ]\n },\n''' + // SITEFORGE_FACTORY_V7_REGISTERED + { + path: '/siteforge', name: 'SiteForge', component: '/index/index', + meta: { title: '网站工厂', icon: 'ri:layout-grid-line' }, + children: [ + { path: 'dashboard', name: 'SiteForgeDashboard', component: '/siteforge/ConsoleHome', meta: { title: '工作台' } }, + { path: 'factory', name: 'SiteForgeFactory', component: '/siteforge/WebsiteFactory', meta: { title: '网站管理' } }, + { path: 'content', name: 'SiteForgeContent', component: '/siteforge/ContentCenter', meta: { title: '内容管理' } }, + { path: 'editor', name: 'SiteForgeEditor', component: '/siteforge/VisualEditor', meta: { title: '网站设计' } }, + { path: 'migration', name: 'SiteForgeMigration', component: '/siteforge/MigrationCenter', meta: { title: '数据与迁移' } }, + { path: 'releases', name: 'SiteForgeReleases', component: '/siteforge/ReleaseCenter', meta: { title: '构建与发布' } }, + { path: 'enterprise', name: 'SiteForgeEnterprise', component: '/siteforge/EnterpriseCenter', meta: { title: '系统管理' } }, + { path: 'themes', name: 'SiteForgeThemes', component: '/siteforge/ThemeCenter', meta: { title: '主题库', isHide: true } }, + { path: 'production', name: 'SiteForgeV8Production', component: '/siteforge/V8Production', meta: { title: '高级生产工具', isHide: true } }, + ], + }, + // SITEFORGE_V819_ROUTES_END +''' +ROUTE_RE = re.compile(r'(export\s+const\s+asyncRoutes\s*(?::[^=]+)?=\s*\[)') -def install(root:Path,dry_run:bool): - base=root/'src'/'router'/'routes'/'asyncRoutes.ts' - target=root/'src'/'views'/'siteforge' - if not base.is_file() or not (root/'package.json').is_file():raise ValueError('不是受支持的 Art Design Pro 源码目录') - original=base.read_text(encoding='utf-8') - pat=r'(export\s+const\s+asyncRoutes\s*:[^=]*=\s*\[)' - if MARKER not in original: - modified,count=re.subn(pat,lambda m:m.group(1)+ROUTES,original,count=1) - if count!=1:raise ValueError('无法定位 asyncRoutes 定义；该官方版本的路由结构可能不同，请人工集成') - else:modified=original - if V8_MARKER not in modified: - modified,count=re.subn(pat,lambda m:m.group(1)+V8_ROUTES,modified,count=1) - if count!=1:raise ValueError('无法注册 V8 业务页面') - print(f'官方工程: {root}\n文件目标: {target}\n待复制页面: {len(list(SOURCE.glob("*.vue")))}\n路由需要更新: {original!=modified}') - if dry_run:return + +def _extract_legacy_block(text: str, marker: str) -> tuple[int, int]: + start = text.index(marker) + # Old installer placed the marker immediately before its own route object. + pos = text.find('{', start) + if pos < 0: raise ValueError('旧路由没有对象起始符号') + depth = 0 + quoted = None + escape = False + for i in range(pos, len(text)): + c = text[i] + if quoted: + if escape: escape = False + elif c == '\\': escape = True + elif c == quoted: quoted = None + elif c in ('"', "'", '`'): quoted = c + elif c == '{': depth += 1 + elif c == '}': + depth -= 1 + if depth == 0: + end = i + 1 + if end < len(text) and text[end] == ',': end += 1 + # The marker and the block must be adjacent except whitespace. + if text[start + len(marker):pos].strip(): + raise ValueError('旧路由已人工修改，拒绝自动迁移') + return start, end + raise ValueError('旧路由结构不完整') + + +def transform_routes(text: str, migrate_legacy: bool = False) -> str: + if 'SITEFORGE_V819_ROUTES_BEGIN' in text or 'SITEFORGE_V819_ROUTES_END' in text: + if text.count(BEGIN) != 1 or text.count(END) != 1: + raise ValueError('V8.19 路由标记不完整') + a = text.index(BEGIN) + b = text.index(END) + len(END) + if text[a:b] != ROUTES.strip(): + raise ValueError('已安装的 SiteForge 路由被人工修改；请人工审核后升级') + return text + if any(m in text for m in LEGACY): + if not migrate_legacy: + raise ValueError('发现 V8 旧版路由；请备份后使用 --migrate-legacy 显式升级') + # Remove highest-offset blocks first. Never touch an unrelated route. + for m in sorted((m for m in LEGACY if m in text), key=lambda v:text.index(v), reverse=True): + a,b=_extract_legacy_block(text,m) + text=text[:a]+text[b:] + modified,n = ROUTE_RE.subn(lambda m:m.group(1)+ROUTES, text, count=1) + if n!=1: raise ValueError('无法识别 asyncRoutes 变量；需手动适配 Art 官方版本') + return modified + + +def _sha(data: bytes) -> str: + return hashlib.sha256(data).hexdigest() + + +def install(root: Path, dry_run: bool = True, verify: bool = False, + migrate_legacy: bool = False, overwrite_views: bool = False): + root = root.resolve() + route_file = root / 'src/router/routes/asyncRoutes.ts' + if not (root/'package.json').is_file() or not route_file.is_file(): + raise ValueError('不是受支持的 Art Design Pro 工程：缺少 package.json 或 asyncRoutes.ts') + current = route_file.read_text(encoding='utf-8') + new = transform_routes(current, migrate_legacy=migrate_legacy) + target = root/'src/views/siteforge' + sources = sorted(p for p in SOURCE.iterdir() if p.suffix in ('.vue','.ts') and p.is_file()) + if not sources: raise ValueError('本地业务页面资源缺失') + existing = [p for p in sources if (target/p.name).exists() and (target/p.name).read_bytes()!=p.read_bytes()] + if verify: + errors=[] + if current!=new: errors.append('路由未安装') + for src in sources: + out=target/src.name + if not out.is_file() or _sha(out.read_bytes()) != _sha(src.read_bytes()): + errors.append(src.name+' 缺失或不匹配') + if errors: raise ValueError('; '.join(errors)) + return {'installed':True,'views':len(sources),'routes':'verified'} + if existing and not overwrite_views and not dry_run: + raise ValueError('以下页面存在不同内容，拒绝覆盖：'+', '.join(p.name for p in existing)+'；请加 --overwrite-views') + result={'dry_run':dry_run,'routes_need_update':current!=new,'views':len(sources), + 'conflicting_views':[x.name for x in existing],'target':str(root)} + if dry_run:return result target.mkdir(parents=True,exist_ok=True) - for src in SOURCE.glob('*.vue'): - dest=target/src.name - if dest.exists():shutil.copy2(dest,dest.with_suffix('.vue.siteforge-backup')) - shutil.copy2(src,dest) - if modified!=original: - shutil.copy2(base,base.with_suffix('.ts.siteforge-backup')) - base.write_text(modified,encoding='utf-8') - print('业务页面与菜单已写入；下一步请配置 /api、/editor、/preview 代理并执行 pnpm build 完成验收。') + for src in sources: + out=target/src.name + if out.exists() and out.read_bytes()!=src.read_bytes(): + backup=out.with_name(out.name+'.siteforge-backup') + if not backup.exists():shutil.copy2(out,backup) + shutil.copy2(src,out) + if current!=new: + backup=route_file.with_name(route_file.name+'.siteforge-backup') + if not backup.exists():shutil.copy2(route_file,backup) + temp=route_file.with_suffix('.ts.siteforge-tmp') + try: + temp.write_text(new,encoding='utf-8') + os.replace(temp,route_file) + finally: + temp.unlink(missing_ok=True) + manifest={'siteforge_version':'8.21.3-dev.1','files':{p.name:_sha(p.read_bytes()) for p in sources}} + (target/'.siteforge-v819.json').write_text(json.dumps(manifest,indent=2),encoding='utf-8') + result['installed']=True + return result + if __name__=='__main__': - parser=argparse.ArgumentParser() - parser.add_argument('official_repo',type=Path) - parser.add_argument('--apply',action='store_true',help='执行源代码变更；不传则只检查') - args=parser.parse_args() - install(args.official_repo.resolve(),dry_run=not args.apply) + parser=argparse.ArgumentParser(description='SiteForge V8.19 → Art Design Pro 离线适配安装') + parser.add_argument('official_repo', type=Path) + parser.add_argument('--apply',action='store_true') + parser.add_argument('--verify',action='store_true') + parser.add_argument('--migrate-legacy',action='store_true') + parser.add_argument('--overwrite-views',action='store_true') + a=parser.parse_args() + try: + print(json.dumps(install(a.official_repo,dry_run=not(a.apply or a.verify),verify=a.verify, + migrate_legacy=a.migrate_legacy,overwrite_views=a.overwrite_views),ensure_ascii=False,indent=2)) + except ValueError as e: + parser.error(str(e)) diff --git a/scripts/migrate_sqlite_to_postgres.py b/scripts/migrate_sqlite_to_postgres.py new file mode 100644 index 0000000..61dd4e1 --- /dev/null +++ b/scripts/migrate_sqlite_to_postgres.py @@ -0,0 +1,30 @@ +#!/usr/bin/env python3 +"""Maintenance-only SQLite to clean PostgreSQL database migration.""" +from __future__ import annotations +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) +import argparse,json,sys +from app.sqlite_pg_transfer import migrate +from app.pg_disaster_recovery import RecoveryError + +def main(argv=None): + ap=argparse.ArgumentParser(description='Offline SQLite -> EMPTY PostgreSQL data migration') + ap.add_argument('--source',required=True,help='Existing SQLite file. Never modified.') + ap.add_argument('--confirmed-offline',action='store_true') + ap.add_argument('--report',help='Output machine-readable verification summary') + args=ap.parse_args(argv) + try: + result=migrate(args.source,confirmed_offline=args.confirmed_offline) + summary=json.dumps(result,ensure_ascii=False,indent=2) + if args.report: + from pathlib import Path + out=Path(args.report).resolve() + if out.exists():raise RecoveryError('Refuse overwriting prior validation report') + out.parent.mkdir(parents=True,exist_ok=True);out.write_text(summary,encoding='utf-8') + print(summary);return 0 + except (RecoveryError,OSError,ValueError) as ex: + print('MIGRATION FAILED: '+str(ex),file=sys.stderr);return 1 + +if __name__=='__main__':raise SystemExit(main()) diff --git a/scripts/pg_disaster_recovery.py b/scripts/pg_disaster_recovery.py new file mode 100644 index 0000000..0b6a635 --- /dev/null +++ b/scripts/pg_disaster_recovery.py @@ -0,0 +1,37 @@ +#!/usr/bin/env python3 +"""Offline PostgreSQL backup/verify/recovery CLI for administrators.""" +from __future__ import annotations +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) +import argparse +import json +import os +from pathlib import Path +from app import pg_disaster_recovery as pg + +def main(argv=None): + p=argparse.ArgumentParser(description='SiteForge offline PostgreSQL disaster recovery') + sub=p.add_subparsers(dest='operation',required=True) + b=sub.add_parser('backup');b.add_argument('--data',required=True);b.add_argument('--output',required=True) + b.add_argument('--confirmed-offline',action='store_true') + v=sub.add_parser('verify');v.add_argument('archive') + r=sub.add_parser('restore-new');r.add_argument('archive');r.add_argument('--data',required=True) + r.add_argument('--confirmed-offline',action='store_true') + args=p.parse_args(argv) + try: + if args.operation=='verify':value=pg.verify(args.archive) + else: + url=os.getenv('SITEFORGE_DATABASE_URL','') + if args.operation=='backup': + value=pg.backup(url,args.data,args.output,confirmed_offline=args.confirmed_offline) + else: + value=pg.restore_new(url,args.archive,args.data,confirmed_offline=args.confirmed_offline) + print(json.dumps(value,ensure_ascii=False,indent=2)) + return 0 + except (pg.RecoveryError,OSError,ValueError) as exc: + print('ERROR: '+str(exc),file=__import__('sys').stderr) + return 1 + +if __name__=='__main__':raise SystemExit(main()) diff --git a/scripts/regression_v817.py b/scripts/regression_v817.py new file mode 100644 index 0000000..a39a548 --- /dev/null +++ b/scripts/regression_v817.py @@ -0,0 +1,130 @@ +#!/usr/bin/env python3 +"""V8.21 repeatable integration regression with per-batch deadlines and isolation. + +Runs pytest against only the local repository. Timeout cleanup kills the whole +process group on POSIX rather than leaving orphan pytest/Worker children. +Nonzero, flaky and timed-out runs always fail the quality gate. +""" +from __future__ import annotations +import argparse +import datetime as dt +import html +import json +import os +import re +import signal +import subprocess +import sys +import time +from dataclasses import asdict, dataclass +from pathlib import Path + +ROOT=Path(__file__).resolve().parent.parent + +@dataclass +class Run: + label: str + modules: list[str] + status: str + seconds: float + exit_code: int | None + passed: int + log: str + + +def run_pytest(label: str, modules: list[str], seconds: int, reports: Path, env: dict[str,str]) -> Run: + args=[sys.executable,'-m','pytest','-vv','--tb=short','--disable-warnings','--no-header',*modules] + filename=re.sub(r'[^a-zA-Z0-9_-]+','-',label)+'.log' + path=reports/filename + began=time.monotonic() + flags={'start_new_session':True} if os.name!='nt' else {'creationflags':subprocess.CREATE_NEW_PROCESS_GROUP} + expired=False + with path.open('wb') as out: + out.write(('$ '+' '.join(args)+'\n').encode('utf-8')) + out.flush() + process=subprocess.Popen(args,cwd=ROOT,env=env,stdout=out,stderr=subprocess.STDOUT,**flags) + try: + process.wait(timeout=seconds) + except subprocess.TimeoutExpired: + expired=True + if os.name!='nt': + try: os.killpg(process.pid,signal.SIGTERM) + except ProcessLookupError: pass + else: process.terminate() + try: process.wait(timeout=4) + except subprocess.TimeoutExpired: + if os.name!='nt': + try: os.killpg(process.pid,signal.SIGKILL) + except ProcessLookupError: pass + else: process.kill() + process.wait(timeout=5) + out.write(f'\nTIMEOUT: deadline={seconds}s; process group terminated\n'.encode()) + content=path.read_text(encoding='utf-8',errors='replace') + m=re.findall(r'(?m)(\d+) passed(?:,| in |\s*\()',content) + passed=int(m[-1]) if m else 0 + status='TIMEOUT' if expired else ('PASS' if process.returncode==0 and passed>0 else 'FAIL') + return Run(label,modules,status,round(time.monotonic()-began,2),process.returncode if not expired else None,passed,str(path)) + + +def write_reports(runs: list[Run],prefix: Path,modules_count: int,repeat: int): + statuses={x:sum(r.status==x for r in runs) for x in ('PASS','FAIL','TIMEOUT')} + batches=[r for r in runs if re.fullmatch(r'round\d+-batch\d+',r.label)] + bad=[r for r in batches if r.status!='PASS'] + result={'version':'8.21.0-dev.1','date':dt.datetime.now(dt.timezone.utc).isoformat(), + 'modules':modules_count,'repeats':repeat,'status':'PASS' if not bad else 'FAIL', + 'tests_last_complete_round':sum(r.passed for r in batches if r.label.startswith(f'round{repeat}-')), + 'counts':statuses,'failures':[asdict(x) for x in bad], + 'runs':[asdict(x) for x in runs], + 'note':'Timed out, failing, or recovered-on-retry tests are not considered passing.'} + prefix.parent.mkdir(parents=True,exist_ok=True) + prefix.with_suffix('.json').write_text(json.dumps(result,ensure_ascii=False,indent=2),encoding='utf-8') + lines=['# SiteForge V8.21 集成回归','',f"状态：**{result['status']}**；模块：{modules_count}；重复轮次：{repeat}",'', + '| 批次 | 状态 | 通过用例 | 秒 | 日志 |','|---|---|---:|---:|---|'] + for r in runs: + lines.append(f'| {r.label} | {r.status} | {r.passed} | {r.seconds} | {Path(r.log).name} |') + lines+=['','失败、超时或重跑后通过均视为验收未通过；详见日志。',''] + prefix.with_suffix('.md').write_text('\n'.join(lines),encoding='utf-8') + rows=''.join(f'{html.escape(r.label)}{r.status}{r.passed}{r.seconds}{html.escape(Path(r.log).name)}' for r in runs) + doc=f'''SiteForge V8.21 · 自动化回归

SiteForge · V8.21 集成回归

结果：{result['status']} · {modules_count} 模块 · {repeat} 轮

每个测试批次有严格超时，发生异常时隔离失败模块并留存原始日志。任何超时均阻止上线判定。

{rows}
批次状态通过用例耗时（秒）日志
''' + prefix.with_suffix('.html').write_text(doc,encoding='utf-8') + return result + + +def main(argv=None): + ap=argparse.ArgumentParser(description='Timeout-safe repeatable SiteForge regression') + ap.add_argument('--batch-size',type=int,default=4) + ap.add_argument('--timeout',type=int,default=90,help='Single pytest batch timeout seconds') + ap.add_argument('--module-timeout',type=int,default=50) + ap.add_argument('--repeat',type=int,default=1) + ap.add_argument('--report',type=Path,default=Path('reports/v820-regression')) + args=ap.parse_args(argv) + if not 1<=args.batch_size<=50 or not 1<=args.repeat<=10 or args.timeout<5 or args.module_timeout<5: + ap.error('Invalid batch-size, repeat, or timeout') + modules=sorted('tests/'+p.name for p in (ROOT/'tests').glob('test_*.py')) + if not modules:ap.error('No tests/test_*.py modules') + logs=args.report.parent/(args.report.name+'_logs');logs.mkdir(parents=True,exist_ok=True) + env=os.environ.copy() + env.setdefault('PYTHONUNBUFFERED','1') + runs=[] + for r in range(1,args.repeat+1): + for index in range(0,len(modules),args.batch_size): + batch=modules[index:index+args.batch_size] + label=f'round{r}-batch{index//args.batch_size+1}' + print(f'RUN {label}: {len(batch)} modules',flush=True) + result=run_pytest(label,batch,args.timeout,logs,env) + runs.append(result) + print(f' {result.status} / {result.passed} passed / {result.seconds}s',flush=True) + if result.status!='PASS': + print(' Isolating modules (original failure is retained)',flush=True) + for i,mod in enumerate(batch,1): + isolated=run_pytest(f'{label}-isolated-{i}',[mod],args.module_timeout,logs,env) + runs.append(isolated) + print(f' {Path(mod).name}: {isolated.status} ({isolated.seconds}s)',flush=True) + # Do not start further rounds after a non-passing batch. + break + if any(x.status!='PASS' and re.fullmatch(r'round\d+-batch\d+',x.label) for x in runs):break + result=write_reports(runs,args.report,len(modules),args.repeat) + print(f"RESULT {result['status']}: {len(modules)} modules; report={args.report}.json",flush=True) + return 0 if result['status']=='PASS' else 1 + +if __name__=='__main__':sys.exit(main()) diff --git a/scripts/regression_v820.py b/scripts/regression_v820.py new file mode 100644 index 0000000..f10bf37 --- /dev/null +++ b/scripts/regression_v820.py @@ -0,0 +1,85 @@ +#!/usr/bin/env python3 +"""Deterministic, subprocess-isolated pytest regression for V8.21. + +All outcomes and raw stdout are preserved. A timed-out or failing batch is a +hard failure, not silently retried into a green result. +""" +from __future__ import annotations +import argparse +import datetime +import html +import json +import os +import re +import signal +import subprocess +import sys +import time +from pathlib import Path + +ROOT=Path(__file__).resolve().parents[1] + + +def launch(modules,seconds): + started=time.monotonic() + try: + process=subprocess.run([sys.executable,'-m','pytest','-q',*modules], + cwd=ROOT,stdout=subprocess.PIPE,stderr=subprocess.STDOUT, + text=True,timeout=seconds) + output=process.stdout + code=process.returncode + status='PASS' if code==0 else 'FAIL' + except subprocess.TimeoutExpired as exc: + output=(exc.stdout or b'') + if isinstance(output,bytes):output=output.decode('utf-8','replace') + output+='\nTIMEOUT: pytest process terminated after deadline. Check Worker child processes.\n' + code=None;status='TIMEOUT' + m=re.search(r'(\d+) passed(?:\s|,)',output) + return {'status':status,'passed':int(m.group(1)) if status=='PASS' and m else 0, + 'duration_seconds':round(time.monotonic()-started,2),'exit_code':code,'output':output} + + +def main(argv=None): + p=argparse.ArgumentParser(description='SiteForge V8.21 independent pytest batch gate') + p.add_argument('--batch-size',type=int,default=4) + p.add_argument('--repeat',type=int,default=1) + p.add_argument('--timeout',type=int,default=80) + p.add_argument('--report',type=Path,default=Path('reports/v821-regression')) + args=p.parse_args(argv) + if not 1<=args.batch_size<=10 or not 1<=args.repeat<=5 or not 10<=args.timeout<=600:p.error('invalid bounds') + modules=sorted('tests/'+f.name for f in (ROOT/'tests').glob('test_*.py')) + if not modules:p.error('no pytest tests found') + report=args.report if args.report.is_absolute() else ROOT/args.report + logs=report.parent/(report.name+'_logs') + logs.mkdir(parents=True,exist_ok=True) + results=[] + for round_num in range(1,args.repeat+1): + for index in range(0,len(modules),args.batch_size): + group=modules[index:index+args.batch_size] + name=f'round{round_num}-batch{index//args.batch_size+1}' + print('RUN',name,flush=True) + result=launch(group,args.timeout) + log=logs/(name+'.log') + log.write_text('$ pytest -q '+' '.join(group)+'\n'+result.pop('output'),encoding='utf-8') + result.update({'name':name,'modules':group,'log':str(log.relative_to(ROOT))}) + results.append(result) + print(result['status'],result['passed'],'passed',result['duration_seconds'],'sec',flush=True) + if result['status']!='PASS':break + if results[-1]['status']!='PASS':break + success=len(results)==args.repeat*((len(modules)+args.batch_size-1)//args.batch_size) and all(x['status']=='PASS' for x in results) + info={'version':'8.21.0-dev.1','generated_at':datetime.datetime.now(datetime.timezone.utc).isoformat(), + 'status':'PASS' if success else 'FAIL','test_modules':len(modules),'repeats':args.repeat, + 'tests_per_round':sum(x['passed'] for x in results if x['name'].startswith('round1-')), + 'total_passes':sum(x['passed'] for x in results),'batches':results, + 'environment_note':'pytest local fixtures only; Docker/PG/Redis/browser/real WordPress not inferred as passed.'} + report.parent.mkdir(parents=True,exist_ok=True) + report.with_suffix('.json').write_text(json.dumps(info,ensure_ascii=False,indent=2),encoding='utf-8') + header='\n'.join(['# SiteForge V8.21 完整自动化回归','',f"**{info['status']}** — {info['test_modules']} 模块 / {info['tests_per_round']} 项每轮 / {args.repeat} 轮",'', + '| 批次 | 结果 | 通过用例 | 耗时 | 日志 |','|---|---|---:|---:|---|']) + table='\n'.join(f"| {r['name']} | {r['status']} | {r['passed']} | {r['duration_seconds']} 秒 | {r['log']} |" for r in results) + report.with_suffix('.md').write_text(header+'\n'+table+'\n\n真实部署与外部服务另行验收。\n',encoding='utf-8') + trs=''.join(f'{html.escape(r["name"])}{html.escape(r["status"])}{r["passed"]}{r["duration_seconds"]}' for r in results) + report.with_suffix('.html').write_text('''V8.21 回归报告

SiteForge V8.21 回归验收

'''+info['status']+'

每轮 '+str(info['tests_per_round'])+' 项自动化测试 · '+str(args.repeat)+' 轮 · 无外部环境实测保证

'+trs+'
批次结果通过秒数

请参阅 JSON、Markdown 和原始测试日志。真实客户站点迁移仍需专项验收。

',encoding='utf-8') + return 0 if success else 1 + +if __name__=='__main__':raise SystemExit(main()) diff --git a/scripts/regression_v821.py b/scripts/regression_v821.py new file mode 100644 index 0000000..96c8fc5 --- /dev/null +++ b/scripts/regression_v821.py @@ -0,0 +1,102 @@ +#!/usr/bin/env python3 +"""Deterministic, subprocess-isolated pytest regression for V8.21. + +All outcomes and raw stdout are preserved. A timed-out or failing batch is a +hard failure, not silently retried into a green result. +""" +from __future__ import annotations +import argparse +import datetime +import html +import json +import os +import re +import signal +import subprocess +import sys +import time +from pathlib import Path + +ROOT=Path(__file__).resolve().parents[1] + + +def launch(modules,seconds): + """Execute pytest in a disposable process group and bound inherited pipes. + + A test can spawn Worker descendants; killing only the pytest PID may leave + children holding stdout open. On timeout, terminate the entire group. + """ + started=time.monotonic() + kwargs={'cwd':ROOT,'stdout':subprocess.PIPE,'stderr':subprocess.STDOUT, + 'text':True,'encoding':'utf-8','errors':'replace'} + if os.name=='nt': + kwargs['creationflags']=subprocess.CREATE_NEW_PROCESS_GROUP + else: + kwargs['start_new_session']=True + child=subprocess.Popen([sys.executable,'-m','pytest','-q',*modules],**kwargs) + try: + output,_=child.communicate(timeout=seconds) + code=child.returncode + status='PASS' if code==0 else 'FAIL' + except subprocess.TimeoutExpired: + if os.name=='nt': + subprocess.run(['taskkill','/PID',str(child.pid),'/T','/F'], + capture_output=True,timeout=10,check=False) + if child.poll() is None:child.kill() + else: + try:os.killpg(child.pid,signal.SIGKILL) + except ProcessLookupError:pass + try:output,_=child.communicate(timeout=10) + except subprocess.TimeoutExpired: + child.kill();output,_=child.communicate(timeout=5) + output+='\nTIMEOUT: pytest process group terminated after deadline.\n' + code=None;status='TIMEOUT' + m=re.search(r'(\d+) passed(?:\s|,)',output) + return {'status':status,'passed':int(m.group(1)) if status=='PASS' and m else 0, + 'duration_seconds':round(time.monotonic()-started,2),'exit_code':code,'output':output} + + +def main(argv=None): + p=argparse.ArgumentParser(description='SiteForge V8.21 independent pytest batch gate') + p.add_argument('--batch-size',type=int,default=4) + p.add_argument('--repeat',type=int,default=1) + p.add_argument('--timeout',type=int,default=80) + p.add_argument('--report',type=Path,default=Path('reports/v821-regression')) + args=p.parse_args(argv) + if not 1<=args.batch_size<=10 or not 1<=args.repeat<=5 or not 10<=args.timeout<=600:p.error('invalid bounds') + modules=sorted('tests/'+f.name for f in (ROOT/'tests').glob('test_*.py')) + if not modules:p.error('no pytest tests found') + report=args.report if args.report.is_absolute() else ROOT/args.report + logs=report.parent/(report.name+'_logs') + logs.mkdir(parents=True,exist_ok=True) + results=[] + for round_num in range(1,args.repeat+1): + for index in range(0,len(modules),args.batch_size): + group=modules[index:index+args.batch_size] + name=f'round{round_num}-batch{index//args.batch_size+1}' + print('RUN',name,flush=True) + result=launch(group,args.timeout) + log=logs/(name+'.log') + log.write_text('$ pytest -q '+' '.join(group)+'\n'+result.pop('output'),encoding='utf-8') + result.update({'name':name,'modules':group,'log':str(log.relative_to(ROOT))}) + results.append(result) + print(result['status'],result['passed'],'passed',result['duration_seconds'],'sec',flush=True) + if result['status']!='PASS':break + if results[-1]['status']!='PASS':break + success=len(results)==args.repeat*((len(modules)+args.batch_size-1)//args.batch_size) and all(x['status']=='PASS' for x in results) + info={'version':'8.21.3-dev.1','generated_at':datetime.datetime.now(datetime.timezone.utc).isoformat(), + 'status':'PASS' if success else 'FAIL','test_modules':len(modules),'repeats':args.repeat, + 'tests_per_round':sum(x['passed'] for x in results if x['name'].startswith('round1-')), + 'total_passes':sum(x['passed'] for x in results),'batches':results, + 'environment_note':'pytest local fixtures only; Docker/PG/Redis/browser/real WordPress not inferred as passed.'} + report.parent.mkdir(parents=True,exist_ok=True) + report.with_suffix('.json').write_text(json.dumps(info,ensure_ascii=False,indent=2),encoding='utf-8') + header='\n'.join(['# SiteForge V8.21 完整自动化回归','',f"**{info['status']}** — {info['test_modules']} 模块 / {info['tests_per_round']} 项每轮 / {args.repeat} 轮",'', + '| 批次 | 结果 | 通过用例 | 耗时 | 日志 |','|---|---|---:|---:|---|']) + table='\n'.join(f"| {r['name']} | {r['status']} | {r['passed']} | {r['duration_seconds']} 秒 | {r['log']} |" for r in results) + report.with_suffix('.md').write_text(header+'\n'+table+'\n\n真实部署与外部服务另行验收。\n',encoding='utf-8') + trs=''.join(f'{html.escape(r["name"])}{html.escape(r["status"])}{r["passed"]}{r["duration_seconds"]}' for r in results) + report.with_suffix('.html').write_text('''V8.21 回归报告

SiteForge V8.21 回归验收

'''+info['status']+'

每轮 '+str(info['tests_per_round'])+' 项自动化测试 · '+str(args.repeat)+' 轮 · 无外部环境实测保证

'+trs+'
批次结果通过秒数

请参阅 JSON、Markdown 和原始测试日志。真实客户站点迁移仍需专项验收。

',encoding='utf-8') + return 0 if success else 1 + +if __name__=='__main__':raise SystemExit(main()) diff --git a/scripts/siteforge_v817_audit.py b/scripts/siteforge_v817_audit.py new file mode 100644 index 0000000..e351cb2 --- /dev/null +++ b/scripts/siteforge_v817_audit.py @@ -0,0 +1,444 @@ +#!/usr/bin/env python3 +"""SiteForge V8.18 read-only enterprise acceptance audit. + +Runs only non-destructive inspections. No migrations, deploys, account operations, +secret dumps, or changes to a SiteForge instance are performed. +""" +from __future__ import annotations + +import argparse +import datetime as dt +import html +import ipaddress +import json +import os +import re +import shutil +import subprocess +import sys +import urllib.error +import urllib.parse +import urllib.request +from collections import Counter +from dataclasses import asdict, dataclass +from pathlib import Path +from typing import Any +from html.parser import HTMLParser + +CATEGORIES = {"repository": "源码结构", "http": "HTTP 健康探针", "docker": "Docker / Worker", "postgres": "PostgreSQL", "redis": "Redis", "build": "静态构建 / SEO", "release": "发布门禁"} + +@dataclass +class Check: + code: str + category: str + status: str # pass | fail | warn | skip + description: str + detail: str = "" + remediation: str = "" + +class Report: + def __init__(self, args): + self.args = args + self.checks: list[Check] = [] + def add(self, code, category, status, description, detail="", remediation=""): + assert status in {"pass", "fail", "warn", "skip"} + # Never include raw environment values or exception objects containing DSNs. + self.checks.append(Check(code, category, status, description, str(detail), remediation)) + def data(self): + counts = Counter(c.status for c in self.checks) + return { + "tool_version": "8.21.1-dev.1", "generated_at": dt.datetime.now(dt.timezone.utc).isoformat(), + "mode": "read-only", "live_production_verified": False, + "note": "本报告只证明实际执行并标记 PASS 的只读检查；SKIP/WARN 不等同通过，未进行真实发布。", + "summary": {x: counts[x] for x in ("pass", "fail", "warn", "skip")}, + "selected_checks_clear": bool(self.checks) and counts["fail"] == 0 and counts["warn"] == 0 and counts["skip"] == 0, + "production_ready": False, # human approval + end-to-end validation cannot be automated by this kit + "checks": [asdict(c) for c in self.checks] + } + +def audit_repo(r: Report, repo: Path): + p = repo.resolve() + items = { + "app": "应用代码 app/", "app/builder.py": "静态构建器 app/builder.py", + "app/multilingual.py": "多语言模块 app/multilingual.py", + "app/templates/workspace.html": "工作区模板", "app/static/workspace.js": "后台交互脚本", + "scripts/check.sh": "Linux 检查脚本", "scripts/http_end_to_end.py": "HTTP 端到端测试", + "scripts/verify_pg_bootstrap.py": "PG 隔离验证", "scripts/browser_smoke.py": "浏览器烟测", + "compose.enterprise.yaml": "企业 Compose 配置" + } + if not p.is_dir(): + r.add("repo.root", "repository", "fail", "仓库路径存在", "指定路径不存在", "设置 --repo 为 SiteForge V8.16 源码根目录") + return + r.add("repo.root", "repository", "pass", "仓库根目录可访问", "仅进行只读检查") + for name, label in items.items(): + ok = (p / name).exists() + r.add("repo." + name.replace("/", "."), "repository", "pass" if ok else "warn", label, + "存在" if ok else "在当前源码中未找到", "核对 V8.16 工程是否解压完整" if not ok else "") + ps = list((p / "app").rglob("*.py")) if (p / "app").is_dir() else [] + if ps: + import ast + errors = [] + for f in ps: + try: + ast.parse(f.read_text(encoding="utf-8-sig"), filename=str(f.relative_to(p))) + except (SyntaxError, UnicodeError, OSError) as exc: + errors.append(f"{f.relative_to(p)}:{getattr(exc, 'lineno', '?')}") + if len(errors) >= 5: break + r.add("repo.python_syntax", "repository", "fail" if errors else "pass", + "Python 源码语法", ", ".join(errors) if errors else f"解析通过 {len(ps)} 个文件") + else: + r.add("repo.python_syntax", "repository", "skip", "Python 源码语法", "未找到 app/*.py") + if (p / ".env").exists(): + try: + text = (p / ".env").read_text(encoding="utf-8", errors="replace") + bad = [] + for key in ("SITEFORGE_COOKIE_SECURE",): + m = re.search(rf"(?m)^\s*{key}\s*=\s*(.+?)\s*$", text) + if m and m.group(1).strip().strip('"\'').lower() in ("false", "0", "no", "off"): + bad.append(key) + r.add("repo.env_security", "repository", "warn" if bad else "pass", ".env 公开部署安全配置", + "存在应检查的非安全设置（仅字段名）：" + ", ".join(bad) if bad else "未发现显式关闭安全 Cookie 的配置；这并非完整安全审计", + "公网环境启用 SITEFORGE_COOKIE_SECURE=true 并确认 HTTPS" if bad else "") + except OSError: + r.add("repo.env_security", "repository", "warn", ".env 配置读取", "读取失败") + else: + r.add("repo.env_security", "repository", "skip", ".env 安全配置", "缺少 .env；不打印或记录凭据") + +def _local_host(url: str) -> bool: + parsed = urllib.parse.urlsplit(url) + if parsed.scheme not in ("http", "https") or not parsed.hostname or parsed.username or parsed.password: + return False + if parsed.hostname == "localhost": + return True + try: + return ipaddress.ip_address(parsed.hostname).is_loopback + except ValueError: + return False + +class NoRedirect(urllib.request.HTTPRedirectHandler): + def redirect_request(self, req, fp, code, msg, headers, newurl): + return None + +def _probe(url: str, limit: int = 256 * 1024) -> tuple[int, str, str]: + req = urllib.request.Request(url, headers={"User-Agent": "SiteForgeAcceptance/8.17", "Accept": "application/json,text/html"}) + op = urllib.request.build_opener(NoRedirect) + try: + with op.open(req, timeout=4) as resp: + body = resp.read(limit + 1) + if len(body) > limit: + return resp.status, "", "响应超过上限" + return resp.status, body.decode("utf-8", errors="replace"), "" + except urllib.error.HTTPError as exc: + return exc.code, "", "返回非 2xx 或重定向" + except (urllib.error.URLError, TimeoutError, OSError, ValueError): + return 0, "", "无法连接或请求超时" + +def audit_http(r: Report, base: str, allow_remote: bool): + p = urllib.parse.urlsplit(base) + if not _local_host(base) and not allow_remote: + r.add("http.scope", "http", "fail", "检查目标授权范围", + "默认仅允许 localhost / 回环地址", "外部已授权的测试域名需要明确传入 --allow-remote") + return + if p.scheme not in ("http", "https") or not p.netloc or p.query or p.fragment or p.username or p.password: + r.add("http.scope", "http", "fail", "检查目标 URL", "URL 无效或包含不允许的参数") + return + root = f"{p.scheme}://{p.netloc}" + p.path.rstrip("/") + r.add("http.scope", "http", "pass", "检查目标授权范围", "只读取健康接口，不提交数据") + for endpoint in ("/api/health", "/api/ready"): + status, body, error = _probe(root + endpoint) + label = "存活探针" if endpoint.endswith("health") else "就绪探针（数据库与存储）" + key = "http.health" if endpoint.endswith("health") else "http.ready" + result = "pass" if status == 200 and not error else "fail" + detail = f"HTTP {status or '不可用'}" + if body: + try: + j = json.loads(body) + detail += "; response.status=" + str(j.get("status", "未提供"))[:36] + if isinstance(j.get("status"), str) and j["status"].lower() in ("unavailable", "error", "failed"): + result = "fail" + except (json.JSONDecodeError, AttributeError): + detail += "; 非 JSON 响应" + result = "fail" + if error: detail += "; " + error + r.add(key, "http", result, label, detail, "核对 Web/DB/data 卷状态及日志；不得以 /api/health 代替 /api/ready" if result == "fail" else "") + status, _, error = _probe(root + "/", limit=1024 * 1024) + r.add("http.entry", "http", "pass" if status in (200, 301, 302, 303, 307, 308) else "warn", + "后台入口可访问", f"HTTP {status or '不可用'}" + (f"；{error}" if error else ""), "检查反向代理、登录页和静态资源" if status not in (200, 301, 302, 303, 307, 308) else "") + +def audit_docker(r: Report, repo: Path, compose_file: str): + if not shutil.which("docker"): + r.add("docker.executable", "docker", "skip", "Docker CLI 可用", "本机未发现 docker 命令") + return + cmd = ["docker", "compose"] + if compose_file: cmd += ["-f", compose_file] + try: + # No `config` output: resolved Compose may contain environment secrets. + check = subprocess.run(cmd + ["config", "-q"], cwd=repo, capture_output=True, timeout=15) + except (OSError, subprocess.TimeoutExpired): + r.add("docker.compose_config", "docker", "fail", "Compose 配置可解析", "无法执行命令或超时") + return + r.add("docker.compose_config", "docker", "pass" if check.returncode == 0 else "fail", "Compose 配置可解析", + "退出码 " + str(check.returncode) + "（敏感输出已隐藏）") + if check.returncode: return + try: + ps = subprocess.run(cmd + ["ps", "--format", "json"], cwd=repo, capture_output=True, timeout=15) + except (OSError, subprocess.TimeoutExpired): + r.add("docker.compose_ps", "docker", "fail", "容器状态检查", "无法执行命令或超时") + return + if ps.returncode: + r.add("docker.compose_ps", "docker", "fail", "容器状态检查", "Compose ps 失败（原始错误已隐藏）") + return + raw = ps.stdout.decode("utf-8", errors="replace").strip() + records = [] + try: + payload = json.loads(raw or "[]") + records = payload if isinstance(payload, list) else [payload] + except json.JSONDecodeError: + try: + records = [json.loads(x) for x in raw.splitlines() if x.strip()] + except json.JSONDecodeError: + r.add("docker.compose_ps", "docker", "warn", "容器状态检查", "无法解析 Compose JSON 版本格式") + return + if not records: + r.add("docker.compose_ps", "docker", "fail", "容器已启动", "未发现运行服务") + return + for rec in records: + service = str(rec.get("Service") or rec.get("Name") or "unknown")[:64] + state = str(rec.get("State", "unknown")).lower() + health = str(rec.get("Health", "")).lower() + ok = state == "running" and health in ("", "healthy", "none") + r.add("docker.service." + re.sub(r"[^a-z0-9_-]", "_", service.lower()), "docker", "pass" if ok else "fail", + f"服务 {service} 运行及健康", f"state={state}; health={health or '未报告'}") + if not any("worker" in str(x.get("Service", "")).lower() for x in records): + r.add("docker.worker", "docker", "warn", "独立 Worker 服务", "ps 中未找到名称含 worker 的服务", "核对企业 Compose 服务命名及独立进程") + +def audit_postgres(r: Report): + dsn = os.getenv("SITEFORGE_DATABASE_URL", "") + if not dsn.lower().startswith(("postgresql://", "postgres://")): + r.add("postgres.config", "postgres", "skip", "PostgreSQL 真实只读检查", "未配置 PostgreSQL DSN 环境变量") + return + try: + import psycopg + except ImportError: + r.add("postgres.driver", "postgres", "skip", "PostgreSQL 驱动", "未安装 psycopg（不进行写入测试）") + return + try: + with psycopg.connect(dsn, connect_timeout=4, options="-c default_transaction_read_only=on") as con: + with con.cursor() as cur: + cur.execute("SELECT 1") + good = cur.fetchone()[0] == 1 + con.rollback() + r.add("postgres.query", "postgres", "pass" if good else "fail", "PostgreSQL 只读连接 SELECT 1", + "查询成功（凭据/地址均不写入报告）" if good else "返回结果异常") + except Exception: + r.add("postgres.query", "postgres", "fail", "PostgreSQL 只读连接 SELECT 1", + "连接或查询失败（异常详情已隐藏，避免泄露 DSN）", "核对隔离环境、网络、TLS、只读账号与连接设置") + +def audit_redis(r: Report): + url = os.getenv("SITEFORGE_REDIS_URL", "") + if not url.lower().startswith(("redis://", "rediss://")): + r.add("redis.config", "redis", "skip", "Redis 真实只读检查", "未配置 SITEFORGE_REDIS_URL") + return + try: import redis + except ImportError: + r.add("redis.driver", "redis", "skip", "Redis 驱动", "未安装 redis（不进行写入测试）") + return + try: + client = redis.Redis.from_url(url, socket_connect_timeout=4, socket_timeout=4) + good = bool(client.ping()) + client.close() + r.add("redis.ping", "redis", "pass" if good else "fail", "Redis PING 连接", "PING 成功" if good else "PING 响应异常") + except Exception: + r.add("redis.ping", "redis", "fail", "Redis PING 连接", "连接失败（异常详情已隐藏）", "核对 Redis 凭据、TLS、DNS、防火墙") + +class Analyzer(HTMLParser): + def __init__(self): + super().__init__(convert_charrefs=True) + self.lang = "" + self.canonicals = [] + self.links = [] + self.hreflangs = [] + def handle_starttag(self, tag, attrs): + a = dict(attrs) + if tag == "html": self.lang = a.get("lang", "") + if tag == "a" and a.get("href"): self.links.append(a["href"]) + if tag == "link": + rel = (a.get("rel") or "").lower().split() + if "canonical" in rel: self.canonicals.append(a.get("href", "")) + if "alternate" in rel and a.get("hreflang"): self.hreflangs.append((a["hreflang"], a.get("href", ""))) + +def normalized_route(raw: str) -> str | None: + s = (raw or "").strip() + if not s or s.startswith("#"): return None + if not s.startswith("/"): return None + p = urllib.parse.urlsplit(s) + if p.query or p.fragment: return None + un = urllib.parse.unquote(p.path) + if "\\" in un or "\x00" in un or any(x in ("..", ".") for x in un.split("/")): + return None + if "//" in un: return None + return un + +def path_for_route(build: Path, route: str) -> Path | None: + if route == "/": return build / "index.html" + rel = route.lstrip("/") + p = build / rel / "index.html" if route.endswith("/") else build / rel + if p.suffix == "": p = build / rel / "index.html" + # resolve may traverse symlinks - do not open files outside build root + root = build.resolve() + actual = p.resolve() + if not actual.is_relative_to(root): return None + if p.is_dir(): p = p / "index.html" + return p + +def audit_build(r: Report, build: Path, baseline: Path | None): + if not build.is_dir(): + r.add("build.root", "build", "fail", "静态构建目录", "构建目录不存在") + return + files = sorted(build.rglob("*.html")) + if not files: + r.add("build.html", "build", "fail", "已生成 HTML 页面", "未找到 HTML 文件") + return + r.add("build.html", "build", "pass", "已生成 HTML 页面", f"发现 {len(files)} 个 HTML 文件") + missing_lang, bad_canon, dup_canon, missing_internal, bad_hreflang = [], [], [], [], [] + scanned = 0 + for f in files[:10000]: + if f.is_symlink() or not f.resolve().is_relative_to(build.resolve()): continue + try: + a = Analyzer() + a.feed(f.read_text(encoding="utf-8", errors="replace")) + except (OSError, ValueError): + continue + scanned += 1 + rel = str(f.relative_to(build)) + if not a.lang.strip(): missing_lang.append(rel) + if len(a.canonicals) > 1: dup_canon.append(rel) + for c in a.canonicals: + if not c.startswith("https://"): bad_canon.append(rel) + for lang, href in a.hreflangs: + if not re.fullmatch(r"[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{2,8})*|x-default", lang) or not href.startswith("https://"): + bad_hreflang.append(rel) + for link in a.links: + # SiteForge static output may include absolute route links. Do not resolve + # /preview/... against build output; those are environment-specific. + route = normalized_route(link) + if route is not None: + target = path_for_route(build, route) + if target is not None and not target.is_file(): + missing_internal.append(f"{rel} -> {route}") + if len(files) > 10000: + r.add("build.scan_limit", "build", "warn", "扫描 HTML 数量", "超过 10000；仅扫描前 10000 个") + for code, label, values, severity, solution in [ + ("build.lang", "HTML lang 属性", missing_lang, "warn", "为多语言页面明确设置 HTML lang"), + ("build.canonical_duplicate", "同页 canonical 唯一", dup_canon, "fail", "一页只能存在一条 canonical"), + ("build.canonical_scheme", "绝对 HTTPS canonical", bad_canon, "warn", "生产域名配置完成后重新构建"), + ("build.hreflang", "hreflang 语言标记与 HTTPS 地址", bad_hreflang, "warn", "只为已发布且审核过的翻译输出 alternate"), + ("build.internal_links", "站内链接对应静态文件", missing_internal, "fail", "修复失效路径或添加正确重定向")]: + r.add(code, "build", severity if values else "pass", label, + f"问题 {len(values)} 项；样例：" + "; ".join(values[:6]) if values else f"扫描 {scanned} 个文件", solution if values else "") + sitemap = build / "sitemap.xml" + r.add("build.sitemap", "build", "pass" if sitemap.is_file() else "warn", "Sitemap 文件", "存在" if sitemap.is_file() else "不存在") + robots = build / "robots.txt" + r.add("build.robots", "build", "pass" if robots.is_file() else "warn", "robots.txt", "存在" if robots.is_file() else "不存在") + if baseline is not None: + if not baseline.is_file(): + r.add("build.url_baseline", "build", "fail", "旧站 URL 清单", "基线文件不存在") + else: + routes, invalid = set(), [] + for idx, s in enumerate(baseline.read_text(encoding="utf-8-sig").splitlines(), 1): + if not s.strip() or s.lstrip().startswith("#"): continue + route = normalized_route(s) + if route is None: invalid.append(idx) + else: routes.add(route) + misses = sorted(path for path in routes if not (path_for_route(build, path) or Path("/__invalid__")).is_file()) + r.add("build.url_baseline", "build", "fail" if invalid or misses else "pass", "旧 URL 1:1 路径覆盖", + f"清单 {len(routes)} 条，缺失 {len(misses)} 条，非法输入行 {len(invalid)} 条；缺失样例 " + ", ".join(misses[:8]), + "不要静默更改旧站 SEO 路径；缺失 URL 必须修复或提供已审核 301 映射" if misses or invalid else "") + +def release_gate(r: Report, evidence: Path | None): + # The kit NEVER gives a pass for production readiness without signed-off evidence. + required = ["isolated_pg", "redis_ping", "docker_health", "backup_restore", "browser_smoke", + "wordpress_url_parity", "staging_deploy", "rollback", "production_approval", "art_design_pro"] + if evidence is None: + r.add("release.evidence", "release", "skip", "正式发布证据表", "未提供 --evidence；不会宣称生产验收完成") + return + if not evidence.is_file(): + r.add("release.evidence", "release", "fail", "正式发布证据表", "找不到 evidence JSON") + return + try: + obj = json.loads(evidence.read_text(encoding="utf-8")) + except (json.JSONDecodeError, OSError): + r.add("release.evidence", "release", "fail", "正式发布证据表", "不是可解析 JSON") + return + for key in required: + val = obj.get(key) + # Validate dates/links/owners, not merely booleans. + valid = isinstance(val, dict) and val.get("status") == "passed" and bool(val.get("operator")) and bool(val.get("date")) and bool(val.get("evidence")) + r.add("release." + key, "release", "pass" if valid else "warn", f"签字验收：{key}", + "证据字段完整（不验证证据真实性）" if valid else "尚缺 passed/operator/date/evidence 字段", + "填入真实执行记录，未通过时禁止正式切流" if not valid else "") + +def markdown(data: dict) -> str: + summ = data["summary"] + result = ["# SiteForge V8.18 只读验收报告", "", f"检查日期：{data['generated_at']}", + "", "**本工具不能证明完整生产上线。** 只执行只读探针和静态检查；人工证据需二次核实。", "", + f"检查结果：PASS {summ['pass']} / FAIL {summ['fail']} / WARN {summ['warn']} / SKIP {summ['skip']}", "", + "| 检查项 | 分类 | 结果 | 详情 |", "|---|---|---|---|"] + def clean(s): return str(s).replace("|", "\\|").replace("\n", " ") + for c in data["checks"]: + result.append(f"| {clean(c['description'])} | {clean(CATEGORIES.get(c['category'], c['category']))} | {c['status'].upper()} | {clean(c['detail'])} |") + result += ["", "## 修复清单", ""] + issues = [c for c in data["checks"] if c["status"] in ("fail", "warn")] + result += [f"- **{c['code']}**：{c['remediation'] or c['description']}" for c in issues] or ["- 没有发现 FAIL / WARN；仍需核实未执行的外部验收。"] + return "\n".join(result) + "\n" + +STYLE = """body{font:14px/1.6 system-ui,-apple-system,'Microsoft YaHei',sans-serif;margin:0;background:#f4f6fa;color:#202b3d}header{padding:28px 4%;background:#14243d;color:white}header h1{margin:0;font-size:25px}main{max-width:1180px;margin:auto;padding:24px}.muted{color:#64748b}.panel{background:white;border:1px solid #e2e7f0;border-radius:14px;padding:22px;margin-bottom:20px}.cards{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px}.metric{background:white;border-radius:12px;border:1px solid #e2e7f0;padding:16px}.metric strong{display:block;font-size:29px}.tools{display:flex;gap:8px;flex-wrap:wrap;margin:16px 0}button{cursor:pointer;background:#fff;border:1px solid #ccd5e2;padding:9px 14px;border-radius:9px}button[aria-pressed=true]{background:#ff6a2b;color:white;border-color:#ff6a2b}.item{padding:13px 0;border-bottom:1px solid #edf0f4;display:flex;gap:12px;align-items:baseline}.tag{font-size:11px;border-radius:5px;padding:2px 7px;min-width:42px;text-align:center;display:inline-block;background:#e5e7eb}.pass{background:#dcfce7;color:#166534}.fail{background:#fee2e2;color:#991b1b}.warn{background:#fef3c7;color:#92400e}.skip{background:#e2e8f0;color:#475569}.description{font-weight:650}.detail{color:#64748b;font-size:13px}.secondary{margin-left:auto;color:#9ca3af}footer{padding:20px;text-align:center;color:#64748b}@media(max-width:660px){.cards{grid-template-columns:repeat(2,minmax(0,1fr))}.item{display:block}.secondary{display:none}}""" + +def html_report(data: dict) -> str: + cards = "".join(f'
{k.upper()}
{data["summary"][k]}
' for k in ("pass", "fail", "warn", "skip")) + rows = [] + for c in data["checks"]: + e = lambda s: html.escape(str(s), quote=True) + rows.append(f'
{e(c["status"].upper())}
{e(c["description"])}
{e(c["detail"])}
' + (f'
建议：{e(c["remediation"])}
' if c["remediation"] else "") + f'
{e(c["code"])}
') + return ("SiteForge · 验收中心" + '

SiteForge · 生产验收中心

V8.18 Read-only Acceptance Kit · 生成时间：' + html.escape(data["generated_at"]) + '
' + '
' + cards + '

检查结论

本报告不会将跳过项、模拟测试或人工登记直接视为生产通过。正式发布必须有真实数据库、Docker、浏览器和回滚证据。

' + "".join(rows) + '
该页面离线可查看，不上传任何诊断数据。
') + +def main(argv=None): + ap = argparse.ArgumentParser(description="SiteForge V8.18 non-destructive acceptance toolkit") + ap.add_argument("--repo", type=Path, help="SiteForge 源码根目录") + ap.add_argument("--url", help="只读 HTTP 健康检查 URL；默认仅支持 loopback") + ap.add_argument("--allow-remote", action="store_true", help="明确允许访问已授权远端测试目标") + ap.add_argument("--docker", action="store_true", help="运行只读 docker compose 命令") + ap.add_argument("--compose-file", default="compose.enterprise.yaml", help="默认企业 Compose 文件") + ap.add_argument("--postgres", action="store_true", help="只执行 PostgreSQL SELECT 1") + ap.add_argument("--redis", action="store_true", help="只执行 Redis PING") + ap.add_argument("--build-dir", type=Path, help="检查已生成的静态站目录") + ap.add_argument("--url-baseline", type=Path, help="旧站 URL 路径清单 TXT") + ap.add_argument("--evidence", type=Path, help="人工签字验收证据 JSON") + ap.add_argument("--output", type=Path, default=Path("siteforge-audit"), help="报告文件前缀") + args = ap.parse_args(argv) + r = Report(args) + if not any((args.repo, args.url, args.docker, args.postgres, args.redis, args.build_dir, args.evidence)): + ap.error("至少选择一个检查目标，例如 --repo . --docker 或 --url http://127.0.0.1:8787") + if args.repo: audit_repo(r, args.repo) + if args.url: audit_http(r, args.url, args.allow_remote) + if args.docker: audit_docker(r, args.repo or Path.cwd(), args.compose_file) + if args.postgres: audit_postgres(r) + if args.redis: audit_redis(r) + if args.build_dir: audit_build(r, args.build_dir, args.url_baseline) + if args.url_baseline and not args.build_dir: + r.add("build.baseline_without_build", "build", "warn", "旧站 URL 路径基线", "必须同时传入 --build-dir") + if args.evidence: release_gate(r, args.evidence) + else: release_gate(r, None) + data = r.data() + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.with_suffix(".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") + args.output.with_suffix(".md").write_text(markdown(data), encoding="utf-8") + args.output.with_suffix(".html").write_text(html_report(data), encoding="utf-8") + print(f"PASS={data['summary']['pass']} FAIL={data['summary']['fail']} WARN={data['summary']['warn']} SKIP={data['summary']['skip']}") + print("报告已写入：", args.output.with_suffix(".json"), args.output.with_suffix(".md"), args.output.with_suffix(".html")) + return 2 if data["summary"]["fail"] else 0 + +if __name__ == "__main__": + sys.exit(main()) diff --git a/scripts/verify_art_design_pro_v819.py b/scripts/verify_art_design_pro_v819.py new file mode 100644 index 0000000..d6a0d4f --- /dev/null +++ b/scripts/verify_art_design_pro_v819.py @@ -0,0 +1,57 @@ +"""Verify an installed Art Design Pro checkout and optionally run its real build. + +Requires the USER's official checkout. A fixture-only installer test never +counts as a successful official Vue build. +""" +from __future__ import annotations +import argparse +import json +import subprocess +import sys +from pathlib import Path +if str(Path(__file__).resolve().parents[1]) not in sys.path: + sys.path.insert(0, str(Path(__file__).resolve().parents[1])) +from scripts.install_into_art_design_pro import install + + +def verify(path: Path, build: bool = False) -> dict: + root = path.expanduser().resolve() + result = install(root, verify=True) + manifest = root/'src/views/siteforge/.siteforge-v819.json' + if not manifest.is_file(): + raise ValueError('安装清单缺失，请执行安装器 --apply') + data = json.loads(manifest.read_text(encoding='utf-8')) + if data.get('siteforge_version') != '8.21.3-dev.1': + raise ValueError('安装清单版本不匹配') + result.update({'version':data['siteforge_version'],'build':'NOT_RUN'}) + if build: + if not (root/'node_modules').is_dir(): + raise ValueError('缺少 Art Design Pro 官方 npm 依赖；在官方工程先运行 pnpm install --frozen-lockfile') + command = ['pnpm','build'] + try: + out = subprocess.run(command, cwd=root, check=False, capture_output=True, + text=True, timeout=300) + except (OSError, subprocess.TimeoutExpired) as exc: + raise ValueError('真实构建无法完成：'+str(exc)) from exc + if out.returncode: + raise ValueError(f'pnpm build 失败（退出码 {out.returncode}）：'+out.stderr[-2000:]) + result['build']='PASS' + result['build_stdout_tail']=out.stdout[-1000:] + return result + + +if __name__=='__main__': + parser=argparse.ArgumentParser() + parser.add_argument('official_repo',type=Path) + parser.add_argument('--build',action='store_true',help='有官方源码和 node_modules 后执行真实 pnpm build') + parser.add_argument('--report',type=Path) + a=parser.parse_args() + try: + result=verify(a.official_repo,build=a.build) + if a.report: + a.report.parent.mkdir(parents=True,exist_ok=True) + a.report.write_text(json.dumps(result,ensure_ascii=False,indent=2),encoding='utf-8') + print(json.dumps(result,ensure_ascii=False,indent=2)) + except ValueError as exc: + print('BLOCKED/FAILED: '+str(exc),file=sys.stderr) + raise SystemExit(1) diff --git a/scripts/verify_pg_backup_restore.py b/scripts/verify_pg_backup_restore.py new file mode 100644 index 0000000..6f5644b --- /dev/null +++ b/scripts/verify_pg_backup_restore.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +"""REAL pg_dump -> checksum -> pg_restore into dedicated empty DB CI smoke. + +Must only run in isolated disposable CI PG server as administrator and with +SITEFORGE_ALLOW_PG_DR_SMOKE=1. Do NOT point at any production database. +""" +from __future__ import annotations +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) + +import os +import re +import tempfile +import uuid +from pathlib import Path +from urllib.parse import urlsplit, urlunsplit + +from app import db, pg_compat, pg_disaster_recovery as disaster + +src_url = os.environ.get('SITEFORGE_DATABASE_URL','') +parsed=urlsplit(src_url) +src_name=parsed.path.lstrip('/') +if (os.environ.get('SITEFORGE_ALLOW_PG_DR_SMOKE')!='1' or not db.POSTGRES + or not re.fullmatch('[a-z][a-z0-9_]*_ci',src_name)): + raise SystemExit('Requires isolated PG _ci database and explicit DR-smoke flag') + +dest_name=src_name[:-3]+'_restore_ci' +dest_url=urlunsplit((parsed.scheme,parsed.netloc,'/'+dest_name,parsed.query,parsed.fragment)) +env=disaster.connection_env(src_url) +marker='restore-check-'+uuid.uuid4().hex[:8] +created=False +try: + with db.connect() as conn: + conn.execute('INSERT INTO sites(id,name,created_at,updated_at) VALUES (?,?,?,?)', + (marker,'Backup Restore Sample',db.now(),db.now())) + # pg_dump is a snapshot, but cross-volume coherence still requires no writers; + # CI runs in isolation and uses a private data directory. + with tempfile.TemporaryDirectory(prefix='sf-v818-pg-dr-') as root: + root=Path(root) + data=root/'original';asset=data/'media'/marker/'file.txt' + asset.parent.mkdir(parents=True) + asset.write_text('SiteForge backup fixture',encoding='utf-8') + archive=root/'backup.zip' + disaster.backup(src_url,data,archive,confirmed_offline=True) + assert disaster.verify(archive)['files']['database.dump']['size']>0 + # Admin must have CREATE DATABASE in this isolated CI service. + disaster.run_pg(['psql','--no-psqlrc','--command',f'CREATE DATABASE {dest_name}'],env,40) + created=True + new_storage=root/'restored' + disaster.restore_new(dest_url,archive,new_storage,confirmed_offline=True) + assert (new_storage/'media'/marker/'file.txt').read_text(encoding='utf-8')=='SiteForge backup fixture' + with pg_compat.connect(dest_url) as conn: + row=conn.execute('SELECT name FROM sites WHERE id=?',(marker,)).fetchone() + assert row and row['name']=='Backup Restore Sample' + print('PASS: Real PG dump, manifest integrity, restore to empty DB and media recovery') +finally: + with db.connect() as conn: + conn.execute('DELETE FROM sites WHERE id=?',(marker,)) + if created: + disaster.run_pg(['psql','--no-psqlrc','--command',f'DROP DATABASE {dest_name} WITH (FORCE)'],env,40) diff --git a/scripts/verify_pg_bootstrap.py b/scripts/verify_pg_bootstrap.py index d9ef1f3..062bfa5 100644 --- a/scripts/verify_pg_bootstrap.py +++ b/scripts/verify_pg_bootstrap.py @@ -1,20 +1,79 @@ -"""PostgreSQL bootstrap smoke: execute only in a throwaway database.""" -import os -if not os.getenv('SITEFORGE_DATABASE_URL','').startswith(('postgresql://','postgres://')): - raise SystemExit('Please set SITEFORGE_DATABASE_URL to a disposable PostgreSQL database') -from app import db,enterprise,factory_api,migration_audit,reusables,release_api,jobs -from app.core import save_entry -import uuid +"""Full PostgreSQL integration smoke test. Requires a disposable PostgreSQL DB. -db.init();enterprise.setup();factory_api.setup();migration_audit.setup();reusables.setup();release_api.setup() -sid=uuid.uuid4().hex[:16] -with db.connect() as c: - c.execute('INSERT INTO sites(id,name,domain,created_at,updated_at) VALUES (?,?,?,?,?)',(sid,'PG Smoke','','2026-01-01','2026-01-01')) - c.execute('INSERT INTO entries(id,site_id,type,title,route,slug,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?)', - (uuid.uuid4().hex[:16],sid,'page','Home','/','home','2026-01-01','2026-01-01')) -assert db.one('SELECT id FROM sites WHERE id=?',(sid,))['id']==sid -job=jobs.submit(sid,{'mirror_images':False},'pg-smoke','pg-smoke-unique-0001') -assert job['state']=='queued' -assert jobs.cancel(sid,job['id'])['state']=='cancelled' -with db.connect() as c:c.execute('DELETE FROM sites WHERE id=?',(sid,)) -print('PostgreSQL schema, CRUD, job submit, cancel smoke passed') +Run only in CI or a dedicated empty database: creates tables and temporary +site/jobs, and validates actual DB API compatibility and worker claims. +""" +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) +import os +import uuid +url=os.getenv('SITEFORGE_DATABASE_URL','') +if not url.startswith(('postgresql://','postgres://')): + raise SystemExit('Set SITEFORGE_DATABASE_URL to a DISPOSABLE PostgreSQL database') +from app import (db,enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86, + site_design_v87,multilingual,jobs,worker) + +# Mirror app.main.lifespan bootstrap so CI will discover any broken DDL/UPSERT. +db.init() +for module in (enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86, + site_design_v87,multilingual): + module.setup() +assert db.one('SELECT 1 AS ready')['ready']==1 +assert db.one('SELECT 1 AS ready')['ready']==1 +ledger=db.one('SELECT version FROM schema_migrations WHERE version=?',('20261022_001_p1_limits',)) +assert ledger,'PostgreSQL migration ledger not created' +sid='pg-'+uuid.uuid4().hex[:12] +job_id=None +sid2=sid+"-second" +try: + with db.connect() as c: + c.execute('INSERT INTO sites(id,name,domain,created_at,updated_at) VALUES (?,?,?,?,?)', + (sid,'PG Smoke','','2026-01-01','2026-01-01')) + c.execute('INSERT INTO sites(id,name,domain,created_at,updated_at) VALUES (?,?,?,?,?)', + (sid2,'PG Smoke Second','','2026-01-01','2026-01-01')) + c.execute('INSERT INTO entries(id,site_id,type,title,route,slug,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?)', + (uuid.uuid4().hex[:16],sid,'page','Home','/','home','2026-01-01','2026-01-01')) + assert db.one('SELECT id FROM sites WHERE id=?',(sid,))['id']==sid + job=jobs.submit(sid,{'mirror_images':False},'pg-smoke','pg-smoke-'+uuid.uuid4().hex[:14]) + job_id=job['id'] + # PostgreSQL claim exercises FOR UPDATE SKIP LOCKED and numeric COUNT rows. + claimed=worker.claim() + assert claimed and claimed['id']==job_id and claimed['state']=='running',claimed + assert worker.claim() is None,'Same-site job was claimed twice' + worker.complete(claimed,{'ok':True}) + assert db.one('SELECT state FROM build_jobs WHERE id=?',(job_id,))['state']=='done' + job2=jobs.submit(sid,{'mirror_images':True},'pg-smoke','pg-smoke-'+uuid.uuid4().hex[:14]) + assert jobs.cancel(sid,job2['id'])['state']=='cancelled' + # Independent connections racing for work must never receive the same job. + import threading + keys=[('pg-claim-a',sid),('pg-claim-b',sid2)] + submitted=[] + for label,site in keys: + submitted.append(jobs.submit(site,{'mirror_images':site==sid},'pg-smoke', + label+'-'+uuid.uuid4().hex[:10])['id']) + barrier=threading.Barrier(2) + claimed=[]; failures=[] + def runner(): + try: + barrier.wait(timeout=8) + claimed.append(worker.claim()) + except Exception as ex:failures.append(ex) + threads=[threading.Thread(target=runner) for _ in range(2)] + for thread in threads:thread.start() + for thread in threads:thread.join(timeout=12) + assert not any(t.is_alive() for t in threads),'Concurrent PG claim deadlock' + assert not failures,failures + ids={item['id'] for item in claimed if item} + assert ids==set(submitted),'Concurrent claims were duplicated or lost' + for item in claimed:worker.complete(item,{'ok':True}) + print('PASS: PostgreSQL schemas, ledger, CRUD, queue claim/complete/cancel, two concurrent claims') +finally: + with db.connect() as c: + c.execute('DELETE FROM sites WHERE id=?',(sid,)) + c.execute('DELETE FROM sites WHERE id=?',(sid2,)) diff --git a/scripts/verify_redis_signal.py b/scripts/verify_redis_signal.py new file mode 100644 index 0000000..cca620b --- /dev/null +++ b/scripts/verify_redis_signal.py @@ -0,0 +1,18 @@ +#!/usr/bin/env python3 +"""Optional real Redis wake-up smoke; external Redis required.""" +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) +import os +import time +from app import redis_signal + +if not os.environ.get('SITEFORGE_REDIS_URL'): + raise SystemExit('Set SITEFORGE_REDIS_URL for real Redis smoke') +if not redis_signal.notify(): + raise SystemExit('Redis notification failed') +start=time.monotonic() +redis_signal.wait(0.1) +assert time.monotonic()-start < 4, 'Wakeup not consumed promptly' +print('PASS: Redis notification and worker wait against configured Redis') diff --git a/scripts/verify_release.py b/scripts/verify_release.py index d695bfc..8549963 100644 --- a/scripts/verify_release.py +++ b/scripts/verify_release.py @@ -6,7 +6,7 @@ import sys ROOT=Path(__file__).resolve().parent.parent sys.path.insert(0,str(ROOT)) from app.version import VERSION -assert VERSION=='8.12.0-dev.1' +assert VERSION=='8.21.3-dev.1' api=(ROOT/'app'/'main.py').read_text(encoding='utf-8') assert 'return builder.build(' not in api, 'A synchronous request-thread build has reappeared' assert "@app.post('/api/sites/{site_id}/builds', status_code=202)" in api diff --git a/scripts/verify_sqlite_pg_transfer.py b/scripts/verify_sqlite_pg_transfer.py new file mode 100644 index 0000000..1a58ff0 --- /dev/null +++ b/scripts/verify_sqlite_pg_transfer.py @@ -0,0 +1,68 @@ +#!/usr/bin/env python3 +"""REAL PostgreSQL data migration CI smoke with a disposable isolated target. + +This script deliberately never runs on ambiguous production-looking DB names. +Set SITEFORGE_ALLOW_PG_DATA_SMOKE=1 and database suffix _ci/_test. +""" +# Allow direct `python scripts/name.py` from a fresh source checkout. +import sys as _sys +from pathlib import Path as _Path +_sys.path.insert(0, str(_Path(__file__).resolve().parents[1])) +import os +import subprocess +import sys +import tempfile +import uuid +from pathlib import Path +from urllib.parse import unquote,urlsplit + +from app import db +from app.sqlite_pg_transfer import migrate +from app.pg_disaster_recovery import RecoveryError + +url = os.environ.get('SITEFORGE_DATABASE_URL','') +name = unquote(urlsplit(url).path.lstrip('/')) +if not db.POSTGRES or os.environ.get('SITEFORGE_ALLOW_PG_DATA_SMOKE')!='1' or not name.endswith(('_ci','_test')): + raise SystemExit('Requires explicit CI-only PG smoke flag and _ci/_test database') + +with tempfile.TemporaryDirectory(prefix='sf-v818-ci-') as temp: + source=Path(temp)/'siteforge.sqlite3' + env=os.environ.copy(); env.pop('SITEFORGE_DATABASE_URL',None) + env['SITEFORGE_DATA_DIR']=temp + env['SITEFORGE_DB_FILE']=str(source) + marker='migration-smoke-'+uuid.uuid4().hex[:10] + code=r'''from app import (db,enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86,site_design_v87,multilingual) +import os +assert not db.POSTGRES +assert not os.path.exists(db.DB_FILE) +db.init() +for x in (enterprise,factory_api,migration_audit,reusables,release_api, + cms_pipeline,v8_workflows,v8_templates,wp_migration_v81,wp_migration_v82, + wp_migration_v83,connectors_v84,connectors_v85,studio_v86,site_design_v87,multilingual):x.setup() +s=os.environ['V818_MARKER'] +with db.connect() as c: + c.execute('INSERT INTO sites(id,name,created_at,updated_at) VALUES (?,?,?,?)',(s,'Migration Sample',db.now(),db.now())) + for i in range(3): + c.execute('INSERT INTO entries(id,site_id,type,title,route,slug,created_at,updated_at) VALUES (?,?,?,?,?,?,?,?)', + (s+'e'+str(i),s,'product','Migrated Car '+str(i),'/products/'+str(i)+'/','p'+str(i),db.now(),db.now())) + c.execute('INSERT INTO redirects(id,site_id,old_path,new_path) VALUES (?,?,?,?)',(s+'r',s,'/old/','/products/0/')) +''' + env['V818_MARKER']=marker + subprocess.run([sys.executable,'-c',code],check=True,env=env) + try: + result=migrate(source,confirmed_offline=True) + assert result['verified'] and result['details']['entries']['rows']==3 + assert result['details']['redirects']['rows']==1 + assert db.one('SELECT COUNT(*) AS n FROM entries WHERE site_id=?',(marker,))['n']==3 + assert db.one('SELECT COUNT(*) AS n FROM redirects WHERE site_id=?',(marker,))['n']==1 + # Re-running must fail: no duplicate rows, no silent upsert. + try:migrate(source,confirmed_offline=True) + except RecoveryError as exc: + assert 'not empty' in str(exc) + else:raise AssertionError('Migration unexpectedly allowed nonempty target') + print(f'PASS: actual PostgreSQL transfer {result["tables"]} tables, {result["records"]} records; rerun blocked') + finally: + with db.connect() as c: + c.execute('DELETE FROM sites WHERE id=?',(marker,)) diff --git a/scripts/wp_v820_preflight.py b/scripts/wp_v820_preflight.py new file mode 100644 index 0000000..5b3887b --- /dev/null +++ b/scripts/wp_v820_preflight.py @@ -0,0 +1,74 @@ +#!/usr/bin/env python3 +"""Offline WordPress WXR preflight and optional static output URL coverage check.""" +from __future__ import annotations +import argparse +import html +import json +import sys +from pathlib import Path + +ROOT=Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path:sys.path.insert(0,str(ROOT)) +from app.wp_complex_v820 import inspect_wxr, MAX_XML +from app.builder import output_path + + +def inspect_file(source:Path,dist:Path|None=None): + if source.stat().st_size>MAX_XML:raise ValueError('WXR 超过 16 MB，需分割后分别预检') + result=inspect_wxr(source.read_bytes()) + if dist is not None: + if not dist.is_dir():raise ValueError('静态构建输出目录不存在') + # Every actual published URL must be matched. WXR preflight by design + # never claims 100% coverage if it has invalid or duplicate routes. + from defusedxml import ElementTree as ET + root=ET.parse(source).getroot() + routes=[] + from app.core import route_path + from urllib.parse import urlsplit + for item in root.findall('./channel/item'): + fields={c.tag.rsplit('}',1)[-1]:c.text or '' for c in item if c.tag.rsplit('}',1)[-1] in ('post_type','status','link')} + if fields.get('post_type') in ('attachment','revision','nav_menu_item') or fields.get('status','publish')!='publish':continue + p=urlsplit(fields.get('link','')) + if p.scheme in ('http','https') and p.hostname and not p.query and not p.fragment and p.path: + try:routes.append(route_path(p.path)) + except ValueError:pass + missing=[route for route in sorted(set(routes)) if not output_path(dist,route).is_file()] + result['static_build_coverage']={'expected_routes':len(set(routes)),'missing_count':len(missing), + 'missing_sample':missing[:100], + 'passed':len(missing)==0 and result['blocking_issues']==0} + return result + + +def render_html(report): + rows=''.join(''+html.escape(x['severity'])+''+html.escape(x['code'])+ + ''+html.escape(x['route'])+''+html.escape(x['message'])+'' for x in report['issues']) + metrics=' '.join(f'{html.escape(str(k))}: {html.escape(str(v))}' for k,v in report['counts'].items() if k in ('published_content','attachments','findings_blocker','findings_review')) + return f'''SiteForge V8.20 WordPress 兼容预检 +

SiteForge V8.20 · WordPress 兼容预检

离线分析，不连接原站，不修改已有站点

{metrics}

待处理问题

+{rows}
等级问题类型URL处理说明
+

本报告不能证明 1:1 迁移、媒体本地化、动态功能、视觉一致性或正式发布验收通过。

''' + + +def main(argv=None): + parser=argparse.ArgumentParser(description='离线分析 WordPress WXR 迁移风险与 URL 覆盖') + parser.add_argument('wxr',type=Path) + parser.add_argument('--dist',type=Path,help='可选：静态构建 dist 目录，检查对应 HTML 是否存在') + parser.add_argument('--output',type=Path,default=Path('reports/v820-wxr-preflight.json')) + args=parser.parse_args(argv) + try:report=inspect_file(args.wxr,args.dist) + except (OSError,ValueError,Exception) as exc: + # A single fail-closed error message avoids a massive traceback for malformed input. + print('无法完成 WXR 预检：'+str(exc)[:350],file=sys.stderr) + return 2 + args.output.parent.mkdir(parents=True,exist_ok=True) + args.output.write_text(json.dumps(report,ensure_ascii=False,indent=2),encoding='utf-8') + args.output.with_suffix('.html').write_text(render_html(report),encoding='utf-8') + print(f"WXR 预检：{report['unique_published_routes']} 个静态路由，{report['blocking_issues']} 个阻断问题；报告：{args.output}") + if report['blocking_issues'] or report.get('static_build_coverage',{}).get('passed') is False:return 1 + return 0 + +if __name__=='__main__':raise SystemExit(main()) diff --git a/scripts/write_v818_acceptance.py b/scripts/write_v818_acceptance.py new file mode 100644 index 0000000..d76d515 --- /dev/null +++ b/scripts/write_v818_acceptance.py @@ -0,0 +1,74 @@ +#!/usr/bin/env python3 +"""Creates a durable V8.18 evidence index from the tests already executed.""" +from __future__ import annotations +import json,html,datetime +from pathlib import Path +root=Path(__file__).resolve().parents[1] +rep=root/'reports' +r=json.loads((rep/'v818-regression-2rounds.json').read_text(encoding='utf-8')) +a=json.loads((rep/'v818-readonly.json').read_text(encoding='utf-8')) +http=(rep/'v818-http-e2e.log').read_text(encoding='utf-8') +assert r['status']=='PASS' and r['repeats']==2 and not r['failures'] +assert (rep/'v818_two_rounds_exitcode').read_text().strip()=='0' +assert 'PASS' in http +runs=[x for x in r['runs'] if x['label'].startswith('round')] +total=sum(x['passed'] for x in runs) +result={ + 'platform':'SiteForge Enterprise', 'version':'8.18.0-dev.1', + 'generated_at':datetime.datetime.now(datetime.timezone.utc).isoformat(), + 'delivery':'developer integration build', + 'source':'V8.17 complete source + V8.18 improvements', + 'local_validation':{ + 'pytest_status':r['status'], 'modules':r['modules'], 'rounds':r['repeats'], + 'passed_per_round':r['tests_last_complete_round'], 'passed_across_rounds':total, + 'failures':r['counts']['FAIL'], 'timeouts':r['counts']['TIMEOUT'], + 'http_worker_e2e':'PASS', 'python_compile':'PASS', 'node_syntax':'PASS', + 'static_audit':'PASS (12 checks, 2 skipped)', + 'ci_yaml':'parsed locally; not executed on GitHub Actions'}, + 'not_tested_in_this_environment':[ + 'real PostgreSQL data migration and dump/restore (CI entry supplied)', + 'real Redis wake-up (CI entry supplied)', + 'Docker engine / multi-container multi-worker network fault tests', + 'Playwright/Chromium interactive browser smoke', + 'SFTP/S3/HTTPS remote public deployment and rollback', + 'production backup RPO/RTO and offsite restore'], + 'changed_modules':[ + 'app/backup.py','app/pg_disaster_recovery.py','app/sqlite_pg_transfer.py', + 'app/jobs.py','app/worker.py','scripts/pg_disaster_recovery.py', + 'scripts/migrate_sqlite_to_postgres.py','scripts/verify_pg_bootstrap.py', + 'scripts/verify_sqlite_pg_transfer.py','scripts/verify_pg_backup_restore.py', + 'scripts/verify_redis_signal.py','.github/workflows/ci.yml'], + 'limitations': 'NOT production-approved; real PG/Redis/Docker tests require external CI/ops environment'} +(rep/'V8_18_RELEASE_EVIDENCE.json').write_text(json.dumps(result,ensure_ascii=False,indent=2),encoding='utf-8') +lines=['# SiteForge Enterprise V8.18.0-dev.1 — 集成验收总览','', + '**结论：本地开发集成回归通过，正式生产环境验收未完成。**','', + f"- 自动化：{r['modules']} 个模块，{r['repeats']} 轮 × {r['tests_last_complete_round']} 项 = {total} 项通过；0 失败 / 0 超时。", + '- HTTP + Worker 真实端到端：通过（登录 → 建站 → 入队 → Worker 构建 → ZIP → 预览）。', + '- Python 编译、JavaScript 语法、项目静态检查：通过。', + '- 项目只读审计：12 项通过，2 项跳过。', + '', '## 核心新增', '', + '- Postgres 模式禁用不正确的 SQLite 备份；Postgres 离线 ZIP 灾备、校验与恢复到全新数据库/目录。', + '- SQLite → PostgreSQL 离线迁移、依赖排序、事务提交和逐表哈希/行数核验。', + '- 发布/回滚任务租约过期、网络故障、取消后标记待核对，禁止不安全自动重试。', + '- CI PostgreSQL、Redis 和实际 pg_dump → 恢复的集成烟测入口。', + '', '## 仍未通过生产门禁', ''] +lines.extend('- '+x for x in result['not_tested_in_this_environment']) +lines+=['','## 文件','', + '- `reports/v818-regression-2rounds.html`：两轮测试明细', + '- `reports/v818-readonly.html`：只读审计报告', + '- `reports/v818-http-e2e.log`：HTTP/Worker E2E 输出', + '- `docs/V8_18_ENTERPRISE_HARDENING.md`：运维、迁移与灾备说明', + '', '注：成功通过本地自动化不代表 Docker 和真实 PostgreSQL 性能/容灾验收通过。'] +(rep/'V8_18_集成验收总览.md').write_text('\n'.join(lines)+'\n',encoding='utf-8') +rows=''.join(f"{html.escape(x['label'])}{x['status']}{x['passed']}{x['seconds']}s" for x in runs) +risks=''.join('
  • '+html.escape(x)+'
    • ' for x in result['not_tested_in_this_environment']) +page=f'''SiteForge V8.18 · 企业集成验收 +
    SITEFORGE ENTERPRISE

    V8.18 · 集成验收总览

    开发集成版 · 本地验证通过 · 生产环境门禁未关闭

    +
    每轮自动化测试
    299
    PASS
    重复回归
    2
    共 {total} 次通过
    测试模块
    {r['modules']}
    历史模块 + 新模块
    失败 / 超时
    0 / 0
    PASS
    +

    完整回归批次

    {rows}
    批次状态测试通过耗时
    +

    业务链路

    PASS · 登录/CSRF → 创建网站和页面 → 异步 Worker 构建 → ZIP 下载 → 页面预览

    Python 编译、JavaScript 语法检查及源码只读审计均通过；只读审计 2 项因环境/人工证据缺失跳过。

    +

    尚未关闭的生产验收

    下列内容已准备 CI/运维入口，当前环境尚无真实完成证据：

      {risks}
    +

    运维与版本说明

    交付包含 V8.17 原有完整业务模块、V8.18 新增备份/迁移/防重复发布代码、自动化测试、CI 工作流、README、完整原始测试日志与验收报告。

    真实上线前必须独立执行 PostgreSQL 迁移、灾备恢复、多 Worker、真实浏览器、部署回滚与故障演练。所有数据库写操作均应只在隔离测试库或经批准的维护窗口执行。

    ''' +(rep/'V8_18_集成验收总览.html').write_text(page,encoding='utf-8') +print('WROTE',total,'passed across two rounds') diff --git a/scripts/write_v819_acceptance.py b/scripts/write_v819_acceptance.py new file mode 100644 index 0000000..1f9bd11 --- /dev/null +++ b/scripts/write_v819_acceptance.py @@ -0,0 +1,34 @@ +"""Produce acceptance report from actual V8.19 result files; no invented passes.""" +import json +import html +from pathlib import Path +from datetime import datetime,timezone + +root=Path(__file__).resolve().parents[1] +r=root/'reports' +summary=r/'v819-regression.json' +if not summary.exists():raise SystemExit('missing v819-regression.json; run regression first') +x=json.loads(summary.read_text(encoding='utf-8')) +if x['status'] != 'PASS':raise SystemExit('regression incomplete or failed; refusing PASS acceptance') +repeatfile=r/'v819-regression-repeat2.json' +if repeatfile.exists(): + repeated=json.loads(repeatfile.read_text(encoding='utf-8')) + if repeated['status'] != 'PASS' or repeated['repeats'] != 2:raise SystemExit('repeat regression did not pass') + repeats_note=f"2 rounds / {sum(t['passed'] for t in repeated['runs'] if t['status']=='PASS')} checks" +else: + repeats_note='single round only' +items=[('V8.19 全量自动化回归','PASS',f"{x['tests_last_complete_round']} tests / {x['modules']} modules; {repeats_note}"), + ('本地 HTTP/Worker E2E','PASS (已单独运行)','参见运行日志；本工具不自动验证历史人工输出'), + ('Art 路由及业务页面适配','PASS (fixture)','安装器测试；不是官方编译'), + ('Art 官方 npm 构建','BLOCKED','缺少官方 Art 工程及其依赖'), + ('Art PC/移动端浏览器验收','NOT RUN','需要官方构建与正常浏览器环境'), + ('真实 PostgreSQL/Redis/HTTPS/发布','NOT RUN','需要独立环境实测')] +info={'version':'8.19.0-dev.1','generated_at':datetime.now(timezone.utc).isoformat(),'regression':x,'repeat_verification':repeats_note,'items':[dict(name=a,status=b,note=c) for a,b,c in items]} +(r/'V8_19_验收汇总.json').write_text(json.dumps(info,ensure_ascii=False,indent=2),encoding='utf-8') +text=['# SiteForge Enterprise V8.19 验收汇总','','**状态：开发集成回归已通过，生产/Art 官方验收尚未完成。**','',f"- 自动回归：{x['tests_last_complete_round']} 项；模块 {x['modules']}；状态 {x['status']}。",'','| 验收项 | 状态 | 说明 |','|---|---|---|'] +text += [f'| {a} | {b} | {c} |' for a,b,c in items] +(r/'V8_19_验收汇总.md').write_text('\n'.join(text)+'\n',encoding='utf-8') +rows=''.join(f'{html.escape(a)}{html.escape(b)}{html.escape(c)}' for a,b,c in items) +doc='''SiteForge V8.19 验收汇总

    SiteForge Enterprise V8.19

    统一后台开发集成验收

    验收结论

    本地回归通过不等于正式 Art 编译或生产验收。下表区分实测与待完成项目。

    '''+rows+'
    项目状态证据或限制
    ' +(r/'V8_19_验收汇总.html').write_text(doc,encoding='utf-8') +print('V8.19 acceptance reports generated; cases:',x['tests_last_complete_round']) diff --git a/tests/test_console_v819.py b/tests/test_console_v819.py new file mode 100644 index 0000000..f426b88 --- /dev/null +++ b/tests/test_console_v819.py @@ -0,0 +1,120 @@ +"""V8.19 unified console contract; server permissions remain authoritative.""" +from app.version import VERSION +import json +import pytest +from tests.test_enterprise import root,site +from scripts.install_into_art_design_pro import install, transform_routes + + +def test_bootstrap_admin_uses_one_navigation_and_no_secrets(root): + one=site(root,'HESU A');two=site(root,'HESU B') + r=root.get('/api/console/bootstrap') + assert r.status_code==200,r.text + info=r.json() + assert info['version']==VERSION + assert {x['id'] for x in info['sites']}=={one,two} + assert info['selected_site_id'] in {one,two} + assert info['capabilities']['create_site'] and info['capabilities']['deploy'] + assert [i['key'] for i in info['navigation']]==['dashboard','sites','content','design','migration','release','system'] + assert 'csrf' not in json.dumps(info).lower() + assert root.get('/api/console/bootstrap?site_id=not-a-site').status_code==403 + + +def test_scope_does_not_disclose_foreign_site_and_rejects_unassigned(root): + one=site(root,'Assigned');two=site(root,'Not assigned') + uid=root.post('/api/enterprise/team/users',json={ + 'username':'v819view','display_name':'Viewer','password':'viewer-strong-password-2026'}).json()['id'] + assert root.put(f'/api/enterprise/sites/{one}/members',json={'user_id':uid,'role':'viewer'}).status_code==200 + root.post('/api/auth/logout') + assert root.post('/api/auth/login',json={'username':'v819view','password':'viewer-strong-password-2026'}).status_code==200 + root.headers['X-SiteForge-CSRF']=root.get('/api/auth/me').json()['csrf'] + r=root.get('/api/console/bootstrap') + assert r.status_code==200,r.text + b=r.json() + assert [s['id'] for s in b['sites']]==[one] + assert b['capabilities']['role']=='viewer' + assert not b['capabilities']['edit'] and not b['capabilities']['deploy'] + assert not b['capabilities']['manage_users'] + assert all(item['key']!='system' for item in b['navigation']) + assert root.get(f'/api/console/bootstrap?site_id={two}').status_code==403 + assert root.get(f'/api/sites/{two}/entries').status_code==403 + assert root.get(f'/api/console/bootstrap?site_id={one}').status_code==200 + + +def test_empty_site_roles_still_have_dashboard(root): + resp=root.get('/api/console/bootstrap') + assert resp.status_code==200 + nav=resp.json()['navigation'] + assert nav[0]['key']=='dashboard' + assert all(n['key'] not in {'content','design','migration','release'} for n in nav) + + +def fixture(tmp_path): + repo=tmp_path/'art';route=repo/'src/router/routes/asyncRoutes.ts' + route.parent.mkdir(parents=True,exist_ok=True) + route.write_text('export const asyncRoutes: MenuListType[] = [\n{path:"/unrelated",name:"Safe"},\n];\n') + (repo/'package.json').write_text('{"name":"art-design-pro"}') + return repo,route + + +def test_art_installer_single_menu_and_safe_backup(tmp_path): + repo,route=fixture(tmp_path) + original=route.read_text() + result=install(repo,dry_run=True) + assert result['dry_run'] and not result['conflicting_views'] + assert route.read_text()==original + install(repo,dry_run=False) + updated=route.read_text() + assert updated.count("path: '/siteforge'")==1 + assert "path: 'production'" in updated + assert updated.count('// SITEFORGE_FACTORY_V8_REGISTERED')==1 + assert 'Safe' in updated + assert install(repo,verify=True)['installed'] + assert route.with_name('asyncRoutes.ts.siteforge-backup').read_text()==original + install(repo,dry_run=False) + assert route.read_text()==updated + + +def test_installer_fails_closed_on_conflicting_views(tmp_path): + repo,route=fixture(tmp_path) + target=repo/'src/views/siteforge/ConsoleHome.vue' + target.parent.mkdir(parents=True) + target.write_text('someone else code') + with pytest.raises(ValueError,match='拒绝覆盖'): + install(repo,dry_run=False) + assert 'SITEFORGE' not in route.read_text() + install(repo,dry_run=False,overwrite_views=True) + assert target.with_name('ConsoleHome.vue.siteforge-backup').read_text()=='someone else code' + target.write_text('broken') + with pytest.raises(ValueError,match='不匹配'): + install(repo,verify=True) + + +def test_installer_rejects_partial_routes(tmp_path): + repo,route=fixture(tmp_path) + route.write_text('export const asyncRoutes = [ /* SITEFORGE_V819_ROUTES_BEGIN */ ]') + with pytest.raises(ValueError,match='标记不完整'): + install(repo,dry_run=False) + + +def test_legacy_upgrade_requires_explicit_confirmation(tmp_path): + repo,route=fixture(tmp_path) + route.write_text('export const asyncRoutes: any[] = [\n // SITEFORGE_FACTORY_V8_REGISTERED\n {path:"/siteforge/production",meta:{a:1}},\n // SITEFORGE_FACTORY_V7_REGISTERED\n {path:"/siteforge",children:[{path:"factory",name:"A"}]},\n {path:"/unrelated"},\n]') + with pytest.raises(ValueError,match='--migrate-legacy'): + install(repo,dry_run=False) + install(repo,dry_run=False,migrate_legacy=True) + routes=route.read_text() + assert routes.count("path: '/siteforge'")==1 + assert 'unrelated' in routes + assert routes.count('// SITEFORGE_FACTORY_V8_REGISTERED')==1 + + +def test_shared_sdk_and_vue_pages_exist(): + from pathlib import Path + base=Path(__file__).resolve().parents[1]/'integrations/art-design-pro/src/views/siteforge' + assert (base/'_shared.ts').is_file() + assert 'X-SiteForge-CSRF' in (base/'_shared.ts').read_text() + for name in ('ConsoleHome.vue','ContentCenter.vue'): + text=(base/name).read_text() + assert '