🔥 Firebase CRUD

✔️ firebase 초기화

• getFirestore(): firestore를 초기화하기 위한 함수

✔️ Create

기능	addDoc	setDoc
문서 ID 생성	firestore가 자동으로 문서 ID를 생성	사용자 지정 문서 ID를 직접 생성
기존 문서 처리	새 문서 생성, 기존 문서와 충돌 없음	기존 문서가 있을 경우 덮어씀( merge option )
사용 시나리오	문서 ID를 자동으로 생성하고 싶을 때	특정 문서 ID를 지정하거나 기존 문서를 업데이트
함수 호출 방식	addDoc(collectionRef, data)	setDoc(docRef, data)

데이터 무결성: 데이터가 일관되고 정확한지에 대한 정도
firebase는 컬렉션이 없더라도 데이터 삽입을 조작하면 컬렉션이 생성되며 자동으로 데이터 삽입 처리됨
→ 무결성 ⬇️

✔️ Read

항목	getDocs	onSnapshot
기능	firestore에서 한 번에 데이터 조회	실시간 데이터 변경 감지 및 반영
반환 값	정적 데이터 스냅샷( QuerySnapshot )	데이터 구독 해제 함수( Unsubscribe )
실시간 반영	수동으로 데이터 갱신 필요	실시간으로 데이터 자동 반영
사용 사례	특정 시점의 데이터 조회가 필요할 때	실시간 UI 업데이트가 필요할 때
장점	단일 요청으로 성능 효율적	데이터 변경이 즉시 반영됨
단점	실시간 반영이 어려움	지속적인 구독으로 리소스 사용 증가

• collection(store 인스턴스, 컬렉션 이름): 컬렉션 조회 함수
• getDocs(collection 참조 객체): 문서들 조회 함수, 프로미스 반환
• getDoc(): 문서 조회 함수
• snapshots.docs: 문서 데이터를 배열로 반환
• onSnapshot(): 실시간 데이터 변경 감지 및 반영

✔️ Update

• updateDoc(collectionRef, data): 문서 참조 객체를 활용한 문서 업데이트

  doc(firestore 참조 객체, 컬렉션 이름, 문서 ID): 문서 ID로 특정 문서 가져오기

✔️ Delete

• deleteDoc(docRef): 문서 참조 객체를 사용해 특정 문서 삭제

import {
  collection,
  getDocs,
  addDoc,
  setDoc,
  doc,
  updateDoc,
  deleteDoc,
  query,
  where,
  orderBy,
} from "firebase/firestore";
import { db } from "../config/firebaseConfig";

export const firebaseFirestoreService = {
  // 데이터 조회( todoList 컬렉션 조회 ): READ
  async getTodoListCollection() {
    const collectionRef = collection(db, "todoList");
    const todoSnapshots = await getDocs(collectionRef);

    const data = todoSnapshots.docs.map((doc) => ({
      id: doc.id,
      ...(doc.data() as { taskNum: number; name: string }),
    }));

    return data;
  },

  // 데이터 생성( todo 컬렉션 내에 문서 추가 ): CREATE
  async createTodoCollectionDoc(targetTodo: { name: string; taskNum: number }) {
    try {
      const collectionRef = collection(db, "todoList");
      await addDoc(collectionRef, { targetTodo });
    } catch (e) {
      console.error("❌ createTodoCollectionDoc error: ", e);
    }
  },

	// 데이터 수정: UPDATE
  async createTodo(targetTodo: { name: string; taskNum: number }) {
    try {
      const docRef = doc(db, "todoList", "todoList");
      await setDoc(docRef, {
        name: "todo",
        taskNum: 1,
        description: "test",
      });

      await setDoc(
        docRef,
        {
          name: "todo",
          taskNum: 1,
        },
        {
          merge: true, // 덮어쓰기 X, 병합하는 옵션
        }
      );
    } catch (e) {
      console.error("❌ createTodo error: ", e);
    }
  },

	// 데이터 수정: UPDATE
  async updateTod() {
    try {
      const docRef = doc(db, "todoList", "todoList");
      await updateDoc(docRef, {
        name: "todoUpdate",
      });
    } catch (e) {
      console.error("updateUser error", e);
    }
  },

	// 데이터 삭제: DELETE
  async deleteTodo() {
    try {
      const docRef = doc(db, "todoList", "todoList");
      await deleteDoc(docRef);
    } catch (e) {
      console.error("❌ delete todo error: ", e);
    }
  },

  // query 사용: 데이터를 필터링 하여 조회: GET
  async getTasksByName(targetName: string) {
    try {
      const collectionRef = collection(db, "todoList");
      const querystring = query(collectionRef, where("name", "==", targetName));
      const snapshot = await getDocs(querystring);
      console.log(snapshot.size, snapshot.empty);

      if (snapshot.empty) {
        console.log("No matching documents for the provided name.");
      } else {
        console.log(`Found ${snapshot.size} documents.`);
      }

    } catch (e) {
      console.error("❌ getTasksByName: ", e);
    }
  },

  // 정렬하기: GET
  // 1번 인자만 주면 오름차순, 2번인자에 'desc' 주면 내림차순
  async orderTasksByName() {
    try {
      const collectionRef = collection(db, "todoList");
      const querystring = query(collectionRef, orderBy("name"));
      const snapshot = await getDocs(querystring);

    } catch (e) {
      console.error("❌ getTasksByName: ", e);
    }
  },
  async orderTasksByNameDesc() {
    try {
      const collectionRef = collection(db, "todoList");
      const querystring = query(collectionRef, orderBy("name", "desc"));
      const snapshot = await getDocs(querystring);

    } catch (e) {
      console.error("❌ getTasksByName: ", e);
    }
  },

  // 복합 query: GET
  async multiQuery() {
    try {
      const collectionRef = collection(db, "todoList");
      const querystring = query(
        collectionRef,
        orderBy("createdAt", "desc"),
        where("name", "==", "a")
      );
      const snapshot = await getDocs(querystring);
      });
    } catch (e) {
      console.error("❌ getTasksByName: ", e);
    }
  },
};