From e7592821169a7f965dfa1c8019fc5c869df40122 Mon Sep 17 00:00:00 2001 From: Samir Boulahtit Date: Sat, 18 Apr 2026 18:09:24 +0200 Subject: [PATCH] refactor: rename apps/ to clients/ + update architecture docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rename apps/ → clients/ for clarity: - app/ (singular) = Python backend (FastAPI, server-rendered web UI) - clients/ (plural) = standalone client applications (API consumers) The web storefront/store/admin stays in app/ because it's server- rendered Jinja2, not a standalone frontend. clients/ is for native apps that connect to the API externally. Updated: - docs/architecture/overview.md — added clients/ to project structure - clients/terminal-android/SETUP.md — updated path references Co-Authored-By: Claude Opus 4.6 (1M context) --- {apps => clients}/terminal-android/.gitignore | 0 {apps => clients}/terminal-android/SETUP.md | 4 ++-- {apps => clients}/terminal-android/app/build.gradle.kts | 0 {apps => clients}/terminal-android/app/proguard-rules.pro | 0 .../terminal-android/app/src/main/AndroidManifest.xml | 0 .../app/src/main/java/lu/rewardflow/terminal/MainActivity.kt | 0 .../src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt | 0 .../main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt | 0 .../main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt | 0 .../rewardflow/terminal/data/db/dao/PendingTransactionDao.kt | 0 .../rewardflow/terminal/data/db/entity/PendingTransaction.kt | 0 .../main/java/lu/rewardflow/terminal/data/model/ApiModels.kt | 0 .../app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt | 0 .../main/java/lu/rewardflow/terminal/di/DataStoreModule.kt | 0 .../main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt | 0 .../src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt | 0 .../main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt | 0 .../java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt | 0 .../lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt | 0 .../src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt | 0 .../terminal-android/app/src/main/res/values/strings.xml | 0 .../terminal-android/app/src/main/res/values/themes.xml | 0 {apps => clients}/terminal-android/build.gradle.kts | 0 {apps => clients}/terminal-android/gradle.properties | 0 {apps => clients}/terminal-android/gradle/libs.versions.toml | 0 .../gradle/wrapper/gradle-wrapper.properties | 0 {apps => clients}/terminal-android/settings.gradle.kts | 0 docs/architecture/overview.md | 5 +++++ 28 files changed, 7 insertions(+), 2 deletions(-) rename {apps => clients}/terminal-android/.gitignore (100%) rename {apps => clients}/terminal-android/SETUP.md (97%) rename {apps => clients}/terminal-android/app/build.gradle.kts (100%) rename {apps => clients}/terminal-android/app/proguard-rules.pro (100%) rename {apps => clients}/terminal-android/app/src/main/AndroidManifest.xml (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/MainActivity.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/dao/PendingTransactionDao.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/entity/PendingTransaction.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/model/ApiModels.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/DataStoreModule.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt (100%) rename {apps => clients}/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt (100%) rename {apps => clients}/terminal-android/app/src/main/res/values/strings.xml (100%) rename {apps => clients}/terminal-android/app/src/main/res/values/themes.xml (100%) rename {apps => clients}/terminal-android/build.gradle.kts (100%) rename {apps => clients}/terminal-android/gradle.properties (100%) rename {apps => clients}/terminal-android/gradle/libs.versions.toml (100%) rename {apps => clients}/terminal-android/gradle/wrapper/gradle-wrapper.properties (100%) rename {apps => clients}/terminal-android/settings.gradle.kts (100%) diff --git a/apps/terminal-android/.gitignore b/clients/terminal-android/.gitignore similarity index 100% rename from apps/terminal-android/.gitignore rename to clients/terminal-android/.gitignore diff --git a/apps/terminal-android/SETUP.md b/clients/terminal-android/SETUP.md similarity index 97% rename from apps/terminal-android/SETUP.md rename to clients/terminal-android/SETUP.md index 114657be..541c663f 100644 --- a/apps/terminal-android/SETUP.md +++ b/clients/terminal-android/SETUP.md @@ -32,7 +32,7 @@ Android Studio bundles: ### 3. Open the project -1. `File → Open` → navigate to `apps/terminal-android/` +1. `File → Open` → navigate to `clients/terminal-android/` 2. Wait for Gradle sync (first time downloads ~500MB of dependencies) 3. If prompted about Gradle JDK, select the bundled JDK 17 @@ -52,7 +52,7 @@ Android Studio bundles: ## Project structure ``` -apps/terminal-android/ +clients/terminal-android/ ├── app/ │ ├── build.gradle.kts # App dependencies (like requirements.txt) │ ├── src/main/ diff --git a/apps/terminal-android/app/build.gradle.kts b/clients/terminal-android/app/build.gradle.kts similarity index 100% rename from apps/terminal-android/app/build.gradle.kts rename to clients/terminal-android/app/build.gradle.kts diff --git a/apps/terminal-android/app/proguard-rules.pro b/clients/terminal-android/app/proguard-rules.pro similarity index 100% rename from apps/terminal-android/app/proguard-rules.pro rename to clients/terminal-android/app/proguard-rules.pro diff --git a/apps/terminal-android/app/src/main/AndroidManifest.xml b/clients/terminal-android/app/src/main/AndroidManifest.xml similarity index 100% rename from apps/terminal-android/app/src/main/AndroidManifest.xml rename to clients/terminal-android/app/src/main/AndroidManifest.xml diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/MainActivity.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/MainActivity.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/MainActivity.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/MainActivity.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/RewardFlowApp.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/api/LoyaltyApi.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/AppDatabase.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/dao/PendingTransactionDao.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/dao/PendingTransactionDao.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/dao/PendingTransactionDao.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/dao/PendingTransactionDao.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/entity/PendingTransaction.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/entity/PendingTransaction.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/entity/PendingTransaction.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/db/entity/PendingTransaction.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/model/ApiModels.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/model/ApiModels.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/model/ApiModels.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/data/model/ApiModels.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/AppModule.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/DataStoreModule.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/DataStoreModule.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/DataStoreModule.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/di/DataStoreModule.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/RewardFlowNavHost.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/pin/PinScreen.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupScreen.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/setup/SetupViewModel.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/terminal/TerminalScreen.kt diff --git a/apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt b/clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt similarity index 100% rename from apps/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt rename to clients/terminal-android/app/src/main/java/lu/rewardflow/terminal/ui/theme/Theme.kt diff --git a/apps/terminal-android/app/src/main/res/values/strings.xml b/clients/terminal-android/app/src/main/res/values/strings.xml similarity index 100% rename from apps/terminal-android/app/src/main/res/values/strings.xml rename to clients/terminal-android/app/src/main/res/values/strings.xml diff --git a/apps/terminal-android/app/src/main/res/values/themes.xml b/clients/terminal-android/app/src/main/res/values/themes.xml similarity index 100% rename from apps/terminal-android/app/src/main/res/values/themes.xml rename to clients/terminal-android/app/src/main/res/values/themes.xml diff --git a/apps/terminal-android/build.gradle.kts b/clients/terminal-android/build.gradle.kts similarity index 100% rename from apps/terminal-android/build.gradle.kts rename to clients/terminal-android/build.gradle.kts diff --git a/apps/terminal-android/gradle.properties b/clients/terminal-android/gradle.properties similarity index 100% rename from apps/terminal-android/gradle.properties rename to clients/terminal-android/gradle.properties diff --git a/apps/terminal-android/gradle/libs.versions.toml b/clients/terminal-android/gradle/libs.versions.toml similarity index 100% rename from apps/terminal-android/gradle/libs.versions.toml rename to clients/terminal-android/gradle/libs.versions.toml diff --git a/apps/terminal-android/gradle/wrapper/gradle-wrapper.properties b/clients/terminal-android/gradle/wrapper/gradle-wrapper.properties similarity index 100% rename from apps/terminal-android/gradle/wrapper/gradle-wrapper.properties rename to clients/terminal-android/gradle/wrapper/gradle-wrapper.properties diff --git a/apps/terminal-android/settings.gradle.kts b/clients/terminal-android/settings.gradle.kts similarity index 100% rename from apps/terminal-android/settings.gradle.kts rename to clients/terminal-android/settings.gradle.kts diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md index 627288f4..df7a6d3c 100644 --- a/docs/architecture/overview.md +++ b/docs/architecture/overview.md @@ -322,6 +322,11 @@ project/ │ ├── unit/ │ └── integration/ │ +├── clients/ # Standalone client applications (API consumers) +│ └── terminal-android/ # Native Android POS terminal (Kotlin/Compose) +│ +├── scripts/ # Seed scripts, deploy scripts +│ └── docs/ # Documentation ├── architecture/ # System architecture ├── frontend/ # Frontend guides