cadannotation/README.md

CadLabel Backend

Spring Boot backend skeleton for CadLabel.

Stack

• Java 21
• Spring Boot 3.4.4
• Maven
• MyBatis-Plus
• MySQL
• Tencent Cloud COS SDK

This project intentionally does not include Spring Security, JWT, login APIs, or user-system code.

Run

mvn test
mvn spring-boot:run

The default profile is dev. Configure these environment variables before starting against a real database and COS bucket:

export APP_DB_URL='jdbc:mysql://localhost:3306/cadlabel?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&createDatabaseIfNotExist=true'
export APP_DB_USERNAME='root'
export APP_DB_PASSWORD=''

export APP_COS_SECRET_ID=''
export APP_COS_SECRET_KEY=''
export APP_COS_BUCKET=''
export APP_COS_REGION='ap-beijing'
export APP_COS_PUBLIC_BASE_URL=''

COS APIs

• POST /api/cos/upload-sessions issues temporary STS credentials for direct browser upload.
• POST /api/cos/objects accepts multipart file upload and stores the file through the backend.

Both endpoints return the standard ApiResponse<T> shape.

Replace The Annotation Dataset

The import runner accepts only solidworks.rebuild_extract.v1 JSON files. It clears existing models, histories, annotations, structures, functions, and their relations before importing the new dataset. It is disabled by default and should run as a non-web process:

APP_JSON_DATASET_IMPORT_ENABLED=true \
APP_JSON_DATASET_IMPORT_SOURCE_DIRECTORY='/absolute/path/to/output_json 2' \
APP_JSON_DATASET_IMPORT_CATEGORY_ID=1 \
mvn spring-boot:run -Dspring-boot.run.arguments=--spring.main.web-application-type=none

The source files contain feature trees only. The importer creates annotation histories but does not fabricate STEP, GLB, or topology assets.