编辑 | blame | 历史 | 原始文档

RSF Server Repo Map

1. Module Layout

  • Workspace root: C:/env/code/wms-master
  • Parent pom: pom.xml (modules: rsf-common, rsf-framework, rsf-server, rsf-open-api)
  • Server module: rsf-server
  • Server boot class: rsf-server/src/main/java/com/vincent/rsf/server/ServerBoot.java

2. Core Paths Inside rsf-server

  • Java root: src/main/java/com/vincent/rsf/server
  • Integration API controllers: src/main/java/com/vincent/rsf/server/api/controller
  • Warehouse business domain: src/main/java/com/vincent/rsf/server/manager
  • Platform/system domain: src/main/java/com/vincent/rsf/server/system
  • Shared infrastructure/config/security/utils: src/main/java/com/vincent/rsf/server/common
  • Mapper XML root: src/main/resources/mapper
  • Manager mapper XML: src/main/resources/mapper/manager
  • System mapper XML: src/main/resources/mapper/system
  • Runtime config: src/main/resources/application*.yml

3. Observed Size (for search strategy)

  • manager/controller: about 107 files
  • api/controller: about 46 files
  • system/controller: about 38 files
  • manager/service/impl: about 68 files
  • mapper/manager: about 67 XML files
  • mapper/system: about 30 XML files

Use keyword-first narrowing before opening files.

4. Request and Data Flow Pattern

  1. Controller receives request, often returns R.ok().add(...) or R.error(...).
  2. Service interface in service/ and implementation in service/impl/.
  3. Mapper interface in mapper/ extends BaseMapper<T>.
  4. Optional custom SQL in mapper XML with matching namespace and statement id.
  5. Entity annotations (@TableName, @TableField, @TableLogic) define persistence behavior.

5. Security and Tenancy Anchors

  • Public route whitelist: common/security/SecurityConfig.java (FILTER_PATH)
  • Method-level permission: @PreAuthorize(...)
  • Tenant interceptor: common/config/MybatisPlusConfig.java

Check these files whenever endpoint visibility or cross-tenant behavior changes.

6. Useful Commands

# Find files by keyword in server Java
rg -n "<keyword>" rsf-server/src/main/java/com/vincent/rsf/server

# Find SQL/XML references
rg -n "<keyword>" rsf-server/src/main/resources/mapper

# Build rsf-server with dependent modules from workspace root
mvn -pl rsf-server -am -DskipTests compile

# Full package build
mvn -pl rsf-server -am -DskipTests package

7. Constraints and Notes

  • No src/test directory is currently present in rsf-server.
  • rsf-server depends on sibling modules; run Maven from workspace root for reliable resolution.
  • A local system-scope jar is referenced at rsf-server/src/main/resources/lib/RouteUtils.jar.