IntelliConnect: Skill for Codex

IntelliConnect Service Style

Use this skill when implementing backend service/serviceimpl code in IntelliConnect. Prefer PUT/update flows that identify the target row by id.

Workflow

1. Read existing nearby examples before editing:
   • src/main/java/top/rslly/iot/services/agent/*ServiceImpl.java
   • src/main/java/top/rslly/iot/services/thingsModel/*ServiceImpl.java
   • matching dao/, models/, and param/request/ files.
2. Prefer the existing repository/service naming style over new abstractions.
3. Add or update the request DTO in top.rslly.iot.param.request when the service method accepts input from controller code.
4. Add derived Spring Data repository methods for simple lookups and pageable queries.
5. Use database-backed pagination for paged APIs; do not manually paginate non-empty lists in the service.
6. Use streams for simple collection projection, but avoid repeated repository calls and mutation-heavy stream code.
7. Keep controller permission checks outside mutating service methods when the repository pattern already uses SafetyServiceImpl wrappers.
8. Before implementing any delete path, inspect all related tables/repositories and decide whether the correct behavior is dependency failure or cascade delete.
9. If the dependency policy is not already obvious from nearby code, ask the user whether to return HAS_DEPENDENCIES or delete related records too.
10. Compile with JDK 21 after edits:

$env:JAVA_HOME='C:\Users\Lenovo\.jdks\ms-21.0.9'; $env:Path="$env:JAVA_HOME\bin;$env:Path"; .\mvnw.cmd -q -DskipTests compile

Service Interface Pattern

Use interfaces under the same service package as the implementation.

Common method shape:

List<Entity> findAllById(int id);

List<Entity> findAllByProductId(int productId);

JsonResult<?> getThing(String token);

JsonResult<?> postThing(ThingParam param);

JsonResult<?> updateThing(ThingParam param);

JsonResult<?> deleteThing(int id);

Use String token for list getters that need user-specific filtering. Do not pass token into post, update, or delete when controller/SafetyService will authorize the operation before calling the service.