feat: implement multi-provider architecture for contribution fetching and add Docker support

Dockerfile

@@ -1,19 +1,16 @@
 FROM php:8.3-cli-alpine AS base
 
-# Runtime dependencies
 RUN apk add --no-cache \
     curl \
     icu-libs \
     libzip \
     && docker-php-ext-install opcache
 
-# Composer
-COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
-
 WORKDIR /app
 
-# ── deps stage ────────────────────────────────────────────────────────────────
+# ── deps stage (prod vendor) ───────────────────────────────────────────────────
 FROM base AS deps
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
 COPY composer.json composer.lock* ./
 RUN composer install \
         --no-dev \
@@ -22,20 +19,39 @@ RUN composer install \
         --optimize-autoloader \
         --prefer-dist
 
-# ── final stage ───────────────────────────────────────────────────────────────
+# ── build stage (generate optimised classmap with source present) ──────────────
+FROM deps AS build
+COPY . .
+RUN composer dump-autoload --optimize --no-dev --no-interaction
+
+# ── dev stage (all deps + Xdebug, source is mounted at runtime) ───────────────
+FROM base AS dev
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+RUN apk add --no-cache ${PHPIZE_DEPS} linux-headers \
+    && pecl install xdebug \
+    && docker-php-ext-enable xdebug \
+    && apk del ${PHPIZE_DEPS}
+COPY docker/php/xdebug.ini /usr/local/etc/php/conf.d/docker-xdebug.ini
+COPY composer.json composer.lock* ./
+RUN composer install --no-scripts --no-interaction --prefer-dist
+EXPOSE 8080
+ENV APP_ENV=dev APP_DEBUG=1
+CMD ["php", "-S", "0.0.0.0:8080", "-t", "public", "public/index.php"]
+
+# ── final (prod) stage — no composer binary ────────────────────────────────────
 FROM base AS final
 
-COPY --from=deps /app/vendor /app/vendor
+RUN addgroup -S app && adduser -S -G app app
+
+COPY --from=build /app/vendor /app/vendor
 COPY . .
 
 RUN mkdir -p var/cache var/log \
-    && chmod -R 777 var \
-    && composer dump-autoload --optimize --no-dev
+    && chown -R app:app /app
+
+USER app
 
 EXPOSE 8080
+ENV APP_ENV=prod APP_DEBUG=0
 
-ENV APP_ENV=prod \
-    APP_DEBUG=0
-
-# Symfony's built-in dev server via PHP — fine for a single-purpose container
 CMD ["php", "-S", "0.0.0.0:8080", "-t", "public", "public/index.php"]