kate522andClaude Opus 5
35bb96e82f
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>
52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
# Admin contract map
|
|
|
|
Generated by process, not a migration guide. Source of truth for menu ↔ schema wiring.
|
|
|
|
## Rules
|
|
|
|
1. Every `schemaPage` must have matching PHP section under the same domain.
|
|
2. Enum field values must be identical in PHP schema and JS schema.
|
|
3. REST `'callback' => [$this, 'method']` methods must exist (class or trait).
|
|
4. Deploy `assets/admin/build/` as one atomic unit after `npm run build`.
|
|
5. No compat aliases, dual-read, or silent frontend catch for missing APIs.
|
|
|
|
## Audit
|
|
|
|
```bash
|
|
php tools/audit-admin-contracts.php
|
|
```
|
|
|
|
Exit code `1` means hard contract errors.
|
|
|
|
## Domain builders
|
|
|
|
| Domain | PHP builder map key | Menu constants file |
|
|
|--------|---------------------|---------------------|
|
|
| global | `JIO_Admin_Schema_Global` | `assets/admin/src/constants/sections/global.js` |
|
|
| page_display | `JIO_Admin_Schema_Page_Display` | `page-display.js` |
|
|
| post_list | `JIO_Admin_Schema_Post_List` | `post-list.js` |
|
|
| permissions | `JIO_Admin_Schema_Permissions` | `permissions.js` |
|
|
| users | `JIO_Admin_Schema_Users` | `users.js` |
|
|
| payment | `JIO_Admin_Schema_Payment` | `payment.js` |
|
|
| extensions | `JIO_Admin_Schema_Extensions` | `extensions.js` |
|
|
| tools | `JIO_Admin_Schema_Tools` | `tools.js` |
|
|
| shop | `JIO_Admin_Schema_Shop` | `shop.js` |
|
|
|
|
## Known custom pages (not schema REST)
|
|
|
|
These use dedicated Vue pages + dedicated REST modules:
|
|
|
|
- Homepage: `HomepageSettings` + `/settings/homepage`
|
|
- Footer: `FooterSettings` + footer settings API
|
|
- Permissions capabilities matrix: `PermissionsCapabilities` + `/permissions/capabilities`
|
|
- Shop products/orders and other operational tables
|
|
- 工单中心: `UsersTicket` + schema `users/ticket` + `jio/v1/admin/tickets*`（部门 / 状态 / 预设回复）
|
|
|
|
## Deploy checklist
|
|
|
|
1. `cd assets/admin && npm ci && npm run build`
|
|
2. Confirm `build/index.js` and every dynamically imported `./Chunk.hash.js` exist
|
|
3. Replace the entire remote `assets/admin/build/` directory
|
|
4. Hard-refresh wp-admin (or purge CDN)
|
|
5. Re-run `php tools/audit-admin-contracts.php`
|