Development Automation & Testing Infrastructure

.dockerignore

@@ -0,0 +1,88 @@
+# .dockerignore for Hermes backend build
+# Only include what's needed for the Go server binary
+
+# Exclude testing infrastructure
+testing/
+tests/
+
+# Exclude documentation
+docs-internal/
+*.md
+!README.md
+
+# Exclude build artifacts
+build/
+/hermes
+*.exe
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+coverage*.out
+coverage*.html
+
+# Exclude config files with secrets
+config.hcl
+credentials.json
+token.json
+.env*
+
+# Exclude version control
+.git/
+.github/
+.gitignore
+.gitattributes
+
+# Exclude test outputs and logs
+workspace.test
+test_results.log
+test_output.log
+test_final.log
+*.log
+*.patch
+
+# Exclude macOS and OS files
+.DS_Store
+Thumbs.db
+
+# Exclude Python scripts
+*.py
+*.sh
+refactor_*.py
+fix_*.py
+scripts/
+
+# Exclude web development files (keep only dist/ and web.go)
+web/node_modules/
+web/.yarn/
+web/.pnp.*
+web/.npm/
+web/.eslintcache
+web/tests/
+web/mirage/
+web/tmp/
+web/.cache/
+web/babel.config.js
+web/ember-cli-build.js
+web/package.json
+web/yarn.lock
+web/tsconfig.json
+web/testem.js
+web/tailwind.config.js
+web/.template-lintrc.js
+web/.eslintrc.js
+web/.prettierrc.js
+web/types/
+web/vendor/
+
+# Keep only web/dist (needed for go:embed) and web/web.go
+!web/dist/
+!web/web.go
+
+# Exclude IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~

.env.example

@@ -0,0 +1,26 @@
+# Minimal .env example for local development and testing
+# Copy to .env and fill in your actual values
+
+# Required for web frontend
+HERMES_WEB_GOOGLE_OAUTH2_CLIENT_ID=your-client-id.apps.googleusercontent.com
+
+# Required for backend Google API access
+GOOGLE_APPLICATION_CREDENTIALS=./credentials.json
+
+# Required for search functionality
+HERMES_WEB_ALGOLIA_APP_ID=your-algolia-app-id
+HERMES_WEB_ALGOLIA_SEARCH_API_KEY=your-search-api-key
+ALGOLIA_ADMIN_API_KEY=your-admin-api-key
+
+# Optional: Override default index names
+HERMES_WEB_ALGOLIA_DOCS_INDEX_NAME=hermes_docs
+HERMES_WEB_ALGOLIA_DRAFTS_INDEX_NAME=hermes_drafts
+HERMES_WEB_ALGOLIA_INTERNAL_INDEX_NAME=hermes_internal
+HERMES_WEB_ALGOLIA_PROJECTS_INDEX_NAME=hermes_projects
+
+# Optional: Database (uses Docker defaults if not set)
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/hermes?sslmode=disable
+
+# Optional: Application settings
+HERMES_WEB_SHORT_LINK_BASE_URL=http://localhost:8000
+LOG_LEVEL=info

.env.template

@@ -0,0 +1,90 @@
+# Hermes Environment Variables Template
+# Copy this file to .env and fill in your actual values
+# WARNING: Never commit .env files with real credentials!
+
+# =============================================================================
+# Google Workspace Integration
+# =============================================================================
+
+# Google OAuth 2.0 Client ID (for web frontend authentication)
+# Get this from Google Cloud Console > APIs & Services > Credentials
+HERMES_WEB_GOOGLE_OAUTH2_CLIENT_ID=your-client-id.apps.googleusercontent.com
+
+# Google Service Account Credentials (for backend API access)
+# Path to your service account JSON file (e.g., ./credentials.json)
+# Download from Google Cloud Console > IAM & Admin > Service Accounts
+GOOGLE_APPLICATION_CREDENTIALS=./credentials.json
+
+# =============================================================================
+# Algolia Search Configuration
+# =============================================================================
+
+# Algolia Application ID
+HERMES_WEB_ALGOLIA_APP_ID=your-algolia-app-id
+
+# Algolia Search API Key (public, read-only key for frontend)
+HERMES_WEB_ALGOLIA_SEARCH_API_KEY=your-algolia-search-api-key
+
+# Algolia Admin API Key (for backend indexing operations)
+# Keep this secret! Only use in backend/testing
+ALGOLIA_ADMIN_API_KEY=your-algolia-admin-api-key
+
+# Algolia Index Names (customize per environment: dev, staging, prod)
+HERMES_WEB_ALGOLIA_DOCS_INDEX_NAME=hermes_docs_dev
+HERMES_WEB_ALGOLIA_DRAFTS_INDEX_NAME=hermes_drafts_dev
+HERMES_WEB_ALGOLIA_INTERNAL_INDEX_NAME=hermes_internal_dev
+HERMES_WEB_ALGOLIA_PROJECTS_INDEX_NAME=hermes_projects_dev
+
+# =============================================================================
+# Application Configuration
+# =============================================================================
+
+# Short Link Base URL (for generating short URLs)
+HERMES_WEB_SHORT_LINK_BASE_URL=http://localhost:8000
+
+# Google Analytics Tag ID (optional, for tracking)
+HERMES_WEB_GOOGLE_ANALYTICS_TAG_ID=
+
+# =============================================================================
+# Database Configuration
+# =============================================================================
+
+# PostgreSQL connection string
+# Default for local Docker: postgresql://postgres:postgres@localhost:5432/hermes?sslmode=disable
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/hermes?sslmode=disable
+
+# =============================================================================
+# Datadog Configuration (optional)
+# =============================================================================
+
+# Datadog API Key (for monitoring and logging)
+DATADOG_API_KEY=
+
+# Datadog Application Key
+DATADOG_APP_KEY=
+
+# Datadog Site (e.g., datadoghq.com, datadoghq.eu)
+DATADOG_SITE=datadoghq.com
+
+# =============================================================================
+# Testing Configuration
+# =============================================================================
+
+# Set to "true" to enable test mode
+TEST_MODE=false
+
+# Test database URL (separate from production)
+TEST_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/hermes_test?sslmode=disable
+
+# =============================================================================
+# Server Configuration
+# =============================================================================
+
+# Server address and port
+SERVER_ADDRESS=:8000
+
+# Log level (debug, info, warn, error)
+LOG_LEVEL=info
+
+# Environment (development, staging, production)
+ENVIRONMENT=development