测试：普通参数--新增&修改&删除

# Conflicts:
#	.gitea/checker/comparator.py
#	.gitea/checker/controller_ast_parser.py
#	.gitea/checker/notifier.py
#	ftb/src/main/java/ftb/test/controller/CultureClockInController.java

.gitea/checker/comparator.py

@@ -32,50 +32,71 @@ class ParameterChange:
     old_required: Optional[bool] = None
     detail: Optional[str] = None
     description: Optional[str] = None
+    old_description: Optional[str] = None
+    source: str = "query"
+    parent_dto: Optional[str] = None
+    body_param_name: Optional[str] = None
 
-    def to_markdown_line(self, *, plain: bool = False) -> str:
-        """
-        格式化为企微 Markdown 行。
-        plain=True 时用于新增接口，直接列出参数，不加「新增」前缀。
-        """
-        req_optional = self.required is False
-        req_required = self.required is True
+    def _change_tag(self) -> str:
+        """变更类型标签（企微颜色）。"""
+        tags = {
+            ChangeType.ADDED: '<font color="info">**新增**</font>',
+            ChangeType.REMOVED: '<font color="warning">**删除**</font>',
+            ChangeType.RENAMED: '<font color="comment">**重命名**</font>',
+            ChangeType.MODIFIED: '<font color="warning">**修改**</font>',
+        }
+        return tags.get(self.change_type, "")
 
-        if plain and self.change_type == ChangeType.ADDED:
-            tag = (
-                '<font color="warning">必填</font>'
-                if req_required
-                else '<font color="comment">可选</font>'
+    def _required_tag(self) -> str:
+        """必填/可选标签。"""
+        if self.required is True:
+            return '<font color="warning">必填</font>'
+        if self.required is False:
+            return '<font color="comment">可选</font>'
+        return ""
+
+    def to_markdown_block(self, index: int = 1) -> str:
+        """格式化为企微友好的参数变更卡片（列表式，非表格）。"""
+        lines: List[str] = []
+        desc = self.description or self.old_description
+
+        if self.change_type == ChangeType.RENAMED:
+            lines.append(f"**{index}. `{self.param_name}`**  {self._change_tag()}")
+            lines.append(f"> `{self.old_name}` → `{self.param_name}`")
+            if desc:
+                lines.append(f"> 说明：{desc}")
+            return "\n".join(lines)
+
+        if self.change_type == ChangeType.ADDED:
+            type_part = f" · `{self.param_type}`" if self.param_type else ""
+            req_part = f" · {self._required_tag()}" if self._required_tag() else ""
+            lines.append(
+                f"**{index}. `{self.param_name}`**{type_part}{req_part}  {self._change_tag()}"
             )
-            desc = f"  <font color=\"comment\">{self.description}</font>" if self.description else ""
-            return f'> `{self.param_type}` **{self.param_name}** · {tag}{desc}'
+            if desc:
+                lines.append(f"> 说明：{desc}")
+            return "\n".join(lines)
 
         if self.change_type == ChangeType.REMOVED:
-            return (
-                f'<font color="warning">【删除】</font> '
-                f'`{self.param_type}` ~~{self.param_name}~~'
+            type_part = f" · `{self.param_type}`" if self.param_type else ""
+            lines.append(
+                f"**{index}. `{self.param_name}`**{type_part}  {self._change_tag()}"
             )
-        if self.change_type == ChangeType.ADDED:
-            tag = (
-                '<font color="warning">必填</font>'
-                if req_required
-                else '<font color="comment">可选</font>'
-            )
-            desc = f"  <font color=\"comment\">{self.description}</font>" if self.description else ""
-            return (
-                f'<font color="info">【新增】</font> '
-                f'`{self.param_type}` **{self.param_name}** · {tag}{desc}'
-            )
-        if self.change_type == ChangeType.RENAMED:
-            return (
-                f'<font color="comment">【重命名】</font> '
-                f'`{self.old_type}` {self.old_name} → '
-                f'`{self.param_type}` **{self.param_name}**'
-            )
-        if self.change_type == ChangeType.MODIFIED:
-            detail = f' · <font color="comment">{self.detail}</font>' if self.detail else ""
-            return f'<font color="warning">【修改】</font> **{self.param_name}**{detail}'
-        return f'- {self.param_name}'
+            if desc:
+                lines.append(f"> 说明：{desc}")
+            return "\n".join(lines)
+
+        # MODIFIED
+        lines.append(f"**{index}. `{self.param_name}`**  {self._change_tag()}")
+        if desc:
+            lines.append(f"> 说明：{desc}")
+        if self.detail:
+            lines.append(f"> 变更：{self.detail}")
+        return "\n".join(lines)
+
+    def to_table_row(self) -> str:
+        """兼容旧调用，委托至卡片块。"""
+        return self.to_markdown_block(1)
 
 
 @dataclass
@@ -116,6 +137,11 @@ def _param_key(p: ApiParameter) -> Tuple[str, str]:
     return (p.source, p.name)
 
 
+def _format_type_change(old_type: str, new_type: str) -> str:
+    """类型变更文案。"""
+    return f"类型由{old_type}改为{new_type}"
+
+
 def compare_parameters(
     old_params: List[ApiParameter], new_params: List[ApiParameter]
 ) -> List[ParameterChange]:
@@ -146,9 +172,16 @@ def compare_parameters(
         new_p = new_map[key]
         detail_parts = []
         if old_p.type != new_p.type:
-            detail_parts.append(f"类型 {old_p.type} -> {new_p.type}")
+            detail_parts.append(_format_type_change(old_p.type, new_p.type))
         if old_p.required != new_p.required:
-            detail_parts.append(f"必填 {old_p.required} -> {new_p.required}")
+            req_label = lambda r: "必填" if r else "可选"
+            detail_parts.append(
+                f"必填性由{req_label(old_p.required)}改为{req_label(new_p.required)}"
+            )
+        if old_p.description != new_p.description:
+            detail_parts.append(
+                f"说明由{old_p.description or '-'}改为{new_p.description or '-'}"
+            )
         if detail_parts:
             changes.append(
                 ParameterChange(
@@ -158,6 +191,11 @@ def compare_parameters(
                     required=new_p.required,
                     old_required=old_p.required,
                     detail=", ".join(detail_parts),
+                    description=new_p.description,
+                    old_description=old_p.description,
+                    source=new_p.source,
+                    parent_dto=new_p.parent_dto,
+                    body_param_name=new_p.body_param_name,
                 )
             )
 
@@ -186,6 +224,11 @@ def compare_parameters(
                         old_name=r_param.name,
                         old_type=r_param.type,
                         required=a_param.required,
+                        description=a_param.description,
+                        old_description=r_param.description,
+                        source=a_param.source,
+                        parent_dto=a_param.parent_dto,
+                        body_param_name=a_param.body_param_name,
                     )
                 )
                 matched_removed.add(r_key)
@@ -200,6 +243,10 @@ def compare_parameters(
                     change_type=ChangeType.REMOVED,
                     param_name=param.name,
                     param_type=param.type,
+                    description=param.description,
+                    source=param.source,
+                    parent_dto=param.parent_dto,
+                    body_param_name=param.body_param_name,
                 )
             )
 
@@ -213,6 +260,9 @@ def compare_parameters(
                     param_type=param.type,
                     required=param.required,
                     description=param.description,
+                    source=param.source,
+                    parent_dto=param.parent_dto,
+                    body_param_name=param.body_param_name,
                 )
             )
 
@@ -370,6 +420,9 @@ def compare_endpoints(
                             param_type=p.type,
                             required=p.required,
                             description=p.description,
+                            source=p.source,
+                            parent_dto=p.parent_dto,
+                            body_param_name=p.body_param_name,
                         )
                         for p in ep.parameters
                     ],

.gitea/checker/controller_ast_parser.py

@@ -23,6 +23,8 @@ from javalang.tree import (
 
 from models import ApiEndpoint, ApiParameter
 
+# javax.validation 必填注解
+REQUIRED_FIELD_ANNS = {"NotNull", "NotEmpty", "NotBlank"}
 MAPPING_ANNS = {"GetMapping", "PostMapping", "PutMapping", "DeleteMapping", "PatchMapping", "RequestMapping"}
 CONTROLLER_ANNS = {"RestController", "Controller"}
 
@@ -233,84 +235,89 @@ def _param_required(param: FormalParameter) -> bool:
     return not _has_ann(param, "Nullable")
 
 
-def _param_description(param: FormalParameter) -> Optional[str]:
-    """提取参数描述，优先 Swagger 注解，其次 @RequestParam 的 value。"""
-    # 1. Swagger @ApiParam
-    ann = _find_ann(param, "ApiParam")
-    if ann:
-        desc = _ann_string(ann, "value", "name")
+JAVADOC_PARAM_RE = re.compile(
+    r"@param\s+(\w+)\s+(.*?)(?=\n\s*\*\s*@|\n\s*\*/|\Z)",
+    re.DOTALL,
+)
+
+
+def _clean_javadoc_text(text: str) -> str:
+    """清理 JavaDoc 行前缀与多余空白。"""
+    cleaned = re.sub(r"\s*\*\s?", " ", text)
+    return re.sub(r"\s+", " ", cleaned).strip()
+
+
+def _parse_javadoc_params(javadoc: str) -> Dict[str, str]:
+    """从 JavaDoc 块解析 @param 名称 -> 说明。"""
+    if not javadoc:
+        return {}
+    result: Dict[str, str] = {}
+    for match in JAVADOC_PARAM_RE.finditer(javadoc):
+        name = match.group(1)
+        desc = _clean_javadoc_text(match.group(2))
         if desc:
-            return desc
+            result[name] = desc
+    return result
 
-    # 2. Swagger @ApiImplicitParam（方法级注解，较少见，暂不实现）
 
-    # 3. Fallback: @RequestParam 的 value 作为描述提示
-    ann = _find_ann(param, "RequestParam")
-    if ann:
-        val = _ann_string(ann, "value", "name")
-        if val and val != param.name:
-            return val
+def _extract_javadoc_before_line(source: str, target_line: int) -> str:
+    """
+    提取目标行之前紧邻的 JavaDoc 块。
+    target_line 为 1-indexed（与方法声明行号一致）。
+    """
+    if not source or target_line <= 1:
+        return ""
+    lines = source.splitlines()
+    idx = target_line - 2
+    while idx >= 0 and not lines[idx].strip():
+        idx -= 1
+    while idx >= 0 and lines[idx].strip().startswith("@"):
+        idx -= 1
+    if idx < 0 or not lines[idx].strip().endswith("*/"):
+        return ""
+    end_idx = idx
+    while idx >= 0 and not lines[idx].strip().startswith("/**"):
+        idx -= 1
+    if idx < 0:
+        return ""
+    return "\n".join(lines[idx : end_idx + 1])
 
+
+def _field_required(field: FieldDeclaration) -> bool:
+    """DTO 字段是否必填（@NotNull / @NotEmpty / @NotBlank）。"""
+    if _has_ann(field, "Nullable"):
+        return False
+    for ann in field.annotations or []:
+        if _ann_simple_name(ann) in REQUIRED_FIELD_ANNS:
+            return True
+    return False
+
+
+def _lookup_param_description(
+    javadoc_params: Dict[str, str], param: FormalParameter, resolved_name: str
+) -> Optional[str]:
+    """按注解名或形参名匹配 JavaDoc @param 说明。"""
+    for key in (resolved_name, param.name):
+        if key and key in javadoc_params:
+            return javadoc_params[key]
     return None
 
 
-def _parse_javadoc_params(source_code: str) -> Dict[str, Dict[str, str]]:
-    """
-    使用正则从 Java 源代码中提取方法上的 Javadoc @param 描述。
-    支持方法声明前存在注解（@GetMapping、@ApiOperation 等）的情况。
-
-    返回结构：
-        { method_name: { param_name: description } }
-    """
-    javadoc_map: Dict[str, Dict[str, str]] = {}
-
-    # 改进正则：允许 Javadoc 后存在零或多个注解，再匹配方法声明
-    pattern = re.compile(
-        r'/\*\*(?P<javadoc>.*?)\*/\s*'
-        r'(?:@\w+(?:\s*\([^)]*\))?\s*)*'          # 跳过注解（支持 @GetMapping(...)）
-        r'(?:public|private|protected|static|final|\s)*'
-        r'[\w<>\[\],\.\s]+?\s+(?P<method>\w+)\s*\(',
-        re.DOTALL | re.MULTILINE
-    )
-
-    for match in pattern.finditer(source_code):
-        javadoc_block = match.group('javadoc')
-        method_name = match.group('method')
-
-        param_descs: Dict[str, str] = {}
-        # 提取 @param，支持多行描述（直到下一个 @ 或结束）
-        param_pattern = re.compile(
-            r'@param\s+(\w+)\s+((?:(?!\n\s*@).)+)',
-            re.IGNORECASE | re.DOTALL
-        )
-        for p_match in param_pattern.finditer(javadoc_block):
-            p_name = p_match.group(1)
-            # 合并多行空白为单行
-            p_desc = ' '.join(p_match.group(2).split())
-            if p_desc:
-                param_descs[p_name] = p_desc
-
-        if param_descs:
-            javadoc_map[method_name] = param_descs
-
-    return javadoc_map
-
-
 class ControllerAstParser:
     """
     基于 javalang 的 Controller 解析器。
     只解析传入的文件，不扫描整个目录（CI 更快）。
     """
 
-    def __init__(self, repo_root: Path, source_dir: Path):
+    def __init__(self, repo_root: Path, source_dirs: List[Path]):
         """
         :param repo_root:   仓库根目录
-        :param source_dir: Java 源码根目录（repo_root 下的相对路径对应的绝对路径）
+        :param source_dirs: Java 源码根目录列表（用于查找 DTO 等）
         """
         self.repo_root = repo_root
-        self.source_dir = source_dir
+        self.source_dirs = source_dirs
         self._dto_cache: Dict[str, List[ApiParameter]] = {}
-        self._javadoc_map: Dict[str, Dict[str, str]] = {}  # method_name -> param_name -> description
+        self._current_source = ""
 
     def parse_file_content(self, source: str, repo_relative_path: str) -> List[ApiEndpoint]:
         """
@@ -321,15 +328,13 @@ class ControllerAstParser:
         :return: 端点列表
         """
         endpoints: List[ApiEndpoint] = []
+        self._current_source = source
         try:
             tree = javalang.parse.parse(source)
         except (javalang.parser.JavaSyntaxError, RecursionError) as exc:
             print(f"[警告] 解析失败 {repo_relative_path}: {exc}")
             return endpoints
 
-        # 解析当前文件的 Javadoc @param（用于参数描述回退）
-        self._javadoc_map = _parse_javadoc_params(source)
-
         for type_decl in tree.types or []:
             if not isinstance(type_decl, ClassDeclaration):
                 continue
@@ -367,9 +372,16 @@ class ControllerAstParser:
                 continue
 
             method_path = _ann_string(ann, "value", "path")
+            javadoc_params: Dict[str, str] = {}
+            if getattr(method, "position", None) and method.position:
+                javadoc = _extract_javadoc_before_line(
+                    self._current_source, method.position.line
+                )
+                javadoc_params = _parse_javadoc_params(javadoc)
+
             params = []
             for p in method.parameters or []:
-                params.extend(self._extract_param(p, method_name=method.name))
+                params.extend(self._extract_param(p, javadoc_params))
 
             return ApiEndpoint(
                 http_method=_http_method(ann_name, ann),
@@ -381,50 +393,82 @@ class ControllerAstParser:
             )
         return None
 
-    def _extract_param(self, param: FormalParameter, method_name: Optional[str] = None) -> List[ApiParameter]:
+    def _extract_param(
+        self, param: FormalParameter, javadoc_params: Optional[Dict[str, str]] = None
+    ) -> List[ApiParameter]:
         """提取方法参数，@RequestBody 展开 DTO 字段；忽略框架注入参数。"""
         type_name = _type_to_str(param.type)
         name = _param_name(param)
+        javadoc_params = javadoc_params or {}
 
         if _is_framework_param(type_name, name):
             return []
 
         if _has_ann(param, "RequestBody"):
-            return self._expand_dto(type_name, "body")
-
-        desc = _param_description(param)
-
-        # Javadoc @param 回退（如果注解中没有描述）
-        if not desc and method_name and method_name in self._javadoc_map:
-            desc = self._javadoc_map[method_name].get(name)
+            body_desc = _lookup_param_description(javadoc_params, param, name)
+            return self._expand_dto(
+                type_name,
+                "body",
+                body_param_name=param.name,
+                body_param_desc=body_desc,
+            )
 
+        description = _lookup_param_description(javadoc_params, param, name)
         return [
             ApiParameter(
                 name=name,
                 type=type_name,
                 required=_param_required(param),
                 source=_param_source(param),
-                description=desc,
+                description=description,
             )
         ]
 
-    def _expand_dto(self, type_name: str, source: str) -> List[ApiParameter]:
-        """展开 @RequestBody DTO 字段。"""
+    def _expand_dto(
+        self,
+        type_name: str,
+        source: str,
+        body_param_name: str = "",
+        body_param_desc: Optional[str] = None,
+    ) -> List[ApiParameter]:
+        """展开 @RequestBody DTO 一级字段。"""
         simple = type_name.split(".")[-1].replace(">", "").replace("<", "").strip()
-        if simple in self._dto_cache:
-            return self._dto_cache[simple]
+        cache_key = f"{simple}:{body_param_name}"
+        if cache_key in self._dto_cache:
+            return self._dto_cache[cache_key]
 
         dto_file = self._find_dto_file(simple)
         if not dto_file:
-            result = [ApiParameter(name=simple, type=type_name, required=True, source=source)]
-            self._dto_cache[simple] = result
+            result = [
+                ApiParameter(
+                    name=simple,
+                    type=type_name,
+                    required=True,
+                    source=source,
+                    description=body_param_desc,
+                    parent_dto=simple,
+                    body_param_name=body_param_name or None,
+                )
+            ]
+            self._dto_cache[cache_key] = result
             return result
 
         try:
-            tree = javalang.parse.parse(dto_file.read_text(encoding="utf-8", errors="ignore"))
+            dto_source = dto_file.read_text(encoding="utf-8", errors="ignore")
+            tree = javalang.parse.parse(dto_source)
         except (javalang.parser.JavaSyntaxError, OSError):
-            result = [ApiParameter(name=simple, type=type_name, required=True, source=source)]
-            self._dto_cache[simple] = result
+            result = [
+                ApiParameter(
+                    name=simple,
+                    type=type_name,
+                    required=True,
+                    source=source,
+                    description=body_param_desc,
+                    parent_dto=simple,
+                    body_param_name=body_param_name or None,
+                )
+            ]
+            self._dto_cache[cache_key] = result
             return result
 
         fields: List[ApiParameter] = []
@@ -434,42 +478,60 @@ class ControllerAstParser:
             for field in type_decl.fields or []:
                 if "static" in (field.modifiers or []):
                     continue
+                field_javadoc = ""
+                if getattr(field, "position", None) and field.position:
+                    field_javadoc = _extract_javadoc_before_line(
+                        dto_source, field.position.line
+                    )
+                field_desc = _clean_javadoc_text(
+                    field_javadoc.replace("/**", "").replace("*/", "").strip()
+                ) or None
                 for decl in field.declarators:
-                    # 尝试提取 @ApiModelProperty 的描述
-                    desc = None
-                    api_model_ann = _find_ann(field, "ApiModelProperty")
-                    if api_model_ann:
-                        desc = _ann_string(api_model_ann, "value")
-
                     fields.append(
                         ApiParameter(
                             name=decl.name,
                             type=_type_to_str(field.type),
-                            required=not _has_ann(field, "Nullable"),
+                            required=_field_required(field),
                             source=source,
-                            description=desc,
+                            description=field_desc,
+                            parent_dto=simple,
+                            body_param_name=body_param_name or None,
                         )
                     )
 
         if not fields:
-            fields = [ApiParameter(name=simple, type=type_name, required=True, source=source)]
+            fields = [
+                ApiParameter(
+                    name=simple,
+                    type=type_name,
+                    required=True,
+                    source=source,
+                    description=body_param_desc,
+                    parent_dto=simple,
+                    body_param_name=body_param_name or None,
+                )
+            ]
 
-        self._dto_cache[simple] = fields
+        self._dto_cache[cache_key] = fields
         return fields
 
     def _find_dto_file(self, simple_name: str) -> Optional[Path]:
-        """在源码目录中查找 DTO 文件。"""
-        if not self.source_dir.exists():
-            return None
+        """在配置的源码目录及仓库内 src/main/java 中查找 DTO 文件。"""
         target = f"{simple_name}.java"
-        for path in self.source_dir.rglob(target):
+        for source_dir in self.source_dirs:
+            if source_dir.exists():
+                for path in source_dir.rglob(target):
+                    return path
+        if self.repo_root.exists():
+            for path in self.repo_root.rglob(target):
+                if "src/main/java" in path.as_posix():
                     return path
         return None
 
 
 def parse_controller_files(
     repo_root: Path,
-    source_subdir: str,
+    source_subdirs: List[str],
     file_paths: List[str],
     file_contents: Dict[str, str],
 ) -> List[ApiEndpoint]:
@@ -477,13 +539,13 @@ def parse_controller_files(
     批量解析指定 Controller 文件（仅解析传入的文件，不全量扫描）。
 
     :param repo_root:       仓库根目录
-    :param source_subdir:  源码子目录（相对仓库根）
+    :param source_subdirs:  源码子目录列表（相对仓库根）
     :param file_paths:      要解析的文件路径列表（相对仓库根）
     :param file_contents:   {文件路径: 源码内容}
     :return: 所有端点
     """
-    source_dir = (repo_root / source_subdir).resolve()
-    parser = ControllerAstParser(repo_root, source_dir)
+    source_dirs = [(repo_root / sub).resolve() for sub in source_subdirs]
+    parser = ControllerAstParser(repo_root, source_dirs)
     endpoints: List[ApiEndpoint] = []
 
     for path in file_paths:

.gitea/checker/controller_parser.py

@@ -25,7 +25,7 @@ def filter_endpoints_by_files(
 
 def parse_endpoints_from_files(
     repo_root: Path,
-    source_subdir: str,
+    source_subdirs: List[str],
     file_paths: List[str],
     file_contents: Dict[str, str],
 ) -> List[ApiEndpoint]:
@@ -33,11 +33,11 @@ def parse_endpoints_from_files(
     解析指定 Controller 文件，提取接口参数（仅解析传入文件，不全量扫描）。
 
     :param repo_root:        仓库根
-    :param source_subdir:   源码目录（相对仓库根）
+    :param source_subdirs:   源码目录列表（相对仓库根）
     :param file_paths:       文件路径列表
     :param file_contents:    路径 -> 源码内容
     :return: ApiEndpoint 列表
     """
     from controller_ast_parser import parse_controller_files
 
-    return parse_controller_files(repo_root, source_subdir, file_paths, file_contents)
+    return parse_controller_files(repo_root, source_subdirs, file_paths, file_contents)

.gitea/checker/main.py

@@ -42,6 +42,14 @@ def load_config(config_path: Path) -> dict:
         return yaml.safe_load(f) or {}
 
 
+def resolve_source_subdirs(config: dict) -> list:
+    """从配置解析 Java 源码目录列表（支持 source_dirs 多模块）。"""
+    dirs = config.get("source_dirs")
+    if dirs:
+        return [str(d) for d in dirs]
+    return [config.get("source_dir", "src/main/java")]
+
+
 def _read_file_safe(path: Path) -> str:
     """读取文件内容。"""
     try:
@@ -73,7 +81,7 @@ def _load_version_contents(
 
 def parse_changed_endpoints(
     repo_root: Path,
-    source_subdir: str,
+    source_subdirs: list,
     changed_files: list,
     old_sha: str,
     label: str,
@@ -86,7 +94,7 @@ def parse_changed_endpoints(
 
     print(f"[AST] 解析 {label} 版本 {len(contents)} 个 Controller 文件")
     endpoints = parse_endpoints_from_files(
-        repo_root, source_subdir, changed_files, contents
+        repo_root, source_subdirs, changed_files, contents
     )
     print(f"[AST] {label} 版本共 {len(endpoints)} 个接口")
     return endpoints_to_map(endpoints)
@@ -111,7 +119,11 @@ def main() -> int:
         config_path = repo_root / config_path
     config = load_config(config_path)
 
-    source_subdir = config.get("source_dir", "src/main/java")
+    if not config.get("check", {}).get("enabled", True):
+        print("[检查] API 变动检查已关闭（check.enabled=false），跳过。")
+        return 0
+
+    source_subdirs = resolve_source_subdirs(config)
 
     commit_info = get_current_commit()
     push_user = args.push_user or commit_info.author
@@ -121,6 +133,8 @@ def main() -> int:
     print("=" * 40)
     print(f"推送人: {push_user}")
     print(f"推送时间: {push_time}")
+    print(f"API 变动检查: {config.get('check', {}).get('enabled', True)}")
+    print(f"源码目录: {', '.join(source_subdirs)}")
     print(f"LLM 审核: {config.get('llm', {}).get('enabled', True)}")
     print(f"记录日志: {config.get('log', {}).get('enabled', False)}")
     print("=" * 40)
@@ -142,10 +156,10 @@ def main() -> int:
     git_diff = get_controller_files_diff(prev_sha, commit_info.sha, changed_files)
 
     new_map = parse_changed_endpoints(
-        repo_root, source_subdir, changed_files, prev_sha, "new"
+        repo_root, source_subdirs, changed_files, prev_sha, "new"
     )
     old_map = parse_changed_endpoints(
-        repo_root, source_subdir, changed_files, prev_sha, "old"
+        repo_root, source_subdirs, changed_files, prev_sha, "old"
     )
 
     new_filtered = endpoints_to_map(

.gitea/checker/models.py

@@ -15,6 +15,8 @@ class ApiParameter:
     required: bool = True
     source: str = "query"
     description: Optional[str] = None
+    parent_dto: Optional[str] = None
+    body_param_name: Optional[str] = None
 
 
 @dataclass

.gitea/checker/notifier.py

@@ -5,11 +5,12 @@
 
 import json
 import re
-from typing import List, Optional
+from collections import OrderedDict
+from typing import List, Optional, Tuple
 
 import requests
 
-from comparator import EndpointChangeReport
+from comparator import EndpointChangeReport, ParameterChange
 
 # 企微 Markdown 单条上限 4096 字符，留余量
 MAX_MD_LENGTH = 3800
@@ -22,6 +23,86 @@ def truncate_text(text: str, max_length: int = MAX_MD_LENGTH) -> str:
     return text[:max_length] + "\n\n<font color=\"comment\">... 消息过长，已截断</font>"
 
 
+def _format_param_change_list(changes: List[ParameterChange]) -> List[str]:
+    """生成企微友好的普通参数变更列表（卡片式）。"""
+    if not changes:
+        return ['<font color="comment">无</font>']
+    lines = ["", f"共 **{len(changes)}** 项变更", ""]
+    for i, change in enumerate(changes, 1):
+        lines.append(change.to_markdown_block(i))
+        if i < len(changes):
+            lines.append("")
+    return lines
+
+
+def _body_dto_group_key(change: ParameterChange) -> Tuple[str, str]:
+    """类对象变更分组键：(body 参数名, DTO 类名)。"""
+    return (change.body_param_name or "body", change.parent_dto or "")
+
+
+def _format_body_field_line(change: ParameterChange, *, is_last: bool) -> List[str]:
+    """格式化 DTO 一级字段变更行。"""
+    branch = "└─" if is_last else "├─"
+    desc = change.description or change.old_description
+    type_part = f" · `{change.param_type}`" if change.param_type else ""
+    req_part = f" · {change._required_tag()}" if change._required_tag() else ""
+    lines = [f"{branch} `{change.param_name}`{type_part}{req_part}  {change._change_tag()}"]
+    if desc:
+        lines.append(f">   说明：{desc}")
+    if change.change_type.value == "modified" and change.detail:
+        lines.append(f">   变更：{change.detail}")
+    if change.change_type.value == "renamed":
+        lines.append(f">   `{change.old_name}` → `{change.param_name}`")
+    return lines
+
+
+def _format_body_dto_groups(changes: List[ParameterChange]) -> List[str]:
+    """按 DTO 分组展示 @RequestBody 一级字段。"""
+    if not changes:
+        return ['<font color="comment">无</font>']
+
+    groups: OrderedDict[Tuple[str, str], List[ParameterChange]] = OrderedDict()
+    for change in changes:
+        key = _body_dto_group_key(change)
+        groups.setdefault(key, []).append(change)
+
+    lines: List[str] = ["", f"共 **{len(groups)}** 个类对象 · **{len(changes)}** 项字段变更", ""]
+    for (param_name, dto_name), group in groups.items():
+        label = param_name or "body"
+        dto_part = f" · `{dto_name}`" if dto_name else ""
+        lines.append(f"**{label}**{dto_part}")
+        lines.append("")
+        for i, change in enumerate(group):
+            lines.extend(_format_body_field_line(change, is_last=(i == len(group) - 1)))
+        lines.append("")
+
+    if lines and lines[-1] == "":
+        lines.pop()
+    return lines
+
+
+def _format_param_details_section(report: EndpointChangeReport) -> List[str]:
+    """生成接口参数变动详情区块。"""
+    body_changes = [c for c in report.parameter_changes if c.source == "body"]
+    regular_changes = [c for c in report.parameter_changes if c.source != "body"]
+    lines = ["", "---------------------------------------", "", "#### 【接口参数变动详情】", ""]
+
+    if body_changes:
+        lines.append("**类对象变更（一级字段）**")
+        lines.extend(_format_body_dto_groups(body_changes))
+        lines.append("")
+
+    if regular_changes:
+        lines.append("**普通参数变更**")
+        lines.extend(_format_param_change_list(regular_changes))
+        lines.append("")
+
+    if not body_changes and not regular_changes:
+        lines.append('<font color="comment">无</font>')
+
+    return lines
+
+
 def _format_endpoint_block(report: EndpointChangeReport) -> str:
     """
     格式化单个接口块，按模板匹配格式输出。
@@ -41,21 +122,7 @@ def _format_endpoint_block(report: EndpointChangeReport) -> str:
     if report.is_removed_endpoint:
         return "\n".join(header + ["", f"<font color=\"warning\">**该接口已被移除**</font>"])
 
-    detail_lines = ["", "---------------------------------------", "", "## 【接口参数变动详情】", ""]
-
-    if report.is_new_endpoint:
-        detail_lines.append("### <font color=\"info\">**新增接口参数**</font>")
-    else:
-        detail_lines.append("### <font color=\"warning\">**参数变更明细**</font>")
-
-    if report.parameter_changes:
-        for change in report.parameter_changes:
-            md = change.to_markdown_line(plain=report.is_new_endpoint)
-            detail_lines.append(md)
-    else:
-        detail_lines.append('<font color="comment">无</font>')
-
-    return "\n".join(header + detail_lines)
+    return "\n".join(header + _format_param_details_section(report))
 
 
 def build_markdown_notification(
@@ -142,7 +209,7 @@ def build_markdown_notification(
         parts.append(path_md)
         parts.append("")
 
-    # 4. 普通参数变更（非路径变更）仍使用原有格式
+    # 4. 普通参数变更（非路径变更）仍使用 model.md 格式
     if changed_reports:
         parts.append("# 【API参数变更通知】")
         parts.append(f"- **修改人：** {push_user}")
@@ -291,6 +358,9 @@ def send_parameter_change_notification(
             push_time=push_time,
             file_name=report.source_file or report.controller_class,
         )
+        if report.parameter_changes:
+            param_section = "\n".join(_format_param_details_section(report)).strip()
+            md = f"{md}\n\n{param_section}"
         if _post_wecom_markdown(webhook_url, md):
             sent += 1
             print(f"第 {sent} 条通知已发送到企业微信（新增接口）")
@@ -325,7 +395,7 @@ def send_parameter_change_notification(
 
     # ========== 3. 参数变更通知（独立分支） ==========
     if changed_reports:
-        # 构建参数变更通知（只包含参数变更报告）
+        # 构建参数变更通知（只包含参数变更报告，对齐 model.md）
         parts: List[str] = []
         parts.append("# 【API参数变更通知】")
         parts.append(f"- **修改人：** {push_user}")

.gitea/config.yaml

@@ -2,9 +2,17 @@
 # AI-Check 配置文件（位于 .gitea/ 目录，与业务代码解耦）
 # ============================================================
 
+# ---------- API 变动检查 ----------
+# 总开关：false 时跳过 Controller 接口参数变更检测（不对比、不通知）
+check:
+  enabled: true
+
 # 业务 Java 源码目录（相对仓库根目录）
-# 单模块: src/main/java
-# 多模块: ftb/src/main/java
+# 单模块: source_dir: "src/main/java"
+# 多模块: 使用 source_dirs（优先于 source_dir）
+source_dirs:
+  - "jnpf-ftb/jnpf-ftb-biz/src/main/java"
+  - "jnpf-ftb/jnpf-ftb-entity/src/main/java"
 source_dir: "ftb/src/main/java"
 
 # ---------- 企业微信机器人 ----------

.gitea/model.md

@@ -22,8 +22,8 @@
   - [删除] 属性: `attr2`  说明: {说明}
   - [修改] 属性: `attr3`  说明: {说明}
 
-### 普通参数变更（非对象字段）
-- **参数变更列表：**
+### 【参数变更】
+- **变更列表：**
 
 | 字段 | 说明 | 变更 |
 |------|------|------|

.idea/AI-Check-Test.iml

@@ -2,7 +2,9 @@
 <module type="JAVA_MODULE" version="4">
   <component name="NewModuleRootManager" inherit-compiler-output="true">
     <exclude-output />
-    <content url="file://$MODULE_DIR$" />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/jnpf-ftb" isTestSource="false" />
+    </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
   </component>

.idea/sqldialects.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="SqlDialectMappings">
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/ftb_certificate_instance_upgrade_template_status.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/certificate/ftb_certificate_instance.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/certificate/ftb_certificate_instance_upgrade_health_certificate_data.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/franchisee/base_dictionary_franchisee_nature.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/franchisee/base_dictionary_industry_param.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/franchisee/ftb_franchisee.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/franchisee/ftb_franchisee_batch_insert_5000_with_region.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/ftb_certificate_instance_upgrade_business_license_from_base_organize.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/ftb_certificate_instance_upgrade_org_store_missing.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/ftb_store_add_store_type_franchisee.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/storecertificatephoto/base_param.sql" dialect="GenericSQL" />
+    <file url="file://$PROJECT_DIR$/jnpf-ftb/jnpf-ftb-biz/src/main/resources/sql/storecertificatephoto/ftb_store_certificate_photo.sql" dialect="GenericSQL" />
+  </component>
+</project>

ftb/src/main/java/ftb/test/controller/.gitkeep

@@ -1,2 +0,0 @@
-# 示例 Spring Controller，用于本地测试 AST 解析
-# 将此目录结构复制到你的 Java 项目中进行验证

ftb/src/main/java/ftb/test/controller/UserController.java

@@ -1,44 +0,0 @@
-package com.example.controller;
-
-import org.springframework.web.bind.annotation.*;
-
-/**
- * 示例 UserController，用于测试 API 变更检测。
- */
-@RestController
-@RequestMapping("/api/users")
-public class UserController {
-
-    /**
-     * 查询用户详情 — 含多种参数类型，便于测试增删改检测。
-     */
-    @GetMapping("/{id}")
-    public String getUser(@PathVariable("id") String id, @RequestParam(value = "test", required = false, defaultValue = "false") Boolean includeDisabled) {
-        return "ok";
-    }
-
-    /**
-     * 新增用户
-     */
-    @PostMapping("/createUser")
-    public String createUser(@RequestBody UserCreateRequest request) {
-        return "created";
-    }
-
-    /**
-     * 更新用户
-     */
-    @PutMapping("/{id}")
-    public String updateUser(@PathVariable("id") Long id, @RequestBody UserCreateRequest request) {
-        return "updated";
-    }
-
-    /**
-     * 删除用户
-     */
-    @DeleteMapping("/{id}")
-    public String deleteUser(@PathVariable("id") Long id) {
-        return "deleted";
-    }
-
-}

ftb/src/main/java/ftb/test/controller/UserCreateRequest.java

@@ -1,26 +0,0 @@
-package com.example.controller;
-
-/**
- * 示例请求体 DTO，测试 @RequestBody 字段展开。
- */
-public class UserCreateRequest {
-
-    private String userName;
-    private Boolean userType;
-
-    public String getUserName() {
-        return userName;
-    }
-
-    public void setUserName(String userName) {
-        this.userName = userName;
-    }
-
-    public Boolean getUserType() {
-        return userType;
-    }
-
-    public void setUserType(Boolean userType) {
-        this.userType = userType;
-    }
-}

jnpf-ftb/jnpf-ftb-api/pom.xml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.jnpf</groupId>
+        <artifactId>jnpf-ftb</artifactId>
+        <version>3.4.7-RELEASE</version>
+    </parent>
+
+    <artifactId>jnpf-ftb-api</artifactId>
+
+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.jnpf</groupId>
+            <artifactId>jnpf-ftb-entity</artifactId>
+            <version>${project.version}</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.jnpf</groupId>
+            <artifactId>jnpf-duty-entity</artifactId>
+            <version>${project.version}</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.jnpf</groupId>
+            <artifactId>jnpf-common-feign</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.jnpf</groupId>
+            <artifactId>jnpf-permission-entity</artifactId>
+            <version>3.4.7-RELEASE</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.jnpf</groupId>
+            <artifactId>jnpf-tenant-entity</artifactId>
+            <version>3.4.7-RELEASE</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <configuration>
+                    <source>9</source>
+                    <target>9</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/account/PTenantAccountApi.java

@@ -0,0 +1,72 @@
+package jnpf.account;
+
+import jnpf.account.fallback.PTenantAccountApiFallBackFactory;
+import jnpf.base.ActionResult;
+import jnpf.exception.HandleException;
+import jnpf.model.TenantGenerateDefaultAvatarVO;
+import jnpf.model.personnels.dto.turnover.SaveTenantUserForm;
+import jnpf.model.personnels.req.roster.UserAccountDto;
+import jnpf.model.user.GenerateHeadForm;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+
+@FeignClient(name = "jnpf-tenant",  fallbackFactory = PTenantAccountApiFallBackFactory.class, path = "/tenantUser")
+public interface PTenantAccountApi {
+
+
+    @PutMapping("/batchAddUserAccount")
+    ActionResult<List<UserAccountDto>> batchAddUserAccount(@RequestBody List<UserAccountDto> userAccountForms);
+
+    @PutMapping("/batchDisabledUserAccount")
+    ActionResult<List<UserAccountDto>> batchDisabledUserAccount(@RequestBody List<UserAccountDto> userAccountForms);
+
+    @GetMapping("/generateDefaultAvatar")
+    ActionResult generateDefaultAvatar(@RequestParam("name") String name) throws IOException;
+
+
+    /**
+     * 批量异步生成头像 调用方自己要触发保底
+     * @param names 用户名
+     * @return
+     */
+    @PostMapping("/batch/generate/default/avatar")
+    List<TenantGenerateDefaultAvatarVO> batchGenerateDefaultAvatar(@RequestBody List<String> names);
+
+    /**
+     * 用户状态修改
+     * @param saveTenantUserForm
+     * @return
+     */
+    @PutMapping("/updateJobStatus")
+    ActionResult updateJobStatus(@RequestBody SaveTenantUserForm saveTenantUserForm);
+
+
+    @PutMapping("/userInfoSynchronous")
+    ActionResult userInfoSynchronous(@RequestBody SaveTenantUserForm saveTenantUserForm);
+
+    @DeleteMapping("/deleteUser/{id}")
+    ActionResult deleteUser(@PathVariable("id") String id);
+
+    /**
+     * 删除用户（同步删除租户用户）
+     *
+     * @param userId 用户ID
+     * @return ActionResult
+     */
+    @DeleteMapping("/deleteUserWithPlatform/{userId}")
+    Boolean deleteUserWithPlatform(@PathVariable("userId") String userId);
+
+    /**
+     * 批量删除用户
+     */
+    @DeleteMapping("/deleteUsers")
+    ActionResult<Void> deleteUsers(@RequestBody List<String> userIds) ;
+
+    @PostMapping("/generateDefaultAvatarCustomFilename")
+    ActionResult generateDefaultAvatar(@RequestBody GenerateHeadForm generateHeadForm) throws IOException;
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/account/fallback/PTenantAccountApiFallBack.java

@@ -0,0 +1,72 @@
+package jnpf.account.fallback;
+
+import jnpf.account.PTenantAccountApi;
+import jnpf.base.ActionResult;
+import jnpf.exception.HandleException;
+import jnpf.model.TenantGenerateDefaultAvatarVO;
+import jnpf.model.personnels.dto.turnover.SaveTenantUserForm;
+import jnpf.model.personnels.req.roster.UserAccountDto;
+import jnpf.model.user.GenerateHeadForm;
+import lombok.extern.slf4j.Slf4j;
+
+import java.io.IOException;
+import java.util.List;
+
+@Slf4j
+public class PTenantAccountApiFallBack implements PTenantAccountApi {
+
+    @Override
+    public ActionResult<List<UserAccountDto>> batchAddUserAccount(List<UserAccountDto> userAccountForms) {
+        log.error("调用批量添加用户接口失败,降级");
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<UserAccountDto>> batchDisabledUserAccount(List<UserAccountDto> userAccountForms) {
+        return null;
+    }
+
+    @Override
+    public ActionResult generateDefaultAvatar(String name) throws IOException {
+        log.error("调用生成默认头像接口失败,降级");
+        return null;
+    }
+
+    @Override
+    public List<TenantGenerateDefaultAvatarVO> batchGenerateDefaultAvatar(List<String> names) {
+        log.error("调用生成默认头像接口失败,降级");
+        return List.of();
+    }
+
+    @Override
+    public ActionResult updateJobStatus(SaveTenantUserForm saveTenantUserForm) {
+        return null;
+    }
+
+    @Override
+    public ActionResult userInfoSynchronous(SaveTenantUserForm saveTenantUserForm) {
+        log.error("调用同步用户信息接口失败,降级");
+        return null;
+    }
+
+    @Override
+    public ActionResult deleteUser(String id) {
+        return null;
+    }
+
+    @Override
+    public Boolean deleteUserWithPlatform(String userId) {
+        log.error("调用删除租户用户接口失败,降级");
+        return false;
+    }
+
+    @Override
+    public ActionResult<Void> deleteUsers(List<String> userIds) {
+        return null;
+    }
+
+    @Override
+    public ActionResult generateDefaultAvatar(GenerateHeadForm generateHeadForm) throws IOException {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/account/fallback/PTenantAccountApiFallBackFactory.java

@@ -0,0 +1,22 @@
+package jnpf.account.fallback;
+
+import feign.FeignException;
+import feign.Request;
+import jnpf.account.PTenantAccountApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+@Component
+@Slf4j
+public class PTenantAccountApiFallBackFactory implements FallbackFactory<PTenantAccountApi> {
+
+    @Override
+    public PTenantAccountApi create(Throwable cause) {
+        log.error("服务降级了");
+        cause.printStackTrace();
+        log.error(cause.getMessage(), cause);
+        return new PTenantAccountApiFallBack();
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceApi.java

@@ -0,0 +1,35 @@
+package jnpf.attendance;
+
+import jnpf.attendance.fallback.AttendanceApiFallback;
+import jnpf.model.attendance.vo.attendance.AttendanceToThousandsFacesVo;
+import jnpf.util.NoDataSourceBind;
+import org.apache.ibatis.annotations.Param;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceApiFallback.class, path = "/attendance")
+public interface AttendanceApi {
+    @PostMapping(value = "/invalidationCoupons")
+    @NoDataSourceBind
+    Boolean invalidationCoupons(@RequestParam(value = "tenantId") String tenantId);
+
+//    @PostMapping(value = "/overtimeVouchers")
+//    @NoDataSourceBind
+//    Boolean overtimeVouchers(@RequestParam(value = "tenantId") String tenantId);
+
+    @PostMapping(value = "/storageRest")
+    Boolean storageRest(@RequestParam("tenantId") String tenantId);
+
+
+    @PostMapping(value = "/attendanceToThousandsFaces")
+    AttendanceToThousandsFacesVo attendanceToThousandsFaces();
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceConfirmApi.java

@@ -0,0 +1,27 @@
+package jnpf.attendance;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.attendance.fallback.AttendanceUserApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.model.thousandsfaces.TodayWorkVo;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+
+import java.util.List;
+
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceUserApiFallback.class, path = "/attendance/confirm")
+public interface AttendanceConfirmApi {
+
+    @Operation(summary = "自动生成考勤确认数据")
+    @GetMapping(value = "/autoConfirm")
+    ActionResult<Boolean> autoCreateConfirm();
+
+    @Operation(summary = "逾期自动确认")
+    @GetMapping(value = "/confirmAutoSlippage")
+    ActionResult<Boolean> confirmAutoSlippage();
+
+    @Operation(summary = "今日工作-考勤确认列表(0-待确认 1-已确认 2-已逾期)")
+    @GetMapping(value = "/getTodayWorkConfirmList")
+    List<TodayWorkVo> getTodayWorkConfirmList();
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceDailyRuleApi.java

@@ -0,0 +1,63 @@
+package jnpf.attendance;
+
+import jnpf.attendance.fallback.AttendanceDailyRuleApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 组队动态
+ *
+ * @author JNPF开发平台组
+ * @version V3.1.0
+ * @copyright 引迈信息技术有限公司（https://www.jnpfsoft.com）
+ * @date 2021-03-24
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceDailyRuleApiFallback.class, path = "/arranging/work")
+public interface AttendanceDailyRuleApi {
+
+
+    /**
+     * 定时执行初始化下个月固定排班
+     */
+    @PostMapping("initFixedScheduleRule")
+    ActionResult initFixedScheduleRule(@RequestParam(value = "tenantId") String tenantId);
+
+
+    /**
+     * 定时执行初始化下个月固定排班
+     */
+    @PostMapping("autoGrantBalance")
+    ActionResult autoGrantBalance(@RequestParam(value = "tenantId") String tenantId);
+
+    /**
+     * 用户是否排班
+     *
+     * @param tenantId 租户ID
+     * @param userId   用户ID
+     * @return
+     */
+    @NoDataSourceBind
+    @GetMapping("userIsScheduling")
+    ActionResult<Boolean> userIsScheduling(@RequestParam("tenantId") String tenantId, @RequestParam("userId") String userId);
+
+    @PostMapping("userIsSchedulingOrdinary")
+    ActionResult<List<String>> userIsSchedulingOrdinary(@RequestBody List<String> organizeIds);
+    /**
+     * 判断用户指定时间范围内是否排班
+     *
+     * @param userId 用户ID
+     * @param start  开始时间
+     * @param end    结束时间
+     * @return
+     */
+    @GetMapping("hasRuleByUserIdAndTime")
+    ActionResult<Boolean> hasRuleByUserIdAndTime(@RequestParam("userId") String userId, @RequestParam("start") Date start, @RequestParam("end") Date end);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceGroupApi.java

@@ -0,0 +1,59 @@
+package jnpf.attendance;
+
+
+
+import jnpf.attendance.dto.AttendanceUserGroupVo;
+import jnpf.attendance.dto.AttendanceUserListGroupVO;
+import jnpf.attendance.fallback.AttendanceGroupApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.entity.AttendanceGroup;
+import jnpf.model.attendance.vo.AttendanceGroupVo;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+
+/**
+ * @Title:  考情组api
+ * @Author: peng.hao
+ * @create: 2024/4/23:16:09
+ */
+@FeignClient(name = "jnpf-ftb",fallbackFactory = AttendanceGroupApiFallback.class,path = "/group")
+public interface AttendanceGroupApi {
+    /**
+     * 获取考勤组名称
+     * @param groupId 考勤组Id
+     *
+     */
+    @GetMapping("/queryTheNameOfTheAttendanceGroup")
+    AttendanceGroup queryTheNameOfTheAttendanceGroup(@RequestParam(value = "groupId") String groupId);
+    @GetMapping("/attendanceUserGroup")
+    List<AttendanceUserGroupVo> getAttendanceUserGroup(@RequestParam("userIds")  List<String> userIds);
+
+    @GetMapping("/getGroupListByOrgId")
+    List<AttendanceGroup> getGroupListByOrgId(@RequestParam("organizeId") String organizeId);
+
+    /**
+     * 批量获取用户绑定的考勤组 ,包含全名称 xxx/xxx/xxx
+     * @param userIds 用户ids
+     *
+     */
+    @PostMapping("/list/user_bound")
+    ActionResult<List<AttendanceUserListGroupVO>> getAttendanceUserListGroupVO(@RequestBody List<String> userIds);
+
+    /**
+     * 详情---获取一个考勤组
+     * @param organizeName 组织名称
+     * @param groupName 考勤组名称
+     * @return 一个考勤组
+     */
+    @GetMapping("/info/organize_group/name")
+    ActionResult<AttendanceGroupVo> getAttendanceGroupByName(@RequestParam("organizeName") String organizeName, @RequestParam("groupName") String groupName);
+
+
+    @GetMapping("/checkScheduling")
+    boolean checkScheduling();
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceLineSchedulingConfigApi.java

@@ -0,0 +1,25 @@
+package jnpf.attendance;
+
+import jnpf.attendance.fallback.AttendanceApiFallback;
+import jnpf.model.attendance.vo.attendance.AttendanceToThousandsFacesVo;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceApiFallback.class, path = "/arranging/line/scheduling/config")
+public interface AttendanceLineSchedulingConfigApi {
+
+    @GetMapping(value = "/noticeLineScheduling")
+    Boolean noticeLineScheduling(@RequestParam("tenantId") String tenantId);
+
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceSimulateDataApi.java

@@ -0,0 +1,24 @@
+package jnpf.attendance;
+
+import jnpf.attendance.fallback.AttendanceSimulateDataApiFallback;
+import jnpf.attendance.fallback.FtbClockInApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * 打卡api
+ *
+ * @author yanwenfu
+ * @create 2023-12-04
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceSimulateDataApiFallback.class, path = "/attendance/simulateData")
+public interface AttendanceSimulateDataApi {
+    /**
+     * 打卡
+     * @return java.lang.Object
+     */
+    @PostMapping(value = "/clockIn")
+    void clockIn(@RequestParam(value = "tenantId") String tenantId) throws Exception;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/AttendanceUserApi.java

@@ -0,0 +1,39 @@
+package jnpf.attendance;
+
+import jnpf.attendance.dto.GroupUpdateByUserDTO;
+import jnpf.attendance.fallback.AttendanceUserApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = AttendanceUserApiFallback.class, path = "/user")
+public interface AttendanceUserApi {
+    /**
+     * 花名册考勤组变更
+     *
+     * @param groupUpdateByUserDTO
+     * @return
+     */
+    @PostMapping("groupUpdateByPersonnel")
+    ActionResult groupUpdateByPersonnel(@RequestBody GroupUpdateByUserDTO groupUpdateByUserDTO);
+
+    /**
+     * 借调考勤组变动通知
+     * @param tenantId
+     * @return
+     */
+    @NoDataSourceBind
+    @GetMapping(value = "/userGroupUpdateBySecondNotice")
+    ActionResult<Boolean> userGroupUpdateBySecondNotice(@RequestParam(value = "tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/FtbClockInApi.java

@@ -0,0 +1,44 @@
+package jnpf.attendance;
+
+import jnpf.attendance.fallback.FtbClockInApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * 打卡api
+ *
+ * @author yanwenfu
+ * @create 2023-12-04
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbClockInApiFallback.class, path = "/attendance/clockIn")
+public interface FtbClockInApi {
+
+    @GetMapping(value = "/daily-rule-change/execute")
+    Boolean dailyRuleChangeExecute();
+
+    @PostMapping(value = "/absenceRecord")
+    @NoDataSourceBind
+    Boolean generateFtbAbsenceRecord(@RequestParam(value = "tenantId") String tenantId);
+
+    @PostMapping(value = "/absenceTask")
+    @NoDataSourceBind
+    Boolean generateAbsenceTask(@RequestParam(value = "tenantId") String tenantId);
+
+    /**
+     * 生成打卡提醒记录
+     * @return java.lang.Boolean
+     */
+    @PostMapping(value = "/remindRecord")
+    @NoDataSourceBind
+    Boolean generateBeforeWorkRemind(@RequestParam(value = "tenantId") String tenantId);
+
+    @PostMapping(value = "/repairNum")
+    @NoDataSourceBind
+    Boolean generateRepairNum(@RequestParam(value = "tenantId") String tenantId);
+
+    @PostMapping(value = "/continuousCheck")
+    Boolean continuousCheck(@RequestParam(value = "tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/FtbStatisticsApi.java

@@ -0,0 +1,108 @@
+package jnpf.attendance;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.attendance.dto.*;
+import jnpf.attendance.fallback.FtbStatisticsApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.model.attendance.dto.DayStatisticsDto;
+import jnpf.model.attendance.dto.SalaryAttendanceSupportDto;
+import jnpf.model.attendance.vo.attendance.AttendanceCustomizeTableVo;
+import jnpf.model.attendance.vo.attendance.DayStatisticsPageListVo;
+import jnpf.model.attendance.vo.attendance.DayStatisticsVo;
+import jnpf.model.attendance.vo.attendance.SalaryAttendanceSupportVo;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import javax.validation.Valid;
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbStatisticsApiFallback.class, path = "/attendance/statistics")
+public interface FtbStatisticsApi {
+
+    @Operation(summary = "用户日统计数据初始化")
+    @GetMapping(value = "/userDayStatisticsInit")
+    ActionResult<Boolean> userDayStatisticsInit(@RequestParam(value = "tenantId") String tenantId);
+
+    @Operation(summary = "个人考勤日报通知")
+    @GetMapping(value = "/dayStatisticsNotice")
+    ActionResult<Boolean> dayStatisticsNotice(@RequestParam(value = "tenantId") String tenantId);
+
+    @NoDataSourceBind
+    @Operation(summary = "个人统计月报通知")
+    @GetMapping(value = "/monthStatisticsNotice")
+    ActionResult<Boolean> monthStatisticsNotice(@RequestParam(value = "tenantId") String tenantId);
+
+    @NoDataSourceBind
+    @Operation(summary = "团队统计月报通知")
+    @GetMapping(value = "/teamMonthStatisticsNotice")
+    ActionResult<Boolean> teamMonthStatisticsNotice(@RequestParam(value = "tenantId") String tenantId);
+
+    @Operation(summary = "连续未排班通知")
+    @GetMapping(value = "/consentUnscheduledNotice")
+    void consentUnscheduledNotice(@RequestParam(value = "tenantId") String tenantId);
+
+    @Operation(summary = "考勤封账-自动封账定时器")
+    @PutMapping(value = "/autoSealTimer")
+    ActionResult<Boolean> autoSealTimer(@RequestParam(value = "tenantId") String tenantId);
+
+    @Operation(summary = "计算考勤组平均工时(实际出勤工时)")
+    @PostMapping(value = "/countAttendanceAvgHours")
+    List<AttendanceCountAvgHoursVo> countAttendanceAvgHours(@Valid @RequestBody AttendanceCountAvgHoursDto dto);
+
+    @Operation(summary = "获取多考勤组月度统计数据")
+    @PostMapping(value = "/getAttendanceAvgHoursDetails")
+    ActionResult<MonthStatsDetailsVo> getAttendanceAvgHoursDetails(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度人均工时折线图")
+    @PostMapping(value = "/getAttendanceMonthPerCapita")
+    ActionResult<List<MonthStatsPerCapitaVo>> getAttendanceMonthPerCapita(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度日常情况")
+    @PostMapping(value = "/getAttendanceDailySituation")
+    ActionResult<List<MonthStatsDailySituationVo>> getAttendanceDailySituation(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度考勤工时排行")
+    @PostMapping(value = "/getAttendanceHoursRanking")
+    ActionResult<List<MonthStatsHoursRankingVo>> getAttendanceHoursRanking(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度全勤情况")
+    @PostMapping(value = "/getAttendanceFullSituation")
+    ActionResult<List<MonthStatsFullSituationVo>> getAttendanceFullSituation(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度异常情况")
+    @PostMapping(value = "/getAttendanceAbnormalCondition")
+    ActionResult<MonthStatsAbnormalConditionVo> getAttendanceAbnormalCondition(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "获取多考勤组月度加班情况")
+    @PostMapping(value = "/getAttendanceOvertimeSituation")
+    ActionResult<List<MonthStatsOvertimeSituationVo>> getAttendanceOvertimeSituation(@Valid @RequestBody MonthStatsDetailsDto dto);
+
+    @Operation(summary = "薪酬考勤数据支持")
+    @PostMapping(value = "/salaryAttendanceSupport")
+    Map<String, SalaryAttendanceSupportVo> salaryAttendanceSupport(@Valid @RequestBody SalaryAttendanceSupportDto dto);
+
+    @Operation(summary = "考勤统计数据日度列表表头（薪酬）")
+    @PostMapping(value = "/attendanceDayStaTable")
+    List<AttendanceCustomizeTableVo> attendanceDayStaTable();
+
+    @Operation(summary = "考勤统计数据日度列表")
+    @PostMapping(value = "/attendanceDayStaList")
+    List<DayStatisticsPageListVo> attendanceDayStaList(@Valid @RequestBody SalaryAttendanceSupportDto dto);
+
+    @Operation(summary = "获取日出勤信息")
+    @NoDataSourceBind
+    @PostMapping(value = "/getAttendanceDayStaList")
+    List<DayStatisticsVo> getAttendanceDayStaList(@Valid @RequestBody DayStatisticsDto dto);
+
+    @Operation(summary = "获取各维度出勤人数")
+    @PostMapping(value = "/getDimensionsAttendanceCountMap")
+    Map<String, List<DateDimensionsRangeVo>> getDimensionsAttendanceCountMap(@Valid @RequestBody DimensionsAttendanceCountDto dto);
+
+    @Operation(summary = "获取各维度出勤人数")
+    @PostMapping(value = "/getDimensionsAttendanceDayCountMap")
+    Map<String, Map<Date, Integer>> getDimensionsAttendanceDayCountMap(@Valid @RequestBody DimensionsAttendanceDayCountDto dto);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/AttendanceCountAvgHoursDto.java

@@ -0,0 +1,32 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotEmpty;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class AttendanceCountAvgHoursDto {
+    /**
+     * 组织ID集合
+     */
+    @NotEmpty(message = "组织ID集合不能为空")
+    private List<String> orgIds;
+    /**
+     * 开始月份(yyyyMM)
+     */
+    @NotBlank(message = "开始月份不能为空")
+    private String startMonth;
+    /**
+     * 结束月份(yyyyMM)
+     */
+    @NotBlank(message = "结束月份不能为空")
+    private String endMonth;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/AttendanceCountAvgHoursVo.java

@@ -0,0 +1,27 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotNull;
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class AttendanceCountAvgHoursVo {
+    /**
+     * 月份
+     */
+    @NotBlank(message = "月份不能为空")
+    private String month;
+    /**
+     * 平均值
+     */
+    @NotNull(message = "平均值不能为空")
+    private BigDecimal avgHours = BigDecimal.ZERO;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/AttendanceUserGroupVo.java

@@ -0,0 +1,24 @@
+package jnpf.attendance.dto;
+
+import lombok.Data;
+
+/**
+ * @Author huanglinpan
+ * @Date 2024/4/23 17:31
+ * @Version 1.0 （版本号）
+ */
+@Data
+public class AttendanceUserGroupVo {
+    /**
+     * 考勤组Id
+     */
+    private String groupId;
+    /**
+     * 考勤组名称
+     */
+    private String groupName;
+    /**
+     * 用户Id
+     */
+    private String userId;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/AttendanceUserListGroupVO.java

@@ -0,0 +1,34 @@
+package jnpf.attendance.dto;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * todo
+ *
+ * @author Flynn Chan
+ * @create 2024-05-17
+ */
+@Data
+public class AttendanceUserListGroupVO implements Serializable {
+    /**
+     * 考勤组id
+     */
+    private String groupId;
+    /**
+     * 考勤组名称
+     */
+    private String groupName;
+
+    /**
+     * 考勤组名称
+     */
+    private String groupFullName;
+
+    /**
+     * 用户Id
+     */
+    private String userId;
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/CompareTypeEnums.java

@@ -0,0 +1,30 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 查询维度枚举
+ *
+ * @author Flynn Chan
+ * @create 2025-02-13
+ */
+@AllArgsConstructor
+@Getter
+public enum CompareTypeEnums {
+    CURRENT(1, "本期"),
+    YOY(2, "同比"),
+    MOM(3, "环比");
+
+    private final int value;
+    private final String text;
+    public static CompareTypeEnums getTypeEnums(int value) {
+        CompareTypeEnums[] values = CompareTypeEnums.values();
+        for (CompareTypeEnums typeEnums : values) {
+            if (typeEnums.getValue() == value) {
+                return typeEnums;
+            }
+        }
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/DateDimensionsRangeDto.java

@@ -0,0 +1,31 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotNull;
+import java.util.Date;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DateDimensionsRangeDto {
+    /**
+     * 查询维度枚举
+     */
+    @NotNull(message = "查询维度不能为空")
+    private CompareTypeEnums typeEnums;
+    /**
+     * 开始时间
+     */
+    @NotNull(message = "开始时间不能为空")
+    private Date startDate;
+    /**
+     * 结束时间
+     */
+    @NotNull(message = "结束时间不能为空")
+    private Date endDate;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/DateDimensionsRangeVo.java

@@ -0,0 +1,24 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotNull;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DateDimensionsRangeVo {
+    /**
+     * 查询维度枚举
+     */
+    @NotNull(message = "查询维度不能为空")
+    private CompareTypeEnums typeEnums;
+    /**
+     * 出勤人数
+     */
+    private Integer count;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/DimensionsAttendanceCountDto.java

@@ -0,0 +1,26 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotEmpty;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DimensionsAttendanceCountDto {
+    /**
+     * 系统门店ID集合
+     */
+    @NotEmpty(message = "系统门店ID集合不能为空")
+    private List<String> storeIds;
+    /**
+     * 时间维度集合
+     */
+    @NotEmpty(message = "时间维度集合不能为空")
+    private List<DateDimensionsRangeDto> dimensionsRangeList;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/DimensionsAttendanceDayCountDto.java

@@ -0,0 +1,33 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import java.util.Date;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class DimensionsAttendanceDayCountDto {
+    /**
+     * 系统门店ID集合
+     */
+    @NotEmpty(message = "系统门店ID集合不能为空")
+    private List<String> storeIds;
+    /**
+     * 开始时间
+     */
+    @NotNull(message = "开始时间不能为空")
+    private Date startDate;
+    /**
+     * 结束时间
+     */
+    @NotNull(message = "结束时间不能为空")
+    private Date endDate;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/GroupUpdateByUserDTO.java

@@ -0,0 +1,28 @@
+package jnpf.attendance.dto;
+
+import lombok.Data;
+
+import java.util.Date;
+import java.util.List;
+
+@Data
+public class GroupUpdateByUserDTO {
+    /**
+     * 1入职 2离职 3调岗 4晋升 5批量删除
+     */
+    private Integer type;
+    /**
+     * 目标考勤组id
+     */
+    private String toGroupId;
+    /**
+     * 用户id集合
+     */
+    private List<String> userIds;
+
+    private String tenantId;
+    /**
+     * 实际入职日期,yyyy-MM-dd
+     */
+    private Date joiningDate;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsAbnormalConditionVo.java

@@ -0,0 +1,55 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsAbnormalConditionVo {
+    /**
+     * 正常次数
+     */
+    private Integer normalCount = 0;
+    /**
+     * 正常次数占比
+     */
+    private BigDecimal normalPercent = BigDecimal.ZERO;
+    /**
+     * 迟到次数
+     */
+    private Integer lateCount = 0;
+    /**
+     * 迟到次数占比
+     */
+    private BigDecimal latePercent = BigDecimal.ZERO;
+    /**
+     * 早退次数
+     */
+    private Integer earlyCount = 0;
+    /**
+     * 早退次数占比
+     */
+    private BigDecimal earlyPercent = BigDecimal.ZERO;
+    /**
+     * 缺卡次数
+     */
+    private Integer absenceCardCount = 0;
+    /**
+     * 缺卡次数占比
+     */
+    private BigDecimal absenceCardPercent = BigDecimal.ZERO;
+    /**
+     * 旷工次数
+     */
+    private Integer absenceCount = 0;
+    /**
+     * 旷工次数占比
+     */
+    private BigDecimal absencePercent = BigDecimal.ZERO;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsDailySituationVo.java

@@ -0,0 +1,23 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsDailySituationVo {
+    /**
+     *  出勤类型
+     */
+    private String typeName;
+    /**
+     * 工时(天)
+     */
+    private BigDecimal avgDays;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsDetailsDto.java

@@ -0,0 +1,27 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotEmpty;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsDetailsDto {
+    /**
+     * 考勤组ID集合
+     */
+    @NotEmpty(message = "考勤组ID集合不能为空")
+    private List<String> groupIds;
+    /**
+     * 月份(yyyyMM)
+     */
+    @NotBlank(message = "开始月份不能为空")
+    private String month;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsDetailsVo.java

@@ -0,0 +1,63 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsDetailsVo {
+    /**
+     * 人均工时
+     */
+    private BigDecimal avgHours = BigDecimal.ZERO;
+    /**
+     * 人均工时同比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal avgHoursOnYear;
+    /**
+     * 人均工时环比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal avgHoursOnMonth;
+    /**
+     * 人均加班工时
+     */
+    private BigDecimal avgOverTimeHours = BigDecimal.ZERO;
+    /**
+     * 人均请假天数
+     */
+    private BigDecimal avgLeaveDays = BigDecimal.ZERO;
+    /**
+     * 人均请假天数同比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal avgLeaveDaysOnYear;
+    /**
+     * 人均请假天数环比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal avgLeaveDaysMonth;
+    /**
+     * 人均旷工天数
+     */
+    private BigDecimal avgAbsentDays = BigDecimal.ZERO;
+    /**
+     * 迟到人数
+     */
+    private BigDecimal lateCount = BigDecimal.ZERO;
+    /**
+     * 迟到人数同比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal lateCountOnYear;
+    /**
+     * 迟到人数环比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal lateCountOnMonth;
+    /**
+     * 早退人数
+     */
+    private BigDecimal earlyCount = BigDecimal.ZERO;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsFullSituationVo.java

@@ -0,0 +1,31 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsFullSituationVo {
+    /**
+     * 日期
+     */
+    private String day;
+    /**
+     * 考勤组人数
+     */
+    private Integer groupUserCount;
+    /**
+     * 全勤人数
+     */
+    private Integer fullCount;
+    /**
+     * 全勤占比
+     */
+    private BigDecimal fullRatio;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsHoursRankingVo.java

@@ -0,0 +1,23 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsHoursRankingVo {
+    /**
+     *  用户名
+     */
+    private String userName;
+    /**
+     * 工时(小时)
+     */
+    private BigDecimal hours;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsOvertimeSituationVo.java

@@ -0,0 +1,32 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsOvertimeSituationVo {
+    /**
+     * 日期(MM.dd)
+     */
+    private String day;
+    /**
+     * 加班工时(小时)
+     */
+    private BigDecimal overtimeHours;
+    /**
+     * 加班工时同比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal overtimeHoursOnYear;
+    /**
+     * 加班工时环比增长(正负表示增减,为空表示没有可对比性展示--)
+     */
+    private BigDecimal overtimeHoursOnMonth;
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsPerCapitaVo.java

@@ -0,0 +1,23 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsPerCapitaVo {
+    /**
+     * 日期(MM.dd)
+     */
+    private String day;
+    /**
+     * 人均工时(小时)
+     */
+    private BigDecimal avgHours;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/dto/MonthStatsSituationVo.java

@@ -0,0 +1,27 @@
+package jnpf.attendance.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class MonthStatsSituationVo {
+    /**
+     *  日期（MM.dd）
+     */
+    private String day;
+    /**
+     * 总人数
+     */
+    private Integer totalCount;
+    /**
+     * 全勤人数
+     */
+    private Integer onTimeCount;
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceApiFallback.java

@@ -0,0 +1,51 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceApi;
+import jnpf.model.attendance.vo.attendance.AttendanceToThousandsFacesVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@Slf4j
+@Component
+public class AttendanceApiFallback implements FallbackFactory<AttendanceApi> {
+
+    @Override
+    public AttendanceApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceApi() {
+            @Override
+            public Boolean invalidationCoupons(String tenantId) {
+                log.error("定时失效考勤劵失败...");
+                return Boolean.FALSE;
+            }
+
+//            @Override
+//            public Boolean overtimeVouchers(String tenantId) {
+//                log.error("定时发放加班劵失败...");
+//                return null;
+//            }
+
+            @Override
+            public Boolean storageRest(String tenantId) {
+                log.error("每月定时计算用户存休失败...");
+                return null;
+            }
+
+            @Override
+            public AttendanceToThousandsFacesVo attendanceToThousandsFaces() {
+                log.error("每月定时计算用户存休失败...");
+                return null;
+            }
+
+
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceConfirmApiFallback.java

@@ -0,0 +1,37 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceConfirmApi;
+import jnpf.base.ActionResult;
+import jnpf.model.thousandsfaces.TodayWorkVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Slf4j
+@Component
+public class AttendanceConfirmApiFallback implements FallbackFactory<AttendanceConfirmApi> {
+
+    @Override
+    public AttendanceConfirmApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceConfirmApi() {
+
+            @Override
+            public ActionResult<Boolean> autoCreateConfirm() {
+                return null;
+            }
+
+            @Override
+            public  ActionResult<Boolean> confirmAutoSlippage() {
+                return null;
+            }
+
+            @Override
+            public List<TodayWorkVo> getTodayWorkConfirmList() {
+                return List.of();
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceDailyRuleApiFallback.java

@@ -0,0 +1,53 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceDailyRuleApi;
+import jnpf.base.ActionResult;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 获取用户信息Api降级处理
+ *
+ * @author JNPF开发平台组
+ * @version V3.1.0
+ * @copyright 引迈信息技术有限公司（https://www.jnpfsoft.com）
+ * @date 2021-03-24
+ */
+@Component
+@Slf4j
+public class AttendanceDailyRuleApiFallback implements FallbackFactory<AttendanceDailyRuleApi> {
+    @Override
+    public AttendanceDailyRuleApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceDailyRuleApi() {
+            @Override
+            public ActionResult initFixedScheduleRule(String tenantId) {
+                return ActionResult.fail("请求失败");
+            }
+
+            @Override
+            public ActionResult autoGrantBalance(String tenantId) {
+                return ActionResult.fail("请求失败");
+            }
+
+            @Override
+            public ActionResult<Boolean> userIsScheduling(String tenantId, String userId) {
+                return ActionResult.fail("请求失败");
+            }
+
+            @Override
+            public ActionResult<List<String>> userIsSchedulingOrdinary(List<String> organizeId) {
+                return ActionResult.fail("请求失败");
+            }
+
+            @Override
+            public ActionResult<Boolean> hasRuleByUserIdAndTime(String userId, Date start, Date end) {
+                return ActionResult.fail("请求失败");
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceGroupApiFallback.java

@@ -0,0 +1,62 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceGroupApi;
+import jnpf.attendance.dto.AttendanceUserGroupVo;
+import jnpf.attendance.dto.AttendanceUserListGroupVO;
+import jnpf.base.ActionResult;
+import jnpf.entity.AttendanceGroup;
+import jnpf.model.attendance.vo.AttendanceGroupVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Title:
+ * @Author: peng.hao
+ * @create: 2024/4/23:16:09
+ */
+@Slf4j
+@Component
+public class AttendanceGroupApiFallback implements FallbackFactory<AttendanceGroupApi> {
+    @Override
+    public AttendanceGroupApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceGroupApi() {
+            @Override
+            public AttendanceGroup queryTheNameOfTheAttendanceGroup(String groupId) {
+                return new AttendanceGroup();
+            }
+
+            @Override
+            public List<AttendanceUserGroupVo> getAttendanceUserGroup(List<String> userIds) {
+                log.error("AttendanceGroupApiFallback调用getAttendanceUserGroup失败");
+                return new ArrayList<>();
+            }
+
+            @Override
+            public List<AttendanceGroup> getGroupListByOrgId(String organizeId) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<AttendanceUserListGroupVO>> getAttendanceUserListGroupVO(List<String> userIds) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<AttendanceGroupVo> getAttendanceGroupByName(String organizeName, String groupName) {
+                return null;
+            }
+
+            @Override
+            public boolean checkScheduling() {
+                return false;
+            }
+
+
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceLineSchedulingConfigApiFallback.java

@@ -0,0 +1,31 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceApi;
+import jnpf.attendance.AttendanceLineSchedulingConfigApi;
+import jnpf.model.attendance.vo.attendance.AttendanceToThousandsFacesVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@Slf4j
+@Component
+public class AttendanceLineSchedulingConfigApiFallback implements FallbackFactory<AttendanceLineSchedulingConfigApi> {
+
+    @Override
+    public AttendanceLineSchedulingConfigApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceLineSchedulingConfigApi() {
+            @Override
+            public Boolean noticeLineScheduling(String tenantId) {
+                return null;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceSimulateDataApiFallback.java

@@ -0,0 +1,30 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceSimulateDataApi;
+import jnpf.attendance.FtbClockInApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+/**
+ * 打卡api fallback
+ *
+ * @author yanwenfu
+ * @create 2023-12-04
+ */
+@Slf4j
+@Component
+public class AttendanceSimulateDataApiFallback implements FallbackFactory<AttendanceSimulateDataApi> {
+
+    @Override
+    public AttendanceSimulateDataApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceSimulateDataApi() {
+
+            @Override
+            public void clockIn(String tenantId) throws Exception {
+                log.error("调用模拟打卡失败...");
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/AttendanceUserApiFallback.java

@@ -0,0 +1,38 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.AttendanceUserApi;
+import jnpf.attendance.dto.GroupUpdateByUserDTO;
+import jnpf.base.ActionResult;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+/**
+ * describe
+ *
+ * @author HuangLinPan
+ * @date 2023/11/27
+ */
+
+@Slf4j
+@Component
+public class AttendanceUserApiFallback implements FallbackFactory<AttendanceUserApi> {
+
+    @Override
+    public AttendanceUserApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new AttendanceUserApi() {
+            @Override
+            public ActionResult groupUpdateByPersonnel(GroupUpdateByUserDTO groupUpdateByUserDTO) {
+                log.error("定时失效考勤劵失败...");
+                return null;
+            }
+
+            @Override
+            public ActionResult<Boolean> userGroupUpdateBySecondNotice(String tenantId) {
+                return null;
+            }
+
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/FtbClockInApiFallback.java

@@ -0,0 +1,60 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.FtbClockInApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+/**
+ * 打卡api fallback
+ *
+ * @author yanwenfu
+ * @create 2023-12-04
+ */
+@Slf4j
+@Component
+public class FtbClockInApiFallback implements FallbackFactory<FtbClockInApi> {
+
+    @Override
+    public FtbClockInApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new FtbClockInApi() {
+
+            @Override
+            public Boolean dailyRuleChangeExecute() {
+                log.error("dailyRuleChangeExecute调用失败...");
+                return Boolean.FALSE;
+            }
+
+            @Override
+            public Boolean generateFtbAbsenceRecord(String tenantId) {
+                log.error("generateFtbAbsenceRecord调用失败...");
+                return Boolean.FALSE;
+            }
+
+            @Override
+            public Boolean generateAbsenceTask(String tenantId) {
+                log.error("generateAbsenceTask调用失败...");
+                return Boolean.FALSE;
+            }
+
+            @Override
+            public Boolean generateBeforeWorkRemind(String tenantId) {
+                log.error("generateBeforeWorkRemind调用失败...");
+                return false;
+            }
+
+            @Override
+            public Boolean generateRepairNum(String tenantId) {
+                log.error("生成补卡次数失败...");
+                return Boolean.FALSE;
+            }
+
+            @Override
+            public Boolean continuousCheck(String tenantId) {
+                log.error("判定连续动作失败...");
+                return Boolean.FALSE;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/attendance/fallback/FtbStatisticsApiFallback.java

@@ -0,0 +1,129 @@
+package jnpf.attendance.fallback;
+
+import jnpf.attendance.FtbStatisticsApi;
+import jnpf.attendance.dto.*;
+import jnpf.base.ActionResult;
+import jnpf.model.attendance.dto.DayStatisticsDto;
+import jnpf.model.attendance.dto.SalaryAttendanceSupportDto;
+import jnpf.model.attendance.vo.attendance.AttendanceCustomizeTableVo;
+import jnpf.model.attendance.vo.attendance.DayStatisticsPageListVo;
+import jnpf.model.attendance.vo.attendance.DayStatisticsVo;
+import jnpf.model.attendance.vo.attendance.SalaryAttendanceSupportVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+@Slf4j
+@Component
+public class FtbStatisticsApiFallback implements FallbackFactory<FtbStatisticsApi> {
+    @Override
+    public FtbStatisticsApi create(Throwable cause) {
+        // 打印降级原因
+        log.error("进入 FtbStatisticsApi 的 fallback，降级原因：", cause);
+        return new FtbStatisticsApi() {
+            @Override
+            public ActionResult<Boolean> userDayStatisticsInit(String tenantId) {
+                return ActionResult.success(Boolean.FALSE);
+            }
+
+            @Override
+            public ActionResult<Boolean> dayStatisticsNotice(String tenantId) {
+                return ActionResult.success(Boolean.FALSE);
+            }
+
+            @Override
+            public ActionResult<Boolean> monthStatisticsNotice(String tenantId) {
+                return ActionResult.success(Boolean.FALSE);
+            }
+
+            @Override
+            public ActionResult<Boolean> teamMonthStatisticsNotice(String tenantId) {
+                return ActionResult.success(Boolean.FALSE);
+            }
+
+            @Override
+            public void consentUnscheduledNotice(String tenantId) {
+
+            }
+
+            @Override
+            public ActionResult<Boolean> autoSealTimer(String tenantId) {
+                return ActionResult.success(Boolean.FALSE);
+            }
+
+            @Override
+            public List<AttendanceCountAvgHoursVo> countAttendanceAvgHours(AttendanceCountAvgHoursDto dto) {
+                return List.of();
+            }
+
+            @Override
+            public ActionResult<MonthStatsDetailsVo> getAttendanceAvgHoursDetails(MonthStatsDetailsDto dto) {
+                return ActionResult.success(null);
+            }
+
+            @Override
+            public ActionResult<List<MonthStatsPerCapitaVo>> getAttendanceMonthPerCapita(MonthStatsDetailsDto dto) {
+                return ActionResult.success(List.of());
+            }
+
+            @Override
+            public ActionResult<List<MonthStatsDailySituationVo>> getAttendanceDailySituation(MonthStatsDetailsDto dto) {
+                return ActionResult.success(List.of());
+            }
+
+            @Override
+            public ActionResult<List<MonthStatsHoursRankingVo>> getAttendanceHoursRanking(MonthStatsDetailsDto dto) {
+                return ActionResult.success(List.of());
+            }
+
+            @Override
+            public ActionResult<List<MonthStatsFullSituationVo>> getAttendanceFullSituation(MonthStatsDetailsDto dto) {
+                return ActionResult.success(List.of());
+            }
+
+            @Override
+            public ActionResult<MonthStatsAbnormalConditionVo> getAttendanceAbnormalCondition(MonthStatsDetailsDto dto) {
+                return ActionResult.success(null);
+            }
+
+            @Override
+            public ActionResult<List<MonthStatsOvertimeSituationVo>> getAttendanceOvertimeSituation(MonthStatsDetailsDto dto) {
+                return ActionResult.success(List.of());
+            }
+
+            @Override
+            public Map<String, SalaryAttendanceSupportVo> salaryAttendanceSupport(SalaryAttendanceSupportDto dto) {
+                return Map.of();
+            }
+
+            @Override
+            public List<AttendanceCustomizeTableVo> attendanceDayStaTable() {
+                return List.of();
+            }
+
+            @Override
+            public List<DayStatisticsPageListVo> attendanceDayStaList(SalaryAttendanceSupportDto dto) {
+                return List.of();
+            }
+
+            @Override
+            public List<DayStatisticsVo> getAttendanceDayStaList(DayStatisticsDto dto) {
+                return List.of();
+            }
+
+            @Override
+            public Map<String, List<DateDimensionsRangeVo>> getDimensionsAttendanceCountMap(DimensionsAttendanceCountDto dto) {
+                return Map.of();
+            }
+
+            @Override
+            public Map<String, Map<Date, Integer>> getDimensionsAttendanceDayCountMap(DimensionsAttendanceDayCountDto dto) {
+                return Map.of();
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/authority/FtbAuthorityApi.java

@@ -0,0 +1,226 @@
+package jnpf.authority;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.authority.fallback.FtbAuthorityApiFallback;
+import jnpf.base.ActionResult;
+import jnpf.base.vo.PageListVO;
+import jnpf.model.authority.dto.menu.FunctionMenuRemoteDTO;
+import jnpf.model.authority.dto.menu.FuntionMenuDTO;
+import jnpf.model.authority.dto.permission.OrganizeWithPositionsDTO;
+import jnpf.model.authority.dto.role.FtbPermissionRoleInfoDTO;
+import jnpf.model.authority.vo.person.FtbRoleListDropDownVO;
+import jnpf.model.authority.vo.role.FtbPermissionRoleIdentificationVO;
+import jnpf.model.authority.vo.role.FtbPermissionRoleInfoVO;
+import jnpf.model.cultivate.CultivatePage;
+import jnpf.model.cultivate.vo.common.InnerPowerPositionVO;
+import jnpf.model.cultivate.vo.common.InnerPowerUserVO;
+import jnpf.model.login.MenuTreeVO;
+import jnpf.permission.dto.v2.user.QueryPageUserDTO;
+import jnpf.permission.dto.v2.user.QueryPageUserMoreKeywordDTO;
+import jnpf.permission.eum.v2.OrganizeCategoryEnums;
+import jnpf.permission.eum.v2.UserWorkStatusEnums;
+import jnpf.permission.vo.organize.OrganizeAndPositionListVO;
+import jnpf.permission.vo.store.StoreBaseListInfo;
+import jnpf.permission.vo.v2.TargetAuthIdsVO;
+import jnpf.permission.vo.v2.organzie.OrganizeGeneralDetailVO;
+import jnpf.permission.vo.v2.organzie.OrganizeManagerFilterNodeVO;
+import jnpf.permission.vo.v2.organzie.OrganizeManagerNodeVO;
+import jnpf.permission.vo.v2.position.PositionListUserVO;
+import jnpf.permission.vo.v2.user.UserBoundVO;
+import jnpf.util.NoDataSourceBind;
+import lombok.SneakyThrows;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.cloud.openfeign.SpringQueryMap;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @Author: peng.hao
+ * @create: 2025/3/27
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbAuthorityApiFallback.class)
+public interface FtbAuthorityApi {
+    /**
+     * 获取当前人员的数据权限范围
+     *
+     * @return
+     */
+    @GetMapping("/web/permission-role/query-user-scope-permission")
+    Map<String, String> queryUserScopeOfPermission(@RequestParam("userId") String userId);
+
+    @Operation(summary = "[门店基础信息列表auth api] 根据登录人权限得到权限范围内门店基础信息")
+    @GetMapping(value = "/permission/organize/list/store/login")
+    List<StoreBaseListInfo> authStoreBaseListInfo();
+
+    @Operation(summary = "[列表] 指定组织下得所有员工信息(FTB带权限)")
+    @GetMapping("/permission/users/list/targetOrganize/auth/api")
+    List<UserBoundVO> listTargetOrganizeIdAuthApi(@RequestParam(value = "organizeId") String organizeId, @RequestParam(value = "userWorkStatusEnumsList", required = false) List<UserWorkStatusEnums> userWorkStatusEnumsList);
+
+    @Operation(summary = "[列表] 指定组织集合下得所有员工信息(FTB带权限)")
+    @PostMapping("/permission/users/list/targetOrganizeIds/auth/api")
+    List<UserBoundVO> listTargetOrganizeIdsAuthApi(@RequestBody List<String> organizeIds, @RequestParam(value = "userWorkStatusEnumsList", required = false) List<UserWorkStatusEnums> userWorkStatusEnumsList);
+
+    @Operation(summary = "[分页] 在职人员列表")
+    @PostMapping("/permission/users/page")
+    @NoDataSourceBind
+    ActionResult<PageListVO<UserBoundVO>> pagePost(@RequestBody QueryPageUserDTO dto);
+
+    @Operation(summary = "[分页] 在职人员列表POST更多关键字信息")
+    @PostMapping("/permission/page/moreKeyword")
+    @NoDataSourceBind
+    ActionResult<PageListVO<UserBoundVO>> pagePostMoreKeyword(@RequestBody QueryPageUserMoreKeywordDTO dto);
+
+    @Operation(summary = "[列表]人员权限过滤后的岗位用户列表")
+    @GetMapping("/permission/position/tree/users")
+    ActionResult<List<PositionListUserVO>> authListPositionTreeUser();
+
+    @Operation(summary = "[api列表]权限范围内的多个组织及其岗位列表(不查人)")
+    @PostMapping("/permission/position/api/list/auth/organize-with-positions")
+    List<OrganizeAndPositionListVO> authOrganizeWithPositions(@RequestBody OrganizeWithPositionsDTO dto);
+
+    @Operation(summary = "[列表]权限过滤,获取所有用户信息,含绑定关系,或指定用户. 不使用权限则返回全部")
+    @PostMapping("/permission/users/info/all/auth")
+    @NoDataSourceBind
+    ActionResult<List<UserBoundVO>> authGetAllUserInfoBatch();
+
+    @Operation(summary = "[列表]权限范围内仅返回用户 id 列表，不查关系与 VO")
+    @PostMapping("/permission/users/ids/auth")
+    @NoDataSourceBind
+    ActionResult<List<String>> authGetPermissionScopeUserIds();
+
+    @Operation(summary = "[树形]人员权限过滤后的组织(公司,部门,门店,班主),人员")
+    @GetMapping(value = "/permission/organize/tree/users")
+    ActionResult<List<OrganizeManagerNodeVO>> listOrganizeTreeUsers();
+
+    @Operation(summary = "[列表]人员权限过滤后的组织列表")
+    @GetMapping(value = "/permission/organize/info/list/users")
+    @NoDataSourceBind
+    ActionResult<List<OrganizeGeneralDetailVO>> authOrganizesByUserBound(@RequestParam(value = "organizeCategoryEnums", required = false) List<OrganizeCategoryEnums> organizeCategoryEnums);
+
+    /**
+     * @param organizeCategoryEnums 组织类型
+     * @param workStatusEnums       工作状态
+     * @param withEmployee          是否包含人员
+     * @param filterBindOtherStore  过滤绑定第三方信息门店
+     * @param filterBindPayStore    过滤收银平台门店
+     * @return 组织树(with auth)
+     */
+    @Operation(summary = "[api树形,滤掉没有的分支]人员权限过滤后的组织(公司,部门,门店,班主),默认不带人员")
+    @GetMapping(value = "/permission/organize/api/tree/users/filterNode")
+    List<OrganizeManagerFilterNodeVO> listOrganizeTreeFilterNode(
+            @RequestParam(value = "organizeCategoryEnums", required = false) List<OrganizeCategoryEnums> organizeCategoryEnums,
+            @RequestParam(value = "workStatusEnums", required = false) List<UserWorkStatusEnums> workStatusEnums,
+            @RequestParam(value = "withEmployee", required = false) Boolean withEmployee,
+            @RequestParam(value = "filterBindOtherStore", required = false) Boolean filterBindOtherStore,
+            @RequestParam(value = "filterBindPayStore", required = false) Boolean filterBindPayStore
+    );
+
+    @Operation(summary = "角色列表下拉")
+    @GetMapping(value = "/web/permission-role-authorize-person/allRolesOfTheCurrentPerson")
+    @NoDataSourceBind
+    ActionResult<List<FtbRoleListDropDownVO>> roleListDropDown(@RequestParam("userId") String userId, @RequestParam("tenantId") String tenantId);
+
+    /**
+     * 根据模块编码获取当前人员的数据权限范围
+     *
+     * @return
+     */
+    @GetMapping("/web/permission-role/query-user-scope-permission-for-module-code")
+    InnerPowerUserVO queryUserScopeOfPermissionForModuleCode();
+
+    /**
+     * 远程client
+     * 包含新增修改
+     */
+    @SneakyThrows
+    @PostMapping("/remoteClient")
+    @NoDataSourceBind
+    void remoteClient(FunctionMenuRemoteDTO dto);
+
+
+    @GetMapping("/position/get-curr-login-user-has-permission-position-id")
+    InnerPowerPositionVO getCurrLoginUserHasPermissionPositionId(@RequestParam(name = "permissionModule", defaultValue = "") String permissionModule);
+
+    /**
+     * 更具岗位id清除所有绑定的角色
+     */
+    @PostMapping("/web/permission-role-authorize-post/clearRoleByPostId")
+    void clearRoleByPostId(@RequestBody List<String> postIds);
+
+    /**
+     * @param userIds 用户列表
+     * @param status  状态 1：禁用 0：启用 -1-所有
+     * @param tenantId 租户id
+     * @return
+     */
+    @Operation(summary = "[列表]根据用户列表批量查询权限范围的门店")
+    @PostMapping(value = "/permission/organize/batchForUserIds/{status}/{moduleId}/{tenantId}")
+    @NoDataSourceBind
+    Map<String, List<String>> batchAuthOrganizesForUserIdsAndTenantId(@RequestBody List<String> userIds, @PathVariable("status") Integer status,@PathVariable("moduleId") String moduleId,@PathVariable("tenantId") String tenantId);
+/**
+     * @param userIds 用户列表
+     * @param status  状态 1：禁用 0：启用 -1-所有
+     * @param tenantId 租户id
+     * @return
+     */
+    @Operation(summary = "[列表]根据用户列表批量查询权限范围的门店")
+    @PostMapping(value = "/permission/organize/batchAllForUserIds/{status}/{moduleId}/{tenantId}")
+    @NoDataSourceBind
+    Map<String, List<String>> batchAuthOrganizesAllForUserIdsAndTenantId(@RequestBody List<String> userIds, @PathVariable("status") Integer status,@PathVariable("moduleId") String moduleId,@PathVariable("tenantId") String tenantId);
+
+    /**
+     * @param userIds 用户列表
+     * @param status  状态 1：禁用 0：启用 -1-所有
+     * @return
+     */
+    @Operation(summary = "[列表]根据用户列表批量查询权限范围的门店")
+    @PostMapping(value = "/permission/organize/batchForUserIds/{status}")
+    Map<String, List<String>> batchAuthOrganizesForUserIds(@RequestBody List<String> userIds, @PathVariable("status") Integer status);
+
+
+    /**
+     * 角色列表
+     *
+     * @return {@link ActionResult }<{@link PageListVO }<{@link FtbPermissionRoleInfoVO }>>
+     */
+    @GetMapping("/web/permission-role/role-list")
+    ActionResult<PageListVO<FtbPermissionRoleInfoVO>> permissionList(@SpringQueryMap CultivatePage cultivatePage, @SpringQueryMap FtbPermissionRoleInfoDTO roleInfoDTO);
+
+    /**
+     * 当前登录用户所有权限用户id
+     *
+     * @return 用户id集合
+     */
+    @GetMapping("/web/permission-role-authorize-person/permission-user")
+    ActionResult<List<String>> permissionUser(@RequestParam("userId") String userId, @RequestParam("permissionModule") String permissionModule, @RequestParam("category") String category);
+
+    /**
+     * 员工已有的功能权限标识集合
+     */
+    @GetMapping("/web/permission-role/permission-identification-collection")
+    ActionResult<FtbPermissionRoleIdentificationVO> permissionIdentificationCollection();
+
+    /**
+     * 查询那些人员具有当前按钮权限
+     */
+    @PostMapping("/web/permission-role-authorize-person/queryButtonPermission")
+    List<String> queryButtonPermission(@RequestBody FuntionMenuDTO funtion);
+
+    /**
+     * 根据用户Id获取用户权限的用户Id集合（超级管理员不要调用此方法）
+     * @return 用户id->所具有的权限用户id集合
+     */
+    @PostMapping("/web/permission-role-authorize-person/collection-of-user")
+    Map<String,List<String>> getUserPermissionUserCollection(@RequestBody List<String> userIds);
+
+    @GetMapping(value = "/permission/organize/user-auth")
+    TargetAuthIdsVO getUserAuth();
+    /**
+     * 当前登录用户菜单树（与 FTB 登录菜单一致；type=Web|App）
+     */
+    @GetMapping("/web/permission-role/obtain-menus-on-token")
+    ActionResult<List<MenuTreeVO>> obtainMenusOnToken(@RequestParam(value = "type", defaultValue = "Web") String type);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/authority/fallback/FtbAuthorityApiFallback.java

@@ -0,0 +1,188 @@
+package jnpf.authority.fallback;
+
+import jnpf.authority.FtbAuthorityApi;
+import jnpf.base.ActionResult;
+import jnpf.base.vo.PageListVO;
+import jnpf.model.authority.dto.menu.FunctionMenuRemoteDTO;
+import jnpf.model.authority.dto.menu.FuntionMenuDTO;
+import jnpf.model.authority.dto.permission.OrganizeWithPositionsDTO;
+import jnpf.model.authority.dto.role.FtbPermissionRoleInfoDTO;
+import jnpf.model.authority.vo.person.FtbRoleListDropDownVO;
+import jnpf.model.authority.vo.role.FtbPermissionRoleIdentificationVO;
+import jnpf.model.authority.vo.role.FtbPermissionRoleInfoVO;
+import jnpf.model.cultivate.CultivatePage;
+import jnpf.model.cultivate.vo.common.InnerPowerPositionVO;
+import jnpf.model.cultivate.vo.common.InnerPowerUserVO;
+import jnpf.model.login.MenuTreeVO;
+import jnpf.permission.dto.v2.user.QueryPageUserDTO;
+import jnpf.permission.dto.v2.user.QueryPageUserMoreKeywordDTO;
+import jnpf.permission.eum.v2.OrganizeCategoryEnums;
+import jnpf.permission.eum.v2.UserWorkStatusEnums;
+import jnpf.permission.vo.organize.OrganizeAndPositionListVO;
+import jnpf.permission.vo.store.StoreBaseListInfo;
+import jnpf.permission.vo.v2.TargetAuthIdsVO;
+import jnpf.permission.vo.v2.organzie.OrganizeGeneralDetailVO;
+import jnpf.permission.vo.v2.organzie.OrganizeManagerFilterNodeVO;
+import jnpf.permission.vo.v2.organzie.OrganizeManagerNodeVO;
+import jnpf.permission.vo.v2.position.PositionListUserVO;
+import jnpf.permission.vo.v2.user.UserBoundVO;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+@Slf4j
+@Component
+public class FtbAuthorityApiFallback implements FallbackFactory<FtbAuthorityApi> {
+
+    @Override
+    public FtbAuthorityApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new FtbAuthorityApi() {
+            @Override
+            public Map<String, String> queryUserScopeOfPermission(String userId) {
+                log.error("queryUserScopeOfPermission 调用失败...");
+                return null;
+            }
+
+            @Override
+            public List<StoreBaseListInfo> authStoreBaseListInfo() {
+                return List.of();
+            }
+
+            @Override
+            public List<UserBoundVO> listTargetOrganizeIdAuthApi(String organizeId, List<UserWorkStatusEnums> userWorkStatusEnumsList) {
+                return List.of();
+            }
+
+            @Override
+            public List<UserBoundVO> listTargetOrganizeIdsAuthApi(List<String> organizeIds, List<UserWorkStatusEnums> userWorkStatusEnumsList) {
+                return List.of();
+            }
+
+            @Override
+            public ActionResult<PageListVO<UserBoundVO>> pagePost(QueryPageUserDTO dto) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<PageListVO<UserBoundVO>> pagePostMoreKeyword(QueryPageUserMoreKeywordDTO dto) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<PositionListUserVO>> authListPositionTreeUser() {
+                return null;
+            }
+
+            @Override
+            public List<OrganizeAndPositionListVO> authOrganizeWithPositions(OrganizeWithPositionsDTO dto) {
+                return List.of();
+            }
+
+            @Override
+            public ActionResult<List<UserBoundVO>> authGetAllUserInfoBatch() {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<String>> authGetPermissionScopeUserIds() {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<OrganizeManagerNodeVO>> listOrganizeTreeUsers() {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<OrganizeGeneralDetailVO>> authOrganizesByUserBound(List<OrganizeCategoryEnums> organizeCategoryEnums) {
+                return null;
+            }
+
+            @Override
+            public List<OrganizeManagerFilterNodeVO> listOrganizeTreeFilterNode(List<OrganizeCategoryEnums> organizeCategoryEnums, List<UserWorkStatusEnums> workStatusEnums, Boolean withEmployee, Boolean filterBindOtherStore, Boolean filterBindPayStore) {
+                return List.of();
+            }
+
+            @Override
+            public ActionResult<List<FtbRoleListDropDownVO>> roleListDropDown(String userId, String tenantId) {
+                return null;
+            }
+
+            @Override
+            public InnerPowerUserVO queryUserScopeOfPermissionForModuleCode() {
+                return null;
+            }
+
+            @Override
+            public void remoteClient(FunctionMenuRemoteDTO dto) {
+
+            }
+
+            @Override
+            public InnerPowerPositionVO getCurrLoginUserHasPermissionPositionId(String permissionModule) {
+                return null;
+            }
+
+            @Override
+            public void clearRoleByPostId(List<String> postIds) {
+
+            }
+
+            @Override
+            public Map<String, List<String>> batchAuthOrganizesForUserIdsAndTenantId(List<String> userIds, Integer status, String moduleId, String tenantId) {
+                return Map.of();
+            }
+            @Override
+            public Map<String, List<String>> batchAuthOrganizesAllForUserIdsAndTenantId(List<String> userIds, Integer status, String moduleId, String tenantId) {
+                return Map.of();
+            }
+
+            @Override
+            public Map<String, List<String>> batchAuthOrganizesForUserIds(List<String> userIds, Integer status) {
+                return null;
+            }
+
+
+            @Override
+            public ActionResult<PageListVO<FtbPermissionRoleInfoVO>> permissionList(CultivatePage cultivatePage, FtbPermissionRoleInfoDTO roleInfoDTO) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<String>> permissionUser(String userId, String permissionModule, String category) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<FtbPermissionRoleIdentificationVO> permissionIdentificationCollection() {
+                return null;
+            }
+
+            @Override
+            public List<String> queryButtonPermission(FuntionMenuDTO funtion) {
+                return null;
+            }
+
+            @Override
+            public Map<String, List<String>> getUserPermissionUserCollection(List<String> userIds) {
+                return Collections.emptyMap();
+            }
+
+            @Override
+            public ActionResult<List<MenuTreeVO>> obtainMenusOnToken(String type) {
+                log.warn("FtbAuthorityApi fallback: obtainMenusOnToken type={}", type);
+                return ActionResult.success(Collections.emptyList());
+            }
+
+            @Override
+            public TargetAuthIdsVO getUserAuth() {
+                return null;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/certificate/CertificateManageApi.java

@@ -0,0 +1,57 @@
+package jnpf.certificate;
+
+import jnpf.base.ActionResult;
+import jnpf.certificate.fallback.CertificateManageFallbackApi;
+import jnpf.model.certificate.vo.CertificateOrganizeBusinessLicenseVO;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import javax.validation.Valid;
+import java.util.Collection;
+import java.util.List;
+
+@FeignClient(name = "jnpf-ftb", fallback = CertificateManageFallbackApi.class, path = "/web/certificate-manage-api")
+public interface CertificateManageApi {
+
+    /**
+     * 根据组织ID查询营业执照信息。
+     *
+     * @param organizeId 组织ID
+     * @return 营业执照信息
+     */
+    @GetMapping("/query-business-license")
+    ActionResult<CertificateOrganizeBusinessLicenseVO> queryBusinessLicense(@RequestParam("organizeId") String organizeId);
+
+    /**
+     * 根据组织ID列表批量查询营业执照信息。
+     *
+     * @param organizeIds 组织ID列表
+     * @return 营业执照信息列表
+     */
+    @PostMapping("/query-business-license-batch")
+    ActionResult<List<CertificateOrganizeBusinessLicenseVO>> queryBusinessLicenseBatch(@RequestBody Collection<String> organizeIds);
+
+    /**
+     * 保存组织营业执照信息。
+     *
+     * @param req 营业执照保存参数
+     * @return 操作结果
+     */
+    @PostMapping("/save-business-license")
+    ActionResult<Void> saveBusinessLicense(@Valid @RequestBody CertificateOrganizeBusinessLicenseVO req);
+
+    /**
+     * 根据组织ID删除该主体下全部证照信息。
+     *
+     * @param organizeId 组织ID
+     * @param loginUserId 登录用户ID
+     * @return 操作结果
+     */
+    @DeleteMapping("/delete-business-license")
+    ActionResult<Void> deleteBusinessLicense(@RequestParam("organizeId") String organizeId,
+                                             @RequestParam(value = "loginUserId", required = false) String loginUserId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/certificate/CertificateWarningApi.java

@@ -0,0 +1,19 @@
+package jnpf.certificate;
+
+import jnpf.base.ActionResult;
+import jnpf.certificate.fallback.CertificateWarningFallbackApi;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+@FeignClient(name = "jnpf-ftb", fallback = CertificateWarningFallbackApi.class, path = "/web/certificate-warning-api")
+public interface CertificateWarningApi {
+
+    /**
+     * 检查并发送预警
+     * @param tenantId
+     * @return
+     */
+    @PostMapping("/checkAndSendCertificateWarning")
+    ActionResult<Boolean> checkAndSendCertificateWarning(@RequestParam("tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/certificate/fallback/CertificateManageFallbackApi.java

@@ -0,0 +1,44 @@
+package jnpf.certificate.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.certificate.CertificateManageApi;
+import jnpf.model.certificate.vo.CertificateOrganizeBusinessLicenseVO;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * 组织营业执照接口降级实现。
+ */
+@Slf4j
+@Component
+public class CertificateManageFallbackApi implements CertificateManageApi {
+
+    @Override
+    public ActionResult<CertificateOrganizeBusinessLicenseVO> queryBusinessLicense(String organizeId) {
+        log.error("queryBusinessLicense调用失败，organizeId={}", organizeId);
+        return ActionResult.success(null);
+    }
+
+    @Override
+    public ActionResult<List<CertificateOrganizeBusinessLicenseVO>> queryBusinessLicenseBatch(Collection<String> organizeIds) {
+        log.error("queryBusinessLicenseBatch调用失败，organizeIds={}", organizeIds);
+        return ActionResult.success(Collections.emptyList());
+    }
+
+    @Override
+    public ActionResult<Void> saveBusinessLicense(CertificateOrganizeBusinessLicenseVO req) {
+        log.error("saveBusinessLicense调用失败，req={}", req);
+        return ActionResult.success();
+    }
+
+    @Override
+    public ActionResult<Void> deleteBusinessLicense(String organizeId, String loginUserId) {
+        log.error("deleteBusinessLicense failed, organizeId={}.loginUserId={}", organizeId,loginUserId);
+        return ActionResult.success();
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/certificate/fallback/CertificateWarningFallbackApi.java

@@ -0,0 +1,16 @@
+package jnpf.certificate.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.certificate.CertificateWarningApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Component
+public class CertificateWarningFallbackApi implements CertificateWarningApi {
+    @Override
+    public ActionResult<Boolean> checkAndSendCertificateWarning(String tenantId) {
+        log.error("checkAndSendCertificateWarning调用失败，tenantId={}", tenantId);
+        return ActionResult.success(Boolean.FALSE);
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/FtbCultivateIdentifyApi.java

@@ -0,0 +1,33 @@
+package jnpf.cultivate;
+
+import jnpf.cultivate.fallback.FtbCultivateIdentifyApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * 鉴定api
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbCultivateIdentifyApiFallback.class, path = "/cultivate")
+public interface FtbCultivateIdentifyApi {
+    /**
+     * 处理鉴定逾期数据
+     *
+     * @param tenantId
+     * @return
+     */
+    @PostMapping(value = "/apply/setIdentifyBeOverdue")
+    @NoDataSourceBind
+    Boolean setIdentifyBeOverdue(@RequestParam(value = "tenantId") String tenantId);
+
+    /**
+     * 计划鉴定时间提醒
+     *
+     * @param tenantId
+     * @return
+     */
+    @PostMapping(value = "/apply/setIdentifyRemind")
+    @NoDataSourceBind
+    Boolean setIdentifyRemind(@RequestParam(value = "tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/FtbCultivateLearnTaskListApi.java

@@ -0,0 +1,33 @@
+package jnpf.cultivate;
+
+import jnpf.cultivate.fallback.FtbCultivateLearnTaskApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+
+/**
+ * 鉴定api
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbCultivateLearnTaskApiFallback.class, path = "/web/learnTaskList/")
+public interface FtbCultivateLearnTaskListApi {
+
+    /**
+     * 定时加入任务
+     *
+     * @return
+     */
+    @GetMapping("/timing/timingAddNewPersonToTaskNew/{tenantId}")
+    @NoDataSourceBind
+    void timingAddNewPersonToTaskNew(@PathVariable("tenantId") String tenantId);
+
+
+    /**
+     * 定时提醒任务（每天定点）
+     *
+     * @return
+     */
+    @GetMapping("/timing/timingTaskLearningAlertNew/{tenantId}")
+    @NoDataSourceBind
+    void timingTaskLearningAlertNew(@PathVariable("tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/FtbCultivatePromotionApi.java

@@ -0,0 +1,42 @@
+package jnpf.cultivate;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.base.ActionResult;
+import jnpf.cultivate.fallback.FtbCultivatePromotionFallback;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+
+/**
+ * @Title:FtbCultivatePromotionMemberApi
+ * @Author:peng.hao
+ * @create: 2024/1/1815:58
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbCultivatePromotionFallback.class )
+public interface FtbCultivatePromotionApi {
+
+    /**
+     * 拖动删除成员启用对应晋升通道
+     * @param userIds 用户id
+     * @return
+     */
+    @PutMapping("/cul_pro_member/deleteMembersToProChannel")
+    ActionResult<Boolean> deleteMembersToProChannel(@RequestBody List<String> userIds);
+
+    /**
+     * 获取是否有人岗位职等的晋升申请
+     * @param postId 公司岗位ID
+     * @param grandId 职等ID
+     * @param userId 用户ID
+     * @return 成功结果
+     */
+    @GetMapping("/cul-post-apply/userIsHasApply")
+    @Operation(summary = "查看当前的人岗位职等是否存在晋升申请")
+    ActionResult<Boolean> isThereAnAppForThePosLevel(@RequestParam("postId") String postId,
+                                                            @RequestParam("grandId") String grandId,
+                                                            @RequestParam("userId") String userId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/FtbCultivateStoreStatisticApi.java

@@ -0,0 +1,101 @@
+package jnpf.cultivate;
+
+import jnpf.base.ActionResult;
+import jnpf.cultivate.fallback.FtbCultivateStoreStatisticApiFallback;
+import jnpf.model.cultivate.dto.storestatistics.*;
+import jnpf.model.cultivate.vo.position.*;
+import jnpf.model.thousandsfaces.TodayWorkVo;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import java.util.List;
+
+/**
+ * 鉴定api
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbCultivateStoreStatisticApiFallback.class, path = "/web/store-index-statistics")
+public interface FtbCultivateStoreStatisticApi {
+    /**
+     * 店长页面 培训统计数量
+     */
+    @PostMapping("/get-cultivate-count")
+    ActionResult<FtbCultivateStoreCountVO> getCultivateCount(@RequestBody FtbCultivateStoreStatisticsReq req);
+
+    /**
+     * 查询我的考试列表
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/queryMyExamList")
+    ActionResult<List<TodayWorkVo>> queryMyExamList(@RequestBody StoreStatisticsMyExamReq req);
+
+
+    /**
+     * 待我批阅(下属的)
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/queryWaitMyReadOver")
+    ActionResult<List<TodayWorkVo>> queryWaitMyReadOver(@RequestBody StoreStatisticsWaitMyCheckExamReq req);
+
+
+    /**
+     * 今日工作-待参与及参与中的线下培训<负责人及参与人均属于相关人员>列表
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/queryOfflineTrainList")
+    ActionResult<List<TodayWorkVo>> queryOfflineTrainList(@RequestBody StoreOfflineTrainReq req);
+
+
+    /**
+     * 今日工作-我的任务（当日开始的培训任务）列表
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/myTaskList")
+    ActionResult<List<TodayWorkVo>> storeMyTaskList(@RequestBody StoreOfflineTrainReq req);
+
+    /**
+     * 今日工作-鉴定他人（当日的待鉴定）列表
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/myIdentityList")
+    ActionResult<List<TodayWorkVo>> storeMyIdentityList(@RequestBody StoreIdentityReq req);
+
+    /**
+     * 员工界面 查询未学习的通用课程数量
+     *
+     * @param req
+     * @return
+     */
+    @PostMapping("/get-worker-cultivate-count")
+    ActionResult<FtbCultivateWorkerCountVO> getWorkerCultivateCount(@RequestBody FtbCultivateStoreStatisticsReq req);
+
+
+    /**
+     * 工作台-员工
+     */
+    @PostMapping("/person/training-statistics")
+    ActionResult<FtbPersonTrainingStatisticsVO> personTrainingStatistics(@RequestBody FtbCultivateStoreStatisticsReq req);
+
+
+    /**
+     * 工作台-店长
+     */
+    @PostMapping("/store-manager/training-statistics")
+    ActionResult<FtbStoreManagerTrainingStatisticsVO> storeManagerTrainingStatistics(@RequestBody FtbCultivateStoreStatisticsReq req);
+
+    /**
+     * 工作台-管理层
+     */
+    @PostMapping("/manager/training-statistics")
+    ActionResult<FtbManagerTrainingStatisticsVO> managerTrainingStatistics(@RequestBody FtbCultivateStoreStatisticsReq req);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/FtbCultivateTeachingApi.java

@@ -0,0 +1,51 @@
+package jnpf.cultivate;
+
+import jnpf.cultivate.fallback.FtbCultivateTeachingApiFallback;
+import jnpf.model.cultivate.vo.teaching.MyPracticeSummaryVo;
+import jnpf.model.cultivate.vo.teaching.SuperiorTeachingSummaryVo;
+import jnpf.model.cultivate.vo.teaching.TeachingStoreCountVo;
+import jnpf.model.cultivate.vo.teaching.TodaySummaryDataVo;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * 带教api
+ */
+@FeignClient(name = "jnpf-ftb", fallbackFactory = FtbCultivateTeachingApiFallback.class, path = "/")
+public interface FtbCultivateTeachingApi {
+
+    /**
+     * 店长界面我的带教统计
+     * @param storeId 门店id
+     * @return TeachingStoreCountVo
+     */
+    @GetMapping("app/teachingRecord/storeTeachingCount")
+    TeachingStoreCountVo storeTeachingCount(@RequestParam("storeId") String storeId);
+
+    /**
+     * App店长界面-今日练习汇总数据
+     *
+     * @param storeId 查询参数
+     * @return 练习汇总数据
+     */
+    @GetMapping("teachingRecord/app/getTodaySummary")
+    TodaySummaryDataVo getTodaySummary(@RequestParam("storeId") String storeId);
+
+    /**
+     * 员工界面-上级带教统计
+     * @param storeId 门店id
+     * @return TeachingStoreCountVo
+     */
+    @GetMapping("app/teachingRecord/getSuperiorTeachingSummary")
+    SuperiorTeachingSummaryVo getSuperiorTeachingSummary(@RequestParam("storeId") String storeId);
+
+    /**
+     * 员工界面--我的练习汇总数据
+     *
+     * @param storeId 查询参数
+     * @return 练习汇总数据
+     */
+    @GetMapping("teachingRecord/app/getMyPracticeSummary")
+    MyPracticeSummaryVo getMyPracticeSummary(@RequestParam("storeId") String storeId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/V2CultivateOldDealApi.java

@@ -0,0 +1,51 @@
+package jnpf.cultivate;
+
+import jnpf.base.ActionResult;
+import jnpf.cultivate.fallback.V2CultivateOldDealApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+@FeignClient(name = "jnpf-ftb", fallbackFactory = V2CultivateOldDealApiFallback.class, path = "/v2/cultivate/old")
+public interface V2CultivateOldDealApi {
+
+    /**
+     * 课程心得评论旧数据处理
+     *
+     * @param tenantId 租户ID
+     * @return 响应
+     */
+    @NoDataSourceBind
+    @GetMapping("/gained/comment")
+    ActionResult<Boolean> dealOldData(@RequestParam("tenantId") String tenantId);
+
+    @NoDataSourceBind
+    @GetMapping("/identify/deal-old")
+    ActionResult<Boolean> identifyDealOldData(@RequestParam("tenantId") String tenantId);
+
+    /**
+     * 迁移旧培训任务数据到新的任务日志表
+     *
+     * @param tenantId 租户ID
+     * @return 响应
+     */
+    @NoDataSourceBind
+    @GetMapping("/task/old-data")
+    ActionResult<String> migrateOldTaskData(@RequestParam("tenantId") String tenantId);
+
+    /**
+     * 旧晋升通道成员数据迁移接口
+     * 将 ftb_cultivate_promotion_member_new 表中的用户数据迁移到
+     * ftb_cultivate_promotion_user 和 ftb_cultivate_promotion_setting 表中
+     * 同时校验用户是否为正常状态（enabledMark = 1）
+     *
+     * @param tenantId 租户ID
+     * @param promotionId 晋升通道ID（可选，如果传入则只迁移指定通道的数据）
+     * @return 响应结果
+     */
+    @NoDataSourceBind
+    @GetMapping("/promotion/migrate-old-data")
+    ActionResult<String> migratePromotionOldData(@RequestParam("tenantId") String tenantId,
+                                                  @RequestParam(value = "promotionId", required = false) String promotionId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/FtbCultivateIdentifyApiFallback.java

@@ -0,0 +1,29 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.cultivate.FtbCultivateIdentifyApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Component
+public class FtbCultivateIdentifyApiFallback implements FallbackFactory<FtbCultivateIdentifyApi> {
+
+    @Override
+    public FtbCultivateIdentifyApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new FtbCultivateIdentifyApi() {
+            @Override
+            public Boolean setIdentifyBeOverdue(String tenantId) {
+                log.error("setIdentifyBeOverdue调用失败...");
+                return false;
+            }
+
+            @Override
+            public Boolean setIdentifyRemind(String tenantId) {
+                log.error("setIdentifyRemind调用失败...");
+                return false;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/FtbCultivateLearnTaskApiFallback.java

@@ -0,0 +1,31 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.cultivate.FtbCultivateLearnTaskListApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Component
+public class FtbCultivateLearnTaskApiFallback implements FallbackFactory<FtbCultivateLearnTaskListApi> {
+
+
+    @Override
+    public FtbCultivateLearnTaskListApi create(Throwable cause) {
+        log.error("进入 FtbCultivateLearnTaskApiFallback 的 fallback，降级原因：", cause); // 打印降级原因
+
+        return new FtbCultivateLearnTaskListApi() {
+
+
+            @Override
+            public void timingAddNewPersonToTaskNew(String tenantId) {
+
+            }
+
+            @Override
+            public void timingTaskLearningAlertNew(String tenantId) {
+
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/FtbCultivatePromotionFallback.java

@@ -0,0 +1,34 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.cultivate.FtbCultivatePromotionApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Slf4j
+@Component
+public class FtbCultivatePromotionFallback implements FallbackFactory<FtbCultivatePromotionApi> {
+
+
+    @Override
+    public FtbCultivatePromotionApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new FtbCultivatePromotionApi() {
+            @Override
+            public ActionResult<Boolean> deleteMembersToProChannel(List<String> userIds) {
+                log.error("deleteMembersToProChannel 调用失败...");
+                return null;
+            }
+
+            @Override
+            public ActionResult<Boolean> isThereAnAppForThePosLevel(String postId, String grandId, String userId) {
+                log.error("isThereAnAppForThePosLevel 调用失败...");
+                return null;
+            }
+        };
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/FtbCultivateStoreStatisticApiFallback.java

@@ -0,0 +1,76 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.cultivate.FtbCultivateStoreStatisticApi;
+import jnpf.model.cultivate.dto.storestatistics.*;
+import jnpf.model.cultivate.vo.position.*;
+import jnpf.model.thousandsfaces.TodayWorkVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Slf4j
+@Component
+public class FtbCultivateStoreStatisticApiFallback implements FallbackFactory<FtbCultivateStoreStatisticApi> {
+
+
+    @Override
+    public FtbCultivateStoreStatisticApi create(Throwable cause) {
+        log.error("进入 FtbCultivateStoreStatisticApi 的 fallback，降级原因：", cause); // 打印降级原因
+
+        return new FtbCultivateStoreStatisticApi() {
+
+            @Override
+            public ActionResult<FtbCultivateStoreCountVO> getCultivateCount(FtbCultivateStoreStatisticsReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<TodayWorkVo>> queryMyExamList(StoreStatisticsMyExamReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<TodayWorkVo>> queryWaitMyReadOver(StoreStatisticsWaitMyCheckExamReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<TodayWorkVo>> queryOfflineTrainList(StoreOfflineTrainReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<TodayWorkVo>> storeMyTaskList(StoreOfflineTrainReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<List<TodayWorkVo>> storeMyIdentityList(StoreIdentityReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<FtbCultivateWorkerCountVO> getWorkerCultivateCount(FtbCultivateStoreStatisticsReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<FtbPersonTrainingStatisticsVO> personTrainingStatistics(FtbCultivateStoreStatisticsReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<FtbStoreManagerTrainingStatisticsVO> storeManagerTrainingStatistics(FtbCultivateStoreStatisticsReq req) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<FtbManagerTrainingStatisticsVO> managerTrainingStatistics(FtbCultivateStoreStatisticsReq req) {
+                return null;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/FtbCultivateTeachingApiFallback.java

@@ -0,0 +1,42 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.cultivate.FtbCultivateTeachingApi;
+import jnpf.model.cultivate.vo.teaching.MyPracticeSummaryVo;
+import jnpf.model.cultivate.vo.teaching.SuperiorTeachingSummaryVo;
+import jnpf.model.cultivate.vo.teaching.TeachingStoreCountVo;
+import jnpf.model.cultivate.vo.teaching.TodaySummaryDataVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Component
+public class FtbCultivateTeachingApiFallback implements FallbackFactory<FtbCultivateTeachingApi> {
+
+    @Override
+    public FtbCultivateTeachingApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new FtbCultivateTeachingApi() {
+
+            @Override
+            public TeachingStoreCountVo storeTeachingCount(String storeId) {
+                return null;
+            }
+
+            @Override
+            public TodaySummaryDataVo getTodaySummary(String storeId) {
+                return new TodaySummaryDataVo();
+            }
+
+            @Override
+            public SuperiorTeachingSummaryVo getSuperiorTeachingSummary(String storeId) {
+                return null;
+            }
+
+            @Override
+            public MyPracticeSummaryVo getMyPracticeSummary(String storeId) {
+                return null;
+            }
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/cultivate/fallback/V2CultivateOldDealApiFallback.java

@@ -0,0 +1,39 @@
+package jnpf.cultivate.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.cultivate.V2CultivateOldDealApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.cloud.openfeign.FallbackFactory;
+import org.springframework.stereotype.Component;
+
+@Slf4j
+@Component
+public class V2CultivateOldDealApiFallback implements FallbackFactory<V2CultivateOldDealApi> {
+
+    @Override
+    public V2CultivateOldDealApi create(Throwable cause) {
+        cause.printStackTrace();
+        return new V2CultivateOldDealApi() {
+            @Override
+            public ActionResult<Boolean> dealOldData(String tenantId) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<Boolean> identifyDealOldData(String tenantId) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<String> migrateOldTaskData(String tenantId) {
+                return null;
+            }
+
+            @Override
+            public ActionResult<String> migratePromotionOldData(String tenantId, String promotionId) {
+                return null;
+            }
+
+        };
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/doclibrary/StoreApi.java

@@ -0,0 +1,205 @@
+package jnpf.doclibrary;
+
+import com.github.pagehelper.PageInfo;
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.base.ActionResult;
+import jnpf.doclibrary.fallback.StoreFallback;
+import jnpf.entity.StoreEntity;
+import jnpf.model.store.Store;
+import jnpf.model.store.StorePositionInfoVo;
+import jnpf.model.store.StoreUserNumVo;
+import jnpf.model.store.dto.StoreAbnormalIdsQueryDTO;
+import jnpf.model.store.dto.StorePageByIdsNoDsQueryDTO;
+import jnpf.model.store.dto.StorePageByIdsQueryDTO;
+import jnpf.model.store.vo.StoreBaseListVO;
+import jnpf.model.store.vo.StoreLocationVO;
+import jnpf.model.store.vo.UserStoreListVo;
+import jnpf.model.vo.StoreExecutionVo;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * 门店内部调用api
+ *
+ * @author yanwenfu
+ * @create 2023-07-12
+ */
+@FeignClient(name = "jnpf-ftb", fallback = StoreFallback.class, path = "/Store")
+public interface StoreApi {
+
+    /**
+     * 查询门店下岗位的成员数量
+     * @param storeId 门店id
+     * @param positionList 岗位id集合
+     * @return java.util.List<jnpf.model.store.StorePositionInfoVo>
+     */
+    @GetMapping(value = "/storePositionInfo/list")
+    List<StorePositionInfoVo> getStorePositionInfoList(@RequestParam(value = "storeId") String storeId, @RequestParam(value = "positionList") List<String> positionList);
+
+    /**
+     * 查询门店下的成员数量
+     * @param storeIds 门店ids
+     * @return java.util.List<jnpf.model.store.StorePositionInfoVo>
+     */
+    @GetMapping(value = "/storePositionInfo/getUserNum")
+    List<StoreUserNumVo> getUserNum(@RequestParam(value = "storeIds") List<String> storeIds);
+
+    /**
+     * 获取用户门店列表信息
+     * @return 返回值
+     */
+    @GetMapping(value = "/userStoreList")
+    ActionResult<List<Store>> getUserStoreList();
+
+    /**
+     * 获取用户门店列表信息(值班)
+     *
+     * @return 返回值
+     */
+    @GetMapping(value = "/userStoreListDuty")
+    ActionResult<List<Store>> getUserStoreListDuty();
+
+    /**
+     * 查询用户所属的门店
+     * @param userId 用户id
+     * @return jnpf.base.ActionResult<java.util.List < jnpf.model.store.Store>>
+     */
+    @GetMapping(value = "/listByUserId/{userId}")
+    List<Store> getListByUserId(@PathVariable(value = "userId") String userId);
+
+    @GetMapping(value = "/getAllUserStores")
+    List<UserStoreListVo> getAllUserStores();
+
+    /**
+     * 根据门店ids查询门店信息
+     * @param storeIds 门店ids
+     * @return java.util.List<jnpf.model.store.Store>
+     */
+    @GetMapping(value = "/listByIds")
+    List<Store> getListByIds(@RequestParam(value = "storeIds") List<String> storeIds);
+
+    @GetMapping("/getList")
+    ActionResult<List<Store>> getList(@RequestParam("selectKey") String selectKey,
+                                      @RequestParam("organizeid") String organizeId,
+                                      @RequestParam("longitude") String longitude,
+                                      @RequestParam("latitude") String latitude);
+
+    /**
+     * 查询组织下的门店
+     * @param organizeId 组织id
+     * @return java.util.List<jnpf.model.store.Store>
+     */
+    @GetMapping(value = "/list")
+    List<Store> getStoreList(@RequestParam(value = "organizeId", required = false) String organizeId);
+
+    /**
+     * 查询组织下的门店(返回了上级组织)
+     * @param organizeId 组织id
+     * @return java.util.List<jnpf.model.store.Store>
+     */
+    @GetMapping(value = "/orgList")
+    List<Store> getOrgStoreList(@RequestParam(value = "organizeId", required = false) String organizeId, @RequestParam(value = "queryStoreIds", required = false) List<String> queryStoreIds);
+
+    /**
+     * 查询门店信息
+     * @param id 门店id
+     * @return jnpf.model.store.Store
+     */
+    @GetMapping("/info/{id}")
+    Store getStoreInfo(@PathVariable("id") String id);
+
+    /**
+     * 查询门店信息
+     * @param id 门店id
+     * @return jnpf.model.store.Store
+     */
+    @GetMapping("/getStoreInfoNoData")
+    StoreEntity getStoreInfoNoData(@RequestParam("id") String id, @RequestParam("tenantId") String tenantId);
+
+    /**
+     * 根据门店ids分页查询门店记录
+     * @param storeIds 门店ids
+     * @param currentPage 当前页码
+     * @param pageSize 每页条数
+     * @return com.github.pagehelper.PageInfo<jnpf.model.vo.StoreExecutionVo>
+     */
+    @PostMapping(value = "/store/pageByIds")
+    PageInfo<StoreExecutionVo> getStorePageByIds(@RequestBody StorePageByIdsQueryDTO query);
+
+    /**
+     * 根据门店ids分页查询门店记录
+     * @param storeIds 门店ids
+     * @param currentPage 当前页码
+     * @param pageSize 每页条数
+     * @return com.github.pagehelper.PageInfo<jnpf.model.vo.StoreExecutionVo>
+     */
+    @PostMapping(value = "/store/pageByIdsNoDataSource")
+    PageInfo<StoreExecutionVo> getStorePageByIdsNoDataSource(@RequestBody StorePageByIdsNoDsQueryDTO query);
+
+    /**
+     * 查询异常的门店
+     * @param storeIds 门店ids
+     * @return java.util.List<java.lang.String>
+     */
+    @PostMapping(value = "/store/abnormal/record")
+    List<String> getAbnormalStoreIds(@RequestBody StoreAbnormalIdsQueryDTO query);
+
+    /**
+     * 根据组织ids查询门店列表
+     * @param organizeIdList 组织ids
+     * @return java.util.List<jnpf.model.store.Store>
+     */
+    @PostMapping(value = "/store/list/byOrganizeList")
+    List<Store> getStoreListByOrganizeList(@RequestBody List<String> organizeIdList);
+
+    /**
+     * 查询门店信息(未绑定数据库)
+     * @param tenantId 租户id
+     * @param storeIds 门店ids
+     * @return java.util.List<jnpf.model.store.Store>
+     */
+    @GetMapping(value = "/store/list/noDataSource")
+    List<Store> getListByIdsNoDataSource(@RequestParam(value = "tenantId") String tenantId, @RequestParam(value = "storeIds") List<String> storeIds);
+
+    /**
+     * 校验是否是值班人
+     * @param userId 用户Id
+     */
+    @GetMapping(value = "/store/checkStoreUser")
+    boolean checkStoreUser(@RequestParam(value = "userId") String userId);
+
+    @Operation(description = "[列表] 目标组织,及其子组织所有已启用的门店")
+    @GetMapping(value = "/store/list/organizeChildren")
+    ActionResult<List<StoreBaseListVO>> getStoreListByOrganizeIdAndChildOrganize(@RequestParam(value = "organizeId") String organizeId, @RequestParam(required = false, value = "disabled") Boolean disabled);
+
+
+    /**
+     * 查询门店下岗位的成员数量
+     * @param storeId 门店id
+     * @param positionList 岗位id集合
+     * @return java.util.List<jnpf.model.store.StorePositionInfoVo>
+     */
+    @NoDataSourceBind
+    @GetMapping(value = "/storePositionInfo/list/nodata")
+    List<StorePositionInfoVo> getStorePositionInfoListNodata(@RequestParam(value = "storeId") String storeId, @RequestParam(value = "positionList") List<String> positionList, @RequestParam(value = "tenantId") String tenantId);
+
+    /**
+     * 查询用户所属的门店
+     * @param userId 用户id
+     * @return jnpf.base.ActionResult<java.util.List < jnpf.model.store.Store>>
+     */
+    @GetMapping(value = "/listByUserId/nodata/{userId}")
+    @NoDataSourceBind
+    List<Store> getListByUserIdNodata(@PathVariable(value = "userId") String userId, @RequestParam(value = "tenantId") String tenantId);
+
+    /**
+     * 获取门店位置信息
+     * @param storeId 门店id
+     * @return jnpf.model.store.vo.StoreLocationVO
+     */
+    @GetMapping(value = "/getStoreLocation")
+    StoreLocationVO getStoreLocation(@RequestParam(value = "storeId") String storeId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/doclibrary/fallback/StoreFallback.java

@@ -0,0 +1,178 @@
+package jnpf.doclibrary.fallback;
+
+import com.github.pagehelper.PageInfo;
+import jnpf.base.ActionResult;
+import jnpf.doclibrary.StoreApi;
+import jnpf.entity.StoreEntity;
+import jnpf.model.store.Store;
+import jnpf.model.store.StorePositionInfoVo;
+import jnpf.model.store.StoreUserNumVo;
+import jnpf.model.store.dto.StoreAbnormalIdsQueryDTO;
+import jnpf.model.store.dto.StorePageByIdsNoDsQueryDTO;
+import jnpf.model.store.dto.StorePageByIdsQueryDTO;
+import jnpf.model.store.vo.StoreBaseListVO;
+import jnpf.model.store.vo.StoreLocationVO;
+import jnpf.model.store.vo.UserStoreListVo;
+import jnpf.model.vo.StoreExecutionVo;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 资料库内部调用fallback
+ *
+ * @author yanwenfu
+ * @create 2023-07-12
+ */
+@Slf4j
+@Component
+public class StoreFallback implements StoreApi {
+    @Override
+    public List<StorePositionInfoVo> getStorePositionInfoList(String storeId, List<String> positionList) {
+
+        log.error("类名: StoreFallback, 方法名: getStorePositionInfoList, 错误信息: 调用失败...");
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<StoreUserNumVo> getUserNum(List<String> storeIds) {
+        log.error("类名: StoreFallback, 方法名: getUserNum, 错误信息: 调用失败...");
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<Store> getListByUserId(String userId) {
+
+        log.error("类名: StoreFallback, 方法名: getStoreListByUser, 错误信息: 调用失败...");
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<UserStoreListVo> getAllUserStores() {
+        log.error("类名: StoreFallback, 方法名: getAllUserStores, 错误信息: 调用失败...");
+        return null;
+    }
+
+    @Override
+    public List<Store> getListByIds(List<String> storeIds) {
+
+        log.error("类名: StoreFallback, 方法名: getListByIds, 错误信息: 调用失败...");
+        return new ArrayList<>();
+    }
+
+    @Override
+    public ActionResult<List<Store>> getList(String selectKey, String organizeId, String longitude, String latitude) {
+
+        log.error("类名: StoreFallback, 方法名: getList, 错误信息: 调用失败...");
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<Store>> getUserStoreList() {
+        log.error("类名: StoreFallback, 方法名: getUserStoreList, 错误信息: 调用失败...");
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<Store>> getUserStoreListDuty() {
+        return null;
+    }
+
+    @Override
+    public List<Store> getStoreList(String organizeId) {
+
+        log.error("类名: StoreFallback, 方法名: getStoreList, 错误信息: 调用失败...");
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<Store> getOrgStoreList(String organizeId, List<String> queryStoreIds) {
+        log.error("类名: StoreFallback, 方法名: getOrgStoreList, 错误信息: 调用失败...");
+        return null;
+    }
+
+
+    @Override
+    public Store getStoreInfo(String id) {
+
+        log.error("类名: StoreFallback, 方法名: getStoreInfo, 错误信息: 调用失败...");
+        return null;
+    }
+
+    /**
+     * 查询门店信息
+     *
+     * @param id       门店id
+     * @param tenantId
+     * @return jnpf.model.store.Store
+     */
+    @Override
+    public StoreEntity getStoreInfoNoData(String id, String tenantId) {
+
+        log.error("FTB_类名: StoreFallback, 方法名: getStoreInfoDutyQuery, 错误信息: 调用失败..., 当前租户号[{}] - 门店号[{}]", tenantId, id);
+        log.error(" getStoreInfoDutyQuery 没有拿到门店信息,走了fallback");
+        return null;
+    }
+
+    @Override
+    public PageInfo<StoreExecutionVo> getStorePageByIds(StorePageByIdsQueryDTO query) {
+
+        return new PageInfo<>();
+    }
+
+    @Override
+    public boolean checkStoreUser(String userId) {
+        log.error("类名: StoreFallback, 方法名: checkStoreUser, 错误信息: 调用失败...");
+        return false;
+    }
+
+    @Override
+    public ActionResult<List<StoreBaseListVO>> getStoreListByOrganizeIdAndChildOrganize(String organizeId, Boolean disabled) {
+        return null;
+    }
+
+    @Override
+    public List<StorePositionInfoVo> getStorePositionInfoListNodata(String storeId, List<String> positionList, String tenantId) {
+        return null;
+    }
+
+    @Override
+    public List<Store> getListByUserIdNodata(String userId, String tenantId) {
+        return null;
+    }
+
+    @Override
+    public StoreLocationVO getStoreLocation(String storeId) {
+        return null;
+    }
+
+    @Override
+    public PageInfo<StoreExecutionVo> getStorePageByIdsNoDataSource(StorePageByIdsNoDsQueryDTO query) {
+
+        return new PageInfo<>();
+    }
+
+    @Override
+    public List<String> getAbnormalStoreIds(StoreAbnormalIdsQueryDTO query) {
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<Store> getStoreListByOrganizeList(List<String> organizeIdList) {
+
+        return new ArrayList<>();
+    }
+
+    @Override
+    public List<Store> getListByIdsNoDataSource(String tenantId, List<String> storeIds) {
+
+        return new ArrayList<>();
+    }
+
+//    @Override
+//    public ActionResult<Store> info(String id) {
+//        return null;
+//    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/exam/V2CultivateTimingApi.java

@@ -0,0 +1,43 @@
+package jnpf.exam;
+
+import jnpf.base.ActionResult;
+import jnpf.exam.fallback.V2CultivateTimingApiFallback;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+@FeignClient(name = "jnpf-ftb", fallback = V2CultivateTimingApiFallback.class, path = "/v2/cultivate/timing")
+public interface V2CultivateTimingApi {
+
+
+    /**
+     * 培训相关每分钟执行
+     *
+     * @return 响应
+     */
+    @NoDataSourceBind
+    @GetMapping("/per-minute")
+    ActionResult<Integer> perMinute(@RequestParam("tenantId") String tenantId);
+
+    /**
+     * 每小时执行
+     *
+     * @param tenantId 租户ID
+     * @return 响应
+     */
+
+    @NoDataSourceBind
+    @GetMapping("/per-hour")
+    ActionResult<Integer> perHour(@RequestParam("tenantId") String tenantId);
+
+    /**
+     * 每半个小时执行
+     *
+     * @param tenantId 租户ID
+     * @return 响应
+     */
+    @NoDataSourceBind
+    @GetMapping("/per-half-hour")
+    ActionResult<Integer> perHalfHour(@RequestParam("tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/exam/fallback/V2CultivateTimingApiFallback.java

@@ -0,0 +1,25 @@
+package jnpf.exam.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.exam.V2CultivateTimingApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+@Component
+@Slf4j
+public class V2CultivateTimingApiFallback implements V2CultivateTimingApi {
+    @Override
+    public ActionResult<Integer> perMinute(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<Integer> perHour(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<Integer> perHalfHour(String tenantId) {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/franchisee/FranchiseeApi.java

@@ -0,0 +1,71 @@
+package jnpf.franchisee;
+
+
+import jnpf.franchisee.fallback.FranchiseeFallbackApi;
+import jnpf.model.franchisee.vo.FranchiseeIdName;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+
+import java.util.Collection;
+import java.util.List;
+
+@FeignClient(name = "jnpf-ftb", fallback = FranchiseeFallbackApi.class, path = "/web/franchise-api")
+public interface FranchiseeApi {
+
+    /**
+     * 获取所有加盟商信息
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameList")
+    List<FranchiseeIdName> getFranchiseeIdNameList();
+
+    /**
+     * 根据ID列表获取加盟商信息
+     * @param ids
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListByIds")
+    List<FranchiseeIdName> getFranchiseeIdNameListByIds(Collection<String> ids);
+
+    /**
+     * 根据ID获取加盟商信息
+     * @param id
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListById")
+    FranchiseeIdName getFranchiseeIdNameListById(String id);
+
+    /**
+     * 根据名称获取加盟商信息
+     * @param name
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListByName")
+    List<FranchiseeIdName> getFranchiseeIdNameListByName(String name);
+
+    /**
+     * 根据名称列表获取加盟商信息
+     * @param names
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListByNames")
+    List<FranchiseeIdName> getFranchiseeIdNameListByNames(Collection<String> names);
+
+
+    /**
+     * 根据编码获取加盟商信息
+     * @param code
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListByCode")
+    FranchiseeIdName getFranchiseeIdNameListByCode(String code);
+
+    /**
+     * 根据编码列表获取加盟商信息
+     * @param codes
+     * @return
+     */
+    @GetMapping("/getFranchiseeIdNameListByCodes")
+    List<FranchiseeIdName> getFranchiseeIdNameListByCodes(Collection<String> codes);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/franchisee/fallback/FranchiseeFallbackApi.java

@@ -0,0 +1,55 @@
+package jnpf.franchisee.fallback;
+
+import jnpf.franchisee.FranchiseeApi;
+import jnpf.model.franchisee.vo.FranchiseeIdName;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.Collection;
+import java.util.List;
+
+@Slf4j
+@Component
+public class FranchiseeFallbackApi implements FranchiseeApi {
+    @Override
+    public List<FranchiseeIdName> getFranchiseeIdNameList() {
+        log.error("getFranchiseeIdNameList fallback");
+        return null;
+    }
+
+    @Override
+    public List<FranchiseeIdName> getFranchiseeIdNameListByIds(Collection<String> ids) {
+        log.error("getFranchiseeIdNameListByIds fallback.ids:{}",ids);
+        return null;
+    }
+
+    @Override
+    public FranchiseeIdName getFranchiseeIdNameListById(String id) {
+        log.error("getFranchiseeIdNameListById fallback.id：{}",id);
+        return null;
+    }
+
+    @Override
+    public List<FranchiseeIdName> getFranchiseeIdNameListByName(String name) {
+        log.error("getFranchiseeIdNameListByName fallback.name：{}",name);
+        return null;
+    }
+
+    @Override
+    public List<FranchiseeIdName> getFranchiseeIdNameListByNames(Collection<String> names) {
+        log.error("getFranchiseeIdNameListByNames fallback.names：{}",names);
+        return null;
+    }
+
+    @Override
+    public FranchiseeIdName getFranchiseeIdNameListByCode(String code) {
+        log.error("getFranchiseeIdNameListByCode fallback.names：{}",code);
+        return null;
+    }
+
+    @Override
+    public List<FranchiseeIdName> getFranchiseeIdNameListByCodes(Collection<String> codes) {
+        log.error("getFranchiseeIdNameListByCodes fallback.names：{}",codes);
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/notice/FtbNoticeApi.java

@@ -0,0 +1,23 @@
+package jnpf.notice;
+
+import jnpf.base.ActionResult;
+import jnpf.notice.fallback.FtbNoticeFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbNoticeFallBackApi.class, path = "/web/noticeAnnouncements")
+public interface FtbNoticeApi {
+
+    /**
+     * 每半个小时检测一下是否有发布的通知公告
+     *
+     * @param tenantId 租户ID
+     * @return
+     */
+    @NoDataSourceBind
+    @GetMapping("/checkPublishNotice")
+    ActionResult<Boolean>  checkPublishNotice(@RequestParam("tenantId") String tenantId);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/notice/fallback/FtbNoticeFallBackApi.java

@@ -0,0 +1,18 @@
+package jnpf.notice.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.notice.FtbNoticeApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+
+@Component
+@Slf4j
+public class FtbNoticeFallBackApi implements FtbNoticeApi {
+
+
+    @Override
+    public ActionResult<Boolean> checkPublishNotice(String tenantId) {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonneApi.java

@@ -0,0 +1,72 @@
+package jnpf.personnels;
+
+import jnpf.model.attendance.vo.DailyApprovalVo;
+import jnpf.model.personnels.dto.emp.FtbEmpQueryDTO;
+import jnpf.model.personnels.dto.roster.meta.FtbPersonnlesJobTenureDTO;
+import jnpf.model.personnels.dto.secondment.FtbSecondMentQueryDTO;
+import jnpf.model.personnels.dto.staff.roster.FtbPersonnelsStaffRosterDto;
+import jnpf.model.personnels.vo.roster.FtbPersonnelsChangeInfoVO;
+import jnpf.model.personnels.vo.roster.FtbPersonnlesJobTenureVO;
+import jnpf.model.personnels.vo.secondment.FtbPersonnelsSecondmentVO;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @Author: peng.hao
+ * @create: 2025/10/3
+ */
+@FeignClient(name = "jnpf-ftb")
+public interface FtbPersonneApi {
+
+    /**
+     *根据userId 查询人事异动信息
+     */
+    @GetMapping("/web-app/staff-home-page/get-personnel-change-info")
+    FtbPersonnelsChangeInfoVO getPersonnelChangeInfo(@RequestParam(name = "userId") String userId);
+
+
+    @PostMapping("/web-app/staff-home-page/get-personnel-change-info-batch")
+    Map<String, FtbPersonnelsChangeInfoVO> getPersonnelChangeInfoBatch(@RequestBody List<String> userIds);
+    /**
+     * 根据userI 和开始时间结束时间查询借调记录
+     */
+    @GetMapping("/web/secondment/get-secondment-record")
+     List<FtbPersonnelsSecondmentVO> getSecondmentRecord(@RequestParam("userId") String userId,
+                                                               @RequestParam(value = "startLeaveTime",required = false) String startLeaveTime,
+                                                               @RequestParam(value = "endLeaveTime",required = false)String endLeaveTime);
+
+    /**
+     * 批量查询审批中和审批完成的借调记录
+     */
+    @PostMapping("/web/secondment/get-secondment-record-bath")
+    List<FtbPersonnelsSecondmentVO> getSecondmentRecordBath(@RequestBody FtbSecondMentQueryDTO dto);
+
+
+    /**
+     * 查询审批中和审批完成的借调记录
+     */
+    @PostMapping("/web/secondment/list-query-approval")
+    List<DailyApprovalVo> queryListApproval(@RequestBody FtbSecondMentQueryDTO  dto);
+
+    /**
+     * 模糊搜索 电话 名称
+     */
+    @PostMapping("/web/personnels-emp-entry/search-phone-name")
+    List<FtbPersonnelsStaffRosterDto> searchPhoneName(@RequestBody FtbEmpQueryDTO dto);
+
+    /**
+     * 查询岗龄
+     * @param req
+     * @return
+     */
+    @PostMapping("/web-app/staff-home-page/query-positionTenure-age")
+    @NoDataSourceBind
+    List<FtbPersonnlesJobTenureVO> queryPositionTenureAge(@RequestBody FtbPersonnlesJobTenureDTO req);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsContactInfoManagerApi.java

@@ -0,0 +1,38 @@
+package jnpf.personnels;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.contractinfo.ContactStatusInfo;
+import jnpf.personnels.fallback.FtbPersonnelsContaceInfoManagerFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsContaceInfoManagerFallBackApi.class, path = "/web/personnelsContactInfo")
+public interface FtbPersonnelsContactInfoManagerApi {
+
+    /**
+     * 同步合同信息
+     *
+     * @param info
+     * @return
+     */
+    @PostMapping("/syncContactInfo")
+    @NoDataSourceBind
+    ActionResult<Boolean> syncContactInfo(@RequestBody ContactStatusInfo info);
+
+    /**
+     * 定时任务检测未签署合同消息
+     *
+     * @param tenantId
+     * @return
+     */
+    @GetMapping("/checkNotSendContactSign")
+    @NoDataSourceBind
+    ActionResult<Boolean> checkNotSendContactSign(@RequestParam("tenantId") String tenantId);
+
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsEmEntryApi.java

@@ -0,0 +1,19 @@
+package jnpf.personnels;
+
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * 入职api
+ */
+@FeignClient(name = "jnpf-ftb", path = "/web/personnels-emp-entry")
+public interface FtbPersonnelsEmEntryApi {
+
+    /**
+     * 根据userId修改手机号信息
+     */
+    @PutMapping("/update-phone-by-userId")
+    void updatePhoneByUserId( @RequestParam("userId") String userId,
+                                     @RequestParam("phone") String phone);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsEmployeeTypeRemoteApi.java

@@ -0,0 +1,30 @@
+package jnpf.personnels;
+
+import jnpf.model.personnels.vo.employeetype.FtbPersonnelsEmployeeTypeVO;
+import jnpf.personnels.fallback.FtbPersonnelsEmployeeTypeRemoteFallBackApi;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 员工类型模块
+ *
+ * @author wangchunxiang
+ * @date 2025/09/30
+ */
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsEmployeeTypeRemoteFallBackApi.class, path = "/web/employee-type")
+public interface FtbPersonnelsEmployeeTypeRemoteApi {
+
+    /**
+     * 根据用户ID集合查询员工类型ID、名称
+     *
+     * @param userIds 用户ID集合
+     * @return key为用户Id，value为员工类型
+     */
+    @PostMapping("/get-employee-type-by-user-ids")
+    Map<String, FtbPersonnelsEmployeeTypeVO> getEmployeeTypeByUserIds(@RequestBody List<String> userIds);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsEmploymentApplyApi.java

@@ -0,0 +1,28 @@
+package jnpf.personnels;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.oa.FtbPersonnelsEmployInfoForOA;
+import jnpf.personnels.fallback.FtbPersonnelsEmploymentApplyFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsEmploymentApplyFallBackApi.class, path = "/web/personnels-staff-employment-apply")
+public interface FtbPersonnelsEmploymentApplyApi {
+
+    @GetMapping("/updateEmploymentApplyStatus")
+    @NoDataSourceBind
+    public ActionResult updateEmploymentApplyStatus(@RequestParam("tenantId") String tenantId);
+
+    /**
+     *  入职办理列表查询 ForOA 回显 姓名 手机
+     */
+    @GetMapping("/inquire-about-the-entry-list")
+    ActionResult<List<FtbPersonnelsEmployInfoForOA>> inquireAboutTheEntryList(@RequestParam(required = false, name = "keyWords") String keyWords,
+                                                                                     @RequestParam(required = false,name =  "phone")String phone,
+                                                                                     @RequestParam(required = false,name =  "workerName")String workerName);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsInfoConfigApi.java

@@ -0,0 +1,44 @@
+package jnpf.personnels;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.oa.FtbPersonnelsEmployInfoForOA;
+import jnpf.model.personnels.vo.range.FtbRangeConfigDIYVO;
+import jnpf.model.personnels.vo.range.FtbRangeConfigVO;
+import jnpf.personnels.fallback.FtbPersonnelsEmploymentApplyFallBackApi;
+import jnpf.personnels.fallback.FtbPersonnelsInfoConfigBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import javax.annotation.Resource;
+import java.util.List;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsInfoConfigBackApi.class, path = "/web/range-config")
+public interface FtbPersonnelsInfoConfigApi {
+
+    /**
+     * 查询是平均范围配置  还是自定义配置
+     * @param type 1 年龄 2 薪资 3 工龄
+     * @return 配置类型 1平均 2自定义
+     */
+    @GetMapping("/query-type")
+    ActionResult<Integer> queryType(@RequestParam("type") Integer type);
+
+    /**
+     * 查询平均区间配置范围
+     * @param type 1 年龄 2 薪资 3 工龄
+     */
+    @GetMapping("/query-info")
+    ActionResult<FtbRangeConfigVO> queryInfo(@RequestParam("type") Integer type);
+
+    /**
+     * 查询自定义区间配置范围
+     *
+     * @param type 1 年龄 2 薪资 3 工龄
+     */
+    @GetMapping("/query-info-diy")
+    ActionResult<List<FtbRangeConfigDIYVO>> queryDiyInfo(@RequestParam("type") Integer type);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsMetaDataManagerApi.java

@@ -0,0 +1,59 @@
+package jnpf.personnels;
+
+import jnpf.model.personnels.dto.roster.meta.PersonnelsMetaDTO;
+import jnpf.model.personnels.dto.salary.FtbXcCustomFieldDto;
+import jnpf.model.personnels.req.roster.FtbPersonnelsMetaDataReq;
+import jnpf.model.personnels.req.roster.FtbPersonnelsMetaFuctionReq;
+import jnpf.model.personnels.vo.salary.FtbXcCustomFieldVo;
+import jnpf.personnels.fallback.FtbPersonnelsMetaDataManagerFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsMetaDataManagerFallBackApi.class, path = "/web/personnels/metaData")
+public interface FtbPersonnelsMetaDataManagerApi {
+
+    @PostMapping("/getMetaData")
+    @NoDataSourceBind
+    public List<PersonnelsMetaDTO> getMetaData(@RequestBody FtbPersonnelsMetaDataReq info);
+
+    /**
+     * 查询用户当月是否已经离职
+     *
+     * @param userId   用户ID
+     * @param tenantId 租户ID
+     * @return true-已经离职  false-未离职
+     */
+    @GetMapping("/queryCurrMonthDepartStatus/{userId}/{tenantId}")
+    @NoDataSourceBind
+    public Boolean queryCurrMonthDepartStatus(@PathVariable("userId") String userId, @PathVariable("tenantId") String tenantId);
+
+
+    /**
+     * 查询用户当月是否已经离职
+     *
+     * @param req   请求
+     * @return true-已经离职  false-未离职
+     */
+    @PostMapping("/queryCurrMonthDepartStatusByDate")
+    @NoDataSourceBind
+    Boolean queryCurrMonthDepartStatusByDate(@RequestBody FtbPersonnelsMetaFuctionReq req);
+
+    /**
+     * 批量查询员工是否离职
+     */
+    @PostMapping("/query-current-month-leave")
+    @NoDataSourceBind
+    Map<String,Boolean> queryCurrMonthLeave(@RequestBody FtbPersonnelsMetaFuctionReq req);
+
+    /**
+     * 批量查询员工自定义字段
+     */
+    @PostMapping("/query-custom-filed")
+    List<FtbXcCustomFieldVo> queryCustomFiled(@RequestBody FtbXcCustomFieldDto req);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsRewardsPunishmentsApi.java

@@ -0,0 +1,50 @@
+package jnpf.personnels;
+
+import jnpf.model.personnels.dto.rewardspunishments.FtbPersonnelSalaryRewardDTO;
+import jnpf.model.personnels.dto.salary.FtbSalaryMetaDataQueryDto;
+import jnpf.model.personnels.vo.rewardspunishments.FtbPersonnelSalaryRewardVO;
+import jnpf.model.personnels.vo.rewardspunishments.FtbXcEmployeeRewardRecordsVO;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 查询指定用户，指定月份内，被奖励和处罚的合计
+ */
+@FeignClient(name = "jnpf-ftb", path = "/ftb-personnels-rewards-punishments")
+public interface FtbPersonnelsRewardsPunishmentsApi {
+
+    /**
+     * 薪酬奖励合计
+     */
+    @PostMapping(value = "/salary-reward")
+    List<FtbPersonnelSalaryRewardVO> salaryReward(@RequestBody FtbPersonnelSalaryRewardDTO ftbPersonnelSalaryRewardDTO);
+
+    /**
+     * 薪酬惩罚合计
+     */
+    @PostMapping(value = "/pay-penalty")
+    List<FtbPersonnelSalaryRewardVO> totalSalaryPenalty(@RequestBody FtbPersonnelSalaryRewardDTO ftbPersonnelSalaryRewardDTO);
+
+    /**
+     * 薪酬获取奖励和惩罚api
+     */
+    @PostMapping(value = "/salaryMetaDataQuery")
+    @NoDataSourceBind
+    BigDecimal salaryMetaDataQuery(@RequestBody FtbSalaryMetaDataQueryDto dto);
+
+    /**
+     * 薪酬获取奖励和惩罚api(批量)
+     */
+    @PostMapping(value = "/salary-meta-data-batch-query")
+    @NoDataSourceBind
+    List<FtbXcEmployeeRewardRecordsVO> salaryBatchMetaDataQuery(@RequestBody FtbSalaryMetaDataQueryDto dto);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsRewardsPunishmentsRemoteApi.java

@@ -0,0 +1,25 @@
+package jnpf.personnels;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.vo.rewardspunishments.FtbPersonnelsRewardsPunishmentApprovalVO;
+import jnpf.personnels.fallback.FtbPersonnelsRewardsPunishmentsRemoteFallBackApi;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+
+@FeignClient(name = "jnpf-ftb", path = "/ftb-personnels-rewards-punishments", fallback = FtbPersonnelsRewardsPunishmentsRemoteFallBackApi.class)
+public interface FtbPersonnelsRewardsPunishmentsRemoteApi {
+
+
+    /**
+     * OA审批获取奖惩规则
+     *
+     * @param type 类型，0奖励，1惩罚
+     * @return {@link ActionResult }
+     */
+    @GetMapping(value = "/list-approval")
+    ActionResult<List<FtbPersonnelsRewardsPunishmentApprovalVO>> listApproval(@RequestParam("type") Integer type);
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsRosterManagerApi.java

@@ -0,0 +1,147 @@
+package jnpf.personnels;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.base.ActionResult;
+import jnpf.base.vo.PageListVO;
+import jnpf.model.personnels.dto.roster.QueryCompanyAgeDto;
+import jnpf.model.personnels.dto.staff.employment.FtbPersonnelsStaffEmploymentApplyDto;
+import jnpf.model.personnels.dto.staff.roster.FtbPersonnelsStaffRosterDto;
+import jnpf.model.personnels.dto.staff.roster.ShopManagerUserDto;
+import jnpf.model.personnels.dto.staff.roster.StaffRosterInfoDto;
+import jnpf.model.personnels.req.roster.StaffRosterListReq;
+import jnpf.model.personnels.req.roster.StaffRosterReq;
+import jnpf.permission.model.user.UserListVO;
+import jnpf.permission.vo.user.UserListMatchVO;
+import jnpf.personnels.fallback.FtbPersonnelsRosterManagerFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.cloud.openfeign.SpringQueryMap;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsRosterManagerFallBackApi.class, path = "/web/personnels-staff-roster")
+public interface FtbPersonnelsRosterManagerApi {
+
+    @NoDataSourceBind
+    @GetMapping("/updateCompanyAge")
+    ActionResult updateCompanyAge(@RequestParam("tenantId") String tenantId);
+
+
+    /**
+     * 绑定手机号
+     *
+     * @param userId 用户ID
+     * @param phone  手机号
+     * @return
+     */
+    @PostMapping("/bindPhone")
+    @NoDataSourceBind
+    public ActionResult<Boolean> bindPhone(@RequestParam("tenantCode") String tenantCode, @RequestParam("userId") String userId, @RequestParam("phone") String phone);
+
+
+    @NoDataSourceBind
+    @PostMapping("/queryCompanyAge/{tenantId}")
+    ActionResult<List<QueryCompanyAgeDto>> queryCompanyAge(@RequestBody List<String> userIds, @PathVariable("tenantId") String tenantId);
+
+    /**
+     * 查询未提交入职登记表的用户
+     *
+     * @param tenantId
+     * @return
+     */
+    @NoDataSourceBind
+    @GetMapping("/queryNoSubmitForm")
+    ActionResult<List<StaffRosterInfoDto>> queryNoSubmitForm(@RequestParam("tenantId") String tenantId);
+
+
+    /**
+     * 查询健康证过期的用户
+     *
+     * @param tenantId
+     * @param days     距离健康证 快过期的天数
+     * @return
+     */
+    @NoDataSourceBind
+    @GetMapping("/queryHealthExpire")
+    ActionResult<List<StaffRosterInfoDto>> queryHealthExpire(@RequestParam("tenantId") String tenantId, @RequestParam(value = "days", required = false) Long days, @RequestParam(value = "months", required = false) Long months);
+
+
+    /**
+     * 花名册查询列表
+     *
+     * @param req
+     * @return {@link ActionResult}<{@link FtbPersonnelsStaffEmploymentApplyDto}>
+     */
+    @GetMapping("/query-list")
+    ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> pageLists(@Validated @SpringQueryMap StaffRosterListReq req);
+
+    /**
+     * 花名册查询列表 _post
+     *
+     * @param req
+     * @return {@link ActionResult}<{@link FtbPersonnelsStaffEmploymentApplyDto}>
+     */
+    @PostMapping("/query-list/postWithSalary")
+    ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> postWithSalary(@Validated @RequestBody StaffRosterListReq req);
+
+    /**
+     * 花名册查询列表不分页
+     */
+    @PostMapping("/query-list/post-with-salary-no-page")
+    List<FtbPersonnelsStaffRosterDto> postWithSalaryNoPage(@Validated @RequestBody StaffRosterListReq req);
+
+    /**
+     * 花名册列表查询-无权限
+     * @param req
+     * @return ActionResult<FtbPersonnelsStaffRosterDto>
+     */
+    @PostMapping("/query-list/byUserIds")
+    ActionResult<List<FtbPersonnelsStaffRosterDto>> getPersonnelByUserIds(@RequestBody StaffRosterListReq req);
+
+    @PostMapping("/query-list/post")
+    ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> pageListsPost(@Validated @RequestBody StaffRosterListReq req);
+
+    /**
+     * 查询离职人员信息
+     * @return
+     */
+    @PostMapping("/queryDepartUser")
+    ActionResult<List<FtbPersonnelsStaffRosterDto>> queryDepartUser(@RequestBody List<String> userIds);
+
+    @Operation(summary = "[匹配]-指定user们哪些存在,哪些不存在, 包含花名册离职的用户")
+    @PostMapping("/user/list/match/ids")
+    ActionResult<UserListMatchVO> getUserListByMatch(@RequestBody List<String> userIds);
+
+    /**
+     * 根据用户ID查询所属门店负责人信息
+     *
+     * @param tenantId
+     * @param  userIds    用户ID
+     * @return
+     */
+    @NoDataSourceBind
+    @PostMapping("/queryShopManagerUser/{tenantId}")
+    ActionResult<ShopManagerUserDto> queryShopManagerUser(@PathVariable("tenantId") String tenantId, @RequestBody List<String> userIds);
+
+    @NoDataSourceBind
+    @GetMapping("/timingAlertTrialJob/{tenantId}")
+    @Deprecated(since = "人事2.1废弃试岗状态")
+    ActionResult<List<UserListVO>> timingAlertTrialJob(@PathVariable("tenantId") String tenantId);
+
+    /**
+     * 根据用户ID查询用户信息
+     * @param req
+     * @return
+     */
+    @PostMapping("/queryWithUserIds")
+    List<FtbPersonnelsStaffRosterDto> queryWithUserIds( @RequestBody StaffRosterListReq req);
+
+    /**
+     * 查询指定userIds用户信息
+     */
+    @PostMapping("/queryWithUserIds/post")
+    List<FtbPersonnelsStaffRosterDto> queryWithUserIdsPost(@RequestBody StaffRosterReq req);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/FtbPersonnelsTurnoverManagementApi.java

@@ -0,0 +1,52 @@
+package jnpf.personnels;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.turnover.FtbDepUserDTO;
+import jnpf.model.personnels.vo.turnover.FtbPersonnelsTurnoverManagementVO;
+import jnpf.permission.vo.v2.user.UserBoundVO;
+import jnpf.personnels.fallback.FtbPersonnelsTurnoverManagementFallBackApi;
+import jnpf.util.NoDataSourceBind;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.List;
+
+/**
+ * @Title: FtbPersonnelsTurnoverManagementApi
+ * @Author: peng.hao
+ * @create: 2024/2/19 10:36
+ */
+@FeignClient(name = "jnpf-ftb", fallback = FtbPersonnelsTurnoverManagementFallBackApi.class, path = "/web/personnels-turnover")
+public interface FtbPersonnelsTurnoverManagementApi {
+
+    @GetMapping("/closeUserAccountRegularlyAfterResignation")
+    @NoDataSourceBind
+    ActionResult<String> closeUserAccountRegularlyAfterResignation(@RequestParam("tenantId") String tenantId);
+
+    /**
+     * 离职用户已签署离职协议
+     * @param userId 用户id
+     * @return
+     */
+    @GetMapping("/user-has-sign-an-agreement")
+    Boolean userHasSignedASeparationAgreement(@RequestParam("userId") String userId,@RequestParam("flag") Integer flag);
+
+    /**
+     * 获取所有离职人员信息
+     */
+    @GetMapping("/query-turnover-list")
+    List<FtbPersonnelsTurnoverManagementVO> queryTurnoverList();
+    /**
+     * 获取离职人员信息
+     * 1.按多个userId
+     * 2.按多个组织id
+     * 3.按多个岗位id
+     */
+    @PostMapping("/get-dep-user")
+    List<UserBoundVO> getInformationAboutTheDepartingPerson(@RequestBody FtbDepUserDTO dto);
+    @PostMapping("/not-token-get-dep-user")
+    List<UserBoundVO> getInformationAboutTheDepartingPersonNotToken(@RequestBody FtbDepUserDTO dto);
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsContaceInfoManagerFallBackApi.java

@@ -0,0 +1,24 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.contractinfo.ContactStatusInfo;
+import jnpf.personnels.FtbPersonnelsContactInfoManagerApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+
+@Component
+@Slf4j
+public class FtbPersonnelsContaceInfoManagerFallBackApi implements FtbPersonnelsContactInfoManagerApi {
+
+
+    @Override
+    public ActionResult<Boolean> syncContactInfo(ContactStatusInfo info) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<Boolean> checkNotSendContactSign(String tenantId) {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsEmployeeTypeRemoteFallBackApi.java

@@ -0,0 +1,18 @@
+package jnpf.personnels.fallback;
+
+import jnpf.model.personnels.vo.employeetype.FtbPersonnelsEmployeeTypeVO;
+import jnpf.personnels.FtbPersonnelsEmployeeTypeRemoteApi;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+import java.util.Map;
+
+@Component
+public class FtbPersonnelsEmployeeTypeRemoteFallBackApi implements FtbPersonnelsEmployeeTypeRemoteApi {
+
+    @Override
+    public Map<String, FtbPersonnelsEmployeeTypeVO> getEmployeeTypeByUserIds(List<String> userIds) {
+        return null;
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsEmploymentApplyFallBackApi.java

@@ -0,0 +1,26 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.oa.FtbPersonnelsEmployInfoForOA;
+import jnpf.personnels.FtbPersonnelsEmploymentApplyApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+
+@Component
+@Slf4j
+public class FtbPersonnelsEmploymentApplyFallBackApi implements FtbPersonnelsEmploymentApplyApi {
+
+
+    @Override
+    public ActionResult updateEmploymentApplyStatus(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<FtbPersonnelsEmployInfoForOA>> inquireAboutTheEntryList(String keyWords, String phone, String workerName) {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsInfoConfigBackApi.java

@@ -0,0 +1,29 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.vo.range.FtbRangeConfigDIYVO;
+import jnpf.model.personnels.vo.range.FtbRangeConfigVO;
+import jnpf.personnels.FtbPersonnelsInfoConfigApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Component
+@Slf4j
+public class FtbPersonnelsInfoConfigBackApi implements FtbPersonnelsInfoConfigApi {
+    @Override
+    public ActionResult<Integer> queryType(Integer type) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<FtbRangeConfigVO> queryInfo(Integer type) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<FtbRangeConfigDIYVO>> queryDiyInfo(Integer type) {
+        return null;
+    }
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsMetaDataManagerFallBackApi.java

@@ -0,0 +1,47 @@
+package jnpf.personnels.fallback;
+
+import jnpf.model.personnels.dto.roster.meta.PersonnelsMetaDTO;
+import jnpf.model.personnels.dto.salary.FtbXcCustomFieldDto;
+import jnpf.model.personnels.req.roster.FtbPersonnelsMetaDataReq;
+import jnpf.model.personnels.req.roster.FtbPersonnelsMetaFuctionReq;
+import jnpf.model.personnels.vo.salary.FtbXcCustomFieldVo;
+import jnpf.personnels.FtbPersonnelsMetaDataManagerApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+
+@Component
+@Slf4j
+public class FtbPersonnelsMetaDataManagerFallBackApi implements FtbPersonnelsMetaDataManagerApi {
+
+
+    @Override
+    public List<PersonnelsMetaDTO> getMetaData(FtbPersonnelsMetaDataReq info) {
+        return null;
+    }
+
+    @Override
+    public Boolean queryCurrMonthDepartStatus(String userId, String tenantId) {
+        return null;
+    }
+
+    @Override
+    public Boolean queryCurrMonthDepartStatusByDate(FtbPersonnelsMetaFuctionReq req) {
+        return null;
+    }
+
+    @Override
+    public Map<String, Boolean> queryCurrMonthLeave(FtbPersonnelsMetaFuctionReq req) {
+        return Map.of();
+    }
+
+    @Override
+    public List<FtbXcCustomFieldVo> queryCustomFiled(FtbXcCustomFieldDto req) {
+        return List.of();
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsRewardsPunishmentsRemoteFallBackApi.java

@@ -0,0 +1,18 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.vo.rewardspunishments.FtbPersonnelsRewardsPunishmentApprovalVO;
+import jnpf.personnels.FtbPersonnelsRewardsPunishmentsRemoteApi;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Component
+public class FtbPersonnelsRewardsPunishmentsRemoteFallBackApi implements FtbPersonnelsRewardsPunishmentsRemoteApi {
+
+    @Override
+    public ActionResult<List<FtbPersonnelsRewardsPunishmentApprovalVO>> listApproval(Integer type) {
+        return ActionResult.fail("OA审批获取奖惩规则降级处理");
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsRosterManagerFallBackApi.java

@@ -0,0 +1,107 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.base.vo.PageListVO;
+import jnpf.model.personnels.dto.roster.QueryCompanyAgeDto;
+import jnpf.model.personnels.dto.staff.roster.FtbPersonnelsStaffRosterDto;
+import jnpf.model.personnels.dto.staff.roster.ShopManagerUserDto;
+import jnpf.model.personnels.dto.staff.roster.StaffRosterInfoDto;
+import jnpf.model.personnels.req.roster.StaffRosterListReq;
+import jnpf.model.personnels.req.roster.StaffRosterReq;
+import jnpf.permission.model.user.UserListVO;
+import jnpf.permission.vo.user.UserListMatchVO;
+import jnpf.personnels.FtbPersonnelsRosterManagerApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import java.util.List;
+
+
+@Component
+@Slf4j
+public class FtbPersonnelsRosterManagerFallBackApi implements FtbPersonnelsRosterManagerApi {
+
+
+    @Override
+    public ActionResult updateCompanyAge(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<Boolean> bindPhone(String tenantCode, String userId, String phone) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<QueryCompanyAgeDto>> queryCompanyAge(List<String> userIds, String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<StaffRosterInfoDto>> queryNoSubmitForm(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<StaffRosterInfoDto>> queryHealthExpire(String tenantId, Long days, Long months) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> pageLists(StaffRosterListReq req) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> pageListsPost(StaffRosterListReq req) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<PageListVO<FtbPersonnelsStaffRosterDto>> postWithSalary(StaffRosterListReq req) {
+        return null;
+    }
+
+    @Override
+    public List<FtbPersonnelsStaffRosterDto> postWithSalaryNoPage(StaffRosterListReq req) {
+        return List.of();
+    }
+
+    @Override
+    public ActionResult<List<FtbPersonnelsStaffRosterDto>> getPersonnelByUserIds(StaffRosterListReq req) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<UserListMatchVO> getUserListByMatch(List<String> userIds) {
+        return null;
+    }
+
+
+    @Override
+    public ActionResult<List<FtbPersonnelsStaffRosterDto>> queryDepartUser(@RequestBody List<String> userIds) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<ShopManagerUserDto> queryShopManagerUser(String tenantId, List<String> userIds) {
+        return null;
+    }
+
+    @Override
+    public ActionResult<List<UserListVO>> timingAlertTrialJob(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public List<FtbPersonnelsStaffRosterDto> queryWithUserIds(StaffRosterListReq req) {
+        return null;
+    }
+
+    @Override
+    public List<FtbPersonnelsStaffRosterDto> queryWithUserIdsPost(StaffRosterReq req) {
+        return null;
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/personnels/fallback/FtbPersonnelsTurnoverManagementFallBackApi.java

@@ -0,0 +1,47 @@
+package jnpf.personnels.fallback;
+
+import jnpf.base.ActionResult;
+import jnpf.model.personnels.dto.turnover.FtbDepUserDTO;
+import jnpf.model.personnels.vo.turnover.FtbPersonnelsTurnoverManagementVO;
+import jnpf.permission.vo.v2.user.UserBoundVO;
+import jnpf.personnels.FtbPersonnelsTurnoverManagementApi;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+/**
+ * @Title: FtbPersonnelsTurnoverManagementFallBackApi
+ * @Author: peng.hao
+ * @create: 2024/2/19 10:38
+ */
+@Slf4j
+@Component
+public class FtbPersonnelsTurnoverManagementFallBackApi  implements FtbPersonnelsTurnoverManagementApi {
+
+    @Override
+    public ActionResult<String> closeUserAccountRegularlyAfterResignation(String tenantId) {
+        return null;
+    }
+
+    @Override
+    public Boolean userHasSignedASeparationAgreement(String userId, Integer flag) {
+        return null;
+    }
+
+    @Override
+    public List<FtbPersonnelsTurnoverManagementVO> queryTurnoverList() {
+        return null;
+    }
+
+    @Override
+    public List<UserBoundVO> getInformationAboutTheDepartingPerson(FtbDepUserDTO dto) {
+        return null;
+    }
+
+    @Override
+    public List<UserBoundVO> getInformationAboutTheDepartingPersonNotToken(FtbDepUserDTO dto) {
+        return List.of();
+    }
+
+}

jnpf-ftb/jnpf-ftb-api/src/main/java/jnpf/util/auth/V2AuthPermissionApi.java

@@ -0,0 +1,22 @@
+package jnpf.util.auth;
+
+import io.swagger.v3.oas.annotations.Operation;
+import jnpf.util.auth.fallback.V2AuthPermissionApiFallback;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+
+import java.util.List;
+
+/**
+ * 登录人数据权限-组织范围 API（与 FTB 内 {@code V2AuthPermissionUtils#getLoginUserAuthOrganizeIds()} 语义一致）。
+ * <p>
+ * 返回值约定：{@code null} 表示全部；空列表表示无权限；非空为组织/门店 id 列表（已排除班组）。
+ * Feign 降级时抛出异常，不会返回空列表以免误判为无权限（当前暂无正式熔断占位策略）。
+ */
+@FeignClient(name = "jnpf-ftb", contextId = "v2AuthPermissionApi", path = "/permission/auth", fallbackFactory = V2AuthPermissionApiFallback.class)
+public interface V2AuthPermissionApi {
+
+    @Operation(summary = "[API] 当前登录人在权限范围内的组织/门店 id 列表（未包裹 ActionResult）")
+    @GetMapping("/login-user-organize-ids")
+    List<String> getLoginUserAuthOrganizeIds();
+}