Skip to content

Commit 738d425

Browse files
dengzhaofunclaude
dengzhaofun
and
claude
authored
docs(admin): product overview section for decision-makers — zh + en (#159)
New "产品概览 / Product Overview" sidebar group with 5 bilingual pages targeting decision-makers, product managers, and operations teams — complementing the existing developer-focused docs. Pages added (zh + en): - product-overview: what ApolloKit is, core value props, module landscape - why-apollokit: self-build pain points, comparison table, use-case scenarios - feature-map: all modules by ops scenario with ✅/⚡ self-serve indicators - ai-features: built-in AI agent system (form-fill, global assistant, @mention) - for-operators: step-by-step workflows for common ops tasks without code Also updated: - meta.json (zh + en): added group + slugs, retitled to "ApolloKit 文档 / ApolloKit Docs" - index.mdx (zh + en): added "Who are you?" dual-entry cards at top Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 7b537a6 commit 738d425

14 files changed

Lines changed: 1164 additions & 10 deletions

‎apps/admin/content/docs/en/ai-features.mdx‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
---
2+
title: AI-Powered Operations
3+
description: ApolloKit's built-in AI agent system — form-fill, global assistant, smart suggestions, all driving faster ops configuration
4+
icon: Sparkles
5+
---
6+
7+
ApolloKit ships a complete **AI agent system** that covers the full loop — from configuring a new campaign to optimizing existing settings. Ops teams don't need to learn every field. Just describe the outcome you want, and the AI handles the rest.
8+
9+
---
10+
11+
## AI Form-Fill Agent
12+
13+
<Callout type="info" title="Where to find it">
14+
When creating or editing any supported module configuration in the dashboard, an AI conversation panel appears on the right side of the screen (or at the bottom on mobile).
15+
</Callout>
16+
17+
**What it does:** You describe what you want in plain language. The agent parses your intent and fills in all the relevant configuration fields. You review and confirm.
18+
19+
### Example Conversations
20+
21+
> **Ops:** "Create a 7-day consecutive check-in: 100 coins on day 3, a rare item on day 7"
22+
>
23+
> **AI:** Automatically identifies the day count, reward types, and quantities — fills the entire check-in config — ready for one-click save
24+
25+
> **Ops:** "Set up a lottery with pity: guaranteed SR at 10 pulls, guaranteed SSR at 50"
26+
>
27+
> **AI:** Configures pool tiers, pity counters, and trigger thresholds automatically
28+
29+
### Modules with AI Form-Fill (14 modules)
30+
31+
| Module | Module | Module |
32+
|--------|--------|--------|
33+
| Check-in | Announcements | Currency |
34+
| Lottery | Carousel Banner | Leaderboard |
35+
| System Mail | Redemption Codes | Rank / Division |
36+
| Shop | Character | Team |
37+
| Assist Pool | Badge | |
38+
39+
### @-Mentioning Existing Resources
40+
41+
Type `@` in the AI conversation to reference existing resources in the dashboard, so the AI can reference them precisely:
42+
43+
- `@coins` → references your defined currency
44+
- `@rare-item` → references a specific item definition
45+
- `@daily-task` → references an existing task config
46+
47+
---
48+
49+
## Global AI Assistant
50+
51+
<Callout type="info" title="Where to find it">
52+
The sparkle button (✨) fixed in the bottom-right corner of the dashboard. Available from any page, any time.
53+
</Callout>
54+
55+
The global assistant is context-aware — it knows which page you're on and tailors its suggestions accordingly.
56+
57+
**What it can do:**
58+
59+
- **Answer questions:** "How does the pity counter work?" "Can redemption codes be limited to one use per person?"
60+
- **Smart suggestions:** Proactively suggest improvements for the configuration on the current page
61+
- **Apply changes with one click:** When the assistant proposes a modification, it shows a confirmation card — you approve and it takes effect immediately
62+
- **Cross-module consulting:** "How should I structure a new-player onboarding task chain?"
63+
- **Navigation guidance:** "Where do I configure mail attachments?" → The assistant navigates you there
64+
65+
### Context Awareness in Action
66+
67+
The assistant knows where you are, so you don't need to repeat the context:
68+
69+
- On the check-in list page asking "How do I create one?" → The assistant walks you through the creation flow
70+
- On an activity edit page asking "Is this reward value reasonable?" → The assistant reads the current config and gives an assessment
71+
72+
---
73+
74+
## AI-Powered Documentation Search
75+
76+
The docs site (this page) has built-in AI conversational search — click the search bar in the top right to use it.
77+
78+
It's not just keyword matching. Ask real questions:
79+
80+
> "How do I configure different reward tiers for a check-in campaign?"
81+
> "What's the relationship between lottery pity and prize pool tiers?"
82+
83+
---
84+
85+
## A Complete AI-Assisted Workflow
86+
87+
Here's a full end-to-end ops scenario showing AI woven throughout:
88+
89+
<Steps>
90+
<Step>
91+
92+
### Decide on the Campaign
93+
94+
Ops wants to ship a Golden Week 7-day check-in event with escalating rewards and a big prize on day 7. Open the Check-in module → New Configuration.
95+
96+
</Step>
97+
<Step>
98+
99+
### AI Fills the Form
100+
101+
In the right-side AI panel, type: "Golden Week 7-day check-in, rewards increase each day, final day gets 1000 coins and a holiday gift box."
102+
103+
The AI fills in: day count, per-day reward type and quantity, cycle settings, and config alias.
104+
105+
</Step>
106+
<Step>
107+
108+
### Review and Tweak
109+
110+
Check the AI-filled parameters. Day 3's reward feels light — edit it directly in the form, or continue the conversation: "Change day 3 to 200 coins."
111+
112+
</Step>
113+
<Step>
114+
115+
### Save and Ship
116+
117+
Confirm everything looks good, hit Save. The campaign is live immediately. Engineering does nothing.
118+
119+
</Step>
120+
</Steps>
121+
122+
**Zero code. No engineering tickets. From idea to live in under 10 minutes.**
123+
124+
---
125+
126+
## AI vs. Manual Configuration
127+
128+
| | Manual Configuration | AI-Assisted |
129+
|--|---------------------|-------------|
130+
| **Configure a check-in campaign** | Learn every field, fill each one individually | Describe it in a sentence; AI fills everything |
131+
| **Adjust a reward value** | Find the field → edit → save | Tell the AI: "Change day 3 to 200" |
132+
| **Unfamiliar module** | Read the docs to understand each field | Ask the AI or let it guide you |
133+
| **Modify existing configs** | Edit each config one by one | Global assistant suggests batch changes + one-click apply |
134+
135+
<Callout type="info">
136+
Want to see AI-assisted workflows in practice? Check the step-by-step scenarios in [Operator Quick Start](./for-operators).
137+
</Callout>

‎apps/admin/content/docs/en/feature-map.mdx‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: Feature Map
3+
description: Browse all ApolloKit modules by ops scenario — self-serve and AI coverage at a glance
4+
icon: Map
5+
---
6+
7+
This page organizes ApolloKit's capabilities from an **operations perspective**. Each feature is annotated with:
8+
9+
- ✅ **Dashboard self-serve** — No engineering required; configure directly in the admin dashboard
10+
- ⚡ **AI one-sentence config** — Supports AI agent form-fill; describe what you want in plain language
11+
12+
---
13+
14+
## Economy
15+
16+
The complete loop for virtual assets — from issuance to consumption.
17+
18+
| Feature | Description | Self-serve |
19+
|---------|-------------|------------|
20+
| **Currency System** | Define multiple in-game currencies (coins, gems, points…), manage issuance, deduction, balance, and ledger auditing | ✅ ⚡ |
21+
| **Items & Inventory** | Item definitions, categories, player inventories, item grants, and audit trails | ✅ ⚡ |
22+
| **Shop** | Product categories, tags, growth-pack stages, purchase limits, and buy flows | ✅ ⚡ |
23+
| **Redemption Codes** | Batch generation, per-code / per-user / global usage limits, KOL distribution | ✅ ⚡ |
24+
| **Exchange** | Point or item exchange for rewards, with per-user and global quotas, idempotent execution | ✅ |
25+
| **Storage Box** | Deposit + interest mechanics; supports fixed-term savings and risk-investment configurations | ✅ ⚡ |
26+
27+
---
28+
29+
## Live Ops
30+
31+
The core toolkit for player retention and reactivation — all fully configurable without engineering.
32+
33+
| Feature | Description | Self-serve |
34+
|---------|-------------|------------|
35+
| **Check-in** | Daily check-in, consecutive streak tracking, automatic cycle resets, tiered reward configuration | ✅ ⚡ |
36+
| **Task System** | Task categories and definitions, event-driven progress updates, multi-tier milestone rewards | ✅ |
37+
| **Lottery** | Pool definitions, prize tiers, pity counters, single and multi-draw | ✅ ⚡ |
38+
| **Activity** | Lifecycle management, node scheduling, points accumulation, milestone rewards | ✅ |
39+
| **System Mail** | Send system messages with attached rewards (currency/items); players claim from their in-game inbox | ✅ ⚡ |
40+
41+
---
42+
43+
## Announcements & Reach
44+
45+
Precise player communication that drives campaign awareness and conversion.
46+
47+
| Feature | Description | Self-serve |
48+
|---------|-------------|------------|
49+
| **Popup Announcements** | Popup or list-style announcements, targeted delivery, impression and click tracking | ✅ ⚡ |
50+
| **Carousel Banners** | Groups, image carousels, CTA routing, time-window scheduling | ✅ ⚡ |
51+
52+
---
53+
54+
## Social
55+
56+
Modules that build player retention through community and competition.
57+
58+
| Feature | Description | Self-serve |
59+
|---------|-------------|------------|
60+
| **Friend System** | Friend requests, acceptance, blocking, and friend-gift delivery | ✅ |
61+
| **Guilds** | Guild creation, member management, permission tiers | ✅ |
62+
| **Teams** | Temporary squad formation, member caps, team state | ✅ ⚡ |
63+
| **Leaderboards** | Multi-dimensional rankings, periodic resets, historical archive | ✅ ⚡ |
64+
| **Rank / Division System** | Division definitions, promotion/demotion rules, season resets | ✅ ⚡ |
65+
| **Invite System** | Invite code generation, relationship tracking, reward triggers | ✅ |
66+
67+
---
68+
69+
## Content Management
70+
71+
Structured management of game narrative and level content, deployable alongside live ops.
72+
73+
| Feature | Description | Self-serve |
74+
|---------|-------------|------------|
75+
| **Dialogue Scripts** | Branching dialogue trees with conditions | ✅ |
76+
| **Level Configuration** | Server-side level parameters managed as config | ✅ |
77+
| **Entities** | Generic game-object definitions (NPCs, map points, etc.) | ✅ |
78+
| **Media Library** | Centralized management of image, video, and asset URLs | ✅ |
79+
| **Collections** | Content grouping and editorial collections | ✅ |
80+
| **Links** | CTA link and redirect target management | ✅ |
81+
82+
---
83+
84+
## Analytics
85+
86+
Understand player behavior; drive operational decisions with data.
87+
88+
| Feature | Description | Self-serve |
89+
|---------|-------------|------------|
90+
| **Player Behavior Events** | Every module action auto-generates events — no extra instrumentation needed | ✅ (automatic) |
91+
| **Analytics API** | Query aggregated data; integrate with your own data platform | Engineering |
92+
| **Webhook Event Stream** | Subscribe to business events; real-time push to external systems | ✅ |
93+
| **MCP Integration** | Expose dashboard capabilities as AI tools for external AI assistants | Engineering config |
94+
95+
---
96+
97+
<Callout type="info">
98+
Want to see how these features work in practice for an ops team? See [Operator Quick Start](./for-operators).
99+
Want to understand how AI agents accelerate configuration? See [AI-Powered Operations](./ai-features).
100+
</Callout>

0 commit comments

Comments
 (0)