# manassebonsomi/smart_borne architecture

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

- Interactive diagram: https://gitdiagram.com/manassebonsomi/smart_borne
- Repository: https://github.com/manassebonsomi/smart_borne

## Overview

CCC Orientation System is a Flask-backed orientation platform for learners and trainers. Its principal learner workflow creates a profile, starts or resumes a session, presents a questionnaire, saves progress, and produces a recommended learning pathway. Trainer capabilities include question and campaign management, command-driven operations, dashboards, reports, and audit/error history. The graph combines documented product stages with source-index and excerpt evidence; several controller and service internals were not sampled, so uncertain connections are omitted.

Main entry points: [`controllers/command_controller.py`](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/command_controller.py) (Command controller), [`app.py`](https://github.com/manassebonsomi/smart_borne/blob/main/app.py) (Flask API), [`services/session_manager.py`](https://github.com/manassebonsomi/smart_borne/blob/main/services/session_manager.py) (Session lifecycle), [`config/database.py`](https://github.com/manassebonsomi/smart_borne/blob/main/config/database.py) (SQLAlchemy database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner["Learner journey"]
  node_profile["Profile management"]
  node_sessions["Session lifecycle<br/>[session_manager.py]"]
  node_survey["Questionnaire<br/>[survey_engine.py]"]
  node_recommendation["Pathway recommendation"]
  node_recommendation_api["Recommendation API"]
end

subgraph group_trainer["Trainer tools"]
  node_questions["Question management"]
  node_dashboard["Dashboard statistics"]
  node_reports["Report exports"]
  node_campaigns["Campaign management"]
end

subgraph group_commands["Command processing"]
  node_command_controller["Command controller"]
  node_correction["Command correction"]
  node_lexer["Lexical analysis<br/>[lexer.py]"]
  node_parser["LL&#40;1&#41; parsing<br/>[ll1_parser.py]"]
  node_builder["Command builder<br/>[command_builder.py]"]
  node_dispatcher["Command dispatcher"]
end

subgraph group_platform["Application services"]
  node_flask["Flask API<br/>[app.py]"]
  node_audit["Audit and errors<br/>[audit_service.py]"]
  node_auth["Authentication<br/>[auth_controller.py]"]
end

subgraph group_data["Domain data"]
  node_database[("SQLAlchemy database<br/>[database.py]")]
  node_learner_data[("Learner and session records<br/>[utilisateur.py]")]
  node_question_data[("Question records<br/>[question.py]")]
  node_recommendation_data[("Recommendation records<br/>[recommandation.py]")]
  node_command_data[("Command records<br/>[commande.py]")]
end

node_learner(("Learner"))
node_trainer(("Trainer"))

node_learner -->|"creates profile"| node_profile
node_profile -.->|"starts journey"| node_sessions
node_sessions -.->|"presents questions"| node_survey
node_survey -->|"analyzes answers"| node_recommendation
node_recommendation -.->|"provides pathway"| node_recommendation_api
node_learner -->|"resumes session"| node_sessions
node_flask -->|"registers routes"| node_sessions
node_flask -->|"registers routes"| node_questions
node_flask -->|"registers routes"| node_command_controller
node_flask -->|"registers routes"| node_recommendation_api
node_flask -->|"registers routes"| node_dashboard
node_flask -->|"registers routes"| node_reports
node_flask -->|"registers routes"| node_campaigns
node_flask -->|"registers routes"| node_auth
node_sessions -->|"reads and updates"| node_learner_data
node_recommendation_api -->|"uses service"| node_recommendation
node_questions -->|"manages records"| node_question_data
node_dashboard -->|"queries statistics"| node_learner_data
node_reports -->|"queries records"| node_learner_data
node_campaigns -->|"records actions"| node_audit
node_command_controller -->|"corrects command"| node_correction
node_command_controller -->|"tokenizes command"| node_lexer
node_command_controller -->|"validates syntax"| node_parser
node_command_controller -->|"builds command"| node_builder
node_command_controller -->|"dispatches command"| node_dispatcher
node_command_controller -->|"saves command"| node_command_data
node_command_controller -->|"records execution"| node_audit
node_trainer -->|"submits commands"| node_command_controller
node_trainer -->|"views statistics"| node_dashboard
node_trainer -->|"exports reports"| node_reports
node_database -->|"backs models"| node_learner_data
node_database -->|"backs models"| node_question_data
node_database -->|"backs models"| node_recommendation_data
node_database -->|"backs models"| node_command_data

click node_flask "https://github.com/manassebonsomi/smart_borne/blob/main/app.py"
click node_profile "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/profile_controller.py"
click node_sessions "https://github.com/manassebonsomi/smart_borne/blob/main/services/session_manager.py"
click node_survey "https://github.com/manassebonsomi/smart_borne/blob/main/services/survey_engine.py"
click node_recommendation "https://github.com/manassebonsomi/smart_borne/blob/main/services/recommendation_engine.py"
click node_recommendation_api "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/recommandation_controller.py"
click node_questions "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/question_controller.py"
click node_dashboard "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/dashboard_controller.py"
click node_reports "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/report_controller.py"
click node_campaigns "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/campagne_controller.py"
click node_audit "https://github.com/manassebonsomi/smart_borne/blob/main/services/audit_service.py"
click node_auth "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/auth_controller.py"
click node_command_controller "https://github.com/manassebonsomi/smart_borne/blob/main/controllers/command_controller.py"
click node_correction "https://github.com/manassebonsomi/smart_borne/blob/main/services/command_corrector.py"
click node_lexer "https://github.com/manassebonsomi/smart_borne/blob/main/services/lexer.py"
click node_parser "https://github.com/manassebonsomi/smart_borne/blob/main/services/ll1_parser.py"
click node_builder "https://github.com/manassebonsomi/smart_borne/blob/main/services/command_builder.py"
click node_dispatcher "https://github.com/manassebonsomi/smart_borne/blob/main/services/command_dispatcher.py"
click node_database "https://github.com/manassebonsomi/smart_borne/blob/main/config/database.py"
click node_learner_data "https://github.com/manassebonsomi/smart_borne/blob/main/models/utilisateur.py"
click node_question_data "https://github.com/manassebonsomi/smart_borne/blob/main/models/question.py"
click node_recommendation_data "https://github.com/manassebonsomi/smart_borne/blob/main/models/recommandation.py"
click node_command_data "https://github.com/manassebonsomi/smart_borne/blob/main/models/commande.py"

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_profile,node_sessions,node_survey,node_recommendation,node_recommendation_api toneBlue
class node_questions,node_dashboard,node_reports,node_campaigns toneAmber
class node_command_controller,node_correction,node_lexer,node_parser,node_builder,node_dispatcher toneMint
class node_flask,node_audit,node_auth toneRose
class node_database,node_learner_data,node_question_data,node_recommendation_data,node_command_data,node_learner,node_trainer toneIndigo
```

## Components

### Learner journey

- [Profile management](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/profile_controller.py): `controllers/profile_controller.py`
- [Session lifecycle](https://github.com/manassebonsomi/smart_borne/blob/main/services/session_manager.py): `services/session_manager.py`
- [Questionnaire](https://github.com/manassebonsomi/smart_borne/blob/main/services/survey_engine.py): `services/survey_engine.py`
- [Pathway recommendation](https://github.com/manassebonsomi/smart_borne/blob/main/services/recommendation_engine.py): `services/recommendation_engine.py`
- [Recommendation API](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/recommandation_controller.py): `controllers/recommandation_controller.py`

### Trainer tools

- [Question management](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/question_controller.py): `controllers/question_controller.py`
- [Dashboard statistics](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/dashboard_controller.py): `controllers/dashboard_controller.py`
- [Report exports](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/report_controller.py): `controllers/report_controller.py`
- [Campaign management](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/campagne_controller.py): `controllers/campagne_controller.py`

### Command processing

- [Command controller](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/command_controller.py): `controllers/command_controller.py`
- [Command correction](https://github.com/manassebonsomi/smart_borne/blob/main/services/command_corrector.py): `services/command_corrector.py`
- [Lexical analysis](https://github.com/manassebonsomi/smart_borne/blob/main/services/lexer.py): `services/lexer.py`
- [LL(1) parsing](https://github.com/manassebonsomi/smart_borne/blob/main/services/ll1_parser.py): `services/ll1_parser.py`
- [Command builder](https://github.com/manassebonsomi/smart_borne/blob/main/services/command_builder.py): `services/command_builder.py`
- [Command dispatcher](https://github.com/manassebonsomi/smart_borne/blob/main/services/command_dispatcher.py): `services/command_dispatcher.py`

### Application services

- [Flask API](https://github.com/manassebonsomi/smart_borne/blob/main/app.py): `app.py`
- [Audit and errors](https://github.com/manassebonsomi/smart_borne/blob/main/services/audit_service.py): `services/audit_service.py`
- [Authentication](https://github.com/manassebonsomi/smart_borne/blob/main/controllers/auth_controller.py): `controllers/auth_controller.py`

### Domain data

- [SQLAlchemy database](https://github.com/manassebonsomi/smart_borne/blob/main/config/database.py): `config/database.py`
- [Learner and session records](https://github.com/manassebonsomi/smart_borne/blob/main/models/utilisateur.py): `models/utilisateur.py`
- [Question records](https://github.com/manassebonsomi/smart_borne/blob/main/models/question.py): `models/question.py`
- [Recommendation records](https://github.com/manassebonsomi/smart_borne/blob/main/models/recommandation.py): `models/recommandation.py`
- [Command records](https://github.com/manassebonsomi/smart_borne/blob/main/models/commande.py): `models/commande.py`

### Other components

- **Learner**
- **Trainer**

## Connections

- Learner → Profile management: creates profile
- Profile management → Session lifecycle: starts journey
- Session lifecycle → Questionnaire: presents questions
- Questionnaire → Pathway recommendation: analyzes answers
- Pathway recommendation → Recommendation API: provides pathway
- Learner → Session lifecycle: resumes session
- Flask API → Session lifecycle: registers routes (evidence: `app.py`)
- Flask API → Question management: registers routes (evidence: `app.py`)
- Flask API → Command controller: registers routes (evidence: `app.py`)
- Flask API → Recommendation API: registers routes (evidence: `app.py`)
- Flask API → Dashboard statistics: registers routes (evidence: `app.py`)
- Flask API → Report exports: registers routes (evidence: `app.py`)
- Flask API → Campaign management: registers routes (evidence: `app.py`)
- Flask API → Authentication: registers routes (evidence: `app.py`)
- Session lifecycle → Learner and session records: reads and updates (evidence: `services/session_manager.py`)
- Recommendation API → Pathway recommendation: uses service (evidence: `controllers/recommandation_controller.py`)
- Question management → Question records: manages records (evidence: `controllers/question_controller.py`)
- Dashboard statistics → Learner and session records: queries statistics (evidence: `controllers/dashboard_controller.py`)
- Report exports → Learner and session records: queries records (evidence: `controllers/report_controller.py`)
- Campaign management → Audit and errors: records actions (evidence: `controllers/campagne_controller.py`)
- Command controller → Command correction: corrects command (evidence: `controllers/command_controller.py`)
- Command controller → Lexical analysis: tokenizes command (evidence: `controllers/command_controller.py`)
- Command controller → LL(1) parsing: validates syntax (evidence: `controllers/command_controller.py`)
- Command controller → Command builder: builds command (evidence: `controllers/command_controller.py`)
- Command controller → Command dispatcher: dispatches command (evidence: `controllers/command_controller.py`)
- Command controller → Command records: saves command (evidence: `controllers/command_controller.py`)
- Command controller → Audit and errors: records execution (evidence: `controllers/command_controller.py`)
- Trainer → Command controller: submits commands
- Trainer → Dashboard statistics: views statistics
- Trainer → Report exports: exports reports
- SQLAlchemy database → Learner and session records: backs models (evidence: `models/utilisateur.py`)
- SQLAlchemy database → Question records: backs models (evidence: `models/question.py`)
- SQLAlchemy database → Recommendation records: backs models (evidence: `models/recommandation.py`)
- SQLAlchemy database → Command records: backs models (evidence: `models/commande.py`)
