tuxware

An EFF package from a dispatcher arrives as a structured archive with a specific file naming convention and an XML manifest inside. If you want to understand what it actually contains — which documents are in it, how the folder tree is organised, what the metadata says about the flight — you need to know ARINC 633 well enough to parse it correctly.

The standard is long, and airlines use it differently: some follow it closely, others layer their own folder structures and document types on top. What a given operator's EFF looks like shows only when one is opened and walked through.

aviant does that. It ingests an EFF package, parses the eff.xml manifest, and presents the folder tree and documents in a navigable interface: useful for a new airline's EFF configuration, or when a parser misbehaves and the raw structure is needed without a throwaway script.

Technical details — ARINC 633 structure and API

EFF File Name Format

EFF file names follow a structured format defined in ARINC 633 Table 4.1.

Field	Description	Format	Example
`aircraftReg`	Registration number	`[A-Z0-9]+`	`N1234S`
`DELIMITER`	One underscore	`_`	`_`
`flightIdentification`	Flight ID (optional, 1–10 chars)	`[A-Z0-9]{1,10}`	`DLH234AB`
`DELIMITER`	One underscore	`_`	`_`
`departureDate`	Departure date	`YYMMDD`	`050823`
`DELIMITER`	One underscore	`_`	`_`
`departureAirport`	IATA (3) or ICAO (4) code	`XXX` / `XXXX`	`FRA`
`DELIMITER`	One underscore	`_`	`_`
`arrivalAirport`	IATA (3) or ICAO (4) code	`XXX` / `XXXX`	`JFK`
`EFF type`	Full or Update	`F` or `U`	`F`
`DATETIMESTAMP`	Creation timestamp	`YYMMDDHHMMSS`	`0508231741`
`FILE TYPE`	Extension	`.eff`	`.eff`

Example: N1234S_DLH234AB_050823_FRA_JFK_F0508231741.eff

EFF Folder Tree

The EFF viewer menu is derived from the eff.xml metadata tree, not from ZIP paths inside .dat archives.

Folder nodes map to SubFolder/@title
Document nodes map to Document/@title and resolve download targets via Document/@file
Root and nested namespaces are supported (EFUSUB, EFDREP, and prefixed tags)

Folder Tree API

GET /briefings/:id/folder-tree

Requires briefing-admin authentication. Response shape:

{
  "roots": [
    {
      "id": "...",
      "title": "...",
      "node_type": "folder",
      "children": [
        {
          "id": "...",
          "title": "...",
          "node_type": "document",
          "filename": "..."
        }
      ]
    }
  ]
}