# hamdiamine/client-ann architecture

> Architecture diagram of the GitHub repository hamdiamine/client-ann, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hamdiamine/client-ann
- Repository: https://github.com/hamdiamine/client-ann

## Overview

SolutionAnnonces is a Cordova mobile classifieds application. Its apparent user workflow covers account access, browsing and searching listings, viewing details, and creating an offer or request; app controllers and factories indicate these stages, but no README or app-source excerpts document their wiring. The tree also shows device capabilities for photos, location, contacts, files, and sharing. Dashed, uncited app links represent likely workflow relationships, not verified calls; solid links are supported by the provided source index or excerpts.

Main entry points: [`SolutionAnnonces/SolutionAnnonces/www/scripts/app.js`](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/app.js) (App Bootstrap), [`SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java) (Android File API), [`SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/NvlAnnonceCtrl.js`](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/NvlAnnonceCtrl.js) (Publish Listing), [`SolutionAnnonces/SolutionAnnonces/www/scripts/factory/AnnonceFctr.js`](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/AnnonceFctr.js) (Listing Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Classifieds App"]
  node_app["App Bootstrap<br/>[app.js]"]
  node_account["Account Access"]
  node_browse["Browse Listings<br/>[ListOffreCtrl.js]"]
  node_search["Search Listings"]
  node_detail["Listing Details"]
  node_publish["Publish Listing<br/>[NvlAnnonceCtrl.js]"]
  node_favorites["Saved Listings"]
  node_map["Listing Map<br/>[MapAnnoncesCtrl.js]"]
end

subgraph group_data["App Data"]
  node_annonce_data["Listing Data<br/>[AnnonceFctr.js]"]
  node_search_data["Search Data<br/>[RechercheFctr.js]"]
  node_account_data["Account Data<br/>[CompteFctr.js]"]
  node_photo_data["Photo Data<br/>[PhotoFctr.js]"]
end

subgraph group_device["Device Capabilities"]
  node_camera["Camera Capture<br/>[Camera.js]"]
  node_geolocation["Geolocation<br/>[geolocation.js]"]
  node_contacts["Contacts Access<br/>[contacts.js]"]
  node_file_api["File API<br/>[FileReader.js]"]
  node_transfer["File Transfer<br/>[FileTransfer.js]"]
  node_sharing["Social Sharing<br/>[SocialSharing.js]"]
  node_network["Network Status<br/>[network.js]"]
end

subgraph group_native["Native Adapters"]
  node_camera_android["Android Camera"]
  node_camera_helpers["Image Helpers<br/>[FileHelper.java]"]
  node_contacts_android["Android Contacts"]
  node_contact_accessor["Contact Accessor"]
  node_file_android["Android File API<br/>[FileUtils.java]"]
  node_filesystem["Filesystem Types<br/>[Filesystem.java]"]
  node_local_filesystem["Local Filesystem"]
  node_content_filesystem["Content Filesystem"]
  node_asset_filesystem["Asset Filesystem"]
  node_transfer_android["Android Transfer<br/>[FileTransfer.java]"]
end

node_user(("Mobile User"))

node_user -.->|"uses"| node_app
node_app -.->|"routes to"| node_account
node_app -.->|"routes to"| node_browse
node_app -.->|"routes to"| node_search
node_app -.->|"routes to"| node_detail
node_app -.->|"routes to"| node_publish
node_app -.->|"routes to"| node_favorites
node_app -.->|"routes to"| node_map
node_browse -.->|"uses"| node_annonce_data
node_detail -.->|"uses"| node_annonce_data
node_publish -.->|"uses"| node_annonce_data
node_search -.->|"uses"| node_search_data
node_account -.->|"uses"| node_account_data
node_publish -.->|"uses"| node_photo_data
node_publish -.->|"captures"| node_camera
node_map -.->|"uses location"| node_geolocation
node_camera_android -->|"uses"| node_camera_helpers
node_contacts_android -->|"delegates to"| node_contact_accessor
node_file_android -->|"uses"| node_filesystem
node_file_android -->|"uses"| node_local_filesystem
node_file_android -->|"uses"| node_content_filesystem
node_file_android -->|"uses"| node_asset_filesystem
node_transfer_android -->|"uses"| node_file_android
node_file_api -.->|"uses"| node_filesystem

click node_app "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/app.js"
click node_account "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/AuthentificationCtrl.js"
click node_browse "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListOffreCtrl.js"
click node_search "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListRechercheCtrl.js"
click node_detail "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/DetailAnnonceCtrl.js"
click node_publish "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/NvlAnnonceCtrl.js"
click node_favorites "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListAnnoncesFavCtrl.js"
click node_map "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/MapAnnoncesCtrl.js"
click node_annonce_data "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/AnnonceFctr.js"
click node_search_data "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/RechercheFctr.js"
click node_account_data "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/CompteFctr.js"
click node_photo_data "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/PhotoFctr.js"
click node_camera "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/www/Camera.js"
click node_geolocation "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-geolocation/www/geolocation.js"
click node_contacts "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/www/contacts.js"
click node_file_api "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/www/FileReader.js"
click node_transfer "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/www/FileTransfer.js"
click node_sharing "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-x-socialsharing/www/SocialSharing.js"
click node_camera_android "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/CameraLauncher.java"
click node_camera_helpers "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/FileHelper.java"
click node_contacts_android "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactManager.java"
click node_contact_accessor "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactAccessor.java"
click node_file_android "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java"
click node_filesystem "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/Filesystem.java"
click node_local_filesystem "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/LocalFilesystem.java"
click node_content_filesystem "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/ContentFilesystem.java"
click node_asset_filesystem "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/AssetFilesystem.java"
click node_transfer_android "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/src/android/FileTransfer.java"
click node_network "https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-network-information/www/network.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_account,node_browse,node_search,node_detail,node_publish,node_favorites,node_map,node_user toneBlue
class node_annonce_data,node_search_data,node_account_data,node_photo_data toneAmber
class node_camera,node_geolocation,node_contacts,node_file_api,node_transfer,node_sharing,node_network toneMint
class node_camera_android,node_camera_helpers,node_contacts_android,node_contact_accessor,node_file_android,node_filesystem,node_local_filesystem,node_content_filesystem,node_asset_filesystem,node_transfer_android toneRose
```

## Components

### Classifieds App

- [App Bootstrap](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/app.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/app.js`
- [Account Access](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/AuthentificationCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/AuthentificationCtrl.js`
- [Browse Listings](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListOffreCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListOffreCtrl.js`
- [Search Listings](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListRechercheCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListRechercheCtrl.js`
- [Listing Details](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/DetailAnnonceCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/DetailAnnonceCtrl.js`
- [Publish Listing](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/NvlAnnonceCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/NvlAnnonceCtrl.js`
- [Saved Listings](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListAnnoncesFavCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/ListAnnoncesFavCtrl.js`
- [Listing Map](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/MapAnnoncesCtrl.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/controllers/MapAnnoncesCtrl.js`

### App Data

- [Listing Data](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/AnnonceFctr.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/factory/AnnonceFctr.js`
- [Search Data](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/RechercheFctr.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/factory/RechercheFctr.js`
- [Account Data](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/CompteFctr.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/factory/CompteFctr.js`
- [Photo Data](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/www/scripts/factory/PhotoFctr.js): `SolutionAnnonces/SolutionAnnonces/www/scripts/factory/PhotoFctr.js`

### Device Capabilities

- [Camera Capture](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/www/Camera.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/www/Camera.js`
- [Geolocation](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-geolocation/www/geolocation.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-geolocation/www/geolocation.js`
- [Contacts Access](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/www/contacts.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/www/contacts.js`
- [File API](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/www/FileReader.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/www/FileReader.js`
- [File Transfer](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/www/FileTransfer.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/www/FileTransfer.js`
- [Social Sharing](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-x-socialsharing/www/SocialSharing.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-x-socialsharing/www/SocialSharing.js`
- [Network Status](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-network-information/www/network.js): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-network-information/www/network.js`

### Native Adapters

- [Android Camera](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/CameraLauncher.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/CameraLauncher.java`
- [Image Helpers](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/FileHelper.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/FileHelper.java`
- [Android Contacts](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactManager.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactManager.java`
- [Contact Accessor](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactAccessor.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactAccessor.java`
- [Android File API](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`
- [Filesystem Types](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/Filesystem.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/Filesystem.java`
- [Local Filesystem](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/LocalFilesystem.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/LocalFilesystem.java`
- [Content Filesystem](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/ContentFilesystem.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/ContentFilesystem.java`
- [Asset Filesystem](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/AssetFilesystem.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/AssetFilesystem.java`
- [Android Transfer](https://github.com/hamdiamine/client-ann/blob/master/SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/src/android/FileTransfer.java): `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/src/android/FileTransfer.java`

### Other components

- **Mobile User**

## Connections

- Mobile User → App Bootstrap: uses
- App Bootstrap → Account Access: routes to
- App Bootstrap → Browse Listings: routes to
- App Bootstrap → Search Listings: routes to
- App Bootstrap → Listing Details: routes to
- App Bootstrap → Publish Listing: routes to
- App Bootstrap → Saved Listings: routes to
- App Bootstrap → Listing Map: routes to
- Browse Listings → Listing Data: uses
- Listing Details → Listing Data: uses
- Publish Listing → Listing Data: uses
- Search Listings → Search Data: uses
- Account Access → Account Data: uses
- Publish Listing → Photo Data: uses
- Publish Listing → Camera Capture: captures
- Listing Map → Geolocation: uses location
- Android Camera → Image Helpers: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-camera/src/android/CameraLauncher.java`)
- Android Contacts → Contact Accessor: delegates to (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-contacts/src/android/ContactManager.java`)
- Android File API → Filesystem Types: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`)
- Android File API → Local Filesystem: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`)
- Android File API → Content Filesystem: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`)
- Android File API → Asset Filesystem: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file/src/android/FileUtils.java`)
- Android Transfer → Android File API: uses (evidence: `SolutionAnnonces/SolutionAnnonces/plugins/cordova-plugin-file-transfer/src/android/FileTransfer.java`)
- File API → Filesystem Types: uses
