Work/Documentation/POSIX-Structure.md

POSIX Structure

Personal or Organization (server)/
├── settings.json
├── layout.json
├── catalog/
│   ├── packs/
│   │   └── pack-<slug>/
│   │       ├── manifest.json
│   │       └── entries/
│   │           └── app-<slug>/
│   │               └── manifest.json
│   └── standalone/
│       └── app-<slug>/
│           └── manifest.json
├── departments/
│   └── department-<slug>/
│       ├── settings.json
│       ├── users.json
│       └── teams/
│           └── team-<slug>/
│               ├── settings.json
│               └── users.json
├── projects/
│   └── project-<slug>/
│       ├── settings.json
│       ├── home.json
│       └── tree/
│           ├── item-<slug>/
│           │   ├── item.json
│           │   ├── schema.json
│           │   └── data.json
│           └── folder-<slug>/
│               ├── folder.json
│               └── item-<slug>/
│                   ├── item.json
│                   ├── schema.json
│                   └── data.json
└── users/
    ├── settings.json
    ├── data.json
    └── personals/
        └── personal-<slug>/
            ├── layout.json
            ├── settings.json
            ├── home.json
            └── tree/

File Responsibilities

• settings.json — Metadata and presentation config for the thing, such as display name, icon, description, and simple settings.
• layout.json — Layout configuration for the current server or personal space.
• home.json — Home surface configuration, such as widgets, sections, and how they are arranged.
• folder.json — Metadata for a folder node in a tree.
• item.json — Instance metadata for a created item, including what it is and how it should behave.
• schema.json — The structure expected by that item's data.
• data.json — The actual content or state data for that item.
• manifest.json — Catalog definition metadata, including versioning, description, and capabilities for reusable apps or entries.
• users.json — User membership or assignment data for departments and teams.