12 lines
16 KiB
JSON
12 lines
16 KiB
JSON
{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\nExplore how slot_sdk (or slot/sdk) is used for inter-service communication in the slot monorepo. Find:\n1. What is slot_sdk - package structure, main purpose\n2. Examples of services calling other services via SDK vs direct HTTP/internal calls\n3. Any existing documentation about this pattern\n4. Naming conventions (Sdk classes, client methods, etc.)\n\nSearch in: /Users/ray/Documents/project/www/slot/slot_sdk, and grep across slot_wallet, slot_user, slot_center, slot_pay, backend for Sdk usage.\n\nReturn: concise summary with key file paths, typical call pattern (code snippet), and recommended terminology for a Cursor rule.\n</user_query>"}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"Exploring slot_sdk structure and cross-service usage patterns across the monorepo.\n\n[REDACTED]"},{"type":"tool_use","name":"updateCurrentStep","input":{"current_step":"Exploring slot_sdk structure"}},{"type":"tool_use","name":"Glob","input":{"target_directory":"/Users/ray/Documents/project/www/slot/slot_sdk","glob_pattern":"**/*"}},{"type":"tool_use","name":"Grep","input":{"pattern":"slot_sdk|SlotSdk|\\\\\\\\Sdk\\\\\\\\","path":"/Users/ray/Documents/project/www/slot","glob":"*.{php,md,json}","head_limit":80}},{"type":"tool_use","name":"Grep","input":{"pattern":"use Sdk\\\\|use slot_sdk","path":"/Users/ray/Documents/project/www/slot","glob":"*.php","head_limit":60}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/readme.md"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/composer.json"}},{"type":"tool_use","name":"Grep","input":{"pattern":"slot\\\\\\\\sdk|Slot\\\\\\\\Sdk|library/slot_sdk","path":"/Users/ray/Documents/project/www/slot","glob":"*.{php,json,md}","head_limit":100}},{"type":"tool_use","name":"Grep","input":{"pattern":"WalletService|WalletClient|CenterService|UserService","path":"/Users/ray/Documents/project/www/slot/slot_wallet","glob":"*.php","head_limit":40}},{"type":"tool_use","name":"Grep","input":{"pattern":"WalletService|WalletClient|CenterService|UserService","path":"/Users/ray/Documents/project/www/slot/slot_user","glob":"*.php","head_limit":40}},{"type":"tool_use","name":"Grep","input":{"pattern":"WalletService|WalletClient|CenterService|UserService","path":"/Users/ray/Documents/project/www/slot/slot_pay","glob":"*.php","head_limit":40}},{"type":"tool_use","name":"Grep","input":{"pattern":"WalletService|WalletClient|CenterService|UserService","path":"/Users/ray/Documents/project/www/slot/backend","glob":"*.php","head_limit":40}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Grep","input":{"pattern":"slotsdk\\\\","path":"/Users/ray/Documents/project/www/slot","glob":"*.php","head_limit":120}},{"type":"tool_use","name":"Glob","input":{"target_directory":"/Users/ray/Documents/project/www/slot/slot_sdk/src","glob_pattern":"**/*.php"}},{"type":"tool_use","name":"Grep","input":{"pattern":"innerapi|HttpClient|Guzzle","path":"/Users/ray/Documents/project/www/slot/slot_center","glob":"*.php","head_limit":30}},{"type":"tool_use","name":"Grep","input":{"pattern":"slotsdk|slot_sdk","path":"/Users/ray/Documents/project/www/slot/docs","glob":"**/*"}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/Client.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/http/HttpClient.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/Config.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/wallet/WalletClient.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/wallet/WalletService.php","limit":80}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_agent/doc/feature_agent.md","limit":80}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/backend/slot_admin/app/service/WalletService.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_agent/app/service/UserReferralGatewayService.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_console/app/service/WalletService.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/http/ResponseHandler.php"}},{"type":"tool_use","name":"Grep","input":{"pattern":"HttpClient|innerapi","path":"/Users/ray/Documents/project/www/slot/backend","glob":"*.php","head_limit":40}},{"type":"tool_use","name":"Grep","input":{"pattern":"slotLib|InnerCurl|innerapi","path":"/Users/ray/Documents/project/www/slot/slot_pay","glob":"*.php","head_limit":30}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/user/UserClient.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/user/UserService.php","limit":60}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_console/app/api/controller/UserController.php","limit":80}},{"type":"tool_use","name":"Grep","input":{"pattern":"\"slot/sdk\"|slotsdk","path":"/Users/ray/Documents/project/www/slot","glob":"composer.json"}},{"type":"tool_use","name":"Grep","input":{"pattern":"slot_sdk|slot/sdk|slotsdk","path":"/Users/ray/Documents/project/www/slot/docs"}},{"type":"tool_use","name":"Grep","input":{"pattern":"slot_sdk|slotsdk","path":"/Users/ray/.cursor","glob":"**/*"}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_user/composer.json","limit":70}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/BaseEntity.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/service/agent/AgentService.php","limit":50}},{"type":"tool_use","name":"Grep","input":{"pattern":"class WalletService","path":"/Users/ray/Documents/project/www/slot/slot_lib","glob":"*.php"}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/backend/slot_admin/app/game/controller/FreeCreditsStatsController.php","limit":50}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_lib/src/services/WalletService.php","limit":60}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_lib/src/basic/BaseApiService.php","limit":50}},{"type":"tool_use","name":"Grep","input":{"pattern":"InnerCurlService","path":"/Users/ray/Documents/project/www/slot/slot_console","glob":"*.php","head_limit":15}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_center/app/service/InnerCurlService.php","limit":40}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/slot_sdk/src/tests/wallet/WalletClientTest.php","limit":40}},{"type":"tool_use","name":"Read","input":{"path":"/Users/ray/Documents/project/www/slot/backend/slot_admin/app/service/api/RiskAPIService.php","limit":40}},{"type":"tool_use","name":"Grep","input":{"pattern":"GatewayService|ApiHost","path":"/Users/ray/Documents/project/www/slot","glob":"*.php","head_limit":25}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"[REDACTED]"},{"type":"tool_use","name":"updateCurrentStep","input":{"current_step":"Summarizing SDK findings","final_summary":"**slot_sdk** (`slot/sdk`, namespace `slotsdk\\`) is a Guzzle-based HTTP client library for cross-service calls to other services’ `innerapi/*` and `api/*` routes—not used by domain services like wallet/user themselves. Consumers: `slot_admin`, `slot_agent`, `slot_console`, `slot_pwa`. Legacy alternatives still common: per-app `InnerCurlService` and `slot_lib` (`slotLib\\services\\*`).","completed_subtitle":"Mapped slot_sdk inter-service usage"}}]}}
|
||
{"role":"assistant","message":{"content":[{"type":"text","text":"## 1. What is `slot_sdk`?\n\n| Item | Detail |\n|------|--------|\n| Repo | `/Users/ray/Documents/project/www/slot/slot_sdk` |\n| Composer | `slot/sdk` v1.0.0, PSR-4 `slotsdk\\` → `src/` |\n| Purpose | **Cross-service HTTP client library** — typed wrappers over other Webman services’ `innerapi/*` / `api/*` endpoints (Guzzle + unified `{code, data}` handling) |\n\n**Package layout**\n\n```\nslot_sdk/src/\n├── Config.php # host, timeout, headers, only_data\n├── http/\n│ ├── HttpClient.php # get/post (+ async), middleware stack\n│ ├── ResponseHandler.php # code===0 → data; else ApiException\n│ └── middleware/ # Trace, Retry, (Signature stub)\n├── exception/ # ApiException, ConfigException\n├── service/\n│ ├── Client.php # base: host → HttpClient\n│ ├── BaseEntity.php\n│ ├── {agent,center,console,risk,user,wallet}/\n│ │ ├── *Client.php # extends Client, service() → *Service\n│ │ ├── *Service.php # one method per remote route\n│ │ └── entity/ # *Entity, *RequestEntity\n│ └── agent/AgentAsyncService.php\n└── tests/ # integration-style client tests\n```\n\n**Remote domains covered:** `agent`, `user`, `wallet`, `center`, `risk`, `console`.\n\n**Who depends on it** (composer `\"slot/sdk\"`): \n`backend/slot_admin`, `slot_agent`, `slot_console`, `slot_pwa`.\n\n**Who does not** (they are call targets or use other patterns): \n`slot_wallet`, `slot_user`, `slot_center`, `slot_pay` — no `slotsdk\\` imports found.\n\n---\n\n## 2. SDK vs direct HTTP — examples\n\n### Pattern A (preferred for new cross-service code): `*Client` → `service()` → `*Service`\n\n```php\nuse slotsdk\\Config as SDKConfig;\nuse slotsdk\\service\\wallet\\WalletClient;\n\n$config = new SDKConfig([\n 'host' => ShareConfigService::get('walletApiHost'),\n 'headers' => ['server-name' => config('app.server_name')],\n]);\n$stats = (new WalletClient($config))->service()->getStatistics($uids, $currency);\n```\n\n- SDK impl: `/Users/ray/Documents/project/www/slot/slot_sdk/src/service/wallet/WalletService.php` → `api/wallet/statistics`\n- Consumer: `/Users/ray/Documents/project/www/slot/backend/slot_admin/app/service/WalletService.php` (`statistic`, `resetBetWin`, `getLeftBetFee`)\n\n### Pattern B: raw `HttpClient` for admin proxy / path fallback\n\n```php\n$client = new HttpClient(new Config(['host' => $host, 'headers' => [...]]));\n$data = $client->get('innerapi/admin/referralFission/index', $params);\n```\n\n- `/Users/ray/Documents/project/www/slot/backend/slot_admin/app/tenant/controller/agent/ReferralFissionController.php`\n- `/Users/ray/Documents/project/www/slot/slot_agent/app/service/UserReferralGatewayService.php` (SDK `UserService` + raw `innerapi/user/son` + path fallback)\n\n### Pattern C (legacy, same repo): `InnerCurlService` + full URL\n\n```php\n$url = ShareConfigService::get('walletApiHost') . '/api/wallet/addCurrency';\nInnerCurlService::getInstance()->post($url, $data);\n```\n\n- Same admin `WalletService` for `addFee` / `balance` / `minusFee`\n- `/Users/ray/Documents/project/www/slot/slot_console/app/service/pwa/PWAService.php` (many PWA innerapi calls)\n- `/Users/ray/Documents/project/www/slot/slot_center/app/service/InnerCurlService.php` (center’s own helper)\n\n### Pattern D (parallel stack): `slot_lib` — not `slot_sdk`\n\n`slot_pay` uses `slotLib\\services\\WalletService` (`BaseApiService` + `walletApiHost` + `api/wallet`), e.g. \n`/Users/ray/Documents/project/www/slot/slot_pay/app/command/EventRecharge.php`.\n\n`slot_console` often mixes **both**: `slotsdk` for agent/user/risk + `slotLib\\services\\WalletService` for wallet mutations.\n\n### Host configuration\n\nCenter publishes `*ApiHost` keys (`walletApiHost`, `userApiHost`, `agentApiHost`, …): \n`/Users/ray/Documents/project/www/slot/slot_center/config/share_config.php`.\n\nConsumers load via `ShareConfigService` → `centerApiHost` + `/innerapi/share-config/all`.\n\n---\n\n## 3. Documentation\n\n| Location | Content |\n|----------|---------|\n| `/Users/ray/Documents/project/www/slot/slot_sdk/readme.md` | PHPUnit commands only |\n| `/Users/ray/Documents/project/www/slot/slot_agent/doc/feature_agent.md` | States agent must call user service via `slot_sdk` innerapi, not user DB |\n| `/Users/ray/Documents/project/www/slot/docs` | No `slot_sdk` docs found |\n| Inline PHPDoc | e.g. `FreeCreditsStatsController`: “经 slot/sdk 透传 slot_console innerapi” |\n\nNo central architecture doc; conventions are inferred from SDK structure + agent doc + comments.\n\n---\n\n## 4. Naming conventions\n\n| Layer | Convention | Example |\n|-------|------------|---------|\n| Namespace | `slotsdk\\` (lowercase) | `slotsdk\\service\\user\\UserClient` |\n| Per remote service | `{Domain}Client` + `{Domain}Service` | `UserClient`, `WalletService` |\n| Client entry | `service(): XxxService` | `WalletClient::service()` |\n| DTOs | `entity/*Entity`, requests `*RequestEntity` | `ReferralBindRequestEntity` |\n| Remote paths | `innerapi/{domain}/...` (service-to-service), `api/{domain}/...` (wallet etc.) | `innerapi/user/info`, `api/wallet/statistics` |\n| Config | `slotsdk\\Config`, import alias `SDKConfig` | `'host' => ShareConfigService::get('userApiHost')` |\n| Caller identity | Header `server-name` | `'server-name' => 'agent'` |\n| App-side gateway | `*GatewayService` wrapping SDK | `UserReferralGatewayService` |\n| Exceptions | `slotsdk\\exception\\ApiException` | non-zero `code` in JSON body |\n\n**Do not confuse** with in-process `app\\service\\UserService` / `app\\service\\WalletService` inside each Webman app — those are local domain services, not the SDK classes.\n\n---\n\n## Recommended Cursor rule terminology\n\n```markdown\n# Cross-service HTTP (slot_sdk)\n\n- Use **slot_sdk** (`composer` package `slot/sdk`, namespace `slotsdk\\`) for HTTP calls from one Webman service to another’s **innerapi** or **api** routes.\n- Do **not** add `slot/sdk` to domain services that *are* the API target (e.g. slot_wallet, slot_user) unless they must call a third service.\n- Preferred call chain: `new {Domain}Client($config)->service()->{method}(...)`.\n- Build config from center share-config hosts: `walletApiHost`, `userApiHost`, `agentApiHost`, `consoleApiHost`, `blackApiHost`, etc. Always set header `server-name` to the calling service name.\n- Add new remote APIs in **slot_sdk** first (`{Domain}Service` method + path + entity if needed), then call from consumer; avoid duplicating URLs in many repos.\n- In consuming apps, wrap repeated cross-service access in `*GatewayService`; keep Controller/Logic thin.\n- **Legacy (avoid for new code):** per-app `InnerCurlService` + concatenated URLs; **slot_lib** `slotLib\\services\\*` (`BaseApiService`) — still used in slot_pay / parts of slot_console; migrate to slot_sdk when touching that area.\n- Naming: SDK classes are `slotsdk\\service\\{domain}\\{Domain}Client|{Domain}Service`; DTOs under `entity/` as `{Name}Entity` / `{Name}RequestEntity`. Do not name local `app\\service\\*` the same as SDK types without aliasing (`SDKConfig`, explicit imports).\n```\n\n---\n\n**Typical end-to-end flow**\n\n```mermaid\nsequenceDiagram\n participant Console as slot_console\n participant SDK as slotsdk WalletClient\n participant Wallet as slot_wallet api\n\n Console->>SDK: Config(host=walletApiHost)\n SDK->>Wallet: POST api/wallet/statistics\n Wallet-->>SDK: {code:0, data:{...}}\n SDK-->>Console: WalletStatEntity[] or ApiException\n```\n\n[REDACTED]"}]}} |