memi-board 0.22.0 → 0.23.0

package/dist/runtime/components/Attachments.vue

@@ -5,7 +5,6 @@ import { useMemiBoardStorage } from 'memi-board/runtime'
 
 const props = withDefaults(defineProps<{
   modelValue: Attachment[]
-  boardId: string
   /** 새 글 작성 중에도 미리 생성한 Firestore 자동 ID를 넘긴다. */
   postId: string
   editable?: boolean
@@ -44,7 +43,7 @@ async function onFileInputChange(e: Event) {
     const uploaded: Attachment[] = []
     for (const file of toUpload) {
       uploadProgress.value = 0
-      const { promise } = uploadAttachment(file, props.boardId, props.postId, (ratio) => {
+      const { promise } = uploadAttachment(file, props.postId, (ratio) => {
         uploadProgress.value = ratio
       })
       uploaded.push(await promise)

package/dist/runtime/components/CommentItem.vue

@@ -130,18 +130,19 @@ async function toggleBlind() {
     <div class="min-w-0 flex-1">
       <div class="flex items-center gap-2">
         <span class="text-sm font-medium">{{ comment.authorName ?? '익명' }}</span>
-        <UTooltip
-          :delay-duration="0"
-          :text="timestampDetails"
-          :ui="{ content: 'h-auto w-max py-2', text: 'whitespace-pre-line overflow-visible' }"
-        >
+        <UPopover :content="{ side: 'top' }" :ui="{ content: 'h-auto w-max' }">
           <time
             :datetime="date?.toISOString()"
-            class="cursor-help text-xs text-muted"
+            class="cursor-pointer text-xs text-muted"
           >
             {{ relativeDate }}
           </time>
-        </UTooltip>
+          <template #content>
+            <p class="whitespace-pre-line px-3 py-2 text-xs">
+              {{ timestampDetails }}
+            </p>
+          </template>
+        </UPopover>
       </div>
       <form
         v-if="editing"

package/dist/runtime/components/Detail.vue

@@ -254,18 +254,19 @@ const contentHtml = computed(() => {
           <UIcon name="i-lucide-eye" class="size-3.5" />
           {{ post.viewCount ?? 0 }}
         </span>
-        <UTooltip
-          :delay-duration="0"
-          :text="formatTimestampDetails(post.createdAt, post.updatedAt).join('\n')"
-          :ui="{ content: 'h-auto w-max py-2', text: 'whitespace-pre-line overflow-visible' }"
-        >
+        <UPopover :content="{ side: 'top' }" :ui="{ content: 'h-auto w-max' }">
           <time
             :datetime="post.createdAt?.toDate?.().toISOString()"
-            class="cursor-help"
+            class="cursor-pointer"
           >
             {{ formatRelativeDate(post.createdAt, now) }}
           </time>
-        </UTooltip>
+          <template #content>
+            <p class="whitespace-pre-line px-3 py-2 text-xs">
+              {{ formatTimestampDetails(post.createdAt, post.updatedAt).join('\n') }}
+            </p>
+          </template>
+        </UPopover>
       </div>
       <div v-if="canEdit(post) || canDelete(post)" class="flex gap-2">
         <UButton

package/dist/runtime/components/Editor.vue

@@ -231,7 +231,7 @@ async function doUploadImage(file: File): Promise<EditorImageEntry> {
   if (file.size > EDITOR_IMAGE_SOURCE_MAX_BYTES) {
     throw new Error(`원본 이미지는 ${EDITOR_IMAGE_SOURCE_MAX_BYTES / 1024 / 1024}MB 이하여야 합니다.`)
   }
-  const entry = await uploadEditorImage(file, resolvedBoardId.value, imageNamespace())
+  const entry = await uploadEditorImage(file, imageNamespace())
   uploadedEditorImages.value.push(entry)
   return entry
 }
@@ -907,7 +907,6 @@ async function handleSubmit() {
     <MemiBoardAttachments
       v-if="!isImageListView"
       v-model="attachments"
-      :board-id="resolvedBoardId"
       :post-id="attachmentNamespace"
       editable
     />

package/dist/runtime/components/ListDefault.vue

@@ -36,8 +36,8 @@ function image(post: PostModel): string | undefined {
           class="flex min-w-0 flex-1 text-left transition-colors hover:bg-elevated/50"
           @click="!postTo(post) && emit('select', post)"
         >
-          <!-- 카드 좌·상·하 밀착, 가로는 고정 / 세로는 행 높이 전체 -->
-          <div class="w-[4.5rem] shrink-0 self-stretch bg-elevated">
+          <!-- 카드 좌·상 밀착, 항상 정사각형 — 텍스트가 길어져도 썸네일 비율은 유지 -->
+          <div class="size-[4.5rem] shrink-0 self-start bg-elevated">
             <img
               v-if="image(post)"
               :src="image(post)"
@@ -46,7 +46,7 @@ function image(post: PostModel): string | undefined {
             >
             <div
               v-else
-              class="flex h-full min-h-[4.5rem] w-full items-center justify-center text-muted"
+              class="flex h-full w-full items-center justify-center text-muted"
             >
               <UIcon name="i-lucide-image" class="size-6" />
             </div>
@@ -103,18 +103,19 @@ function image(post: PostModel): string | undefined {
             truncate
             class="max-w-full"
           />
-          <UTooltip
-            :delay-duration="0"
-            :text="formatTimestampDetails(post.createdAt, post.updatedAt).join('\n')"
-            :ui="{ content: 'h-auto w-max py-2', text: 'whitespace-pre-line overflow-visible' }"
-          >
+          <UPopover :content="{ side: 'top' }" :ui="{ content: 'h-auto w-max' }">
             <time
               :datetime="post.createdAt?.toDate?.().toISOString()"
-              class="cursor-help text-xs leading-snug text-muted"
+              class="cursor-pointer text-xs leading-snug text-muted"
             >
               {{ formatRelativeDate(post.createdAt, now) }}
             </time>
-          </UTooltip>
+            <template #content>
+              <p class="whitespace-pre-line px-3 py-2 text-xs">
+                {{ formatTimestampDetails(post.createdAt, post.updatedAt).join('\n') }}
+              </p>
+            </template>
+          </UPopover>
           <div class="flex flex-wrap items-center justify-end gap-x-2 gap-y-0.5 text-xs leading-snug text-muted">
             <span class="inline-flex items-center gap-0.5 tabular-nums">
               <UIcon name="i-lucide-eye" class="size-3 shrink-0" />{{ post.viewCount ?? 0 }}

package/dist/runtime/components/ListDense.vue

@@ -93,18 +93,19 @@ function thumb(post: PostModel): string | undefined {
             />
           </span>
           <span class="text-default/40" aria-hidden="true">·</span>
-          <UTooltip
-            :delay-duration="0"
-            :text="formatTimestampDetails(post.createdAt, post.updatedAt).join('\n')"
-            :ui="{ content: 'h-auto w-max py-2', text: 'whitespace-pre-line overflow-visible' }"
-          >
+          <UPopover :content="{ side: 'top' }" :ui="{ content: 'h-auto w-max' }">
             <time
               :datetime="post.createdAt?.toDate?.().toISOString()"
-              class="cursor-help tabular-nums"
+              class="cursor-pointer tabular-nums"
             >
               {{ formatRelativeDate(post.createdAt, now) }}
             </time>
-          </UTooltip>
+            <template #content>
+              <p class="whitespace-pre-line px-3 py-2 text-xs">
+                {{ formatTimestampDetails(post.createdAt, post.updatedAt).join('\n') }}
+              </p>
+            </template>
+          </UPopover>
           <span class="text-default/40" aria-hidden="true">·</span>
           <span class="inline-flex items-center gap-0.5 tabular-nums">
             <UIcon name="i-lucide-eye" class="size-3" />

package/dist/runtime/components/ListVideo.vue

@@ -75,18 +75,19 @@ function cover(post: PostModel): string | undefined {
             <UIcon name="i-lucide-eye" class="size-3" />
             {{ post.viewCount ?? 0 }}
           </span>
-          <UTooltip
-            :delay-duration="0"
-            :text="formatTimestampDetails(post.createdAt, post.updatedAt).join('\n')"
-            :ui="{ content: 'h-auto w-max py-2', text: 'whitespace-pre-line overflow-visible' }"
-          >
+          <UPopover :content="{ side: 'top' }" :ui="{ content: 'h-auto w-max' }">
             <time
               :datetime="post.createdAt?.toDate?.().toISOString()"
-              class="cursor-help"
+              class="cursor-pointer"
             >
               {{ formatRelativeDate(post.createdAt, now) }}
             </time>
-          </UTooltip>
+            <template #content>
+              <p class="whitespace-pre-line px-3 py-2 text-xs">
+                {{ formatTimestampDetails(post.createdAt, post.updatedAt).join('\n') }}
+              </p>
+            </template>
+          </UPopover>
         </div>
       </div>
     </div>

package/dist/types.d.ts

@@ -8,7 +8,7 @@ export interface Attachment {
 }
 /**
  * 에디터 본문 이미지 업로드 결과 (원본 + 썸네일).
- * Storage: `memiBoards/{boardId}/posts/{postId}/images/...` · `.../images/thumbnails/...`
+ * Storage: `memiBoardPosts/{postId}/images/...` · `.../images/thumbnails/...`
  * 본문 markdown 에는 originalUrl 만 넣고, 썸네일은 목록 카드 등에 활용 가능.
  * 수정 중 버려진 파일은 호스트 스케줄러로 정리 (본문에 없는 path).
  */
@@ -22,6 +22,8 @@ export interface EditorImageEntry {
 export type ModerationStatus = 'approved';
 export interface PostModel {
     id?: string;
+    /** 어느 보드(memiBoardSettings/{boardId})에 속한 글인지 — flat 컬렉션이라 경로 대신 필드로 스코핑한다. */
+    boardId: string;
     /** 카테고리 내 URL 식별자. 최초 작성 시 생성되고 제목 수정 시에도 유지된다. */
     slug: string;
     title: string;
@@ -32,14 +34,14 @@ export interface PostModel {
     videoUrl?: string;
     tags?: string[];
     /**
-     * @deprecated 카테고리 개념 제거 — 글은 memiBoards/{boardId}/posts 에만 존재.
+     * @deprecated 카테고리 개념 제거 — boardId 로 대체.
      * 레거시 읽기 호환용으로만 남을 수 있음.
      */
     category?: string;
     attachments?: Attachment[];
     /** 클라이언트 batch로 증감하는 UI 편의 필드 — 보안 판단에 쓰지 않는다. */
     commentCount: number;
-    /** 클라이언트 트랜잭션으로 증감하는 UI 편의 필드 — 보안 판단에 쓰지 않는다. 실제 좋아요 여부는 likes/{uid} 서브컬렉션이 기준. */
+    /** 클라이언트 트랜잭션으로 증감하는 UI 편의 필드 — 보안 판단에 쓰지 않는다. 실제 좋아요 여부는 memiBoardLikes 컬렉션이 기준. */
     likeCount: number;
     /**
      * 조회수. 로그인 없이 +1 가능(rules 가 viewCount 단독 증가만 허용).
@@ -69,13 +71,17 @@ export interface PostModel {
 export interface PostDetail extends PostModel {
     content: string;
 }
-/** 보드 경계를 넘는 작성자별 글 목록(예: /board-user/{uid})에서만 쓰는 형태 — 어느 보드 글인지 함께 담는다. */
-export interface UserPostModel extends PostModel {
-    boardId: string;
-}
+/**
+ * @deprecated PostModel 에 boardId 가 이미 있어 더 이상 별도 타입이 필요 없다.
+ * 보드 경계를 넘는 작성자별 글 목록(예: /board-user/{uid}) 등에서 PostModel 을 그대로 쓰면 된다.
+ */
+export type UserPostModel = PostModel;
 export interface CommentModel {
     id?: string;
+    /** 속한 글. flat 컬렉션이라 경로 대신 필드로 스코핑한다. */
     postId: string;
+    /** 부모 글의 boardId — 생성 시 클라이언트가 채우고, rules 가 부모 글과 일치하는지 검증한다. */
+    boardId: string;
     body: string;
     authorUid: string;
     authorName: string | null;
@@ -116,7 +122,7 @@ export type BoardWriteRole = 'user' | 'staff' | 'admin';
 export type BoardVisibility = 'public' | 'hidden';
 /**
  * 보드 1개 메타 (= 예전 BoardCategory).
- * id 가 곧 boardId — memiBoards/{id}/settings/config 에 저장.
+ * id 가 곧 boardId — memiBoardSettings/{id} 에 저장.
  */
 export interface BoardModel {
     /** boardId (예: 'notice', 'free') */
@@ -141,10 +147,18 @@ export interface BoardModel {
 }
 /** @deprecated BoardModel 사용 — 카테고리 개념 제거, id = boardId */
 export type BoardCategory = BoardModel;
-/** memiBoards/{boardId}/settings/config */
+/** memiBoardSettings/{boardId} */
 export interface BoardSettingsModel extends Omit<BoardModel, 'id'> {
     updatedAt?: Timestamp;
 }
+/** memiBoardLikes/{postId}_{uid} — "내가 좋아요한 글" 등 uid 기준 교차 조회용 flat 컬렉션. */
+export interface BoardLikeModel {
+    id?: string;
+    uid: string;
+    postId: string;
+    boardId: string;
+    createdAt: Timestamp;
+}
 /** 검열이 어느 단계에서 끝났는지 (호스트/로깅용, UI 노출 없음) */
 export type ModerationVia = 'empty' | 'disabled' | 'local' | 'ai' | 'restricted' | 'ai-error-allow' | 'ai-error-block';
 export interface ModerationResult {

package/dist/utils/boardPaths.d.ts

@@ -1,26 +1,37 @@
 import { CollectionReference, DocumentReference, Firestore } from 'firebase/firestore';
-export declare const DEFAULT_BOARDS_COLLECTION = "memiBoards";
+export declare const DEFAULT_POSTS_COLLECTION = "memiBoardPosts";
+export declare const DEFAULT_COMMENTS_COLLECTION = "memiBoardComments";
+export declare const DEFAULT_LIKES_COLLECTION = "memiBoardLikes";
+export declare const DEFAULT_SETTINGS_COLLECTION = "memiBoardSettings";
 export declare const DEFAULT_USERS_COLLECTION = "memiBoardUsers";
 export interface BoardPathConfig {
-    boardsCollection: string;
+    postsCollection: string;
+    commentsCollection: string;
+    likesCollection: string;
+    settingsCollection: string;
     usersCollection: string;
 }
 export declare function resolveBoardPathConfig(input: {
-    boardsCollection?: string;
+    postsCollection?: string;
+    commentsCollection?: string;
+    likesCollection?: string;
+    settingsCollection?: string;
     usersCollection?: string;
 }): BoardPathConfig;
-export declare function boardsCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
-export declare function boardDoc(db: Firestore, cfg: BoardPathConfig, boardId: string): DocumentReference;
-/** 구 boardSettings — 보드 단위 설정 문서 */
-export declare function boardSettingsDoc(db: Firestore, cfg: BoardPathConfig, boardId: string): DocumentReference;
-export declare function boardPostsCol(db: Firestore, cfg: BoardPathConfig, boardId: string): CollectionReference;
-export declare function boardPostDoc(db: Firestore, cfg: BoardPathConfig, boardId: string, postId: string): DocumentReference;
-export declare function boardPostBodyDoc(db: Firestore, cfg: BoardPathConfig, boardId: string, postId: string): DocumentReference;
-export declare function boardPostCommentsCol(db: Firestore, cfg: BoardPathConfig, boardId: string, postId: string): CollectionReference;
-export declare function boardPostCommentDoc(db: Firestore, cfg: BoardPathConfig, boardId: string, postId: string, commentId: string): DocumentReference;
-export declare function boardPostLikeDoc(db: Firestore, cfg: BoardPathConfig, boardId: string, postId: string, uid: string): DocumentReference;
+/** 보드 설정 목록/문서 — 구 memiBoards/{boardId} stub + settings/config 통합 */
+export declare function settingsCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
+export declare function settingsDoc(db: Firestore, cfg: BoardPathConfig, boardId: string): DocumentReference;
+export declare function postsCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
+export declare function postDoc(db: Firestore, cfg: BoardPathConfig, postId: string): DocumentReference;
+export declare function postBodyDoc(db: Firestore, cfg: BoardPathConfig, postId: string): DocumentReference;
+export declare function commentsCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
+export declare function commentDoc(db: Firestore, cfg: BoardPathConfig, commentId: string): DocumentReference;
+export declare function likesCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
+/** 좋아요 문서ID 관례: `${postId}_${uid}` — 유저당 글당 좋아요 1개, 토글은 create-or-delete */
+export declare function likeDocId(postId: string, uid: string): string;
+export declare function likeDoc(db: Firestore, cfg: BoardPathConfig, postId: string, uid: string): DocumentReference;
 export declare function boardUsersCol(db: Firestore, cfg: BoardPathConfig): CollectionReference;
 export declare function boardUserDoc(db: Firestore, cfg: BoardPathConfig, uid: string): DocumentReference;
-export declare function boardStorageRoot(cfg: BoardPathConfig, boardId: string): string;
-export declare function boardPostStorageFolder(cfg: BoardPathConfig, boardId: string, postId: string): string;
+/** postId 가 전역 고유이므로 boardId 프리픽스 불필요 */
+export declare function postStorageFolder(cfg: BoardPathConfig, postId: string): string;
 export declare function boardSsrKey(cfg: BoardPathConfig, suffix: string): string;

package/docs/firebase-setup.md

@@ -94,13 +94,12 @@ AI Logic / `firebaseml` 이 **Enforce** 이면 App Check 토큰 없이 검열 AP
 4. **프로덕션:** 디버그 토큰 사용 금지. reCAPTCHA 도메인에 실제 호스트 도메인 등록.
 5. (선택) Firestore/Storage Enforce — 켜면 토큰 없는 요청 거부. AI Logic 과 별개 토글이다.
 
-## 9. Firestore 복합 인덱스 (카테고리 필터 사용 시)
+## 9. Firestore 복합 인덱스
 
-`MemiBoardList` 에 `category` prop 을 넘기면 `category + createdAt` 복합 인덱스가 필요하다.  
-콘솔 에러의 인덱스 생성 링크를 따르거나, 호스트 `firestore.indexes.json` 에 추가 후:
+`memiBoardPosts`/`memiBoardComments`/`memiBoardLikes` 는 모두 최상위 flat 컬렉션이고, 보드/글 단위 스코핑은 `boardId`/`postId` 필드에 대한 `where` 동등 필터로 한다. [docs/firestore.indexes.json.example](firestore.indexes.json.example) 를 호스트 `firestore.indexes.json` 에 병합 후:
 
 ```bash
 firebase deploy --only firestore:indexes
 ```
 
-컬렉션 ID: 서브컬렉션 `posts` (collection group `posts`). 경로 예: `memiBoards/{boardId}/posts`.
+콘솔 에러에 인덱스 생성 링크가 뜨면 그걸 따라도 된다 — 위 예시 파일은 패키지가 실제로 실행하는 쿼리 기준으로 미리 정리해 둔 것이다. 컬렉션 이름을 커스터마이즈했다면(`memiBoard.postsCollection` 등) `collectionGroup` 값도 맞춰 바꾼다.

package/docs/firestore.indexes.json.example

@@ -0,0 +1,127 @@
+{
+  "indexes": [
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "boardId", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "listed", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "boardId", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "boardId", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "listed", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "ASCENDING" },
+        { "fieldPath": "__name__", "order": "ASCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "boardId", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "ASCENDING" },
+        { "fieldPath": "__name__", "order": "ASCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "boardId", "order": "ASCENDING" },
+        { "fieldPath": "authorUid", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardPosts",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "authorUid", "order": "ASCENDING" },
+        { "fieldPath": "isPublished", "order": "ASCENDING" },
+        { "fieldPath": "listed", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardComments",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "postId", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardComments",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "postId", "order": "ASCENDING" },
+        { "fieldPath": "parentId", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardComments",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "postId", "order": "ASCENDING" },
+        { "fieldPath": "parentId", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "ASCENDING" },
+        { "fieldPath": "__name__", "order": "ASCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardComments",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "rootId", "order": "ASCENDING" },
+        { "fieldPath": "isReply", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardComments",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "rootId", "order": "ASCENDING" },
+        { "fieldPath": "isReply", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "ASCENDING" },
+        { "fieldPath": "__name__", "order": "ASCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "memiBoardLikes",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "uid", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" },
+        { "fieldPath": "__name__", "order": "DESCENDING" }
+      ]
+    }
+  ],
+  "fieldOverrides": []
+}