betterNAS/README.md

46 lines
937 B
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
```
## Agent loop
Bootstrap a clone-local environment with:
```bash
pnpm agent:bootstrap
```
Run the full static and integration loop with:
```bash
pnpm agent:verify
```
Create or refresh the sibling agent clones with:
```bash
pnpm clones:setup
```