### Get Role Tree

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this GET endpoint to retrieve a tree structure of all roles, useful for user role assignment.

```Java
// GET请求获取角色树
// URL: http://localhost:8080/bid/sysRole/allTree/json

// curl示例
// curl http://localhost:8080/bid/sysRole/allTree/json -b cookies.txt

// 成功响应
[
    {
        "id": "role-uuid-001",
        "name": "管理员",
        "children": []
    },
    {
        "id": "role-uuid-002",
        "name": "招标专员",
        "children": []
    }
]
```

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

### POST /bid/tender/dataGrid/json - Get Bid List

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a paginated list of bid records with support for filtering.

```APIDOC
## POST /bid/tender/dataGrid/json

### Description

分页查询投标记录列表，支持条件筛选。

### Method

POST

### Endpoint

http://localhost:8080/bid/tender/dataGrid/json

### Parameters

#### Query Parameters

- **page** (Integer) - Optional - Page number
- **rows** (Integer) - Optional - Number of records per page
- **sort** (String) - Optional - Field to sort by (default: tenderDate)
- **order** (String) - Optional - Sort order (default: desc)

### Request Example

```json
{
  "page": 1,
  "rows": 10
}
```

### Response

#### Success Response (200)

- **page** (Integer) - Current page number
- **rows** (Integer) - Number of records per page
- **total** (Integer) - Total number of records
- **pageResult** (Array) - Array of bid records
  - **id** (String) - Bid ID
  - **badId** (String) - Notice ID
  - **userId** (String) - User ID
  - **content** (String) - Bid content
  - **amount** (String) - Bid amount
  - **tenderDate** (String) - Bid date
  - **fileId** (String) - File ID
  - **createTime** (String) - Creation timestamp

#### Response Example

```json
{
    "page": 1,
    "rows": 10,
    "total": 25,
    "pageResult": [
        {
            "id": "tender-uuid-001",
            "badId": "notice-uuid-001",
            "userId": "tby-uuid",
            "content": "我公司承诺按照招标要求提供优质产品",
            "amount": "480000",
            "tenderDate": "2024-01-20",
            "fileId": "file-uuid-001",
            "createTime": "2024-01-20 14:30:00"
        }
    ]
}
```
```

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

### Get Resource Tree List

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the hierarchical list of menu resources. Requires sys:resource:view permission.

```java
// POST请求获取资源列表
// URL: http://localhost:8080/bid/sysResource/treeGrid/json
// 权限要求：sys:resource:view

// curl示例
// curl -X POST http://localhost:8080/bid/sysResource/treeGrid/json -b cookies.txt

// 成功响应
[
    {
        "resourceId": "res-uuid-001",
        "resourceName": "系统管理",
        "resourcePid": null,
        "resourceType": "0",
        "url": "/sys",
        "icon": "fa-cog",
        "permCode": "sys",
        "resourceSeq": 1,
        "children": [
            {
                "resourceId": "res-uuid-002",
                "resourceName": "用户管理",
                "resourceType": "1",
                "url": "/sysUser",
                "permCode": "sys:user:view"
            }
        ]
    }
]
```

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

### Get User Menu Tree

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the menu tree authorized for the currently logged-in user.

```java
// POST请求获取用户菜单
// URL: http://localhost:8080/bid/sysResource/userMenuTree/json

// curl示例
// curl -X POST http://localhost:8080/bid/sysResource/userMenuTree/json -b cookies.txt

// 成功响应
[
    {
        "id": "res-uuid-001",
        "name": "公告管理",
        "url": "/notice",
        "icon": "fa-bullhorn",
        "children": []
    },
    {
        "id": "res-uuid-002",
        "name": "投标管理",
        "url": "/tender",
        "icon": "fa-file-text",
        "children": []
    }
]
```

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

### POST /bid/comment/dataGrid/json - Get Evaluation List

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a paginated list of bid evaluation records.

```APIDOC
## POST /bid/comment/dataGrid/json

### Description

分页查询评标记录列表。

### Method

POST

### Endpoint

http://localhost:8080/bid/comment/dataGrid/json

### Parameters

#### Query Parameters

- **page** (Integer) - Optional - Page number
- **rows** (Integer) - Optional - Number of records per page

### Request Example

```json
{
  "page": 1,
  "rows": 10
}
```

### Response

#### Success Response (200)

- **page** (Integer) - Current page number
- **rows** (Integer) - Number of records per page
- **total** (Integer) - Total number of records
- **pageResult** (Array) - Array of evaluation records
  - **id** (String) - Evaluation ID
  - **badId** (String) - Notice ID
  - **tenderId** (String) - Bid ID
  - **userId** (String) - User ID (evaluator)
  - **status** (String) - Evaluation status (e.g., '1' for pass, '0' for fail)
  - **content** (String) - Evaluation content
  - **createTime** (String) - Creation timestamp

#### Response Example

```json
{
    "page": 1,
    "rows": 10,
    "total": 15,
    "pageResult": [
        {
            "id": "comment-uuid-001",
            "badId": "notice-uuid-001",
            "tenderId": "tender-uuid-001",
            "userId": "pby-uuid",
            "status": "1",
            "content": "该投标方案技术可行，报价合理",
            "createTime": "2024-02-01 10:00:00"
        }
    ]
}
```
```

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

### Get Role List (Paginated)

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this endpoint to retrieve a paginated list of system roles. Requires sys:role:view permission.

```Java
// POST请求获取角色列表
// URL: http://localhost:8080/bid/sysRole/dataGrid/json
// 权限要求：sys:role:view

// curl示例
// curl -X POST http://localhost:8080/bid/sysRole/dataGrid/json \
//   -d "page=1&rows=10" \
//   -b cookies.txt

// 成功响应
{
    "page": 1,
    "rows": 10,
    "pageResult": [
        {
            "roleId": "role-uuid-001",
            "roleName": "招标专员",
            "roleSeq": 2,
            "roleStatus": "1",
            "description": "负责发布招标公告"
        }
    ]
}
```

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

### Get User List (Paginated)

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this endpoint to retrieve a paginated list of system users. Requires sys:user:view permission.

```Java
// POST请求获取用户列表
// URL: http://localhost:8080/bid/sysUser/dataGrid/json
// 权限要求：sys:user:view

// 请求参数
Integer page = 1;
Integer rows = 10;
String sort = "createTime";
String order = "desc";

// curl示例
// curl -X POST http://localhost:8080/bid/sysUser/dataGrid/json \
//   -d "page=1&rows=10" \
//   -b cookies.txt

// 成功响应
{
    "page": 1,
    "rows": 10,
    "total": 20,
    "pageResult": [
        {
            "userId": "user-uuid-001",
            "loginName": "zby",
            "userName": "张招标",
            "sex": "1",
            "phone": "13800138000",
            "email": "zby@example.com",
            "orgId": "org-uuid-001",
            "userStatus": "1",
            "loginCount": 15,
            "lastvisitDate": "2024-01-20 10:30:00"
        }
    ]
}
```

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

### GET /bid/sysLog/allTypeTree/json

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a tree structure of all log types for filtering purposes.

```APIDOC
## GET /bid/sysLog/allTypeTree/json

### Description
Get all log types in a tree structure for log filtering.

### Method
GET

### Endpoint
http://localhost:8080/bid/sysLog/allTypeTree/json

### Response
#### Success Response (200)
- **id** (string) - Type ID
- **name** (string) - Type name
```

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

### GET /bid/file/download

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Downloads an attachment based on the provided file ID.

```APIDOC
## GET /bid/file/download

### Description
Download an attachment based on the file ID.

### Method
GET

### Endpoint
http://localhost:8080/bid/file/download

### Parameters
#### Query Parameters
- **fileId** (string) - Required - The unique identifier of the file

### Response
#### Success Response (200)
- Returns file binary stream with Content-Type: application/octet-stream
```

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

### Get System Log List API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieve a paginated list of system operation logs. This POST request requires parameters for pagination and sorting. The endpoint is protected by 'sys:log:view' permission.

```Java
// POST请求获取日志列表
// URL: http://localhost:8080/bid/sysLog/dataGrid/json
// 权限要求：sys:log:view

// 请求参数
Integer page = 1;
Integer rows = 10;
String sort = "createTime";
String order = "desc";
```

```Shell
// curl示例
// curl -X POST http://localhost:8080/bid/sysLog/dataGrid/json \
//   -d "page=1&rows=10" \
//   -b cookies.txt
```

```JSON
// 成功响应
{
    "page": 1,
    "rows": 10,
    "total": 100,
    "pageResult": [
        {
            "logId": "log-uuid-001",
            "loginName": "admin",
            "logType": "1",
            "logContent": "登陆成功",
            "requestUri": "/admin/login",
            "requestMethod": "POST",
            "remoteAddr": "192.168.1.100",
            "userAgent": "Mozilla/5.0...",
            "createTime": "2024-01-20 10:30:00"
        }
    ]
}
```

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

### Get Dictionary Tree List

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the hierarchical structure of system dictionaries. Requires sys:dict:view permission.

```java
// POST请求获取字典列表
// URL: http://localhost:8080/bid/sysDict/treeGrid/json
// 权限要求：sys:dict:view

// curl示例
// curl -X POST http://localhost:8080/bid/sysDict/treeGrid/json -b cookies.txt

// 成功响应
[
    {
        "dictId": "dict-uuid-001",
        "dictCode": "industry_type",
        "dictName": "行业类型",
        "dictType": "0",
        "dictPid": null,
        "children": [
            {
                "dictId": "dict-uuid-002",
                "dictCode": "1",
                "dictName": "服务",
                "dictType": "1"
            },
            {
                "dictId": "dict-uuid-003",
                "dictCode": "2",
                "dictName": "商品",
                "dictType": "1"
            }
        ]
    }
]
```

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

### Get Log Type Tree API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Fetch a tree structure of all log types for filtering purposes. This is a GET request.

```Java
// GET请求获取日志类型树
// URL: http://localhost:8080/bid/sysLog/allTypeTree/json
```

```Shell
// curl示例
// curl http://localhost:8080/bid/sysLog/allTypeTree/json -b cookies.txt
```

```JSON
// 成功响应
[
    {
        "id": "1",
        "name": "登录日志"
    },
    {
        "id": "2",
        "name": "操作日志"
    }
]
```

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

### 用户退出 API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

安全退出系统并清除用户会话信息。支持 GET 或 POST 请求。

```Java
// GET/POST请求退出示例
// URL: http://localhost:8080/bid/admin/logout

// curl示例
// curl http://localhost:8080/bid/admin/logout -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "您已安全退出"
}
```

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

### Get Organization Tree List

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the full hierarchical structure of organizations. Requires sys:org:view permission.

```java
// POST请求获取机构列表
// URL: http://localhost:8080/bid/sysOrg/treeGrid/json
// 权限要求：sys:org:view

// curl示例
// curl -X POST http://localhost:8080/bid/sysOrg/treeGrid/json -b cookies.txt

// 成功响应
[
    {
        "orgId": "org-uuid-001",
        "orgName": "总公司",
        "orgPid": null,
        "orgSeq": 1,
        "orgAddress": "北京市",
        "children": [
            {
                "orgId": "org-uuid-002",
                "orgName": "采购部",
                "orgPid": "org-uuid-001",
                "orgSeq": 1
            }
        ]
    }
]
```

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

### Get Evaluation List API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a paginated list of evaluation records. Requires 'tender:comment:view' permission.

```java
// POST请求获取评标列表
// URL: http://localhost:8080/bid/comment/dataGrid/json
// 权限要求：tender:comment:view

// 请求参数
Integer page = 1;
Integer rows = 10;

// curl示例
// curl -X POST http://localhost:8080/bid/comment/dataGrid/json \
//   -d "page=1&rows=10" \
//   -b cookies.txt

// 成功响应
{
    "page": 1,
    "rows": 10,
    "total": 15,
    "pageResult": [
        {
            "id": "comment-uuid-001",
            "badId": "notice-uuid-001",
            "tenderId": "tender-uuid-001",
            "userId": "pby-uuid",
            "status": "1",
            "content": "该投标方案技术可行，报价合理",
            "createTime": "2024-02-01 10:00:00"
        }
    ]
}
```

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

### Download File API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Download a file by its ID using a GET request. The response will be a file stream. A 404 Not Found error is returned if the file does not exist.

```Java
// GET请求下载文件
// URL: http://localhost:8080/bid/file/download?fileId=file-uuid-001
```

```Shell
// curl示例
// curl -o downloaded_file.pdf \
//   "http://localhost:8080/bid/file/download?fileId=file-uuid-001" \
//   -b cookies.txt
```

```HTTP
// 成功响应：返回文件二进制流
// Content-Type: application/octet-stream
// Content-Disposition: attachment; filename="原文件名.pdf"

// 文件不存在响应：HTTP 404 Not Found
```

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

### Get Tender List API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a paginated list of tender records with support for conditional filtering. Requires 'tender:tender:view' permission.

```java
// POST请求获取投标列表
// URL: http://localhost:8080/bid/tender/dataGrid/json
// 权限要求：tender:tender:view

// 请求参数
Integer page = 1;
Integer rows = 10;
String sort = "tenderDate";
String order = "desc";

// curl示例
// curl -X POST http://localhost:8080/bid/tender/dataGrid/json \
//   -d "page=1&rows=10" \
//   -b cookies.txt

// 成功响应
{
    "page": 1,
    "rows": 10,
    "total": 25,
    "pageResult": [
        {
            "id": "tender-uuid-001",
            "badId": "notice-uuid-001",
            "userId": "tby-uuid",
            "content": "我公司承诺按照招标要求提供优质产品",
            "amount": "480000",
            "tenderDate": "2024-01-20",
            "fileId": "file-uuid-001",
            "createTime": "2024-01-20 14:30:00"
        }
    ]
}
```

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

### POST /bid/sysResource/add

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new menu or button resource.

```APIDOC
## POST /bid/sysResource/add

### Description
Adds a new resource, menu, or button to the system.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysResource/add

### Request Body
- **resourceName** (string) - Required - Name of the resource
- **resourcePid** (string) - Optional - Parent resource ID
- **resourceType** (string) - Required - Type (0-directory, 1-menu, 2-button)
- **url** (string) - Optional - Resource URL
- **icon** (string) - Optional - Icon class
- **permCode** (string) - Optional - Permission code
- **resourceSeq** (integer) - Optional - Sorting order

### Response
#### Success Response (200)
- **success** (boolean) - Operation status
- **msg** (string) - Result message
```

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

### POST /admin/login

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

用户登录接口，通过用户名和密码进行身份验证，成功后创建会话。

```APIDOC
## POST /admin/login

### Description
用户登录接口，通过Apache Shiro进行身份验证，登录成功后创建会话并记录登录日志。

### Method
POST

### Endpoint
/bid/admin/login

### Request Body
- **username** (string) - Required - 用户名
- **password** (string) - Required - 密码
- **captcha** (string) - Optional - 验证码

### Response
#### Success Response (200)
- 重定向到首页

#### Response Example
{
    "success": false,
    "msg": "用户名不存在"
}
```

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

### Add Menu Resource

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new menu or button resource. Requires sys:resource:add permission.

```java
// POST请求添加资源
// URL: http://localhost:8080/bid/sysResource/add
// 权限要求：sys:resource:add

// 请求参数
SysResource sysResource = new SysResource();
sysResource.setResourceName("报表管理");
sysResource.setResourcePid("res-uuid-001");    // 上级资源ID
sysResource.setResourceType("1");              // 类型：0-目录，1-菜单，2-按钮
sysResource.setUrl("/report");
sysResource.setIcon("fa-chart");
sysResource.setPermCode("sys:report:view");
sysResource.setResourceSeq(5);

// curl示例
// curl -X POST http://localhost:8080/bid/sysResource/add \
//   -d "resourceName=报表管理&resourceType=1&url=/report&permCode=sys:report:view&resourceSeq=5" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### Add New User

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this endpoint to create a new system user. Usernames must be unique. Requires sys:user:add permission.

```Java
// POST请求添加用户
// URL: http://localhost:8080/bid/sysUser/add
// 权限要求：sys:user:add

// 请求参数
SysUserVo sysUserVo = new SysUserVo();
sysUserVo.setLoginName("newuser");
sysUserVo.setUserName("新用户");
sysUserVo.setSex("1");              // 性别：1-男，0-女
sysUserVo.setPhone("13900139000");
sysUserVo.setEmail("newuser@example.com");
sysUserVo.setOrgId("org-uuid-001"); // 所属机构ID
sysUserVo.setRoleIds("role-uuid-001,role-uuid-002");  // 角色ID列表

// curl示例
// curl -X POST http://localhost:8080/bid/sysUser/add \
//   -d "loginName=newuser&userName=新用户&sex=1&phone=13900139000&roleIds=role-uuid-001" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功"
}

// 用户名重复响应
{
    "success": false,
    "msg": "用户名已存在!"
}
```

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

### POST /bid/sysOrg/add

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new organization record.

```APIDOC
## POST /bid/sysOrg/add

### Description
Creates a new organization entry in the system.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysOrg/add

### Request Body
- **orgName** (string) - Required - Name of the organization
- **orgPid** (string) - Optional - Parent organization ID
- **orgSeq** (integer) - Optional - Sorting order
- **orgAddress** (string) - Optional - Organization address
- **description** (string) - Optional - Description of the organization

### Response
#### Success Response (200)
- **success** (boolean) - Operation status
- **msg** (string) - Result message

#### Response Example
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### POST /bid/sysLog/dataGrid/json

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves a paginated list of system operation logs.

```APIDOC
## POST /bid/sysLog/dataGrid/json

### Description
Paginated query for system operation logs.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysLog/dataGrid/json

### Parameters
#### Request Body
- **page** (Integer) - Optional - Page number
- **rows** (Integer) - Optional - Number of rows per page
- **sort** (String) - Optional - Sort field
- **order** (String) - Optional - Sort order (asc/desc)

### Response
#### Success Response (200)
- **page** (Integer) - Current page
- **rows** (Integer) - Rows per page
- **total** (Integer) - Total records
- **pageResult** (Array) - List of log objects
```

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

### POST /notice/dataGrid/json

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

分页查询招标公告列表，支持条件筛选和排序。

```APIDOC
## POST /notice/dataGrid/json

### Description
分页查询招标公告列表，支持条件筛选和排序。

### Method
POST

### Endpoint
/bid/notice/dataGrid/json

### Query Parameters
- **page** (Integer) - Required - 页码
- **rows** (Integer) - Required - 每页条数
- **sort** (String) - Optional - 排序字段
- **order** (String) - Optional - 排序方向

### Response
#### Success Response (200)
- **page** (Integer) - 当前页码
- **rows** (Integer) - 每页条数
- **total** (Integer) - 总记录数
- **pageResult** (Array) - 公告列表数据

#### Response Example
{
    "page": 1,
    "rows": 10,
    "total": 50,
    "pageResult": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "title": "办公设备采购招标公告",
            "createTime": "2024-01-15 10:30:00"
        }
    ]
}
```

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

### Add New Role

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this endpoint to create a new system role. Requires sys:role:add permission.

```Java
// POST请求添加角色
// URL: http://localhost:8080/bid/sysRole/add
// 权限要求：sys:role:add

// 请求参数
SysRole sysRole = new SysRole();
sysRole.setRoleName("审计专员");
sysRole.setRoleSeq(5);
sysRole.setRoleStatus("1");
sysRole.setDescription("负责招投标审计工作");

// curl示例
// curl -X POST http://localhost:8080/bid/sysRole/add \
//   -d "roleName=审计专员&roleSeq=5&roleStatus=1&description=负责招投标审计工作" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### POST /notice/add

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

招标专员创建新的招标公告。

```APIDOC
## POST /notice/add

### Description
招标专员创建新的招标公告，商品类型招标金额不得超过100万。

### Method
POST

### Endpoint
/bid/notice/add

### Request Body
- **title** (String) - Required - 公告标题
- **content** (String) - Required - 公告内容
- **amount** (String) - Required - 招标金额
- **industryType** (String) - Required - 行业类型：1-服务，2-商品
- **tenderDate** (String) - Required - 投标截止日期
- **badDate** (String) - Required - 评标截止日期
- **fileId** (String) - Optional - 附件关联ID

### Response
#### Success Response (200)
- **success** (Boolean) - 操作结果
- **msg** (String) - 提示信息

#### Response Example
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### POST /bid/sysDict/add

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new dictionary category or item.

```APIDOC
## POST /bid/sysDict/add

### Description
Adds a new dictionary entry.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysDict/add

### Request Body
- **dictCode** (string) - Required - Unique code
- **dictName** (string) - Required - Display name
- **dictType** (string) - Required - Type (0-category, 1-item)
- **dictPid** (string) - Optional - Parent ID
- **dictSeq** (integer) - Optional - Sorting order
- **description** (string) - Optional - Description

### Response
#### Success Response (200)
- **success** (boolean) - Operation status
- **msg** (string) - Result message
```

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

### POST /bid/sysResource/treeGrid/json

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the tree structure of all system resources and menus.

```APIDOC
## POST /bid/sysResource/treeGrid/json

### Description
Retrieves all menu and resource data in a tree structure.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysResource/treeGrid/json

### Response
#### Success Response (200)
- **resourceId** (string) - Resource ID
- **resourceName** (string) - Resource Name
- **resourceType** (string) - Type (0-directory, 1-menu)
- **url** (string) - Resource URL
- **permCode** (string) - Permission code

#### Response Example
[
    {
        "resourceId": "res-uuid-001",
        "resourceName": "系统管理",
        "resourceType": "0",
        "url": "/sys",
        "permCode": "sys",
        "children": []
    }
]
```

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

### POST /bid/sysResource/userMenuTree/json

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Retrieves the menu tree accessible by the currently logged-in user.

```APIDOC
## POST /bid/sysResource/userMenuTree/json

### Description
Fetches the navigation menu tree based on user permissions.

### Method
POST

### Endpoint
http://localhost:8080/bid/sysResource/userMenuTree/json

### Response
#### Success Response (200)
- **id** (string) - Resource ID
- **name** (string) - Menu name
- **url** (string) - Menu URL
- **icon** (string) - Icon class
- **children** (array) - Sub-menus
```

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

### Role Authorization

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Use this endpoint to assign menu and button permissions to a role. Requires sys:role:grant permission.

```Java
// POST请求角色授权
// URL: http://localhost:8080/bid/sysRole/grant
// 权限要求：sys:role:grant

// 请求参数
String id = "role-uuid-001";                    // 角色ID
String resourceIds = "res-001,res-002,res-003"; // 资源ID列表（逗号分隔）

// curl示例
// curl -X POST http://localhost:8080/bid/sysRole/grant \
//   -d "id=role-uuid-001&resourceIds=res-001,res-002,res-003" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "授权成功！"
}
```

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

### Add Organization

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new organization record. Requires sys:org:add permission.

```java
// POST请求添加机构
// URL: http://localhost:8080/bid/sysOrg/add
// 权限要求：sys:org:add

// 请求参数
SysOrg sysOrg = new SysOrg();
sysOrg.setOrgName("技术部");
sysOrg.setOrgPid("org-uuid-001");   // 上级机构ID
sysOrg.setOrgSeq(3);                // 排序号
sysOrg.setOrgAddress("北京市海淀区");
sysOrg.setDescription("负责技术研发");

// curl示例
// curl -X POST http://localhost:8080/bid/sysOrg/add \
//   -d "orgName=技术部&orgPid=org-uuid-001&orgSeq=3&orgAddress=北京市海淀区" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### 添加招标公告 API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

创建新的招标公告。商品类型招标金额不得超过100万。需要 tender:notice:add 权限。

```Java
// POST请求添加公告
// URL: http://localhost:8080/bid/notice/add
// 权限要求：tender:notice:add

// 请求参数
Notice notice = new Notice();
notice.setTitle("办公设备采购招标公告");
notice.setContent("采购办公电脑100台，详见附件技术规格要求");
notice.setAmount("500000");           // 招标金额
notice.setIndustryType("1");          // 行业类型：1-服务，2-商品
notice.setTenderDate("2024-01-30");   // 投标截止日期
notice.setBadDate("2024-02-15");      // 评标截止日期
notice.setFileId("file-relation-id"); // 附件关联ID

// curl示例
// curl -X POST http://localhost:8080/bid/notice/add \
//   -d "title=办公设备采购招标公告&content=采购办公电脑100台&amount=500000&industryType=1&tenderDate=2024-01-30&badDate=2024-02-15" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功！"
}

// 失败响应（商品类型金额超限）
{
    "success": false,
    "msg": "招标类型为商品时，招标金额不得大于100万"
}
```

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

### Add Dictionary Data

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Creates a new dictionary category or item. Requires sys:dict:add permission.

```java
// POST请求添加字典
// URL: http://localhost:8080/bid/sysDict/add
// 权限要求：sys:dict:add

// 请求参数
SysDict sysDict = new SysDict();
sysDict.setDictCode("tender_status");
sysDict.setDictName("招标状态");
sysDict.setDictType("0");           // 类型：0-分类，1-字典项
sysDict.setDictPid(null);           // 上级字典ID
sysDict.setDictSeq(3);
sysDict.setDescription("招标公告状态");

// curl示例
// curl -X POST http://localhost:8080/bid/sysDict/add \
//   -d "dictCode=tender_status&dictName=招标状态&dictType=0&dictSeq=3" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "添加成功！"
}
```

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

### 修改密码 API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

允许当前登录用户修改密码，需要提供旧密码进行验证。仅限登录用户操作。

```Java
// POST请求修改密码示例
// URL: http://localhost:8080/bid/sysUser/editUserPwd
// 权限要求：登录用户

// 请求参数
String oldPwd = "原密码";
String pwd = "新密码";

// curl示例
// curl -X POST http://localhost:8080/bid/sysUser/editUserPwd \
//   -d "oldPwd=admin&pwd=newpassword" \
//   -b cookies.txt

// 成功响应
{
    "success": true,
    "msg": "密码修改成功，请牢记！"
}

// 失败响应
{
    "success": false,
    "msg": "旧密码不正确"
}
```

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

### POST /bid/file/upload

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

Uploads multiple files and returns a relation ID for association with business records.

```APIDOC
## POST /bid/file/upload

### Description
Batch upload files and return a relation ID for association with announcements or bid records.

### Method
POST

### Endpoint
http://localhost:8080/bid/file/upload

### Parameters
#### Request Body
- **files** (CommonsMultipartFile[]) - Required - Array of files to upload
- **model** (String) - Required - Business module identifier (e.g., "notice")

### Response
#### Success Response (200)
- **success** (boolean) - Status of the operation
- **msg** (string) - Error or status message
- **obj** (object) - Contains the relationId

#### Response Example
{
    "success": true,
    "msg": "",
    "obj": {
        "relationId": "file-relation-uuid-001"
    }
}
```

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

### Role Management API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

APIs for managing system roles, including listing, adding, granting permissions, and retrieving role trees.

```APIDOC
## POST /bid/sysRole/dataGrid/json

### Description
Paginate and query the system role list.

### Method
POST

### Endpoint
/bid/sysRole/dataGrid/json

### Query Parameters
- **page** (Integer) - Optional - The page number for pagination.
- **rows** (Integer) - Optional - The number of rows per page.

### Request Example
```json
{
  "page": 1,
  "rows": 10
}
```

### Response
#### Success Response (200)
- **page** (Integer) - The current page number.
- **rows** (Integer) - The number of rows per page.
- **pageResult** (Array) - An array of role objects.
  - **roleId** (String) - The unique identifier for the role.
  - **roleName** (String) - The name of the role.
  - **roleSeq** (Integer) - The sequence number for the role.
  - **roleStatus** (String) - The status of the role ('1' for active, '0' for inactive).
  - **description** (String) - A description of the role.

#### Response Example
```json
{
    "page": 1,
    "rows": 10,
    "pageResult": [
        {
            "roleId": "role-uuid-001",
            "roleName": "招标专员",
            "roleSeq": 2,
            "roleStatus": "1",
            "description": "负责发布招标公告"
        }
    ]
}
```
```

```APIDOC
## POST /bid/sysRole/add

### Description
Create a new system role.

### Method
POST

### Endpoint
/bid/sysRole/add

### Request Body
- **roleName** (String) - Required - The name of the role.
- **roleSeq** (Integer) - Optional - The sequence number for the role.
- **roleStatus** (String) - Optional - The status of the role ('1' for active, '0' for inactive).
- **description** (String) - Optional - A description of the role.

### Request Example
```json
{
  "roleName": "审计专员",
  "roleSeq": 5,
  "roleStatus": "1",
  "description": "负责招投标审计工作"
}
```

### Response
#### Success Response (200)
- **success** (Boolean) - Indicates if the operation was successful.
- **msg** (String) - A message indicating the result of the operation.

#### Response Example
```json
{
    "success": true,
    "msg": "添加成功！"
}
```
```

```APIDOC
## POST /bid/sysRole/grant

### Description
Assign menu and button permissions to a role.

### Method
POST

### Endpoint
/bid/sysRole/grant

### Request Body
- **id** (String) - Required - The ID of the role to grant permissions to.
- **resourceIds** (String) - Required - A comma-separated list of resource IDs.

### Request Example
```json
{
  "id": "role-uuid-001",
  "resourceIds": "res-001,res-002,res-003"
}
```

### Response
#### Success Response (200)
- **success** (Boolean) - Indicates if the operation was successful.
- **msg** (String) - A message indicating the result of the operation.

#### Response Example
```json
{
    "success": true,
    "msg": "授权成功！"
}
```
```

```APIDOC
## GET /bid/sysRole/allTree/json

### Description
Retrieve a tree structure of all roles for user role assignment.

### Method
GET

### Endpoint
/bid/sysRole/allTree/json

### Response
#### Success Response (200)
- Returns an array of role objects with a tree structure.
  - **id** (String) - The unique identifier for the role.
  - **name** (String) - The name of the role.
  - **children** (Array) - An array of child roles, if any.

#### Response Example
```json
[
    {
        "id": "role-uuid-001",
        "name": "管理员",
        "children": []
    },
    {
        "id": "role-uuid-002",
        "name": "招标专员",
        "children": []
    }
]
```
```

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

### 获取公告列表 API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

分页查询招标公告列表，支持按指定字段排序和条件筛选。需要 tender:notice:view 权限。

```Java
// POST请求获取公告列表
// URL: http://localhost:8080/bid/notice/dataGrid/json
// 权限要求：tender:notice:view

// 请求参数
Integer page = 1;        // 页码
Integer rows = 10;       // 每页条数
String sort = "createTime";  // 排序字段
String order = "desc";   // 排序方向

// curl示例
// curl -X POST http://localhost:8080/bid/notice/dataGrid/json \
//   -d "page=1&rows=10&sort=createTime&order=desc" \
//   -b cookies.txt

// 成功响应
{
    "page": 1,
    "rows": 10,
    "total": 50,
    "pageResult": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "userId": "admin-uuid",
            "title": "办公设备采购招标公告",
            "content": "采购办公电脑100台",
            "amount": "500000",
            "industryType": "1",
            "status": "0",
            "noticeDate": "2024-01-15",
            "tenderDate": "2024-01-30",
            "badDate": "2024-02-15",
            "createTime": "2024-01-15 10:30:00"
        }
    ]
}
```

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

### 用户登录 API

Source: https://context7.com/doudoutangs/1.bid_system/llms.txt

通过用户名和密码进行用户身份验证。成功后创建会话并记录登录日志。支持可选的验证码。

```Java
// POST请求登录示例
// URL: http://localhost:8080/bid/admin/login
// Content-Type: application/x-www-form-urlencoded

// 请求参数
String username = "admin";
String password = "admin";
String captcha = "";  // 验证码（可选）

// curl示例
// curl -X POST http://localhost:8080/bid/admin/login \
//   -d "username=admin&password=admin" \
//   -c cookies.txt

// 登录成功响应：重定向到首页
// 登录失败响应
{
    "success": false,
    "msg": "用户名不存在"  // 或 "密码错误"、"账户锁定状态"
}
```