Design Principles

The Advisor Console is built on principles that prioritize advisor productivity, system reliability, and seamless integration with existing workflows.

1. Single Interface, Zero Context Switching

Advisors should never need to leave the console. Research, communication, CRM access, and booking hand-off all happen in one place. Every feature is designed to reduce tab-switching and tool-juggling.

2. Salesforce UI Bundle Deployment

The console deploys as metadata within the SFDX project. This eliminates adoption friction: the advisor experience lives where advisors already work. No separate hosting, no separate authentication.

3. AI-Augmented, Not AI-Replaced

The AI assistant handles research and drafting. The advisor makes decisions. The console surfaces information and suggestions; advisors retain full control over client relationships.

4. Graceful Fallback Chain

The system works without any API keys. Direct API calls fall back to SDK calls, which fall back to mocked data. Advisors always get results, even during outages.

5. Channel-Agnostic Communication

The inbox normalizes messages from all channels into a common schema. Advisors see conversations, not channels. The underlying platform is an implementation detail.

6. Type-Safe Data Access

GraphQL UIAPI provides type-safe queries against Salesforce. No string-based SOQL in the frontend. Schema introspection catches errors at build time, not runtime.

7. Offline-Capable Persistence

Chat history and session state persist in IndexedDB. Advisors can close the browser and pick up where they left off. No data loss on refresh or session timeout.

8. Component-Driven Development

25 reusable shadcn/ui components built on Radix primitives. Full control over styling with Tailwind CSS. No vendor lock-in to a component library.

9. Platform-First, API-Driven

Each new vertical (dining, hotels, flights) is a new adapter, not a rebuild. The console consumes APIs; the APIs define the capabilities.

10. Minimal Surface Area

The console does only what advisors need. It does not handle payment, booking confirmation, or itinerary generation. Those responsibilities stay with Atlantes.