desktop: Prices, Store art, Growth and App info tabs, exports at the top right and in the command palette, studio and fastlane steps in the first-run guide, fix hints on errors; fixtures, screenshots, tests, UX audit in docs/desktop.md

This commit is contained in:
CRTkafa 2026-10-11 07:40:59 +08:00
parent 029ef2e2d3
commit 5d09111528
34 changed files with 2572 additions and 67 deletions

View file

@ -0,0 +1,189 @@
// Growth: store analytics snapshots against the listing changes from git (`analytics compare --json`, offline; a new
// snapshot and the App Store report request are confirm-gated writes), App Store Product Page Optimization tests
// (status read; create and upload treatments: dry run, dialog, real run; start / stop are owner actions with their
// own dialog, never MCP tools), and Google Play store listing experiments (no API: Play Console).
import { useMemo, useState } from 'react';
import { type AnalyticsCompare, api, type PpoStatus, type PpoTest } from '../../api';
import { t } from '../../i18n';
import type { UnifiedApp } from '../../lib/identity';
import { analyticsCsv, exportName } from '../../lib/exports';
import { ago, date, num, pct } from '../../lib/format';
import { chartSeries, effectDelta } from '../../lib/views';
import { useNav } from '../../nav';
import { useData, useRead, useWrite } from '../../store';
import { useExports } from '../../ui/Exports';
import { Icon, StoreGlyph } from '../../ui/icons';
import { Card, Chip, Empty, ErrorNotice, Kpi, Notice, Seg, Skeleton } from '../../ui/kit';
import { LineChart } from '../../ui/LineChart';
import { WriteButton } from '../../ui/WriteButton';
import { ascUrl, PLAY_CONSOLE } from '../AppView';
const DONE = ['COMPLETED', 'STOPPED'];
const started = (x: PpoTest) => !!x.startDate && !x.endDate && !DONE.includes(x.state);
const stateTone = (s: string): 'ok' | 'warn' | 'bad' | 'info' | 'neutral' | 'accent' =>
s === 'REJECTED' ? 'bad' : DONE.includes(s) ? 'neutral' : ['WAITING_FOR_REVIEW', 'IN_REVIEW'].includes(s) ? 'warn' : ['ACCEPTED', 'APPROVED'].includes(s) ? 'ok' : 'info';
function Analytics({ projectId, hasApple, hasPlay, name, playReports }: { projectId: string; hasApple: boolean; hasPlay: boolean; name: string; playReports: boolean }) {
const r = useRead<AnalyticsCompare>(projectId, 'analytics.compare', { network: false });
const w = useWrite(projectId);
const a = r.data;
const stores = ([hasApple && 'apple', hasPlay && 'play'].filter(Boolean) as ('apple' | 'play')[]).filter(s => !a || (s === 'apple' ? a.series.apple.length : a.series.play.length));
const [store, setStore] = useState<'apple' | 'play'>(hasApple ? 'apple' : 'play');
const st = stores.includes(store) ? store : stores[0] ?? store;
const s = useMemo(() => (a ? chartSeries(a, st) : null), [a, st]);
useExports('growth', [{ id: 'analytics-csv', label: t('export.analytics'), icon: 'chart', kind: 'csv', file: exportName(name, 'analytics'), disabled: a ? false : t('export.readFirst'), build: () => analyticsCsv(a!) }]);
const none = !!r.error && /no snapshots/i.test(r.error);
const actions = (
<>
{hasApple && <WriteButton run={w} icon="sliders" w={{ method: 'analytics.setup', args: {}, title: t('gr.setup'), done: t('gr.setupDone') }} hint={t('gr.setupHint')}>{t('gr.setup')}</WriteButton>}
<WriteButton run={w} primary icon="download" w={{ method: 'analytics.snapshot', args: {}, title: t('gr.snapshot'), done: t('gr.snapshotDone'), after: r.refresh }} hint={t('gr.snapshotHint')}>{t('gr.snapshot')}</WriteButton>
</>
);
const sum = (xs: number[]) => xs.reduce((n, v) => n + v, 0);
const reach = s ? sum(s.reach) : 0, inst = s ? sum(s.installs) : 0;
const effects = (a?.effects ?? []).filter(e => e.store === st).slice(-8).reverse();
return (
<Card title={t('gr.analytics')} icon="chart" sub={a ? t('gr.analyticsSub', { count: a.snapshots, since: date(a.since) }) : t('gr.analyticsSubNone')} pad={false}
actions={<>{stores.length > 1 && <Seg value={st} onChange={setStore} label={t('col.store')} options={[['apple', 'App Store'], ['play', 'Google Play']]} />}{actions}</>}>
{none ? (
<Empty illo="pulse" title={t('gr.noneTitle')}>{t('gr.noneText')}{hasPlay && !playReports ? ` ${t('gr.noBucket')}` : ''}</Empty>
) : r.error ? <div className="card-body"><ErrorNotice error={r.error} /></div> : !a || !s ? <div className="card-body"><Skeleton lines={5} block /></div> : (
<div className="card-body stack" style={{ gap: 16 }}>
<div className="kpis" style={{ gridTemplateColumns: 'repeat(3, minmax(0, 1fr))' }}>
<Kpi icon="eye" label={st === 'apple' ? t('gr.impressions') : t('gr.visitors')} value={num(reach)} sub={t('gr.days', { count: s.dates.length })} />
<Kpi icon="download" label={st === 'apple' ? t('gr.downloads') : t('gr.acquisitions')} value={num(inst)} sub={t('gr.days', { count: s.dates.length })} />
<Kpi icon="activity" label={t('gr.conversion')} value={reach ? pct(inst / reach, 1) : '–'} sub={t('gr.conversionSub')} />
</div>
{s.dates.length > 1 ? (
<LineChart dates={s.dates} label={t('gr.chartAria', { store: st === 'apple' ? 'App Store' : 'Google Play' })} eventsLabel={t('gr.changes', { count: s.events.length })} events={s.events}
lines={[
{ label: st === 'apple' ? t('gr.impressions') : t('gr.visitors'), values: s.reach, cls: 'l1', axis: 'left' },
{ label: st === 'apple' ? t('gr.downloads') : t('gr.acquisitions'), values: s.installs, cls: 'l2', axis: 'left' },
{ label: t('gr.conversion'), values: s.conversion, cls: 'l3', axis: 'right' },
]} />
) : <Notice tone="info">{t('gr.oneDay')}</Notice>}
{effects.length > 0 && (
<table className="table">
<thead><tr><th>{t('gr.change')}</th><th>{t('col.date')}</th><th className="right">{t('gr.before')}</th><th className="right">{t('gr.after')}</th><th className="right">{t('col.diff')}</th></tr></thead>
<tbody>
{effects.map((e, i) => {
const dlt = effectDelta(e.before.conversion, e.after.conversion);
return (
<tr key={i}>
<td><div className="strong">{e.event.subject}</div><div className="small muted mono-id">{e.event.commit} · {e.event.files.slice(0, 3).join(', ')}</div></td>
<td className="nowrap">{date(e.event.date)}</td>
<td className="right num">{pct(e.before.conversion ?? null, 1)}<div className="small muted">{t('gr.daysN', { count: e.daysBefore })}</div></td>
<td className="right num">{pct(e.after.conversion ?? null, 1)}<div className="small muted">{t('gr.daysN', { count: e.daysAfter })}</div></td>
<td className="right">{dlt === null ? '–' : <Chip tone={dlt >= 0 ? 'ok' : 'warn'} dot={false}>{`${dlt >= 0 ? '+' : ''}${num(dlt, 1)} %`}</Chip>}</td>
</tr>
);
})}
</tbody>
</table>
)}
<p className="small muted">{t('gr.reading')}</p>
</div>
)}
</Card>
);
}
function Experiments({ app }: { app: UnifiedApp }) {
const d = useData();
const target = app.project?.id ?? app.target;
const r = useRead<PpoStatus>(target, 'apple.ppo_status', { network: true, title: t('gr.ppo') });
const w = useWrite(app.project?.id ?? null);
const variants = d.statusFor(app)?.summary?.variants ?? [];
const [pickV, setPickV] = useState<string[]>([]);
const [traffic, setTraffic] = useState(30);
const [up, setUp] = useState('');
const chosen = pickV.length ? pickV : variants.slice(0, 1);
const upV = up || variants[0] || '';
const tests = r.data?.tests ?? [];
const editable = tests.find(x => !started(x) && !DONE.includes(x.state));
const asc = app.ios ? ascUrl(app.ios.app.id) : ascUrl(d.statusFor(app)?.app?.platforms.ios?.ascAppId);
return (
<Card title={t('gr.ppo')} icon="flask" sub={<span className="row" style={{ gap: 6 }}><StoreGlyph store="ios" className="ic13" />{r.data ? (r.fromCache ? t('common.cachedFrom', { when: ago(r.at) }) : t('common.readWhen', { when: ago(r.at) })) : t('gr.ppoSub')}</span>} pad={false}
actions={<>
<button className="btn btn-sm btn-ghost" onClick={() => api.openExternal(asc).catch(() => {})}><Icon name="external" />{t('gr.results')}</button>
<button className="btn btn-sm" onClick={r.refresh} disabled={r.loading}><Icon name="refresh" className={r.loading ? 'spin' : undefined} />{r.data ? t('action.refresh') : t('gr.ppoRead')}</button>
</>}>
{r.error && <div className="card-body"><ErrorNotice error={r.error} keep={!!r.data} /></div>}
{!r.data ? (r.loading && !r.error ? <div className="card-body"><Skeleton lines={4} /></div> : <Empty compact illo="cloud" title={t('gr.ppoNotRead')}>{t('gr.ppoNotReadText')}</Empty>)
: !tests.length ? <Empty compact illo="text" title={t('gr.ppoNone')}>{variants.length ? t('gr.ppoNoneText') : t('gr.ppoNoVariants')}</Empty> : (
<table className="table">
<thead><tr><th>{t('gr.test')}</th><th>{t('gr.state')}</th><th className="right">{t('gr.traffic')}</th><th>{t('gr.dates')}</th><th>{t('gr.treatments')}</th><th className="right">{t('gr.owner')}</th></tr></thead>
<tbody>
{tests.map(x => (
<tr key={x.id}>
<td className="strong">{x.name}</td>
<td><Chip tone={stateTone(x.state)}>{x.state.replace(/_/g, ' ').toLowerCase()}</Chip></td>
<td className="right num">{x.trafficProportion !== undefined ? `${x.trafficProportion} %` : '–'}</td>
<td className="small nowrap">{x.startDate ? `${date(x.startDate)} → ${x.endDate ? date(x.endDate) : t('gr.running')}` : t('gr.notStarted')}</td>
<td className="small">{x.treatments.length ? x.treatments.map(tr => t('gr.treatment', { name: tr.name, count: tr.locales })).join(' · ') : '–'}</td>
<td className="right">
{app.project && !DONE.includes(x.state) && (started(x)
? <WriteButton run={w} danger icon="pause" w={{ method: 'owner.ppo_stop', args: { experiment: x.name }, title: t('gr.stop', { name: x.name }), done: t('gr.stopped'), after: r.refresh }}>{t('gr.stopBtn')}</WriteButton>
: <WriteButton run={w} icon="play" w={{ method: 'owner.ppo_start', args: { experiment: x.name }, title: t('gr.start', { name: x.name }), done: t('gr.started'), after: r.refresh }}>{t('gr.startBtn')}</WriteButton>)}
</td>
</tr>
))}
</tbody>
</table>
)}
{app.project ? (
<div className="card-body" style={{ borderTop: '1px solid var(--line)' }}>
{!variants.length ? <Notice tone="info" icon="info">{t('gr.ppoNoVariants')}</Notice> : (
<div className="act-grid">
<div className="act-col">
<div className="act-head"><Icon name="plus" />{t('gr.create')}</div>
<div className="chips">{variants.map(v => (
<label key={v} className="check"><input type="checkbox" checked={chosen.includes(v)} onChange={ev => setPickV(ev.target.checked ? [...new Set([...chosen, v])].slice(0, 3) : chosen.filter(x => x !== v))} />{t('gr.variant', { id: v })}</label>
))}</div>
<label className="row small" style={{ gap: 8 }}><span className="muted">{t('gr.traffic')}</span>
<input className="input input-sm mono" type="number" min={1} max={100} value={traffic} onChange={ev => setTraffic(Math.max(1, Math.min(100, Number(ev.target.value) || 30)))} style={{ width: 70 }} />%</label>
<WriteButton run={w} icon="flask" disabled={!chosen.length} w={{ method: 'apple.ppo_create', args: { variants: chosen.join(','), traffic }, title: t('gr.createTitle'), done: t('gr.created'), after: r.refresh }}>{t('gr.createBtn')}</WriteButton>
</div>
<div className="act-col">
<div className="act-head"><Icon name="image" />{t('gr.upload')}</div>
<select className="input input-sm" value={upV} onChange={ev => setUp(ev.target.value)} aria-label={t('gr.upload')}>{variants.map(v => <option key={v} value={v}>{t('gr.variant', { id: v })}</option>)}</select>
<WriteButton run={w} icon="upload" disabled={!editable} hint={editable ? t('act.slowHint') : t('gr.uploadNoTest')} w={{ method: 'apple.ppo_upload', args: { variant: upV, ...(editable ? { experiment: editable.name } : {}) }, title: t('gr.uploadTitle', { id: upV }), done: t('act.uploaded'), after: r.refresh }}>{t('gr.uploadBtn')}</WriteButton>
<span className="small muted">{editable ? t('gr.uploadInto', { name: editable.name }) : t('gr.uploadNoTest')}</span>
</div>
</div>
)}
<p className="small muted act-note"><Icon name="shield" />{t('gr.ppoNote')}</p>
</div>
) : <div className="card-foot"><Icon name="info" />{t('gr.ppoStoreOnly')}</div>}
</Card>
);
}
function PlayExperiments({ app }: { app: UnifiedApp }) {
const nav = useNav();
return (
<Card title={t('gr.playExp')} icon="flask" sub={<span className="row" style={{ gap: 6 }}><StoreGlyph store="android" className="ic13" />{t('gr.playExpSub')}</span>}
actions={<button className="btn btn-sm" onClick={() => api.openExternal(PLAY_CONSOLE).catch(() => {})}><Icon name="external" />Play Console</button>}>
<div className="stack" style={{ gap: 10 }}>
<p className="small">{t('gr.playExpText')}</p>
{app.project && <div><button className="btn btn-sm" onClick={() => nav.go({ screen: 'app', appId: app.key, tab: 'art' })}><Icon name="grid" />{t('gr.seeVariants')}</button></div>}
</div>
</Card>
);
}
export function GrowthTab({ app }: { app: UnifiedApp }) {
const d = useData();
const s = d.statusFor(app)?.summary;
const hasApple = !!(s?.apple ?? app.ios), hasPlay = !!(s?.play ?? app.android);
if (app.project && !s) return <Card><Skeleton lines={5} block /></Card>;
return (
<>
{app.project && <Analytics projectId={app.project.id} hasApple={hasApple} hasPlay={hasPlay} name={s?.name ?? app.name} playReports={!!s?.playReports} />}
<div className={`grid ${hasApple && hasPlay ? 'g-main-side' : ''}`} style={{ alignItems: 'start' }}>
{hasApple && <Experiments app={app} />}
{hasPlay && <PlayExperiments app={app} />}
</div>
</>
);
}