Skip to content

Import Corporate Action, Reports, Broker Management APIs (new domains) - #48

Open
hogan-yuan wants to merge 8 commits into
mainfrom
feat/import-corp-action-report-broker-crs
Open

Import Corporate Action, Reports, Broker Management APIs (new domains)#48
hogan-yuan wants to merge 8 commits into
mainfrom
feat/import-corp-action-report-broker-crs

Conversation

@hogan-yuan

Copy link
Copy Markdown
Member

Summary

Adds three new Broker API domains, imported from whale-openapi-docs via the whale-api-import workflow. Operation sets were determined by tracing the actual frontend feature pages in fe-wealth-admin (not the raw gateway route list), and each operation/template was verified to be really invoked.

Domain Base ops Notes
corporate-action 78 + 23 paired /download; announcement lifecycle, register/detail, execution, refund-by-sub-position-view, shareholder voting, post-event adjustment, fee management, US option corp action, notify, CCASS
reports 34 report list/bookmark, batch printing, export-task, export log, CRS file generation, commission reports
broker-management 18 broker relationship import, team & broker, commission-sharing (DCP) setups, user create/lock

Details

  • Internal-only excluded (x-lbonly: true): in-transit-funds datasets + retry, WTT client-detail dataset, CRS declaration-file generation, SFTP/export retry.
  • Datasets keep POST as the documented primary with x-post-fallback: true; each /download is folded under its base op (x-dataset-download / x-dataset-parent) and kept out of navigation.
  • Localized into three bundles per domain (broker-api/<domain>.{en,zh-CN,zh-HK}.yml), wired into src/nimbus/lib/openapi.ts, and nested into docs.json navigation for all three locales per each op's source menu path.
  • bun run check passes: 0 errors, heading anchors aligned.

Add three new Broker API domains, imported from whale-openapi-docs via the
whale-api-import workflow (frontend-verified operation sets):

- corporate-action (78 base ops + 23 paired downloads): announcement lifecycle,
  register/detail, execution, refund by sub-position view, shareholder voting,
  post-event adjustment, fee management, US option corp action, notify, CCASS,
  and their datasets.
- reports (34 base ops): report list/bookmark, batch printing, export-task,
  export log, CRS file generation, commission reports, and their datasets.
- broker-management (18 base ops): broker relationship import, team & broker,
  commission-sharing (DCP) setups, user create/lock, and their datasets.

Internal-only (x-lbonly: true) operations are excluded: in-transit-funds
datasets/retry, WTT client-detail dataset, CRS declaration file, SFTP/export
retry. Datasets keep POST as the documented primary with x-post-fallback and
folded /download pairing. Wired into src/nimbus/lib/openapi.ts and nested in
docs.json navigation for all three locales. `bun run check` passes (0 errors).
…n + 4 datasets

Sync the domain with the refined source scope:
- Exclude POST /v1/client_fee/import (now x-lbonly: true).
- Add POST /v1/option/reconciliation/list and datasets instrument_option_change_details,
  corp_action_scrip_fee, corp_action_gst_fee, corp_action_post_adjust_detail_announcements
  (each with paired /download).
- post_adjust confirm/delete/revoke/update remain public (kept).
Now 109 operations per locale; docs.json nav updated for all three locales.
bun run check passes (0 errors).
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 4, 2026

Copy link
Copy Markdown

Deploying whale-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 939cb95
Status: ✅  Deploy successful!
Preview URL: https://a87c2559.whale-docs.pages.dev
Branch Preview URL: https://feat-import-corp-action-repo.whale-docs.pages.dev

View logs

Import 10 shared-components operations into the Misc domain (all locales):
- Flow Tickets (9): approve step, create/delete comment, export tickets, get step
  comments, ticket list v2, handle ticket, update payload, update policies.
- Dataset Download (1): DELETE /v1/datasets/download/{id} (added as delete: on the
  existing GET path).
Match the existing get_flow_tickets_with_biz style (tags [Misc], x-verified: verified,
x-mint, standard envelope). Also mark the pre-existing download_records and
get_dataset_download x-verified: verified. docs.json: new Flow Tickets subgroup +
DELETE added to Dataset Export, under Misc, all three locales. bun run check passes.
…u.json

Reorder the three new-domain nav groups (and their nested subgroups) to follow
menu.json. Sorting is anchored on each entry's operation path (locale-independent)
rather than the display label, so zh-HK subgroups sort correctly despite
menu.json's zh-HK labels differing in wording from the bundle's Traditional
labels (e.g. 匯出日誌 vs 導出日誌).
Every operation under Broker Management is non-WhaleAPI and has been marked
x-lbonly: true in the source, so it is not for public docs. Remove the domain:
delete broker-management.{en,zh-CN,zh-HK}.yml, unregister it in openapi.ts
(imports, parse consts, mergeDocuments args, domainDocuments), and drop the
Broker Management nav group from docs.json for all three locales.
bun run check passes.
Sync the source change: 查询该租户企业行动是否需要工单审批 -> 查询该企业行动是否需要工单审批.
…on-report-broker-crs

# Conflicts:
#	src/nimbus/lib/openapi.ts
Remove the Reports domain from this PR so it can land through the Day-End Mgr PR
instead: delete reports.{en,zh-CN,zh-HK}.yml, unregister in openapi.ts, and drop
the Reports nav group from docs.json (all locales). This PR now covers
Corporate Action only.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant