0 Fork 0

Files

T

kate522andClaude Opus 5 35bb96e82f refactor: rename the theme brand and every identifier from AKSRT to Jio

Full-project rename. `git grep -i aksrt` is now empty apart from the
DBMigrator 3.3.0 changelog note that documents the rename itself.

Code identifiers
- PHP namespace AKSRT\ -> Jio\ (composer PSR-4 + 378 declarations)
- global constants AKSRT_* -> JIO_* (VERSION/DIR/URI, PAY_TYPE_*, CAPTCHA_*)
- procedural functions, hooks, options, meta keys, table names,
  cookies, query vars, ajax actions and nonces: aksrt_ -> jio_
- text domain aksrt -> jio; Theme Name -> Jio
- JS globals: aksrtData/aksrtAdminData/... -> jioData/jioAdminData/...,
  window.AKSRTCaptcha & friends -> window.JioCaptcha, Aksrt* -> Jio*
- Vue components Aks*.vue -> Jio*.vue (15 files renamed + imports)
- CSS classes/data-attrs/custom properties: aksrt- -> jio-
- REST namespace aksrt/v1 -> jio/v1 (incl. payment gateway callbacks)

Storage layer
- DB tables {prefix}aksrt_* -> {prefix}jio_*; SCHEMA_VERSION 3.2.0 -> 3.3.0
  so dbDelta creates the new names on install
- widget id_base aksrt_widget_* -> jio_widget_*
- uninstall.php drop list rebuilt from the actual migrator tables
  (dropped 3 stale entries, added the 17 missing ones)

Removed
- hardcoded https://api.aksrt.com/version.json default update endpoint;
  get_endpoint() now reads the 「更新端点」 setting and do_check() no-ops
  when it is empty

Files renamed: inc/helpers/aksrt-*.php -> jio-*.php (54),
assets/admin/src/components/form/Aks*.vue -> Jio*.vue (15).
Build artifacts regenerated: assets/css/build, assets/js/runtime,
assets/admin/build.

Verified: audit-psr4-paths errors=0, audit-admin-contracts errors=0
(warnings=56, unchanged baseline), 813/813 widget-system tests,
44/44 phpunit, php -l clean across all PHP.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-11-01 20:05:04 +08:00

3.5 KiB

Raw Permalink Blame History

ADR: Domain folder placement + PSR-4 namespaces for theme types

Status

Accepted (2026-07-17); updated 2026-08-02 for Composer PSR-4 root flatten to src/.

Context

Domain folders were frozen after the root→domain move. Theme types then migrated from global JIO_* + manual require_once to real PHP namespaces under src/ with Composer PSR-4.

Decision

Domain ownership (unchanged)

Concern	Domain	Why
Theme shell (setup, scripts, templates, SEO, meta boxes, DB migrator, front-submit, docs presenter, home modules, stats, redirects, update checker, comment actions)	`Core`	Shared CMS plumbing
SPA shell + controllers + schema + native ops	`Admin`	Dual-surface IA
Settings facade + runtime delegates	`Settings`	Single public settings API
Auth, OAuth, captcha, moderation, email rollback	`Auth`	Identity & access
User center/home/badges/level/metrics/notifications/follow	`User`	Account surface
Credits, balance wallet, signin, invite, points-free	`Credits`	Points + cash wallet
Download tokens/state, content pay, VIP, visibility	`Content`	Post-centric paid content
Orders, gateways, coupon, charge-card, revenue, creator-revenue, withdrawal, rebate, discount, shipping, wechat-notify	`Payment`	Commerce + settlement
Shop services/meta/reviews	`Shop`	Product catalog / cart
SMS stack	`Sms`	Messaging channel
AI runtime (admin AI controller stays in `Admin`)	`Ai`	Generation helpers
Message, private message, site notice, report center	`Messages`	In-site messaging
MeiliSearch, search-push, ip-geo, content-audit, api-audit	`Extensions`	Optional integrations
Widgets + registry	`Widgets`	WP widgets
Inline style / custom code / loading overlay	`Frontend`	Asset render helpers

PSR-4 layout

Composer: "Jio\\": "src/"
Namespace Jio\{Domain}\… ↔ path src/{Domain}/…
One type per file; StudlyCaps filename = short class/trait/interface name
Nested segments: Admin\Schema, Admin\Native, Payment\Gateways, Admin\Schema\PostList
OAuth stays under Auth (Jio\Auth\OAuth) — no separate oauth/ tree
Do not move TopicPay / PlateFollowPay into Content without updating this ADR
CreatorRevenue and WeChatNotify stay under Payment

Loader

functions.php loads vendor/autoload.php (Composer: third-party + theme PSR-4)
Immediately after, canary class_exists(\Jio\Core\DomainModel::class) — if missing, wp_die with composer install / composer dump-autoload -o (stale vendor/ after PSR-4 cutover is the common failure)
inc/bootstrap.php loads helpers + procedural modules (inc/modules/*) + core-hooks only
Singleton init() remains in functions.php using FQCNs

Deploy note: vendor/ is gitignored. After pull/upload, run composer install --no-dev --optimize-autoloader (or at least composer dump-autoload -o) in the theme root so autoload_psr4 includes "Jio\\": ["…/src"].

Procedural (not PSR-4)

inc/helpers/* function libraries
inc/modules/* (captcha, user-hub/parts, user-notifications, widgets-register, …)
inc/core-hooks.php (+ parts)

The one-shot tools/build-psr4-map.php migrator (and tools/psr4-map/ artifacts) were removed when inc/classes was deleted — they scanned the old tree and cannot run anymore.

Out of scope

Dual-read class_alias shims for old JIO_* global names (rewrite references instead)
Converting all helpers to classes

3.5 KiB Raw Permalink Blame History