Initial Course

modules/01_fundamentals/README.md

@@ -0,0 +1,34 @@
+# Module 01: C++ Fundamentals
+
+## Learning Goals
+
+- Understand the structure of a C++ program (`main`, headers, translation units)
+- Work with fundamental types (`int`, `double`, `bool`, `char`)
+- Use literals, constants, and basic I/O
+- Apply arithmetic, relational, and logical operators
+- Read and write formatted output
+
+## Exercises
+
+| Exercise | Topic | Standard |
+|----------|-------|----------|
+| `hello_world` | First program, returning values from functions | C++17 |
+| `variables_and_types` | Types, `auto`, type aliases | C++17 |
+| `operators` | Arithmetic, comparisons, bitwise ops | C++17 |
+| `basic_io` | Streams, string formatting | C++17 |
+
+## How to Work
+
+1. Open the exercise header in `include/` to see the required API.
+2. Implement the functions in `src/`.
+3. Run the corresponding test target in CLion or with CTest.
+4. All tests must pass before moving on.
+
+## Run Tests (CLion)
+
+Select a target like `01_fundamentals_hello_world` and click Run, or use:
+
+```bash
+cmake --build build --target 01_fundamentals_hello_world
+ctest --test-dir build -R 01_fundamentals_hello_world
+```