From 79f4f38690c49912cd4ed606daee559cc57558b4 Mon Sep 17 00:00:00 2001
From: Volodymyr Chekyrta
<127732735+volodymyr-chekyrta@users.noreply.github.com>
Date: Mon, 17 Jul 2023 20:24:25 +0300
Subject: [PATCH] Added base documentation for the project. (#52)
---
Documentation/Documentation.md | 235 ++++++++++++++++++
Documentation/Resources/CALayers.png | Bin 0 -> 34596 bytes
Documentation/Resources/CleanArchitecture.jpg | Bin 0 -> 107444 bytes
.../Resources/Create_module_step1.png | Bin 0 -> 428352 bytes
.../Resources/Create_module_step2.png | Bin 0 -> 168922 bytes
.../Resources/Create_module_step3.png | Bin 0 -> 121674 bytes
.../Resources/Create_module_step4.png | Bin 0 -> 331910 bytes
.../Resources/Create_module_step5.png | Bin 0 -> 66083 bytes
.../Resources/Create_module_step6.png | Bin 0 -> 170772 bytes
.../Resources/Create_module_step7.png | Bin 0 -> 199046 bytes
.../Resources/Create_module_step7_2.png | Bin 0 -> 141656 bytes
.../Resources/Create_module_step7_3.png | Bin 0 -> 52862 bytes
.../Resources/Create_module_step8.png | Bin 0 -> 621721 bytes
Documentation/Resources/Modules.jpg | Bin 0 -> 57090 bytes
README.md | 2 +
15 files changed, 237 insertions(+)
create mode 100644 Documentation/Documentation.md
create mode 100644 Documentation/Resources/CALayers.png
create mode 100644 Documentation/Resources/CleanArchitecture.jpg
create mode 100644 Documentation/Resources/Create_module_step1.png
create mode 100644 Documentation/Resources/Create_module_step2.png
create mode 100644 Documentation/Resources/Create_module_step3.png
create mode 100644 Documentation/Resources/Create_module_step4.png
create mode 100644 Documentation/Resources/Create_module_step5.png
create mode 100644 Documentation/Resources/Create_module_step6.png
create mode 100644 Documentation/Resources/Create_module_step7.png
create mode 100644 Documentation/Resources/Create_module_step7_2.png
create mode 100644 Documentation/Resources/Create_module_step7_3.png
create mode 100644 Documentation/Resources/Create_module_step8.png
create mode 100644 Documentation/Resources/Modules.jpg
diff --git a/Documentation/Documentation.md b/Documentation/Documentation.md
new file mode 100644
index 000000000..81c24d4c5
--- /dev/null
+++ b/Documentation/Documentation.md
@@ -0,0 +1,235 @@
+# Documentation
+
+Content:
+* [Architecture](#architecture)
+ + [Philosophy](#philosophy)
+ + [Concept](#concept)
+ + [What is Clean Architecture?](#what-is-clean-architecture)
+ + [Layers](#layers)
+ - [Presentation](#presentation)
+ - [Domain](#domain)
+ - [Data](#data)
+ + [Example](#example)
+ + [FAQ](#faq)
+ - [How does Clean Architecture improve software development?](#how-does-clean-architecture-improve-software-development)
+ - [Can Clean Architecture be used with any programming language?](#can-clean-architecture-be-used-with-any-programming-language)
+ - [Is Clean Architecture applicable only for large-scale applications?](#is-clean-architecture-applicable-only-for-large-scale-applications)
+ - [How is data validation handled in Clean Architecture?](#how-is-data-validation-handled-in-clean-architecture)
+ - [How are errors handled in Clean Architecture?](#how-are-errors-handled-in-clean-architecture)
+ - [What are Interactors in Clean Architecture?](#what-are-interactors-in-clean-architecture)
+ - [How do you deal with performance in Clean Architecture?](#how-do-you-deal-with-performance-in-clean-architecture)
+ - [Is Clean Architecture the same as Hexagonal Architecture?](#is-clean-architecture-the-same-as-hexagonal-architecture)
+ + [Useful links](#useful-links)
+* [Project structure and Modularity](#project-structure-and-modularity)
+ - [Main rule](#main-rule)
+ - [Structure](#structure)
+ - [Responsibility](#responsibility)
+ - [Benefits](#benefits)
+ - [How to create a module for your new feature?](#how-to-create-a-module-for-your-new-feature)
+* [Tech Stack](#tech-stack)
+
+# Architecture
+
+## Philosophy
+Remember ☝️
+
+Architecture is a crucial part of developing software, but it's not a dogma.
+
+Architecture is a set of recommendations to save you from trivial mistakes and make life easier, but if for your purpose you need to break it - you can do it.
+
+## Concept
+This project follows the architectural concept of The Clean Architecture:
+
+[
](Resources/CleanArchitecture.jpg)
+
+## What is Clean Architecture?
+It is an architectural approach that emphasizes the separation of concerns, the use of dependency inversion, and the creation of testable and maintainable code.
+It promotes flexibility by separating the application into different layers of abstraction.
+This allows for easier maintenance and testing of individual components, as well as the ability to swap out underlying technologies without affecting the overall architecture.
+
+Architecture was popularized by Robert C. Martin ("Uncle Bob").
+
+## Layers
+Usually, implementation consists of the following three layers/packages/folders: Presentation, Domain, and Data.
+
+[
](Resources/CALayers.png)
+
+### Presentation
+Presentation is all about Displaying data, User input handling, Data validation, and Navigation.
+If the Presentation Layer needs data or business logic, it calls Domain Layer.
+
+### Domain
+The Domain layer, also known as the Business layer, is a key component that focuses on the core business logic, rules, and entities specific to the problem domain the application is designed to address.
+The Domain layer is **independent of any technology or infrastructure concerns**, such as databases, user interfaces, or external services.
+This separation allows the business logic to be more easily understood, maintained, and tested, without being affected by changes in other layers or components of the application.
+
+### Data
+The Data layer, or the Persistence layer, is a component of an application's architecture responsible for managing data storage, retrieval, and manipulation.
+This layer serves as an abstraction between the application's core logic and the underlying data storage technology, such as databases, file systems, or external APIs.
+
+## Example
+Examples can be found in most project modules, but let's take a look at the `Course` module.
+For instance, here we can find the next structure:
+`CourseOutlineView` and `CourseContainerViewModel` as a representation of the Presentation Layer.
+`CourseInteractor` as a representation of the Domain Layer.
+And `CourseRepository` as a representation of the Data Layer.
+
+The best way to determine **what a module does** is to open its Interactor.
+Here you can find all the business cases covered by the module.
+
+But if you want to know **how it does it**, you must delve into its Presentation and Data layers.
+
+## FAQ
+
+### How does Clean Architecture improve software development?
+Clean Architecture separates the concerns of software components, reduces coupling, and improves the independence of software systems.
+This makes the system more flexible, maintainable, and testable. It also ensures that the software can survive changes in technology, user interface, and even some business rules.
+
+### Can Clean Architecture be used with any programming language?
+Yes, Clean Architecture is not tied to any specific programming language.
+It's a design philosophy that can be applied to any language as long as it supports the principles of object-oriented design.
+
+### Is Clean Architecture applicable only for large-scale applications?
+No, Clean Architecture is not exclusively for large-scale applications.
+It can be implemented in small projects as well, providing similar benefits of maintainability, scalability, and testability.
+However, for very simple or small-scale applications, implementing Clean Architecture might be overkill and lead to unnecessary complexity.
+
+### How is data validation handled in Clean Architecture?
+Data validation can be considered at various levels in Clean Architecture. Simple, technical validations like checking for null or validating data formats can be done in the outer layers. Business rule validations, on the other hand, should be handled by Entities or Use Cases in the inner layers. This helps to ensure that invalid data never reaches the core business logic.
+
+### How are errors handled in Clean Architecture?
+Error handling in Clean Architecture typically depends on the type of error.
+Domain-specific errors (those that relate to the core business rules) should be handled within the Entities or Use Cases.
+Technical errors (like a database connection failing) should be handled at the outer layers, with the necessary information relayed back to the inner layers through predefined interfaces.
+
+### What are Interactors in Clean Architecture?
+Interactors, also known as Use Cases, represent specific applications of the business rules.
+They orchestrate the flow of data between Entities and the outer layers of the system.
+Interactors contain the logic to fulfill each use case of the system and maintain a decoupled relationship with the Entities and outer layers via interfaces.
+
+### How do you deal with performance in Clean Architecture?
+While Clean Architecture is not specifically designed to optimize performance, it does not inherently cause performance issues either.
+If performance becomes a concern, then performance optimization strategies can be applied in the relevant layers or components.
+However, it is recommended to keep these optimizations isolated from the business rules to preserve the separation of concerns.
+
+### Is Clean Architecture the same as Hexagonal Architecture?
+While there are similarities between Clean Architecture and Hexagonal Architecture (also known as Ports and Adapters) in terms of their goal of separation of concerns and testability, they are not the same.
+Both architectures advocate for isolating business logic from external concerns, but they use different metaphors and structures.
+Clean Architecture tends to focus more on layers, while Hexagonal Architecture emphasizes the interaction points (ports) and their implementations (adapters).
+
+## Useful links
+If you want to delve deeper into the topic of CA, you can find useful links below.
+
+Article: [Clean Architecture for mobile: To be, or not to be](https://medium.com/globant/clean-architecture-for-mobile-to-be-or-not-to-be-2ffc8d46e402)
+
+Video: [Robert C Martin - Clean Architecture and Design](https://www.youtube.com/watch?v=Nsjsiz2A9mg)
+
+Book: [Clean Architecture: A Craftsman's Guide to Software Structure and Design (Robert C. Martin Series)](https://www.amazon.com/Clean-Architecture-Craftsmans-Software-Structure/dp/0134494164)
+
+# Project structure and Modularity
+Modular architecture in applications pertains to the practice of decomposing an app's elements into smaller, reusable, and interchangeable modules.
+Each Feature in the application is represented by a specific module, so you will not have problems finding the right class or functionality.
+
+## Main rule
+Lower modules don't know anything about the higher modules.
+It helps avoid conflicts with circular dependencies.
+
+If you need to pass some logic from one independent module to another, it is not a good idea to link modules to each other, this will eventually lead to circular dependencies and the broken project.
+The better way is an abstraction in the core, implementation in the module, and dependency injection.
+
+## Structure
+[
](Resources/Modules.jpg)
+
+## Responsibility
+Each module is centered around a specific set of features or functionality.
+1. App module - app lifecycle management, routing, dependency control.
+2. Auth Module - anything related to the user authorization process.
+3. Discovery Module - anything related to the course catalog and search.
+4. Dashboard Module - anything related to the course dashboard.
+5. Profile Module - anything related to a user profile and settings.
+6. Course Module - anything related to course structure, certificates, and assessments.
+7. Discussion Module - anything related to course discussions.
+8. Core Module - a set of utilities and abstractions required by each module.
+
+## Benefits
+Modular approach has several benefits such as:
+
+##### Improved code organization
+By separating components into modules, developers can better understand and manage the structure of the codebase.
+This organization facilitates code navigation and makes it easier to locate specific functionalities.
+
+##### Scalability
+Since modules are self-contained, it's easier to add or remove features as the application grows.
+This flexibility allows developers to build scalable apps that can evolve with changing requirements.
+
+##### Reusability
+Modular architecture promotes the creation of reusable components, which can be easily shared across multiple projects or within different parts of the same project.
+This reusability can lead to increased productivity and reduced development time.
+
+##### Faster build time
+Modular architecture allows incremental builds, where only the modified modules are recompiled.
+This approach can significantly reduce build times and improve the development workflow.
+
+## How to create a module for your new feature?
+1. Go to File -> New -> Project...
+
+[
](Resources/Create_module_step1.png)
+
+2. Select `Framework` from Templates and click the Next button.
+
+[
](Resources/Create_module_step2.png)
+
+3. Change your module name, choose Team and click the Next button.
+
+[
](Resources/Create_module_step3.png)
+
+4. Select your project folder and don't forget to add the new module to the OpenEdX project group.
+
+[
](Resources/Create_module_step4.png)
+
+5. Add your new module to the Podfile.
+
+[
](Resources/Create_module_step5.png)
+
+6. Go to the project settings of the new module and add `Configurations` as shown in the screenshot below.
+
+[
](Resources/Create_module_step6.png)
+
+7. Go to your new module target and click `+` sign to add the `Core` module.
+
+[
](Resources/Create_module_step7.png)
+
+Choose `Core.framework` from the list.
+
+[
](Resources/Create_module_step7_2.png)
+
+Change Embed flag to `Do Not Embed`.
+The Core module will be embedded via the App module.
+
+[
](Resources/Create_module_step7_3.png)
+
+8. In the same way, add your new module to the OpenEdX target.
+
+[
](Resources/Create_module_step8.png)
+
+9. Navigate to the project folder and run `pod install`.
+
+10. Optional step. Add `.gitignore`, `SwiftGen`, and a Test target to your module.
+
+# Tech Stack
+The project tries to use only the required number of libraries and frameworks and avoid unnecessary dependencies.
+
+The following technologies are used in the project:
+- Swift, the main programming language.
+- Swift Concurrency, the main toolkit for managing async jobs.
+- SwiftUI, the main toolkit for building UI.
+- SwiftUIIntrospect, SwiftUI backward UIKit access.
+- Alamofire, HTTP networking library.
+- Kingfisher, images loading library.
+- Swinject, dependency injection framework.
+- CoreData, data persistence.
+- Firebase, infrastructure.
+- XCTest, unit testing framework.
+- SwiftyMocky, framework for automatic mock generation.
+- SwiftLint, a tool to enforce Swift style and conventions.
+- SwiftGen, the Swift code generator for assets.
diff --git a/Documentation/Resources/CALayers.png b/Documentation/Resources/CALayers.png
new file mode 100644
index 0000000000000000000000000000000000000000..c8da60ada967b9b8c48f12633e1a6098a3cb7a3d
GIT binary patch
literal 34596
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
literal 0
HcmV?d00001
diff --git a/Documentation/Resources/CleanArchitecture.jpg b/Documentation/Resources/CleanArchitecture.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..3cd44fb58d87e5fd2fe1f0a75533f132bb163c61
GIT binary patch
literal 107444
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