# kherbiche/fec architecture

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

- Interactive diagram: https://gitdiagram.com/kherbiche/fec
- Repository: https://github.com/kherbiche/fec

## Overview

This repository implements FEC accounting-file validation and processing, with a browser upload interface, a Java service layer, and Spark-backed repository processing. The principal workflow is file selection and HTTP upload, file parsing and format detection, then rule-based validation over Spark data. The tree also includes a separate mail API and Spark streaming support. The README is empty; some web-to-service and streaming wiring is not shown, so those links are omitted or marked unverified.

Main entry points: [`fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java) (Processing manager), [`fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`](https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java) (FEC repository), [`fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java`](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java) (Parsing helper), [`fec-front/src/main/frontend/src/app/app.component.ts`](https://github.com/kherbiche/fec/blob/master/fec-front/src/main/frontend/src/app/app.component.ts) (Angular app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Upload client"]
  node_angular["Angular app<br/>[app.component.ts]"]
  node_upload_service["Upload service<br/>[app.service.ts]"]
  node_web_upload["Web upload<br/>[Upload.java]"]
end

subgraph group_processing["FEC processing"]
  node_fec_model["FEC line model<br/>[FecLine.java]"]
  node_fec_object["Parsed file object<br/>[FecObjJRdd.java]"]
  node_manager["Processing manager<br/>[ManagerImpl.java]"]
  node_manager_helper["Parsing helper<br/>[ManagerHelper.java]"]
  node_validation["Validation rules"]
  node_stream_handler["Stream handler<br/>[FecSceHandler.java]"]
end

subgraph group_data["Spark data access"]
  node_repo["FEC repository<br/>[FecRepoImpl.java]"]
  node_spark_config["Spark configuration<br/>[SparkConfig.java]"]
  node_spark_data["Spark datasets<br/>[IFecRepo.java]"]
end

subgraph group_mail["Mail API"]
  node_mail_resource["Mail endpoint<br/>[MailResource.java]"]
  node_mail_helper["Mail helper"]
  node_mail_client["Mail client<br/>[MailClient.java]"]
end

node_user(("Uploader"))
node_hdfs[("HDFS files")]

node_user -->|"selects file"| node_angular
node_angular -->|"submits upload"| node_upload_service
node_upload_service -.->|"posts file"| node_web_upload
node_web_upload -.->|"starts processing"| node_manager
node_manager -->|"loads and queries"| node_repo
node_manager -->|"constructs file object"| node_manager_helper
node_manager_helper -->|"builds"| node_fec_object
node_manager_helper -->|"applies format rules"| node_validation
node_manager -->|"runs checks"| node_validation
node_fec_model -->|"models rows"| node_repo
node_repo -->|"uses Spark"| node_spark_config
node_repo -->|"implements"| node_spark_data
node_repo -->|"reads files"| node_hdfs
node_manager -->|"stores or streams"| node_hdfs
node_stream_handler -->|"handles stream objects"| node_fec_object
node_mail_resource -->|"delegates mail"| node_mail_helper

click node_angular "https://github.com/kherbiche/fec/blob/master/fec-front/src/main/frontend/src/app/app.component.ts"
click node_upload_service "https://github.com/kherbiche/fec/blob/master/fec-front/src/main/frontend/src/app/app.service.ts"
click node_web_upload "https://github.com/kherbiche/fec/blob/master/fec-web/src/main/java/fr/bzh/rzh/web/controllers/Upload.java"
click node_fec_model "https://github.com/kherbiche/fec/blob/master/fec-core/src/main/java/fr/bzh/rzh/fec/model/FecLine.java"
click node_fec_object "https://github.com/kherbiche/fec/blob/master/fec-core/src/main/java/fr/bzh/rzh/fec/model/FecObjJRdd.java"
click node_manager "https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java"
click node_manager_helper "https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java"
click node_validation "https://github.com/kherbiche/fec/tree/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/rules"
click node_stream_handler "https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/handler/FecSceHandler.java"
click node_repo "https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java"
click node_spark_config "https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/conf/SparkConfig.java"
click node_spark_data "https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/IFecRepo.java"
click node_mail_resource "https://github.com/kherbiche/fec/blob/master/fec-mail/src/main/java/fr/atos/rennes/fec/mail/resources/MailResource.java"
click node_mail_helper "https://github.com/kherbiche/fec/blob/master/fec-mail/src/main/java/fr/atos/rennes/fec/mail/MangerMailHelper.java"
click node_mail_client "https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/mail/MailClient.java"

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_angular,node_upload_service,node_web_upload toneBlue
class node_fec_model,node_fec_object,node_manager,node_manager_helper,node_validation,node_stream_handler,node_hdfs toneAmber
class node_repo,node_spark_config,node_spark_data toneMint
class node_mail_resource,node_mail_helper,node_mail_client toneRose
class node_user toneIndigo
```

## Components

### Upload client

- [Angular app](https://github.com/kherbiche/fec/blob/master/fec-front/src/main/frontend/src/app/app.component.ts): `fec-front/src/main/frontend/src/app/app.component.ts`
- [Upload service](https://github.com/kherbiche/fec/blob/master/fec-front/src/main/frontend/src/app/app.service.ts): `fec-front/src/main/frontend/src/app/app.service.ts`
- [Web upload](https://github.com/kherbiche/fec/blob/master/fec-web/src/main/java/fr/bzh/rzh/web/controllers/Upload.java): `fec-web/src/main/java/fr/bzh/rzh/web/controllers/Upload.java`

### FEC processing

- [FEC line model](https://github.com/kherbiche/fec/blob/master/fec-core/src/main/java/fr/bzh/rzh/fec/model/FecLine.java): `fec-core/src/main/java/fr/bzh/rzh/fec/model/FecLine.java`
- [Parsed file object](https://github.com/kherbiche/fec/blob/master/fec-core/src/main/java/fr/bzh/rzh/fec/model/FecObjJRdd.java): `fec-core/src/main/java/fr/bzh/rzh/fec/model/FecObjJRdd.java`
- [Processing manager](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java): `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`
- [Parsing helper](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java): `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java`
- [Validation rules](https://github.com/kherbiche/fec/tree/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/rules): `fec-service/src/main/java/fr/bzh/rzh/service/fec/rules`
- [Stream handler](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/handler/FecSceHandler.java): `fec-service/src/main/java/fr/bzh/rzh/service/handler/FecSceHandler.java`

### Spark data access

- [FEC repository](https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java): `fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`
- [Spark configuration](https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/conf/SparkConfig.java): `fec-repo/src/main/java/fr/bzh/rzh/repository/conf/SparkConfig.java`
- [Spark datasets](https://github.com/kherbiche/fec/blob/master/fec-repo/src/main/java/fr/bzh/rzh/repository/IFecRepo.java): `fec-repo/src/main/java/fr/bzh/rzh/repository/IFecRepo.java`

### Mail API

- [Mail endpoint](https://github.com/kherbiche/fec/blob/master/fec-mail/src/main/java/fr/atos/rennes/fec/mail/resources/MailResource.java): `fec-mail/src/main/java/fr/atos/rennes/fec/mail/resources/MailResource.java`
- [Mail helper](https://github.com/kherbiche/fec/blob/master/fec-mail/src/main/java/fr/atos/rennes/fec/mail/MangerMailHelper.java): `fec-mail/src/main/java/fr/atos/rennes/fec/mail/MangerMailHelper.java`
- [Mail client](https://github.com/kherbiche/fec/blob/master/fec-service/src/main/java/fr/bzh/rzh/service/fec/mail/MailClient.java): `fec-service/src/main/java/fr/bzh/rzh/service/fec/mail/MailClient.java`

### Other components

- **Uploader**
- **HDFS files**

## Connections

- Uploader → Angular app: selects file (evidence: `fec-front/src/main/frontend/src/app/app.component.ts`)
- Angular app → Upload service: submits upload (evidence: `fec-front/src/main/frontend/src/app/app.component.ts`)
- Upload service → Web upload: posts file
- Web upload → Processing manager: starts processing
- Processing manager → FEC repository: loads and queries (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`)
- Processing manager → Parsing helper: constructs file object (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`)
- Parsing helper → Parsed file object: builds (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java`)
- Parsing helper → Validation rules: applies format rules (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerHelper.java`)
- Processing manager → Validation rules: runs checks (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`)
- FEC line model → FEC repository: models rows (evidence: `fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`)
- FEC repository → Spark configuration: uses Spark (evidence: `fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`)
- FEC repository → Spark datasets: implements (evidence: `fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`)
- FEC repository → HDFS files: reads files (evidence: `fec-repo/src/main/java/fr/bzh/rzh/repository/fec/FecRepoImpl.java`)
- Processing manager → HDFS files: stores or streams (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/fec/ManagerImpl.java`)
- Stream handler → Parsed file object: handles stream objects (evidence: `fec-service/src/main/java/fr/bzh/rzh/service/handler/FecSceHandler.java`)
- Mail endpoint → Mail helper: delegates mail (evidence: `fec-mail/src/main/java/fr/atos/rennes/fec/mail/resources/MailResource.java`)
