# covivo/mobicoop architecture

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

- Interactive diagram: https://gitdiagram.com/covivo/mobicoop
- Repository: https://github.com/covivo/mobicoop

## Overview

Mobicoop Platform is a shared-mobility product with an API and desktop web client. A representative user journey starts in the carpool client, which calls API carpool functionality; the API also supports communities, user accounts, communications, payments, solidarity transport, articles, and public-transport information. Sampled source confirms selected client/API references and carpool-manager behavior; many other capabilities are represented from the README and tree, but their internal wiring was not sampled.

Main entry points: [`api/src/Carpool/Service/ResultManager.php`](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/ResultManager.php) (Search results), [`api/src/Carpool/Service/AdManager.php`](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/AdManager.php) (Carpool API), [`api/src/User/Service/ReviewManager.php`](https://github.com/covivo/mobicoop/blob/dev/api/src/User/Service/ReviewManager.php) (User reviews), [`client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php`](https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php) (Carpool screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_carpool_ui["Carpool screens"]
  node_community_ui["Community screens"]
  node_community_client["Community client service"]
end

subgraph group_carpool["Carpooling"]
  node_carpool_api["Carpool API<br/>[AdManager.php]"]
  node_proposal[("Proposals<br/>[Proposal.php]")]
  node_criteria["Journey criteria<br/>[Criteria.php]"]
  node_asks[("Carpool requests<br/>[Ask.php]")]
  node_matching["Search results<br/>[ResultManager.php]"]
  node_proposal_store[("Proposal repository")]
end

subgraph group_community["Communities"]
  node_community_api["Community API"]
  node_community_data[("Community records<br/>[Community.php]")]
end

subgraph group_people["Users and communication"]
  node_user_api["User accounts<br/>[UserManager.php]"]
  node_users[("User profiles<br/>[User.php]")]
  node_reviews["User reviews<br/>[ReviewManager.php]"]
  node_review_store[("Review repository")]
  node_notifications["Notifications"]
end

subgraph group_services["Other services"]
  node_payments["Payments<br/>[PaymentManager.php]"]
  node_solidary["Solidarity transport"]
  node_solidary_admin["Solidarity admin"]
  node_articles["Articles<br/>[ArticleManager.php]"]
  node_public_transport["Public transport"]
  node_address[("Geographic addresses<br/>[Address.php]")]
  node_data_provider["External API client<br/>[DataProvider.php]"]
end

node_traveler(("Traveler"))
node_review_actor(("Reviewer"))

node_traveler -->|"uses"| node_carpool_ui
node_carpool_ui -->|"requests ads"| node_carpool_api
node_carpool_api -->|"reads proposals"| node_proposal
node_carpool_api -->|"checks proofs"| node_asks
node_matching -->|"uses"| node_criteria
node_matching -->|"uses"| node_proposal
node_matching -->|"uses"| node_asks
node_matching -->|"queries"| node_proposal_store
node_traveler -->|"uses"| node_community_ui
node_community_ui -->|"manages communities"| node_community_api
node_community_client -->|"uses"| node_community_data
node_review_actor -->|"submits review"| node_reviews
node_reviews -->|"queries reviews"| node_review_store
node_reviews -->|"builds reviewer data"| node_users
node_traveler -->|"uses"| node_payments
node_traveler -->|"uses"| node_solidary
node_traveler -->|"reads"| node_articles
node_traveler -->|"checks transit"| node_public_transport

click node_carpool_ui "https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php"
click node_community_ui "https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Community/Controller/CommunityController.php"
click node_carpool_api "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/AdManager.php"
click node_proposal "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Proposal.php"
click node_criteria "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Criteria.php"
click node_asks "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Ask.php"
click node_matching "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/ResultManager.php"
click node_proposal_store "https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Repository/ProposalRepository.php"
click node_community_client "https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Community/Service/CommunityManager.php"
click node_community_api "https://github.com/covivo/mobicoop/blob/dev/api/src/Community/Service/CommunityManager.php"
click node_community_data "https://github.com/covivo/mobicoop/blob/dev/api/src/Community/Entity/Community.php"
click node_user_api "https://github.com/covivo/mobicoop/blob/dev/api/src/User/Service/UserManager.php"
click node_users "https://github.com/covivo/mobicoop/blob/dev/api/src/User/Entity/User.php"
click node_reviews "https://github.com/covivo/mobicoop/blob/dev/api/src/User/Service/ReviewManager.php"
click node_review_store "https://github.com/covivo/mobicoop/blob/dev/api/src/User/Repository/ReviewRepository.php"
click node_notifications "https://github.com/covivo/mobicoop/blob/dev/api/src/Communication/Service/NotificationManager.php"
click node_payments "https://github.com/covivo/mobicoop/blob/dev/api/src/Payment/Service/PaymentManager.php"
click node_solidary "https://github.com/covivo/mobicoop/blob/dev/api/src/Solidary/Service/SolidaryManager.php"
click node_solidary_admin "https://github.com/covivo/mobicoop/blob/dev/api/src/Solidary/Admin/Service/SolidaryManager.php"
click node_articles "https://github.com/covivo/mobicoop/blob/dev/api/src/Article/Service/ArticleManager.php"
click node_public_transport "https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/PublicTransport/Service/PublicTransportManager.php"
click node_address "https://github.com/covivo/mobicoop/blob/dev/api/src/Geography/Entity/Address.php"
click node_data_provider "https://github.com/covivo/mobicoop/blob/dev/api/src/DataProvider/Service/DataProvider.php"

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_carpool_ui,node_community_ui,node_community_client,node_review_actor toneBlue
class node_carpool_api,node_proposal,node_criteria,node_asks,node_matching,node_proposal_store toneAmber
class node_community_api,node_community_data toneMint
class node_user_api,node_users,node_reviews,node_review_store,node_notifications toneRose
class node_payments,node_solidary,node_solidary_admin,node_articles,node_public_transport,node_address,node_data_provider,node_traveler toneIndigo
```

## Components

### Desktop client

- [Carpool screens](https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php): `client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php`
- [Community screens](https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Community/Controller/CommunityController.php): `client/src/MobicoopBundle/Community/Controller/CommunityController.php`
- [Community client service](https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/Community/Service/CommunityManager.php): `client/src/MobicoopBundle/Community/Service/CommunityManager.php`

### Carpooling

- [Carpool API](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/AdManager.php): `api/src/Carpool/Service/AdManager.php`
- [Proposals](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Proposal.php): `api/src/Carpool/Entity/Proposal.php`
- [Journey criteria](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Criteria.php): `api/src/Carpool/Entity/Criteria.php`
- [Carpool requests](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Entity/Ask.php): `api/src/Carpool/Entity/Ask.php`
- [Search results](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Service/ResultManager.php): `api/src/Carpool/Service/ResultManager.php`
- [Proposal repository](https://github.com/covivo/mobicoop/blob/dev/api/src/Carpool/Repository/ProposalRepository.php): `api/src/Carpool/Repository/ProposalRepository.php`

### Communities

- [Community API](https://github.com/covivo/mobicoop/blob/dev/api/src/Community/Service/CommunityManager.php): `api/src/Community/Service/CommunityManager.php`
- [Community records](https://github.com/covivo/mobicoop/blob/dev/api/src/Community/Entity/Community.php): `api/src/Community/Entity/Community.php`

### Users and communication

- [User accounts](https://github.com/covivo/mobicoop/blob/dev/api/src/User/Service/UserManager.php): `api/src/User/Service/UserManager.php`
- [User profiles](https://github.com/covivo/mobicoop/blob/dev/api/src/User/Entity/User.php): `api/src/User/Entity/User.php`
- [User reviews](https://github.com/covivo/mobicoop/blob/dev/api/src/User/Service/ReviewManager.php): `api/src/User/Service/ReviewManager.php`
- [Review repository](https://github.com/covivo/mobicoop/blob/dev/api/src/User/Repository/ReviewRepository.php): `api/src/User/Repository/ReviewRepository.php`
- [Notifications](https://github.com/covivo/mobicoop/blob/dev/api/src/Communication/Service/NotificationManager.php): `api/src/Communication/Service/NotificationManager.php`

### Other services

- [Payments](https://github.com/covivo/mobicoop/blob/dev/api/src/Payment/Service/PaymentManager.php): `api/src/Payment/Service/PaymentManager.php`
- [Solidarity transport](https://github.com/covivo/mobicoop/blob/dev/api/src/Solidary/Service/SolidaryManager.php): `api/src/Solidary/Service/SolidaryManager.php`
- [Solidarity admin](https://github.com/covivo/mobicoop/blob/dev/api/src/Solidary/Admin/Service/SolidaryManager.php): `api/src/Solidary/Admin/Service/SolidaryManager.php`
- [Articles](https://github.com/covivo/mobicoop/blob/dev/api/src/Article/Service/ArticleManager.php): `api/src/Article/Service/ArticleManager.php`
- [Public transport](https://github.com/covivo/mobicoop/blob/dev/client/src/MobicoopBundle/PublicTransport/Service/PublicTransportManager.php): `client/src/MobicoopBundle/PublicTransport/Service/PublicTransportManager.php`
- [Geographic addresses](https://github.com/covivo/mobicoop/blob/dev/api/src/Geography/Entity/Address.php): `api/src/Geography/Entity/Address.php`
- [External API client](https://github.com/covivo/mobicoop/blob/dev/api/src/DataProvider/Service/DataProvider.php): `api/src/DataProvider/Service/DataProvider.php`

### Other components

- **Traveler**
- **Reviewer**

## Connections

- Traveler → Carpool screens: uses
- Carpool screens → Carpool API: requests ads (evidence: `client/src/MobicoopBundle/Carpool/Controller/CarpoolController.php`)
- Carpool API → Proposals: reads proposals (evidence: `api/src/Carpool/Service/AdManager.php`)
- Carpool API → Carpool requests: checks proofs (evidence: `api/src/Carpool/Service/AdManager.php`)
- Search results → Journey criteria: uses (evidence: `api/src/Carpool/Service/ResultManager.php`)
- Search results → Proposals: uses (evidence: `api/src/Carpool/Service/ResultManager.php`)
- Search results → Carpool requests: uses (evidence: `api/src/Carpool/Service/ResultManager.php`)
- Search results → Proposal repository: queries (evidence: `api/src/Carpool/Service/ResultManager.php`)
- Traveler → Community screens: uses
- Community screens → Community API: manages communities (evidence: `client/src/MobicoopBundle/Community/Controller/CommunityController.php`)
- Community client service → Community records: uses (evidence: `client/src/MobicoopBundle/Community/Service/CommunityManager.php`)
- Reviewer → User reviews: submits review (evidence: `api/src/User/Service/ReviewManager.php`)
- User reviews → Review repository: queries reviews (evidence: `api/src/User/Repository/ReviewRepository.php`)
- User reviews → User profiles: builds reviewer data (evidence: `api/src/User/Service/ReviewManager.php`)
- Traveler → Payments: uses
- Traveler → Solidarity transport: uses
- Traveler → Articles: reads
- Traveler → Public transport: checks transit
