<!-- https://unlockos.io/manual/member-spacecard -->

# SpaceCard Help

## Overview

A SpaceCard is the check-in entry point shown on the Home screen. One card is displayed per facility space linked to your membership plan. Each card shows the space's image, name, and remaining quota, and lets you start a check-in session with a single tap.

---

## Detailed Features

## Feature 1: Reading a SpaceCard

Each SpaceCard contains the following information.

| Item | Description |
|------|-------------|
| Image area | Photos uploaded by the facility, or an auto-generated illustration based on the space name |
| Space name | The name of the check-in space (e.g., Meeting Room A, Fitness Studio) |
| Plan name | The membership plan linked to this space |
| Quota | Remaining usage count when a limit applies (e.g., 3/10 used) |
| Check-in button | **Check in here** — tap to start a check-in session |

## Feature 2: Browsing Images

If the facility has uploaded multiple photos for a space, you can swipe left or right in the image area to browse them.

- When real photos are available, tapping an image opens it in a lightbox for a full-screen view
- If no photos have been uploaded, an auto-generated color illustration based on the space name is shown instead

## Feature 3: Starting a Check-in

Tap the **Check in here** button to start a check-in session.

### Check-in flow

1. Tap the button (it is temporarily disabled while processing)
2. After a successful check-in, the entry key (QR code) is automatically shown in a popup
3. The session panel appears at the top of the Home screen and a timer begins counting

### When check-in is not possible

The button is disabled or unresponsive in the following situations:

| Situation | What to do |
|-----------|-----------|
| Already checked in | Check out of your current session first |
| Check-in in progress | Wait for the current process to complete |
| Session restoring | Wait for the app to finish loading |

## Feature 4: Checking Your Quota

If the plan has a monthly check-in limit, the card shows "XX/YY used" to indicate how many check-ins you have remaining.

- Plans without a limit do not show a quota indicator
- Attempting to check in after reaching the limit will display an error

---

## Frequently Asked Questions

### Q: No SpaceCards are shown

Possible reasons:

- Your membership plan is not linked to any facility spaces (contact the facility)
- Your membership is not active (check your status on My Page)
- The facility has not configured check-in settings (contact the facility)

### Q: I checked in but the entry key did not appear

In the session panel on the Home screen, tap **Show QR** to display the key again.

### Q: A "Quota exceeded" error prevents check-in

You have used all your check-ins for this month. The quota resets at the start of the next billing period. Contact the facility if you need a quota adjustment.

### Q: The image doesn't match the space name

The images reflect what the facility has uploaded. If you notice an error, please let the facility know.

---

## Troubleshooting

### Tapping "Check in here" does nothing

- Check your network connection
- Reload the page and try again
- If the issue persists, contact the facility

### The entry key has expired

Tap the refresh button inside the **Show QR** modal to get a new key. The key is also refreshed automatically when it is close to expiry.

---

## Related Pages

- [Home Screen](member-home.md)
- [Signup](member-signup.md)
- [My Page](member-mypage.md)
- [Time Slot Booking (Member)](timeslot-booking-member.md)
