Hei AI Code

https://github.com/xiaohei1022/hei-ai-code
Admin
Hei AI Code is an AI-powered code generation platform that uses LangChain4j and OpenAI to...
Tokens:18,787
Snippets:98
Trust Score:3.8
Update:7 months ago
Show doc for...
Tokens:
Raw
### Get Application Details API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves detailed information for a specified application, including its name, initial prompt, code generation type, deployment status, and the user who created it.

```bash
# 获取应用详情请求
curl -X GET "http://localhost:8123/api/app/get/vo?id=1984178910452338688" \
  -b cookies.txt
```

--------------------------------

### Event Listeners Setup in JavaScript

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

Sets up event listeners for various user interactions. This includes handling form submissions for adding/updating tasks, resetting the form, and triggering task filtering based on input changes in search, category, and status elements. It also calls the `init` function to initialize the application.

```javascript
taskForm.addEventListener('submit', function(event) {
  if (editingTaskId) {
    updateTask(event);
  } else {
    addTask(event);
  }
});

cancelBtn.addEventListener('click', resetForm);
searchInput.addEventListener('input', filterTasks);
categoryFilter.addEventListener('change', filterTasks);
statusFilter.addEventListener('change', filterTasks);

// Initialize application
init();
```

--------------------------------

### Paginate Featured Applications List using API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

This API endpoint retrieves a list of featured and recommended applications on the platform. These applications are typically high-quality examples with a high priority score. Pagination parameters like page number and page size are supported.

```bash
curl -X POST http://localhost:8123/api/app/good/list/page/vo \
  -H "Content-Type: application/json" \
  -d '{
    "pageNum": 1,
    "pageSize": 10
  }'
```

--------------------------------

### Get Application Details API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves detailed information about a specific application, including its name, initial prompt, code generation type, deployment status, and associated user information.

```APIDOC
## GET /api/app/get/vo

### Description
Retrieves detailed information about a specific application, including its name, initial prompt, code generation type, deployment status, and associated user information.

### Method
GET

### Endpoint
/api/app/get/vo

### Parameters
#### Query Parameters
- **id** (long) - Required - The ID of the application to retrieve.
- **cookies.txt** (cookie) - Required - A valid session cookie obtained after login.

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (object) - Application details.
  - **id** (long) - Application ID.
  - **appName** (string) - Application name.
  - **initPrompt** (string) - Initial prompt used for generation.
  - **genType** (string) - Code generation type (e.g., "multi-file", "vue").
  - **deployUrl** (string) - URL of the deployed application (if deployed).
  - **createUserName** (string) - Username of the application creator.
  - **createTime** (string) - Application creation timestamp.
  - **updateTime** (string) - Application update timestamp.
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "id": 1984178910452338688,
    "appName": "待办事项管理",
    "initPrompt": "创建一个待办事项管理应用，包含添加、删除、标记完成功能，使用现代化的 UI 设计",
    "genType": "multi-file",
    "deployUrl": "http://localhost:8123/static/490009/",
    "createUserName": "testuser",
    "createTime": "2024-01-15T11:00:00",
    "updateTime": "2024-01-15T11:30:00"
  },
  "message": ""
}
```
```

--------------------------------

### Get Current Logged-in User API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves information about the currently logged-in user, requiring a valid session cookie. Returns a sanitized user profile, excluding sensitive fields like passwords.

```bash
# 获取登录用户信息
curl -X GET http://localhost:8123/api/user/get/login \
  -b cookies.txt

# 成功响应
{
  "code": 0,
  "data": {
    "id": 1234567890123456789,
    "userAccount": "testuser",
    "userName": "测试用户",
    "userAvatar": "https://example.com/avatar.jpg",
    "userProfile": "这是用户简介",
    "userRole": "user",
    "createTime": "2024-01-15T10:30:00",
    "updateTime": "2024-01-15T10:30:00"
  },
  "message": ""
}

# 未登录时的错误响应
{
  "code": 40100,
  "data": null,
  "message": "未登录"
}
```

--------------------------------

### Get Current Login User API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves information about the currently logged-in user. Requires a valid session cookie. Returns de-sensitized user information, excluding sensitive fields like passwords.

```APIDOC
## GET /api/user/get/login

### Description
Retrieves information about the currently logged-in user. Requires a valid session cookie. Returns de-sensitized user information, excluding sensitive fields like passwords.

### Method
GET

### Endpoint
/api/user/get/login

### Parameters
#### Query Parameters
- **cookies.txt** (cookie) - Required - A valid session cookie obtained after login.

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (object) - De-sensitized user information (same structure as login response).
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "id": 1234567890123456789,
    "userAccount": "testuser",
    "userName": "测试用户",
    "userAvatar": "https://example.com/avatar.jpg",
    "userProfile": "这是用户简介",
    "userRole": "user",
    "createTime": "2024-01-15T10:30:00",
    "updateTime": "2024-01-15T10:30:00"
  },
  "message": ""
}
```

#### Error Response (40100)
- **code** (integer) - 40100 for unauthorized.
- **data** (null) - Null.
- **message** (string) - Error message, e.g., "未登录" (Not logged in).

#### Error Response Example
```json
{
  "code": 40100,
  "data": null,
  "message": "未登录"
}
```
```

--------------------------------

### Get Application Chat History using API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

This API endpoint retrieves the chat history for a specific application. It uses cursor-based pagination and supports loading more messages in chronological order (descending by time). Parameters include application ID and page size, with an optional `lastCreateTime` for fetching older messages.

```bash
# Get chat history (first load)
curl -X GET "http://localhost:8123/api/chatHistory/app/1984178910452338688?pageSize=20" \
  -b cookies.txt

# Get more history (cursor pagination)
curl -X GET "http://localhost:8123/api/chatHistory/app/1984178910452338688?pageSize=20&lastCreateTime=2024-01-15T10:30:00" \
  -b cookies.txt
```

--------------------------------

### Get App Chat History

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves the chat history for a specific application using cursor-based pagination. Supports loading more messages in reverse chronological order.

```APIDOC
## GET /api/chatHistory/app/{appId}

### Description
Retrieves the chat history for a specific application using cursor-based pagination. Supports loading more messages in reverse chronological order.

### Method
GET

### Endpoint
/api/chatHistory/app/{appId}

### Parameters
#### Path Parameters
- **appId** (string) - Required - The unique identifier of the application.

#### Query Parameters
- **pageSize** (integer) - Optional - The number of records to retrieve per page (default 20).
- **lastCreateTime** (string) - Optional - The timestamp of the last message to fetch messages before this time (for cursor pagination).

### Request Example
```bash
# Initial load
curl -X GET "http://localhost:8123/api/chatHistory/app/1984178910452338688?pageSize=20" -b cookies.txt

# Load more history
curl -X GET "http://localhost:8123/api/chatHistory/app/1984178910452338688?pageSize=20&lastCreateTime=2024-01-15T10:30:00" -b cookies.txt
```

### Response
#### Success Response (200)
- **data.records** (array) - A list of chat message objects.
  - **id** (integer) - The message ID.
  - **message** (string) - The content of the message.
  - **messageType** (string) - The type of message ('user' or 'ai').
  - **appId** (integer) - The application ID.
  - **userId** (integer) - The user ID.
  - **createTime** (string) - The timestamp of the message.
- **data.totalRow** (integer) - The total number of messages.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "records": [
      {
        "id": 1,
        "message": "创建一个待办事项管理应用",
        "messageType": "user",
        "appId": 1984178910452338688,
        "userId": 1234567890123456789,
        "createTime": "2024-01-15T10:30:00"
      },
      {
        "id": 2,
        "message": "<!DOCTYPE html><html>...</html>",
        "messageType": "ai",
        "appId": 1984178910452338688,
        "userId": 1234567890123456789,
        "createTime": "2024-01-15T10:30:15"
      }
    ],
    "totalRow": 10
  },
  "message": ""
}
```
```

--------------------------------

### Initialize and Render Tasks in JavaScript

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

Initializes the task management application by setting up event listeners, rendering existing tasks from local storage, and updating statistics. It also sets the default due date to the current day.

```javascript
document.addEventListener('DOMContentLoaded', function() {
  // Get DOM elements
  const taskForm = document.getElementById('task-form');
  const taskTitle = document.getElementById('task-title');
  const taskDescription = document.getElementById('task-description');
  const taskCategory = document.getElementById('task-category');
  const taskDueDate = document.getElementById('task-due-date');
  const taskPriority = document.getElementById('task-priority');
  const submitBtn = document.getElementById('submit-btn');
  const cancelBtn = document.getElementById('cancel-btn');
  const formTitle = document.getElementById('form-title');
  const tasksContainer = document.getElementById('tasks-container');
  const emptyState = document.getElementById('empty-state');
  const searchInput = document.getElementById('search-input');
  const categoryFilter = document.getElementById('category-filter');
  const statusFilter = document.getElementById('status-filter');
  const totalTasksElement = document.getElementById('total-tasks');
  const completedTasksElement = document.getElementById('completed-tasks');
  const pendingTasksElement = document.getElementById('pending-tasks');
  const taskCountElement = document.getElementById('task-count');

  // Initialize tasks array
  let tasks = JSON.parse(localStorage.getItem('tasks')) || [];
  let editingTaskId = null;

  // Initialize application
  function init() {
    renderTasks();
    updateStats();
    // Set default date to today
    const today = new Date().toISOString().split('T')[0];
    taskDueDate.value = today;
  }

  // Save tasks to local storage
  function saveTasks() {
    localStorage.setItem('tasks', JSON.stringify(tasks));
  }

  // Render task list
  function renderTasks(filteredTasks = null) {
    const tasksToRender = filteredTasks || tasks;
    if (tasksToRender.length === 0) {
      tasksContainer.innerHTML = '';
      tasksContainer.appendChild(emptyState);
      emptyState.style.display = 'block';
      return;
    }
    emptyState.style.display = 'none';
    tasksContainer.innerHTML = '';
    tasksToRender.forEach(task => {
      const taskElement = document.createElement('div');
      taskElement.className = `task-item ${task.completed ? 'completed' : ''}`;
      taskElement.dataset.id = task.id;
      const dueDate = task.dueDate ? new Date(task.dueDate).toLocaleDateString() : '未设置';
      taskElement.innerHTML = `
        <div style="display: flex; align-items: center; flex: 1;">
          <input type="checkbox" class="task-checkbox" ${task.completed ? 'checked' : ''}>
          <div class="task-content">
            <div class="task-title">${task.title}</div>
            <div class="task-description">${task.description}</div>
            <div class="task-meta">
              <span class="task-category">${task.category}</span>
              <span>优先级: ${task.priority}</span>
              <span>截止日期: ${dueDate}</span>
            </div>
          </div>
        </div>
        <div class="task-actions">
          <button class="task-btn edit-btn" title="编辑任务">✏️</button>
          <button class="task-btn delete-btn" title="删除任务">🗑️</button>
        </div>
      `;
      tasksContainer.appendChild(taskElement);

      // Add event listeners
      const checkbox = taskElement.querySelector('.task-checkbox');
      const editBtn = taskElement.querySelector('.edit-btn');
      const deleteBtn = taskElement.querySelector('.delete-btn');

      checkbox.addEventListener('change', function() {
        toggleTaskCompletion(task.id);
      });
      editBtn.addEventListener('click', function() {
        editTask(task.id);
      });
      deleteBtn.addEventListener('click', function() {
        deleteTask(task.id);
      });
    });
  }

  // Add new task
  function addTask(event) {
    event.preventDefault();
    const title = taskTitle.value.trim();
    const description = taskDescription.value.trim();
    const category = taskCategory.value;
    const dueDate = taskDueDate.value;
    const priority = taskPriority.value;

    if (!title) {
      alert('请输入任务标题');
      return;
    }

    const newTask = {
      id: Date.now().toString(),
      title,
      description,
      category,
      dueDate,
      priority,
      completed: false,
      createdAt: new Date().toISOString()
    };

    tasks.push(newTask);
    saveTasks();
    renderTasks();
    updateStats();
    resetForm();
    // Show success message
    showMessage('任务添加成功！', 'success');
  }

  // Edit task
  function editTask(id) {
    const task = tasks.find(t => t.id === id);
    if (!task) return;

    taskTitle.value = task.title;
    taskDescription.value = task.description;
    taskCategory.value = task.category;
    taskDueDate.value = task.dueDate;
    taskPriority.value = task.priority;

    formTitle.textContent = '编辑任务';
    submitBtn.textContent = '更新任务';
    cancelBtn.style.display = 'inline-block';
    editingTaskId = id;

    // Scroll to the form
    taskForm.scrollIntoView({ behavior: 'smooth' });
  }

  // Update task
  function updateTask(event) {
    event.preventDefault();
    const title = taskTitle.value.trim();
    const description = taskDescription.value.trim();
    const category = taskCategory.value;
    const dueDate = taskDueDate.value;
    const priority = taskPriority.value;

    if (!title) {
      alert('请输入任务标题');
      return;
    }

    const taskIndex = tasks.findIndex(t => t.id === editingTaskId);
    if (taskIndex === -1) return;

    tasks[taskIndex].title = title;
    tasks[taskIndex].description = description;
    tasks[taskIndex].category = category;
    tasks[taskIndex].dueDate = dueDate;
    tasks[taskIndex].priority = priority;

    saveTasks();
    renderTasks();
    updateStats();
    resetForm();
    // Show success message
    showMessage('任务更新成功！', 'success');
  }

  // Delete task
  function deleteTask(id) {
    if (!con
```

--------------------------------

### Deploy Application API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Deploys a generated application, making it accessible online. Assigns a unique 6-digit deployment ID and copies the code files to the deployment directory. Returns the accessible deployment URL.

```bash
# 部署应用请求
curl -X POST http://localhost:8123/api/app/deploy \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "appId": 1984178910452338688
  }'

# 成功响应
{
  "code": 0,
  "data": "http://localhost:8123/static/490009/",
  "message": ""
}

# 应用不存在时的错误响应
{
  "code": 40400,
  "data": null,
  "message": "应用不存在"
}

# 无权限时的错误响应
{
  "code": 40300,
  "data": null,
  "message": "无操作权限"
}
```

--------------------------------

### Create Application API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Creates a new AI code generation application. Requires an initial prompt, which is used to generate the application name (first 12 characters). Defaults to multi-file generation mode.

```bash
# 创建应用请求
curl -X POST http://localhost:8123/api/app/add \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "initPrompt": "创建一个待办事项管理应用，包含添加、删除、标记完成功能，使用现代化的 UI 设计"
  }'

# 成功响应
{
  "code": 0,
  "data": 1984178910452338688,
  "message": ""
}

# 参数错误响应
{
  "code": 40000,
  "data": null,
  "message": "初始化 prompt 不能为空"
}
```

--------------------------------

### User Login API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Authenticates a user and creates a session. Upon successful login, user session information is stored in Redis, and a sanitized user profile is returned. Sessions are valid for 30 days.

```bash
# 用户登录请求
curl -X POST http://localhost:8123/api/user/login \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "userAccount": "testuser",
    "userPassword": "password123"
  }'

# 成功响应
{
  "code": 0,
  "data": {
    "id": 1234567890123456789,
    "userAccount": "testuser",
    "userName": "测试用户",
    "userAvatar": "https://example.com/avatar.jpg",
    "userProfile": "这是用户简介",
    "userRole": "user",
    "createTime": "2024-01-15T10:30:00",
    "updateTime": "2024-01-15T10:30:00"
  },
  "message": ""
}
```

--------------------------------

### Paginate User's Application List using API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

This API endpoint facilitates the pagination and retrieval of all applications created by the currently logged-in user. It supports searching by application name and sorting the results. Each page can contain a maximum of 20 records.

```bash
curl -X POST http://localhost:8123/api/app/my/list/page/vo \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "pageNum": 1,
    "pageSize": 10,
    "appName": "",
    "sortField": "createTime",
    "sortOrder": "descend"
  }'
```

--------------------------------

### User Registration API (Bash)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Registers a new user by sending account, password, and confirmation password. Validates password consistency and stores encrypted passwords. Returns the new user ID upon successful registration.

```bash
# 用户注册请求
curl -X POST http://localhost:8123/api/user/register \
  -H "Content-Type: application/json" \
  -d '{
    "userAccount": "testuser",
    "userPassword": "password123",
    "checkPassword": "password123"
  }'

# 成功响应
{
  "code": 0,
  "data": 1234567890123456789,
  "message": ""
}

# 密码不一致时的错误响应
{
  "code": 40000,
  "data": null,
  "message": "两次输入的密码不一致"
}
```

--------------------------------

### Create Application API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Creates a new AI code generation application. Requires an initial prompt, which is used to derive the application name (first 12 characters) and defaults to multi-file generation mode.

```APIDOC
## POST /api/app/add

### Description
Creates a new AI code generation application. Requires an initial prompt, which is used to derive the application name (first 12 characters) and defaults to multi-file generation mode.

### Method
POST

### Endpoint
/api/app/add

### Parameters
#### Query Parameters
- **cookies.txt** (cookie) - Required - A valid session cookie obtained after login.

#### Request Body
- **initPrompt** (string) - Required - The initial description or prompt for the application.

### Request Example
```json
{
  "initPrompt": "创建一个待办事项管理应用，包含添加、删除、标记完成功能，使用现代化的 UI 设计"
}
```

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (long) - The ID of the newly created application.
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": 1984178910452338688,
  "message": ""
}
```

#### Error Response (40000)
- **code** (integer) - 40000 for bad request.
- **data** (null) - Null.
- **message** (string) - Error message, e.g., "初始化 prompt 不能为空" (Initial prompt cannot be empty).

#### Error Response Example
```json
{
  "code": 40000,
  "data": null,
  "message": "初始化 prompt 不能为空"
}
```
```

--------------------------------

### Paginate My App List

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves a paginated list of applications created by the current user. Supports searching by app name and sorting.

```APIDOC
## POST /api/app/my/list/page/vo

### Description
Retrieves a paginated list of applications created by the current user. Supports searching by application name and sorting. Returns a maximum of 20 records per page.

### Method
POST

### Endpoint
/api/app/my/list/page/vo

### Parameters
#### Request Body
- **pageNum** (integer) - Required - The page number to retrieve.
- **pageSize** (integer) - Required - The number of records per page (max 20).
- **appName** (string) - Optional - Filters applications by name.
- **sortField** (string) - Optional - The field to sort by (e.g., 'createTime').
- **sortOrder** (string) - Optional - The sort order ('ascend' or 'descend').

### Request Example
```json
{
  "pageNum": 1,
  "pageSize": 10,
  "appName": "",
  "sortField": "createTime",
  "sortOrder": "descend"
}
```

### Response
#### Success Response (200)
- **data.records** (array) - A list of application objects.
  - **id** (string) - The application ID.
  - **appName** (string) - The application name.
  - **initPrompt** (string) - The initial prompt for the application.
  - **codeGenType** (string) - The code generation type.
  - **deployKey** (string) - The deployment key.
  - **createTime** (string) - The creation timestamp.
  - **user** (object) - Information about the user who created the app.
    - **id** (integer) - User ID.
    - **userName** (string) - User name.
- **data.pageNumber** (integer) - The current page number.
- **data.pageSize** (integer) - The number of records per page.
- **data.totalRow** (integer) - The total number of records.
- **data.totalPage** (integer) - The total number of pages.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "records": [
      {
        "id": "1984178910452338688",
        "appName": "待办事项管理",
        "initPrompt": "创建一个待办事项管理应用",
        "codeGenType": "multi_file",
        "deployKey": "490009",
        "createTime": "2024-01-15T10:30:00",
        "user": {
          "id": 1234567890123456789,
          "userName": "测试用户"
        }
      }
    ],
    "pageNumber": 1,
    "pageSize": 10,
    "totalRow": 5,
    "totalPage": 1
  },
  "message": ""
}
```
```

--------------------------------

### Admin Paginate All Applications using API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

This is an administrator-only endpoint for paginating and querying all applications created by any user on the platform. It allows filtering by user ID, application name, and other criteria. Requires administrator privileges.

```bash
# Admin query all applications
curl -X POST http://localhost:8123/api/app/admin/list/page/vo \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "pageNum": 1,
    "pageSize": 20,
    "userId": null,
    "appName": "待办"
  }'
```

--------------------------------

### Create App Table Schema (SQL)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Defines the SQL schema for the 'app' table in a MySQL database. It stores application details such as name, cover, initial prompt, code generation type, deployment key, and user association, with indexes for performance.

```sql
-- 应用表
CREATE TABLE app (
    id           BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 'id',
    appName      VARCHAR(256) COMMENT '应用名称',
    cover        VARCHAR(512) COMMENT '应用封面',
    initPrompt   TEXT COMMENT '应用初始化的 prompt',
    codeGenType  VARCHAR(64) COMMENT '代码生成类型：html/multi_file/vue_project',
    deployKey    VARCHAR(64) COMMENT '部署标识',
    deployedTime DATETIME COMMENT '部署时间',
    priority     INT DEFAULT 0 NOT NULL COMMENT '优先级',
    userId       BIGINT NOT NULL COMMENT '创建用户id',
    editTime     DATETIME DEFAULT CURRENT_TIMESTAMP NOT NULL,
    createTime   DATETIME DEFAULT CURRENT_TIMESTAMP NOT NULL,
    updateTime   DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    isDelete     TINYINT DEFAULT 0 NOT NULL COMMENT '是否删除',
    UNIQUE KEY uk_deployKey (deployKey),
    INDEX idx_appName (appName),
    INDEX idx_userId (userId)
) COMMENT '应用' COLLATE = utf8mb4_unicode_ci;
```

--------------------------------

### Admin Paginate App List

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Admin-only endpoint to query all applications created by any user. Supports filtering by user ID, app name, and other criteria.

```APIDOC
## POST /api/app/admin/list/page/vo

### Description
Admin-only endpoint to query all applications created by any user on the platform. Supports filtering by user ID, application name, and other criteria.

### Method
POST

### Endpoint
/api/app/admin/list/page/vo

### Parameters
#### Request Body
- **pageNum** (integer) - Required - The page number to retrieve.
- **pageSize** (integer) - Required - The number of records per page.
- **userId** (integer or null) - Optional - Filters applications by user ID.
- **appName** (string) - Optional - Filters applications by name.

### Request Example
```json
{
  "pageNum": 1,
  "pageSize": 20,
  "userId": null,
  "appName": "待办"
}
```

### Response
#### Success Response (200)
- **data.records** (array) - A list of application objects (structure may vary).
- **data.totalRow** (integer) - The total number of records matching the query.

#### Response Example (Requires Admin Privileges)
```json
{
  "code": 0,
  "data": {
    "records": [...],
    "totalRow": 100
  },
  "message": ""
}
```

#### Error Response (Forbidden)
```json
{
  "code": 40300,
  "data": null,
  "message": "无权限"
}
```
```

--------------------------------

### 统计信息样式

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

为任务统计信息卡片定义了样式，包括背景、内边距、圆角和阴影。使用 Flexbox 布局使统计卡片能够并排显示，并为数值和标签设置了不同的样式。

```css
/* 统计信息 */
.stats {
  display: flex;
  gap: 20px;
  margin-bottom: 20px;
  flex-wrap: wrap;
}
.stat-card {
  background: white;
  padding: 20px;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgba(0, 0, 0, 0.05);
  flex: 1;
  min-width: 150px;
  text-align: center;
}
.stat-value {
  font-size: 2rem;
  font-weight: bold;
  color: #6a11cb;
  margin-bottom: 5px;
}
.stat-label {
  color: #666;
  font-size: 0.9rem;
}
```

--------------------------------

### Paginate Featured App List

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Retrieves a paginated list of featured applications recommended by the platform.

```APIDOC
## POST /api/app/good/list/page/vo

### Description
Retrieves a paginated list of featured applications recommended by the platform. These applications typically have high priority scores and are considered high-quality examples.

### Method
POST

### Endpoint
/api/app/good/list/page/vo

### Parameters
#### Request Body
- **pageNum** (integer) - Required - The page number to retrieve.
- **pageSize** (integer) - Required - The number of records per page.

### Request Example
```json
{
  "pageNum": 1,
  "pageSize": 10
}
```

### Response
#### Success Response (200)
- **data.records** (array) - A list of featured application objects.
  - **id** (string) - The application ID.
  - **appName** (string) - The application name.
  - **initPrompt** (string) - The initial prompt for the application.
  - **codeGenType** (string) - The code generation type.
  - **priority** (integer) - The priority score of the application.
  - **user** (object) - Information about the user who created the app.
    - **userName** (string) - User name.
- **data.totalRow** (integer) - The total number of records.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "records": [
      {
        "id": "1984183857432580096",
        "appName": "个人博客系统",
        "initPrompt": "创建一个现代化的个人博客系统",
        "codeGenType": "multi_file",
        "priority": 1,
        "user": {
          "userName": "官方示例"
        }
      }
    ],
    "totalRow": 3
  },
  "message": ""
}
```
```

--------------------------------

### Show Message Functionality in JavaScript

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

Displays temporary feedback messages to the user. It dynamically creates a message element, styles it based on the message type (success, error, or default), appends it to the body, animates its appearance, and then removes it after a delay.

```javascript
function showMessage(message, type) {
  const messageElement = document.createElement('div');
  messageElement.textContent = message;
  messageElement.style.cssText = ` position: fixed; top: 20px; right: 20px; padding: 15px 20px; border-radius: 8px; color: white; font-weight: bold; z-index: 1000; box-shadow: 0 4px 12px rgba(0,0,0,0.15); transition: transform 0.3s, opacity 0.3s; transform: translateX(100%); opacity: 0; `;

  if (type === 'success') {
    messageElement.style.backgroundColor = '#28a745';
  } else if (type === 'error') {
    messageElement.style.backgroundColor = '#dc3545';
  } else {
    messageElement.style.backgroundColor = '#6a11cb';
  }

  document.body.appendChild(messageElement);

  setTimeout(() => {
    messageElement.style.transform = 'translateX(0)';
    messageElement.style.opacity = '1';
  }, 100);

  setTimeout(() => {
    messageElement.style.transform = 'translateX(100%)';
    messageElement.style.opacity = '0';
    setTimeout(() => {
      document.body.removeChild(messageElement);
    }, 300);
  }, 3000);
}
```

--------------------------------

### Deploy Application API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Deploys the generated code for an application to a live environment. Returns a URL where the deployed application can be accessed. A unique 6-digit deployment identifier is generated for each deployment.

```APIDOC
## POST /api/app/deploy

### Description
Deploys the generated code for an application to a live environment. Returns a URL where the deployed application can be accessed. A unique 6-digit deployment identifier is generated for each deployment.

### Method
POST

### Endpoint
/api/app/deploy

### Parameters
#### Query Parameters
- **cookies.txt** (cookie) - Required - A valid session cookie obtained after login.

#### Request Body
- **appId** (long) - Required - The ID of the application to deploy.

### Request Example
```json
{
  "appId": 1984178910452338688
}
```

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (string) - The URL of the deployed application (e.g., "http://localhost:8123/static/490009/").
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": "http://localhost:8123/static/490009/",
  "message": ""
}
```

#### Error Response (40400)
- **code** (integer) - 40400 for not found.
- **data** (null) - Null.
- **message** (string) - Error message, e.g., "应用不存在" (Application not found).

#### Error Response (40300)
- **code** (integer) - 40300 for forbidden.
- **data** (null) - Null.
- **message** (string) - Error message, e.g., "无操作权限" (No permission).

#### Error Response Example
```json
{
  "code": 40400,
  "data": null,
  "message": "应用不存在"
}
```
```

--------------------------------

### User Registration API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Registers a new user account. Requires user account, password, and password confirmation. Returns the new user's ID upon successful registration.

```APIDOC
## POST /api/user/register

### Description
Registers a new user account. Requires user account, password, and password confirmation. Returns the new user's ID upon successful registration.

### Method
POST

### Endpoint
/api/user/register

### Parameters
#### Request Body
- **userAccount** (string) - Required - The user's account name.
- **userPassword** (string) - Required - The user's password.
- **checkPassword** (string) - Required - The password confirmation.

### Request Example
```json
{
  "userAccount": "testuser",
  "userPassword": "password123",
  "checkPassword": "password123"
}
```

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (long) - The ID of the newly created user.
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": 1234567890123456789,
  "message": ""
}
```

#### Error Response (40000)
- **code** (integer) - 40000 for bad request.
- **data** (null) - Null.
- **message** (string) - Error message, e.g., "两次输入的密码不一致" (Passwords do not match).

#### Error Response Example
```json
{
  "code": 40000,
  "data": null,
  "message": "两次输入的密码不一致"
}
```
```

--------------------------------

### 任务完成状态样式

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

定义了已完成任务的样式，通过添加删除线和改变文本颜色来视觉上区分。还包括任务复选框的样式。

```css
/* 任务完成状态 */
.completed .task-title {
  text-decoration: line-through;
  color: #888;
}
.completed .task-description {
  color: #aaa;
}
.task-checkbox {
  margin-right: 15px;
}
```

--------------------------------

### 搜索和筛选样式

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

为搜索框和分类筛选器定义了样式，使用 Flexbox 布局使其能够灵活排列。该样式支持响应式设计，在小屏幕上会堆叠显示。

```css
/* 搜索和筛选样式 */
.filters {
  display: flex;
  gap: 15px;
  margin-bottom: 20px;
  flex-wrap: wrap;
}
.search-box {
  flex: 1;
  min-width: 250px;
}
.category-filter {
  min-width: 180px;
}
```

--------------------------------

### Vue Router Configuration with Hash History

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/src/main/resources/prompt/codegen-vue-file-system-prompt.txt

Sets up Vue Router with hash history mode, suitable for avoiding server-side routing configuration issues. It defines the router instance and includes a placeholder for route configurations.

```javascript
import { createRouter, createWebHashHistory } from 'vue-router'

const router = createRouter({
  history: createWebHashHistory(),
  routes: [
    // 路由配置
  ]
})
```

--------------------------------

### Create User Table Schema (SQL)

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Defines the SQL schema for the 'user' table in a MySQL database. It includes fields for user authentication, profile information, roles, and timestamps, with unique constraints on 'userAccount' and indexes for efficient querying.

```sql
-- 用户表
CREATE TABLE user (
    id           BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 'id',
    userAccount  VARCHAR(256) NOT NULL COMMENT '账号',
    userPassword VARCHAR(512) NOT NULL COMMENT '密码',
    userName     VARCHAR(256) COMMENT '用户昵称',
    userAvatar   VARCHAR(1024) COMMENT '用户头像',
    userProfile  VARCHAR(512) COMMENT '用户简介',
    userRole     VARCHAR(256) DEFAULT 'user' NOT NULL COMMENT '用户角色：user/admin',
    editTime     DATETIME DEFAULT CURRENT_TIMESTAMP NOT NULL,
    createTime   DATETIME DEFAULT CURRENT_TIMESTAMP NOT NULL,
    updateTime   DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    isDelete     TINYINT DEFAULT 0 NOT NULL COMMENT '是否删除',
    UNIQUE KEY uk_userAccount (userAccount),
    INDEX idx_userName (userName)
) COMMENT '用户' COLLATE = utf8mb4_unicode_ci;
```

--------------------------------

### Admin Update Application using API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

This administrator endpoint allows for the modification of any application's information, including its name, cover image, and priority. It requires the application ID and the fields to be updated in the request body.

```bash
# Admin update application
curl -X POST http://localhost:8123/api/app/admin/update \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "id": 1984178910452338688,
    "appName": "精选：待办事项管理",
    "priority": 1,
    "cover": "https://example.com/cover.jpg"
  }'
```

--------------------------------

### 头部样式

Source: https://github.com/xiaohei1022/hei-ai-code/blob/main/tmp/code_output/html_1984441782763851776/index.html

为网站的头部区域定义了样式，包括背景渐变、文字颜色、内边距、居中文本以及圆角和阴影效果。这部分代码用于创建醒目的页面标题区域。

```css
/* 头部样式 */
header {
  background: linear-gradient(135deg, #6a11cb 0%, #2575fc 100%);
  color: white;
  padding: 30px 0;
  text-align: center;
  border-radius: 0 0 20px 20px;
  margin-bottom: 30px;
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
}
header h1 {
  font-size: 2.5rem;
  margin-bottom: 10px;
}
header p {
  font-size: 1.1rem;
  opacity: 0.9;
}
```

--------------------------------

### User Authentication API

Source: https://context7.com/xiaohei1022/hei-ai-code/llms.txt

Handles user login and session creation. Upon successful login, a user session is stored in Redis, and a de-sensitized user information object is returned. Sessions are valid for 30 days.

```APIDOC
## POST /api/user/login

### Description
Handles user login and session creation. Upon successful login, a user session is stored in Redis, and a de-sensitized user information object is returned. Sessions are valid for 30 days.

### Method
POST

### Endpoint
/api/user/login

### Parameters
#### Request Body
- **userAccount** (string) - Required - The user's account name.
- **userPassword** (string) - Required - The user's password.

### Request Example
```json
{
  "userAccount": "testuser",
  "userPassword": "password123"
}
```

### Response
#### Success Response (200)
- **code** (integer) - 0 for success.
- **data** (object) - De-sensitized user information.
  - **id** (long) - User ID.
  - **userAccount** (string) - User account.
  - **userName** (string) - User name.
  - **userAvatar** (string) - User avatar URL.
  - **userProfile** (string) - User profile description.
  - **userRole** (string) - User role (e.g., "user").
  - **createTime** (string) - User creation timestamp (ISO 8601 format).
  - **updateTime** (string) - User update timestamp (ISO 8601 format).
- **message** (string) - An empty string if successful.

#### Response Example
```json
{
  "code": 0,
  "data": {
    "id": 1234567890123456789,
    "userAccount": "testuser",
    "userName": "测试用户",
    "userAvatar": "https://example.com/avatar.jpg",
    "userProfile": "这是用户简介",
    "userRole": "user",
    "createTime": "2024-01-15T10:30:00",
    "updateTime": "2024-01-15T10:30:00"
  },
  "message": ""
}
```
```
Tokens:
Raw