Solar AI-Q Hub
Enterprise Grade Integration Platform for Solar Companies

Solar AI-Q Hub is a secure, scalable integration backbone that connects your solar business systems into one unified ecosystem. Purpose-built for the Australian solar industry, it eliminates manual data entry, reduces errors, and ensures your team always works with accurate, real-time information.

The platform acts as an intelligent middleware layer between Pipereply's Solar AI-Q CRM and your critical solar industry tools - OpenSolar, SpendWatt, Pylon, Simpro, AroFlo, ServiceM8, and all major lead providers - enabling seamless, bidirectional data flow without the limitations of legacy integration platforms.

Core Value Proposition
One entry. Everywhere updated.

When a proposal is sent in OpenSolar, pricing updates in Pipereply. When a customer signs, the job flows to Simpro. When an installer completes work, the CRM reflects it instantly. No double-entry. No synchronisation delays. No data inconsistencies.

Solar AI-Q Hub doesn't just connect systems - it orchestrates complex solar business workflows with industry-specific intelligence built in:

Australian STC/BSTC pricing calculations
Multi-option proposal handling
Installer assignment routing
State rebate detection
Equipment categorisation rules
Technical Architecture
Modern, Cloud-Native Stack
Application Layer:
  • FastAPI (Python 3.11+) - High-performance async web framework, 3x faster than traditional Flask/Django
  • SQLAlchemy 2.0 - Modern ORM with async support and type safety
  • Pydantic v2 - Runtime validation, 17x faster than v1, ensures data integrity at every boundary
Infrastructure:
  • PostgreSQL 15 - Industry-standard relational database with JSONB for flexible config storage
  • Railway - Zero-downtime deployments, automatic SSL, built-in observability
  • Git-based CI/CD - Every commit triggers automated testing and deployment
Security & Reliability:
  • Fernet encryption (AES-128 with HMAC SHA-256) for all API keys and secrets at rest
  • OAuth 2.0 token management with automatic refresh
  • Webhook signature validation on all inbound requests
  • Structured JSON logging for full audit trails and compliance
  • Exponential backoff retry logic for transient failures
  • Per-client database isolation for data sovereignty
Why This Stack Is Cutting-Edge
01
Async-First Architecture

Traditional integration platforms block on I/O operations. Solar AI-Q Hub uses Python's native async/await to handle thousands of concurrent API calls without thread overhead. When processing a proposal sent event, the platform simultaneously: fetches project data from OpenSolar, queries Pipereply for the matching opportunity, extracts pricing with STC calculations, updates CRM fields, and logs the transaction. All in parallel, completing in milliseconds instead of seconds.

02
Type-Safe at Every Layer

From API request validation (Pydantic schemas) through business logic (Python type hints) to database queries (SQLAlchemy typed mappings), the entire stack prevents runtime type errors. This means: API payload changes are caught immediately, refactoring is safe and automated, and integration bugs are found at compile-time, not in production.

03
Event-Driven by Design

Rather than polling for changes (expensive, slow, rate-limited), Solar AI-Q Hub receives webhook events the instant something happens: OpenSolar proposal accepted → Pipereply opportunity won (< 500ms). No polling delays. No API rate limit concerns. No missed updates. The platform processes events idempotently - the same event can be received multiple times without causing duplicate updates.

04
Multi-Tenant with Database-Per-Client

Unlike shared-database SaaS platforms, each Solar AI-Q Hub client gets their own isolated PostgreSQL database: Data sovereignty - Your data never mixes with competitors. Custom schemas - Client-specific fields without schema conflicts. Performance isolation - One client's data volume doesn't slow down others. Compliance-ready - Meets data residency requirements for government contracts. A central registry database routes requests to the correct client database in microseconds using connection pooling.

01
Observable & Debuggable

Every integration event is logged in exhaustive detail: Inbound webhooks (full payload, processing status, duration), outbound API calls (request/response, status codes, retry attempts), error traces with full context (which client, which opportunity, which field), and Slack notifications for failures with actionable diagnostics. When something goes wrong, you have a complete forensic trail. When something goes right, you can measure exactly how fast it happened.

02
Retry-First Error Handling

Solar AI-Q Hub treats external APIs as unreliable by default: Automatic retries with exponential backoff (5s → 30s → 2min), persistent retry queue for failed webhooks, manual retry admin endpoints for bulk recovery, and graceful degradation (log and notify, don't crash). If OpenSolar returns a 500 error, the platform doesn't lose the event - it retries intelligently until success or exhausts attempts, then alerts you.

03
Developer Velocity

The FastAPI + SQLAlchemy stack enables rapid development: Auto-generated API documentation (OpenAPI/Swagger) from code, database migrations with rollback (Alembic) for schema changes, hot reload in development - code changes reflect instantly, and Python's extensive ecosystem - 400,000+ packages for any integration need. New integrations (SpendWatt, Simpro) can be added in days, not months.

Security Features
Encryption & Secrets Management
  • API keys encrypted at rest using Fernet (AES-128-CBC with HMAC-SHA256)
  • Secrets never logged - automatic redaction in logs and error traces
  • Environment-based key management - no secrets in code or Git
  • Per-integration credential isolation - OpenSolar breach doesn't expose Simpro keys
Access Control
  • Webhook signature validation - 256-bit secrets prevent replay attacks
  • OAuth token rotation - automatic refresh before expiration
  • IP allowlisting (optional) - restrict webhook origins
  • Admin endpoints require authentication - no public mutation endpoints
Compliance & Audit
  • Immutable webhook logs - every inbound event permanently recorded
  • Full API call audit trail - request/response/duration/status for every external call
  • GDPR-ready - client data isolation supports right-to-deletion
  • Timestamp precision - all events recorded in UTC with millisecond accuracy
Operational Security
  • Zero-downtime deployments - Railway blue-green deploys with health checks
  • Automatic SSL/TLS - Let's Encrypt certificates with auto-renewal
  • Rate limiting - protection against webhook floods or API abuse
  • Database backups - continuous WAL archiving with point-in-time recovery
Why It Matters for Solar Companies
Scale Without Breaking

Traditional integration platforms (Zapier, Integromat, Retool) hit walls at scale:

Rate limits

Zapier throttles at 100 requests/15 minutes

Execution time limits

Retool workflows timeout after 5 minutes

Cold starts

Serverless platforms add 500ms+ latency on first request

Vendor lock-in

Proprietary workflow builders with no export path

Solar AI-Q Hub is built for 2500+ clients processing millions of events per month with:

  • Sub-100ms p50 response times
  • No hard rate limits (only external API constraints)
  • Self-hosted control (your code, your infrastructure)
  • Pure Python (portable, maintainable, auditable)

Industry-Specific Intelligence

Generic integration platforms treat all data the same. Solar AI-Q Hub understands:

STC/BSTC pricing rules

Automatic extraction and calculation

Multi-system proposals

Handling 3 quote options with varying equipment

Installer workflows

Routing jobs to licensed contractors by region

State rebate schemes

Detecting and categorising state incentives

Equipment compatibility

Validating inverter/panel/battery combinations

This domain knowledge prevents data corruption (e.g., treating STCs as regular discounts) and enables intelligent automation.

Cost Efficiency

Replacing Zapier/Make with Solar AI-Q Hub:

No per-task fees

Unlimited workflows at fixed infrastructure cost

No user seat limits

Your entire team has access

No "premium connector" surcharges

Build any integration you need

Predictable scaling

Pipereply charges for resources used, not event volume

At 1,000 opportunities/month processing 3 webhook events each (sent, viewed, accepted):

Zapier

3,000 tasks × $0.03 = $90/month

Plus $20/seat for 5 users = $190 total

Solar AI-Q Hub

Included in the standard Solar AI-Q CRM Subscription, no additional costs.


Built for the Future

Solar AI-Q Hub's architecture supports:

  • New integrations - SpendWatt, Pylon, OpenSolar, Simpro, ServiceM8, Aroflo, all major lead providers
  • AI enhancements - GPT-4 analysis of proposal success patterns
  • Custom workflows - client-specific business rules without core changes
  • White-label deployment - run dedicated instances for enterprise clients
  • International expansion - multi-currency, multi-region, multi-language ready

The platform isn't just faster than legacy integrations - it's fundamentally more capable, built on technology choices that will remain cutting-edge for the next decade.

Technology Summary
The Result
Solar AI-Q Hub transforms solar business operations from fragmented, error-prone manual processes into a seamless, automated, audit-ready system that scales with your growth.

Your team focuses on selling solar. The platform handles the data.


Want to see it in action?

Contact Pipereply for a technical deep-dive and integration roadmap for your solar business.