meta-lc-runtime-angular

English | 中文

Positioning

Angular runtime integration layer for schema rendering/data binding through BFF-only data paths.

Milestone Mapping

• Primary milestone: Phase 4
• Program board: GitHub Project #5

Scope & Boundaries

• In-scope: module responsibilities mapped to the Meta-Driven SaaS OS mainline.
• Dependency relation: Consumes core contracts and bff data contracts.
• Non-goal: No direct backend/database calls.

MUST Constraints

• DSL is the single source of truth.
• All data/realtime flows must pass through BFF.
• Runtime must not embed business-rule implementation.
• Meta Kernel is the only structural source.

Collaboration Notes

• Phase 5 (Designer) and materials stay in ngx-lowcode.
• ngx-puzzle remains an independent base library.

Quick Start

after cloning this repo:

npm ci
npm run build
npm run test -- --watch=false

after adding implementation packages:

import { provideHttpClient } from '@angular/common/http';
import {
  NGX_LOWCODE_DATASOURCE_MANAGER,
  NGX_LOWCODE_WEBSOCKET_MANAGER,
} from '@zhongmiao/ngx-lowcode-core-types';
import {
  createBffDataSourceManager,
  createSocketIoWebSocketManager,
} from '@zhongmiao/meta-lc-runtime-angular';

export const appConfig = {
  providers: [
    provideHttpClient(),
    {
      provide: NGX_LOWCODE_DATASOURCE_MANAGER,
      useValue: createBffDataSourceManager({
        baseUrl: 'http://localhost:6000',
      }),
    },
    {
      provide: NGX_LOWCODE_WEBSOCKET_MANAGER,
      useValue: createSocketIoWebSocketManager({
        baseUrl: 'http://localhost:6000',
      }),
    },
  ],
};

createSocketIoWebSocketManager connects to the BFF /runtime namespace and maps runtime page topic channels such as tenant.tenant-a.page.orders.instance.instance-1 to subscribePage messages. Use createDefaultWebSocketManager() for tests or hosts that do not enable realtime transport yet.

References

• Unified docs: lowcode-docs
• Architecture baseline: Meta-Driven Standard