This is a demo of a service to make tax filing faster and easier for a preselected group of eligible low-income Canadians. This service was designed and developed by the Canadian Digital Service (CDS) in partnership with the Canada Revenue Agency (CRA).
CRA already has most of the information that tax-filers include in their returns. At the same time, low-confidence tax filers are very worried about making mistakes when submitting a tax return. Using this information, we aimed to design a service that provides a wizard-like tax filing experience: rather than requiring tax-filers to enter their information, the service presents information that the CRA already has, then asks tax-filers to confirm the information is correct.
| Demo user 1 | Demo user 2 |
|---|---|
| Gabrielle Roy | Monique Corriveau |
A5G98S4K1 |
A5G98S4K3 |
540 739 869 |
435 073 143 |
09 09 1977 |
03 03 1947 |
While this repository is no longer actively maintained, the code is open and available for demonstration purposes or reuse. In addition to an end-to-end flow, it is an example of best-practice development for an API-driven, cloud-native frontend application.
The Claim Tax Benefits (CTB) application is a server-side express application using Pug templating on the server and schnazzy SCSS stylesheets. The application scaffolding comes from the express generator. It assumes the existence of a backend API (to receive user data) and a cloud database (for storing access codes), although both are stubbed out so the application can run in isolation for development purposes.
There is a record of the decision to go for Express, for posterity.
As mentioned in the introduction, the CTB application implements many recommended practices for a modern web service.
We use several third-party services for an improved development workflow and continuous security.
All new pull requests have a suite of automated tests run against them.
axe) to check for violations in the markupA walkthrough on how to continue development on this project: whether your aim is to rebuild the service in a new technology or to develop and release this codebase specifically.
npmnpm is a javascript package manager. It downloads project dependencies and runs node applications.
npm will complain if you’re not on node version v10.15.0 or higher when you boot up the app.
It’s possible to bootstrap this application with no /.env file — but if you want one, go nuts.
Guess what? There is no build step. Just install the dependencies and run it.
Pretty slick. 😎
# install dependencies
npm install
# run application in 'dev' mode
npm run dev
# run application in 'prod' mode
npm startThe app should be running at http://localhost:3005/. With npm run dev, saving a file will restart the server automatically.
On a Mac, press Control + C to quit the running application.
The application can be run with a local postgres database (otherwise, it falls back on a JSON file).
To start the app in development mode, alongside the postgres db type docker-compose up
Docker Desktop already has compose included, but just in case, installation instructions for docker-compose can be found here
# run unit tests
npm test
# run linting
npm run lint
# run end-to-end tests
npm run cypress
npm run cypress:cli # these don't open a browserCypress is what we use to write our end-to-end tests. It can run in a browser or in headless mode (ie, on the command line) to step through one or more flows. By running our end-to-end tests frequently, we are making sure that new changes to the code don't break existing user journeys.
dockerA docker container allows a developer to package up an application and all of its parts. This means we can build an app in any language, in any stack, and then run it anywhere — whether locally or on a server.
# build an image locally
docker build -t claimtaxbenefits.azurecr.io/cra-claim-tax-benefits .
# run the container
docker run -it -p 3005:3005 claimtaxbenefits.azurecr.io/cra-claim-tax-benefitsThe container should be running at http://localhost:3005/.
On a Mac, press Control + C to quit the running docker container.
This application is deployed continuously using Github Actions.
However, it’s still a beta service so it might not be 100% reliable. If anything goes wrong, follow the manual deployment instructions.
L’application Réclamation d’avantages fiscaux n’est pas autonome et nécessite un niveau élevé d’intégration de la part de l’ARC. Ce produit extrait les données sur l’individu à partir de la base de données de l’ARC, puis les affiche au déclarant. La communication entre le produit et la base de données de l’ARC se fait par l’intermédiaire d’une interface de programmation d’application (API). Cette technologie permet à un système de communiquer avec un autre système.
Une fois que le déclarant s’est authentifié, l’API envoie les données à l’application. Celle-ci demande ensuite au déclarant de confirmer que l’information affichée est exacte. La déclaration de revenus est ensuite produite au moyen de l’API IMPÔTNET, c’est-à-dire la même que celle utilisée par les logiciels payants.
Étant donné que l’ARC utilise des technologies héritées, il existe un degré de risque. Ce risque est atténué par le fait que le produit en ligne est hébergé sur une technologie en nuage, de sorte qu’il est séparé de la base de données. Cette séparation nous a permis de réaliser plusieurs prototypes pour différentes versions, sans mettre en péril les données de l’ARC. Si le produit était devenu un service fonctionnel, nous aurions pu continuer à modifier le service en fonction des commentaires des utilisateurs.
L’application Réclamation d’avantages fiscaux (RAF) est une application express côté serveur qui utilise les langages Pug pour les gabarits et SCSS pour les feuilles de styles. L’échafaudage de l’application vient du générateur d’applications Express. Il suppose l’existence d’une API backend (qui reçoit les données de l’utilisateur) et d’une base de données infonuagique (qui stocke les codes d’accès), bien que tous deux soient simulés afin que l’application puisse fonctionner de façon isolée pour le développement.
Le compte-rendu de la décision d’opter pour Express (anglais seulement) est conservé pour la postérité.
Comme il est mentionné dans l’introduction, l’application RAF met en œuvre plusieurs pratiques recommandées pour le développement de services Web modernes.
Nous utilisons plusieurs services tiers pour améliorer le déroulement du développement et de la sécurité continue.
Chaque demande de tirage subit une suite de tests automatisés.
Guide pour continuer le développement du produit : Ce guide est là pour vous aider si vous voulez reconstruire le service avec une nouvelle technologie ou si vous voulez développer et déployer le code.
Veuillez vous référer à la page README afin d’obtenir les instructions détaillées pour construire et exécuter l’application.