|
|
@@ -0,0 +1,319 @@
|
|
|
+# 文件命名规范重构方案
|
|
|
+
|
|
|
+## 命名规范(最终版)
|
|
|
+
|
|
|
+- **base-core 层接口**:`IShareService` → `IShare`、`IPushService` → `IPush`(去掉 Service,保持 I 前缀)
|
|
|
+- **capability 层接口**(能力暴露给外部):`ShareService` → `IShare`、`PushService` → `IPush`、`BLEService` → `IBLE`、`NFCService` → `INFC`、`SocketIOService` → `ISocketIO`
|
|
|
+- **实现类**:`*ServiceImpl` → `*Impl`(例如 `ShareServiceImpl` → `ShareImpl`)
|
|
|
+- **能力入口 / Kit**:`ShareServiceFactory` → `ShareKit`、`PushServiceFactory` → `PushKit`、`BLEServiceFactory` → `BLEKit`、`SocketIOServiceFactory` → `SocketIOKit`(统一用 `*Kit` 做对外入口)
|
|
|
+- **回调实现**:`*CallbackImpl` → `*Callback`(去掉 Impl,例如 `ShareCallbackImpl` → `ShareCallback`)
|
|
|
+
|
|
|
+## 完整文件树形结构图
|
|
|
+
|
|
|
+```
|
|
|
+xdz_android/
|
|
|
+├── app/src/main/java/com/narutohuo/xindazhou/
|
|
|
+│ ├── auth/
|
|
|
+│ │ ├── AuthManager.kt ✅ 保持
|
|
|
+│ │ ├── datasource/
|
|
|
+│ │ │ ├── local/
|
|
|
+│ │ │ │ ├── AuthLocalDataSource.kt ✅ 保持
|
|
|
+│ │ │ │ └── AuthLocalDataSourceImpl.kt ✅ 保持
|
|
|
+│ │ │ └── remote/
|
|
|
+│ │ │ ├── AuthApi.kt ✅ 保持
|
|
|
+│ │ │ └── AuthRemoteDataSource.kt ✅ 保持
|
|
|
+│ │ ├── model/
|
|
|
+│ │ │ ├── LoginRequest.kt ✅ 保持
|
|
|
+│ │ │ ├── LoginResponse.kt ✅ 保持
|
|
|
+│ │ │ └── RegisterRequest.kt ✅ 保持
|
|
|
+│ │ ├── repository/
|
|
|
+│ │ │ └── AuthRepository.kt ✅ 保持
|
|
|
+│ │ ├── storage/
|
|
|
+│ │ │ └── TokenStore.kt ✅ 保持
|
|
|
+│ │ └── ui/
|
|
|
+│ │ ├── login/
|
|
|
+│ │ │ └── LoginActivity.kt ✅ 保持
|
|
|
+│ │ ├── register/
|
|
|
+│ │ │ └── RegisterActivity.kt ✅ 保持
|
|
|
+│ │ └── viewmodel/
|
|
|
+│ │ ├── LoginState.kt ✅ 保持
|
|
|
+│ │ ├── LoginViewModel.kt ✅ 保持
|
|
|
+│ │ ├── LoginViewModelFactory.kt ✅ 保持
|
|
|
+│ │ ├── RegisterState.kt ✅ 保持
|
|
|
+│ │ ├── RegisterViewModel.kt ✅ 保持
|
|
|
+│ │ └── RegisterViewModelFactory.kt ✅ 保持
|
|
|
+│ ├── community/ ✅ 保持
|
|
|
+│ ├── launch/
|
|
|
+│ │ └── AppInitializer.kt ✅ 保持
|
|
|
+│ ├── MainActivity.kt ✅ 保持
|
|
|
+│ ├── MainFragment.kt ✅ 保持
|
|
|
+│ ├── service/ ✅ 保持
|
|
|
+│ ├── shop/ ✅ 保持
|
|
|
+│ ├── user/
|
|
|
+│ │ └── ui/
|
|
|
+│ │ ├── UserActivity.kt ✅ 保持
|
|
|
+│ │ └── viewmodel/
|
|
|
+│ │ ├── UserViewModel.kt ✅ 保持
|
|
|
+│ │ └── UserViewModelFactory.kt ✅ 保持
|
|
|
+│ ├── vehicle/ ✅ 保持
|
|
|
+│ └── XinDaZhouApplication.kt ✅ 保持
|
|
|
+│
|
|
|
+├── base-common/src/main/java/com/narutohuo/xindazhou/common/
|
|
|
+│ ├── config/
|
|
|
+│ │ ├── ConfigManager.kt ✅ 保持
|
|
|
+│ │ └── ServerConfigManager.kt ✅ 保持
|
|
|
+│ ├── crash/
|
|
|
+│ │ └── CrashHelper.kt ✅ 保持
|
|
|
+│ ├── dialog/
|
|
|
+│ │ ├── CascadePickerDialog.kt ✅ 保持
|
|
|
+│ │ ├── DialogHelper.kt ✅ 保持
|
|
|
+│ │ └── ServerConfigDialog.kt ✅ 保持
|
|
|
+│ ├── executor/
|
|
|
+│ │ └── ExecutorManager.kt ✅ 保持
|
|
|
+│ ├── image/
|
|
|
+│ │ └── ImageLoadHelper.kt ✅ 保持
|
|
|
+│ ├── launch/
|
|
|
+│ │ ├── AppLaunchManager.kt ✅ 保持
|
|
|
+│ │ ├── model/
|
|
|
+│ │ │ └── OnboardingItem.kt ✅ 保持
|
|
|
+│ │ ├── NavigationCallback.kt ✅ 保持
|
|
|
+│ │ ├── OnboardingManager.kt ✅ 保持
|
|
|
+│ │ └── ui/
|
|
|
+│ │ └── OnboardingFragment.kt ✅ 保持
|
|
|
+│ ├── network/
|
|
|
+│ │ ├── adapter/
|
|
|
+│ │ │ └── ApiResponseCallAdapterFactory.kt ✅ 保持
|
|
|
+│ │ ├── ApiBaseRemoteDataSource.kt ✅ 保持
|
|
|
+│ │ ├── ApiBaseRepository.kt ✅ 保持
|
|
|
+│ │ ├── ApiManager.kt ✅ 保持
|
|
|
+│ │ ├── ApiResponseParser.kt ✅ 保持
|
|
|
+│ │ ├── exception/
|
|
|
+│ │ │ ├── ApiException.kt ✅ 保持
|
|
|
+│ │ │ └── ExceptionHandle.kt ✅ 保持
|
|
|
+│ │ ├── interceptor/
|
|
|
+│ │ │ ├── HeaderInterceptor.kt ✅ 保持
|
|
|
+│ │ │ └── TokenRefreshInterceptor.kt ✅ 保持
|
|
|
+│ │ ├── NetworkManager.kt ✅ 保持
|
|
|
+│ │ ├── operator/
|
|
|
+│ │ │ ├── ApiResponseOperator.kt ✅ 保持
|
|
|
+│ │ │ ├── GlobalApiOperator.kt ✅ 保持
|
|
|
+│ │ │ └── RetryOperator.kt ✅ 保持
|
|
|
+│ │ ├── response/
|
|
|
+│ │ │ ├── ApiResponse.kt ✅ 保持
|
|
|
+│ │ │ └── ApiResponseExtensions.kt ✅ 保持
|
|
|
+│ │ └── SANDWICH_COMPARISON_CORRECTED.md ✅ 保持
|
|
|
+│ ├── networkrx/
|
|
|
+│ │ ├── ApiDisposableObserver.kt ✅ 保持
|
|
|
+│ │ ├── cookie/
|
|
|
+│ │ │ ├── CookieJarImpl.kt ✅ 保持
|
|
|
+│ │ │ ├── CookieStore.kt ✅ 保持
|
|
|
+│ │ │ ├── MemoryCookieStore.kt ✅ 保持
|
|
|
+│ │ │ └── SPCookieStore.kt ✅ 保持
|
|
|
+│ │ ├── download/
|
|
|
+│ │ │ └── DownloadManager.kt ✅ 保持
|
|
|
+│ │ ├── interceptor/
|
|
|
+│ │ │ ├── HeaderInterceptor.kt ✅ 保持
|
|
|
+│ │ │ └── TokenRefreshInterceptor.kt ✅ 保持
|
|
|
+│ │ ├── NetworkManager.kt ✅ 保持
|
|
|
+│ │ ├── NetworkUtil.kt ✅ 保持
|
|
|
+│ │ ├── ResponseThrowable.kt ✅ 保持
|
|
|
+│ │ ├── RxApiResponse.kt ✅ 保持
|
|
|
+│ │ ├── RxApiResponseTransformer.kt ✅ 保持
|
|
|
+│ │ └── RxExceptionHandler.kt ✅ 保持
|
|
|
+│ ├── router/
|
|
|
+│ │ └── RouterHelper.kt ✅ 保持
|
|
|
+│ ├── storage/
|
|
|
+│ │ └── StorageManager.kt ✅ 保持
|
|
|
+│ ├── ui/
|
|
|
+│ │ ├── ActivityExtensions.kt ✅ 保持
|
|
|
+│ │ ├── ActivityManager.kt ✅ 保持
|
|
|
+│ │ ├── BaseActivity.kt ✅ 保持
|
|
|
+│ │ ├── BaseFragment.kt ✅ 保持
|
|
|
+│ │ ├── BaseViewModel.kt ✅ 保持
|
|
|
+│ │ ├── FragmentExtensions.kt ✅ 保持
|
|
|
+│ │ ├── MessageHelper.kt ✅ 保持
|
|
|
+│ │ ├── StatusBarHelper.kt ✅ 保持
|
|
|
+│ │ └── UI层封装方案.md ✅ 保持
|
|
|
+│ └── version/
|
|
|
+│ ├── datasource/
|
|
|
+│ │ └── remote/
|
|
|
+│ │ ├── VersionApi.kt ✅ 保持
|
|
|
+│ │ └── VersionRemoteDataSource.kt ✅ 保持
|
|
|
+│ ├── model/
|
|
|
+│ │ └── VersionResponse.kt ✅ 保持
|
|
|
+│ ├── repository/
|
|
|
+│ │ └── VersionRepository.kt ✅ 保持
|
|
|
+│ ├── ui/
|
|
|
+│ │ └── UpdateDialogFragment.kt ✅ 保持
|
|
|
+│ └── VersionUpdateManager.kt ✅ 保持
|
|
|
+│
|
|
|
+├── base-core/src/main/java/com/narutohuo/xindazhou/core/
|
|
|
+│ ├── log/
|
|
|
+│ │ ├── FloatingLogButton.kt ✅ 保持
|
|
|
+│ │ ├── ILog.kt ✅ 保持
|
|
|
+│ │ └── impl/
|
|
|
+│ │ ├── LogcatViewerLog.kt ✅ 保持
|
|
|
+│ │ └── NoOpLog.kt ✅ 保持
|
|
|
+│ ├── network/
|
|
|
+│ │ └── interceptor/ ✅ 保持
|
|
|
+│ ├── permission/
|
|
|
+│ │ └── PermissionHelper.kt ✅ 保持
|
|
|
+│ ├── share/
|
|
|
+│ │ ├── IShareCallback.kt ✅ 保持
|
|
|
+│ │ └── IShareService.kt ⚠️ → IShare.kt
|
|
|
+│ ├── push/
|
|
|
+│ │ └── IPushService.kt ⚠️ → IPush.kt
|
|
|
+│ ├── storage/
|
|
|
+│ │ ├── IStorage.kt ✅ 保持
|
|
|
+│ │ └── StorageImpl.kt ⚠️ → StorageKit.kt
|
|
|
+│ └── util/
|
|
|
+│ └── IUtil.kt ✅ 保持
|
|
|
+│
|
|
|
+├── capability-share/src/main/java/com/narutohuo/xindazhou/share/
|
|
|
+│ ├── api/
|
|
|
+│ │ └── ShareService.kt ⚠️ → IShare.kt
|
|
|
+│ ├── impl/
|
|
|
+│ │ └── ShareServiceImpl.kt ⚠️ → ShareImpl.kt
|
|
|
+│ ├── factory/
|
|
|
+│ │ └── ShareServiceFactory.kt ⚠️ → ShareKit.kt
|
|
|
+│ ├── callback/
|
|
|
+│ │ └── ShareCallbackImpl.kt ⚠️ → ShareCallback.kt
|
|
|
+│ ├── model/
|
|
|
+│ │ ├── ShareConfig.kt ✅ 保持
|
|
|
+│ │ └── ShareResponse.kt ✅ 保持
|
|
|
+│ └── ui/
|
|
|
+│ ├── ShareDialogFragment.kt ✅ 保持
|
|
|
+│ └── ShareProxyActivity.kt ✅ 保持
|
|
|
+│
|
|
|
+├── capability-ble/src/main/java/com/narutohuo/xindazhou/ble/
|
|
|
+│ ├── api/
|
|
|
+│ │ └── BLEService.kt ⚠️ → IBLE.kt
|
|
|
+│ ├── impl/
|
|
|
+│ │ └── BLEServiceImpl.kt ⚠️ → BLEImpl.kt
|
|
|
+│ ├── factory/
|
|
|
+│ │ └── BLEServiceFactory.kt ⚠️ → BLEKit.kt
|
|
|
+│ ├── callback/
|
|
|
+│ │ └── BLECallback.kt ✅ 保持
|
|
|
+│ ├── config/
|
|
|
+│ │ └── BLEConstants.kt ✅ 保持
|
|
|
+│ ├── model/
|
|
|
+│ │ ├── BLECommand.kt ✅ 保持
|
|
|
+│ │ ├── BLEDevice.kt ✅ 保持
|
|
|
+│ │ ├── BLEEncryptedData.kt ✅ 保持
|
|
|
+│ │ ├── BLEResponse.kt ✅ 保持
|
|
|
+│ │ ├── Command.kt ✅ 保持
|
|
|
+│ │ ├── FragmentBuffer.kt ✅ 保持
|
|
|
+│ │ └── Packet.kt ✅ 保持
|
|
|
+│ └── util/
|
|
|
+│ ├── BleConnector.kt ✅ 保持
|
|
|
+│ ├── BLECrypto.kt ✅ 保持
|
|
|
+│ ├── BLEExtension.kt ✅ 保持
|
|
|
+│ ├── BLEPacketBuilder.kt ✅ 保持
|
|
|
+│ ├── BLEPacketParser.kt ✅ 保持
|
|
|
+│ ├── BlePacketSender.kt ✅ 保持
|
|
|
+│ ├── BLEPacketSplitter.kt ✅ 保持
|
|
|
+│ └── BleScanner.kt ✅ 保持
|
|
|
+│
|
|
|
+├── capability-push/src/main/java/com/narutohuo/xindazhou/push/
|
|
|
+│ ├── api/
|
|
|
+│ │ └── PushService.kt ⚠️ → IPush.kt
|
|
|
+│ ├── impl/
|
|
|
+│ │ └── PushServiceImpl.kt ⚠️ → PushImpl.kt
|
|
|
+│ ├── factory/
|
|
|
+│ │ └── PushServiceFactory.kt ⚠️ → PushKit.kt
|
|
|
+│ ├── helper/
|
|
|
+│ │ └── TagAliasOperatorHelper.kt ✅ 保持
|
|
|
+│ ├── model/
|
|
|
+│ │ └── PushResponse.kt ✅ 保持
|
|
|
+│ ├── receiver/
|
|
|
+│ │ ├── BootReceiver.kt ✅ 保持
|
|
|
+│ │ └── JPushReceiver.kt ✅ 保持
|
|
|
+│ ├── server/
|
|
|
+│ │ ├── PushMessageService.kt ⚠️ → PushMessageKit.kt
|
|
|
+│ │ └── UserService.kt ⚠️ → UserKit.kt
|
|
|
+│ ├── service/
|
|
|
+│ │ └── UserService.java ✅ 保持
|
|
|
+│ └── startup/
|
|
|
+│ └── PushInitializer.kt ✅ 保持
|
|
|
+│
|
|
|
+├── capability-qrcode/src/main/java/com/narutohuo/xindazhou/qrcode/
|
|
|
+│ ├── api/
|
|
|
+│ │ └── QRCodeManager.kt ✅ 保持
|
|
|
+│ ├── impl/
|
|
|
+│ │ └── QRCodeManagerImpl.kt ⚠️ → QRCodeImpl.kt(可选)
|
|
|
+│ ├── factory/
|
|
|
+│ │ └── QRCodeManagerFactory.kt ✅ 保持
|
|
|
+│ ├── model/
|
|
|
+│ │ └── QRCodeResponse.kt ✅ 保持
|
|
|
+│ └── ui/
|
|
|
+│ ├── QRCodeScanActivity.kt ✅ 保持
|
|
|
+│ └── QRCodeScanFragment.kt ✅ 保持
|
|
|
+│
|
|
|
+├── capability-socketio/src/main/java/com/narutohuo/xindazhou/socketio/
|
|
|
+│ ├── api/
|
|
|
+│ │ └── SocketIOService.kt ⚠️ → ISocketIO.kt
|
|
|
+│ ├── impl/
|
|
|
+│ │ └── SocketIOServiceImpl.kt ⚠️ → SocketIOImpl.kt
|
|
|
+│ ├── factory/
|
|
|
+│ │ ├── SocketIORepositoryFactory.kt ✅ 保持
|
|
|
+│ │ └── SocketIOServiceFactory.kt ⚠️ → SocketIOKit.kt
|
|
|
+│ ├── manager/
|
|
|
+│ │ └── SocketIOManager.kt ✅ 保持
|
|
|
+│ ├── repository/
|
|
|
+│ │ └── SocketIORepository.kt ✅ 保持
|
|
|
+│ ├── model/
|
|
|
+│ │ ├── SocketIOEvent.kt ✅ 保持
|
|
|
+│ │ └── SocketIOResponse.kt ✅ 保持
|
|
|
+│ └── SocketIOManager.kt ✅ 保持
|
|
|
+│
|
|
|
+└── capability-nfc/src/main/java/com/narutohuo/xindazhou/nfc/
|
|
|
+ ├── api/
|
|
|
+ │ └── NFCService.kt ⚠️ → INFC.kt
|
|
|
+ ├── impl/
|
|
|
+ │ └── NFCServiceImpl.kt ⚠️ → NFCImpl.kt
|
|
|
+ └── model/
|
|
|
+ └── NFCResponse.kt ✅ 保持
|
|
|
+```
|
|
|
+
|
|
|
+## 改名清单
|
|
|
+
|
|
|
+### base-core
|
|
|
+- `core/share/IShareService.kt` → `core/share/IShare.kt`
|
|
|
+- `core/push/IPushService.kt` → `core/push/IPush.kt`
|
|
|
+- `core/storage/StorageImpl.kt` → `core/storage/StorageKit.kt`
|
|
|
+
|
|
|
+### capability-share
|
|
|
+- `share/api/ShareService.kt` → `share/api/IShare.kt`
|
|
|
+- `share/impl/ShareServiceImpl.kt` → `share/impl/ShareImpl.kt`
|
|
|
+- `share/factory/ShareServiceFactory.kt` → `share/ShareKit.kt`(或 `share/factory/ShareKit.kt`)
|
|
|
+- `share/callback/ShareCallbackImpl.kt` → `share/callback/ShareCallback.kt`
|
|
|
+
|
|
|
+### capability-ble
|
|
|
+- `ble/api/BLEService.kt` → `ble/api/IBLE.kt`
|
|
|
+- `ble/impl/BLEServiceImpl.kt` → `ble/impl/BLEImpl.kt`
|
|
|
+- `ble/factory/BLEServiceFactory.kt` → `ble/BLEKit.kt`(或 `ble/factory/BLEKit.kt`)
|
|
|
+
|
|
|
+### capability-push
|
|
|
+- `push/api/PushService.kt` → `push/api/IPush.kt`
|
|
|
+- `push/impl/PushServiceImpl.kt` → `push/impl/PushImpl.kt`
|
|
|
+- `push/factory/PushServiceFactory.kt` → `push/PushKit.kt`(或 `push/factory/PushKit.kt`)
|
|
|
+- `push/server/PushMessageService.kt` → `push/server/PushMessageKit.kt`
|
|
|
+- `push/server/UserService.kt` → `push/server/UserKit.kt`
|
|
|
+
|
|
|
+### capability-qrcode
|
|
|
+- `qrcode/api/QRCodeManager.kt` → `qrcode/api/QRCodeManager.kt`(保持)
|
|
|
+- `qrcode/impl/QRCodeManagerImpl.kt` → `qrcode/impl/QRCodeImpl.kt`(可选)
|
|
|
+- `qrcode/factory/QRCodeManagerFactory.kt` → `qrcode/factory/QRCodeManagerFactory.kt`(保持)
|
|
|
+
|
|
|
+### capability-socketio
|
|
|
+- `socketio/api/SocketIOService.kt` → `socketio/api/ISocketIO.kt`
|
|
|
+- `socketio/impl/SocketIOServiceImpl.kt` → `socketio/impl/SocketIOImpl.kt`
|
|
|
+- `socketio/factory/SocketIOServiceFactory.kt` → `socketio/SocketIOKit.kt`(或 `socketio/factory/SocketIOKit.kt`)
|
|
|
+
|
|
|
+### capability-nfc
|
|
|
+- `nfc/api/NFCService.kt` → `nfc/api/INFC.kt`
|
|
|
+- `nfc/impl/NFCServiceImpl.kt` → `nfc/impl/NFCImpl.kt`
|
|
|
+
|
|
|
+## 总计
|
|
|
+
|
|
|
+**22 个文件需要改名**
|