Revise README for quick install and project generation flow

Author: c15k0

README.md

@@ -11,72 +11,74 @@
 
 PSFS is a lightweight PHP framework for MVC/API applications (Twig + Propel + Symfony components).
 
-## 5-minute setup
+## Quick Install (Copy/Paste)
 
-Prerequisites:
+Requirements:
+- `bash`
+- `docker compose` or `php + composer`
 
-- Docker + Docker Compose
-- Git
+Using `curl`:
 
-<!-- validated -->
 ```bash
-docker compose up -d
-docker compose ps
-docker exec core-php-1 php -v
-docker exec core-php-1 composer install --no-interaction --prefer-dist
+curl -fsSL https://raw.githubusercontent.com/psfs/core/master/install.sh | bash
 ```
 
-If your PHP container name is not `core-php-1`:
+Using `wget`:
 
-<!-- validated -->
 ```bash
-docker compose ps
-docker ps --format '{{.Names}}'
+wget -qO- https://raw.githubusercontent.com/psfs/core/master/install.sh | bash
 ```
 
-## Daily command map
+The installer downloads and runs the official PSFS project generator.
 
-<!-- example-only -->
-```bash
-# Run key tests
-docker exec core-php-1 php vendor/bin/phpunit --no-coverage --filter '/(AuthApiTest|RequestResponseSecurityContractTest)/'
+## Create a Project
 
-# List PSFS CLI commands
-docker exec core-php-1 php src/bin/psfs list
+Interactive:
 
-# Security local pre-check (act)
-act push --container-architecture linux/amd64
+```bash
+./scripts/create-psfs-project.sh
 ```
 
-## Choose your path
-
-### Onboarding path
+Non-interactive:
 
-1. Read [Operations Playbook](./doc/OPERATIONS.md)
-2. Read [DTO Validation Engine](./doc/DTO_VALIDATION.md)
-3. Execute the "First day" flow
-4. Use troubleshooting matrix when blocked
-
-### Core contributor path
+```bash
+./scripts/create-psfs-project.sh \
+  --non-interactive \
+  --name my-psfs-app \
+  --path /tmp/my-psfs-app \
+  --runtime docker \
+  --package acme/my-psfs-app \
+  --description "My PSFS app" \
+  --author "Your Name"
+```
 
-1. Read [Operations Playbook](./doc/OPERATIONS.md)
-2. Read [DTO Validation Engine](./doc/DTO_VALIDATION.md)
-3. Read [Propel Workflow](./doc/PROPEL_WORKFLOW.md)
-4. Run key tests and validate changes in Docker
+Remote install with flags:
 
-## Propel models and migrations
+```bash
+curl -fsSL https://raw.githubusercontent.com/psfs/core/master/install.sh | bash -s -- \
+  --non-interactive \
+  --name my-psfs-app \
+  --runtime docker \
+  --package acme/my-psfs-app
+```
 
-For operational Propel flow (schema, model generation context, migration execution, rollback, failure modes), see:
+## What the Generator Does
 
-- [Propel Workflow](./doc/PROPEL_WORKFLOW.md)
+- Detects `local` runtime (`php` + `composer`) and `docker` runtime (`docker compose`).
+- If both are available in interactive mode, prompts for runtime selection.
+- Generates PSFS base structure (`config`, `html`, `modules`, `cache`, `logs`, `locale`).
+- Generates initial `composer.json`.
+- For Docker runtime, generates `docker-compose.yml`, `docker/php.ini`, and `.env.example`.
+- Does not auto-run dependency install or container startup.
 
-## Documentation index
+## Documentation
 
 - [Operations Playbook](./doc/OPERATIONS.md)
 - [DTO Validation Engine](./doc/DTO_VALIDATION.md)
 - [Propel Workflow](./doc/PROPEL_WORKFLOW.md)
+- [Core Contracts](./doc/CONTRACTS.md)
 
-## Rules
+## Notes
 
-- Run project commands inside Docker containers.
-- Keep command blocks explicitly tagged as `validated` or `example-only`.
+- Runtime baseline for this repository is Docker Compose with PHP 8.3.
+- For project internals and contributor workflows, use the docs listed above.

install.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_RAW_BASE="${REPO_RAW_BASE:-https://raw.githubusercontent.com/psfs/core/master}"
+GENERATOR_PATH="${GENERATOR_PATH:-scripts/create-psfs-project.sh}"
+GENERATOR_URL="${REPO_RAW_BASE}/${GENERATOR_PATH}"
+
+tmp_file="$(mktemp -t psfs-generator.XXXXXX.sh)"
+cleanup() {
+  rm -f "${tmp_file}"
+}
+trap cleanup EXIT
+
+download_with_curl() {
+  curl -fsSL "${GENERATOR_URL}" -o "${tmp_file}"
+}
+
+download_with_wget() {
+  wget -qO "${tmp_file}" "${GENERATOR_URL}"
+}
+
+if command -v curl >/dev/null 2>&1; then
+  download_with_curl
+elif command -v wget >/dev/null 2>&1; then
+  download_with_wget
+else
+  echo "ERROR: curl or wget is required." >&2
+  exit 1
+fi
+
+bash "${tmp_file}" "$@"