# anassamajane/cpp architecture

> Architecture diagram of the GitHub repository anassamajane/cpp, 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/anassamajane/cpp
- Repository: https://github.com/anassamajane/cpp

## Overview

This repository is a collection of standalone C++ exercises, not one integrated application. Each exercise demonstrates a small domain workflow—from object-oriented models and administrative forms to generic containers and algorithms—through its own example program. The graph groups related exercises by topic and shows only relationships supported by the supplied source index or excerpts. Many implementation files were not sampled, so some exercise capabilities are represented by their existing source paths without inferred internal call chains.

Main entry points: [`cpp03/ex02/ClapTrap.cpp`](https://github.com/anassamajane/cpp/blob/main/cpp03/ex02/ClapTrap.cpp) (ClapTrap family), [`cpp07/ex02/Array.hpp`](https://github.com/anassamajane/cpp/blob/main/cpp07/ex02/Array.hpp) (Array template), [`cpp08/ex00/easyfind.hpp`](https://github.com/anassamajane/cpp/blob/main/cpp08/ex00/easyfind.hpp) (Container search), [`cpp08/ex01/Span.cpp`](https://github.com/anassamajane/cpp/blob/main/cpp08/ex01/Span.cpp) (Span)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_objects["Objects and Classes"]
  node_phonebook["PhoneBook<br/>[PhoneBook.cpp]"]
  node_contact["Contact<br/>[Contact.hpp]"]
  node_weapon["Weapon<br/>[Weapon.hpp]"]
  node_humans["Human A / B<br/>[HumanA.cpp]"]
  node_fixed["Fixed-point<br/>[Fixed.cpp]"]
  node_claptrap["ClapTrap family<br/>[ClapTrap.cpp]"]
end

subgraph group_polymorphism["Polymorphism and Forms"]
  node_animals["Animal hierarchy<br/>[Animal.cpp]"]
  node_brain["Brain<br/>[Brain.cpp]"]
  node_materia["Materia system<br/>[AMateria.cpp]"]
  node_character["Character<br/>[Character.cpp]"]
  node_materia_source["MateriaSource<br/>[MateriaSource.cpp]"]
  node_bureaucrat["Bureaucrat<br/>[Bureaucrat.cpp]"]
  node_forms["Forms<br/>[AForm.cpp]"]
  node_intern["Intern<br/>[Intern.cpp]"]
  node_scalar["Scalar conversion"]
  node_serializer["Serializer<br/>[Serializer.cpp]"]
  node_rtti["Runtime identification<br/>[main.cpp]"]
end

subgraph group_templates["Templates and Containers"]
  node_array["Array template<br/>[Array.hpp]"]
  node_easyfind["Container search<br/>[easyfind.hpp]"]
  node_span["Span<br/>[Span.cpp]"]
  node_mutant_stack["MutantStack<br/>[MutantStack.hpp]"]
end

subgraph group_algorithms["Data Algorithms"]
  node_bitcoin["Bitcoin exchange"]
  node_rpn["RPN calculator<br/>[RPN.cpp]"]
  node_pmerge["PmergeMe<br/>[PmergeMe.cpp]"]
end

node_phonebook -->|"uses contacts"| node_contact
node_humans -->|"uses weapon"| node_weapon
node_claptrap -->|"extends base"| node_claptrap
node_animals -.->|"owns brain"| node_brain
node_character -->|"equips materia"| node_materia
node_materia_source -->|"creates materia"| node_materia
node_bureaucrat -->|"signs and executes"| node_forms
node_intern -->|"creates forms"| node_forms
node_array -->|"exercises template"| node_array
node_easyfind -->|"searches containers"| node_easyfind
node_span -->|"adds ranges"| node_span
node_mutant_stack -->|"iterates stack"| node_mutant_stack
node_bitcoin -.->|"processes exchange"| node_bitcoin
node_rpn -.->|"evaluates expression"| node_rpn
node_pmerge -.->|"sorts sequences"| node_pmerge

click node_phonebook "https://github.com/anassamajane/cpp/blob/main/cpp00/ex01/PhoneBook.cpp"
click node_contact "https://github.com/anassamajane/cpp/blob/main/cpp00/ex01/Contact.hpp"
click node_weapon "https://github.com/anassamajane/cpp/blob/main/cpp01/ex03/Weapon.hpp"
click node_humans "https://github.com/anassamajane/cpp/blob/main/cpp01/ex03/HumanA.cpp"
click node_fixed "https://github.com/anassamajane/cpp/blob/main/cpp02/ex02/Fixed.cpp"
click node_claptrap "https://github.com/anassamajane/cpp/blob/main/cpp03/ex02/ClapTrap.cpp"
click node_animals "https://github.com/anassamajane/cpp/blob/main/cpp04/ex01/Animal.cpp"
click node_brain "https://github.com/anassamajane/cpp/blob/main/cpp04/ex01/Brain.cpp"
click node_materia "https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/AMateria.cpp"
click node_character "https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/Character.cpp"
click node_materia_source "https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/MateriaSource.cpp"
click node_bureaucrat "https://github.com/anassamajane/cpp/blob/main/cpp05/ex02/Bureaucrat.cpp"
click node_forms "https://github.com/anassamajane/cpp/blob/main/cpp05/ex02/AForm.cpp"
click node_intern "https://github.com/anassamajane/cpp/blob/main/cpp05/ex03/Intern.cpp"
click node_scalar "https://github.com/anassamajane/cpp/blob/main/cpp06/ex00/ScalarConverter.cpp"
click node_serializer "https://github.com/anassamajane/cpp/blob/main/cpp06/ex01/Serializer.cpp"
click node_rtti "https://github.com/anassamajane/cpp/blob/main/cpp06/ex02/main.cpp"
click node_array "https://github.com/anassamajane/cpp/blob/main/cpp07/ex02/Array.hpp"
click node_easyfind "https://github.com/anassamajane/cpp/blob/main/cpp08/ex00/easyfind.hpp"
click node_span "https://github.com/anassamajane/cpp/blob/main/cpp08/ex01/Span.cpp"
click node_mutant_stack "https://github.com/anassamajane/cpp/blob/main/cpp08/ex02/MutantStack.hpp"
click node_bitcoin "https://github.com/anassamajane/cpp/blob/main/cpp09/ex00/BitcoinExchange.cpp"
click node_rpn "https://github.com/anassamajane/cpp/blob/main/cpp09/ex01/RPN.cpp"
click node_pmerge "https://github.com/anassamajane/cpp/blob/main/cpp09/ex02/PmergeMe.cpp"

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_phonebook,node_contact,node_weapon,node_humans,node_fixed,node_claptrap toneBlue
class node_animals,node_brain,node_materia,node_character,node_materia_source,node_bureaucrat,node_forms,node_intern,node_scalar,node_serializer,node_rtti toneAmber
class node_array,node_easyfind,node_span,node_mutant_stack toneMint
class node_bitcoin,node_rpn,node_pmerge toneRose
```

## Components

### Objects and Classes

- [PhoneBook](https://github.com/anassamajane/cpp/blob/main/cpp00/ex01/PhoneBook.cpp): `cpp00/ex01/PhoneBook.cpp`
- [Contact](https://github.com/anassamajane/cpp/blob/main/cpp00/ex01/Contact.hpp): `cpp00/ex01/Contact.hpp`
- [Weapon](https://github.com/anassamajane/cpp/blob/main/cpp01/ex03/Weapon.hpp): `cpp01/ex03/Weapon.hpp`
- [Human A / B](https://github.com/anassamajane/cpp/blob/main/cpp01/ex03/HumanA.cpp): `cpp01/ex03/HumanA.cpp`
- [Fixed-point](https://github.com/anassamajane/cpp/blob/main/cpp02/ex02/Fixed.cpp): `cpp02/ex02/Fixed.cpp`
- [ClapTrap family](https://github.com/anassamajane/cpp/blob/main/cpp03/ex02/ClapTrap.cpp): `cpp03/ex02/ClapTrap.cpp`

### Polymorphism and Forms

- [Animal hierarchy](https://github.com/anassamajane/cpp/blob/main/cpp04/ex01/Animal.cpp): `cpp04/ex01/Animal.cpp`
- [Brain](https://github.com/anassamajane/cpp/blob/main/cpp04/ex01/Brain.cpp): `cpp04/ex01/Brain.cpp`
- [Materia system](https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/AMateria.cpp): `cpp04/ex03/AMateria.cpp`
- [Character](https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/Character.cpp): `cpp04/ex03/Character.cpp`
- [MateriaSource](https://github.com/anassamajane/cpp/blob/main/cpp04/ex03/MateriaSource.cpp): `cpp04/ex03/MateriaSource.cpp`
- [Bureaucrat](https://github.com/anassamajane/cpp/blob/main/cpp05/ex02/Bureaucrat.cpp): `cpp05/ex02/Bureaucrat.cpp`
- [Forms](https://github.com/anassamajane/cpp/blob/main/cpp05/ex02/AForm.cpp): `cpp05/ex02/AForm.cpp`
- [Intern](https://github.com/anassamajane/cpp/blob/main/cpp05/ex03/Intern.cpp): `cpp05/ex03/Intern.cpp`
- [Scalar conversion](https://github.com/anassamajane/cpp/blob/main/cpp06/ex00/ScalarConverter.cpp): `cpp06/ex00/ScalarConverter.cpp`
- [Serializer](https://github.com/anassamajane/cpp/blob/main/cpp06/ex01/Serializer.cpp): `cpp06/ex01/Serializer.cpp`
- [Runtime identification](https://github.com/anassamajane/cpp/blob/main/cpp06/ex02/main.cpp): `cpp06/ex02/main.cpp`

### Templates and Containers

- [Array template](https://github.com/anassamajane/cpp/blob/main/cpp07/ex02/Array.hpp): `cpp07/ex02/Array.hpp`
- [Container search](https://github.com/anassamajane/cpp/blob/main/cpp08/ex00/easyfind.hpp): `cpp08/ex00/easyfind.hpp`
- [Span](https://github.com/anassamajane/cpp/blob/main/cpp08/ex01/Span.cpp): `cpp08/ex01/Span.cpp`
- [MutantStack](https://github.com/anassamajane/cpp/blob/main/cpp08/ex02/MutantStack.hpp): `cpp08/ex02/MutantStack.hpp`

### Data Algorithms

- [Bitcoin exchange](https://github.com/anassamajane/cpp/blob/main/cpp09/ex00/BitcoinExchange.cpp): `cpp09/ex00/BitcoinExchange.cpp`
- [RPN calculator](https://github.com/anassamajane/cpp/blob/main/cpp09/ex01/RPN.cpp): `cpp09/ex01/RPN.cpp`
- [PmergeMe](https://github.com/anassamajane/cpp/blob/main/cpp09/ex02/PmergeMe.cpp): `cpp09/ex02/PmergeMe.cpp`

## Connections

- PhoneBook → Contact: uses contacts
- Human A / B → Weapon: uses weapon
- ClapTrap family → ClapTrap family: extends base
- Animal hierarchy → Brain: owns brain
- Character → Materia system: equips materia
- MateriaSource → Materia system: creates materia
- Bureaucrat → Forms: signs and executes
- Intern → Forms: creates forms
- Array template → Array template: exercises template (evidence: `cpp07/ex02/main.cpp`)
- Container search → Container search: searches containers (evidence: `cpp08/ex00/main.cpp`)
- Span → Span: adds ranges
- MutantStack → MutantStack: iterates stack (evidence: `cpp08/ex02/main.cpp`)
- Bitcoin exchange → Bitcoin exchange: processes exchange
- RPN calculator → RPN calculator: evaluates expression
- PmergeMe → PmergeMe: sorts sequences
