appstruct-cli 0.2.0

Command-line compiler and development workflow for AppStruct applications
# __APPSTRUCT_PROJECT_NAME__

This project was created from the AppStruct `saas` template and locks `appstruct/saas@1`.

For `database.dev.mode: managed`, ensure Docker with Compose is running. For `external`, set
`DATABASE_URL` in `.env` (see `.env.example`) and run `appstruct migrate dev --accept`.
Run `appstruct preset show` to inspect the locked modules, then `appstruct doctor` and
`appstruct dev`.

The API listens on `http://127.0.0.1:3000` and the Web application on
`http://127.0.0.1:5173` by default. Create an account, create an organization, and then manage
tenant-isolated projects and tasks. Entity changes are recorded by Audit; the default Audit reader
role is `admin`.

New accounts receive the `member` role. After the first operator registers, run
`appstruct auth bootstrap-admin --email admin@example.com` from a trusted host.

Development uses capture mail, PostgreSQL Jobs/Outbox, and local file storage under
`.appstruct/files`. Set production Mail/File provider credentials through environment variables;
never put secrets in `appstruct.yaml`. The preset includes an Admin operations overview; Billing
is not part of preset version 1.

For a production image, create `.env.production`, run `appstruct build`, and use
`docker compose -f compose.production.yaml up --build -d --wait`. Apply reviewed migrations separately before
starting the API image.

Production Web uses a same-origin API proxy on port 8080. Set `APPSTRUCT_FRONTEND_URL` and
`APPSTRUCT_ALLOWED_ORIGIN` to the public HTTPS origin. Compose persists local files in a named
volume. Run `node deploy/smoke.mjs <web-origin>`, then verify login and tenant-scoped CRUD over HTTPS.