a5bd51de33
Some checks failed
Security / Security check (push) Failing after 1s
The Dart SDK package was renamed package: fai_dart_sdk → fai_client_sdk and the dir + Forgejo repo got a -dart language suffix per the three SDK families convention in fai/platform/docs/architecture/sdks.md. Updates the path dep, dep name, every `package:fai_dart_sdk/...` import, and the one comment that named the SDK. Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
# F∆I Studio
|
|
|
|
Desktop GUI client for the F∆I Platform hub. Tier-2 generic
|
|
platform client per `docs/architecture/client.md`. Connects to a
|
|
local or remote `fai serve` over gRPC.
|
|
|
|
> **Status (2026-05-05):** MVP scaffold. Three pages with mock
|
|
> data, no live gRPC connection yet. Validates the visual
|
|
> direction before the Dart SDK is wired in.
|
|
|
|
## Pages (MVP scope)
|
|
|
|
1. **Modules** — installed modules, capabilities, declared
|
|
permissions. Click → manifest detail.
|
|
2. **Audit** — live stream of hub events (when wired). Filter
|
|
by event type and flow.
|
|
3. **Approvals** — pending `system.approval@^0` reviews with
|
|
approve / reject buttons.
|
|
|
|
These three cover the platform's central properties:
|
|
**composition** (modules), **audit** (events),
|
|
**human-in-the-loop** (approvals).
|
|
|
|
## Stack
|
|
|
|
- Flutter 3.40+ (Desktop: macOS, Linux, Windows)
|
|
- gRPC client via [`fai_client_sdk`](../fai_client_sdk_dart) (sibling
|
|
repo; pinned by relative path during development)
|
|
- No external runtime dependencies; bundles its own Dart VM
|
|
|
|
## Run locally
|
|
|
|
```bash
|
|
flutter run -d macos
|
|
```
|
|
|
|
## Repo placement
|
|
|
|
Will be published as `fai/studio` on Forgejo (`git.flemming.ws`).
|
|
The local directory `fai_studio/` follows the established
|
|
`fai_platform/` layout convention.
|
|
|
|
## Why "Studio" and not "Stage"
|
|
|
|
"Stage" collided too easily with "staging environment" in
|
|
developer English. "Studio" is the established industry pattern
|
|
for creator-tools (Visual Studio, Android Studio, RStudio) and
|
|
matches the GUI's audience of module developers, operators, and
|
|
power users. The rename was applied across all `docs/` in the
|
|
platform repo on 2026-05-05.
|