fix(frontend): align layouts posts and widgets with zibll

2026-08-17 21:47:40 +08:00
1 parent 526364b438
commit 5d45eb053b
@@ -0,0 +1,23 @@
+# AKSRT / Zibll visual reference
+
+The reference stack is isolated from the AKSRT site and exposes Zibll at
+https://localhost:9443. The local Zibll source remains read-only.
+
+~~~powershell
+$env:ZIBLL_THEME_PATH='C:\Users\Xing\Desktop\zibll'
+docker compose -f tests/visual/docker-compose.zibll.yml up -d
+docker compose -f tests/visual/docker-compose.zibll.yml run --rm wp core install --url=https://localhost:9443 --title='Zibll Reference' --admin_user=visual_admin --admin_password='AKSRT-Visual-2026!' --admin_email=visual@example.test --skip-email
+docker compose -f tests/visual/docker-compose.zibll.yml run --rm wp theme activate zibll
+~~~
+
+Create or clean AKSRT fixtures inside its WordPress container:
+
+~~~powershell
+wp eval-file wp-content/themes/AKSRT-theme/tools/wp-cli-visual-fixtures.php create
+wp eval-file wp-content/themes/AKSRT-theme/tools/wp-cli-visual-fixtures.php cleanup
+~~~
+
+Use tests/fixtures/widget-golden-v1.json for the 222 component captures and
+tests/fixtures/page-visual-matrix-v1.json for page-level captures. Remove
+the reference stack with docker compose down -v only after fixture cleanup
+and screenshot verification.
@@ -0,0 +1,70 @@
+name: aksrt-zibll-visual-reference
+
+services:
+  db:
+    image: mariadb:11.4
+    environment:
+      MARIADB_DATABASE: zibll_reference
+      MARIADB_USER: zibll
+      MARIADB_PASSWORD: zibll
+      MARIADB_RANDOM_ROOT_PASSWORD: "1"
+    volumes:
+      - zibll_db:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      interval: 5s
+      timeout: 5s
+      retries: 20
+
+  wordpress:
+    image: wordpress:php8.1-apache
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: zibll
+      WORDPRESS_DB_PASSWORD: zibll
+      WORDPRESS_DB_NAME: zibll_reference
+    volumes:
+      - zibll_wp:/var/www/html
+      - type: bind
+        source: ${ZIBLL_THEME_PATH}
+        target: /var/www/html/wp-content/themes/zibll
+        read_only: true
+
+  caddy:
+    image: caddy:2.8-alpine
+    depends_on:
+      - wordpress
+    ports:
+      - "9443:443"
+    volumes:
+      - ./zibll-Caddyfile:/etc/caddy/Caddyfile:ro
+      - zibll_caddy_data:/data
+
+  wp:
+    image: wordpress:cli-php8.1
+    depends_on:
+      db:
+        condition: service_healthy
+      wordpress:
+        condition: service_started
+    user: "33:33"
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: zibll
+      WORDPRESS_DB_PASSWORD: zibll
+      WORDPRESS_DB_NAME: zibll_reference
+    volumes:
+      - zibll_wp:/var/www/html
+      - type: bind
+        source: ${ZIBLL_THEME_PATH}
+        target: /var/www/html/wp-content/themes/zibll
+        read_only: true
+    entrypoint: ["wp"]
+
+volumes:
+  zibll_db:
+  zibll_wp:
+  zibll_caddy_data:
@@ -0,0 +1,4 @@
+https://localhost {
+	tls internal
+	reverse_proxy wordpress:80
+}