UI②:数据对象全用中文名 —— label 随物化落 PG 注释,全链读回

此前 label 在建表那一步就丢了,治理台只剩 project__intake_record 这种键给人看。
用表/列注释而非另建元数据表:名字与表同生共死,不会对不上。
设计台/运营台/对象详情/触发器下拉一律中文名在前、键在后。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

api-report/apps/api/src/modules/ledger/contract.d.ts

@@ -72,7 +72,10 @@ export type ReleaseWriteResult = {
 export type LedgerService = {
     applyDeclarations(declarations: readonly ObjectDeclaration[]): Promise<SchemaApplyResult[]>;
     describe(address: ObjectAddress): Promise<MaterializedObject | undefined>;
-    listObjects(): Promise<ObjectAddress[]>;
+    /** 出参带人读名(表注释);没登记就没有 label,呈现退回对象键 */
+    listObjects(): Promise<Array<ObjectAddress & {
+        label?: string | undefined;
+    }>>;
     systemWrite(write: SystemWrite): Promise<void>;
     draftWrite(write: DraftWrite): Promise<void>;
     releaseWrite(taskId: TaskId): Promise<ReleaseWriteResult>;

api-report/apps/api/src/modules/ledger/port.d.ts

@@ -25,7 +25,10 @@ export type ObjectRef = {
 export type LedgerStore = {
     /** 已物化对象的列与主键;未物化返回 undefined */
     describe(ref: ObjectRef): Promise<MaterializedObject | undefined>;
-    listObjects(): Promise<ObjectRef[]>;
+    /** 出参带人读名(表注释);没登记就没有 label,呈现退回对象键 */
+    listObjects(): Promise<Array<ObjectRef & {
+        label?: string | undefined;
+    }>>;
     /** 执行「只增不破坏」的变更计划 */
     applyChanges(ref: ObjectRef, changes: readonly SchemaChange[]): Promise<void>;
     select(query: LedgerQuery): Promise<{

api-report/packages/contracts/src/api/governance.d.ts

@@ -1626,10 +1626,12 @@ export declare const listToolsRoute: {
 export declare const listLedgerObjectsRoute: {
     readonly method: "GET";
     readonly path: "/api/gov/data/objects";
+    /** `label` 是人读名(落在表注释上);缺省即没登记,呈现退回对象键 */
     readonly output: z.ZodObject<{
         objects: z.ZodArray<z.ZodObject<{
             domain: z.ZodString;
             object: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 };
@@ -1641,9 +1643,11 @@ export declare const browseLedgerRoute: {
         object: z.ZodString;
     }, z.core.$strip>;
     readonly output: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
         columns: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         primaryKey: z.ZodArray<z.ZodString>;
         rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;