The repo had no agent-facing project guidance: AGENTS.md contained only the
generated TanStack Intent skill pointers, and README.md described a stack
this app does not use.
- CLAUDE.md (new): API client contract (envelope, ApiError, single-flight
401 refresh, the FormData Content-Type trap), the PERM catalog mirroring
the backend permission classes, the route + NAV_GROUPS + PERM triad that
must be edited together to add a page, and the useListPage/DataTable
pattern.
- AGENTS.md: gotchas above the generated block, which is left untouched —
global query retry policy, can() vs useCan() reactivity, the gig-admin-auth
persist key, and that jsdom is opted into per file via a
`// @vitest-environment jsdom` pragma since there is no vitest config.
- README.md: @tanstack/react-start is not a dependency (this is a plain Vite
SPA, no SSR); cf:deploy no longer copies a shell to index.html; the feature
list was a milestone-1 snapshot that omitted five shipped nav groups and
still called moderation reports a future milestone.
Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_013MADG54Y51wZkU3ViRjeSi
When VITE_API_BASE_URL is unset, BASE_URL defaults to '', which causes
new URL(path, '') to throw TypeError: Invalid URL. Fall back to
location.origin (browser/jsdom) or 'http://localhost' (SSR).
Adds the dashboard surface for the backend's /api/admin/v1/resume/import-batches
endpoints, and the multipart support it needed.
Client:
- rawRequest passes a FormData body through untouched and skips Content-Type,
so the browser sets multipart/form-data *with the boundary*. Setting it by
hand stripped the boundary and the server saw an empty upload — verified
against the backend: 202 with the fix, 422 VALIDATION_ERROR without it.
This was the first admin endpoint in the codebase to accept a file.
- New api.upload(). fetch reports no upload progress, so upload UI stays
indeterminate rather than faking a percentage.
UI (/resume/import-batches, gated on admin:resume:read; writes on :manage):
- Upload dialog with countryCode and dry-run checked by default — seeing the
collision report before creating accounts is almost always what you want.
- Detail sheet polls every 2s and stops once the batch is terminal. Clickable
count tiles filter the per-resume report; step statuses surface `命中缓存` /
`复用结果` so the dedup is visible.
- Confirm a dry run, retry failed rows, and resolve a missing contact.
IMPORT_IDENTITY_TAKEN is shown inline — a collision is expected input, not
an error toast.
- progress.total is 0 until unpacking finishes, so both views render 准备中…
rather than "0 / 0", which would read as an empty batch.
types.gen.ts regenerated from the backend's admin spec.
Co-Authored-By: Claude Opus 5 <[email protected]>
Adds 开发工具 → 数据库管理台, which exchanges the admin bearer token for a
single-use entry link (POST /api/admin/v1/internal-surfaces/db-studio/session)
and opens it in a new tab. The link sets an HttpOnly session cookie on the
console's own hostname, so it has to be opened by the browser rather than
fetched — the nginx gate in front of the console then re-checks the permission
on every request.
The tab is opened synchronously inside the click handler, before the request
resolves, or the popup blocker kills it; `noopener` is unusable there since it
makes window.open return null, so the opener is detached manually.
Gated on auth:db-studio:access. That key is `auth:`-prefixed rather than
`admin:` on purpose — PermissionSeeder syncs the admin role to every `admin:%`
key, which would grant database-owner SQL access to every admin account.
Co-Authored-By: Claude Opus 5 <[email protected]>
- /roles — role table with create dialog and a permission-matrix sheet:
collapsible per-module sections (selected/total counts, role's own
modules start expanded) and a key/description filter that force-
expands matches; super-admin role is read-only
- /admin-users — user search (Enter to run) with role assignment
dialog; editing your own roles is blocked
Both nav items gate on auth:role:* keys, which only super-admin holds.
Co-Authored-By: Claude Fable 5 <[email protected]>
New Dimzou 内容 pages against the Dimzou admin API:
- /dimzou/documents — state filter (活跃/已归档/回收站), detail sheet
with versions, translations and pending review counts
- /dimzou/publications — visibility filter, detail from row data
Co-Authored-By: Claude Fable 5 <[email protected]>
New nav group with four pages against the Exc admin API:
- /exc/demands — status/mode filters, detail sheet with related
services, quotes and dispatch rounds
- /exc/dispatches — status/round filters
- /exc/orders — status/payment filters, detail sheet with items and
状态流转 audit trail
- /exc/providers — status/verified filters, detail sheet with dispatch
settings and status logs
Co-Authored-By: Claude Fable 5 <[email protected]>
Rework 内容审核 pages around reported resources instead of individual
reports, matching the new backend endpoints: rows group all reports on
one comment/event, with a slide-over listing report details and
per-row actions 通过并屏蔽 (approve) / 驳回举报 (reject) / 撤销屏蔽
(revert). Filters: 待处理 / 已屏蔽 / 全部.
Co-Authored-By: Claude Fable 5 <[email protected]>
New 内容审核 nav group covering the remaining admin API groups:
- /comment-reports — status filter; hide/delete comment or dismiss
- /event-reports — status filter; hide/delete/resolve/dismiss
- /dimzou-translations — language/status filters, draft block progress,
requeue machine translation
Co-Authored-By: Claude Fable 5 <[email protected]>
Robot-author edit form and detail drop positioning/target_readers (now
series-level); persona + styles stay (routed to the account profile via the
admin API). Series detail shows positioning/target_readers. Types updated;
admin API types regenerated.
Adds a 预览 action (enabled once an article has a Dimzou document) opening a
sheet that fetches and renders the draft — cover, title, summary, and body HTML
(typography/prose). Re-enables the @tailwindcss/typography plugin for prose.
Adds an "编辑" action opening a sheet form to edit a robot author's status,
persona, positioning, target readers, and the article/image/publishing style
objects (JSON-validated as objects). Saves via the existing admin PUT endpoint,
then refetches the enriched list.
- searchable CategoryPicker (Popover+Command) reusable across studio pages,
plus useCategoryOptions hook (shared tree query + id→name resolver)
- filter bar with category + status filters and a reset action
- new columns: account (avatar + display_name + uid), category name; persona
demoted to a secondary column; display_name/category surfaced in detail sheet
kongkx
