Add Docker-based local testing environment with ArchivesSpace 2.6, MySQL, Solr, and ArcLight

.env.example

@@ -0,0 +1,30 @@
+# ArcFlow Environment Configuration Template
+# Copy this file to .env and update with your values
+
+# ===== Docker Local Testing Environment =====
+# MySQL Database Configuration for ArchivesSpace
+MYSQL_DATABASE=archivesspace
+MYSQL_USER=as
+MYSQL_PASSWORD=as123
+
+# ===== ArcFlow Script Configuration =====
+# Solr Configuration
+# Use local Solr: http://localhost:8983/solr/arclight
+# Use remote Solr via SSH tunnel: http://localhost:8984/solr/arclight (with ssh -NTL 8984:localhost:8983 remote-server)
+ARCLIGHT_SOLR_URL=http://localhost:8983/solr/arclight
+
+# ArcLight Directory
+# Path to your local Arcuit (or other ArcLight application) directory
+ARCLIGHT_DIR=/path/to/arcuit
+
+# ArchivesSpace Directory
+# Path to your ArchivesSpace installation (for job files)
+ASPACE_DIR=/path/to/archivesspace
+
+# Traject Extra Configuration (optional)
+# Path to additional Traject configuration file
+# TRAJECT_EXTRA_CONFIG=/path/to/extra_config.rb
+
+# Force Update
+# Set to true to recreate all EADs from scratch
+# FORCE_UPDATE=false

.gitattributes

@@ -0,0 +1,2 @@
+# Ensure shell scripts always have LF line endings
+*.sh text eol=lf

.gitignore

@@ -60,4 +60,45 @@ MANIFEST
 .arcflow.yml
 
 # PID files
-*.pid
+*.pid
+
+# Local Solr configuration (can vary by environment)
+solr-config/
+
+# Environment configuration
+.env
+# Docker local testing - working data (managed by Docker volumes)
+# Note: Using named volumes instead of bind mounts for better permission handling
+# mysql-data, archivesspace-data, and solr-data are now Docker-managed volumes
+
+# Docker local testing - backup data (preserve but don't commit)
+# These are large files that should be obtained from dev server
+backup-data/*
+!backup-data/mysql/
+backup-data/mysql/*
+!backup-data/mysql/README.md
+!backup-data/mysql/archivesspace.sql
+
+# Exception: Allow the test SQL dump for immediate testing
+# This is a 344KB dump with full schema but no data
+!backup-data/mysql/archivesspace.sql
+
+# Docker local testing - config directories
+# Default configsets are provided for immediate working setup
+# Users can replace these with their own configurations if needed
+!configsets/
+!configsets/blacklight-core/
+!configsets/blacklight-core/**
+!configsets/archivesspace/
+!configsets/archivesspace/**
+
+# ArcLight data directory
+arclight-data/
+
+# Temporary backup files
+*.sql
+*.sql.gz
+*.tar.gz
+
+# Exception: Allow the test MySQL dump for immediate testing
+!backup-data/mysql/archivesspace.sql