From 4252dc97e34efe08a4b648bd42d6558b046fda29 Mon Sep 17 00:00:00 2001 From: unknown Date: Wed, 15 Jul 2026 17:45:09 +0800 Subject: [PATCH] chore: stop tracking docs/ (gitignored local planning only) Remove previously tracked docs from the repository. docs/ remains in .gitignore so it will not be re-uploaded. --- docs/admin-ia-map.md | 152 --------------------------------------- docs/zibll-gap-matrix.md | 107 --------------------------- 2 files changed, 259 deletions(-) delete mode 100644 docs/admin-ia-map.md delete mode 100644 docs/zibll-gap-matrix.md diff --git a/docs/admin-ia-map.md b/docs/admin-ia-map.md deleted file mode 100644 index 9ca7ea06..00000000 --- a/docs/admin-ia-map.md +++ /dev/null @@ -1,152 +0,0 @@ -# Admin IA Map — zibll-aligned native ops + SPA config - -> Living blueprint for AKSRT admin information architecture after the zibll 1:1 ops-menu migration. -> Source of truth for *where* a surface lives; field-level schema remains in Vue schema / PHP schema provider. - -## Split rule (locked) - -| Layer | Surface | Purpose | -|-------|---------|---------| -| **WP native sidebar** | CPT menus, `aksrt_pay` top menu, `users.php` submenus | Day-to-day **operations** (content CRUD, orders, tickets) | -| **AKSRT SPA** (`admin.php?page=aksrt-settings#/...`) | Schema-driven pages only | **Configuration** (switches, layout, gateways, policies) | - -Do **not** reintroduce operational workbenches into the SPA once native pages ship. - ---- - -## Native sidebar tree (target) - -``` -[pos ~34 separator] -商城 (aksrt_product) pos 35, dashicons-store -├─ 所有商品 / 新增商品 -├─ 商品分类 (aksrt_product_cat) -├─ 特色标签 (aksrt_product_tag) -└─ 优惠活动 (shop_discount) - -支付中心 (aksrt_pay) pos ~36–38, dashicons-cart -├─ 概览 aksrt_pay -├─ 订单 aksrt_orders -├─ 付费文章 aksrt_pay_products -├─ 下载记录 aksrt_download_logs -├─ 发货及物流 aksrt_shipping -├─ 售后管理 aksrt_after_sale -├─ 优惠码 aksrt_coupons -├─ 卡密管理 aksrt_charge_cards -├─ 创作分成 aksrt_income -├─ 推广返佣 aksrt_rebate -└─ 提现审核 aksrt_withdraw - -[pos ~39 separator] -论坛版块 (aksrt_forum_plate) pos 40, dashicons-buddicons-forums -├─ 所有版块 / 添加版块 -└─ 分区 (aksrt_plate_cat) - -论坛帖子 (aksrt_forum_topic) pos 40, dashicons-buddicons-topics -├─ 所有帖子 / 添加帖子 -├─ 话题 (aksrt_forum_topic_cat) -└─ 标签 (aksrt_forum_tag) - -用户 (WP core users.php) -├─ 消息管理 users.php?page=aksrt_messages -├─ 邀请码管理 users.php?page=aksrt_invite_codes -├─ 身份认证 users.php?page=aksrt_user_auth -└─ 举报&禁封 users.php?page=aksrt_user_ban - -AKSRT (SPA shell) pos 58, dashicons-admin-generic -└─ hash routes: config-only sections -``` - -### Feature gates - -| Surface | Settings key | Notes | -|---------|--------------|-------| -| 商城 CPT/tax | `shop_s` → `AKSRT_Settings::get_shop_settings()['enabled']` | Hide menu when shop off | -| 论坛 CPT/tax | `bbs_s` → `get_forum_settings()['enabled']` | Front skips registration when off; admin still registers but may hide menu | -| 支付中心子项 | payment/shop/rebate switches | Per-submenu | -| 用户子菜单 | message / invite / verify / ban flags | Align SPA users schema | - -Capability baseline: `manage_options` (later may tighten toward super-admin like zibll). - ---- - -## SPA config tree (retained) - -### 支付&付费 `/payment` - -| Route | Type | Notes | -|-------|------|-------| -| `/payment/paid` | custom/schema | Download / paid-content **policy** | -| `/payment/recharge` | schema | Balance recharge | -| `/payment/vip` | schema | VIP plans | -| `/payment/gateway` | custom | Gateway credentials | -| `/payment/order` | schema | Order display settings (not order list) | -| `/payment/affiliate` | schema | Rebate **rules** | -| `/payment/card-pass` | schema | Card rules/copy | -| `/payment/withdrawal` | schema | Withdraw **policy** (tickets → native) | - -**Removed from SPA (ops):** charge-card workbench, revenue table, rebate table. - -### 商城&商品 `/shop` - -| Route | Type | -|-------|------| -| `/shop/basic` | schema | -| `/shop/list` | schema | -| `/shop/single` | schema | -| `/shop/product-defaults` | schema | -| `/shop/contact` | schema | -| `/shop/shipping-config` | schema | -| `/shop/timing` | schema | - -**Removed from SPA (ops):** products, orders, after-sale, shipping, coupons, withdrawals, dashboard. - -Default SPA entry after strip: `/shop/basic`. - -### 社区&论坛 `/forum` - -| Route | Type | -|-------|------| -| `/forum/settings` | schema basic | -| `/forum/settings/names` | schema | -| `/forum/settings/homepage` | schema | -| `/forum/settings/board-page` | schema | -| `/forum/settings/post-page` | schema | -| `/forum/settings/reply` | schema | -| `/forum/settings/permissions` | schema | -| `/forum/settings/other` | schema | -| `/forum/settings/upload` | schema | -| `/forum/settings/credits` | schema | - -**Removed from SPA (ops):** boards, topics, moderators, moderator-applications, dashboard. - -Default SPA entry after strip: `/forum/settings`. - -### 用户&互动 `/users` (config kept) - -auth, oauth, features, signin, credits, verify **settings**, level, badge, notifications, sms, wechat, wechat-template. - -**Removed from SPA (ops):** messages, invite-codes, ban, report queues. - ---- - -## Canonical domain keys - -Internal keys remain: `global`, `page_display`, `post_list`, `permissions`, `users`, `payment`, `shop`, `forum`, `extensions`, `tools`. - -Route paths may stay friendly (`/page-display/...`); ops native pages use `admin.php?page=aksrt_*` slugs above. - ---- - -## Rollout phases - -| Phase | Deliverable | -|-------|-------------| -| 0 | This map + gap matrix | -| 1 | CPT/tax native menus | -| 2 | `aksrt_pay` PHP list pages | -| 3 | `users.php` governance submenus | -| 4 | Strip SPA ops routes/components | -| 5+ | Runtime behavior parity backlog | - -See also: [zibll-gap-matrix.md](./zibll-gap-matrix.md). diff --git a/docs/zibll-gap-matrix.md b/docs/zibll-gap-matrix.md deleted file mode 100644 index 901d49a2..00000000 --- a/docs/zibll-gap-matrix.md +++ /dev/null @@ -1,107 +0,0 @@ -# zibll ↔ AKSRT gap matrix (admin ops entry) - -Three-way mapping: **zibll current → AKSRT before migration → AKSRT target**. - -Focus: admin **entry & page shape**. Runtime field parity is Phase 5+. - ---- - -## Shop - -| zibll | AKSRT before | AKSRT target | Data / service | -|-------|--------------|--------------|----------------| -| CPT `shop_product` pos 35, `dashicons-store`, super-admin `show_ui` | `aksrt_product` `show_ui=true`, **`show_in_menu=false`** | Native menu pos 35, store icon; gate on `shop_s` | CPT | -| Tax `shop_cat` | `aksrt_product_cat` show_ui false | show_ui + admin column under product | taxonomy | -| Tax `shop_tag` | `aksrt_product_tag` show_ui false | show_ui under product | taxonomy | -| Tax `shop_discount` | `shop_discount` show_ui false | show_ui under product | `AKSRT_Shop_Term_Meta` | -| Product list columns | Trait exists, wired in `functions.php` | Keep/enhance on native list | admin columns trait | -| Product edit meta | SPA `ShopProducts` + REST | Native meta box (Phase 1b) | product ops / post meta | -| Orders | SPA `ShopOrders` | `admin.php?page=aksrt_orders` | `AKSRT_Order` | -| Shipping | SPA `ShopShipping` | `aksrt_shipping` | `AKSRT_Shipping` | -| After-sale | SPA `ShopAfterSale` | `aksrt_after_sale` | `AKSRT_After_Sale` | -| Coupons | SPA `ShopCoupons` / zibpay coupon page | `aksrt_coupons` | `AKSRT_Coupon` | -| Shop CSF config | SPA shop schema | **Keep SPA schema** | `AKSRT_Settings::get_shop_settings()` | - ---- - -## Forum / community - -| zibll | AKSRT before | AKSRT target | Data / service | -|-------|--------------|--------------|----------------| -| CPT `plate` pos 40, forums icon | `aksrt_forum_plate` **show_in_menu false** | show_in_menu true, pos 40, `dashicons-buddicons-forums` | CPT | -| Tax `plate_cat` | `aksrt_plate_cat` | show_ui under plate | taxonomy | -| CPT `forum_post` pos 40, topics icon | `aksrt_forum_topic` default menu, comments icon | pos 40, `dashicons-buddicons-topics`, explicit menu | CPT | -| Tax `forum_topic` / `forum_tag` | `aksrt_forum_topic_cat` / `aksrt_forum_tag` | show_ui under topic | taxonomy | -| Legacy board tax | — | `aksrt_forum_board` keep rewrite bridge, **hide admin UI** (plate is canonical) | taxonomy | -| Boards/topics SPA | `ForumBoards` / `ForumTopics` | Native CPT lists | `AKSRT_Forum` | -| Moderators / applications | SPA | Plate meta box + optional subpage | moderation service | -| BBS CSF config | SPA forum schema | **Keep SPA schema** | `get_forum_settings()` | - ---- - -## Payment / zibpay ops - -| zibll page | Purpose | AKSRT before | Target slug | Service | -|------------|---------|--------------|-------------|---------| -| `zibpay_page` | Dashboard | SPA dashboards | `aksrt_pay` | aggregates | -| `zibpay_page#/order` | Orders (new) | SPA ShopOrders | `aksrt_orders` | `AKSRT_Order` | -| `zibpay_order_page` | Orders (legacy) | SPA | same native list | | -| `zibpay_page#/shipping` | Shipping | SPA | `aksrt_shipping` | `AKSRT_Shipping` | -| `zibpay_page#/after-sale` | After-sale | SPA | `aksrt_after_sale` | `AKSRT_After_Sale` | -| `zibpay_product_page` | Paid-post sales report | done | `aksrt_pay_products` | content pay (`AKSRT_Admin_Pay_Products` + order aggregation) | -| `zibpay_income_page` | Creator income | `PaymentRevenue` | `aksrt_income` | `AKSRT_Revenue` | -| `zibpay_rebate_page` | Rebate | `PaymentRebate` | `aksrt_rebate` | `AKSRT_Rebate` | -| `zibpay_withdraw` | Withdraw | `ShopWithdrawals` | `aksrt_withdraw` | `AKSRT_Withdrawal` | -| `zibpay_charge_card_page` | Charge cards | `PaymentChargeCard` | `aksrt_charge_cards` | `AKSRT_Charge_Card` | -| `zibpay_coupon_page` | Coupons | `ShopCoupons` | `aksrt_coupons` | `AKSRT_Coupon` | -| CSF pay sections | Gateways/VIP/… | SPA payment schema | **Keep SPA** | settings | - -Note: zibll「商品管理」`zibpay_product_page` is **paid article sales**, not the physical `shop_product` CPT list. - ---- - -## User governance - -| zibll | slug | AKSRT before | Target | -|-------|------|--------------|--------| -| 消息管理 | `user_messags` under users.php | SPA `UsersMessages` | `users.php?page=aksrt_messages` | -| 邀请码管理 | `invit_code` | SPA `UsersInviteCodes` | `aksrt_invite_codes` | -| 身份认证 | `user_auth` | SPA `UsersVerify` queue | `aksrt_user_auth` | -| 举报&禁封申诉 | `user_ban` | SPA Ban + Report | single `aksrt_user_ban` with tabs | -| Credits column | users list | `AKSRT_User_Credits_Admin` | keep | -| CSF user config | — | SPA users schema | keep | - ---- - -## SPA ops routes to delete (Phase 4) - -### shop.js -`shop-products`, `shop-orders`, `shop-after-sale`, `shop-shipping`, `shop-coupons`, `shop-withdrawals`, `shop-dashboard` - -### forum.js -`forum-boards`, `forum-topics`, `forum-moderators`, `forum-moderator-applications`, `forum-dashboard` - -### payment.js -`payment-charge-card`, `payment-revenue`, `payment-rebate` (ops tables) - -### users.js -`users-messages`, `users-invite-codes`, `users-ban`, `users-report` (queues) - ---- - -## Phase status - -| Phase | Status | -|-------|--------| -| 0 Docs + matrix | done | -| 1 Native CPT/tax menus | done | -| 2a Pay menu + orders/withdraw/cards | done | -| 2b Shipping/after-sale/coupons/income/rebate | done | -| 3 users.php submenus | done | -| 4 SPA strip | done (ops routes redirect to native) | -| 5+ behavior parity | done — native ops shell + plate follow-pay + topic pay matrix + multi-gateway topic cashier (`AKSRT_Topic_Pay` /pay/topic) + topic coupon burn (P1) + plate follow VIP1/2 + multi-gateway (`AKSRT_Plate_Follow_Pay` /pay/plate-follow) + cash creator revenue (content/topic/plate) + sales report/download logs + hidecontent + users commerce + order filters/clear-closed + post pay_type filter + bulk content-pay edit + income/rebate user filter | -| 5 remaining | optional polish only; guest topic/plate cash purchase + cookie unlock done (reuses pay_no_logged_in / pay_cookie_day) | - -## Dual-UI rule - -Native write path must work **before** removing the matching SPA ops route. No data migration: same tables/meta; UI only.