Fix iconv error on CSV export with special characters (RES-2058)

.fly/scripts/startup.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+
+# Do NOT use set -e — we must always reach supervisord at the end
+# so that nginx starts and the health check passes.
+
+# Ensure storage directories exist
+mkdir -p /var/www/storage/framework/{sessions,views,cache/data}
+mkdir -p /var/www/storage/logs
+mkdir -p /var/www/bootstrap/cache
+chown -R www-data:www-data /var/www/storage /var/www/bootstrap/cache
+
+# Substitute environment variables in nginx config for Tigris proxy.
+if [ -n "$AWS_BUCKET" ]; then
+    export TIGRIS_BUCKET_URL="https://${AWS_BUCKET}.fly.storage.tigris.dev"
+    export TIGRIS_BUCKET_HOST="${AWS_BUCKET}.fly.storage.tigris.dev"
+    envsubst '${TIGRIS_BUCKET_URL} ${TIGRIS_BUCKET_HOST}' < /etc/nginx/nginx.conf > /etc/nginx/nginx.conf.tmp
+    mv /etc/nginx/nginx.conf.tmp /etc/nginx/nginx.conf
+fi
+
+# Run DB setup in a subshell so failures never prevent supervisord from starting
+(
+    # Wait for MySQL to be reachable
+    echo "Waiting for database..."
+    DB_READY=0
+    for i in $(seq 1 30); do
+        if php /var/www/artisan migrate:status > /dev/null 2>&1; then
+            DB_READY=1
+            break
+        fi
+        echo "  attempt $i/30 - database not ready, retrying..."
+        sleep 2
+    done
+
+    if [ "$DB_READY" = "1" ]; then
+        echo "Database ready, running migrations..."
+        php /var/www/artisan migrate --force || echo "WARNING: migrate failed"
+        timeout 30 php /var/www/artisan translations:import 2>/dev/null || true
+    else
+        echo "WARNING: Database not reachable after 60s, skipping migrations"
+    fi
+
+    # Cache config/routes/views for performance (non-fatal)
+    php /var/www/artisan config:cache 2>/dev/null || true
+    php /var/www/artisan route:cache 2>/dev/null || true
+    php /var/www/artisan view:cache 2>/dev/null || true
+    php /var/www/artisan queue:restart 2>/dev/null || true
+) &
+
+# Start supervisord immediately (manages nginx, php-fpm, cron)
+# This ensures the health check can pass while DB setup runs in background
+exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf

.gitattributes

@@ -0,0 +1,25 @@
+# Ensure shell scripts always use LF line endings
+*.sh text eol=lf
+
+# Auto detect text files and normalize line endings to LF
+* text=auto eol=lf
+
+# Ensure specific file types use LF
+*.php text eol=lf
+*.js text eol=lf
+*.vue text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary

.gitignore

@@ -23,6 +23,16 @@ restarters-anonymised.sql
 /public/global
 /public/js/app.js
 /public/js/wiki.js
+/public/js/resources_js_*.js
 /public/css/app.css
+/public/hot
+/public/messages.js
 /public/css/wiki.css
 /.claude/settings.local.json
+/public/build/
+/storage/api-docs/api-docs.json
+/.phpunit.result.cache
+/playwright-report/
+/events.csv
+/public/repair-data*.csv
+/uploads/*.jpg

CLAUDE.md

@@ -2,6 +2,42 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## CRITICAL: Docker Commands
+
+**NEVER use `docker-compose` or `docker exec` directly. ALWAYS use `task` commands.**
+
+```bash
+# Starting containers
+task docker:up-core      # Core services only
+task docker:up-debug     # Core + debug tools (phpMyAdmin, Mailhog)
+task docker:up-discourse # Core + Discourse
+task docker:up-all       # All services
+
+# Stopping containers
+task docker:down-core
+task docker:down-debug
+task docker:down-discourse
+task docker:down-all
+
+# Running commands in container
+task docker:run:bash -- "npm run dev"      # Run bash command
+task docker:run:artisan -- migrate         # Run artisan command
+task docker:shell                          # Open shell in container
+
+# Testing
+task docker:test:phpunit      # Run PHP tests
+task docker:test:jest         # Run JS tests
+task docker:test:playwright   # Run e2e tests
+
+# Vite dev server (HMR)
+task docker:vite:start        # Start Vite in background
+task docker:vite:stop         # Stop Vite
+task docker:vite              # Start Vite in foreground (interactive)
+
+# Logs and debugging
+task docker:logs              # View container logs
+```
+
 ## Project Overview
 
 Restarters.net is a suite of software for the repair community that brings together community repair enthusiasts and activists. It combines three core modules:
@@ -16,16 +52,16 @@ This is a Laravel 9 application with PHP 8+ that integrates with external servic
 
 ### Local Development Setup
 ```bash
-# Using Docker (recommended for full development environment)
-docker-compose up -d
+# Using Docker (recommended) - see CRITICAL section above for task commands
+task docker:up-debug    # Start with debug tools
 
 # The application will be available at:
-# - Restarters: http://www.example.com:8001
-# - phpMyAdmin: http://www.example.com:8002  
-# - Discourse: http://www.example.com:8003
+# - Restarters: http://localhost:8001
+# - phpMyAdmin: http://localhost:8002
 # - Mailhog: http://localhost:8025
 
-# Note: Add www.example.com to your hosts file pointing to your Docker host
+# Run Vite for HMR (hot module replacement)
+task docker:run:bash -- "npm run dev"
 ```
 
 ### Common Development Commands
@@ -44,7 +80,7 @@ php artisan migrate            # Run database migrations
 php artisan migrate:fresh     # Fresh migration (drops all tables)
 php artisan seed              # Run database seeders
 php artisan tinker            # Laravel REPL
-php artisan lang:js           # Generate JavaScript translation files
+# JavaScript translation files are now auto-generated by Vite laravel-translator plugin
 php artisan translations:check # Check translation completeness
 
 # Generate application key (for new installs)
@@ -147,4 +183,7 @@ npm test
 - Only translate fr and fr-BE
 
 ## Development Warnings
-- Don't try to test changes when you're running on Windows.
+- Don't try to test changes when you're running on Windows.
+
+## Workflow Guidelines
+- When you create files, add them to git

Dockerfile

@@ -9,11 +9,19 @@ RUN apt-get update && \
         unzip \
         npm \
         vim \
+        netcat-openbsd \
         default-mysql-client \
         postgresql-client && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
+# Install Playwright system dependencies
+# We need to install @playwright/test first to get the install-deps command
+RUN npm install -g @playwright/test && \
+    npm install -g jest-junit && \
+    npx playwright install-deps && \
+    npm uninstall -g @playwright/test
+
 ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/download/2.7.31/install-php-extensions /usr/local/bin/
 
 RUN install-php-extensions \
@@ -23,6 +31,9 @@ RUN install-php-extensions \
     xmlrpc \
     xdebug \
     intl \
+    exif \
+    pcntl \
+    curl \
     gd
 
 # Install composer.  Don't run composer install yet - see docker_run.sh
@@ -46,9 +57,10 @@ RUN if getent group ${GID}; then \
       useradd -m -u ${UID} -g restarter -s /bin/bash restarter; \
     fi
 
-# Dynamically update php-fpm to use the new user and group
+# Dynamically update php-fpm to use the new user and group, and listen on all interfaces
 RUN sed -i "s/user = www-data/user = restarter/g" /usr/local/etc/php-fpm.d/www.conf && \
-    sed -i "s/group = www-data/group = restarter/g" /usr/local/etc/php-fpm.d/www.conf
+    sed -i "s/group = www-data/group = restarter/g" /usr/local/etc/php-fpm.d/www.conf && \
+    sed -i "s/listen = 127.0.0.1:9000/listen = 0.0.0.0:9000/g" /usr/local/etc/php-fpm.d/www.conf
 
 # Copy the code (this will be overridden by the volume mount in docker-compose)
 COPY --chown=${UID}:${GID} . ./

Dockerfile.fly

@@ -0,0 +1,123 @@
+# =============================================================================
+# Stage 1: Build assets (Node + Composer)
+# =============================================================================
+FROM php:8.2-cli AS builder
+
+# Install system dependencies for building
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git zip unzip curl \
+    libpng-dev libjpeg62-turbo-dev libfreetype6-dev libzip-dev libicu-dev libxml2-dev \
+    && docker-php-ext-configure gd --with-freetype --with-jpeg \
+    && docker-php-ext-install pdo_mysql bcmath zip intl gd \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Install xmlrpc via pecl
+RUN pecl install channel://pecl.php.net/xmlrpc-1.0.0RC3 && docker-php-ext-enable xmlrpc
+
+# Install composer
+COPY --from=composer/composer:2-bin /composer /usr/bin/composer
+
+# Install Node 18
+RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash - \
+    && apt-get install -y nodejs \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /build
+
+# Copy composer files first for layer caching
+COPY composer.json composer.lock ./
+RUN composer install --no-dev --no-scripts --no-autoloader --prefer-dist
+
+# Copy package files for npm layer caching
+COPY package.json package-lock.json ./
+RUN npm ci --legacy-peer-deps
+RUN npx update-browserslist-db@latest
+
+# Copy all source code
+COPY . .
+
+# Create a minimal .env for artisan commands during build (no DB needed)
+RUN echo "APP_KEY=base64:$(openssl rand -base64 32)" > .env && \
+    echo "APP_ENV=production" >> .env
+
+# Finish composer autoload (skip post-autoload scripts that need DB/app context)
+ENV COMPOSER_ALLOW_SUPERUSER=1
+RUN composer dump-autoload --optimize --no-dev --no-scripts
+
+# Run package discovery manually
+RUN php artisan package:discover --ansi || true
+
+# Build frontend assets
+# The webpack.mix.js runs `php artisan lang:js` via WebpackShellPlugin, but that
+# needs the full app bootstrapped. Generate translations first, then build.
+RUN php artisan lang:js --no-lib resources/js/translations.js 2>/dev/null || true
+RUN npm run production
+
+# Generate swagger docs (non-fatal if it fails)
+RUN php artisan l5-swagger:generate 2>/dev/null || true
+
+# Remove build .env (real env comes from Fly secrets at runtime)
+RUN rm -f .env
+
+# =============================================================================
+# Stage 2: Production image (Nginx + PHP-FPM + Supervisord + Cron)
+# =============================================================================
+FROM php:8.2-fpm
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    nginx \
+    supervisor \
+    cron \
+    gettext-base \
+    libpng-dev libjpeg62-turbo-dev libfreetype6-dev libzip-dev libicu-dev libxml2-dev \
+    && docker-php-ext-configure gd --with-freetype --with-jpeg \
+    && docker-php-ext-install pdo_mysql bcmath zip intl gd \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Install xmlrpc
+RUN pecl install channel://pecl.php.net/xmlrpc-1.0.0RC3 && docker-php-ext-enable xmlrpc
+
+# Configure PHP-FPM to use unix socket
+RUN sed -i 's|listen = 127.0.0.1:9000|listen = /var/run/php-fpm.sock|' /usr/local/etc/php-fpm.d/www.conf && \
+    sed -i 's|;listen.owner = www-data|listen.owner = www-data|' /usr/local/etc/php-fpm.d/www.conf && \
+    sed -i 's|;listen.group = www-data|listen.group = www-data|' /usr/local/etc/php-fpm.d/www.conf && \
+    sed -i 's|;listen.mode = 0660|listen.mode = 0660|' /usr/local/etc/php-fpm.d/www.conf && \
+    rm -f /usr/local/etc/php-fpm.d/zz-docker.conf
+
+# PHP production settings
+RUN cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/conf.d/php.ini && \
+    echo "upload_max_filesize = 100M" >> /usr/local/etc/php/conf.d/php.ini && \
+    echo "post_max_size = 100M" >> /usr/local/etc/php/conf.d/php.ini && \
+    echo "memory_limit = 256M" >> /usr/local/etc/php/conf.d/php.ini
+
+# Copy nginx config
+COPY docker/nginx-fly.conf /etc/nginx/nginx.conf
+
+# Copy supervisord config
+COPY docker/supervisord-fly.conf /etc/supervisor/conf.d/supervisord.conf
+
+# Set up cron for Laravel scheduler (every minute)
+RUN echo "* * * * * cd /var/www && php artisan schedule:run >> /dev/null 2>&1" | crontab -
+
+# Set working directory
+WORKDIR /var/www
+
+# Copy application from builder
+COPY --from=builder --chown=www-data:www-data /build /var/www
+
+# Remove dev files not needed in production
+RUN rm -rf node_modules tests .git .github
+
+# Ensure storage and cache directories exist
+RUN mkdir -p storage/framework/{sessions,views,cache/data} \
+    storage/logs bootstrap/cache \
+    && chown -R www-data:www-data storage bootstrap/cache
+
+# Copy startup script
+COPY .fly/scripts/startup.sh /usr/local/bin/startup.sh
+RUN chmod +x /usr/local/bin/startup.sh
+
+EXPOSE 80
+
+CMD ["/usr/local/bin/startup.sh"]