feat: Initial commit.

project/.gitignore

@@ -0,0 +1,6 @@
+.build/*
+Report.pdf
+Report.html
+Report.tex
+Airflow/*.pdf
+ManJ/*.pdf

project/README.md

@@ -0,0 +1,27 @@
+# Home Performance Assessment
+
+This is a system airflow assessment project, where files are stored to generate the report.
+
+## TODO
+
+### While on site at customers home
+
+- [ ] Get equipment photos
+- [ ] Perform TrueFlow report and static pressure analysis
+  - Store in `Airflow` folder
+
+### Post site visit
+
+- [ ] Generate TrueFlow forecast reports.
+  - Store in `Airflow`
+  - [ ] Need screen shots of report and forecast for report template.
+    - Store as `img/trueflow.png` and `img/truflow-forecast.png`
+- [ ] Generate share / cloud storage for customer facing files / links needed in report
+  - Store final `Airflow` folder, `ManJ` folder, and `Report.pdf`
+  - [ ] Upload photos to cloud storage.
+- [ ] Fill out `Report.md` template.
+  - [ ] Update `vars.yml` and `vault.yml`
+- [ ] Generate `Report.pdf` from template.
+  - [ ] Review generated report.
+- [ ] Upload final `Report.pdf` to cloud storage
+- [ ] Send final `Report.pdf` to client

project/Report.md

@@ -0,0 +1,172 @@
+---
+title: '{{ document_title }}'
+author: '{{ author_name }}'
+date: \today{}
+mainfont: DejaVu Sans
+documentclass: article
+fontsize: 12pt
+# NOTE: The applegreen is a custom color defined in resources/head.tex
+linkcolor: applegreen
+urlcolor: applegreen
+abstract: |
+  **Prepared For:**
+
+  {{ customer.name }}
+
+  {{ customer.address.street }}
+  {{ customer.address.city }}, {{ customer.address.state }} {{ customer.address.zip }}
+
+    ```{=latex}
+    \begin{center}
+    ```
+    <!-- below are just forced line breaks -->
+    \
+    \
+    \
+
+  [![logo]({{ links.images.logo  }}){ width=30% }]({{ company.website }})
+
+    ```{=latex}
+    \end{center}
+    ```
+---
+
+<!-- NOTE: Table of contents section only needs changed if new sections are
+           added.
+-->
+
+# Contents
+
+1. [Introduction](#introduction)
+1. [Airflow Assessment](#airflow-assessment)
+   1. [Your Static Measurements](#your-static-measurements)
+   1. [Static Pressure Forecast](#static-measurements-forecast)
+1. [Summary](#summary)
+1. [Definitions](#definitions)
+   1. [IAQ]
+   1. [TESP]
+   1. [WC][wc]
+
+## Introduction
+
+Thank you for having us to your home for a system airflow assessment. I hope that it was beneficial. We learned a lot
+about your system during the brief visit. So, let’s jump in to some of the things discovered.
+
+Below is a summary of the system measurements and some recommendations. As part of the service we ran airflow test and
+forecasting.
+
+Once you read the report you’ll have 3 options: do nothing, pick and choose upgrades, or do more planning for more
+difficult goals or complex projects. These options are discussed at the end of the report as well as our leanings for
+your home.
+
+\newpage
+
+## Airflow Assessment
+
+While on site, we also measured the total system airflow and static pressure of the system. Static pressure is
+equivalent to the blood pressure of your system and gives us a better understanding of the overall ability for the
+system to provide the proper amount of airflow, as well as how much it may struggle to do so.
+
+Static pressure is the amount of resistance that the blower has to work against in order to move air through the system.
+Things that have an effect on the static pressure of the system include, air filters (size and type), duct sizes, amount
+of ducts, length of ducts, duct fittings and transitions, as well as internal system components. Each component of the
+system has a resistance associated with it that the blower has to overcome, by taking some key measurements we are able
+to determine the [TESP] of the system. While there are several static pressures in the system, when we talk about static
+pressure we are generally referring to [TESP].
+
+Static pressure ([TESP]) has a range of _low_, _acceptable_, or _high_. While these numbers are specific to the actual
+equipment, most manufacturers follow similar standards. For the sake of simplicity, 0.5" [wc] or under is an
+_acceptable_ target, 0.8" [wc] is generally the max acceptable static pressure (although we like to stay well below this
+if possible), and above 0.8" [wc] is considered _high_ and should be addressed. _Low_ is generally not common and is
+rarely problematic, so it is not focused on much.
+
+<!-- NOTE: Force a new page here, for images and sub-section heading to be on same page -->
+
+\newpage
+
+### Your Static Measurements
+
+![True Flow Report](img/trueflow.png){height=50%}
+
+<!-- WARNING: Summarize the static measurements here -->
+
+The above image is a snapshot of the static pressures recorded for your system. This shows that the static pressure of
+your system is very high (1.114" [wc]). The primary culprits for the high static pressure are that the filter is
+undersized for the airflow required and the return duct sizing is small.
+
+These measurements were taken in the heating mode because your system does not currently have air conditioning.
+Currently the heating airflow is on the low side for what is required for your system (1200 CFM would be ideal). This
+should be adjusted if possible during the install to get better performance and efficiency out of the system, given that
+some static pressures can be improved during the project.
+
+<!-- NOTE: Force a new page here, for images and sub-section heading to be on same page -->
+
+\newpage
+
+### Static Measurements Forecast
+
+![True Flow Forecast](img/trueflow-forecast.png){height=50%}
+
+<!-- WARNING: Summarize the forecast results below. -->
+
+The above image is a snapshot is of a forecast of the static pressures after adding air conditioning. It should be noted
+that these measurements are based solely on the airflow required for cooling mode, not for heating mode (in other words,
+heating mode is going to be higher because the airflow requirement is higher).
+
+This shows that with an upgraded filter we can get the static pressure below the 0.8" [wc] max target while in cooling
+mode.
+
+\newpage
+
+## Summary
+
+The purpose of the system airflow assessment is to help find the correct airflow or improvements
+that are required to increase the system longevity and efficiency.
+
+<!-- WARNING: Add summary here -->
+
+Regards,
+
+![](img/signature.png){width=20%; float=left}
+
+\
+\
+
+[Here is a link to all the documents][document-folder]
+
+> [!NOTE:]
+>
+> Documents are stored on our internal servers and links to your documents expire in approximately 30 days from the
+> creation of your report, for security reasons. We recommend that you download any documents you would like to keep for
+> your records. If you have troubles then we can send the documents via email or extend the expiration date of the
+> provided document links.
+
+<!-- prettier-ignore-start -->
+
+<!-- NOTE: These are reference links for short form linking in the document.
+           This allows all the links to be changed / updated in one place.
+           However most do not need updated unless sections are added, besides the
+           document links, which are defined / setup in vars.sh.
+-->
+
+[IAQ]: #iaq-definition "IAQ"
+[wc]: #wc-definition "wc"
+[TESP]: #tesp-definition "TESP"
+
+
+<!-- IMPORTANT: Take screen shots of the TrueFlow reports and add to the img
+                folder with names / path setup in vars.sh -->
+
+<!-- default is img/trueflow.png -->
+[trueflow-image]: 
+<!-- default is img/forecast.png -->
+[trueflow-forecast-image]: 
+
+<!-- IMPORTANT: These links need to be updated. -->
+
+[document-folder]: 
+<!-- prettier-ignore-end -->
+
+```
+
+```

project/justfile

@@ -0,0 +1,47 @@
+build_dir_name := ".build"
+dir_name := `basename $PWD`
+cloud_dir := "/mnt/customers"
+
+[private]
+default:
+  just --list
+
+# Builds and fills the templates into the .build directory.
+[group('build')]
+build:
+	@gum spin --title="Building project..." -- bash -xc "hpa build &>/dev/null"
+
+# Build & generate an HTML report.
+[group("generate")]
+html: 
+	@gum spin --title="Generating html..." -- bash -xc "hpa generate html &>/dev/null"
+	@xdg-open Report.html &
+
+# Build & generate a PDF report.
+[group("generate")]
+pdf:
+	@gum spin --title="Generating pdf..." -- bash -xc "hpa generate pdf &>/dev/null"
+	@pidof zathura &>/dev/null || xdg-open Report.pdf &
+
+# Copy files to cloud storage directory.
+[group("generate")]
+cloud-storage:
+	mkdir {{cloud_dir}}/{{dir_name}} &>/dev/null || true
+	cp -R Airflow {{cloud_dir}}/{{dir_name}}
+	cp -R ManJ {{cloud_dir}}/{{dir_name}}
+	[ -f Report.pdf ] && cp Report.pdf {{cloud_dir}}/{{dir_name}}
+
+# Build & generate a Latex file.
+[group("generate")]
+[group("debug")]
+latex:
+	@gum spin --title="Generating latex..." -- baxh -xc "hpa generate latex &>/dev/null"
+	@xdg-open Report.tex &
+
+[group('utilities')]
+edit-vault:
+  @hpa ansible-vault edit --vault-password /run/secrets/vault-pass vault.yml
+
+[group('utilities')]
+clean:
+  @rm -rf {{build_dir_name}}

project/vars.yml

@@ -0,0 +1,25 @@
+---
+
+# Stores variables related to the template directory, which is used
+# to setup projects and store commonly used files.
+#
+template:
+  path: /root/.local/share/hpa/template
+
+author_name: "{{ vault_author_name }}"
+
+company: "{{ vault_company }}"
+
+links:
+  images:
+    logo: "img/logo.png"
+    trueflow: "img/trueflow.png"
+    trueflow_forecast: "img/forecast.png"
+
+customer: "{{ vault_customer }}"
+
+# WARNING: Update these for the project.
+home:
+  square_feet: "3,000"
+  cfm50: "3,000"
+  lair: "1:1"

project/vault.yml

@@ -0,0 +1,16 @@
+$ANSIBLE_VAULT;1.2;AES256;consults
+36353833666438306363313239323865633538633061376534336139656536643034393564653964
+3665616466303038383663376136393463353361643461630a326530306330663130343639656630
+62623861376433333831326637303462636461366432386239323136323663343332613838346137
+3362616563353531650a323962356634316262343165616230346630386666313262333235303534
+63643430616430656233653936653263623937646333373339313430376131313435343464633136
+65333665396332393266383662336439616635383866616639313661613033393336363865633366
+33383935613962353831616235626166376336386235633130646461623939613131616265333730
+63343065313964353965343464396563313661633165363734636638313533653532623035346439
+36366536366438356162323264323862663265373931353338636235613764653966663964643739
+38356131306432646163323962333131343431336538373331646134333134326364613733356136
+65643466366635353038623335376435373030323265306362306239346130383662306537343733
+61323331656661653461373063353036383263626266663462353431313230363132303665613736
+33353564643938333832323061623132653532363939616238363537626537666233626335396136
+32346666363539306266313466303230646439646238656364653934366161313032626231646262
+366635313263326630303336366233366264