gitlink-cli/docs/feishu-bitable-schema.md

1.2 KiB

Feishu Bitable Dry-Run Schema

gitlink-cli feishu currently generates Bitable schema and records locally.

It does not call Feishu Bitable OpenAPI.

Commands

gitlink-cli feishu +bitable-schema --format markdown
gitlink-cli feishu +bitable-records --from-workflow-json report.json --format json

Tables

Default tables:

issues
prs
contributors
reports

Record Semantics

Records are summary records derived from workflow +repo-report JSON.

They are not one row per GitLink issue or one row per GitLink pull request.

Current behavior:

reports: one summary row per repo report
issues: summary buckets by issue type and priority
prs: summary buckets by change type and risk
contributors: reserved schema; records are empty unless workflow JSON later includes contributor details

Real Write Boundary

Not implemented:

Bitable OpenAPI create
Bitable OpenAPI batch create
Bitable update
Bitable upsert
Base creation
table creation
view creation
field creation
person/open_id mapping

Real Bitable writes require a separate design for:

app authentication
table IDs
record unique keys
search-before-update
pagination
partial failure handling
rate limits
permission diagnostics