influence/.cursor/rules/api-rule.mdc

# 최우선 규칙: 한글 응답 필수

**모든 응답은 한글로만 작성해야 함. 이 규칙은 다른 모든 규칙보다 우선한다.**

# API & Store Rules

## Pinia Store Rules

### 1. Setup Syntax Store Reset 구현
- Setup 문법(`defineStore(() => {...})`)으로 작성된 store는 자동 `$reset()`이 제공되지 않음
- 반드시 수동으로 `reset()` 함수를 구현해야 함
```typescript
// Good
export const useMyStore = defineStore('myStore', () => {
  const data = ref([])
  const loading = ref(false)
  
  // 수동으로 reset 함수 구현
  function reset() {
    data.value = []
    loading.value = false
  }
  
  return {
    data,
    loading,
    reset  // reset 함수 반환 필수
  }
})

// Bad - reset 함수 없음
export const useMyStore = defineStore('myStore', () => {
  const data = ref([])
  return { data }
})
```

### 2. Reset 함수 구현 가이드
- 모든 state를 초기값으로 되돌리는 로직 포함
- 중첩된 객체의 경우 깊은 복사 고려
- persist 옵션이 있는 경우 저장소 데이터도 정리
```typescript
function reset() {
  // 단순 값 초기화
  simpleValue.value = null
  
  // 객체 초기화
  objectValue.value = {
    prop1: '',
    prop2: 0
  }
  
  // 배열 초기화
  arrayValue.value = []
  
  // 중첩 객체 초기화
  complexValue.value = JSON.parse(JSON.stringify(DEFAULT_STATE))
}
```

### 3. Store 초기화 호출 방식
- Setup 문법 store: `store.reset()`
- Options 문법 store: `store.$reset()`
```typescript
// Setup store
const setupStore = useSetupStore()
setupStore.reset()  // O
setupStore.$reset() // X - 에러 발생

// Options store
const optionsStore = useOptionsStore()
optionsStore.$reset() // O
```

### 4. Store 초기화 시점
- 로그아웃
- 사용자 전환
- 주요 상태 변경
- 에러 복구
```typescript
async function logout() {
  // 모든 store 초기화
  authStore.setLogout()
  setupStore.reset()     // Setup syntax
  optionsStore.$reset()  // Options syntax
  
  // 로컬 스토리지 정리
  localStorage.clear()
}
```

## API Rules

- api 서버는 코드이그나이터4 베이스의 벡엔드 기술로 구현되어있으며
  기존 문서에사용되는 양식을 지키며 구현
- 프론트에서 api신규 생성시 백엔드 코드이그나4 기반의 기술로 구현하는 예제를 함께 제공
- 항상 페이지 구성이 완료되고 나면 제작에 필요한 쿼리를 DDL형태로 구성해서 ddl폴더에 만들어줘
- api구성후 백엔드 예제를 backend-examples에 코드이그나이터4 형태로 구성해줘
- MD파일을 생성해서 백엔드 구성과 DB생성을 하는 과정을 순서대로 작성해줘
- 프론트화면 및 UI / API 구성시에는 항상 composition api 형태로 작성 css는 항상 scss형태로 분리해서 구성

## 프론트엔드 API 호출 규칙
- **Nuxt.js server/api 사용 금지**: 프론트엔드에서 직접 백엔드 API 호출
- **useAxios() 패턴 강제**: 기존 코드베이스와 일관성 유지
- 반드시 다음 형태로 구성:
```javascript
const loadData = async () => {
  try {
    const params = {
      // 파라미터들...
    }

    useAxios()
      .post('/api/endpoint', params)
      .then((res) => {
        if (res.data.success) {
          // 성공 처리
          data.value = res.data.data
        } else {
          // 실패 처리
          error.value = res.data.message
        }
      })
      .catch((err) => {
        // 에러 처리
        error.value = err.message
      })
      .finally(() => {
        // 완료 처리
        loading.value = false
      })

  } catch (err) {
    error.value = err.message
  }
}
```

## API 구조 금지사항
- **server/api 디렉토리 생성 금지**: Nuxt.js 서버 API 사용하지 않음
- **mysql2, 데이터베이스 라이브러리 사용 금지**: 프론트엔드에서 직접 DB 연결 금지
- **$fetch 사용 금지**: useAxios() 패턴만 사용
- **async/await 패턴 지양**: .then().catch().finally() 체인 사용

## 백엔드 연동 방식
- 프론트엔드 → CodeIgniter4 백엔드 직접 호출
- useAxios()를 통한 HTTP 통신만 사용
- 응답 형태: `res.data.success`, `res.data.data`, `res.data.message`
- 백엔드는 직접 만들거야 다만 너가 backend-examples 폴더에 프론트와 수신할수는있는 형태의 api예제를 만들어
- useAxios()를 통한 HTTP 통신만 사용
- 응답 형태: `res.data.success`, `res.data.data`, `res.data.message`
- 백엔드는 직접 만들거야 다만 너가 backend-examples 폴더에 프론트와 수신할수는있는 형태의 api예제를 만들어