mirror of
https://github.com/harivansh-afk/betterNAS.git
synced 2026-04-15 20:03:08 +00:00
58 lines
1.1 KiB
Markdown
58 lines
1.1 KiB
Markdown
# betterNAS
|
|
|
|
- control-plane owns policy and identity (decides)
|
|
- node-agent owns file serving (serves)
|
|
- web owns UX (consumer facing)
|
|
- nextcloud-app is optional adapter only for cloud storage in s3 n shit
|
|
|
|
## Monorepo
|
|
|
|
- `apps/web`: Next.js control-plane UI
|
|
- `apps/control-plane`: Go control-plane service
|
|
- `apps/node-agent`: Go NAS runtime / WebDAV node
|
|
- `apps/nextcloud-app`: optional Nextcloud adapter
|
|
- `packages/contracts`: canonical shared contracts
|
|
- `packages/ui`: shared React UI
|
|
- `infra/docker`: local Docker runtime
|
|
|
|
The root planning and delegation guide lives in [skeleton.md](./skeleton.md).
|
|
|
|
## Verify
|
|
|
|
Run the repo acceptance loop with:
|
|
|
|
```bash
|
|
pnpm verify
|
|
```
|
|
|
|
## Runtime loop
|
|
|
|
Bootstrap clone-local runtime settings with:
|
|
|
|
```bash
|
|
pnpm agent:bootstrap
|
|
```
|
|
|
|
If `.env.agent` is missing, bootstrap writes clone-local defaults for this checkout.
|
|
|
|
Bring the stack up, verify it, and tear it down with:
|
|
|
|
```bash
|
|
pnpm stack:up
|
|
pnpm stack:verify
|
|
pnpm stack:down --volumes
|
|
```
|
|
|
|
## Agent loop
|
|
|
|
Run the full static and integration loop with:
|
|
|
|
```bash
|
|
pnpm agent:verify
|
|
```
|
|
|
|
Create or refresh the sibling agent clones with:
|
|
|
|
```bash
|
|
pnpm clones:setup
|
|
```
|