# Learning Outcomes


| Step                                                                 | Title                                                   | Concept Covered                          | Learning objectives                                                                                                                                                                                              | Further Reading                                                                                                                                           |
|----------------------------------------------------------------------|---------------------------------------------------------|------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| [step 1](https://github.com/pact-foundation/pact-workshop-js/tree/step1)   | Create our consumer before the Provider API even exists | Consumer-driven design                   | <ul><li>Understand use case</li></ul>                                                                                                                                                                             | <ul><li>https://martinfowler.com/articles/consumerDrivenContracts.html</li></ul>|                                                                         |
| [step 2](https://github.com/pact-foundation/pact-workshop-js/tree/step2)   | Write a unit test for our consumer                      | -                                        | <ul><li>How to write a basic unit test for an HTTP Client</li><li>Understand how a unit test is unable to catch certain integration issues</li></ul>                                                              | <ul><li>https://docs.pact.io/faq/convinceme</li></ul>                                                                                                     |
| [step 3](https://github.com/pact-foundation/pact-workshop-js/tree/step3)   | Write a Pact test for our consumer                      | Consumer side pact test                  | <ul><li>Understand basic Consumer-side Pact concepts</li><li>Understand "Matchers" to avoid test data brittleness</li><li>Demonstrate that Pact tests are able to catch a class of integration problems</li></ul> | <ul><li>https://docs.pact.io/5-minute-getting-started-guide#scope-of-a-consumer-pact-test</li><li>https://docs.pact.io/best_practices/consumer</li></ul>| |
| [step 4](https://github.com/pact-foundation/pact-workshop-js/tree/step4)   | Verify the consumer pact with the Provider API          | Provider side pact test                  | <ul><li>Understand basic Provider-side Pact concepts</li><li>Place provider side testing in a broader testing context (e.g. where it fits on the pyramid)</li></ul>                                               | <ul><li>https://docs.pact.io/5-minute-getting-started-guide#scope-of-a-provider-pact-test</li></ul>                                                       |
| [step 5](https://github.com/pact-foundation/pact-workshop-js/tree/step5)   | Fix the consumer's bad assumptions about the Provider   | Humans talking to humans (collaboration) | <ul><li>Understand that a tool facilitates collaboration, it doesn't replace it</li></ul>                                                                                                                         |                                                                                                                                                           |
| [step 6](https://github.com/pact-foundation/pact-workshop-js/tree/step6)   | Write a pact test for `404` (missing User) in consumer  | Testing API invariants                   | <ul><li>Understand how we can test "stateful" APIs without having to create complex, sequential API calls</li></ul>                                                                                               |                                                                                                                                                           |
| [step 7](https://github.com/pact-foundation/pact-workshop-js/tree/step7)   | Update API to handle `404` case                         | Provider States                          | <ul><li>How Pact deals with "stateful" interactions, via the concept of "Provider States"</li></ul>                                                                                                               | <ul><li>https://docs.pact.io/getting_started/provider_states</li></ul>                                                                                    |
| [step 8](https://github.com/pact-foundation/pact-workshop-js/tree/step8)   | Write a pact test for the `401` case                    | Testing authenticated APIs               | <ul><li>Service evolution - adding a new feature</li></ul>                                                                                                                                                        |                                                                                                                                                           |
| [step 9](https://github.com/pact-foundation/pact-workshop-js/tree/step9)   | Update API to handle `401` case                         | Service evolution                        | <ul><li>Understand the challenge of dealing with complex/dynamic data, such as time-bound authentication tokens</li></ul>                                                                                         |                                                                                                                                                           |
| [step 10](https://github.com/pact-foundation/pact-workshop-js/tree/step10) | Fix the provider to support the `401` case              | Request filters                          | <ul><li>Understand Pact's approach to dealing with complex/dynamic data, such as time-bound authentication tokens</li></ul>                                                                                       |                                                                                                                                                           |
| [step 11](https://github.com/pact-foundation/pact-workshop-js/tree/step11) | Implement a broker workflow for integration with CI/CD  | Automation                               | <ul><li>Understand how to use Pact in a CI and CD workflow</li></ul>                                                                                                                                              | <ul><li>https://docs.pact.io/pact_broker</li><li>https://docs.pact.io/best_practices/pact_nirvana</li></ul>                                               |