Welcome to the authoritative source of truth for the Salesforce Platform Architect Portfolio. This documentation is version-controlled and deployed directly from the codebase.
1. Operational Guides
Target Audience: Stakeholders, Recruiters, Ops Team
| Artifact | Purpose |
|---|---|
| 01. Executive Overview | Business value, “Definition of Done”, and ROI analysis. |
| 02. Program Charter | Scope, timeline, user stories, and acceptance criteria. |
| 03. Systems Architecture (SAS) | The “North Star” architecture, data models, and integration patterns. |
| 04. Technical Guide | Implementation details for LWC, Apex, and CI/CD. |
| 05. Maintenance Guide | Operations, rotation policies, and disaster recovery. |
| 06. Guardrails & Governance | Automated quality gates and compliance rules. |
2. Architectural Decision Records (ADRs)
Target Audience: Architects, Developers
[!NOTE] ADRs are immutable records of significant design choices. They capture the context and consequences of decisions.
Core Platform & UI
- ADR-001: Experience Cloud LWR vs. Aura
- ADR-002: Custom Objects vs. Standard Objects
- ADR-004: Static Resource Code Rendering
- ADR-005: Gamified Testimonial UI
- ADR-009: Granular Resume Data Model
- ADR-010: Visualization Engine (Vis.js vs. AntV G6)
- ADR-020: Mobile Performance (SVG Fallback)
- ADR-021: Native GraphQL vs. Apex REST
- ADR-023: Client-Side PDF Generation
Integration & Security
- ADR-003: Apex REST vs. External Service
- ADR-006: JWT Bearer Flow for CI/CD
- ADR-007: GitHub API Server-Side Caching
- ADR-008: Jira Integration vs. Agile Accelerator
- ADR-012: Guest User Security (Restriction Rules)
- ADR-017: System API Security & Dual-Sided Auth
- ADR-024: Twin API Pattern
- ADR-025: PAPI Fan-Out & Throttling
- ADR-026: Header-Based API Versioning
AI, Data & FinOps
- ADR-011: Context Grounding Strategy
- ADR-013: Structured Logging (Nebula)
- ADR-014: Deferred Telemetry Loading
- ADR-015: Strategy Pattern for GenAI
- ADR-016: Cloudflare Worker as Edge Proxy
- ADR-018: FinOps (Lambda URLs vs. API Gateway)
- ADR-019: Executable Governance (Platform Events)
- ADR-022: Resilience Engineering (Chaos Toggle)
3. API Specifications (OAS)
Target Audience: Integration Consumers
- Salesforce System API (SAPI) - Core Data Layer
- Portfolio Process API (PAPI) - Orchestration Layer