Update README to reflect current stack and project structure

- Requirements: MariaDB 11 (not MySQL 8.0), Caddy+PHP-FPM (not Apache),
  imagick extension (not GD)
- Docker CLI: mariadb command (not mysql)
- Project structure: resources/, bin/, bootstrap/app.php, tests/e2e/
- Test counts: 102 PHPUnit, 40×4=160 Playwright
- CI: PHP 8.3 and 8.4 (not 8.2/8.3)
- Added Nginx example alongside Caddy for manual installs
- Added composer install step to manual installation
- Removed stale DEFAULT_THEME / MAX_UPLOAD_SIZE env vars, added
  APP_ENV, APP_DEBUG, SESSION_LIFETIME

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: thenickberry

README.md

@@ -4,28 +4,28 @@ A PHP-based image management and cataloging system.
 
 ## Overview
 
-CANDIDv2 is an image database application that allows users to organize, search, and browse photo collections. Originally written in Perl by Ben Weir, it has been rewritten in PHP.
+CANDIDv2 is an image database application for organizing, searching, and browsing photo collections. Originally written in Perl by Ben Weir, rewritten in modern PHP.
 
 ## Features
 
-- **Search** — Find images by date, photographer, description, or tagged people
-- **Browse** — Navigate images through hierarchical categories with sorting options
-- **Lightbox** — View images in a carousel with keyboard/touch navigation
-- **Bulk Upload** — Upload multiple images with EXIF metadata extraction
-- **People Tagging** — Tag users in photos and search by tagged people
-- **Duplicate Detection** — Automatic MD5-based duplicate detection on upload
+- **Browse** — Navigate images through hierarchical categories with sort options
+- **Search** — Find images by date range, photographer, description, or tagged people
+- **Lightbox** — Full-screen carousel with keyboard and touch navigation
+- **Bulk Upload** — Upload multiple images at once with automatic EXIF extraction (date taken, camera)
+- **Bulk Edit** — Select multiple images to update metadata or rotate in one action
+- **People Tagging** — Tag users in photos and filter search results by tagged people
+- **Duplicate Detection** — MD5-based duplicate detection on upload
+- **Admin Panel** — User management and trash/restore for soft-deleted content
 
 ## Requirements
 
 - PHP 8.3+
-- MySQL 8.0+
-- Apache with mod_rewrite
-- PHP Extensions: GD, PDO_MySQL, EXIF, zip
+- MariaDB 11+
+- Caddy (or any web server) + PHP-FPM
+- PHP extensions: `imagick`, `pdo_mysql`, `exif`, `zip`
 
 ## Quick Start (Docker)
 
-The fastest way to get started is with Docker:
-
 ```bash
 # Clone the repository
 git clone <repository-url>
@@ -43,10 +43,10 @@ open http://localhost:8080
 
 ### Default Credentials
 
-- **Username:** admin
-- **Password:** changeme
+- **Username:** `admin`
+- **Password:** `changeme`
 
-**Important:** Change the admin password immediately after first login.
+> **Important:** Change the admin password immediately after first login.
 
 ### Docker Commands
 
@@ -60,16 +60,14 @@ docker compose down
 # View logs
 docker compose logs -f
 
-# Rebuild after changes
-docker compose build --no-cache
-docker compose up -d
+# Rebuild image after Dockerfile changes
+docker compose build --no-cache && docker compose up -d
 
-# Access MySQL CLI
-docker compose exec db mysql -u candid -p candid
+# MariaDB CLI
+docker compose exec db mariadb -u candid -p candid
 
-# Reset database (warning: destroys data)
-docker compose down -v
-docker compose up -d
+# Reset database (destroys all data)
+docker compose down -v && docker compose up -d
 ```
 
 ## Manual Installation
@@ -78,97 +76,112 @@ docker compose up -d
 
 ```bash
 cp .env.example .env
-# Edit .env with your database credentials
+# Edit .env with your database credentials and settings
 ```
 
-### 2. Create Database
+### 2. Install PHP Dependencies
 
 ```bash
-mysql -u root -p < database/schema.sql
-mysql -u root -p candid < database/seed.sql
+composer install
 ```
 
-### 3. Configure Apache
+### 3. Create Database
 
-Point your document root to the `public/` directory and ensure mod_rewrite is enabled.
+```bash
+mariadb -u root -p < database/schema.sql
+mariadb -u root -p candid < database/seed.sql
+```
 
-Example virtual host:
+### 4. Configure Web Server
 
-```apache
-<VirtualHost *:80>
-    ServerName candid.local
-    DocumentRoot /path/to/candidv2/public
+Point your document root to the `public/` directory. All requests must be routed through `public/index.php`.
 
-    <Directory /path/to/candidv2/public>
-        AllowOverride All
-        Require all granted
-    </Directory>
-</VirtualHost>
+**Caddy example:**
+```
+root * /path/to/candidv2/public
+php_fastcgi unix//run/php/php-fpm.sock
+file_server
+try_files {path} /index.php?{query}
+```
+
+**Nginx example:**
+```nginx
+root /path/to/candidv2/public;
+index index.php;
+location / { try_files $uri $uri/ /index.php?$query_string; }
+location ~ \.php$ { fastcgi_pass unix:/run/php/php-fpm.sock; include fastcgi_params; }
 ```
 
-### 4. Set Permissions
+### 5. Set Permissions
 
 ```bash
-# Make storage directories writable
 chmod -R 755 storage
 chown -R www-data:www-data storage
 ```
 
 ## Configuration
 
-Configuration is managed through environment variables. See `.env.example` for available options:
+All configuration is via environment variables in `.env`:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
+| `APP_ENV` | Environment (`development` / `production`) | `production` |
+| `APP_DEBUG` | Show PHP errors | `false` |
 | `DB_HOST` | Database hostname | `localhost` |
 | `DB_NAME` | Database name | `candid` |
 | `DB_USER` | Database username | `candid` |
 | `DB_PASS` | Database password | — |
-| `DEFAULT_THEME` | UI theme | `default` |
-| `MAX_UPLOAD_SIZE` | Max upload file size | `50M` |
+| `SESSION_LIFETIME` | Session lifetime in seconds | `86400` |
 
 ## Project Structure
 
 ```
 candidv2/
-├── public/           # Web root (front controller)
+├── bin/              # CLI utility scripts
+├── bootstrap/
+│   └── app.php       # Application bootstrap
+├── config/           # Configuration
+├── database/         # Schema and seed SQL
+├── docker/           # Dockerfile, Caddyfile, php.ini
+├── public/           # Web root (front controller + assets)
+├── resources/        # View templates
 ├── src/              # Application code (PSR-4: App\)
-│   ├── Controller/   # Request handlers
-│   ├── Service/      # Business logic
-│   ├── Exception/    # Custom exceptions
-│   └── Helper/       # Utility functions
-├── config/           # Configuration files
-├── templates/        # View templates
-├── database/         # Schema and seeds
-├── docker/           # Docker configuration
+│   ├── Controller/
+│   ├── Service/
+│   ├── Repository/
+│   ├── Entity/
+│   ├── Exception/
+│   └── Helper/
 ├── storage/          # Runtime files (uploads, images, cache)
-├── scripts/          # CLI utilities
-├── tests/            # PHPUnit test suites
-└── legacy/           # Deprecated code (reference only)
+└── tests/            # PHPUnit suites + Playwright E2E
+    └── e2e/
 ```
 
 ## Testing
 
 ```bash
-# PHPUnit (79 tests)
+# PHPUnit — unit and integration tests (102 tests)
 docker exec candidv2-app-1 php vendor/bin/phpunit
 
-# PHPStan static analysis
+# PHPStan — static analysis (level 6)
 docker exec candidv2-app-1 vendor/bin/phpstan analyse
 
-# Playwright E2E (27 tests) - requires npm install first
+# Playwright — E2E tests (40 tests × 4 browsers = 160 total)
 npm install && npx playwright install
 npx playwright test
+
+# Single browser
+npx playwright test --project=chromium
 ```
 
-Tests run automatically via GitHub Actions on push/PR (PHP 8.2, 8.3).
+Tests run automatically via GitHub Actions on push/PR (PHP 8.3 and 8.4).
 
 ## Documentation
 
-- [PHASES.md](PHASES.md) — Roadmap for ongoing updates
-- [CHANGELOG.md](CHANGELOG.md) — Log of all modifications
-- [MODERNIZATION_PLAN.md](MODERNIZATION_PLAN.md) — Technical assessment and plan
+- [PHASES.md](PHASES.md) — Roadmap and task tracking
+- [CHANGELOG.md](CHANGELOG.md) — Log of all changes with rationale
+- [MODERNIZATION_PLAN.md](MODERNIZATION_PLAN.md) — Technical assessment
 
 ## License
 
-See LICENSE file for details.
+MIT — see [LICENSE](LICENSE) for details.