Glossary¶

A¶

API Version¶

Versioning strategy using URL prefixes (/api/v1/, /api/v2/) to support multiple response formats.

AsyncIO¶

Python library for writing concurrent code using async/await syntax.

B¶

Backend Module¶

Self-contained unit following Clean Architecture (domain, application, infrastructure, presentation layers).

Bearer Token¶

HTTP Authorization header format: Authorization: Bearer <token>

C¶

Clean Architecture¶

Software design separating concerns into layers: Domain, Application, Infrastructure, Presentation.

Context Manager¶

Python protocol for resource management with __enter__ and __exit__ methods.

Courier¶

User role with permissions to manage bags and mark shipments as delivered.

D¶

DTO (Data Transfer Object)¶

Object used to transfer data between layers, typically in application layer.

F¶

Fernet¶

Symmetric encryption method using AES-128-CBC with PBKDF2 for key derivation.

Flet¶

Python framework for building cross-platform applications (web, mobile, desktop).

J¶

JWT (JSON Web Token)¶

Compact, URL-safe token format for authentication containing claims like sub (user_id) and tenant_id.

M¶

Modular Monolith¶

Architecture combining modular design with a single deployment unit.

Multi-Tenancy¶

Architecture where a single instance serves multiple tenants with data isolation via RLS.

O¶

OAuth¶

Open standard for authorization, implemented for Google and GitHub login.

P¶

Pydantic¶

Python library for data validation using Python type annotations.

Protocol (Python)¶

Structural type system for defining interfaces without inheritance.

R¶

Rate Limiting¶

Technique to control request rate per user/IP/endpoint.

Refresh Token¶

Token used to obtain new access tokens, rotated on every use.

RLS (Row Level Security)¶

PostgreSQL feature enforcing tenant isolation at database level.

S¶

SQLModel¶

Library combining SQLAlchemy ORM with Pydantic validation.

SafeArea¶

Area respecting device safe areas (notch, home indicator).

T¶

Tenant¶

Organization/customer in the multi-tenant system.

Token Encryption¶

Fernet/AES encryption for tokens stored in SharedPreferences.

Tracking ID¶

Public identifier for shipments: format TRK-[A-Z0-9]{8}

U¶

UUID¶

Universally Unique Identifier used for primary keys.

W¶

WebSocket¶

Bidirectional communication protocol for real-time updates.

Workflow (Git)¶

Branching strategy: main → develop → feature/*