feat: add subdirectory structure to keystore-init project layout

- Create push_notifications, build, and assets folders during init
- Place firebase-service-account.json stub in push_notifications/
- Place google-play-service-account.json stub in build/
- Add keystoreFileSubdirectory mapping to keystore_constants.dart
- Document keystore-init command and generated folder structure in README

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SERDUN

README.md

@@ -25,6 +25,41 @@ dart pub global activate --source=path <path_to_package>
 
 ## Usage
 
+### Keystore Project Initialization
+
+Initialize a full keystore project directory for a given application. Fetches application metadata
+from the Configurator API and generates the required folder structure, signing keys, deep link
+metadata, and template credential files.
+
+```sh
+$ webtrit_phone_tools keystore-init --applicationId=<id> --token=<jwt> [directory]
+```
+
+The command creates the following structure under `<directory>/applications/<applicationId>/`:
+
+```
+<applicationId>/
+├── assets/                              # Application assets (logos, icons, etc.)
+├── build/
+│   └── google-play-service-account.json # Google Play service account for CI publishing
+├── deep_links/
+│   └── .well-known/
+│       ├── apple-app-site-association.json
+│       └── assetlinks.json
+├── push_notifications/
+│   └── firebase-service-account.json    # Firebase service account for push notifications
+├── ssl_certificates/                    # SSL certificates for the application
+├── AuthKey_[key_id].p8                  # iOS APNs auth key
+├── Certificates.p12                     # iOS distribution certificate
+├── Provision.mobileprovision            # iOS provisioning profile
+├── upload-keystore.jks                  # Android upload keystore (JKS)
+├── upload-keystore.p12                  # Android upload keystore (P12)
+├── upload-keystore-metadata.json        # Android keystore metadata
+└── upload-store-connect-metadata.json   # App Store Connect credentials
+```
+
+Files that require manual completion are created with an `.incomplete` suffix.
+
 ### Android Keystore Signing
 
 Tools for managing signing keys and certificates.

lib/src/commands/keystore_generate/models/keystore_constants.dart

@@ -13,6 +13,12 @@ const keystoreFiles = [
   androidUploadKeystoreP12,
 ];
 
+// Subdirectory mapping for keystore files (null means root)
+const keystoreFileSubdirectory = {
+  firebaseServiceAccount: 'push_notifications',
+  androidPlayServiceAccount: 'build',
+};
+
 // Firebase
 const firebaseServiceAccount = 'firebase-service-account.json';
 

lib/src/commands/keystore_init/processors/keystore_project_processor.dart

@@ -21,6 +21,15 @@ class KeystoreProjectProcessor {
 
     logger.info('Creating ssl certificates directory: $keystoreProjectPath');
     Directory(path.join(keystoreProjectPath, 'ssl_certificates')).createSync(recursive: true);
+
+    logger.info('Creating push notifications directory: $keystoreProjectPath');
+    Directory(path.join(keystoreProjectPath, 'push_notifications')).createSync(recursive: true);
+
+    logger.info('Creating build directory: $keystoreProjectPath');
+    Directory(path.join(keystoreProjectPath, 'build')).createSync(recursive: true);
+
+    logger.info('Creating assets directory: $keystoreProjectPath');
+    Directory(path.join(keystoreProjectPath, 'assets')).createSync(recursive: true);
   }
 
   void writeIosCredentialsTemplate({
@@ -44,7 +53,10 @@ class KeystoreProjectProcessor {
   }) {
     for (final fileName in keystoreFiles) {
       if (!existingKeystoreFiles.contains(fileName)) {
-        final filePath = path.join(keystoreProjectPath, '$fileName.incomplete');
+        final subdirectory = keystoreFileSubdirectory[fileName];
+        final filePath = subdirectory != null
+            ? path.join(keystoreProjectPath, subdirectory, '$fileName.incomplete')
+            : path.join(keystoreProjectPath, '$fileName.incomplete');
         logger.info('Creating empty file: $filePath');
         File(filePath).createSync();
       }