Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions docs/api-specs/class-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -600,20 +600,26 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접

### 5.3 클래스 명단
- `GET /api/v1/classes/{classId}/members`
- 운영자 행이 먼저 오고, 이후 참여 순이다.
- 운영자 행이 먼저 오고, 이후 참여 순이다 (운영자, 참여자1, 참여자2 …).
- 운영자가 참여하지 않는 클래스(`ownerParticipates=false`)는 보는 사람에 따라 다르다.
- 운영자 본인이 보면 맨 위에 운영자 줄이 붙는다: `memberId` 0, `me` true, `participating` false, 이름은 운영자 닉네임, `joinedAt`은 클래스 생성 시각.
- 참여자가 보면 운영자 줄 없이 참여자만 나온다.
- 미참여 운영자 줄은 표시 이름이 없어서 이름 수정(5.4)은 403이다. 앱은 `participating`이 false면 연필 버튼을 숨긴다.
- 미참여 운영자 줄은 좌석(`memberCount`)·명단 인원(`activeMemberCount`)·결과 통계에 들어가지 않는다.
- 표시 이름·역할·아바타만 내려가고 계정 식별자는 내려가지 않는다.

```json
{
"statusCode": 200,
"data": [
{ "memberId": 10, "displayName": "김선생", "role": "OWNER", "characterUrl": "https://...", "me": true, "joinedAt": "2026-10-21T10:00:00" },
{ "memberId": 11, "displayName": "김학생", "role": "MEMBER", "characterUrl": "https://...", "me": false, "joinedAt": "2026-10-21T11:00:00" }
{ "memberId": 10, "displayName": "김선생", "role": "OWNER", "characterUrl": "https://...", "me": true, "joinedAt": "2026-10-21T10:00:00", "participating": true },
{ "memberId": 11, "displayName": "김학생", "role": "MEMBER", "characterUrl": "https://...", "me": false, "joinedAt": "2026-10-21T11:00:00", "participating": true }
]
}
```

- `memberId`: 내보내기(5.6)에 쓴다.
- `memberId`: 내보내기(5.6)에 쓴다. 미참여 운영자 줄은 0이다(내보내기 대상 아님).
- `participating`: 토론에 참여하는 사람이면 true다. 운영자에게만 보이는 미참여 운영자 줄만 false다.
- `characterUrl`: 회원 캐릭터 이미지 URL이다. 프로필이 없으면 null이다.
- `me`: 조회한 사람 본인이면 true다 (이름 수정 버튼 노출용).
- 권한이 없으면 403 `CLASS_403_MEMBER`다.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,16 @@

import com.swyp.picke.domain.classroom.dto.response.ClassMemberResponse;
import com.swyp.picke.domain.classroom.entity.ClassMember;
import com.swyp.picke.domain.classroom.entity.Classroom;
import com.swyp.picke.domain.classroom.enums.ClassMemberRole;
import com.swyp.picke.domain.user.entity.User;
import java.util.Objects;

public final class ClassMemberConverter {

/** 미참여 운영자 줄의 memberId. 실제 멤버십 ID 는 1부터라 겹치지 않는다 */
public static final long NON_PARTICIPATING_OWNER_MEMBER_ID = 0L;

private ClassMemberConverter() {
}

Expand All @@ -19,7 +24,27 @@ public static ClassMemberResponse toResponse(ClassMember member, Long viewerId,
member.getRole(),
avatarUrl,
Objects.equals(user.getId(), viewerId),
member.getJoinedAt()
member.getJoinedAt(),
true
);
}

/**
* 참여하지 않는 운영자(ownerParticipates = false)는 멤버 행이 없지만, 운영자 본인이 명단을 볼 때는 맨 위에 보여준다 (#665).
* 앱이 memberId 를 필수 값으로 읽어서 null 대신 {@link #NON_PARTICIPATING_OWNER_MEMBER_ID} 를 쓴다.
* 좌석·명단 인원·결과 통계에는 들어가지 않는다.
*/
public static ClassMemberResponse toNonParticipatingOwner(Classroom classroom, String avatarUrl) {
User owner = classroom.getOwner();
String nickname = owner.getNickname() == null || owner.getNickname().isBlank() ? "운영자" : owner.getNickname().strip();
return new ClassMemberResponse(
NON_PARTICIPATING_OWNER_MEMBER_ID,
nickname,
ClassMemberRole.OWNER,
avatarUrl,
true,
classroom.getCreatedAt(),
false
);
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,12 @@
/** 명단 화면(S12)용. 계정 식별자(userId·태그)는 내려가지 않고 클래스 안의 표시 이름만 보인다. */
@Schema(description = "클래스 멤버")
public record ClassMemberResponse(
@Schema(description = "멤버십 ID (내보내기 등 멤버 단위 작업에 쓴다)") Long memberId,
@Schema(description = "멤버십 ID (내보내기 등 멤버 단위 작업에 쓴다). 참여하지 않는 운영자 줄은 0") long memberId,
@Schema(description = "클래스 안에서 보이는 이름") String displayName,
@Schema(description = "역할 (OWNER / MEMBER)") ClassMemberRole role,
@Schema(description = "아바타 이미지 URL") String characterUrl,
@Schema(description = "조회한 사람 본인이면 true (연필 버튼 노출용)") boolean me,
@Schema(description = "참여 시각") LocalDateTime joinedAt
@Schema(description = "참여 시각. 참여하지 않는 운영자 줄은 클래스 생성 시각") LocalDateTime joinedAt,
@Schema(description = "토론에 참여하는 사람이면 true. 운영자 본인에게만 보이는 미참여 운영자 줄은 false") boolean participating
) {
}
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
import com.swyp.picke.global.common.exception.ErrorCode;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
Expand Down Expand Up @@ -140,13 +141,25 @@ public List<ClassMemberResponse> getMembers(Long userId, Long classId) {
throw new CustomException(ErrorCode.CLASS_MEMBER_ONLY);
}
List<ClassMember> members = classMemberRepository.findActiveMembers(classId);
Map<Long, CharacterType> characters = userProfileRepository.findAllByUserIdIn(
members.stream().map(m -> m.getUser().getId()).toList()).stream()
Long ownerId = classroom.getOwner().getId();
// 미참여 운영자 줄은 운영자 본인에게만 보인다. 참여자 명단에는 참여자만 나온다 (#665)
boolean addOwnerRow = Objects.equals(ownerId, userId)
&& members.stream().noneMatch(m -> Objects.equals(m.getUser().getId(), ownerId));
List<Long> userIds = new ArrayList<>(members.stream().map(m -> m.getUser().getId()).toList());
if (addOwnerRow) {
userIds.add(ownerId);
}
Map<Long, CharacterType> characters = userProfileRepository.findAllByUserIdIn(userIds).stream()
.collect(Collectors.toMap(p -> p.getUser().getId(), UserProfile::getCharacterType, (a, b) -> a));
return members.stream()
.map(m -> ClassMemberConverter.toResponse(m, userId,
imageUrls.avatar(characters.get(m.getUser().getId()))))
.toList();

List<ClassMemberResponse> result = new ArrayList<>();
if (addOwnerRow) {
result.add(ClassMemberConverter.toNonParticipatingOwner(classroom,
imageUrls.avatar(characters.get(ownerId))));
}
members.forEach(m -> result.add(ClassMemberConverter.toResponse(m, userId,
imageUrls.avatar(characters.get(m.getUser().getId())))));
return result;
}

@Override
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -469,6 +469,117 @@ void removeActiveMember_keepsSeat_butActiveMemberCountDrops() throws Exception {
.andExpect(jsonPath("$.data.activeMemberCount").value(2));
}

@Test
@DisplayName("운영자 참여: 생성 1/1 → 2명 참여 3/3 → 무활동 나가기 2/2 → 활동 후 나가기 2/1")
void counts_ownerParticipates() throws Exception {
assertCountsFlow(true);
}

@Test
@DisplayName("운영자 미참여: 생성 0/0 → 2명 참여 2/2 → 무활동 나가기 1/1 → 활동 후 나가기 1/0")
void counts_ownerNotParticipates() throws Exception {
assertCountsFlow(false);
}

/** memberCount(사용 좌석) / activeMemberCount(명단) 를 상세·목록·참여 확인·명단 API 에서 모두 확인한다 */
private void assertCountsFlow(boolean ownerParticipates) throws Exception {
int o = ownerParticipates ? 1 : 0;
ClassInfo cls = createClass(ownerParticipates);
assertCounts(cls, o, o);

User quiet = newUser("조용학생");
User active = newUser("활동학생");
join(tokenOf(quiet), cls.inviteCode, "조용학생").andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(o + 1))
.andExpect(jsonPath("$.data.activeMemberCount").value(o + 1));
join(tokenOf(active), cls.inviteCode, "활동학생").andExpect(status().isOk());
assertCounts(cls, o + 2, o + 2);

// 활동 없이 나가면 좌석도 돌려준다
mockMvc.perform(delete("/api/v1/classes/" + cls.classId + "/members/me")
.header("Authorization", "Bearer " + tokenOf(quiet)))
.andExpect(status().isOk());
assertCounts(cls, o + 1, o + 1);

// 사전투표 후 나가면 좌석은 남고 명단만 줄어든다
userBattleRepository.save(UserBattle.builder().user(active).battle(battle)
.classroom(classroomRepository.findById(cls.classId).orElseThrow())
.step(UserBattleStep.TTS_LISTENING).build());
mockMvc.perform(delete("/api/v1/classes/" + cls.classId + "/members/me")
.header("Authorization", "Bearer " + tokenOf(active)))
.andExpect(status().isOk());
assertCounts(cls, o + 1, o);
}

@Test
@DisplayName("운영자 참여: 명단은 운영자, 참여자1, 참여자2 순서 (#665)")
void members_ownerFirst_participating() throws Exception {
assertOwnerFirst(true);
}

@Test
@DisplayName("운영자 미참여: 운영자가 보면 맨 위에 운영자 줄(memberId 0, participating false), 참여자가 보면 참여자만 (#665)")
void members_ownerFirst_notParticipating() throws Exception {
assertOwnerFirst(false);
}

private void assertOwnerFirst(boolean participates) throws Exception {
ClassInfo cls = createClass(participates);
User first = newUser("참여자1");
User second = newUser("참여자2");
join(tokenOf(first), cls.inviteCode, "참여자1").andExpect(status().isOk());
join(tokenOf(second), cls.inviteCode, "참여자2").andExpect(status().isOk());

// 운영자가 보면 항상 운영자, 참여자1, 참여자2
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + ownerToken))
.andExpect(status().isOk())
.andExpect(jsonPath("$.data", hasSize(3)))
.andExpect(jsonPath("$.data[0].role").value("OWNER"))
.andExpect(jsonPath("$.data[0].displayName").value("선생님"))
.andExpect(jsonPath("$.data[0].me").value(true))
.andExpect(jsonPath("$.data[0].participating").value(participates))
.andExpect(participates
? jsonPath("$.data[0].memberId").value(memberIdOf(cls.classId, owner))
: jsonPath("$.data[0].memberId").value(0))
.andExpect(jsonPath("$.data[1].displayName").value("참여자1"))
.andExpect(jsonPath("$.data[1].participating").value(true))
.andExpect(jsonPath("$.data[2].displayName").value("참여자2"));

// 참여자가 보면: 운영자 참여 시 운영자 포함 3명, 미참여 시 참여자 2명만
if (participates) {
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + tokenOf(first)))
.andExpect(jsonPath("$.data", hasSize(3)))
.andExpect(jsonPath("$.data[0].role").value("OWNER"))
.andExpect(jsonPath("$.data[0].me").value(false))
.andExpect(jsonPath("$.data[1].me").value(true));
} else {
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + tokenOf(first)))
.andExpect(jsonPath("$.data", hasSize(2)))
.andExpect(jsonPath("$.data[0].displayName").value("참여자1"))
.andExpect(jsonPath("$.data[0].me").value(true))
.andExpect(jsonPath("$.data[1].displayName").value("참여자2"))
.andExpect(jsonPath("$.data[?(@.role == 'OWNER')]", hasSize(0)));
}

// 멤버 수는 그대로 (미참여 운영자 포함 여부는 기획 확인 대기)
mockMvc.perform(get("/api/v1/classes/" + cls.classId).header("Authorization", "Bearer " + ownerToken))
.andExpect(jsonPath("$.data.activeMemberCount").value(participates ? 3 : 2));
}

private void assertCounts(ClassInfo cls, int seats, int activeMembers) throws Exception {
mockMvc.perform(get("/api/v1/classes/" + cls.classId).header("Authorization", "Bearer " + ownerToken))
.andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(seats))
.andExpect(jsonPath("$.data.activeMemberCount").value(activeMembers));
mockMvc.perform(get("/api/v1/classes").header("Authorization", "Bearer " + ownerToken))
.andExpect(jsonPath("$.data[0].memberCount").value(seats))
.andExpect(jsonPath("$.data[0].activeMemberCount").value(activeMembers));
preview(tokenOf(newUser("확인학생")), cls.inviteCode)
.andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(seats))
.andExpect(jsonPath("$.data.activeMemberCount").value(activeMembers));
}

// ===== 헬퍼 =====

private record ClassInfo(long classId, String inviteCode) {
Expand Down
Loading