# gdt-auto Agent Guide

## Project Scope
- This project integrates with Tencent Ads APIs to batch-create and manage ad plans and ad creatives.
- Backend is a standard Java web application built with Spring Boot and MyBatis-Plus.
- Backend layering follows `controller`, `service`, `service.impl`, `mapper`, and `entity`.
- Frontend lives under `portal/` and is a Vue 3 + Vite application using Element Plus and Tailwind CSS.

## Working Rules
- Prefer existing code patterns in this repository over introducing new abstractions.
- When the user provides a concrete method context and asks for a change, limit the code change to that method's behavior unless broader refactoring is explicitly confirmed.
- For backend API responses used by the frontend, prefer `com.moka.gdtauto.common.Result`; frontend business success is determined by the `success` field.
- Do not read `src/main/resources` configuration files unless the task requires it and the user has confirmed.
- Do not inspect generated or dependency directories unless strictly necessary, especially `target/`, `node_modules/`, and `dist/`.
- Avoid reading files and directories already ignored by `.gitignore` unless they are directly relevant to the task.

## Project References
- Tencent Ads SDK usage reference: check tests under `src/test` when present, especially Tencent Ads create-flow examples such as `TencentAdsAdgroupCreateTest`.
- CRUD backend reference: [src/main/java/com/moka/gdtauto/controller/OssFileController.java](/Users/pudongliang/moka_workspace/gdt-auto/src/main/java/com/moka/gdtauto/controller/OssFileController.java)
- Frontend page reference: [portal/src/views/oss-file/index.vue](/Users/pudongliang/moka_workspace/gdt-auto/portal/src/views/oss-file/index.vue)
- Frontend API reference: [portal/src/api/ossFile.js](/Users/pudongliang/moka_workspace/gdt-auto/portal/src/api/ossFile.js)
- Router reference: [portal/src/router/index.js](/Users/pudongliang/moka_workspace/gdt-auto/portal/src/router/index.js)
- UI style reference: [portal/src/views/conversion/index.vue](/Users/pudongliang/moka_workspace/gdt-auto/portal/src/views/conversion/index.vue)

## CRUD Generation
- If the task is to add CRUD for a new table, update `TABLE_NAMES` in [src/main/java/com/moka/gdtauto/BaseCodeGenerator.java](/Users/pudongliang/moka_workspace/gdt-auto/src/main/java/com/moka/gdtauto/BaseCodeGenerator.java) and then run its `main` method.

## Codex Skills
- Project-local skills for Codex are stored under `.codex/skills/`.
- Migrated from `.qoder`: `git-commit-push`
