base on # Clean Architecture ## Preamble This is a 2-week coding exercise. You will extend the Clean Architecture implementation to add a use case. It is a continuation of this code: https://github.com/paulgries/LoginCleanArchitecture We have: * implemented the changes from this week's lab * added the login use case * added a "logged in" View and View Model (showing the username), but no Interactor or Controller or Presenter. * created subpackages for the `login`, `signup`, and `logged_in` code * made some style and design change to the code To explore the changes, run "git log" in a Terminal, or choose menu item `Git —> Show Git Log`. Click and explore! You can even watch this README evolve. ## Packaging Take a moment to look at the package structure in `src`. There are packages for the layers of CA, and in some of these packages are "subpackages" for each of the three use cases, `login`, `signup`, and `logged_in`. These packages don't have subpackages: `data_access`, `entity`, `view`, and `app`. **Thought question:** Why don't these have use-case-specific subpackages? ## A note on English: 2-word verb phrases vs. 1-word nouns "Sign up" is a verb phrase and "signup" is a noun. That generalizes: "check in" vs "checkin", "log in" vs "login". Two words for the verb phrase, 1 word for the noun phrase. For example, to complete a login, you need to log in. In "the login process", "login" is a noun acting as an adjective to describe "process". "Basketball coach" is another example of this English construct. ## Comparing the signup and login code In lab this week, you worked with a single user interaction. We have added a second use case for login. Let's compare the two use cases. ### Controllers In IntelliJ, right-click on `LoginController` and select `Open in Right Split`. Now double-click on `SignupController`. When you do, you will see the two Controllers side by side. They are identical in structure, differing only in the details. ### Interactors Now compare `LoginInteractor` and `SignupInteractor` side by side. (You can drag tabs around if you like.) **Thought question:** Why doesn't the `LoginInteractor` have a `UserFactory`? #### Remnants of a bug Compare the two `execute` methods carefully. Look at the variable types (including the instance variables) and compare them to the CA Engine so you understand which boxes are relevant to the Interactors. You'll notice that the `LoginInteractor` starts by extracting the login information from the Input Data object, and that on line 22 the code also gets the password before doing the comparison. In the Signup version, it's all done in one step. The Login code was split up like this because there was a bug and it wasn't obvious what was causing it, even when we used the debugger. We isolated the bug (meaning, we found out what the problem was) by doing one step at a time. **Thought question:** Which version do you find easier to understand, the Signup one or the Login one? **Thought question:** Maybe the problem is with the debugging tools, maybe the IDE doesn't allow easy exploration of expressions? ### Interactor assets Each Interactor has an InputBoundary, InputData, OutputBoundary, and OutpuData. They're all quite short. Compare them. ## Data Access Object There is only one DAO, the `FileUserDataAccessObject`. It has changed since the lab: it has one more method. This is because it implements an interface, `LoginUserDataAccessInterface`. **Thought question:** What is the method that was added? ## Adding a use case interaction [for credit] There is currently no way to delete users from the system. This week's coding exercise has you add a "delete all users" button to the Signup screen and implement the logic for it. Look for "TODO" in the `SignupView` class and follow the instructions. Next, look at the empty classes and interfaces in the "clear_users" packages. Fill them in! For this use case interaction, there is no data to give to the `ClearController`, and no data to put into `ClearInputData`. **Thought question:** You need that Controller for CA, but do you need the InputData object? Make a decision either way and implement your decision. There is no wrong choice. **See MarkUs for details about what you are expected to hand in.** ## Extra Practice You likely noticed that other features of the program aren't working yet either. For example: - the `Log out` button doesn't work once a user logs in - the `Cancel` buttons don't actually cancel anything - the program isn't doing some expected checks for password length or username requirements - the program doesn't have an overall menu to choose between signing up and logging in - and many more! If you feel you need more practice with Clean Architecture before getting started on the project with your team, we encourage you to try adding some of these other bits of functionality to this program. ", Assign "at most 3 tags" to the expected json: {"id":"3997","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"