Skip to content

Configuration ​

This page collects the operational configuration values used by the FreightTiger Pylon handoff and weekly analytics package.

Weekly Analytics Environment ​

Create .env in the report pipeline folder:

bash
PYLON_API_KEY=...

Optional publishing values are normally passed from the shell or secret manager:

bash
REPORT_PASSWORD=...
PAGES_PROJECT=ft-tms-weekly

Python Dependencies ​

The pipeline uses:

text
requests>=2.31
python-dotenv>=1.0
jinja2>=3.1
pyyaml>=6.0

Install with:

bash
.venv/bin/pip install -r requirements.txt

Report Config Files ​

FilePurpose
config/modules.ymlDisplay labels for tms_module slugs.
config/personas.ymlMaps owner labels to Account Managers, Engineering, and Product sections.
config/pylon_urls.ymlPylon account, ticket, tier, and module view URL templates.
config/sla_policy.ymlBug SLA hours, feature request SLA days, and priority-to-severity fallback.
config/tiers.ymlTier display order and colors.

Pylon Field Slugs ​

Account custom fields:

  • business_line_for_customer_account
  • account.hubspot.customer_tier
  • mrr
  • active_modules
  • csm_lead

Issue custom fields:

  • tms_request_type
  • tms_severity
  • tms_module
  • priority

Worker Secrets ​

Set in Cloudflare Workers:

bash
npx wrangler secret put PYLON_WEBHOOK_SECRET
npx wrangler secret put PYLON_API_TOKEN
npx wrangler secret put LINEAR_API_KEY

Worker Vars ​

Configured in pylon-linear-bridge/wrangler.toml:

VariablePurpose
LINEAR_TEAM_IDDefault Linear team.
LINEAR_LABEL_IDSOptional comma-separated label ids.
MODULE_TEAM_MAPJSON module-to-team mapping.

KV binding:

toml
[[kv_namespaces]]
binding = "DEDUP"
id = "..."
preview_id = "..."

Downloads ​

The site serves packaged archives from public/downloads/:

  • freighttiger-weekly-analytics-skill.tar.gz
  • freighttiger-knowledge-base-update-skill.tar.gz
  • freighttiger-weekly-analytics-pipeline.tar.gz

n8n ​

Do not publish n8n webhook UUID paths or Slack incoming webhook URLs in this documentation. Treat both as secrets.

Known workflow responsibilities:

  • Account auto-routing workflow.
  • Bug triage extraction workflow.

Secure handoff values to store outside this public docs tree:

  • Production n8n base URL.
  • Workflow names and export JSON.
  • Pylon trigger destinations for both webhook paths.
  • Pylon API credential owner and rotation process.
  • Slack webhook credential owner.
  • OpenAI/model credential owner.
  • Internal-user domain/list if true auto-response is added later.

FreightTiger Pylon setup, skills, and automations handoff