Digital Handbook

Appearance

CoSign.Agency ​

CoSign Interpreting Services - WordPress application for interpreter service requests and digital document signing with payment terms processing.

Billing ​

Hosting Platform ​

Current Hosting Details ​

  • Provider: TBD
  • Plan: TBD
  • Server Location: TBD
  • SSL Certificate: TBD

Domain Management ​

  • Domain: cosign.agency
  • Local Development: cosignct.test
  • Registrar: TBD
  • DNS Provider: TBD
  • CDN: TBD

Technical Stack ​

  • Framework: WordPress with Roots stack (Bedrock + Sage + Trellis)
  • Theme: Sage theme with Tailwind CSS and Laravel Blade templating
  • Build System: Bud.js (@roots/bud) with Vue.js components
  • Backend: PHP with WordPress core, Advanced Custom Fields Pro
  • Frontend: Vue.js 3, Tailwind CSS, GSAP animations
  • Database: MySQL (managed by Bedrock)
  • Deployment: Trellis (Ansible-powered LEMP stack via Vagrant)
  • Development Server: http://localhost:3000 (proxy to cosignct.test)
  • Backup Strategy: TBD

Project Info ​

Project Details ​

  • Project Start Date: TBD
  • Launch Date: TBD
  • Current Status: Production
  • Last Updated: TBD

Client Contact Information ​

  • Primary Contact: TBD
  • Email: TBD
  • Phone: TBD
  • Role: TBD

Project Team ​

  • Project Manager: TBD
  • Developer(s): TBD
  • Designer: TBD
  • Content Manager: TBD

Notes ​

Development Notes ​

  • Architecture: WordPress with complete Roots stack for modern development
  • Custom Block System: 25+ custom Gutenberg blocks ("Pinecones") in fir/Pinecones/
  • Form Processing: Advanced AJAX handlers for interpreter requests and contract signing
  • Digital Signatures: HTML5 canvas-based signature capture with PDF generation
  • Environment Detection: Smart email routing based on development/production context
  • File System: Custom .cosign files for structured interpreter request data

Development Commands ​

  • Theme Development: npm run dev (hot reload), npm run build (production)
  • PHP Dependencies: composer install
  • Code Quality: composer test (phpcs standards)
  • Translations: npm run translate, npm run translate:compile
  • Local Environment: vagrant up in trellis/ directory
  • Deployment: ansible-playbook deploy.yml -e env=production

Content Updates ​

  • Content Management: WordPress admin with custom Gutenberg blocks
  • Form Management: AJAX handlers in fir/Inc/Ajax.php
  • Update Schedule: TBD
  • Maintenance: Ansible-based deployment automation
  • Change Log: TBD

Client Feedback ​

  • Revisions: TBD
  • Communication Notes: TBD

Performance Notes ​

  • Metrics: TBD
  • Optimization: Bud.js build system, Vue.js components for interactivity
  • PDF Generation: Dompdf for contract and request documents
  • Monitoring: TBD

Third Party Services ​

Analytics & Tracking ​

  • Google Analytics: TBD
  • Google Tag Manager: TBD
  • Heatmap Tools: TBD

Email Services ​

  • Email Provider: Environment-based email routing
  • Marketing Platform: TBD

Security Services ​

  • Security Monitoring: TBD
  • Malware Protection: TBD
  • CSRF Protection: WordPress nonces implemented

Performance & Monitoring ​

  • Uptime Monitoring: TBD
  • Performance Tools: TBD

APIs & Integrations ​

  • Google Places API: Address autocomplete functionality
  • Digital Signatures: signature_pad library for canvas-based signatures

Website Features ​

Core Application Features ​

  • Interpreter Service Requests: Multi-step forms with conditional logic
  • Digital Document Signing: HTML5 canvas signature capture
  • PDF Generation: Automated contract and request document creation
  • Payment Terms Processing: Specialized form handling for contracts
  • File Management: Custom file types and temporary file cleanup

Custom Block System (Pinecones) ​

  • Form Blocks: Multi-step forms, signature capture, conditional logic
  • Layout Blocks: Hero, Columns, Wrap, Layout components
  • Content Blocks: Paragraph, Heading, Markdown, Table, Accordion
  • Block Location: fir/Pinecones/ with 25+ custom components
  • Registration: Auto-registered in fir/Inc/Setup.php

Vue.js Interactive Components ​

  • Signature.vue: Digital signature capture interface
  • Address.vue: Google Places address autocomplete
  • Form Controls: Textinput.vue, Textarea.vue, Choices.vue
  • Location: fir/assets/scripts/components/

Form Processing System ​

  • General Requests: process_form() AJAX handler
  • Payment Terms: process_pricing_form() AJAX handler
  • PDF Generation: Dompdf integration with digital signatures
  • Security: Input sanitization and nonce validation
  • File Handling: Temporary file management and cleanup

Technical Specifications ​

Directory Structure ​

cosignct/
├── site/                    # Bedrock WordPress installation
│   ├── web/app/themes/fir/  # Main Sage theme
│   ├── web/app/uploads/     # WordPress uploads
│   └── composer.json        # PHP dependencies
├── trellis/                 # Deployment configuration
└── CLAUDE.md               # Documentation

Environment Configuration ​

  • Local Development: cosignct.test (HTTPS proxy)
  • Development Server: localhost:3000
  • File Paths: Uploads, attachments, temporary files configured
  • Environment Variables: Bedrock environment-based configuration

Key Dependencies ​

  • PHP: WordPress core, ACF Pro, Dompdf, ACF Composer
  • JavaScript: Vue.js, signature_pad, GSAP, UUID generation
  • Build: @roots/bud build system
  • Deployment: Ansible via Trellis

Credentials / Keys ​

Hosting & Domain Access ​

  • Domain Registrar: TBD
  • Hosting Provider: TBD
  • DNS Management: TBD

Development Credentials ​

  • Repository Access: TBD
  • Server Access: Trellis/Ansible managed SSH keys
  • Database: Environment-based configuration

Third Party Service Credentials ​

  • Google Places API: Required for address autocomplete
  • Email Services: Environment-based configuration
  • Analytics: TBD

APIs & Integrations ​

  • Google Places API: Address autocomplete functionality
  • WordPress REST API: Available for content management
  • Custom AJAX Endpoints: Form processing handlers

Security Access ​

  • WordPress Admin: TBD
  • Server Access: SSH keys managed by Trellis
  • SSL Certificate Management: TBD
  • File Permissions: Attachments directory requires write access

Security Note: All credentials and sensitive information should be stored securely using the agency's approved password management system. The application uses WordPress nonces for CSRF protection and sanitizes all form inputs. Environment variables are managed through Bedrock's configuration system and should never be committed to version control.