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