Skip to content

01. Master Blueprint: System Architecture & Entry Point

Status: Active / Golden (Entry Point) Version: 1.1 (Reconciled Jan 2026)

"The definitive entry point for the Singular Dream platform's architecture. Use this as your map before diving into the specialized Domain and Capability manuals."

1. System Metaphor: Layered Service Architecture

The platform is organized into a Forensic Service Architecture. Dependencies strictly flow downward. This ensures that core infrastructure (Foundation) is never polluted by business logic (Modules), and that generic horizontal logic (Unified) remains reusable.

🏛️ Layer 1: Business Partitions (The Verticals)

Source: packages/modules/* These are the business domains containing logic unique to community operations. - Reference: See 03_DOMAIN_ATLAS.md for detailed logic for Property, Governance, Operations, and Finance.

🌉 Layer 2: Unified Core (The Horizontals)

Source: packages/modules/unified/* Generic capabilities that integrate different Layer 1 processes (e.g., Search, Workflow, Audit). - Reference: See 03_DOMAIN_ATLAS.md Section 5.

🧱 Layer 3: Foundation (The Infrastructure)

Source: packages/foundation/* Agnostic plumbing and technical abstraction (Database, Auth, Storage). - Reference: See 04_INFRASTRUCTURE_OPS.md.

2. Capability Model: The "Big Four"

We group technical modules into four primary commercial value pillars. - Reference: For the full, audited functional matrix of all 200+ features, see 06_PRODUCT_CAPABILITIES.md.

  1. Property Registry: The "Digital Twin" and Single Source of Truth for assets.
  2. Digital Democracy: Remote, weighted voting and owner oversight.
  3. Operations Machine: Converting decisions into physical service execution.
  4. Financial Engine: Automated dues, assessments, and double-entry ledger.

3. The Identity Model: Contextual Persona

We do not use flat "Roles." We use a Context-Aware Persona Model. A user is defined by their Relationship to a physical asset or legal entity in the Directory.

  • Hat (Persona): Who am I acting as? (Owner, Board Member, Vendor).
  • Scope: What is my radius? (My Unit vs. The Building).
  • Asset: What is the target? (Unit 102, Main Pump).

Standard 60 (The Pivot Shell): The UI automatically provides the correct forensic lens (People, Assets, Services) for the current context.

4. Operational Strategy