Skip to content

System Landscape & Topology

1. The 4-Tier Environment Model (ISO-SD-2026)

The Singular Dream platform operates on a strictly defined 4-Tier Topology. This model ensures that every change is verified in a safe environment before reaching production users.

Tier Environment Name Branch Project ID Database ID Purpose Access Control
1 WORKBENCH LOC/... singular-dream-dev (default) Rapid iteration, unit logic. Local Machine
2 INTEGRATION tst singular-dream-dev singular-dream-tst System integration. Engineering
3 STAGING stg singular-dream-dev singular-dream-stg UAT, Pile Review. Stakeholders
4 PRODUCTION main singular-dream (default) Live system. End Users

2. Resource Naming Conventions

To prevent "drift" and accidental data pollution, all infrastructure resources MUST adhere to the Suffix Strategy.

A. Infrastructure Projects (Vercel, Firebase)

  • Structure: [project-name]-[env-suffix]
  • Examples:
  • singular-dream-dev (Hosts Work-in-Progress, Tst, and Stg)
  • singular-dream (Production Isolated)

B. Databases (SQL/NoSQL)

  • Structure: Standard Identifier (No internal prefix)
  • Rationale: The database lives inside the project container. We do not name a table DEV_USERS inside the singular-dream-dev project.
  • Example: users collection in singular-dream-dev project.

3. The "Golden Path" (CI/CD)

Resources flow in one direction only.

graph LR
    A[Tier 1: WORKBENCH] -->|Commit| B[Tier 2: INTEGRATION]
    B -->|Automated Tests| B
    B -->|Release Candidate| C{Tier 3: STAGING}
    C -->|UAT & Performance| C
    C -->|Approval| D[Tier 4: PRODUCTION]

Gate Definitions

  • Commit Gate: Local linting and type-checking (Husky).
  • Staging Gate (stg): This is a Place, not an activity.
  • Activity: Automated Testing (stg pipeline)
  • Activity: Preview Deployment (stg URL)
  • Activity: Manual QA
  • Production Gate (main): The Final State. Merging here triggers immediate deployment to Live.

Version History

Version Date Author Change
0.2.0 2026-02-09 Antigravity Re-aligned to Two-Project Infrastructure Model
0.1.0 2026-01-26 Antigravity Initial Audit & Metadata Injection