managarten/memoro/apps/mobile/docs/SPACES_TESTING.md

# Memoro Spaces Testing Guide

This guide outlines the steps to test the spaces functionality in the Memoro app.

## Test Environment Setup

Before testing, ensure you have:
- A development build of the Memoro app running
- At least one test user account
- A few test memos created

You can enable mock data for testing without a backend by setting the environment variable:
```
EXPO_PUBLIC_USE_MOCK_DATA=true
```

## Testing Areas

### 1. Spaces List View

#### Create a New Space
- Navigate to the Spaces tab
- Tap "Create New Space" button
- Enter a space name (e.g., "Test Space")
- Tap "Create"
- **Expected**: A new space should appear in the list

#### Space List Display
- Check that the spaces list shows:
  - Space name
  - Description (if any)
  - Color indicator
  - Memo count
- **Expected**: All spaces should be listed with correct information

#### Delete a Space
- Long press or tap on a space to open the action menu
- Select "Delete" from the menu
- Confirm deletion in the alert dialog
- **Expected**: 
  - A confirmation dialog should show the space name
  - After confirmation, the space should be removed from the list
  - Success message should appear

### 2. Space Detail View

#### Navigate to Space Detail
- Tap on a space in the spaces list
- Select "View Details" from the menu
- **Expected**: Space detail screen should open showing space information

#### Space Information Display
- Check that the space detail view shows:
  - Space name
  - Description
  - Color indicator
  - Memo count
- **Expected**: All information should be displayed correctly

#### View Memos in a Space
- Scroll down to see the "Memos in this Space" section
- **Expected**: All memos associated with the space should be listed
- **Expected**: If no memos are associated, an appropriate message should be shown

#### Add New Memo to Space
- Tap "Create New Memo" button
- **Expected**: Navigation to memo creation screen
- **Note**: This may not be fully implemented yet

### 3. Memo-Space Management

#### Link a Memo to Spaces
- Navigate to a memo detail view
- Tap the menu (three dots) icon
- Select "Manage Spaces" from the menu
- Check/uncheck spaces to link/unlink the memo
- Tap "Save"
- **Expected**: 
  - Space selector modal should open showing all available spaces
  - Spaces should be checkable/uncheckable
  - After saving, changes should persist

#### Unlink a Memo from Spaces
- Navigate to a memo detail view
- Tap the menu icon
- Select "Manage Spaces"
- Uncheck a currently checked space
- Tap "Save"
- **Expected**: The memo should no longer be associated with the unchecked space

#### Verify Space-Memo Relationships
- Link a memo to a space
- Navigate to that space's detail view
- **Expected**: The linked memo should appear in the space's memo list
- Unlink the memo from the space
- **Expected**: The memo should no longer appear in the space's memo list

### 4. Error Handling

#### Network Errors
- Turn off internet connection
- Attempt to create a space or link a memo to a space
- **Expected**: Appropriate error message should be displayed
- **Expected**: The app should not crash

#### Invalid Operations
- Try to delete a space that has memos (if that's restricted)
- **Expected**: Appropriate warning or confirmation message

#### Recovery from Errors
- Cause an error (e.g., by network disconnect)
- Restore connectivity
- Retry the operation
- **Expected**: Operation should succeed after retry

## Edge Cases

### Space with Many Memos
- Create a space
- Link 10+ memos to it
- View the space detail
- **Expected**: All memos should load and display correctly

### Long Names and Descriptions
- Create a space with a very long name (>50 characters)
- Add a long description (>200 characters)
- View in both list and detail views
- **Expected**: Text should be properly truncated or wrapped

### Empty States
- Delete all spaces
- Check spaces list
- **Expected**: An appropriate "no spaces" message should be displayed
- Create a space with no memos
- View space detail
- **Expected**: An appropriate "no memos" message should be displayed

## Known Limitations

- Mock data mode does not fully simulate the linking/unlinking behavior
- Some UI elements may not be fully responsive on all device sizes
- Space deletion might not properly handle linked memos in some edge cases

## Reporting Issues

If you encounter any issues during testing, please document:
1. The steps to reproduce the issue
2. What you expected to happen
3. What actually happened
4. Any error messages displayed
5. Screenshots if applicable

Report these issues to the development team via the project management system.