Welcome to the Central Engineering, Architecture & Operations Knowledge Portal for Armellini Air Express.
| Service | Description | Quick Link |
|---|---|---|
| Forgejo Git Server | Self-hosted Git repositories & CI/CD pipelines | Open Forgejo |
| Wiki.js Portal | Engineering documentation, API catalogs, & playbooks | Open Wiki.js |
| AAE Logistics App | Cargo operations, tariff calculation, & reconciliation | Repository: aae-app |
| Snowflake DW | Shipments, reconciliation, and audit logs | Internal Data Warehouse |
| Sage Intacct ERP | Financial accounting, vendor bills & customer ledger | Accounting Portal |
aae-app β Logistics & Carrier Portalβββ ποΈ System Architecture
β βββ Architecture Overview (Next.js 15, Firebase Admin, Snowflake, n8n)
β βββ Security Model & Firestore Rules
β βββ Multi-Cloud Data Flow (GCP + AWS + Snowflake)
β
βββ π API Reference & Endpoints
β βββ /api/tracking & /api/awb (Airway Bill Operations)
β βββ /api/reconcile (Carrier Invoice & JAF Matching)
β βββ /api/rates & /api/margin (Tariff Engine)
β βββ /api/rolodex (Contact Extraction & Search)
β
βββ πΌ Integrations & Third-Party APIs
β βββ Snowflake Analytics Integration
β βββ Sage Intacct Middleware & Bills
β βββ Google Drive Automated Uploads
β βββ Traze Logistics API
β
βββ π₯ Team Guidelines & Standards
βββ Developer Onboarding & Environment Setup
βββ Git Workflow & Branching Conventions
βββ Security, Secrets & Access Governance
git clone https://gitael.armellini.net/aelmark/aae-app.git
cd aae-app
npm install # or bun install
.env.example to .env.local..env, service-account*.json, or API secrets to Git.main Branch: Protected production branch. All changes must go through tested pull requests.feature/<description>, fix/<issue-id>, or refactor/<scope>.feat:, fix:, docs:, chore:).*.sync-conflict*) excluded via .gitignore.Maintained by the Armellini Air Express Engineering & Operations Team.