kate522
8c5b1555c9
Move all domain folders from src/AKSRT/{Domain} to src/{Domain}; remap
Composer PSR-4 "AKSRT\\": "src/"; update audit script + README + ADR
paths; remove dead tools/build-psr4-map.php (scanned deleted inc/classes).
63 lines
3.6 KiB
Markdown
63 lines
3.6 KiB
Markdown
# 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 `AKSRT_*` + 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 |
|
|
| Topic pay, plate follow pay | `Forum` | Forum SKUs (not generic content pay) |
|
|
| Orders, gateways, coupon, charge-card, revenue, creator-revenue, withdrawal, rebate, discount, after-sale, 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: `"AKSRT\\": "src/"`
|
|
- Namespace `AKSRT\{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` (`AKSRT\Auth\OAuth`) — no separate `oauth/` tree
|
|
- Do not move `TopicPay` / `PlateFollowPay` into `Content` without updating this ADR
|
|
- `CreatorRevenue` and `WeChatNotify` stay under `Payment`
|
|
|
|
### Loader
|
|
|
|
1. `functions.php` loads `vendor/autoload.php` (Composer: third-party + theme PSR-4)
|
|
2. Immediately after, canary `class_exists(\AKSRT\Core\DomainModel::class)` — if missing, `wp_die` with `composer install` / `composer dump-autoload -o` (stale `vendor/` after PSR-4 cutover is the common failure)
|
|
3. `inc/bootstrap.php` loads helpers + procedural modules (`inc/modules/*`) + core-hooks only
|
|
4. 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 `"AKSRT\\": ["…/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 `AKSRT_*` global names (rewrite references instead)
|
|
- Converting all helpers to classes
|