An open API service indexing awesome lists of open source software.

https://github.com/zhongmiao-org/meta-lc-cli

Meta-Driven SaaS OS CLI for App DSL validation and SaaS scaffold generation pipelines.
https://github.com/zhongmiao-org/meta-lc-cli

bff cli code-generator dsl low-code meta-driven multi-tenant saas scaffolding

Last synced: about 1 month ago
JSON representation

Meta-Driven SaaS OS CLI for App DSL validation and SaaS scaffold generation pipelines.

Awesome Lists containing this project

README

          

# meta-lc-cli

English | [中文](./README_zh.md)

## Positioning
App generator and tooling CLI for App DSL validation and scaffold pipeline outputs.

## Milestone Mapping
- Primary milestone: Phase 6 (+ API Generator task in Phase 2)
- Program board: [GitHub Project #5](https://github.com/orgs/zhongmiao-org/projects/5)

## Scope & Boundaries
- In-scope: module responsibilities mapped to the Meta-Driven SaaS OS mainline.
- Dependency relation: Coordinates generated outputs consumed by kernel, bff, and runtime layers.
- Non-goal: No long-running runtime engine responsibilities.

## 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](https://github.com/zhongmiao-org/ngx-lowcode).
- [ngx-puzzle](https://github.com/zhongmiao-org/ngx-puzzle) remains an independent base library.

## Quick Start

after cloning this repo:

```bash
npm install
npm run build
```

after adding implementation packages:

```bash
# generate a minimal valid DSL template
npx meta-lc init --out ./app.dsl.json

# validate DSL (returns exit code 1 on failure)
npx meta-lc validate --file ./app.dsl.json

# machine-readable output
npx meta-lc validate --file ./app.dsl.json --json

# human-readable summary + validation result
npx meta-lc explain --file ./app.dsl.json

# generate pipeline plan (writes plan.json by default)
npx meta-lc generate --file ./app.dsl.json --out demo

# generate and write DB/API/Perm/Page artifacts
npx meta-lc generate --file ./app.dsl.json --out demo --write

# generate tenant/role template (preview by default)
npx meta-lc template --file ./app.dsl.json --out demo

# generate and write tenant/role template file
npx meta-lc template --file ./app.dsl.json --out demo --write

# run strict E2E gate (validate + generate + template + BFF checks)
npx meta-lc e2e --file ./app.dsl.json --out demo --bff-url http://localhost:6000

# machine-readable E2E report output
npx meta-lc e2e --file ./app.dsl.json --out demo --json
```

## References
- Unified docs: [lowcode-docs](https://github.com/zhongmiao-org/lowcode-docs)
- Architecture baseline: [Meta-Driven Standard](https://github.com/zhongmiao-org/lowcode-docs/blob/main/meta-driven-standard.md)