elysia-admin: Instructions file for Kiro

前端模块规范（Vue 3 + TypeScript）

与 .cursor/rules/frontend.mdc 同源。详细代码模板：

#[[file:.ai/AI_CODE_EXAMPLES_FRONTEND.md]]

Frontend File Structure

admin/src/
    types/api/{group}-{name}.d.ts   ← type declarations (declare namespace Api)
    api/{group}/{name}.ts           ← HTTP wrappers only
    views/{group}/{name}/
        index.vue                   ← page container (useTable, columns, dialog control)
        modules/
            {name}-search.vue       ← search form only
            {name}-dialog.vue       ← add/edit form only

---

Type Declaration Pattern (types/api/)

declare namespace Api {
    namespace GroupName {  // PascalCase group + module name
        interface NameListItem {
            nameId?: number;
            fieldA?: string;
            status?: boolean;
            createTime?: Date;
            // ... mirror backend schema fields
        }
        type NameList = Api.Common.PaginatedResponse<NameListItem>
        type NameSearchParams = Partial<
            Pick<NameListItem, 'fieldA' | 'status'> &
            Api.Common.CommonSearchParams
        >
    }
}

---

API Layer Pattern (api/{group}/{name}.ts)

import request from '@/utils/http'

// Naming: fetch + Action + ModuleName
export function fetchCreateName(data: Api.GroupName.NameListItem) {
    return request.post({ url: '/api/group/name', data, showSuccessMessage: true, showErrorMessage: true })
}
export function fetchGetNameList(params: Api.GroupName.NameSearchParams) {
    return request.get<Api.GroupName.NameList>({ url: '/api/group/name/list', params })
}
export function fetchGetNameDetail(id: number) {
    return request.get<Api.GroupName.NameListItem>({ url: `/api/group/name/${id}` })
}
export function fetchUpdateName(data: Api.GroupName.NameListItem) {
    return request.put({ url: '/api/group/name', data, showSuccessMessage: true, showErrorMessage: true })
}
export function fetchDeleteName(ids: number | string) {
    return request.delete({ url: `/api/group/name/${ids}`, showSuccessMessage: true, showErrorMessage: true })
}