Sync installer hardening and test infrastructure

Author: minitheguitarist

.gitignore

@@ -11,6 +11,12 @@
 .svn/
 .swiftpm/
 migrate_working_dir/
+__pycache__/
+.agents
+.agents/
+.codex
+.codex/
+.git.broken-*/
 
 # IntelliJ related
 *.iml
@@ -27,7 +33,6 @@ migrate_working_dir/
 **/doc/api/
 **/ios/Flutter/.last_build_id
 .dart_tool/
-.flutter-sdk/
 .flutter-plugins-dependencies
 .pub-cache/
 .pub/
@@ -47,9 +52,16 @@ app.*.map.json
 
 # Local VM test artifacts
 /outputs/
+/iso-realese/
+/rpm-outputs/
+*.iso
+*.rpm
+*.src.rpm
 /*.qcow2
 /*.fd
-/*.iso
-/linux/__pycache__/
-/tool/__pycache__/
-/dist/
+
+# Local hardware/debug captures
+/gerçeksistemdenloglar/*.txt
+
+# Generated design prototype exports kept locally for reference
+/stitch_velvet_nebula_installer_redesign/

.metadata

@@ -0,0 +1,45 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "ff37bef603469fb030f2b72995ab929ccfc227f0"
+  channel: "stable"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: android
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: ios
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: linux
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: macos
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: web
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+    - platform: windows
+      create_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+      base_revision: ff37bef603469fb030f2b72995ab929ccfc227f0
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

COPR.md

@@ -1,75 +1,127 @@
 # COPR Guide
 
-This repository is prepared for COPR builds with the `SCM` source type and the
-`make srpm` workflow.
+This repository is prepared for COPR builds using the **SCM source type** and
+the **make srpm** SRPM generation method.
 
-## Build Method
+## Why `make srpm` instead of `rpkg`?
 
-Use `make srpm` for this project.
+Use `make srpm` for this repository.
 
-Why:
+Reason:
 
-1. This is the upstream application repository, not a DistGit-style packaging repository.
-2. The provided `.copr/Makefile` creates the source archive directly from the checked-out tree.
-3. The workflow stays explicit, reproducible, and compatible with GitHub-triggered COPR builds.
+1. This is an upstream application repository, not a dedicated DistGit-style
+   `rpkg` repository.
+2. COPR documents that `rpkg` is the default SCM method, but it also notes
+   that modern `rpkg` workflows expect rpkg-util v3 templating conventions.
+3. `make srpm` lets us generate the exact source archive from the checked out
+   tree and then call `rpmbuild -bs` ourselves.
+4. That keeps the packaging logic simple and explicit for GitHub webhook builds.
 
-Files used by COPR:
+Relevant official COPR documentation:
+
+- SCM source type and SRPM build methods:
+  https://docs.pagure.org/copr.copr/user_documentation.html
+- Local package building with `rpkg`:
+  https://docs.pagure.org/copr.copr/building_package.html
+
+## Files Used by COPR
 
 - `ro-installer.spec`
 - `.copr/Makefile`
 - `LICENSE`
 
-Command executed by COPR:
+The Makefile target that COPR runs is:
 
 ```bash
 make -f .copr/Makefile srpm outdir="<outdir>" spec="ro-installer.spec"
 ```
 
-## COPR Package Settings
+That target:
+
+1. reads `Name` and `Version` from the spec file
+2. creates `ro-installer-<version>.tar.gz` from the checked out source tree
+3. runs `rpmbuild -bs`
+4. places the resulting `.src.rpm` into `outdir`
+
+Important:
+
+- COPR runs `make srpm` in a minimal source chroot
+- do not assume tools like `git` are available there
+- the provided `.copr/Makefile` therefore uses `cp` and `tar`, not `git archive`
+
+## How to Configure COPR
+
+Create or edit the package in COPR with these settings:
+
+1. **Source Type**: `SCM`
+2. **SCM Type**: `git`
+3. **Clone URL**:
+   `https://github.com/Project-Ro-ASD/ro-Installer.git`
+4. **Committish**:
+   `main`
+5. **Subdirectory**:
+   leave empty
+6. **Spec File**:
+   `ro-installer.spec`
+7. **SRPM Build Method**:
+   `make srpm`
+8. **Auto-rebuild**:
+   enable it
 
-Configure the package with these values:
+## GitHub Webhook Setup
 
-1. `Source Type`: `SCM`
-2. `SCM Type`: `git`
-3. `Clone URL`: `https://github.com/Project-Ro-ASD/ro-Installer.git`
-4. `Committish`: `main`
-5. `Subdirectory`: leave empty
-6. `Spec File`: `ro-installer.spec`
-7. `SRPM Build Method`: `make srpm`
-8. `Auto-rebuild`: enabled
+Once the SCM package exists in COPR:
 
-## GitHub Webhook
+1. Open the COPR project
+2. Go to **Settings** -> **Integrations**
+3. Copy the GitHub webhook URL
+4. In GitHub open:
+   `Settings -> Webhooks -> Add webhook`
+5. Paste the COPR webhook URL as **Payload URL**
+6. Set **Content type** to `application/json`
+7. Enable push events
+8. Save
 
-After creating the SCM package in COPR:
+Official COPR GitHub webhook documentation:
 
-1. Open the COPR project.
-2. Go to `Settings -> Integrations`.
-3. Copy the GitHub webhook URL.
-4. In GitHub open `Settings -> Webhooks -> Add webhook`.
-5. Paste the COPR URL into `Payload URL`.
-6. Set content type to `application/json`.
-7. Enable push events and save.
+- https://docs.pagure.org/copr.copr/user_documentation.html
 
-## Local SRPM Test
+## Local Test Workflow
+
+If you want to test the SRPM generation locally:
 
 ```bash
 mkdir -p dist
 make -f .copr/Makefile srpm outdir="$PWD/dist" spec="ro-installer.spec"
 ```
 
-Expected output for the current release:
+That should produce:
 
-- `dist/ro-installer-3.0.0.tar.gz`
-- `dist/ro-installer-3.0.0-1*.src.rpm`
+- `dist/ro-installer-1.2.7.tar.gz`
+- `dist/ro-installer-1.2.7-1*.src.rpm`
 
-Optional local rebuild with `mock`:
+If `mock` is available, rebuild the SRPM locally:
 
 ```bash
 mock -r fedora-rawhide-x86_64 --rebuild dist/*.src.rpm
 ```
 
-## Note About Flutter
+## Important Dependency Note
+
+The spec currently uses:
+
+```spec
+BuildRequires: flutter
+```
+
+This means the selected COPR chroot must have an RPM package providing the
+Flutter SDK. If your target chroot does not provide `flutter`, the build will
+fail before compilation starts.
+
+In that case you need one of these:
+
+1. an additional repository enabled in COPR that provides `flutter`
+2. a dedicated COPR package for `flutter`
 
-The RPM build expects a Fedora-compatible environment with the required build
-dependencies available to the spec. Keep the build declarative and avoid adding
-ad-hoc downloads outside the packaging workflow.
+Do not rely on downloading Flutter from the Internet during `%build`; keep the
+build declarative and reproducible.