Files
pnoker 372d75b0c9 refactor(core): rename find/query/fetch methods to get per crud law
sweep every module to satisfy the new method-name rule, renaming
about 40 methods together with their interface, implementation, test
and cli call sites: store find() lookups become get(), analytics
queryLatest/queryHistory become getLatest/getHistory, sql helper
query() becomes spec()/sql(), jwks fetch() becomes load(), and the
cursor record component queryDigest becomes requestDigest

no behavior changes; full unit suite (5278 tests) and both quality
gates stay green
2026-09-18 09:53:51 +08:00
..

DC3 Common Auth

Overview

dc3-common-auth is the shared authentication business module of the IoT DC3 platform. It contains all controllers, service implementations, gRPC servers, mappers, and DAL classes that implement the authentication center's functionality. It is wired directly into dc3-center-auth.

Module Information

  • Group ID: io.github.pnoker
  • Artifact ID: dc3-common-auth

Key Components

Layer Contents
Controllers REST controllers for user, tenant, token, dictionary endpoints
Services TokenService, UserService, TenantService, DictionaryForAuthService
gRPC Servers Spring @Service beans extending generated *ImplBase server classes
DAL MyBatis-Plus mappers and DAL managers for auth tables
Init AuthInitRunner for startup checks

gRPC Services Exposed

Service Purpose
TokenApi Validate login and token material for gateway authentication
TenantApi Resolve tenant metadata by code
UserApi Resolve users by ID or principal ID
LocalCredentialApi Resolve local credentials by login name
PermissionApi List effective permission codes
ResourceRegistryApi Synchronize discovered API and menu resources
McpRuntimeApi Introspect, authorize, resolve, and audit MCP tool calls

Distributed callers use the corresponding facade interfaces; they should not construct gRPC channels in business code.

Build Instructions

mvn -s .mvn/settings.xml -pl dc3-common/dc3-common-auth -am package

Testing

Run the module tests from the repository root:

mvn -s .mvn/settings.xml -pl dc3-common/dc3-common-auth -am test
  • dc3-center-auth — Bootstraps this module as a Spring Boot service
  • dc3-api-auth — gRPC contract implemented by this module
  • dc3-common-model — Entity, BO, VO, DTO definitions