Backend-First State Audit - Session 136

Audit Results

Already Backend-First (Good)

Local-Only (Need Backend Wiring)

Pattern to Follow

Each local-only tool should implement the Session 129 pattern:

@Injectable({ providedIn: 'root' })
export class ExampleApiService {
  private readonly http = inject(HttpClient);
  private readonly apiBaseUrl = inject(API_BASE_URL);
  
  // Backend data in a SEPARATE signal (not autoFlashState)
  private readonly _backendData = signal<MyData | null>(null);
  
  // Local state can still use autoFlashState for offline/optimistic UI
  private readonly _localState = autoFlashState<MyData>('example-key', defaultValue);
  
  // Merged view: backend takes priority
  readonly data = computed(() => {
    const backend = this._backendData();
    const local = this._localState();
    return backend ?? local;
  });
  
  loadFromBackend(): Observable<MyData> {
    return this.http.get<MyData>(`${this.apiBaseUrl}/endpoint`).pipe(
      tap(data => this._backendData.set(data))
    );
  }
  
  saveToBackend(data: MyData): Observable<MyData> {
    return this.http.put<MyData>(`${this.apiBaseUrl}/endpoint`, data).pipe(
      tap(saved => {
        this._backendData.set(saved);
        this._localState.set(saved); // Keep local in sync
      })
    );
  }
}

Priority Order for Wiring

1. flow-engine-lib - Model citizen (Phase 2 already started this)
2. universe-canvas - Most impactful (canvas state = platform structure)
3. universe-explorer - Architect state maps to universe structure
4. modularity-lib ModuleStorageService - Module context should persist
5. modular-universe - Module installation data

Existing Backend Endpoints Available

All needed endpoints already exist in backend-api:

No new backend endpoints are needed. The gap is purely on the frontend: services need to be updated to call these endpoints instead of (or in addition to) local storage.