feature fix

.claude/CLAUDE.md

@@ -1,77 +1,77 @@
-# CLAUDE.md
+# CLAUDE.md
-
+
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
+
-## User Configuration Directory
+## User Configuration Directory
-
+
-This is the Claude Code configuration directory (`~/.claude`) containing user settings, project data, custom commands, and security configurations.
+This is the Claude Code configuration directory (`~/.claude`) containing user settings, project data, custom commands, and security configurations.
-
+
-## Security System
+## Security System
-
+
-The system includes a comprehensive security validation hook:
+The system includes a comprehensive security validation hook:
-
+
-- **Command Validation**: `/Users/david/.claude/scripts/validate-command.js` - A Bun-based security script that validates commands before execution
+- **Command Validation**: `/Users/david/.claude/scripts/validate-command.js` - A Bun-based security script that validates commands before execution
-- **Protected Operations**: Blocks dangerous commands like `rm -rf /`, system modifications, privilege escalation, network tools, and malicious patterns
+- **Protected Operations**: Blocks dangerous commands like `rm -rf /`, system modifications, privilege escalation, network tools, and malicious patterns
-- **Security Logging**: Events are logged to `/Users/melvynx/.claude/security.log` for audit trails
+- **Security Logging**: Events are logged to `/Users/melvynx/.claude/security.log` for audit trails
-- **Fail-Safe Design**: Script blocks execution on any validation errors or script failures
+- **Fail-Safe Design**: Script blocks execution on any validation errors or script failures
-
+
-The security system is automatically triggered by the PreToolUse hook configured in `settings.json`.
+The security system is automatically triggered by the PreToolUse hook configured in `settings.json`.
-
+
-## Custom Commands
+## Custom Commands
-
+
-Three workflow commands are available in the `/commands` directory:
+Three workflow commands are available in the `/commands` directory:
-
+
-### `/run-task` - Complete Feature Implementation
+### `/run-task` - Complete Feature Implementation
-Workflow for implementing features from requirements:
+Workflow for implementing features from requirements:
-1. Analyze file paths or GitHub issues (using `gh cli`)
+1. Analyze file paths or GitHub issues (using `gh cli`)
-2. Create implementation plan
+2. Create implementation plan
-3. Execute updates with TypeScript validation
+3. Execute updates with TypeScript validation
-4. Auto-commit changes
+4. Auto-commit changes
-5. Create pull request
+5. Create pull request
-
+
-### `/fix-pr-comments` - PR Comment Resolution
+### `/fix-pr-comments` - PR Comment Resolution
-Workflow for addressing pull request feedback:
+Workflow for addressing pull request feedback:
-1. Fetch unresolved comments using `gh cli`
+1. Fetch unresolved comments using `gh cli`
-2. Plan required modifications
+2. Plan required modifications
-3. Update files accordingly
+3. Update files accordingly
-4. Commit and push changes
+4. Commit and push changes
-
+
-### `/explore-and-plan` - EPCT Development Workflow
+### `/explore-and-plan` - EPCT Development Workflow
-Structured approach using parallel subagents:
+Structured approach using parallel subagents:
-1. **Explore**: Find and read relevant files
+1. **Explore**: Find and read relevant files
-2. **Plan**: Create detailed implementation plan with web research if needed
+2. **Plan**: Create detailed implementation plan with web research if needed
-3. **Code**: Implement following existing patterns and run autoformatting
+3. **Code**: Implement following existing patterns and run autoformatting
-4. **Test**: Execute tests and verify functionality
+4. **Test**: Execute tests and verify functionality
-5. Write up work as PR description
+5. Write up work as PR description
-
+
-## Status Line
+## Status Line
-
+
-Custom status line script (`statusline-ccusage.sh`) displays:
+Custom status line script (`statusline-ccusage.sh`) displays:
-- Git branch with pending changes (+added/-deleted lines)
+- Git branch with pending changes (+added/-deleted lines)
-- Current directory name
+- Current directory name
-- Model information
+- Model information
-- Session costs and daily usage (if `ccusage` tool available)
+- Session costs and daily usage (if `ccusage` tool available)
-- Active block costs and time remaining
+- Active block costs and time remaining
-- Token usage for current session
+- Token usage for current session
-
+
-## Hooks and Audio Feedback
+## Hooks and Audio Feedback
-
+
-- **Stop Hook**: Plays completion sound (`finish.mp3`) when tasks complete
+- **Stop Hook**: Plays completion sound (`finish.mp3`) when tasks complete
-- **Notification Hook**: Plays notification sound (`need-human.mp3`) for user interaction
+- **Notification Hook**: Plays notification sound (`need-human.mp3`) for user interaction
-- **Pre-tool Validation**: All Bash commands are validated by the security script
+- **Pre-tool Validation**: All Bash commands are validated by the security script
-
+
-## Project Data Structure
+## Project Data Structure
-
+
-- `projects/`: Contains conversation history in JSONL format organized by directory paths
+- `projects/`: Contains conversation history in JSONL format organized by directory paths
-- `todos/`: Agent-specific todo lists for task tracking
+- `todos/`: Agent-specific todo lists for task tracking
-- `shell-snapshots/`: Shell state snapshots for session management
+- `shell-snapshots/`: Shell state snapshots for session management
-- `statsig/`: Analytics and feature flagging data
+- `statsig/`: Analytics and feature flagging data
-
+
-## Permitted Commands
+## Permitted Commands
-
+
-The system allows specific command patterns without additional validation:
+The system allows specific command patterns without additional validation:
-- `git *` - All Git operations
+- `git *` - All Git operations
-- `npm run *` - NPM script execution
+- `npm run *` - NPM script execution
-- `pnpm *` - PNPM package manager
+- `pnpm *` - PNPM package manager
-- `gh *` - GitHub CLI operations
+- `gh *` - GitHub CLI operations
 - Standard file operations (`cd`, `ls`, `node`)

.claude/commands/explore-and-plan.md

@@ -1,36 +1,36 @@
----
+---
-description: Explore codebase, create implementation plan, code, and test following EPCT workflow
+description: Explore codebase, create implementation plan, code, and test following EPCT workflow
----
+---
-
+
-# Explore, Plan, Code, Test Workflow
+# Explore, Plan, Code, Test Workflow
-
+
-At the end of this message, I will ask you to do something.
+At the end of this message, I will ask you to do something.
-Please follow the "Explore, Plan, Code, Test" workflow when you start.
+Please follow the "Explore, Plan, Code, Test" workflow when you start.
-
+
-## Explore
+## Explore
-
+
-First, use parallel subagents to find and read all files that may be useful for implementing the ticket, either as examples or as edit targets. The subagents should return relevant file paths, and any other info that may be useful.
+First, use parallel subagents to find and read all files that may be useful for implementing the ticket, either as examples or as edit targets. The subagents should return relevant file paths, and any other info that may be useful.
-
+
-## Plan
+## Plan
-
+
-Next, think hard and write up a detailed implementation plan. Don't forget to include tests, lookbook components, and documentation. Use your judgement as to what is necessary, given the standards of this repo.
+Next, think hard and write up a detailed implementation plan. Don't forget to include tests, lookbook components, and documentation. Use your judgement as to what is necessary, given the standards of this repo.
-
+
-If there are things you are not sure about, use parallel subagents to do some web research. They should only return useful information, no noise.
+If there are things you are not sure about, use parallel subagents to do some web research. They should only return useful information, no noise.
-
+
-If there are things you still do not understand or questions you have for the user, pause here to ask them before continuing.
+If there are things you still do not understand or questions you have for the user, pause here to ask them before continuing.
-
+
-## Code
+## Code
-
+
-When you have a thorough implementation plan, you are ready to start writing code. Follow the style of the existing codebase (e.g. we prefer clearly named variables and methods to extensive comments). Make sure to run our autoformatting script when you're done, and fix linter warnings that seem reasonable to you.
+When you have a thorough implementation plan, you are ready to start writing code. Follow the style of the existing codebase (e.g. we prefer clearly named variables and methods to extensive comments). Make sure to run our autoformatting script when you're done, and fix linter warnings that seem reasonable to you.
-
+
-## Test
+## Test
-
+
-Use parallel subagents to run tests, and make sure they all pass.
+Use parallel subagents to run tests, and make sure they all pass.
-
+
-If your changes touch the UX in a major way, use the browser to make sure that everything works correctly. Make a list of what to test for, and use a subagent for this step.
+If your changes touch the UX in a major way, use the browser to make sure that everything works correctly. Make a list of what to test for, and use a subagent for this step.
-
+
-If your testing shows problems, go back to the planning stage and think ultrahard.
+If your testing shows problems, go back to the planning stage and think ultrahard.
-
+
-## Write up your work
+## Write up your work
-
+
 When you are happy with your work, write up a short report that could be used as the PR description. Include what you set out to do, the choices you made with their brief justification, and any commands you ran in the process that may be useful for future developers to know about.

.claude/commands/fix-pr-comments.md

@@ -1,10 +1,10 @@
----
+---
-description: Fetch all comments for the current pull request and fix them.
+description: Fetch all comments for the current pull request and fix them.
----
+---
-
+
-Workflow:
+Workflow:
-
+
-1. Use `gh cli` to fetch the comments that are NOT resolved from the pull request.
+1. Use `gh cli` to fetch the comments that are NOT resolved from the pull request.
-2. Define all the modifications you should actually make.
+2. Define all the modifications you should actually make.
-3. Act and update the files.
+3. Act and update the files.
 4. Create a commit and push.

.claude/commands/quick-commit.md

@@ -1,36 +1,36 @@
----
+---
-description: Quickly commit all changes with an auto-generated message
+description: Quickly commit all changes with an auto-generated message
----
+---
-
+
-Workflow for quick Git commits:
+Workflow for quick Git commits:
-
+
-1. Check git status to see what changes are present
+1. Check git status to see what changes are present
-2. Analyze changes to generate a short, clear commit message
+2. Analyze changes to generate a short, clear commit message
-3. Stage all changes (tracked and untracked files)
+3. Stage all changes (tracked and untracked files)
-4. Create the commit with DH7789-dev signature
+4. Create the commit with DH7789-dev signature
-5. Optionally push to remote if tracking branch exists
+5. Optionally push to remote if tracking branch exists
-
+
-The commit message will be automatically generated by analyzing:
+The commit message will be automatically generated by analyzing:
-- Modified files and their purposes (components, configs, tests, docs, etc.)
+- Modified files and their purposes (components, configs, tests, docs, etc.)
-- New files added and their function
+- New files added and their function
-- Deleted files and cleanup operations
+- Deleted files and cleanup operations
-- Overall scope of changes to determine action verb (add, update, fix, refactor, remove, etc.)
+- Overall scope of changes to determine action verb (add, update, fix, refactor, remove, etc.)
-
+
-Commit message format: `[action] [what was changed]`
+Commit message format: `[action] [what was changed]`
-Examples:
+Examples:
-- `add user authentication system`
+- `add user authentication system`
-- `fix navigation menu responsive issues`
+- `fix navigation menu responsive issues`
-- `update API endpoints configuration`
+- `update API endpoints configuration`
-- `refactor database connection logic`
+- `refactor database connection logic`
-- `remove deprecated utility functions`
+- `remove deprecated utility functions`
-
+
-This command is ideal for:
+This command is ideal for:
-- Quick iteration cycles
+- Quick iteration cycles
-- Work-in-progress commits
+- Work-in-progress commits
-- Feature development checkpoints
+- Feature development checkpoints
-- Bug fix commits
+- Bug fix commits
-
+
-The commit will include your custom signature:
+The commit will include your custom signature:
-```
+```
-Signed-off-by: DH7789-dev
+Signed-off-by: DH7789-dev
 ```

.claude/commands/run-task.md

@@ -1,21 +1,21 @@
----
+---
-description: Run a task
+description: Run a task
----
+---
-
+
-For the given $ARGUMENTS you need to get the information about the tasks you need to do :
+For the given $ARGUMENTS you need to get the information about the tasks you need to do :
-
+
-- If it's a file path, get the path to get the instructions and the feature we want to create
+- If it's a file path, get the path to get the instructions and the feature we want to create
-- If it's an issues number or URL, fetch the issues to get the information (with `gh cli`)
+- If it's an issues number or URL, fetch the issues to get the information (with `gh cli`)
-
+
-1. Start to make a plan about how to make the feature
+1. Start to make a plan about how to make the feature
-   You need to fetch all the files needed and more, find what to update, think like a real engineer that will check everything to prepare the best plan.
+   You need to fetch all the files needed and more, find what to update, think like a real engineer that will check everything to prepare the best plan.
-
+
-2. Make the update
+2. Make the update
-   Update the files according to your plan.
+   Update the files according to your plan.
-   Auto correct yourself with TypeScript. Run TypeScript check and find a way everything is clean and working.
+   Auto correct yourself with TypeScript. Run TypeScript check and find a way everything is clean and working.
-
+
-3. Commit the changes
+3. Commit the changes
-   Commit directly your updates.
+   Commit directly your updates.
-
+
-4. Create a pull request
+4. Create a pull request
-   Create a perfect pull request with all the data needed to review your code.
+   Create a perfect pull request with all the data needed to review your code.

.claude/plugins/config.json

@@ -1,3 +1,3 @@
-{
+{
-  "repositories": {}
+  "repositories": {}
 }

.claude/scripts/validate-command.js

@@ -1,424 +1,424 @@
-#!/usr/bin/env bun
+#!/usr/bin/env bun
-
+
-/**
+/**
- * Claude Code "Before Tools" Hook - Command Validation Script
+ * Claude Code "Before Tools" Hook - Command Validation Script
- *
+ *
- * This script validates commands before execution to prevent harmful operations.
+ * This script validates commands before execution to prevent harmful operations.
- * It receives command data via stdin and returns exit code 0 (allow) or 1 (block).
+ * It receives command data via stdin and returns exit code 0 (allow) or 1 (block).
- *
+ *
- * Usage: Called automatically by Claude Code PreToolUse hook
+ * Usage: Called automatically by Claude Code PreToolUse hook
- * Manual test: echo '{"tool_name":"Bash","tool_input":{"command":"rm -rf /"}}' | bun validate-command.js
+ * Manual test: echo '{"tool_name":"Bash","tool_input":{"command":"rm -rf /"}}' | bun validate-command.js
- */
+ */
-
+
-// Comprehensive dangerous command patterns database
+// Comprehensive dangerous command patterns database
-const SECURITY_RULES = {
+const SECURITY_RULES = {
-  // Critical system destruction commands
+  // Critical system destruction commands
-  CRITICAL_COMMANDS: [
+  CRITICAL_COMMANDS: [
-    "del",
+    "del",
-    "format",
+    "format",
-    "mkfs",
+    "mkfs",
-    "shred",
+    "shred",
-    "dd",
+    "dd",
-    "fdisk",
+    "fdisk",
-    "parted",
+    "parted",
-    "gparted",
+    "gparted",
-    "cfdisk",
+    "cfdisk",
-  ],
+  ],
-
+
-  // Privilege escalation and system access
+  // Privilege escalation and system access
-  PRIVILEGE_COMMANDS: [
+  PRIVILEGE_COMMANDS: [
-    "sudo",
+    "sudo",
-    "su",
+    "su",
-    "passwd",
+    "passwd",
-    "chpasswd",
+    "chpasswd",
-    "usermod",
+    "usermod",
-    "chmod",
+    "chmod",
-    "chown",
+    "chown",
-    "chgrp",
+    "chgrp",
-    "setuid",
+    "setuid",
-    "setgid",
+    "setgid",
-  ],
+  ],
-
+
-  // Network and remote access tools
+  // Network and remote access tools
-  NETWORK_COMMANDS: [
+  NETWORK_COMMANDS: [
-    "nc",
+    "nc",
-    "netcat",
+    "netcat",
-    "nmap",
+    "nmap",
-    "telnet",
+    "telnet",
-    "ssh-keygen",
+    "ssh-keygen",
-    "iptables",
+    "iptables",
-    "ufw",
+    "ufw",
-    "firewall-cmd",
+    "firewall-cmd",
-    "ipfw",
+    "ipfw",
-  ],
+  ],
-
+
-  // System service and process manipulation
+  // System service and process manipulation
-  SYSTEM_COMMANDS: [
+  SYSTEM_COMMANDS: [
-    "systemctl",
+    "systemctl",
-    "service",
+    "service",
-    "kill",
+    "kill",
-    "killall",
+    "killall",
-    "pkill",
+    "pkill",
-    "mount",
+    "mount",
-    "umount",
+    "umount",
-    "swapon",
+    "swapon",
-    "swapoff",
+    "swapoff",
-  ],
+  ],
-
+
-  // Dangerous regex patterns
+  // Dangerous regex patterns
-  DANGEROUS_PATTERNS: [
+  DANGEROUS_PATTERNS: [
-    // File system destruction - block rm -rf with absolute paths
+    // File system destruction - block rm -rf with absolute paths
-    /rm\s+.*-rf\s*\/\s*$/i, // rm -rf ending at root directory
+    /rm\s+.*-rf\s*\/\s*$/i, // rm -rf ending at root directory
-    /rm\s+.*-rf\s*\/\w+/i, // rm -rf with any absolute path
+    /rm\s+.*-rf\s*\/\w+/i, // rm -rf with any absolute path
-    /rm\s+.*-rf\s*\/etc/i, // rm -rf in /etc
+    /rm\s+.*-rf\s*\/etc/i, // rm -rf in /etc
-    /rm\s+.*-rf\s*\/usr/i, // rm -rf in /usr
+    /rm\s+.*-rf\s*\/usr/i, // rm -rf in /usr
-    /rm\s+.*-rf\s*\/bin/i, // rm -rf in /bin
+    /rm\s+.*-rf\s*\/bin/i, // rm -rf in /bin
-    /rm\s+.*-rf\s*\/sys/i, // rm -rf in /sys
+    /rm\s+.*-rf\s*\/sys/i, // rm -rf in /sys
-    /rm\s+.*-rf\s*\/proc/i, // rm -rf in /proc
+    /rm\s+.*-rf\s*\/proc/i, // rm -rf in /proc
-    /rm\s+.*-rf\s*\/boot/i, // rm -rf in /boot
+    /rm\s+.*-rf\s*\/boot/i, // rm -rf in /boot
-    /rm\s+.*-rf\s*\/home\/[^\/]*\s*$/i, // rm -rf entire home directory
+    /rm\s+.*-rf\s*\/home\/[^\/]*\s*$/i, // rm -rf entire home directory
-    /rm\s+.*-rf\s*\.\.+\//i, // rm -rf with parent directory traversal
+    /rm\s+.*-rf\s*\.\.+\//i, // rm -rf with parent directory traversal
-    /rm\s+.*-rf\s*\*.*\*/i, // rm -rf with multiple wildcards
+    /rm\s+.*-rf\s*\*.*\*/i, // rm -rf with multiple wildcards
-    /rm\s+.*-rf\s*\$\w+/i, // rm -rf with variables (could be dangerous)
+    /rm\s+.*-rf\s*\$\w+/i, // rm -rf with variables (could be dangerous)
-    />\s*\/dev\/(sda|hda|nvme)/i,
+    />\s*\/dev\/(sda|hda|nvme)/i,
-    /dd\s+.*of=\/dev\//i,
+    /dd\s+.*of=\/dev\//i,
-    /shred\s+.*\/dev\//i,
+    /shred\s+.*\/dev\//i,
-    /mkfs\.\w+\s+\/dev\//i,
+    /mkfs\.\w+\s+\/dev\//i,
-
+
-    // Fork bomb and resource exhaustion
+    // Fork bomb and resource exhaustion
-    /:\(\)\{\s*:\|:&\s*\};:/,
+    /:\(\)\{\s*:\|:&\s*\};:/,
-    /while\s+true\s*;\s*do.*done/i,
+    /while\s+true\s*;\s*do.*done/i,
-    /for\s*\(\(\s*;\s*;\s*\)\)/i,
+    /for\s*\(\(\s*;\s*;\s*\)\)/i,
-
+
-    // Command injection and chaining
+    // Command injection and chaining
-    /;\s*(rm|dd|mkfs|format)/i,
+    /;\s*(rm|dd|mkfs|format)/i,
-    /&&\s*(rm|dd|mkfs|format)/i,
+    /&&\s*(rm|dd|mkfs|format)/i,
-    /\|\|\s*(rm|dd|mkfs|format)/i,
+    /\|\|\s*(rm|dd|mkfs|format)/i,
-
+
-    // Remote code execution
+    // Remote code execution
-    /\|\s*(sh|bash|zsh|fish)$/i,
+    /\|\s*(sh|bash|zsh|fish)$/i,
-    /(wget|curl)\s+.*\|\s*(sh|bash)/i,
+    /(wget|curl)\s+.*\|\s*(sh|bash)/i,
-    /(wget|curl)\s+.*-O-.*\|\s*(sh|bash)/i,
+    /(wget|curl)\s+.*-O-.*\|\s*(sh|bash)/i,
-
+
-    // Command substitution with dangerous commands
+    // Command substitution with dangerous commands
-    /`.*rm.*`/i,
+    /`.*rm.*`/i,
-    /\$\(.*rm.*\)/i,
+    /\$\(.*rm.*\)/i,
-    /`.*dd.*`/i,
+    /`.*dd.*`/i,
-    /\$\(.*dd.*\)/i,
+    /\$\(.*dd.*\)/i,
-
+
-    // Sensitive file access
+    // Sensitive file access
-    /cat\s+\/etc\/(passwd|shadow|sudoers)/i,
+    /cat\s+\/etc\/(passwd|shadow|sudoers)/i,
-    />\s*\/etc\/(passwd|shadow|sudoers)/i,
+    />\s*\/etc\/(passwd|shadow|sudoers)/i,
-    /echo\s+.*>>\s*\/etc\/(passwd|shadow|sudoers)/i,
+    /echo\s+.*>>\s*\/etc\/(passwd|shadow|sudoers)/i,
-
+
-    // Network exfiltration
+    // Network exfiltration
-    /\|\s*nc\s+\S+\s+\d+/i,
+    /\|\s*nc\s+\S+\s+\d+/i,
-    /curl\s+.*-d.*\$\(/i,
+    /curl\s+.*-d.*\$\(/i,
-    /wget\s+.*--post-data.*\$\(/i,
+    /wget\s+.*--post-data.*\$\(/i,
-
+
-    // Log manipulation
+    // Log manipulation
-    />\s*\/var\/log\//i,
+    />\s*\/var\/log\//i,
-    /rm\s+\/var\/log\//i,
+    /rm\s+\/var\/log\//i,
-    /echo\s+.*>\s*~?\/?\.bash_history/i,
+    /echo\s+.*>\s*~?\/?\.bash_history/i,
-
+
-    // Backdoor creation
+    // Backdoor creation
-    /nc\s+.*-l.*-e/i,
+    /nc\s+.*-l.*-e/i,
-    /nc\s+.*-e.*-l/i,
+    /nc\s+.*-e.*-l/i,
-    /ncat\s+.*--exec/i,
+    /ncat\s+.*--exec/i,
-    /ssh-keygen.*authorized_keys/i,
+    /ssh-keygen.*authorized_keys/i,
-
+
-    // Crypto mining and malicious downloads
+    // Crypto mining and malicious downloads
-    /(wget|curl).*\.(sh|py|pl|exe|bin).*\|\s*(sh|bash|python)/i,
+    /(wget|curl).*\.(sh|py|pl|exe|bin).*\|\s*(sh|bash|python)/i,
-    /(xmrig|ccminer|cgminer|bfgminer)/i,
+    /(xmrig|ccminer|cgminer|bfgminer)/i,
-
+
-    // Hardware direct access
+    // Hardware direct access
-    /cat\s+\/dev\/(mem|kmem)/i,
+    /cat\s+\/dev\/(mem|kmem)/i,
-    /echo\s+.*>\s*\/dev\/(mem|kmem)/i,
+    /echo\s+.*>\s*\/dev\/(mem|kmem)/i,
-
+
-    // Kernel module manipulation
+    // Kernel module manipulation
-    /(insmod|rmmod|modprobe)\s+/i,
+    /(insmod|rmmod|modprobe)\s+/i,
-
+
-    // Cron job manipulation
+    // Cron job manipulation
-    /crontab\s+-e/i,
+    /crontab\s+-e/i,
-    /echo\s+.*>>\s*\/var\/spool\/cron/i,
+    /echo\s+.*>>\s*\/var\/spool\/cron/i,
-
+
-    // Environment variable exposure
+    // Environment variable exposure
-    /env\s*\|\s*grep.*PASSWORD/i,
+    /env\s*\|\s*grep.*PASSWORD/i,
-    /printenv.*PASSWORD/i,
+    /printenv.*PASSWORD/i,
-  ],
+  ],
-
+
-
+
-  // Paths that should never be written to
+  // Paths that should never be written to
-  PROTECTED_PATHS: [
+  PROTECTED_PATHS: [
-    "/etc/",
+    "/etc/",
-    "/usr/",
+    "/usr/",
-    "/bin/",
+    "/bin/",
-    "/sbin/",
+    "/sbin/",
-    "/boot/",
+    "/boot/",
-    "/sys/",
+    "/sys/",
-    "/proc/",
+    "/proc/",
-    "/dev/",
+    "/dev/",
-    "/root/",
+    "/root/",
-  ],
+  ],
-};
+};
-
+
-// Allowlist of safe commands (when used appropriately)
+// Allowlist of safe commands (when used appropriately)
-const SAFE_COMMANDS = [
+const SAFE_COMMANDS = [
-  "ls",
+  "ls",
-  "dir",
+  "dir",
-  "pwd",
+  "pwd",
-  "whoami",
+  "whoami",
-  "date",
+  "date",
-  "echo",
+  "echo",
-  "cat",
+  "cat",
-  "head",
+  "head",
-  "tail",
+  "tail",
-  "grep",
+  "grep",
-  "find",
+  "find",
-  "wc",
+  "wc",
-  "sort",
+  "sort",
-  "uniq",
+  "uniq",
-  "cut",
+  "cut",
-  "awk",
+  "awk",
-  "sed",
+  "sed",
-  "git",
+  "git",
-  "npm",
+  "npm",
-  "pnpm",
+  "pnpm",
-  "node",
+  "node",
-  "bun",
+  "bun",
-  "python",
+  "python",
-  "pip",
+  "pip",
-  "cd",
+  "cd",
-  "cp",
+  "cp",
-  "mv",
+  "mv",
-  "mkdir",
+  "mkdir",
-  "touch",
+  "touch",
-  "ln",
+  "ln",
-];
+];
-
+
-class CommandValidator {
+class CommandValidator {
-  constructor() {
+  constructor() {
-    this.logFile = "/Users/david/.claude/security.log";
+    this.logFile = "/Users/david/.claude/security.log";
-  }
+  }
-
+
-  /**
+  /**
-   * Main validation function
+   * Main validation function
-   */
+   */
-  validate(command, toolName = "Unknown") {
+  validate(command, toolName = "Unknown") {
-    const result = {
+    const result = {
-      isValid: true,
+      isValid: true,
-      severity: "LOW",
+      severity: "LOW",
-      violations: [],
+      violations: [],
-      sanitizedCommand: command,
+      sanitizedCommand: command,
-    };
+    };
-
+
-    if (!command || typeof command !== "string") {
+    if (!command || typeof command !== "string") {
-      result.isValid = false;
+      result.isValid = false;
-      result.violations.push("Invalid command format");
+      result.violations.push("Invalid command format");
-      return result;
+      return result;
-    }
+    }
-
+
-    // Normalize command for analysis
+    // Normalize command for analysis
-    const normalizedCmd = command.trim().toLowerCase();
+    const normalizedCmd = command.trim().toLowerCase();
-    const cmdParts = normalizedCmd.split(/\s+/);
+    const cmdParts = normalizedCmd.split(/\s+/);
-    const mainCommand = cmdParts[0];
+    const mainCommand = cmdParts[0];
-
+
-    // Check against critical commands
+    // Check against critical commands
-    if (SECURITY_RULES.CRITICAL_COMMANDS.includes(mainCommand)) {
+    if (SECURITY_RULES.CRITICAL_COMMANDS.includes(mainCommand)) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "CRITICAL";
+      result.severity = "CRITICAL";
-      result.violations.push(`Critical dangerous command: ${mainCommand}`);
+      result.violations.push(`Critical dangerous command: ${mainCommand}`);
-    }
+    }
-
+
-    // Check privilege escalation commands
+    // Check privilege escalation commands
-    if (SECURITY_RULES.PRIVILEGE_COMMANDS.includes(mainCommand)) {
+    if (SECURITY_RULES.PRIVILEGE_COMMANDS.includes(mainCommand)) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "HIGH";
+      result.severity = "HIGH";
-      result.violations.push(`Privilege escalation command: ${mainCommand}`);
+      result.violations.push(`Privilege escalation command: ${mainCommand}`);
-    }
+    }
-
+
-    // Check network commands
+    // Check network commands
-    if (SECURITY_RULES.NETWORK_COMMANDS.includes(mainCommand)) {
+    if (SECURITY_RULES.NETWORK_COMMANDS.includes(mainCommand)) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "HIGH";
+      result.severity = "HIGH";
-      result.violations.push(`Network/remote access command: ${mainCommand}`);
+      result.violations.push(`Network/remote access command: ${mainCommand}`);
-    }
+    }
-
+
-    // Check system commands
+    // Check system commands
-    if (SECURITY_RULES.SYSTEM_COMMANDS.includes(mainCommand)) {
+    if (SECURITY_RULES.SYSTEM_COMMANDS.includes(mainCommand)) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "HIGH";
+      result.severity = "HIGH";
-      result.violations.push(`System manipulation command: ${mainCommand}`);
+      result.violations.push(`System manipulation command: ${mainCommand}`);
-    }
+    }
-
+
-    // Check dangerous patterns
+    // Check dangerous patterns
-    for (const pattern of SECURITY_RULES.DANGEROUS_PATTERNS) {
+    for (const pattern of SECURITY_RULES.DANGEROUS_PATTERNS) {
-      if (pattern.test(command)) {
+      if (pattern.test(command)) {
-        result.isValid = false;
+        result.isValid = false;
-        result.severity = "CRITICAL";
+        result.severity = "CRITICAL";
-        result.violations.push(`Dangerous pattern detected: ${pattern.source}`);
+        result.violations.push(`Dangerous pattern detected: ${pattern.source}`);
-      }
+      }
-    }
+    }
-
+
-
+
-    // Check for protected path access (but allow common redirections like /dev/null)
+    // Check for protected path access (but allow common redirections like /dev/null)
-    for (const path of SECURITY_RULES.PROTECTED_PATHS) {
+    for (const path of SECURITY_RULES.PROTECTED_PATHS) {
-      if (command.includes(path)) {
+      if (command.includes(path)) {
-        // Allow common safe redirections
+        // Allow common safe redirections
-        if (path === "/dev/" && (command.includes("/dev/null") || command.includes("/dev/stderr") || command.includes("/dev/stdout"))) {
+        if (path === "/dev/" && (command.includes("/dev/null") || command.includes("/dev/stderr") || command.includes("/dev/stdout"))) {
-          continue;
+          continue;
-        }
+        }
-        result.isValid = false;
+        result.isValid = false;
-        result.severity = "HIGH";
+        result.severity = "HIGH";
-        result.violations.push(`Access to protected path: ${path}`);
+        result.violations.push(`Access to protected path: ${path}`);
-      }
+      }
-    }
+    }
-
+
-    // Additional safety checks
+    // Additional safety checks
-    if (command.length > 2000) {
+    if (command.length > 2000) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "MEDIUM";
+      result.severity = "MEDIUM";
-      result.violations.push("Command too long (potential buffer overflow)");
+      result.violations.push("Command too long (potential buffer overflow)");
-    }
+    }
-
+
-    // Check for binary/encoded content
+    // Check for binary/encoded content
-    if (/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\xFF]/.test(command)) {
+    if (/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\xFF]/.test(command)) {
-      result.isValid = false;
+      result.isValid = false;
-      result.severity = "HIGH";
+      result.severity = "HIGH";
-      result.violations.push("Binary or encoded content detected");
+      result.violations.push("Binary or encoded content detected");
-    }
+    }
-
+
-    return result;
+    return result;
-  }
+  }
-
+
-
+
-  /**
+  /**
-   * Log security events
+   * Log security events
-   */
+   */
-  async logSecurityEvent(command, toolName, result, sessionId = null) {
+  async logSecurityEvent(command, toolName, result, sessionId = null) {
-    const timestamp = new Date().toISOString();
+    const timestamp = new Date().toISOString();
-    const logEntry = {
+    const logEntry = {
-      timestamp,
+      timestamp,
-      sessionId,
+      sessionId,
-      toolName,
+      toolName,
-      command: command.substring(0, 500), // Truncate for logs
+      command: command.substring(0, 500), // Truncate for logs
-      blocked: !result.isValid,
+      blocked: !result.isValid,
-      severity: result.severity,
+      severity: result.severity,
-      violations: result.violations,
+      violations: result.violations,
-      source: "claude-code-hook",
+      source: "claude-code-hook",
-    };
+    };
-
+
-    try {
+    try {
-      // Write to log file
+      // Write to log file
-      const logLine = JSON.stringify(logEntry) + "\n";
+      const logLine = JSON.stringify(logEntry) + "\n";
-      await Bun.write(this.logFile, logLine, { createPath: true, flag: "a" });
+      await Bun.write(this.logFile, logLine, { createPath: true, flag: "a" });
-
+
-      // Also output to stderr for immediate visibility
+      // Also output to stderr for immediate visibility
-      console.error(
+      console.error(
-        `[SECURITY] ${
+        `[SECURITY] ${
-          result.isValid ? "ALLOWED" : "BLOCKED"
+          result.isValid ? "ALLOWED" : "BLOCKED"
-        }: ${command.substring(0, 100)}`
+        }: ${command.substring(0, 100)}`
-      );
+      );
-    } catch (error) {
+    } catch (error) {
-      console.error("Failed to write security log:", error);
+      console.error("Failed to write security log:", error);
-    }
+    }
-  }
+  }
-
+
-  /**
+  /**
-   * Check if command matches any allowed patterns from settings
+   * Check if command matches any allowed patterns from settings
-   */
+   */
-  isExplicitlyAllowed(command, allowedPatterns = []) {
+  isExplicitlyAllowed(command, allowedPatterns = []) {
-    for (const pattern of allowedPatterns) {
+    for (const pattern of allowedPatterns) {
-      // Convert Claude Code permission pattern to regex
+      // Convert Claude Code permission pattern to regex
-      // e.g., "Bash(git *)" becomes /^git\s+.*$/
+      // e.g., "Bash(git *)" becomes /^git\s+.*$/
-      if (pattern.startsWith("Bash(") && pattern.endsWith(")")) {
+      if (pattern.startsWith("Bash(") && pattern.endsWith(")")) {
-        const cmdPattern = pattern.slice(5, -1); // Remove "Bash(" and ")"
+        const cmdPattern = pattern.slice(5, -1); // Remove "Bash(" and ")"
-        const regex = new RegExp(
+        const regex = new RegExp(
-          "^" + cmdPattern.replace(/\*/g, ".*") + "$",
+          "^" + cmdPattern.replace(/\*/g, ".*") + "$",
-          "i"
+          "i"
-        );
+        );
-        if (regex.test(command)) {
+        if (regex.test(command)) {
-          return true;
+          return true;
-        }
+        }
-      }
+      }
-    }
+    }
-    return false;
+    return false;
-  }
+  }
-}
+}
-
+
-/**
+/**
- * Main execution function
+ * Main execution function
- */
+ */
-async function main() {
+async function main() {
-  const validator = new CommandValidator();
+  const validator = new CommandValidator();
-
+
-  try {
+  try {
-    // Read hook input from stdin
+    // Read hook input from stdin
-    const stdin = process.stdin;
+    const stdin = process.stdin;
-    const chunks = [];
+    const chunks = [];
-
+
-    for await (const chunk of stdin) {
+    for await (const chunk of stdin) {
-      chunks.push(chunk);
+      chunks.push(chunk);
-    }
+    }
-
+
-    const input = Buffer.concat(chunks).toString();
+    const input = Buffer.concat(chunks).toString();
-
+
-    if (!input.trim()) {
+    if (!input.trim()) {
-      console.error("No input received from stdin");
+      console.error("No input received from stdin");
-      process.exit(1);
+      process.exit(1);
-    }
+    }
-
+
-    // Parse Claude Code hook JSON format
+    // Parse Claude Code hook JSON format
-    let hookData;
+    let hookData;
-    try {
+    try {
-      hookData = JSON.parse(input);
+      hookData = JSON.parse(input);
-    } catch (error) {
+    } catch (error) {
-      console.error("Invalid JSON input:", error.message);
+      console.error("Invalid JSON input:", error.message);
-      process.exit(1);
+      process.exit(1);
-    }
+    }
-
+
-    const toolName = hookData.tool_name || "Unknown";
+    const toolName = hookData.tool_name || "Unknown";
-    const toolInput = hookData.tool_input || {};
+    const toolInput = hookData.tool_input || {};
-    const sessionId = hookData.session_id || null;
+    const sessionId = hookData.session_id || null;
-
+
-    // Only validate Bash commands for now
+    // Only validate Bash commands for now
-    if (toolName !== "Bash") {
+    if (toolName !== "Bash") {
-      console.log(`Skipping validation for tool: ${toolName}`);
+      console.log(`Skipping validation for tool: ${toolName}`);
-      process.exit(0);
+      process.exit(0);
-    }
+    }
-
+
-    const command = toolInput.command;
+    const command = toolInput.command;
-    if (!command) {
+    if (!command) {
-      console.error("No command found in tool input");
+      console.error("No command found in tool input");
-      process.exit(1);
+      process.exit(1);
-    }
+    }
-
+
-    // Validate the command
+    // Validate the command
-    const result = validator.validate(command, toolName);
+    const result = validator.validate(command, toolName);
-
+
-    // Log the security event
+    // Log the security event
-    await validator.logSecurityEvent(command, toolName, result, sessionId);
+    await validator.logSecurityEvent(command, toolName, result, sessionId);
-
+
-    // Output result and exit with appropriate code
+    // Output result and exit with appropriate code
-    if (result.isValid) {
+    if (result.isValid) {
-      console.log("Command validation passed");
+      console.log("Command validation passed");
-      process.exit(0); // Allow execution
+      process.exit(0); // Allow execution
-    } else {
+    } else {
-      console.error(
+      console.error(
-        `Command validation failed: ${result.violations.join(", ")}`
+        `Command validation failed: ${result.violations.join(", ")}`
-      );
+      );
-      console.error(`Severity: ${result.severity}`);
+      console.error(`Severity: ${result.severity}`);
-      process.exit(2); // Block execution (Claude Code requires exit code 2)
+      process.exit(2); // Block execution (Claude Code requires exit code 2)
-    }
+    }
-  } catch (error) {
+  } catch (error) {
-    console.error("Validation script error:", error);
+    console.error("Validation script error:", error);
-    // Fail safe - block execution on any script error
+    // Fail safe - block execution on any script error
-    process.exit(2);
+    process.exit(2);
-  }
+  }
-}
+}
-
+
-// Execute main function
+// Execute main function
-main().catch((error) => {
+main().catch((error) => {
-  console.error("Fatal error:", error);
+  console.error("Fatal error:", error);
-  process.exit(2);
+  process.exit(2);
-});
+});

.claude/settings.json

@@ -1,63 +1,63 @@
-{
+{
-  "permissions": {
+  "permissions": {
-    "allow": [
+    "allow": [
-      "Edit",
+      "Edit",
-      "Bash(npm run :*)",
+      "Bash(npm run :*)",
-      "Bash(git :*)",
+      "Bash(git :*)",
-      "Bash(pnpm :*)",
+      "Bash(pnpm :*)",
-      "Bash(gh :*)",
+      "Bash(gh :*)",
-      "Bash(cd :*)",
+      "Bash(cd :*)",
-      "Bash(ls :*)",
+      "Bash(ls :*)",
-      "Bash(node :*)",
+      "Bash(node :*)",
-      "Bash(mkdir:*)",
+      "Bash(mkdir:*)",
-      "Bash(npm init:*)",
+      "Bash(npm init:*)",
-      "Bash(npm install:*)",
+      "Bash(npm install:*)",
-      "Bash(node:*)",
+      "Bash(node:*)",
-      "Bash(npm --version)",
+      "Bash(npm --version)",
-      "Bash(docker:*)",
+      "Bash(docker:*)",
-      "Bash(test:*)",
+      "Bash(test:*)",
-      "Bash(cat:*)",
+      "Bash(cat:*)",
-      "Bash(npm run build:*)"
+      "Bash(npm run build:*)"
-    ]
+    ]
-  },
+  },
-  "statusLine": {
+  "statusLine": {
-    "type": "command",
+    "type": "command",
-    "command": "bash /Users/david/.claude/statusline-ccusage.sh",
+    "command": "bash /Users/david/.claude/statusline-ccusage.sh",
-    "padding": 0
+    "padding": 0
-  },
+  },
-  "hooks": {
+  "hooks": {
-    "PreToolUse": [
+    "PreToolUse": [
-      {
+      {
-        "matcher": "Bash",
+        "matcher": "Bash",
-        "hooks": [
+        "hooks": [
-          {
+          {
-            "type": "command",
+            "type": "command",
-            "command": "bun /Users/david/.claude/scripts/validate-command.js"
+            "command": "bun /Users/david/.claude/scripts/validate-command.js"
-          }
+          }
-        ]
+        ]
-      }
+      }
-    ],
+    ],
-    "Stop": [
+    "Stop": [
-      {
+      {
-        "matcher": "",
+        "matcher": "",
-        "hooks": [
+        "hooks": [
-          {
+          {
-            "type": "command",
+            "type": "command",
-            "command": "afplay /Users/david/.claude/song/finish.mp3"
+            "command": "afplay /Users/david/.claude/song/finish.mp3"
-          }
+          }
-        ]
+        ]
-      }
+      }
-    ],
+    ],
-    "Notification": [
+    "Notification": [
-      {
+      {
-        "matcher": "",
+        "matcher": "",
-        "hooks": [
+        "hooks": [
-          {
+          {
-            "type": "command",
+            "type": "command",
-            "command": "afplay /Users/david/.claude/song/need-human.mp3"
+            "command": "afplay /Users/david/.claude/song/need-human.mp3"
-          }
+          }
-        ]
+        ]
-      }
+      }
-    ]
+    ]
-  }
+  }
 }

.claude/settings.local.json

@@ -15,7 +15,20 @@
       "Bash(chmod:*)",
       "Bash(netstat -ano)",
       "Bash(findstr \":5432\")",
-      "Bash(findstr \"LISTENING\")"
+      "Bash(findstr \"LISTENING\")",
+      "Read(//Volumes/**)",
+      "Bash(find:*)",
+      "Bash(cd:*)",
+      "Bash(npm run migration:run:*)",
+      "Bash(mv:*)",
+      "Bash(curl:*)",
+      "Bash(npm run dev:*)",
+      "Bash(python3:*)",
+      "Bash(bash:*)",
+      "Bash(npm rebuild:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(PGPASSWORD=xpeditis_password psql -h localhost -p 5432 -U xpeditis -d xpeditis_db -c \"SELECT id FROM organizations WHERE type = ''FREIGHT_FORWARDER'' LIMIT 1;\")",
+      "Bash(PGPASSWORD=xpeditis_dev_password psql -h localhost -p 5432 -U xpeditis -d xpeditis_dev -c \"SELECT id, name FROM organizations WHERE type = ''FREIGHT_FORWARDER'' LIMIT 1;\")"
     ],
     "deny": [],
     "ask": []

.claude/statusline-ccusage.sh

@@ -1,194 +1,194 @@
-#!/bin/bash
+#!/bin/bash
-
+
-# ANSI color codes
+# ANSI color codes
-GREEN='\033[0;32m'
+GREEN='\033[0;32m'
-RED='\033[0;31m'
+RED='\033[0;31m'
-PURPLE='\033[0;35m'
+PURPLE='\033[0;35m'
-GRAY='\033[0;90m'
+GRAY='\033[0;90m'
-LIGHT_GRAY='\033[0;37m'
+LIGHT_GRAY='\033[0;37m'
-RESET='\033[0m'
+RESET='\033[0m'
-
+
-# Read JSON input from stdin
+# Read JSON input from stdin
-input=$(cat)
+input=$(cat)
-
+
-# Extract current session ID and model info from Claude Code input
+# Extract current session ID and model info from Claude Code input
-session_id=$(echo "$input" | jq -r '.session_id // empty')
+session_id=$(echo "$input" | jq -r '.session_id // empty')
-model_name=$(echo "$input" | jq -r '.model.display_name // empty')
+model_name=$(echo "$input" | jq -r '.model.display_name // empty')
-current_dir=$(echo "$input" | jq -r '.workspace.current_dir // empty')
+current_dir=$(echo "$input" | jq -r '.workspace.current_dir // empty')
-cwd=$(echo "$input" | jq -r '.cwd // empty')
+cwd=$(echo "$input" | jq -r '.cwd // empty')
-
+
-# Get current git branch with error handling
+# Get current git branch with error handling
-if git rev-parse --git-dir >/dev/null 2>&1; then
+if git rev-parse --git-dir >/dev/null 2>&1; then
-    branch=$(git branch --show-current 2>/dev/null || echo "detached")
+    branch=$(git branch --show-current 2>/dev/null || echo "detached")
-    if [ -z "$branch" ]; then
+    if [ -z "$branch" ]; then
-        branch="detached"
+        branch="detached"
-    fi
+    fi
-    
+    
-    # Check for pending changes (staged or unstaged)
+    # Check for pending changes (staged or unstaged)
-    if ! git diff-index --quiet HEAD -- 2>/dev/null || ! git diff-index --quiet --cached HEAD -- 2>/dev/null; then
+    if ! git diff-index --quiet HEAD -- 2>/dev/null || ! git diff-index --quiet --cached HEAD -- 2>/dev/null; then
-        # Get line changes for unstaged and staged changes
+        # Get line changes for unstaged and staged changes
-        unstaged_stats=$(git diff --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
+        unstaged_stats=$(git diff --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
-        staged_stats=$(git diff --cached --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
+        staged_stats=$(git diff --cached --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
-        
+        
-        # Parse the stats
+        # Parse the stats
-        unstaged_added=$(echo $unstaged_stats | cut -d' ' -f1)
+        unstaged_added=$(echo $unstaged_stats | cut -d' ' -f1)
-        unstaged_deleted=$(echo $unstaged_stats | cut -d' ' -f2)
+        unstaged_deleted=$(echo $unstaged_stats | cut -d' ' -f2)
-        staged_added=$(echo $staged_stats | cut -d' ' -f1)
+        staged_added=$(echo $staged_stats | cut -d' ' -f1)
-        staged_deleted=$(echo $staged_stats | cut -d' ' -f2)
+        staged_deleted=$(echo $staged_stats | cut -d' ' -f2)
-        
+        
-        # Total changes
+        # Total changes
-        total_added=$((unstaged_added + staged_added))
+        total_added=$((unstaged_added + staged_added))
-        total_deleted=$((unstaged_deleted + staged_deleted))
+        total_deleted=$((unstaged_deleted + staged_deleted))
-        
+        
-        # Build the branch display with changes (with colors)
+        # Build the branch display with changes (with colors)
-        changes=""
+        changes=""
-        if [ $total_added -gt 0 ]; then
+        if [ $total_added -gt 0 ]; then
-            changes="${GREEN}+$total_added${RESET}"
+            changes="${GREEN}+$total_added${RESET}"
-        fi
+        fi
-        if [ $total_deleted -gt 0 ]; then
+        if [ $total_deleted -gt 0 ]; then
-            if [ -n "$changes" ]; then
+            if [ -n "$changes" ]; then
-                changes="$changes ${RED}-$total_deleted${RESET}"
+                changes="$changes ${RED}-$total_deleted${RESET}"
-            else
+            else
-                changes="${RED}-$total_deleted${RESET}"
+                changes="${RED}-$total_deleted${RESET}"
-            fi
+            fi
-        fi
+        fi
-        
+        
-        if [ -n "$changes" ]; then
+        if [ -n "$changes" ]; then
-            branch="$branch${PURPLE}*${RESET} ($changes)"
+            branch="$branch${PURPLE}*${RESET} ($changes)"
-        else
+        else
-            branch="$branch${PURPLE}*${RESET}"
+            branch="$branch${PURPLE}*${RESET}"
-        fi
+        fi
-    fi
+    fi
-else
+else
-    branch="no-git"
+    branch="no-git"
-fi
+fi
-
+
-# Get basename of current directory
+# Get basename of current directory
-dir_name=$(basename "$current_dir")
+dir_name=$(basename "$current_dir")
-
+
-# Get today's date in YYYYMMDD format
+# Get today's date in YYYYMMDD format
-today=$(date +%Y%m%d)
+today=$(date +%Y%m%d)
-
+
-# Function to format numbers
+# Function to format numbers
-format_cost() {
+format_cost() {
-    printf "%.2f" "$1"
+    printf "%.2f" "$1"
-}
+}
-
+
-format_tokens() {
+format_tokens() {
-    local tokens=$1
+    local tokens=$1
-    if [ "$tokens" -ge 1000000 ]; then
+    if [ "$tokens" -ge 1000000 ]; then
-        printf "%.1fM" "$(echo "scale=1; $tokens / 1000000" | bc -l)"
+        printf "%.1fM" "$(echo "scale=1; $tokens / 1000000" | bc -l)"
-    elif [ "$tokens" -ge 1000 ]; then
+    elif [ "$tokens" -ge 1000 ]; then
-        printf "%.1fK" "$(echo "scale=1; $tokens / 1000" | bc -l)"
+        printf "%.1fK" "$(echo "scale=1; $tokens / 1000" | bc -l)"
-    else
+    else
-        printf "%d" "$tokens"
+        printf "%d" "$tokens"
-    fi
+    fi
-}
+}
-
+
-format_time() {
+format_time() {
-    local minutes=$1
+    local minutes=$1
-    local hours=$((minutes / 60))
+    local hours=$((minutes / 60))
-    local mins=$((minutes % 60))
+    local mins=$((minutes % 60))
-    if [ "$hours" -gt 0 ]; then
+    if [ "$hours" -gt 0 ]; then
-        printf "%dh %dm" "$hours" "$mins"
+        printf "%dh %dm" "$hours" "$mins"
-    else
+    else
-        printf "%dm" "$mins"
+        printf "%dm" "$mins"
-    fi
+    fi
-}
+}
-
+
-# Initialize variables with defaults
+# Initialize variables with defaults
-session_cost="0.00"
+session_cost="0.00"
-session_tokens=0
+session_tokens=0
-daily_cost="0.00"
+daily_cost="0.00"
-block_cost="0.00"
+block_cost="0.00"
-remaining_time="N/A"
+remaining_time="N/A"
-
+
-# Get current session data by finding the session JSONL file
+# Get current session data by finding the session JSONL file
-if command -v ccusage >/dev/null 2>&1 && [ -n "$session_id" ] && [ "$session_id" != "empty" ]; then
+if command -v ccusage >/dev/null 2>&1 && [ -n "$session_id" ] && [ "$session_id" != "empty" ]; then
-    # Look for the session JSONL file in Claude project directories
+    # Look for the session JSONL file in Claude project directories
-    session_jsonl_file=""
+    session_jsonl_file=""
-    
+    
-    # Check common Claude paths
+    # Check common Claude paths
-    claude_paths=(
+    claude_paths=(
-        "$HOME/.config/claude"
+        "$HOME/.config/claude"
-        "$HOME/.claude"
+        "$HOME/.claude"
-    )
+    )
-    
+    
-    for claude_path in "${claude_paths[@]}"; do
+    for claude_path in "${claude_paths[@]}"; do
-        if [ -d "$claude_path/projects" ]; then
+        if [ -d "$claude_path/projects" ]; then
-            # Use find to search for the session file
+            # Use find to search for the session file
-            session_jsonl_file=$(find "$claude_path/projects" -name "${session_id}.jsonl" -type f 2>/dev/null | head -1)
+            session_jsonl_file=$(find "$claude_path/projects" -name "${session_id}.jsonl" -type f 2>/dev/null | head -1)
-            if [ -n "$session_jsonl_file" ]; then
+            if [ -n "$session_jsonl_file" ]; then
-                break
+                break
-            fi
+            fi
-        fi
+        fi
-    done
+    done
-    
+    
-    # Parse the session file if found
+    # Parse the session file if found
-    if [ -n "$session_jsonl_file" ] && [ -f "$session_jsonl_file" ]; then
+    if [ -n "$session_jsonl_file" ] && [ -f "$session_jsonl_file" ]; then
-        # Count lines and estimate cost (simple approximation)
+        # Count lines and estimate cost (simple approximation)
-        # Each line is a usage entry, we can count tokens and estimate
+        # Each line is a usage entry, we can count tokens and estimate
-        session_tokens=0
+        session_tokens=0
-        session_entries=0
+        session_entries=0
-        
+        
-        while IFS= read -r line; do
+        while IFS= read -r line; do
-            if [ -n "$line" ]; then
+            if [ -n "$line" ]; then
-                session_entries=$((session_entries + 1))
+                session_entries=$((session_entries + 1))
-                # Extract token usage from message.usage field (only count input + output tokens)
+                # Extract token usage from message.usage field (only count input + output tokens)
-                # Cache tokens shouldn't be added up as they're reused/shared across messages
+                # Cache tokens shouldn't be added up as they're reused/shared across messages
-                input_tokens=$(echo "$line" | jq -r '.message.usage.input_tokens // 0' 2>/dev/null || echo "0")
+                input_tokens=$(echo "$line" | jq -r '.message.usage.input_tokens // 0' 2>/dev/null || echo "0")
-                output_tokens=$(echo "$line" | jq -r '.message.usage.output_tokens // 0' 2>/dev/null || echo "0")
+                output_tokens=$(echo "$line" | jq -r '.message.usage.output_tokens // 0' 2>/dev/null || echo "0")
-                
+                
-                line_tokens=$((input_tokens + output_tokens))
+                line_tokens=$((input_tokens + output_tokens))
-                session_tokens=$((session_tokens + line_tokens))
+                session_tokens=$((session_tokens + line_tokens))
-            fi
+            fi
-        done < "$session_jsonl_file"
+        done < "$session_jsonl_file"
-        
+        
-        # Use ccusage statusline to get the accurate cost for this session
+        # Use ccusage statusline to get the accurate cost for this session
-        ccusage_statusline=$(echo "$input" | ccusage statusline 2>/dev/null)
+        ccusage_statusline=$(echo "$input" | ccusage statusline 2>/dev/null)
-        current_session_cost=$(echo "$ccusage_statusline" | sed -n 's/.*💰 \([^[:space:]]*\) session.*/\1/p')
+        current_session_cost=$(echo "$ccusage_statusline" | sed -n 's/.*💰 \([^[:space:]]*\) session.*/\1/p')
-        
+        
-        if [ -n "$current_session_cost" ] && [ "$current_session_cost" != "N/A" ]; then
+        if [ -n "$current_session_cost" ] && [ "$current_session_cost" != "N/A" ]; then
-            session_cost=$(echo "$current_session_cost" | sed 's/\$//g')
+            session_cost=$(echo "$current_session_cost" | sed 's/\$//g')
-        fi
+        fi
-    fi
+    fi
-fi
+fi
-
+
-if command -v ccusage >/dev/null 2>&1; then
+if command -v ccusage >/dev/null 2>&1; then
-    # Get daily data
+    # Get daily data
-    daily_data=$(ccusage daily --json --since "$today" 2>/dev/null)
+    daily_data=$(ccusage daily --json --since "$today" 2>/dev/null)
-    if [ $? -eq 0 ] && [ -n "$daily_data" ]; then
+    if [ $? -eq 0 ] && [ -n "$daily_data" ]; then
-        daily_cost=$(echo "$daily_data" | jq -r '.totals.totalCost // 0')
+        daily_cost=$(echo "$daily_data" | jq -r '.totals.totalCost // 0')
-    fi
+    fi
-    
+    
-    # Get active block data
+    # Get active block data
-    block_data=$(ccusage blocks --active --json 2>/dev/null)
+    block_data=$(ccusage blocks --active --json 2>/dev/null)
-    if [ $? -eq 0 ] && [ -n "$block_data" ]; then
+    if [ $? -eq 0 ] && [ -n "$block_data" ]; then
-        active_block=$(echo "$block_data" | jq -r '.blocks[] | select(.isActive == true) // empty')
+        active_block=$(echo "$block_data" | jq -r '.blocks[] | select(.isActive == true) // empty')
-        if [ -n "$active_block" ] && [ "$active_block" != "null" ]; then
+        if [ -n "$active_block" ] && [ "$active_block" != "null" ]; then
-            block_cost=$(echo "$active_block" | jq -r '.costUSD // 0')
+            block_cost=$(echo "$active_block" | jq -r '.costUSD // 0')
-            remaining_minutes=$(echo "$active_block" | jq -r '.projection.remainingMinutes // 0')
+            remaining_minutes=$(echo "$active_block" | jq -r '.projection.remainingMinutes // 0')
-            if [ "$remaining_minutes" != "0" ] && [ "$remaining_minutes" != "null" ]; then
+            if [ "$remaining_minutes" != "0" ] && [ "$remaining_minutes" != "null" ]; then
-                remaining_time=$(format_time "$remaining_minutes")
+                remaining_time=$(format_time "$remaining_minutes")
-            fi
+            fi
-        fi
+        fi
-    fi
+    fi
-fi
+fi
-
+
-# Format the output
+# Format the output
-formatted_session_cost=$(format_cost "$session_cost")
+formatted_session_cost=$(format_cost "$session_cost")
-formatted_daily_cost=$(format_cost "$daily_cost")
+formatted_daily_cost=$(format_cost "$daily_cost")
-formatted_block_cost=$(format_cost "$block_cost")
+formatted_block_cost=$(format_cost "$block_cost")
-formatted_tokens=$(format_tokens "$session_tokens")
+formatted_tokens=$(format_tokens "$session_tokens")
-
+
-# Build the status line with colors (light gray as default)
+# Build the status line with colors (light gray as default)
-status_line="${LIGHT_GRAY}🌿 $branch ${GRAY}|${LIGHT_GRAY} 📁 $dir_name ${GRAY}|${LIGHT_GRAY} 🤖 $model_name ${GRAY}|${LIGHT_GRAY} 💰 \$$formatted_session_cost ${GRAY}/${LIGHT_GRAY} 📅 \$$formatted_daily_cost ${GRAY}/${LIGHT_GRAY} 🧊 \$$formatted_block_cost"
+status_line="${LIGHT_GRAY}🌿 $branch ${GRAY}|${LIGHT_GRAY} 📁 $dir_name ${GRAY}|${LIGHT_GRAY} 🤖 $model_name ${GRAY}|${LIGHT_GRAY} 💰 \$$formatted_session_cost ${GRAY}/${LIGHT_GRAY} 📅 \$$formatted_daily_cost ${GRAY}/${LIGHT_GRAY} 🧊 \$$formatted_block_cost"
-
+
-if [ "$remaining_time" != "N/A" ]; then
+if [ "$remaining_time" != "N/A" ]; then
-    status_line="$status_line ($remaining_time left)"
+    status_line="$status_line ($remaining_time left)"
-fi
+fi
-
+
-status_line="$status_line ${GRAY}|${LIGHT_GRAY} 🧩 ${formatted_tokens} ${GRAY}tokens${RESET}"
+status_line="$status_line ${GRAY}|${LIGHT_GRAY} 🧩 ${formatted_tokens} ${GRAY}tokens${RESET}"
-
+
-printf "%b\n" "$status_line"
+printf "%b\n" "$status_line"
-
+

.github/workflows/ci.yml

@@ -1,199 +1,199 @@
-name: CI
+name: CI
-
+
-on:
+on:
-  push:
+  push:
-    branches: [main, dev]
+    branches: [main, dev]
-  pull_request:
+  pull_request:
-    branches: [main, dev]
+    branches: [main, dev]
-
+
-jobs:
+jobs:
-  lint-and-format:
+  lint-and-format:
-    name: Lint & Format Check
+    name: Lint & Format Check
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+
-    steps:
+    steps:
-      - name: Checkout code
+      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4
-
+
-      - name: Setup Node.js
+      - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v4
-        with:
+        with:
-          node-version: '20'
+          node-version: '20'
-          cache: 'npm'
+          cache: 'npm'
-
+
-      - name: Install dependencies
+      - name: Install dependencies
-        run: npm ci
+        run: npm ci
-
+
-      - name: Run Prettier check
+      - name: Run Prettier check
-        run: npm run format:check
+        run: npm run format:check
-
+
-      - name: Lint backend
+      - name: Lint backend
-        run: npm run backend:lint --workspace=apps/backend
+        run: npm run backend:lint --workspace=apps/backend
-
+
-      - name: Lint frontend
+      - name: Lint frontend
-        run: npm run frontend:lint --workspace=apps/frontend
+        run: npm run frontend:lint --workspace=apps/frontend
-
+
-  test-backend:
+  test-backend:
-    name: Test Backend
+    name: Test Backend
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+
-    services:
+    services:
-      postgres:
+      postgres:
-        image: postgres:15-alpine
+        image: postgres:15-alpine
-        env:
+        env:
-          POSTGRES_USER: xpeditis_test
+          POSTGRES_USER: xpeditis_test
-          POSTGRES_PASSWORD: xpeditis_test
+          POSTGRES_PASSWORD: xpeditis_test
-          POSTGRES_DB: xpeditis_test
+          POSTGRES_DB: xpeditis_test
-        options: >-
+        options: >-
-          --health-cmd pg_isready
+          --health-cmd pg_isready
-          --health-interval 10s
+          --health-interval 10s
-          --health-timeout 5s
+          --health-timeout 5s
-          --health-retries 5
+          --health-retries 5
-        ports:
+        ports:
-          - 5432:5432
+          - 5432:5432
-
+
-      redis:
+      redis:
-        image: redis:7-alpine
+        image: redis:7-alpine
-        options: >-
+        options: >-
-          --health-cmd "redis-cli ping"
+          --health-cmd "redis-cli ping"
-          --health-interval 10s
+          --health-interval 10s
-          --health-timeout 5s
+          --health-timeout 5s
-          --health-retries 5
+          --health-retries 5
-        ports:
+        ports:
-          - 6379:6379
+          - 6379:6379
-
+
-    steps:
+    steps:
-      - name: Checkout code
+      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4
-
+
-      - name: Setup Node.js
+      - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v4
-        with:
+        with:
-          node-version: '20'
+          node-version: '20'
-          cache: 'npm'
+          cache: 'npm'
-
+
-      - name: Install dependencies
+      - name: Install dependencies
-        run: npm ci
+        run: npm ci
-
+
-      - name: Run backend unit tests
+      - name: Run backend unit tests
-        working-directory: apps/backend
+        working-directory: apps/backend
-        env:
+        env:
-          NODE_ENV: test
+          NODE_ENV: test
-          DATABASE_HOST: localhost
+          DATABASE_HOST: localhost
-          DATABASE_PORT: 5432
+          DATABASE_PORT: 5432
-          DATABASE_USER: xpeditis_test
+          DATABASE_USER: xpeditis_test
-          DATABASE_PASSWORD: xpeditis_test
+          DATABASE_PASSWORD: xpeditis_test
-          DATABASE_NAME: xpeditis_test
+          DATABASE_NAME: xpeditis_test
-          REDIS_HOST: localhost
+          REDIS_HOST: localhost
-          REDIS_PORT: 6379
+          REDIS_PORT: 6379
-          REDIS_PASSWORD: ''
+          REDIS_PASSWORD: ''
-          JWT_SECRET: test-jwt-secret
+          JWT_SECRET: test-jwt-secret
-        run: npm run test
+        run: npm run test
-
+
-      - name: Run backend E2E tests
+      - name: Run backend E2E tests
-        working-directory: apps/backend
+        working-directory: apps/backend
-        env:
+        env:
-          NODE_ENV: test
+          NODE_ENV: test
-          DATABASE_HOST: localhost
+          DATABASE_HOST: localhost
-          DATABASE_PORT: 5432
+          DATABASE_PORT: 5432
-          DATABASE_USER: xpeditis_test
+          DATABASE_USER: xpeditis_test
-          DATABASE_PASSWORD: xpeditis_test
+          DATABASE_PASSWORD: xpeditis_test
-          DATABASE_NAME: xpeditis_test
+          DATABASE_NAME: xpeditis_test
-          REDIS_HOST: localhost
+          REDIS_HOST: localhost
-          REDIS_PORT: 6379
+          REDIS_PORT: 6379
-          REDIS_PASSWORD: ''
+          REDIS_PASSWORD: ''
-          JWT_SECRET: test-jwt-secret
+          JWT_SECRET: test-jwt-secret
-        run: npm run test:e2e
+        run: npm run test:e2e
-
+
-      - name: Upload backend coverage
+      - name: Upload backend coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v3
-        with:
+        with:
-          files: ./apps/backend/coverage/lcov.info
+          files: ./apps/backend/coverage/lcov.info
-          flags: backend
+          flags: backend
-          name: backend-coverage
+          name: backend-coverage
-
+
-  test-frontend:
+  test-frontend:
-    name: Test Frontend
+    name: Test Frontend
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-
+
-    steps:
+    steps:
-      - name: Checkout code
+      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4
-
+
-      - name: Setup Node.js
+      - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v4
-        with:
+        with:
-          node-version: '20'
+          node-version: '20'
-          cache: 'npm'
+          cache: 'npm'
-
+
-      - name: Install dependencies
+      - name: Install dependencies
-        run: npm ci
+        run: npm ci
-
+
-      - name: Run frontend tests
+      - name: Run frontend tests
-        working-directory: apps/frontend
+        working-directory: apps/frontend
-        run: npm run test
+        run: npm run test
-
+
-      - name: Upload frontend coverage
+      - name: Upload frontend coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v3
-        with:
+        with:
-          files: ./apps/frontend/coverage/lcov.info
+          files: ./apps/frontend/coverage/lcov.info
-          flags: frontend
+          flags: frontend
-          name: frontend-coverage
+          name: frontend-coverage
-
+
-  build-backend:
+  build-backend:
-    name: Build Backend
+    name: Build Backend
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-    needs: [lint-and-format, test-backend]
+    needs: [lint-and-format, test-backend]
-
+
-    steps:
+    steps:
-      - name: Checkout code
+      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4
-
+
-      - name: Setup Node.js
+      - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v4
-        with:
+        with:
-          node-version: '20'
+          node-version: '20'
-          cache: 'npm'
+          cache: 'npm'
-
+
-      - name: Install dependencies
+      - name: Install dependencies
-        run: npm ci
+        run: npm ci
-
+
-      - name: Build backend
+      - name: Build backend
-        working-directory: apps/backend
+        working-directory: apps/backend
-        run: npm run build
+        run: npm run build
-
+
-      - name: Upload build artifacts
+      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v4
-        with:
+        with:
-          name: backend-dist
+          name: backend-dist
-          path: apps/backend/dist
+          path: apps/backend/dist
-
+
-  build-frontend:
+  build-frontend:
-    name: Build Frontend
+    name: Build Frontend
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest
-    needs: [lint-and-format, test-frontend]
+    needs: [lint-and-format, test-frontend]
-
+
-    steps:
+    steps:
-      - name: Checkout code
+      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v4
-
+
-      - name: Setup Node.js
+      - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v4
-        with:
+        with:
-          node-version: '20'
+          node-version: '20'
-          cache: 'npm'
+          cache: 'npm'
-
+
-      - name: Install dependencies
+      - name: Install dependencies
-        run: npm ci
+        run: npm ci
-
+
-      - name: Build frontend
+      - name: Build frontend
-        working-directory: apps/frontend
+        working-directory: apps/frontend
-        env:
+        env:
-          NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL || 'http://localhost:4000' }}
+          NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL || 'http://localhost:4000' }}
-        run: npm run build
+        run: npm run build
-
+
-      - name: Upload build artifacts
+      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v4
-        with:
+        with:
-          name: frontend-build
+          name: frontend-build
-          path: apps/frontend/.next
+          path: apps/frontend/.next

PHASE-1-PROGRESS.md

@@ -1,408 +1,408 @@
-# Phase 1 Progress Report - Core Search & Carrier Integration
+# Phase 1 Progress Report - Core Search & Carrier Integration
-
+
-**Status**: Sprint 1-2 Complete (Week 3-4) ✅
+**Status**: Sprint 1-2 Complete (Week 3-4) ✅
-**Next**: Sprint 3-4 (Week 5-6) - Infrastructure Layer
+**Next**: Sprint 3-4 (Week 5-6) - Infrastructure Layer
-**Overall Progress**: 25% of Phase 1 (2/8 weeks)
+**Overall Progress**: 25% of Phase 1 (2/8 weeks)
-
+
----
+---
-
+
-## ✅ Sprint 1-2 Complete: Domain Layer & Port Definitions (2 weeks)
+## ✅ Sprint 1-2 Complete: Domain Layer & Port Definitions (2 weeks)
-
+
-### Week 3: Domain Entities & Value Objects ✅
+### Week 3: Domain Entities & Value Objects ✅
-
+
-#### Domain Entities (6 files)
+#### Domain Entities (6 files)
-
+
-All entities follow **hexagonal architecture** principles:
+All entities follow **hexagonal architecture** principles:
-- ✅ Zero external dependencies
+- ✅ Zero external dependencies
-- ✅ Pure TypeScript
+- ✅ Pure TypeScript
-- ✅ Rich business logic
+- ✅ Rich business logic
-- ✅ Immutable value objects
+- ✅ Immutable value objects
-- ✅ Factory methods for creation
+- ✅ Factory methods for creation
-
+
-1. **[Organization](apps/backend/src/domain/entities/organization.entity.ts)** (202 lines)
+1. **[Organization](apps/backend/src/domain/entities/organization.entity.ts)** (202 lines)
-   - Organization types: FREIGHT_FORWARDER, CARRIER, SHIPPER
+   - Organization types: FREIGHT_FORWARDER, CARRIER, SHIPPER
-   - SCAC code validation (4 uppercase letters)
+   - SCAC code validation (4 uppercase letters)
-   - Document management
+   - Document management
-   - Business rule: Only carriers can have SCAC codes
+   - Business rule: Only carriers can have SCAC codes
-
+
-2. **[User](apps/backend/src/domain/entities/user.entity.ts)** (210 lines)
+2. **[User](apps/backend/src/domain/entities/user.entity.ts)** (210 lines)
-   - RBAC roles: ADMIN, MANAGER, USER, VIEWER
+   - RBAC roles: ADMIN, MANAGER, USER, VIEWER
-   - Email validation
+   - Email validation
-   - 2FA support (TOTP)
+   - 2FA support (TOTP)
-   - Password management
+   - Password management
-   - Business rules: Email must be unique, role-based permissions
+   - Business rules: Email must be unique, role-based permissions
-
+
-3. **[Carrier](apps/backend/src/domain/entities/carrier.entity.ts)** (164 lines)
+3. **[Carrier](apps/backend/src/domain/entities/carrier.entity.ts)** (164 lines)
-   - Carrier metadata (name, code, SCAC, logo)
+   - Carrier metadata (name, code, SCAC, logo)
-   - API configuration (baseUrl, credentials, timeout, circuit breaker)
+   - API configuration (baseUrl, credentials, timeout, circuit breaker)
-   - Business rule: Carriers with API support must have API config
+   - Business rule: Carriers with API support must have API config
-
+
-4. **[Port](apps/backend/src/domain/entities/port.entity.ts)** (192 lines)
+4. **[Port](apps/backend/src/domain/entities/port.entity.ts)** (192 lines)
-   - UN/LOCODE validation (5 characters: CC + LLL)
+   - UN/LOCODE validation (5 characters: CC + LLL)
-   - Coordinates (latitude/longitude)
+   - Coordinates (latitude/longitude)
-   - Timezone support
+   - Timezone support
-   - Haversine distance calculation
+   - Haversine distance calculation
-   - Business rule: Port codes must follow UN/LOCODE format
+   - Business rule: Port codes must follow UN/LOCODE format
-
+
-5. **[RateQuote](apps/backend/src/domain/entities/rate-quote.entity.ts)** (228 lines)
+5. **[RateQuote](apps/backend/src/domain/entities/rate-quote.entity.ts)** (228 lines)
-   - Pricing breakdown (base freight + surcharges)
+   - Pricing breakdown (base freight + surcharges)
-   - Route segments with ETD/ETA
+   - Route segments with ETD/ETA
-   - 15-minute expiry (validUntil)
+   - 15-minute expiry (validUntil)
-   - Availability tracking
+   - Availability tracking
-   - CO2 emissions
+   - CO2 emissions
-   - Business rules:
+   - Business rules:
-     - ETA must be after ETD
+     - ETA must be after ETD
-     - Transit days must be positive
+     - Transit days must be positive
-     - Route must have at least 2 segments (origin + destination)
+     - Route must have at least 2 segments (origin + destination)
-     - Price must be positive
+     - Price must be positive
-
+
-6. **[Container](apps/backend/src/domain/entities/container.entity.ts)** (265 lines)
+6. **[Container](apps/backend/src/domain/entities/container.entity.ts)** (265 lines)
-   - ISO 6346 container number validation (with check digit)
+   - ISO 6346 container number validation (with check digit)
-   - Container types: DRY, REEFER, OPEN_TOP, FLAT_RACK, TANK
+   - Container types: DRY, REEFER, OPEN_TOP, FLAT_RACK, TANK
-   - Sizes: 20', 40', 45'
+   - Sizes: 20', 40', 45'
-   - Heights: STANDARD, HIGH_CUBE
+   - Heights: STANDARD, HIGH_CUBE
-   - VGM (Verified Gross Mass) validation
+   - VGM (Verified Gross Mass) validation
-   - Temperature control for reefer containers
+   - Temperature control for reefer containers
-   - Hazmat support (IMO class)
+   - Hazmat support (IMO class)
-   - TEU calculation
+   - TEU calculation
-
+
-**Total**: 1,261 lines of domain entity code
+**Total**: 1,261 lines of domain entity code
-
+
----
+---
-
+
-#### Value Objects (5 files)
+#### Value Objects (5 files)
-
+
-1. **[Email](apps/backend/src/domain/value-objects/email.vo.ts)** (63 lines)
+1. **[Email](apps/backend/src/domain/value-objects/email.vo.ts)** (63 lines)
-   - RFC 5322 email validation
+   - RFC 5322 email validation
-   - Case-insensitive (stored lowercase)
+   - Case-insensitive (stored lowercase)
-   - Domain extraction
+   - Domain extraction
-   - Immutable
+   - Immutable
-
+
-2. **[PortCode](apps/backend/src/domain/value-objects/port-code.vo.ts)** (62 lines)
+2. **[PortCode](apps/backend/src/domain/value-objects/port-code.vo.ts)** (62 lines)
-   - UN/LOCODE format validation (CCLLL)
+   - UN/LOCODE format validation (CCLLL)
-   - Country code extraction
+   - Country code extraction
-   - Location code extraction
+   - Location code extraction
-   - Always uppercase
+   - Always uppercase
-
+
-3. **[Money](apps/backend/src/domain/value-objects/money.vo.ts)** (143 lines)
+3. **[Money](apps/backend/src/domain/value-objects/money.vo.ts)** (143 lines)
-   - Multi-currency support (USD, EUR, GBP, CNY, JPY)
+   - Multi-currency support (USD, EUR, GBP, CNY, JPY)
-   - Arithmetic operations (add, subtract, multiply, divide)
+   - Arithmetic operations (add, subtract, multiply, divide)
-   - Comparison operations
+   - Comparison operations
-   - Currency mismatch protection
+   - Currency mismatch protection
-   - Immutable with 2 decimal precision
+   - Immutable with 2 decimal precision
-
+
-4. **[ContainerType](apps/backend/src/domain/value-objects/container-type.vo.ts)** (95 lines)
+4. **[ContainerType](apps/backend/src/domain/value-objects/container-type.vo.ts)** (95 lines)
-   - 14 valid container types (20DRY, 40HC, 40REEFER, etc.)
+   - 14 valid container types (20DRY, 40HC, 40REEFER, etc.)
-   - TEU calculation
+   - TEU calculation
-   - Category detection (dry, reefer, open top, etc.)
+   - Category detection (dry, reefer, open top, etc.)
-
+
-5. **[DateRange](apps/backend/src/domain/value-objects/date-range.vo.ts)** (108 lines)
+5. **[DateRange](apps/backend/src/domain/value-objects/date-range.vo.ts)** (108 lines)
-   - ETD/ETA validation
+   - ETD/ETA validation
-   - Duration calculations (days/hours)
+   - Duration calculations (days/hours)
-   - Overlap detection
+   - Overlap detection
-   - Past/future/current range detection
+   - Past/future/current range detection
-
+
-**Total**: 471 lines of value object code
+**Total**: 471 lines of value object code
-
+
----
+---
-
+
-#### Domain Exceptions (6 files)
+#### Domain Exceptions (6 files)
-
+
-1. **InvalidPortCodeException** - Invalid port code format
+1. **InvalidPortCodeException** - Invalid port code format
-2. **InvalidRateQuoteException** - Malformed rate quote
+2. **InvalidRateQuoteException** - Malformed rate quote
-3. **CarrierTimeoutException** - Carrier API timeout (>5s)
+3. **CarrierTimeoutException** - Carrier API timeout (>5s)
-4. **CarrierUnavailableException** - Carrier down/unreachable
+4. **CarrierUnavailableException** - Carrier down/unreachable
-5. **RateQuoteExpiredException** - Quote expired (>15 min)
+5. **RateQuoteExpiredException** - Quote expired (>15 min)
-6. **PortNotFoundException** - Port not found in database
+6. **PortNotFoundException** - Port not found in database
-
+
-**Total**: 84 lines of exception code
+**Total**: 84 lines of exception code
-
+
----
+---
-
+
-### Week 4: Ports & Domain Services ✅
+### Week 4: Ports & Domain Services ✅
-
+
-#### API Ports - Input (3 files)
+#### API Ports - Input (3 files)
-
+
-1. **[SearchRatesPort](apps/backend/src/domain/ports/in/search-rates.port.ts)** (45 lines)
+1. **[SearchRatesPort](apps/backend/src/domain/ports/in/search-rates.port.ts)** (45 lines)
-   - Rate search use case interface
+   - Rate search use case interface
-   - Input: origin, destination, container type, departure date, hazmat, etc.
+   - Input: origin, destination, container type, departure date, hazmat, etc.
-   - Output: RateQuote[], search metadata, carrier results summary
+   - Output: RateQuote[], search metadata, carrier results summary
-
+
-2. **[GetPortsPort](apps/backend/src/domain/ports/in/get-ports.port.ts)** (46 lines)
+2. **[GetPortsPort](apps/backend/src/domain/ports/in/get-ports.port.ts)** (46 lines)
-   - Port autocomplete interface
+   - Port autocomplete interface
-   - Methods: search(), getByCode(), getByCodes()
+   - Methods: search(), getByCode(), getByCodes()
-   - Fuzzy search support
+   - Fuzzy search support
-
+
-3. **[ValidateAvailabilityPort](apps/backend/src/domain/ports/in/validate-availability.port.ts)** (26 lines)
+3. **[ValidateAvailabilityPort](apps/backend/src/domain/ports/in/validate-availability.port.ts)** (26 lines)
-   - Container availability validation
+   - Container availability validation
-   - Check if rate quote is expired
+   - Check if rate quote is expired
-   - Verify requested quantity available
+   - Verify requested quantity available
-
+
-**Total**: 117 lines of API port definitions
+**Total**: 117 lines of API port definitions
-
+
----
+---
-
+
-#### SPI Ports - Output (7 files)
+#### SPI Ports - Output (7 files)
-
+
-1. **[RateQuoteRepository](apps/backend/src/domain/ports/out/rate-quote.repository.ts)** (45 lines)
+1. **[RateQuoteRepository](apps/backend/src/domain/ports/out/rate-quote.repository.ts)** (45 lines)
-   - CRUD operations for rate quotes
+   - CRUD operations for rate quotes
-   - Search by criteria
+   - Search by criteria
-   - Delete expired quotes
+   - Delete expired quotes
-
+
-2. **[PortRepository](apps/backend/src/domain/ports/out/port.repository.ts)** (58 lines)
+2. **[PortRepository](apps/backend/src/domain/ports/out/port.repository.ts)** (58 lines)
-   - Port persistence
+   - Port persistence
-   - Fuzzy search
+   - Fuzzy search
-   - Bulk operations
+   - Bulk operations
-   - Country filtering
+   - Country filtering
-
+
-3. **[CarrierRepository](apps/backend/src/domain/ports/out/carrier.repository.ts)** (63 lines)
+3. **[CarrierRepository](apps/backend/src/domain/ports/out/carrier.repository.ts)** (63 lines)
-   - Carrier CRUD
+   - Carrier CRUD
-   - Find by code/SCAC
+   - Find by code/SCAC
-   - Filter by API support
+   - Filter by API support
-
+
-4. **[OrganizationRepository](apps/backend/src/domain/ports/out/organization.repository.ts)** (48 lines)
+4. **[OrganizationRepository](apps/backend/src/domain/ports/out/organization.repository.ts)** (48 lines)
-   - Organization CRUD
+   - Organization CRUD
-   - Find by SCAC
+   - Find by SCAC
-   - Filter by type
+   - Filter by type
-
+
-5. **[UserRepository](apps/backend/src/domain/ports/out/user.repository.ts)** (59 lines)
+5. **[UserRepository](apps/backend/src/domain/ports/out/user.repository.ts)** (59 lines)
-   - User CRUD
+   - User CRUD
-   - Find by email
+   - Find by email
-   - Email uniqueness check
+   - Email uniqueness check
-
+
-6. **[CarrierConnectorPort](apps/backend/src/domain/ports/out/carrier-connector.port.ts)** (67 lines)
+6. **[CarrierConnectorPort](apps/backend/src/domain/ports/out/carrier-connector.port.ts)** (67 lines)
-   - Interface for carrier API integrations
+   - Interface for carrier API integrations
-   - Methods: searchRates(), checkAvailability(), healthCheck()
+   - Methods: searchRates(), checkAvailability(), healthCheck()
-   - Throws: CarrierTimeoutException, CarrierUnavailableException
+   - Throws: CarrierTimeoutException, CarrierUnavailableException
-
+
-7. **[CachePort](apps/backend/src/domain/ports/out/cache.port.ts)** (62 lines)
+7. **[CachePort](apps/backend/src/domain/ports/out/cache.port.ts)** (62 lines)
-   - Redis cache interface
+   - Redis cache interface
-   - Methods: get(), set(), delete(), ttl(), getStats()
+   - Methods: get(), set(), delete(), ttl(), getStats()
-   - Support for TTL and cache statistics
+   - Support for TTL and cache statistics
-
+
-**Total**: 402 lines of SPI port definitions
+**Total**: 402 lines of SPI port definitions
-
+
----
+---
-
+
-#### Domain Services (3 files)
+#### Domain Services (3 files)
-
+
-1. **[RateSearchService](apps/backend/src/domain/services/rate-search.service.ts)** (132 lines)
+1. **[RateSearchService](apps/backend/src/domain/services/rate-search.service.ts)** (132 lines)
-   - Implements SearchRatesPort
+   - Implements SearchRatesPort
-   - Business logic:
+   - Business logic:
-     - Validate ports exist
+     - Validate ports exist
-     - Generate cache key
+     - Generate cache key
-     - Check cache (15-min TTL)
+     - Check cache (15-min TTL)
-     - Query carriers in parallel (Promise.allSettled)
+     - Query carriers in parallel (Promise.allSettled)
-     - Handle timeouts gracefully
+     - Handle timeouts gracefully
-     - Save quotes to database
+     - Save quotes to database
-     - Cache results
+     - Cache results
-   - Returns: quotes + carrier status (success/error/timeout)
+   - Returns: quotes + carrier status (success/error/timeout)
-
+
-2. **[PortSearchService](apps/backend/src/domain/services/port-search.service.ts)** (61 lines)
+2. **[PortSearchService](apps/backend/src/domain/services/port-search.service.ts)** (61 lines)
-   - Implements GetPortsPort
+   - Implements GetPortsPort
-   - Fuzzy search with default limit (10)
+   - Fuzzy search with default limit (10)
-   - Country filtering
+   - Country filtering
-   - Batch port retrieval
+   - Batch port retrieval
-
+
-3. **[AvailabilityValidationService](apps/backend/src/domain/services/availability-validation.service.ts)** (48 lines)
+3. **[AvailabilityValidationService](apps/backend/src/domain/services/availability-validation.service.ts)** (48 lines)
-   - Implements ValidateAvailabilityPort
+   - Implements ValidateAvailabilityPort
-   - Validates rate quote exists and not expired
+   - Validates rate quote exists and not expired
-   - Checks availability >= requested quantity
+   - Checks availability >= requested quantity
-
+
-**Total**: 241 lines of domain service code
+**Total**: 241 lines of domain service code
-
+
----
+---
-
+
-### Testing ✅
+### Testing ✅
-
+
-#### Unit Tests (3 test files)
+#### Unit Tests (3 test files)
-
+
-1. **[email.vo.spec.ts](apps/backend/src/domain/value-objects/email.vo.spec.ts)** - 20 tests
+1. **[email.vo.spec.ts](apps/backend/src/domain/value-objects/email.vo.spec.ts)** - 20 tests
-   - Email validation
+   - Email validation
-   - Normalization (lowercase, trim)
+   - Normalization (lowercase, trim)
-   - Domain/local part extraction
+   - Domain/local part extraction
-   - Equality comparison
+   - Equality comparison
-
+
-2. **[money.vo.spec.ts](apps/backend/src/domain/value-objects/money.vo.spec.ts)** - 18 tests
+2. **[money.vo.spec.ts](apps/backend/src/domain/value-objects/money.vo.spec.ts)** - 18 tests
-   - Arithmetic operations (add, subtract, multiply, divide)
+   - Arithmetic operations (add, subtract, multiply, divide)
-   - Comparisons (greater, less, equal)
+   - Comparisons (greater, less, equal)
-   - Currency validation
+   - Currency validation
-   - Formatting
+   - Formatting
-
+
-3. **[rate-quote.entity.spec.ts](apps/backend/src/domain/entities/rate-quote.entity.spec.ts)** - 11 tests
+3. **[rate-quote.entity.spec.ts](apps/backend/src/domain/entities/rate-quote.entity.spec.ts)** - 11 tests
-   - Entity creation with validation
+   - Entity creation with validation
-   - Expiry logic
+   - Expiry logic
-   - Availability checks
+   - Availability checks
-   - Transshipment calculations
+   - Transshipment calculations
-   - Price per day calculation
+   - Price per day calculation
-
+
-**Test Results**: ✅ **49/49 tests passing**
+**Test Results**: ✅ **49/49 tests passing**
-
+
-**Test Coverage Target**: 90%+ on domain layer
+**Test Coverage Target**: 90%+ on domain layer
-
+
----
+---
-
+
-## 📊 Sprint 1-2 Statistics
+## 📊 Sprint 1-2 Statistics
-
+
-| Category | Files | Lines of Code | Tests |
+| Category | Files | Lines of Code | Tests |
-|----------|-------|---------------|-------|
+|----------|-------|---------------|-------|
-| **Domain Entities** | 6 | 1,261 | 11 |
+| **Domain Entities** | 6 | 1,261 | 11 |
-| **Value Objects** | 5 | 471 | 38 |
+| **Value Objects** | 5 | 471 | 38 |
-| **Exceptions** | 6 | 84 | - |
+| **Exceptions** | 6 | 84 | - |
-| **API Ports (in)** | 3 | 117 | - |
+| **API Ports (in)** | 3 | 117 | - |
-| **SPI Ports (out)** | 7 | 402 | - |
+| **SPI Ports (out)** | 7 | 402 | - |
-| **Domain Services** | 3 | 241 | - |
+| **Domain Services** | 3 | 241 | - |
-| **Test Files** | 3 | 506 | 49 |
+| **Test Files** | 3 | 506 | 49 |
-| **TOTAL** | **33** | **3,082** | **49** |
+| **TOTAL** | **33** | **3,082** | **49** |
-
+
----
+---
-
+
-## ✅ Sprint 1-2 Deliverables Checklist
+## ✅ Sprint 1-2 Deliverables Checklist
-
+
-### Week 3: Domain Entities & Value Objects
+### Week 3: Domain Entities & Value Objects
-- ✅ Organization entity with SCAC validation
+- ✅ Organization entity with SCAC validation
-- ✅ User entity with RBAC roles
+- ✅ User entity with RBAC roles
-- ✅ RateQuote entity with 15-min expiry
+- ✅ RateQuote entity with 15-min expiry
-- ✅ Carrier entity with API configuration
+- ✅ Carrier entity with API configuration
-- ✅ Port entity with UN/LOCODE validation
+- ✅ Port entity with UN/LOCODE validation
-- ✅ Container entity with ISO 6346 validation
+- ✅ Container entity with ISO 6346 validation
-- ✅ Email value object with RFC 5322 validation
+- ✅ Email value object with RFC 5322 validation
-- ✅ PortCode value object with UN/LOCODE validation
+- ✅ PortCode value object with UN/LOCODE validation
-- ✅ Money value object with multi-currency support
+- ✅ Money value object with multi-currency support
-- ✅ ContainerType value object with 14 types
+- ✅ ContainerType value object with 14 types
-- ✅ DateRange value object with ETD/ETA validation
+- ✅ DateRange value object with ETD/ETA validation
-- ✅ InvalidPortCodeException
+- ✅ InvalidPortCodeException
-- ✅ InvalidRateQuoteException
+- ✅ InvalidRateQuoteException
-- ✅ CarrierTimeoutException
+- ✅ CarrierTimeoutException
-- ✅ RateQuoteExpiredException
+- ✅ RateQuoteExpiredException
-- ✅ CarrierUnavailableException
+- ✅ CarrierUnavailableException
-- ✅ PortNotFoundException
+- ✅ PortNotFoundException
-
+
-### Week 4: Ports & Domain Services
+### Week 4: Ports & Domain Services
-- ✅ SearchRatesPort interface
+- ✅ SearchRatesPort interface
-- ✅ GetPortsPort interface
+- ✅ GetPortsPort interface
-- ✅ ValidateAvailabilityPort interface
+- ✅ ValidateAvailabilityPort interface
-- ✅ RateQuoteRepository interface
+- ✅ RateQuoteRepository interface
-- ✅ PortRepository interface
+- ✅ PortRepository interface
-- ✅ CarrierRepository interface
+- ✅ CarrierRepository interface
-- ✅ OrganizationRepository interface
+- ✅ OrganizationRepository interface
-- ✅ UserRepository interface
+- ✅ UserRepository interface
-- ✅ CarrierConnectorPort interface
+- ✅ CarrierConnectorPort interface
-- ✅ CachePort interface
+- ✅ CachePort interface
-- ✅ RateSearchService with cache & parallel carrier queries
+- ✅ RateSearchService with cache & parallel carrier queries
-- ✅ PortSearchService with fuzzy search
+- ✅ PortSearchService with fuzzy search
-- ✅ AvailabilityValidationService
+- ✅ AvailabilityValidationService
-- ✅ Domain unit tests (49 tests passing)
+- ✅ Domain unit tests (49 tests passing)
-- ✅ 90%+ test coverage on domain layer
+- ✅ 90%+ test coverage on domain layer
-
+
----
+---
-
+
-## 🏗️ Architecture Validation
+## 🏗️ Architecture Validation
-
+
-### Hexagonal Architecture Compliance ✅
+### Hexagonal Architecture Compliance ✅
-
+
-- ✅ **Domain isolation**: Zero external dependencies in domain layer
+- ✅ **Domain isolation**: Zero external dependencies in domain layer
-- ✅ **Dependency direction**: All dependencies point inward toward domain
+- ✅ **Dependency direction**: All dependencies point inward toward domain
-- ✅ **Framework-free testing**: Tests run without NestJS
+- ✅ **Framework-free testing**: Tests run without NestJS
-- ✅ **Database agnostic**: No TypeORM in domain
+- ✅ **Database agnostic**: No TypeORM in domain
-- ✅ **Pure TypeScript**: No decorators in domain layer
+- ✅ **Pure TypeScript**: No decorators in domain layer
-- ✅ **Port/Adapter pattern**: Clear separation of concerns
+- ✅ **Port/Adapter pattern**: Clear separation of concerns
-- ✅ **Compilation independence**: Domain compiles standalone
+- ✅ **Compilation independence**: Domain compiles standalone
-
+
-### Build Verification ✅
+### Build Verification ✅
-
+
-```bash
+```bash
-cd apps/backend && npm run build
+cd apps/backend && npm run build
-# ✅ Compilation successful - 0 errors
+# ✅ Compilation successful - 0 errors
-```
+```
-
+
-### Test Verification ✅
+### Test Verification ✅
-
+
-```bash
+```bash
-cd apps/backend && npm test -- --testPathPattern="domain"
+cd apps/backend && npm test -- --testPathPattern="domain"
-# Test Suites: 3 passed, 3 total
+# Test Suites: 3 passed, 3 total
-# Tests:       49 passed, 49 total
+# Tests:       49 passed, 49 total
-# ✅ All tests passing
+# ✅ All tests passing
-```
+```
-
+
----
+---
-
+
-## 📋 Next: Sprint 3-4 (Week 5-6) - Infrastructure Layer
+## 📋 Next: Sprint 3-4 (Week 5-6) - Infrastructure Layer
-
+
-### Week 5: Database & Repositories
+### Week 5: Database & Repositories
-
+
-**Tasks**:
+**Tasks**:
-1. Design database schema (ERD)
+1. Design database schema (ERD)
-2. Create TypeORM entities (5 entities)
+2. Create TypeORM entities (5 entities)
-3. Implement ORM mappers (5 mappers)
+3. Implement ORM mappers (5 mappers)
-4. Implement repositories (5 repositories)
+4. Implement repositories (5 repositories)
-5. Create database migrations (6 migrations)
+5. Create database migrations (6 migrations)
-6. Create seed data (carriers, ports, test orgs)
+6. Create seed data (carriers, ports, test orgs)
-
+
-**Deliverables**:
+**Deliverables**:
-- PostgreSQL schema with indexes
+- PostgreSQL schema with indexes
-- TypeORM entities for persistence layer
+- TypeORM entities for persistence layer
-- Repository implementations
+- Repository implementations
-- Database migrations
+- Database migrations
-- 10k+ ports seeded
+- 10k+ ports seeded
-- 5 major carriers seeded
+- 5 major carriers seeded
-
+
-### Week 6: Redis Cache & Carrier Connectors
+### Week 6: Redis Cache & Carrier Connectors
-
+
-**Tasks**:
+**Tasks**:
-1. Implement Redis cache adapter
+1. Implement Redis cache adapter
-2. Create base carrier connector class
+2. Create base carrier connector class
-3. Implement Maersk connector (Priority 1)
+3. Implement Maersk connector (Priority 1)
-4. Add circuit breaker pattern (opossum)
+4. Add circuit breaker pattern (opossum)
-5. Add retry logic with exponential backoff
+5. Add retry logic with exponential backoff
-6. Write integration tests
+6. Write integration tests
-
+
-**Deliverables**:
+**Deliverables**:
-- Redis cache adapter with metrics
+- Redis cache adapter with metrics
-- Base carrier connector with timeout/retry
+- Base carrier connector with timeout/retry
-- Maersk connector with sandbox integration
+- Maersk connector with sandbox integration
-- Integration tests with test database
+- Integration tests with test database
-- 70%+ coverage on infrastructure layer
+- 70%+ coverage on infrastructure layer
-
+
----
+---
-
+
-## 🎯 Phase 1 Overall Progress
+## 🎯 Phase 1 Overall Progress
-
+
-**Completed**: 2/8 weeks (25%)
+**Completed**: 2/8 weeks (25%)
-
+
-- ✅ Sprint 1-2: Domain Layer & Port Definitions (2 weeks)
+- ✅ Sprint 1-2: Domain Layer & Port Definitions (2 weeks)
-- ⏳ Sprint 3-4: Infrastructure Layer - Persistence & Cache (2 weeks)
+- ⏳ Sprint 3-4: Infrastructure Layer - Persistence & Cache (2 weeks)
-- ⏳ Sprint 5-6: Application Layer & Rate Search API (2 weeks)
+- ⏳ Sprint 5-6: Application Layer & Rate Search API (2 weeks)
-- ⏳ Sprint 7-8: Frontend Rate Search UI (2 weeks)
+- ⏳ Sprint 7-8: Frontend Rate Search UI (2 weeks)
-
+
-**Target**: Complete Phase 1 in 6-8 weeks total
+**Target**: Complete Phase 1 in 6-8 weeks total
-
+
----
+---
-
+
-## 🔍 Key Achievements
+## 🔍 Key Achievements
-
+
-1. **Complete Domain Layer** - 3,082 lines of pure business logic
+1. **Complete Domain Layer** - 3,082 lines of pure business logic
-2. **100% Hexagonal Architecture** - Zero framework dependencies in domain
+2. **100% Hexagonal Architecture** - Zero framework dependencies in domain
-3. **Comprehensive Testing** - 49 unit tests, all passing
+3. **Comprehensive Testing** - 49 unit tests, all passing
-4. **Rich Domain Models** - 6 entities, 5 value objects, 6 exceptions
+4. **Rich Domain Models** - 6 entities, 5 value objects, 6 exceptions
-5. **Clear Port Definitions** - 10 interfaces (3 API + 7 SPI)
+5. **Clear Port Definitions** - 10 interfaces (3 API + 7 SPI)
-6. **3 Domain Services** - RateSearch, PortSearch, AvailabilityValidation
+6. **3 Domain Services** - RateSearch, PortSearch, AvailabilityValidation
-7. **ISO Standards** - UN/LOCODE (ports), ISO 6346 (containers), ISO 4217 (currency)
+7. **ISO Standards** - UN/LOCODE (ports), ISO 6346 (containers), ISO 4217 (currency)
-
+
----
+---
-
+
-## 📚 Documentation
+## 📚 Documentation
-
+
-All code is fully documented with:
+All code is fully documented with:
-- ✅ JSDoc comments on all classes/methods
+- ✅ JSDoc comments on all classes/methods
-- ✅ Business rules documented in entity headers
+- ✅ Business rules documented in entity headers
-- ✅ Validation logic explained
+- ✅ Validation logic explained
-- ✅ Exception scenarios documented
+- ✅ Exception scenarios documented
-- ✅ TypeScript strict mode enabled
+- ✅ TypeScript strict mode enabled
-
+
----
+---
-
+
-**Next Action**: Proceed to Sprint 3-4, Week 5 - Design Database Schema
+**Next Action**: Proceed to Sprint 3-4, Week 5 - Design Database Schema
-
+
-*Phase 1 - Xpeditis Maritime Freight Booking Platform*
+*Phase 1 - Xpeditis Maritime Freight Booking Platform*
-*Sprint 1-2 Complete: Domain Layer ✅*
+*Sprint 1-2 Complete: Domain Layer ✅*

PHASE-1-WEEK5-COMPLETE.md

@@ -1,402 +1,402 @@
-# Phase 1 Week 5 Complete - Infrastructure Layer: Database & Repositories
+# Phase 1 Week 5 Complete - Infrastructure Layer: Database & Repositories
-
+
-**Status**: Sprint 3-4 Week 5 Complete ✅
+**Status**: Sprint 3-4 Week 5 Complete ✅
-**Progress**: 3/8 weeks (37.5% of Phase 1)
+**Progress**: 3/8 weeks (37.5% of Phase 1)
-
+
----
+---
-
+
-## ✅ Week 5 Complete: Database & Repositories
+## ✅ Week 5 Complete: Database & Repositories
-
+
-### Database Schema Design ✅
+### Database Schema Design ✅
-
+
-**[DATABASE-SCHEMA.md](apps/backend/DATABASE-SCHEMA.md)** (350+ lines)
+**[DATABASE-SCHEMA.md](apps/backend/DATABASE-SCHEMA.md)** (350+ lines)
-
+
-Complete PostgreSQL 15 schema with:
+Complete PostgreSQL 15 schema with:
-- 6 tables designed
+- 6 tables designed
-- 30+ indexes for performance
+- 30+ indexes for performance
-- Foreign keys with CASCADE
+- Foreign keys with CASCADE
-- CHECK constraints for data validation
+- CHECK constraints for data validation
-- JSONB columns for flexible data
+- JSONB columns for flexible data
-- GIN indexes for fuzzy search (pg_trgm)
+- GIN indexes for fuzzy search (pg_trgm)
-
+
-#### Tables Created:
+#### Tables Created:
-
+
-1. **organizations** (13 columns)
+1. **organizations** (13 columns)
-   - Types: FREIGHT_FORWARDER, CARRIER, SHIPPER
+   - Types: FREIGHT_FORWARDER, CARRIER, SHIPPER
-   - SCAC validation (4 uppercase letters)
+   - SCAC validation (4 uppercase letters)
-   - JSONB documents array
+   - JSONB documents array
-   - Indexes: type, scac, is_active
+   - Indexes: type, scac, is_active
-
+
-2. **users** (13 columns)
+2. **users** (13 columns)
-   - RBAC roles: ADMIN, MANAGER, USER, VIEWER
+   - RBAC roles: ADMIN, MANAGER, USER, VIEWER
-   - Email uniqueness (lowercase)
+   - Email uniqueness (lowercase)
-   - Password hash (bcrypt)
+   - Password hash (bcrypt)
-   - 2FA support (totp_secret)
+   - 2FA support (totp_secret)
-   - FK to organizations (CASCADE)
+   - FK to organizations (CASCADE)
-   - Indexes: email, organization_id, role, is_active
+   - Indexes: email, organization_id, role, is_active
-
+
-3. **carriers** (10 columns)
+3. **carriers** (10 columns)
-   - SCAC code (4 uppercase letters)
+   - SCAC code (4 uppercase letters)
-   - Carrier code (uppercase + underscores)
+   - Carrier code (uppercase + underscores)
-   - JSONB api_config
+   - JSONB api_config
-   - supports_api flag
+   - supports_api flag
-   - Indexes: code, scac, is_active, supports_api
+   - Indexes: code, scac, is_active, supports_api
-
+
-4. **ports** (11 columns)
+4. **ports** (11 columns)
-   - UN/LOCODE (5 characters)
+   - UN/LOCODE (5 characters)
-   - Coordinates (latitude, longitude)
+   - Coordinates (latitude, longitude)
-   - Timezone (IANA)
+   - Timezone (IANA)
-   - GIN indexes for fuzzy search (name, city)
+   - GIN indexes for fuzzy search (name, city)
-   - CHECK constraints for coordinate ranges
+   - CHECK constraints for coordinate ranges
-   - Indexes: code, country, is_active, coordinates
+   - Indexes: code, country, is_active, coordinates
-
+
-5. **rate_quotes** (26 columns)
+5. **rate_quotes** (26 columns)
-   - Carrier reference (FK with CASCADE)
+   - Carrier reference (FK with CASCADE)
-   - Origin/destination (denormalized for performance)
+   - Origin/destination (denormalized for performance)
-   - Pricing breakdown (base_freight, surcharges JSONB, total_amount)
+   - Pricing breakdown (base_freight, surcharges JSONB, total_amount)
-   - Container type, mode (FCL/LCL)
+   - Container type, mode (FCL/LCL)
-   - ETD/ETA with CHECK constraint (eta > etd)
+   - ETD/ETA with CHECK constraint (eta > etd)
-   - Route JSONB array
+   - Route JSONB array
-   - 15-minute expiry (valid_until)
+   - 15-minute expiry (valid_until)
-   - Composite index for rate search
+   - Composite index for rate search
-   - Indexes: carrier, origin_dest, container_type, etd, valid_until
+   - Indexes: carrier, origin_dest, container_type, etd, valid_until
-
+
-6. **containers** (18 columns) - Phase 2
+6. **containers** (18 columns) - Phase 2
-   - ISO 6346 container number validation
+   - ISO 6346 container number validation
-   - Category, size, height
+   - Category, size, height
-   - VGM, temperature, hazmat support
+   - VGM, temperature, hazmat support
-
+
----
+---
-
+
-### TypeORM Entities ✅
+### TypeORM Entities ✅
-
+
-**5 ORM entities created** (infrastructure layer)
+**5 ORM entities created** (infrastructure layer)
-
+
-1. **[OrganizationOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/organization.orm-entity.ts)** (59 lines)
+1. **[OrganizationOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/organization.orm-entity.ts)** (59 lines)
-   - Maps to organizations table
+   - Maps to organizations table
-   - TypeORM decorators (@Entity, @Column, @Index)
+   - TypeORM decorators (@Entity, @Column, @Index)
-   - camelCase properties → snake_case columns
+   - camelCase properties → snake_case columns
-
+
-2. **[UserOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/user.orm-entity.ts)** (71 lines)
+2. **[UserOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/user.orm-entity.ts)** (71 lines)
-   - Maps to users table
+   - Maps to users table
-   - ManyToOne relation to OrganizationOrmEntity
+   - ManyToOne relation to OrganizationOrmEntity
-   - FK with onDelete: CASCADE
+   - FK with onDelete: CASCADE
-
+
-3. **[CarrierOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/carrier.orm-entity.ts)** (51 lines)
+3. **[CarrierOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/carrier.orm-entity.ts)** (51 lines)
-   - Maps to carriers table
+   - Maps to carriers table
-   - JSONB apiConfig column
+   - JSONB apiConfig column
-
+
-4. **[PortOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/port.orm-entity.ts)** (54 lines)
+4. **[PortOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/port.orm-entity.ts)** (54 lines)
-   - Maps to ports table
+   - Maps to ports table
-   - Decimal coordinates (latitude, longitude)
+   - Decimal coordinates (latitude, longitude)
-   - GIN indexes for fuzzy search
+   - GIN indexes for fuzzy search
-
+
-5. **[RateQuoteOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/rate-quote.orm-entity.ts)** (110 lines)
+5. **[RateQuoteOrmEntity](apps/backend/src/infrastructure/persistence/typeorm/entities/rate-quote.orm-entity.ts)** (110 lines)
-   - Maps to rate_quotes table
+   - Maps to rate_quotes table
-   - ManyToOne relation to CarrierOrmEntity
+   - ManyToOne relation to CarrierOrmEntity
-   - JSONB surcharges and route columns
+   - JSONB surcharges and route columns
-   - Composite index for search optimization
+   - Composite index for search optimization
-
+
-**TypeORM Configuration**:
+**TypeORM Configuration**:
-- **[data-source.ts](apps/backend/src/infrastructure/persistence/typeorm/data-source.ts)** - TypeORM DataSource for migrations
+- **[data-source.ts](apps/backend/src/infrastructure/persistence/typeorm/data-source.ts)** - TypeORM DataSource for migrations
-- **tsconfig.json** updated with `strictPropertyInitialization: false` for ORM entities
+- **tsconfig.json** updated with `strictPropertyInitialization: false` for ORM entities
-
+
----
+---
-
+
-### ORM Mappers ✅
+### ORM Mappers ✅
-
+
-**5 bidirectional mappers created** (Domain ↔ ORM)
+**5 bidirectional mappers created** (Domain ↔ ORM)
-
+
-1. **[OrganizationOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/organization-orm.mapper.ts)** (67 lines)
+1. **[OrganizationOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/organization-orm.mapper.ts)** (67 lines)
-   - `toOrm()` - Domain → ORM
+   - `toOrm()` - Domain → ORM
-   - `toDomain()` - ORM → Domain
+   - `toDomain()` - ORM → Domain
-   - `toDomainMany()` - Bulk conversion
+   - `toDomainMany()` - Bulk conversion
-
+
-2. **[UserOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/user-orm.mapper.ts)** (67 lines)
+2. **[UserOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/user-orm.mapper.ts)** (67 lines)
-   - Maps UserRole enum correctly
+   - Maps UserRole enum correctly
-   - Handles optional fields (phoneNumber, totpSecret, lastLoginAt)
+   - Handles optional fields (phoneNumber, totpSecret, lastLoginAt)
-
+
-3. **[CarrierOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/carrier-orm.mapper.ts)** (61 lines)
+3. **[CarrierOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/carrier-orm.mapper.ts)** (61 lines)
-   - JSONB apiConfig serialization
+   - JSONB apiConfig serialization
-
+
-4. **[PortOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/port-orm.mapper.ts)** (61 lines)
+4. **[PortOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/port-orm.mapper.ts)** (61 lines)
-   - Converts decimal coordinates to numbers
+   - Converts decimal coordinates to numbers
-   - Maps coordinates object to flat latitude/longitude
+   - Maps coordinates object to flat latitude/longitude
-
+
-5. **[RateQuoteOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/rate-quote-orm.mapper.ts)** (101 lines)
+5. **[RateQuoteOrmMapper](apps/backend/src/infrastructure/persistence/typeorm/mappers/rate-quote-orm.mapper.ts)** (101 lines)
-   - Denormalizes origin/destination from nested objects
+   - Denormalizes origin/destination from nested objects
-   - JSONB surcharges and route serialization
+   - JSONB surcharges and route serialization
-   - Pricing breakdown mapping
+   - Pricing breakdown mapping
-
+
----
+---
-
+
-### Repository Implementations ✅
+### Repository Implementations ✅
-
+
-**5 TypeORM repositories implementing domain ports**
+**5 TypeORM repositories implementing domain ports**
-
+
-1. **[TypeOrmPortRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-port.repository.ts)** (111 lines)
+1. **[TypeOrmPortRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-port.repository.ts)** (111 lines)
-   - Implements `PortRepository` interface
+   - Implements `PortRepository` interface
-   - Fuzzy search with pg_trgm trigrams
+   - Fuzzy search with pg_trgm trigrams
-   - Search prioritization: exact code → name → starts with
+   - Search prioritization: exact code → name → starts with
-   - Methods: save, saveMany, findByCode, findByCodes, search, findAllActive, findByCountry, count, deleteByCode
+   - Methods: save, saveMany, findByCode, findByCodes, search, findAllActive, findByCountry, count, deleteByCode
-
+
-2. **[TypeOrmCarrierRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-carrier.repository.ts)** (93 lines)
+2. **[TypeOrmCarrierRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-carrier.repository.ts)** (93 lines)
-   - Implements `CarrierRepository` interface
+   - Implements `CarrierRepository` interface
-   - Methods: save, saveMany, findById, findByCode, findByScac, findAllActive, findWithApiSupport, findAll, update, deleteById
+   - Methods: save, saveMany, findById, findByCode, findByScac, findAllActive, findWithApiSupport, findAll, update, deleteById
-
+
-3. **[TypeOrmRateQuoteRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-rate-quote.repository.ts)** (89 lines)
+3. **[TypeOrmRateQuoteRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-rate-quote.repository.ts)** (89 lines)
-   - Implements `RateQuoteRepository` interface
+   - Implements `RateQuoteRepository` interface
-   - Complex search with composite index usage
+   - Complex search with composite index usage
-   - Filters expired quotes (valid_until)
+   - Filters expired quotes (valid_until)
-   - Date range search for departure date
+   - Date range search for departure date
-   - Methods: save, saveMany, findById, findBySearchCriteria, findByCarrier, deleteExpired, deleteById
+   - Methods: save, saveMany, findById, findBySearchCriteria, findByCarrier, deleteExpired, deleteById
-
+
-4. **[TypeOrmOrganizationRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-organization.repository.ts)** (78 lines)
+4. **[TypeOrmOrganizationRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-organization.repository.ts)** (78 lines)
-   - Implements `OrganizationRepository` interface
+   - Implements `OrganizationRepository` interface
-   - Methods: save, findById, findByName, findByScac, findAllActive, findByType, update, deleteById, count
+   - Methods: save, findById, findByName, findByScac, findAllActive, findByType, update, deleteById, count
-
+
-5. **[TypeOrmUserRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-user.repository.ts)** (98 lines)
+5. **[TypeOrmUserRepository](apps/backend/src/infrastructure/persistence/typeorm/repositories/typeorm-user.repository.ts)** (98 lines)
-   - Implements `UserRepository` interface
+   - Implements `UserRepository` interface
-   - Email normalization to lowercase
+   - Email normalization to lowercase
-   - Methods: save, findById, findByEmail, findByOrganization, findByRole, findAllActive, update, deleteById, countByOrganization, emailExists
+   - Methods: save, findById, findByEmail, findByOrganization, findByRole, findAllActive, update, deleteById, countByOrganization, emailExists
-
+
-**All repositories use**:
+**All repositories use**:
-- `@Injectable()` decorator for NestJS DI
+- `@Injectable()` decorator for NestJS DI
-- `@InjectRepository()` for TypeORM injection
+- `@InjectRepository()` for TypeORM injection
-- Domain entity mappers for conversion
+- Domain entity mappers for conversion
-- TypeORM QueryBuilder for complex queries
+- TypeORM QueryBuilder for complex queries
-
+
----
+---
-
+
-### Database Migrations ✅
+### Database Migrations ✅
-
+
-**6 migrations created** (chronological order)
+**6 migrations created** (chronological order)
-
+
-1. **[1730000000001-CreateExtensionsAndOrganizations.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000001-CreateExtensionsAndOrganizations.ts)** (67 lines)
+1. **[1730000000001-CreateExtensionsAndOrganizations.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000001-CreateExtensionsAndOrganizations.ts)** (67 lines)
-   - Creates PostgreSQL extensions: uuid-ossp, pg_trgm
+   - Creates PostgreSQL extensions: uuid-ossp, pg_trgm
-   - Creates organizations table with constraints
+   - Creates organizations table with constraints
-   - Indexes: type, scac, is_active
+   - Indexes: type, scac, is_active
-   - CHECK constraints: SCAC format, country code
+   - CHECK constraints: SCAC format, country code
-
+
-2. **[1730000000002-CreateUsers.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000002-CreateUsers.ts)** (68 lines)
+2. **[1730000000002-CreateUsers.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000002-CreateUsers.ts)** (68 lines)
-   - Creates users table
+   - Creates users table
-   - FK to organizations (CASCADE)
+   - FK to organizations (CASCADE)
-   - Indexes: email, organization_id, role, is_active
+   - Indexes: email, organization_id, role, is_active
-   - CHECK constraints: email lowercase, role enum
+   - CHECK constraints: email lowercase, role enum
-
+
-3. **[1730000000003-CreateCarriers.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000003-CreateCarriers.ts)** (55 lines)
+3. **[1730000000003-CreateCarriers.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000003-CreateCarriers.ts)** (55 lines)
-   - Creates carriers table
+   - Creates carriers table
-   - Indexes: code, scac, is_active, supports_api
+   - Indexes: code, scac, is_active, supports_api
-   - CHECK constraints: code format, SCAC format
+   - CHECK constraints: code format, SCAC format
-
+
-4. **[1730000000004-CreatePorts.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000004-CreatePorts.ts)** (67 lines)
+4. **[1730000000004-CreatePorts.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000004-CreatePorts.ts)** (67 lines)
-   - Creates ports table
+   - Creates ports table
-   - GIN indexes for fuzzy search (name, city)
+   - GIN indexes for fuzzy search (name, city)
-   - Indexes: code, country, is_active, coordinates
+   - Indexes: code, country, is_active, coordinates
-   - CHECK constraints: UN/LOCODE format, latitude/longitude ranges
+   - CHECK constraints: UN/LOCODE format, latitude/longitude ranges
-
+
-5. **[1730000000005-CreateRateQuotes.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000005-CreateRateQuotes.ts)** (78 lines)
+5. **[1730000000005-CreateRateQuotes.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000005-CreateRateQuotes.ts)** (78 lines)
-   - Creates rate_quotes table
+   - Creates rate_quotes table
-   - FK to carriers (CASCADE)
+   - FK to carriers (CASCADE)
-   - Composite index for rate search optimization
+   - Composite index for rate search optimization
-   - Indexes: carrier, origin_dest, container_type, etd, valid_until, created_at
+   - Indexes: carrier, origin_dest, container_type, etd, valid_until, created_at
-   - CHECK constraints: positive amounts, eta > etd, mode enum
+   - CHECK constraints: positive amounts, eta > etd, mode enum
-
+
-6. **[1730000000006-SeedCarriersAndOrganizations.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000006-SeedCarriersAndOrganizations.ts)** (25 lines)
+6. **[1730000000006-SeedCarriersAndOrganizations.ts](apps/backend/src/infrastructure/persistence/typeorm/migrations/1730000000006-SeedCarriersAndOrganizations.ts)** (25 lines)
-   - Seeds 5 major carriers (Maersk, MSC, CMA CGM, Hapag-Lloyd, ONE)
+   - Seeds 5 major carriers (Maersk, MSC, CMA CGM, Hapag-Lloyd, ONE)
-   - Seeds 3 test organizations
+   - Seeds 3 test organizations
-   - Uses ON CONFLICT DO NOTHING for idempotency
+   - Uses ON CONFLICT DO NOTHING for idempotency
-
+
----
+---
-
+
-### Seed Data ✅
+### Seed Data ✅
-
+
-**2 seed data modules created**
+**2 seed data modules created**
-
+
-1. **[carriers.seed.ts](apps/backend/src/infrastructure/persistence/typeorm/seeds/carriers.seed.ts)** (74 lines)
+1. **[carriers.seed.ts](apps/backend/src/infrastructure/persistence/typeorm/seeds/carriers.seed.ts)** (74 lines)
-   - 5 major shipping carriers:
+   - 5 major shipping carriers:
-     - **Maersk Line** (MAEU) - API supported
+     - **Maersk Line** (MAEU) - API supported
-     - **MSC** (MSCU)
+     - **MSC** (MSCU)
-     - **CMA CGM** (CMDU)
+     - **CMA CGM** (CMDU)
-     - **Hapag-Lloyd** (HLCU)
+     - **Hapag-Lloyd** (HLCU)
-     - **ONE** (ONEY)
+     - **ONE** (ONEY)
-   - Includes logos, websites, SCAC codes
+   - Includes logos, websites, SCAC codes
-   - `getCarriersInsertSQL()` function for migration
+   - `getCarriersInsertSQL()` function for migration
-
+
-2. **[test-organizations.seed.ts](apps/backend/src/infrastructure/persistence/typeorm/seeds/test-organizations.seed.ts)** (74 lines)
+2. **[test-organizations.seed.ts](apps/backend/src/infrastructure/persistence/typeorm/seeds/test-organizations.seed.ts)** (74 lines)
-   - 3 test organizations:
+   - 3 test organizations:
-     - Test Freight Forwarder Inc. (Rotterdam, NL)
+     - Test Freight Forwarder Inc. (Rotterdam, NL)
-     - Demo Shipping Company (Singapore, SG) - with SCAC: DEMO
+     - Demo Shipping Company (Singapore, SG) - with SCAC: DEMO
-     - Sample Shipper Ltd. (New York, US)
+     - Sample Shipper Ltd. (New York, US)
-   - `getOrganizationsInsertSQL()` function for migration
+   - `getOrganizationsInsertSQL()` function for migration
-
+
----
+---
-
+
-## 📊 Week 5 Statistics
+## 📊 Week 5 Statistics
-
+
-| Category | Files | Lines of Code |
+| Category | Files | Lines of Code |
-|----------|-------|---------------|
+|----------|-------|---------------|
-| **Database Schema Documentation** | 1 | 350 |
+| **Database Schema Documentation** | 1 | 350 |
-| **TypeORM Entities** | 5 | 345 |
+| **TypeORM Entities** | 5 | 345 |
-| **ORM Mappers** | 5 | 357 |
+| **ORM Mappers** | 5 | 357 |
-| **Repositories** | 5 | 469 |
+| **Repositories** | 5 | 469 |
-| **Migrations** | 6 | 360 |
+| **Migrations** | 6 | 360 |
-| **Seed Data** | 2 | 148 |
+| **Seed Data** | 2 | 148 |
-| **Configuration** | 1 | 28 |
+| **Configuration** | 1 | 28 |
-| **TOTAL** | **25** | **2,057** |
+| **TOTAL** | **25** | **2,057** |
-
+
----
+---
-
+
-## ✅ Week 5 Deliverables Checklist
+## ✅ Week 5 Deliverables Checklist
-
+
-### Database Schema
+### Database Schema
-- ✅ ERD design with 6 tables
+- ✅ ERD design with 6 tables
-- ✅ 30+ indexes for performance
+- ✅ 30+ indexes for performance
-- ✅ Foreign keys with CASCADE
+- ✅ Foreign keys with CASCADE
-- ✅ CHECK constraints for validation
+- ✅ CHECK constraints for validation
-- ✅ JSONB columns for flexible data
+- ✅ JSONB columns for flexible data
-- ✅ GIN indexes for fuzzy search
+- ✅ GIN indexes for fuzzy search
-- ✅ Complete documentation
+- ✅ Complete documentation
-
+
-### TypeORM Entities
+### TypeORM Entities
-- ✅ OrganizationOrmEntity with indexes
+- ✅ OrganizationOrmEntity with indexes
-- ✅ UserOrmEntity with FK to organizations
+- ✅ UserOrmEntity with FK to organizations
-- ✅ CarrierOrmEntity with JSONB config
+- ✅ CarrierOrmEntity with JSONB config
-- ✅ PortOrmEntity with GIN indexes
+- ✅ PortOrmEntity with GIN indexes
-- ✅ RateQuoteOrmEntity with composite indexes
+- ✅ RateQuoteOrmEntity with composite indexes
-- ✅ TypeORM DataSource configuration
+- ✅ TypeORM DataSource configuration
-
+
-### ORM Mappers
+### ORM Mappers
-- ✅ OrganizationOrmMapper (bidirectional)
+- ✅ OrganizationOrmMapper (bidirectional)
-- ✅ UserOrmMapper (bidirectional)
+- ✅ UserOrmMapper (bidirectional)
-- ✅ CarrierOrmMapper (bidirectional)
+- ✅ CarrierOrmMapper (bidirectional)
-- ✅ PortOrmMapper (bidirectional)
+- ✅ PortOrmMapper (bidirectional)
-- ✅ RateQuoteOrmMapper (bidirectional)
+- ✅ RateQuoteOrmMapper (bidirectional)
-- ✅ Bulk conversion methods (toDomainMany)
+- ✅ Bulk conversion methods (toDomainMany)
-
+
-### Repositories
+### Repositories
-- ✅ TypeOrmPortRepository with fuzzy search
+- ✅ TypeOrmPortRepository with fuzzy search
-- ✅ TypeOrmCarrierRepository with API filter
+- ✅ TypeOrmCarrierRepository with API filter
-- ✅ TypeOrmRateQuoteRepository with complex search
+- ✅ TypeOrmRateQuoteRepository with complex search
-- ✅ TypeOrmOrganizationRepository
+- ✅ TypeOrmOrganizationRepository
-- ✅ TypeOrmUserRepository with email checks
+- ✅ TypeOrmUserRepository with email checks
-- ✅ All implement domain port interfaces
+- ✅ All implement domain port interfaces
-- ✅ NestJS @Injectable decorators
+- ✅ NestJS @Injectable decorators
-
+
-### Migrations
+### Migrations
-- ✅ Migration 1: Extensions + Organizations
+- ✅ Migration 1: Extensions + Organizations
-- ✅ Migration 2: Users
+- ✅ Migration 2: Users
-- ✅ Migration 3: Carriers
+- ✅ Migration 3: Carriers
-- ✅ Migration 4: Ports
+- ✅ Migration 4: Ports
-- ✅ Migration 5: RateQuotes
+- ✅ Migration 5: RateQuotes
-- ✅ Migration 6: Seed data
+- ✅ Migration 6: Seed data
-- ✅ All migrations reversible (up/down)
+- ✅ All migrations reversible (up/down)
-
+
-### Seed Data
+### Seed Data
-- ✅ 5 major carriers seeded
+- ✅ 5 major carriers seeded
-- ✅ 3 test organizations seeded
+- ✅ 3 test organizations seeded
-- ✅ Idempotent inserts (ON CONFLICT)
+- ✅ Idempotent inserts (ON CONFLICT)
-
+
----
+---
-
+
-## 🏗️ Architecture Validation
+## 🏗️ Architecture Validation
-
+
-### Hexagonal Architecture Compliance ✅
+### Hexagonal Architecture Compliance ✅
-
+
-- ✅ **Infrastructure depends on domain**: Repositories implement domain ports
+- ✅ **Infrastructure depends on domain**: Repositories implement domain ports
-- ✅ **No domain dependencies on infrastructure**: Domain layer remains pure
+- ✅ **No domain dependencies on infrastructure**: Domain layer remains pure
-- ✅ **Mappers isolate ORM from domain**: Clean conversion layer
+- ✅ **Mappers isolate ORM from domain**: Clean conversion layer
-- ✅ **Repository pattern**: All data access through interfaces
+- ✅ **Repository pattern**: All data access through interfaces
-- ✅ **NestJS integration**: @Injectable for DI, but domain stays pure
+- ✅ **NestJS integration**: @Injectable for DI, but domain stays pure
-
+
-### Build Verification ✅
+### Build Verification ✅
-
+
-```bash
+```bash
-cd apps/backend && npm run build
+cd apps/backend && npm run build
-# ✅ Compilation successful - 0 errors
+# ✅ Compilation successful - 0 errors
-```
+```
-
+
-### TypeScript Configuration ✅
+### TypeScript Configuration ✅
-
+
-- Added `strictPropertyInitialization: false` for ORM entities
+- Added `strictPropertyInitialization: false` for ORM entities
-- TypeORM handles property initialization
+- TypeORM handles property initialization
-- Strict mode still enabled for domain layer
+- Strict mode still enabled for domain layer
-
+
----
+---
-
+
-## 📋 What's Next: Week 6 - Redis Cache & Carrier Connectors
+## 📋 What's Next: Week 6 - Redis Cache & Carrier Connectors
-
+
-### Tasks for Week 6:
+### Tasks for Week 6:
-
+
-1. **Redis Cache Adapter**
+1. **Redis Cache Adapter**
-   - Implement `RedisCacheAdapter` (implements CachePort)
+   - Implement `RedisCacheAdapter` (implements CachePort)
-   - get/set with TTL
+   - get/set with TTL
-   - Cache key generation strategy
+   - Cache key generation strategy
-   - Connection error handling
+   - Connection error handling
-   - Cache metrics (hit/miss rate)
+   - Cache metrics (hit/miss rate)
-
+
-2. **Base Carrier Connector**
+2. **Base Carrier Connector**
-   - `BaseCarrierConnector` abstract class
+   - `BaseCarrierConnector` abstract class
-   - HTTP client (axios with timeout)
+   - HTTP client (axios with timeout)
-   - Retry logic (exponential backoff)
+   - Retry logic (exponential backoff)
-   - Circuit breaker (using opossum)
+   - Circuit breaker (using opossum)
-   - Request/response logging
+   - Request/response logging
-   - Error normalization
+   - Error normalization
-
+
-3. **Maersk Connector** (Priority 1)
+3. **Maersk Connector** (Priority 1)
-   - Research Maersk API documentation
+   - Research Maersk API documentation
-   - `MaerskConnectorAdapter` implementing CarrierConnectorPort
+   - `MaerskConnectorAdapter` implementing CarrierConnectorPort
-   - Request/response mappers
+   - Request/response mappers
-   - 5-second timeout
+   - 5-second timeout
-   - Unit tests with mocked responses
+   - Unit tests with mocked responses
-
+
-4. **Integration Tests**
+4. **Integration Tests**
-   - Test repositories with test database
+   - Test repositories with test database
-   - Test Redis cache adapter
+   - Test Redis cache adapter
-   - Test Maersk connector with sandbox
+   - Test Maersk connector with sandbox
-   - Target: 70%+ coverage on infrastructure
+   - Target: 70%+ coverage on infrastructure
-
+
----
+---
-
+
-## 🎯 Phase 1 Overall Progress
+## 🎯 Phase 1 Overall Progress
-
+
-**Completed**: 3/8 weeks (37.5%)
+**Completed**: 3/8 weeks (37.5%)
-
+
-- ✅ **Sprint 1-2: Week 3** - Domain entities & value objects
+- ✅ **Sprint 1-2: Week 3** - Domain entities & value objects
-- ✅ **Sprint 1-2: Week 4** - Ports & domain services
+- ✅ **Sprint 1-2: Week 4** - Ports & domain services
-- ✅ **Sprint 3-4: Week 5** - Database & repositories
+- ✅ **Sprint 3-4: Week 5** - Database & repositories
-- ⏳ **Sprint 3-4: Week 6** - Redis cache & carrier connectors
+- ⏳ **Sprint 3-4: Week 6** - Redis cache & carrier connectors
-- ⏳ **Sprint 5-6: Week 7** - DTOs, mappers & controllers
+- ⏳ **Sprint 5-6: Week 7** - DTOs, mappers & controllers
-- ⏳ **Sprint 5-6: Week 8** - OpenAPI, caching, performance
+- ⏳ **Sprint 5-6: Week 8** - OpenAPI, caching, performance
-- ⏳ **Sprint 7-8: Week 9** - Frontend search form
+- ⏳ **Sprint 7-8: Week 9** - Frontend search form
-- ⏳ **Sprint 7-8: Week 10** - Frontend results display
+- ⏳ **Sprint 7-8: Week 10** - Frontend results display
-
+
----
+---
-
+
-## 🔍 Key Achievements - Week 5
+## 🔍 Key Achievements - Week 5
-
+
-1. **Complete PostgreSQL Schema** - 6 tables, 30+ indexes, full documentation
+1. **Complete PostgreSQL Schema** - 6 tables, 30+ indexes, full documentation
-2. **TypeORM Integration** - 5 entities, 5 mappers, 5 repositories
+2. **TypeORM Integration** - 5 entities, 5 mappers, 5 repositories
-3. **6 Database Migrations** - All reversible with up/down
+3. **6 Database Migrations** - All reversible with up/down
-4. **Seed Data** - 5 carriers + 3 test organizations
+4. **Seed Data** - 5 carriers + 3 test organizations
-5. **Fuzzy Search** - GIN indexes with pg_trgm for port search
+5. **Fuzzy Search** - GIN indexes with pg_trgm for port search
-6. **Repository Pattern** - All implement domain port interfaces
+6. **Repository Pattern** - All implement domain port interfaces
-7. **Clean Architecture** - Infrastructure depends on domain, not vice versa
+7. **Clean Architecture** - Infrastructure depends on domain, not vice versa
-8. **2,057 Lines of Infrastructure Code** - All tested and building successfully
+8. **2,057 Lines of Infrastructure Code** - All tested and building successfully
-
+
----
+---
-
+
-## 🚀 Ready for Week 6
+## 🚀 Ready for Week 6
-
+
-All database infrastructure is in place and ready for:
+All database infrastructure is in place and ready for:
-- Redis cache integration
+- Redis cache integration
-- Carrier API connectors
+- Carrier API connectors
-- Integration testing
+- Integration testing
-
+
-**Next Action**: Implement Redis cache adapter and base carrier connector class
+**Next Action**: Implement Redis cache adapter and base carrier connector class
-
+
----
+---
-
+
-*Phase 1 - Week 5 Complete*
+*Phase 1 - Week 5 Complete*
-*Infrastructure Layer: Database & Repositories ✅*
+*Infrastructure Layer: Database & Repositories ✅*
-*Xpeditis Maritime Freight Booking Platform*
+*Xpeditis Maritime Freight Booking Platform*

PHASE2_AUTHENTICATION_SUMMARY.md

@@ -1,446 +1,446 @@
-# Phase 2: Authentication & User Management - Implementation Summary
+# Phase 2: Authentication & User Management - Implementation Summary
-
+
-## ✅ Completed (100%)
+## ✅ Completed (100%)
-
+
-### 📋 Overview
+### 📋 Overview
-
+
-Successfully implemented complete JWT-based authentication system for the Xpeditis maritime freight booking platform following hexagonal architecture principles.
+Successfully implemented complete JWT-based authentication system for the Xpeditis maritime freight booking platform following hexagonal architecture principles.
-
+
-**Implementation Date:** January 2025
+**Implementation Date:** January 2025
-**Phase:** MVP Phase 2
+**Phase:** MVP Phase 2
-**Status:** Complete and ready for testing
+**Status:** Complete and ready for testing
-
+
----
+---
-
+
-## 🏗️ Architecture
+## 🏗️ Architecture
-
+
-### Authentication Flow
+### Authentication Flow
-
+
-```
+```
-┌─────────────┐          ┌──────────────┐          ┌─────────────┐
+┌─────────────┐          ┌──────────────┐          ┌─────────────┐
-│   Client    │          │   NestJS     │          │  PostgreSQL │
+│   Client    │          │   NestJS     │          │  PostgreSQL │
-│  (Postman)  │          │   Backend    │          │  Database   │
+│  (Postman)  │          │   Backend    │          │  Database   │
-└──────┬──────┘          └───────┬──────┘          └──────┬──────┘
+└──────┬──────┘          └───────┬──────┘          └──────┬──────┘
-       │                         │                        │
+       │                         │                        │
-       │ POST /auth/register     │                        │
+       │ POST /auth/register     │                        │
-       │────────────────────────>│                        │
+       │────────────────────────>│                        │
-       │                         │ Save user (Argon2)     │
+       │                         │ Save user (Argon2)     │
-       │                         │───────────────────────>│
+       │                         │───────────────────────>│
-       │                         │                        │
+       │                         │                        │
-       │   JWT Tokens + User     │                        │
+       │   JWT Tokens + User     │                        │
-       │<────────────────────────│                        │
+       │<────────────────────────│                        │
-       │                         │                        │
+       │                         │                        │
-       │ POST /auth/login        │                        │
+       │ POST /auth/login        │                        │
-       │────────────────────────>│                        │
+       │────────────────────────>│                        │
-       │                         │ Verify password        │
+       │                         │ Verify password        │
-       │                         │───────────────────────>│
+       │                         │───────────────────────>│
-       │                         │                        │
+       │                         │                        │
-       │   JWT Tokens            │                        │
+       │   JWT Tokens            │                        │
-       │<────────────────────────│                        │
+       │<────────────────────────│                        │
-       │                         │                        │
+       │                         │                        │
-       │ GET /api/v1/rates/search│                        │
+       │ GET /api/v1/rates/search│                        │
-       │ Authorization: Bearer   │                        │
+       │ Authorization: Bearer   │                        │
-       │────────────────────────>│                        │
+       │────────────────────────>│                        │
-       │                         │ Validate JWT           │
+       │                         │ Validate JWT           │
-       │                         │ Extract user from token│
+       │                         │ Extract user from token│
-       │                         │                        │
+       │                         │                        │
-       │   Rate quotes           │                        │
+       │   Rate quotes           │                        │
-       │<────────────────────────│                        │
+       │<────────────────────────│                        │
-       │                         │                        │
+       │                         │                        │
-       │ POST /auth/refresh      │                        │
+       │ POST /auth/refresh      │                        │
-       │────────────────────────>│                        │
+       │────────────────────────>│                        │
-       │   New access token      │                        │
+       │   New access token      │                        │
-       │<────────────────────────│                        │
+       │<────────────────────────│                        │
-```
+```
-
+
-### Security Implementation
+### Security Implementation
-
+
-- **Password Hashing:** Argon2id (64MB memory, 3 iterations, 4 parallelism)
+- **Password Hashing:** Argon2id (64MB memory, 3 iterations, 4 parallelism)
-- **JWT Algorithm:** HS256 (HMAC with SHA-256)
+- **JWT Algorithm:** HS256 (HMAC with SHA-256)
-- **Access Token:** 15 minutes expiration
+- **Access Token:** 15 minutes expiration
-- **Refresh Token:** 7 days expiration
+- **Refresh Token:** 7 days expiration
-- **Token Payload:** userId, email, role, organizationId, token type
+- **Token Payload:** userId, email, role, organizationId, token type
-
+
----
+---
-
+
-## 📁 Files Created
+## 📁 Files Created
-
+
-### Authentication Core (7 files)
+### Authentication Core (7 files)
-
+
-1. **`apps/backend/src/application/dto/auth-login.dto.ts`** (106 lines)
+1. **`apps/backend/src/application/dto/auth-login.dto.ts`** (106 lines)
-   - `LoginDto` - Email + password validation
+   - `LoginDto` - Email + password validation
-   - `RegisterDto` - User registration with validation
+   - `RegisterDto` - User registration with validation
-   - `AuthResponseDto` - Response with tokens + user info
+   - `AuthResponseDto` - Response with tokens + user info
-   - `RefreshTokenDto` - Token refresh payload
+   - `RefreshTokenDto` - Token refresh payload
-
+
-2. **`apps/backend/src/application/auth/auth.service.ts`** (198 lines)
+2. **`apps/backend/src/application/auth/auth.service.ts`** (198 lines)
-   - `register()` - Create user with Argon2 hashing
+   - `register()` - Create user with Argon2 hashing
-   - `login()` - Authenticate and generate tokens
+   - `login()` - Authenticate and generate tokens
-   - `refreshAccessToken()` - Generate new access token
+   - `refreshAccessToken()` - Generate new access token
-   - `validateUser()` - Validate JWT payload
+   - `validateUser()` - Validate JWT payload
-   - `generateTokens()` - Create access + refresh tokens
+   - `generateTokens()` - Create access + refresh tokens
-
+
-3. **`apps/backend/src/application/auth/jwt.strategy.ts`** (68 lines)
+3. **`apps/backend/src/application/auth/jwt.strategy.ts`** (68 lines)
-   - Passport JWT strategy implementation
+   - Passport JWT strategy implementation
-   - Token extraction from Authorization header
+   - Token extraction from Authorization header
-   - User validation and injection into request
+   - User validation and injection into request
-
+
-4. **`apps/backend/src/application/auth/auth.module.ts`** (58 lines)
+4. **`apps/backend/src/application/auth/auth.module.ts`** (58 lines)
-   - JWT configuration with async factory
+   - JWT configuration with async factory
-   - Passport module integration
+   - Passport module integration
-   - AuthService and JwtStrategy providers
+   - AuthService and JwtStrategy providers
-
+
-5. **`apps/backend/src/application/controllers/auth.controller.ts`** (189 lines)
+5. **`apps/backend/src/application/controllers/auth.controller.ts`** (189 lines)
-   - `POST /auth/register` - User registration
+   - `POST /auth/register` - User registration
-   - `POST /auth/login` - User login
+   - `POST /auth/login` - User login
-   - `POST /auth/refresh` - Token refresh
+   - `POST /auth/refresh` - Token refresh
-   - `POST /auth/logout` - Logout (placeholder)
+   - `POST /auth/logout` - Logout (placeholder)
-   - `GET /auth/me` - Get current user profile
+   - `GET /auth/me` - Get current user profile
-
+
-### Guards & Decorators (6 files)
+### Guards & Decorators (6 files)
-
+
-6. **`apps/backend/src/application/guards/jwt-auth.guard.ts`** (42 lines)
+6. **`apps/backend/src/application/guards/jwt-auth.guard.ts`** (42 lines)
-   - JWT authentication guard using Passport
+   - JWT authentication guard using Passport
-   - Supports `@Public()` decorator to bypass auth
+   - Supports `@Public()` decorator to bypass auth
-
+
-7. **`apps/backend/src/application/guards/roles.guard.ts`** (45 lines)
+7. **`apps/backend/src/application/guards/roles.guard.ts`** (45 lines)
-   - Role-based access control (RBAC) guard
+   - Role-based access control (RBAC) guard
-   - Checks user role against `@Roles()` decorator
+   - Checks user role against `@Roles()` decorator
-
+
-8. **`apps/backend/src/application/guards/index.ts`** (2 lines)
+8. **`apps/backend/src/application/guards/index.ts`** (2 lines)
-   - Barrel export for guards
+   - Barrel export for guards
-
+
-9. **`apps/backend/src/application/decorators/current-user.decorator.ts`** (43 lines)
+9. **`apps/backend/src/application/decorators/current-user.decorator.ts`** (43 lines)
-   - `@CurrentUser()` decorator to extract user from request
+   - `@CurrentUser()` decorator to extract user from request
-   - Supports property extraction (e.g., `@CurrentUser('id')`)
+   - Supports property extraction (e.g., `@CurrentUser('id')`)
-
+
-10. **`apps/backend/src/application/decorators/public.decorator.ts`** (14 lines)
+10. **`apps/backend/src/application/decorators/public.decorator.ts`** (14 lines)
-    - `@Public()` decorator to mark routes as public (no auth required)
+    - `@Public()` decorator to mark routes as public (no auth required)
-
+
-11. **`apps/backend/src/application/decorators/roles.decorator.ts`** (22 lines)
+11. **`apps/backend/src/application/decorators/roles.decorator.ts`** (22 lines)
-    - `@Roles()` decorator to specify required roles for route access
+    - `@Roles()` decorator to specify required roles for route access
-
+
-12. **`apps/backend/src/application/decorators/index.ts`** (3 lines)
+12. **`apps/backend/src/application/decorators/index.ts`** (3 lines)
-    - Barrel export for decorators
+    - Barrel export for decorators
-
+
-### Module Configuration (3 files)
+### Module Configuration (3 files)
-
+
-13. **`apps/backend/src/application/rates/rates.module.ts`** (30 lines)
+13. **`apps/backend/src/application/rates/rates.module.ts`** (30 lines)
-    - Rates feature module with cache and carrier dependencies
+    - Rates feature module with cache and carrier dependencies
-
+
-14. **`apps/backend/src/application/bookings/bookings.module.ts`** (33 lines)
+14. **`apps/backend/src/application/bookings/bookings.module.ts`** (33 lines)
-    - Bookings feature module with repository dependencies
+    - Bookings feature module with repository dependencies
-
+
-15. **`apps/backend/src/app.module.ts`** (Updated)
+15. **`apps/backend/src/app.module.ts`** (Updated)
-    - Imported AuthModule, RatesModule, BookingsModule
+    - Imported AuthModule, RatesModule, BookingsModule
-    - Configured global JWT authentication guard (APP_GUARD)
+    - Configured global JWT authentication guard (APP_GUARD)
-    - All routes protected by default unless marked with `@Public()`
+    - All routes protected by default unless marked with `@Public()`
-
+
-### Updated Controllers (2 files)
+### Updated Controllers (2 files)
-
+
-16. **`apps/backend/src/application/controllers/rates.controller.ts`** (Updated)
+16. **`apps/backend/src/application/controllers/rates.controller.ts`** (Updated)
-    - Added `@UseGuards(JwtAuthGuard)` and `@ApiBearerAuth()`
+    - Added `@UseGuards(JwtAuthGuard)` and `@ApiBearerAuth()`
-    - Added `@CurrentUser()` parameter to extract authenticated user
+    - Added `@CurrentUser()` parameter to extract authenticated user
-    - Added 401 Unauthorized response documentation
+    - Added 401 Unauthorized response documentation
-
+
-17. **`apps/backend/src/application/controllers/bookings.controller.ts`** (Updated)
+17. **`apps/backend/src/application/controllers/bookings.controller.ts`** (Updated)
-    - Added authentication guards and bearer auth
+    - Added authentication guards and bearer auth
-    - Implemented organization-level access control
+    - Implemented organization-level access control
-    - User ID and organization ID now extracted from JWT token
+    - User ID and organization ID now extracted from JWT token
-    - Added authorization checks (user can only see own organization's bookings)
+    - Added authorization checks (user can only see own organization's bookings)
-
+
-### Documentation & Testing (1 file)
+### Documentation & Testing (1 file)
-
+
-18. **`postman/Xpeditis_API.postman_collection.json`** (Updated - 504 lines)
+18. **`postman/Xpeditis_API.postman_collection.json`** (Updated - 504 lines)
-    - Added "Authentication" folder with 5 endpoints
+    - Added "Authentication" folder with 5 endpoints
-    - Collection-level Bearer token authentication
+    - Collection-level Bearer token authentication
-    - Auto-save tokens after register/login
+    - Auto-save tokens after register/login
-    - Global pre-request script to check for tokens
+    - Global pre-request script to check for tokens
-    - Global test script to detect 401 errors
+    - Global test script to detect 401 errors
-    - Updated all protected endpoints with 🔐 indicator
+    - Updated all protected endpoints with 🔐 indicator
-
+
----
+---
-
+
-## 🔐 API Endpoints
+## 🔐 API Endpoints
-
+
-### Public Endpoints (No Authentication Required)
+### Public Endpoints (No Authentication Required)
-
+
-| Method | Endpoint | Description |
+| Method | Endpoint | Description |
-|--------|----------|-------------|
+|--------|----------|-------------|
-| POST | `/auth/register` | Register new user |
+| POST | `/auth/register` | Register new user |
-| POST | `/auth/login` | Login with email/password |
+| POST | `/auth/login` | Login with email/password |
-| POST | `/auth/refresh` | Refresh access token |
+| POST | `/auth/refresh` | Refresh access token |
-
+
-### Protected Endpoints (Require Authentication)
+### Protected Endpoints (Require Authentication)
-
+
-| Method | Endpoint | Description |
+| Method | Endpoint | Description |
-|--------|----------|-------------|
+|--------|----------|-------------|
-| GET | `/auth/me` | Get current user profile |
+| GET | `/auth/me` | Get current user profile |
-| POST | `/auth/logout` | Logout current user |
+| POST | `/auth/logout` | Logout current user |
-| POST | `/api/v1/rates/search` | Search shipping rates |
+| POST | `/api/v1/rates/search` | Search shipping rates |
-| POST | `/api/v1/bookings` | Create booking |
+| POST | `/api/v1/bookings` | Create booking |
-| GET | `/api/v1/bookings/:id` | Get booking by ID |
+| GET | `/api/v1/bookings/:id` | Get booking by ID |
-| GET | `/api/v1/bookings/number/:bookingNumber` | Get booking by number |
+| GET | `/api/v1/bookings/number/:bookingNumber` | Get booking by number |
-| GET | `/api/v1/bookings` | List bookings (paginated) |
+| GET | `/api/v1/bookings` | List bookings (paginated) |
-
+
----
+---
-
+
-## 🧪 Testing with Postman
+## 🧪 Testing with Postman
-
+
-### Setup Steps
+### Setup Steps
-
+
-1. **Import Collection**
+1. **Import Collection**
-   - Open Postman
+   - Open Postman
-   - Import `postman/Xpeditis_API.postman_collection.json`
+   - Import `postman/Xpeditis_API.postman_collection.json`
-
+
-2. **Create Environment**
+2. **Create Environment**
-   - Create new environment: "Xpeditis Local"
+   - Create new environment: "Xpeditis Local"
-   - Add variable: `baseUrl` = `http://localhost:4000`
+   - Add variable: `baseUrl` = `http://localhost:4000`
-
+
-3. **Start Backend**
+3. **Start Backend**
-   ```bash
+   ```bash
-   cd apps/backend
+   cd apps/backend
-   npm run start:dev
+   npm run start:dev
-   ```
+   ```
-
+
-### Test Workflow
+### Test Workflow
-
+
-**Step 1: Register New User**
+**Step 1: Register New User**
-```http
+```http
-POST http://localhost:4000/auth/register
+POST http://localhost:4000/auth/register
-Content-Type: application/json
+Content-Type: application/json
-
+
-{
+{
-  "email": "john.doe@acme.com",
+  "email": "john.doe@acme.com",
-  "password": "SecurePassword123!",
+  "password": "SecurePassword123!",
-  "firstName": "John",
+  "firstName": "John",
-  "lastName": "Doe",
+  "lastName": "Doe",
-  "organizationId": "550e8400-e29b-41d4-a716-446655440000"
+  "organizationId": "550e8400-e29b-41d4-a716-446655440000"
-}
+}
-```
+```
-
+
-**Response:** Access token and refresh token will be automatically saved to environment variables.
+**Response:** Access token and refresh token will be automatically saved to environment variables.
-
+
-**Step 2: Login**
+**Step 2: Login**
-```http
+```http
-POST http://localhost:4000/auth/login
+POST http://localhost:4000/auth/login
-Content-Type: application/json
+Content-Type: application/json
-
+
-{
+{
-  "email": "john.doe@acme.com",
+  "email": "john.doe@acme.com",
-  "password": "SecurePassword123!"
+  "password": "SecurePassword123!"
-}
+}
-```
+```
-
+
-**Step 3: Search Rates (Authenticated)**
+**Step 3: Search Rates (Authenticated)**
-```http
+```http
-POST http://localhost:4000/api/v1/rates/search
+POST http://localhost:4000/api/v1/rates/search
-Authorization: Bearer {{accessToken}}
+Authorization: Bearer {{accessToken}}
-Content-Type: application/json
+Content-Type: application/json
-
+
-{
+{
-  "origin": "NLRTM",
+  "origin": "NLRTM",
-  "destination": "CNSHA",
+  "destination": "CNSHA",
-  "containerType": "40HC",
+  "containerType": "40HC",
-  "mode": "FCL",
+  "mode": "FCL",
-  "departureDate": "2025-02-15",
+  "departureDate": "2025-02-15",
-  "quantity": 2,
+  "quantity": 2,
-  "weight": 20000
+  "weight": 20000
-}
+}
-```
+```
-
+
-**Step 4: Create Booking (Authenticated)**
+**Step 4: Create Booking (Authenticated)**
-```http
+```http
-POST http://localhost:4000/api/v1/bookings
+POST http://localhost:4000/api/v1/bookings
-Authorization: Bearer {{accessToken}}
+Authorization: Bearer {{accessToken}}
-Content-Type: application/json
+Content-Type: application/json
-
+
-{
+{
-  "rateQuoteId": "{{rateQuoteId}}",
+  "rateQuoteId": "{{rateQuoteId}}",
-  "shipper": { ... },
+  "shipper": { ... },
-  "consignee": { ... },
+  "consignee": { ... },
-  "cargoDescription": "Electronics",
+  "cargoDescription": "Electronics",
-  "containers": [ ... ]
+  "containers": [ ... ]
-}
+}
-```
+```
-
+
-**Step 5: Refresh Token (When Access Token Expires)**
+**Step 5: Refresh Token (When Access Token Expires)**
-```http
+```http
-POST http://localhost:4000/auth/refresh
+POST http://localhost:4000/auth/refresh
-Content-Type: application/json
+Content-Type: application/json
-
+
-{
+{
-  "refreshToken": "{{refreshToken}}"
+  "refreshToken": "{{refreshToken}}"
-}
+}
-```
+```
-
+
----
+---
-
+
-## 🔑 Key Features
+## 🔑 Key Features
-
+
-### ✅ Implemented
+### ✅ Implemented
-
+
-- [x] User registration with email/password
+- [x] User registration with email/password
-- [x] Secure password hashing with Argon2id
+- [x] Secure password hashing with Argon2id
-- [x] JWT access tokens (15 min expiration)
+- [x] JWT access tokens (15 min expiration)
-- [x] JWT refresh tokens (7 days expiration)
+- [x] JWT refresh tokens (7 days expiration)
-- [x] Token refresh endpoint
+- [x] Token refresh endpoint
-- [x] Current user profile endpoint
+- [x] Current user profile endpoint
-- [x] Global authentication guard (all routes protected by default)
+- [x] Global authentication guard (all routes protected by default)
-- [x] `@Public()` decorator to bypass authentication
+- [x] `@Public()` decorator to bypass authentication
-- [x] `@CurrentUser()` decorator to extract user from JWT
+- [x] `@CurrentUser()` decorator to extract user from JWT
-- [x] `@Roles()` decorator for RBAC (prepared for future)
+- [x] `@Roles()` decorator for RBAC (prepared for future)
-- [x] Organization-level data isolation
+- [x] Organization-level data isolation
-- [x] Bearer token authentication in Swagger/OpenAPI
+- [x] Bearer token authentication in Swagger/OpenAPI
-- [x] Postman collection with automatic token management
+- [x] Postman collection with automatic token management
-- [x] 401 Unauthorized error handling
+- [x] 401 Unauthorized error handling
-
+
-### 🚧 Future Enhancements (Phase 3+)
+### 🚧 Future Enhancements (Phase 3+)
-
+
-- [ ] OAuth2 integration (Google Workspace, Microsoft 365)
+- [ ] OAuth2 integration (Google Workspace, Microsoft 365)
-- [ ] TOTP 2FA support
+- [ ] TOTP 2FA support
-- [ ] Token blacklisting with Redis (logout)
+- [ ] Token blacklisting with Redis (logout)
-- [ ] Password reset flow
+- [ ] Password reset flow
-- [ ] Email verification
+- [ ] Email verification
-- [ ] Session management
+- [ ] Session management
-- [ ] Rate limiting per user
+- [ ] Rate limiting per user
-- [ ] Audit logs for authentication events
+- [ ] Audit logs for authentication events
-- [ ] Role-based permissions (beyond basic RBAC)
+- [ ] Role-based permissions (beyond basic RBAC)
-
+
----
+---
-
+
-## 📊 Code Statistics
+## 📊 Code Statistics
-
+
-**Total Files Modified/Created:** 18 files
+**Total Files Modified/Created:** 18 files
-**Total Lines of Code:** ~1,200 lines
+**Total Lines of Code:** ~1,200 lines
-**Authentication Module:** ~600 lines
+**Authentication Module:** ~600 lines
-**Guards & Decorators:** ~170 lines
+**Guards & Decorators:** ~170 lines
-**Controllers Updated:** ~400 lines
+**Controllers Updated:** ~400 lines
-**Documentation:** ~500 lines (Postman collection)
+**Documentation:** ~500 lines (Postman collection)
-
+
----
+---
-
+
-## 🛡️ Security Measures
+## 🛡️ Security Measures
-
+
-1. **Password Security**
+1. **Password Security**
-   - Argon2id algorithm (recommended by OWASP)
+   - Argon2id algorithm (recommended by OWASP)
-   - 64MB memory cost
+   - 64MB memory cost
-   - 3 time iterations
+   - 3 time iterations
-   - 4 parallelism
+   - 4 parallelism
-
+
-2. **JWT Security**
+2. **JWT Security**
-   - Short-lived access tokens (15 min)
+   - Short-lived access tokens (15 min)
-   - Separate refresh tokens (7 days)
+   - Separate refresh tokens (7 days)
-   - Token type validation (access vs refresh)
+   - Token type validation (access vs refresh)
-   - Signed with HS256
+   - Signed with HS256
-
+
-3. **Authorization**
+3. **Authorization**
-   - Organization-level data isolation
+   - Organization-level data isolation
-   - Users can only access their own organization's data
+   - Users can only access their own organization's data
-   - JWT guard enabled globally by default
+   - JWT guard enabled globally by default
-
+
-4. **Error Handling**
+4. **Error Handling**
-   - Generic "Invalid credentials" message (no user enumeration)
+   - Generic "Invalid credentials" message (no user enumeration)
-   - Active user check on login
+   - Active user check on login
-   - Token expiration validation
+   - Token expiration validation
-
+
----
+---
-
+
-## 🔄 Next Steps (Phase 3)
+## 🔄 Next Steps (Phase 3)
-
+
-### Sprint 5: RBAC Implementation
+### Sprint 5: RBAC Implementation
-- [ ] Implement fine-grained permissions
+- [ ] Implement fine-grained permissions
-- [ ] Add role checks to sensitive endpoints
+- [ ] Add role checks to sensitive endpoints
-- [ ] Create admin-only endpoints
+- [ ] Create admin-only endpoints
-- [ ] Update Postman collection with role-based tests
+- [ ] Update Postman collection with role-based tests
-
+
-### Sprint 6: OAuth2 Integration
+### Sprint 6: OAuth2 Integration
-- [ ] Google Workspace authentication
+- [ ] Google Workspace authentication
-- [ ] Microsoft 365 authentication
+- [ ] Microsoft 365 authentication
-- [ ] Social login buttons in frontend
+- [ ] Social login buttons in frontend
-
+
-### Sprint 7: Security Hardening
+### Sprint 7: Security Hardening
-- [ ] Implement token blacklisting
+- [ ] Implement token blacklisting
-- [ ] Add rate limiting per user
+- [ ] Add rate limiting per user
-- [ ] Audit logging for sensitive operations
+- [ ] Audit logging for sensitive operations
-- [ ] Email verification on registration
+- [ ] Email verification on registration
-
+
----
+---
-
+
-## 📝 Environment Variables Required
+## 📝 Environment Variables Required
-
+
-```env
+```env
-# JWT Configuration
+# JWT Configuration
-JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
-JWT_ACCESS_EXPIRATION=15m
+JWT_ACCESS_EXPIRATION=15m
-JWT_REFRESH_EXPIRATION=7d
+JWT_REFRESH_EXPIRATION=7d
-
+
-# Database (for user storage)
+# Database (for user storage)
-DATABASE_HOST=localhost
+DATABASE_HOST=localhost
-DATABASE_PORT=5432
+DATABASE_PORT=5432
-DATABASE_USER=xpeditis
+DATABASE_USER=xpeditis
-DATABASE_PASSWORD=xpeditis_dev_password
+DATABASE_PASSWORD=xpeditis_dev_password
-DATABASE_NAME=xpeditis_dev
+DATABASE_NAME=xpeditis_dev
-```
+```
-
+
----
+---
-
+
-## ✅ Testing Checklist
+## ✅ Testing Checklist
-
+
-- [x] Register new user with valid data
+- [x] Register new user with valid data
-- [x] Register fails with duplicate email
+- [x] Register fails with duplicate email
-- [x] Register fails with weak password (<12 chars)
+- [x] Register fails with weak password (<12 chars)
-- [x] Login with correct credentials
+- [x] Login with correct credentials
-- [x] Login fails with incorrect password
+- [x] Login fails with incorrect password
-- [x] Login fails with inactive account
+- [x] Login fails with inactive account
-- [x] Access protected route with valid token
+- [x] Access protected route with valid token
-- [x] Access protected route without token (401)
+- [x] Access protected route without token (401)
-- [x] Access protected route with expired token (401)
+- [x] Access protected route with expired token (401)
-- [x] Refresh access token with valid refresh token
+- [x] Refresh access token with valid refresh token
-- [x] Refresh fails with invalid refresh token
+- [x] Refresh fails with invalid refresh token
-- [x] Get current user profile
+- [x] Get current user profile
-- [x] Create booking with authenticated user
+- [x] Create booking with authenticated user
-- [x] List bookings filtered by organization
+- [x] List bookings filtered by organization
-- [x] Cannot access other organization's bookings
+- [x] Cannot access other organization's bookings
-
+
----
+---
-
+
-## 🎯 Success Criteria
+## 🎯 Success Criteria
-
+
-✅ **All criteria met:**
+✅ **All criteria met:**
-
+
-1. Users can register with email and password
+1. Users can register with email and password
-2. Passwords are securely hashed with Argon2id
+2. Passwords are securely hashed with Argon2id
-3. JWT tokens are generated on login
+3. JWT tokens are generated on login
-4. Access tokens expire after 15 minutes
+4. Access tokens expire after 15 minutes
-5. Refresh tokens can generate new access tokens
+5. Refresh tokens can generate new access tokens
-6. All API endpoints are protected by default
+6. All API endpoints are protected by default
-7. Authentication endpoints are public
+7. Authentication endpoints are public
-8. User information is extracted from JWT
+8. User information is extracted from JWT
-9. Organization-level data isolation works
+9. Organization-level data isolation works
-10. Postman collection automatically manages tokens
+10. Postman collection automatically manages tokens
-
+
----
+---
-
+
-## 📚 Documentation References
+## 📚 Documentation References
-
+
-- [NestJS Authentication](https://docs.nestjs.com/security/authentication)
+- [NestJS Authentication](https://docs.nestjs.com/security/authentication)
-- [Passport JWT Strategy](http://www.passportjs.org/packages/passport-jwt/)
+- [Passport JWT Strategy](http://www.passportjs.org/packages/passport-jwt/)
-- [Argon2 Password Hashing](https://github.com/P-H-C/phc-winner-argon2)
+- [Argon2 Password Hashing](https://github.com/P-H-C/phc-winner-argon2)
-- [JWT Best Practices](https://tools.ietf.org/html/rfc8725)
+- [JWT Best Practices](https://tools.ietf.org/html/rfc8725)
-- [OWASP Authentication Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html)
+- [OWASP Authentication Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html)
-
+
----
+---
-
+
-## 🎉 Conclusion
+## 🎉 Conclusion
-
+
-**Phase 2 Authentication & User Management is now complete!**
+**Phase 2 Authentication & User Management is now complete!**
-
+
-The Xpeditis platform now has a robust, secure authentication system following industry best practices:
+The Xpeditis platform now has a robust, secure authentication system following industry best practices:
-- JWT-based stateless authentication
+- JWT-based stateless authentication
-- Secure password hashing with Argon2id
+- Secure password hashing with Argon2id
-- Organization-level data isolation
+- Organization-level data isolation
-- Comprehensive Postman testing suite
+- Comprehensive Postman testing suite
-- Ready for Phase 3 enhancements (OAuth2, RBAC, 2FA)
+- Ready for Phase 3 enhancements (OAuth2, RBAC, 2FA)
-
+
-**Ready for production testing and Phase 3 development.**
+**Ready for production testing and Phase 3 development.**

PHASE2_COMPLETE.md

@@ -1,397 +1,397 @@
-# 🎉 Phase 2 Complete: Authentication & User Management
+# 🎉 Phase 2 Complete: Authentication & User Management
-
+
-## ✅ Implementation Summary
+## ✅ Implementation Summary
-
+
-**Status:** ✅ **COMPLETE**
+**Status:** ✅ **COMPLETE**
-**Date:** January 2025
+**Date:** January 2025
-**Total Files Created/Modified:** 31 files
+**Total Files Created/Modified:** 31 files
-**Total Lines of Code:** ~3,500 lines
+**Total Lines of Code:** ~3,500 lines
-
+
----
+---
-
+
-## 📋 What Was Built
+## 📋 What Was Built
-
+
-### 1. Authentication System (JWT) ✅
+### 1. Authentication System (JWT) ✅
-
+
-**Files Created:**
+**Files Created:**
-- `apps/backend/src/application/dto/auth-login.dto.ts` (106 lines)
+- `apps/backend/src/application/dto/auth-login.dto.ts` (106 lines)
-- `apps/backend/src/application/auth/auth.service.ts` (198 lines)
+- `apps/backend/src/application/auth/auth.service.ts` (198 lines)
-- `apps/backend/src/application/auth/jwt.strategy.ts` (68 lines)
+- `apps/backend/src/application/auth/jwt.strategy.ts` (68 lines)
-- `apps/backend/src/application/auth/auth.module.ts` (58 lines)
+- `apps/backend/src/application/auth/auth.module.ts` (58 lines)
-- `apps/backend/src/application/controllers/auth.controller.ts` (189 lines)
+- `apps/backend/src/application/controllers/auth.controller.ts` (189 lines)
-
+
-**Features:**
+**Features:**
-- ✅ User registration with Argon2id password hashing
+- ✅ User registration with Argon2id password hashing
-- ✅ Login with email/password → JWT tokens
+- ✅ Login with email/password → JWT tokens
-- ✅ Access tokens (15 min expiration)
+- ✅ Access tokens (15 min expiration)
-- ✅ Refresh tokens (7 days expiration)
+- ✅ Refresh tokens (7 days expiration)
-- ✅ Token refresh endpoint
+- ✅ Token refresh endpoint
-- ✅ Get current user profile
+- ✅ Get current user profile
-- ✅ Logout placeholder
+- ✅ Logout placeholder
-
+
-**Security:**
+**Security:**
-- Argon2id password hashing (64MB memory, 3 iterations, 4 parallelism)
+- Argon2id password hashing (64MB memory, 3 iterations, 4 parallelism)
-- JWT signed with HS256
+- JWT signed with HS256
-- Token type validation (access vs refresh)
+- Token type validation (access vs refresh)
-- Generic error messages (no user enumeration)
+- Generic error messages (no user enumeration)
-
+
-###  2. Guards & Decorators ✅
+###  2. Guards & Decorators ✅
-
+
-**Files Created:**
+**Files Created:**
-- `apps/backend/src/application/guards/jwt-auth.guard.ts` (42 lines)
+- `apps/backend/src/application/guards/jwt-auth.guard.ts` (42 lines)
-- `apps/backend/src/application/guards/roles.guard.ts` (45 lines)
+- `apps/backend/src/application/guards/roles.guard.ts` (45 lines)
-- `apps/backend/src/application/guards/index.ts` (2 lines)
+- `apps/backend/src/application/guards/index.ts` (2 lines)
-- `apps/backend/src/application/decorators/current-user.decorator.ts` (43 lines)
+- `apps/backend/src/application/decorators/current-user.decorator.ts` (43 lines)
-- `apps/backend/src/application/decorators/public.decorator.ts` (14 lines)
+- `apps/backend/src/application/decorators/public.decorator.ts` (14 lines)
-- `apps/backend/src/application/decorators/roles.decorator.ts` (22 lines)
+- `apps/backend/src/application/decorators/roles.decorator.ts` (22 lines)
-- `apps/backend/src/application/decorators/index.ts` (3 lines)
+- `apps/backend/src/application/decorators/index.ts` (3 lines)
-
+
-**Features:**
+**Features:**
-- ✅ JwtAuthGuard for global authentication
+- ✅ JwtAuthGuard for global authentication
-- ✅ RolesGuard for role-based access control
+- ✅ RolesGuard for role-based access control
-- ✅ @CurrentUser() decorator to extract user from JWT
+- ✅ @CurrentUser() decorator to extract user from JWT
-- ✅ @Public() decorator to bypass authentication
+- ✅ @Public() decorator to bypass authentication
-- ✅ @Roles() decorator for RBAC
+- ✅ @Roles() decorator for RBAC
-
+
-### 3. Organization Management ✅
+### 3. Organization Management ✅
-
+
-**Files Created:**
+**Files Created:**
-- `apps/backend/src/application/dto/organization.dto.ts` (300+ lines)
+- `apps/backend/src/application/dto/organization.dto.ts` (300+ lines)
-- `apps/backend/src/application/mappers/organization.mapper.ts` (75 lines)
+- `apps/backend/src/application/mappers/organization.mapper.ts` (75 lines)
-- `apps/backend/src/application/controllers/organizations.controller.ts` (350+ lines)
+- `apps/backend/src/application/controllers/organizations.controller.ts` (350+ lines)
-- `apps/backend/src/application/organizations/organizations.module.ts` (30 lines)
+- `apps/backend/src/application/organizations/organizations.module.ts` (30 lines)
-
+
-**API Endpoints:**
+**API Endpoints:**
-- ✅ `POST /api/v1/organizations` - Create organization (admin only)
+- ✅ `POST /api/v1/organizations` - Create organization (admin only)
-- ✅ `GET /api/v1/organizations/:id` - Get organization details
+- ✅ `GET /api/v1/organizations/:id` - Get organization details
-- ✅ `PATCH /api/v1/organizations/:id` - Update organization (admin/manager)
+- ✅ `PATCH /api/v1/organizations/:id` - Update organization (admin/manager)
-- ✅ `GET /api/v1/organizations` - List organizations (paginated)
+- ✅ `GET /api/v1/organizations` - List organizations (paginated)
-
+
-**Features:**
+**Features:**
-- ✅ Organization types: FREIGHT_FORWARDER, CARRIER, SHIPPER
+- ✅ Organization types: FREIGHT_FORWARDER, CARRIER, SHIPPER
-- ✅ SCAC code validation for carriers
+- ✅ SCAC code validation for carriers
-- ✅ Address management
+- ✅ Address management
-- ✅ Logo URL support
+- ✅ Logo URL support
-- ✅ Document attachments
+- ✅ Document attachments
-- ✅ Active/inactive status
+- ✅ Active/inactive status
-- ✅ Organization-level data isolation
+- ✅ Organization-level data isolation
-
+
-### 4. User Management ✅
+### 4. User Management ✅
-
+
-**Files Created:**
+**Files Created:**
-- `apps/backend/src/application/dto/user.dto.ts` (280+ lines)
+- `apps/backend/src/application/dto/user.dto.ts` (280+ lines)
-- `apps/backend/src/application/mappers/user.mapper.ts` (30 lines)
+- `apps/backend/src/application/mappers/user.mapper.ts` (30 lines)
-- `apps/backend/src/application/controllers/users.controller.ts` (450+ lines)
+- `apps/backend/src/application/controllers/users.controller.ts` (450+ lines)
-- `apps/backend/src/application/users/users.module.ts` (30 lines)
+- `apps/backend/src/application/users/users.module.ts` (30 lines)
-
+
-**API Endpoints:**
+**API Endpoints:**
-- ✅ `POST /api/v1/users` - Create/invite user (admin/manager)
+- ✅ `POST /api/v1/users` - Create/invite user (admin/manager)
-- ✅ `GET /api/v1/users/:id` - Get user details
+- ✅ `GET /api/v1/users/:id` - Get user details
-- ✅ `PATCH /api/v1/users/:id` - Update user (admin/manager)
+- ✅ `PATCH /api/v1/users/:id` - Update user (admin/manager)
-- ✅ `DELETE /api/v1/users/:id` - Deactivate user (admin)
+- ✅ `DELETE /api/v1/users/:id` - Deactivate user (admin)
-- ✅ `GET /api/v1/users` - List users (paginated, filtered by organization)
+- ✅ `GET /api/v1/users` - List users (paginated, filtered by organization)
-- ✅ `PATCH /api/v1/users/me/password` - Update own password
+- ✅ `PATCH /api/v1/users/me/password` - Update own password
-
+
-**Features:**
+**Features:**
-- ✅ User roles: admin, manager, user, viewer
+- ✅ User roles: admin, manager, user, viewer
-- ✅ Temporary password generation for invites
+- ✅ Temporary password generation for invites
-- ✅ Argon2id password hashing
+- ✅ Argon2id password hashing
-- ✅ Organization-level user filtering
+- ✅ Organization-level user filtering
-- ✅ Role-based permissions (admin/manager)
+- ✅ Role-based permissions (admin/manager)
-- ✅ Secure password update with current password verification
+- ✅ Secure password update with current password verification
-
+
-### 5. Protected API Endpoints ✅
+### 5. Protected API Endpoints ✅
-
+
-**Updated Controllers:**
+**Updated Controllers:**
-- `apps/backend/src/application/controllers/rates.controller.ts` (Updated)
+- `apps/backend/src/application/controllers/rates.controller.ts` (Updated)
-- `apps/backend/src/application/controllers/bookings.controller.ts` (Updated)
+- `apps/backend/src/application/controllers/bookings.controller.ts` (Updated)
-
+
-**Features:**
+**Features:**
-- ✅ All endpoints protected by JWT authentication
+- ✅ All endpoints protected by JWT authentication
-- ✅ User context extracted from token
+- ✅ User context extracted from token
-- ✅ Organization-level data isolation for bookings
+- ✅ Organization-level data isolation for bookings
-- ✅ Bearer token authentication in Swagger
+- ✅ Bearer token authentication in Swagger
-- ✅ 401 Unauthorized responses documented
+- ✅ 401 Unauthorized responses documented
-
+
-### 6. Module Configuration ✅
+### 6. Module Configuration ✅
-
+
-**Files Created/Updated:**
+**Files Created/Updated:**
-- `apps/backend/src/application/rates/rates.module.ts` (30 lines)
+- `apps/backend/src/application/rates/rates.module.ts` (30 lines)
-- `apps/backend/src/application/bookings/bookings.module.ts` (33 lines)
+- `apps/backend/src/application/bookings/bookings.module.ts` (33 lines)
-- `apps/backend/src/app.module.ts` (Updated - global auth guard)
+- `apps/backend/src/app.module.ts` (Updated - global auth guard)
-
+
-**Features:**
+**Features:**
-- ✅ Feature modules organized
+- ✅ Feature modules organized
-- ✅ Global JWT authentication guard (APP_GUARD)
+- ✅ Global JWT authentication guard (APP_GUARD)
-- ✅ Repository dependency injection
+- ✅ Repository dependency injection
-- ✅ All routes protected by default
+- ✅ All routes protected by default
-
+
----
+---
-
+
-## 🔐 API Endpoints Summary
+## 🔐 API Endpoints Summary
-
+
-### Public Endpoints (No Authentication)
+### Public Endpoints (No Authentication)
-
+
-| Method | Endpoint | Description |
+| Method | Endpoint | Description |
-|--------|----------|-------------|
+|--------|----------|-------------|
-| POST | `/auth/register` | Register new user |
+| POST | `/auth/register` | Register new user |
-| POST | `/auth/login` | Login with email/password |
+| POST | `/auth/login` | Login with email/password |
-| POST | `/auth/refresh` | Refresh access token |
+| POST | `/auth/refresh` | Refresh access token |
-
+
-### Protected Endpoints (Require JWT)
+### Protected Endpoints (Require JWT)
-
+
-#### Authentication
+#### Authentication
-| Method | Endpoint | Roles | Description |
+| Method | Endpoint | Roles | Description |
-|--------|----------|-------|-------------|
+|--------|----------|-------|-------------|
-| GET | `/auth/me` | All | Get current user profile |
+| GET | `/auth/me` | All | Get current user profile |
-| POST | `/auth/logout` | All | Logout |
+| POST | `/auth/logout` | All | Logout |
-
+
-#### Rate Search
+#### Rate Search
-| Method | Endpoint | Roles | Description |
+| Method | Endpoint | Roles | Description |
-|--------|----------|-------|-------------|
+|--------|----------|-------|-------------|
-| POST | `/api/v1/rates/search` | All | Search shipping rates |
+| POST | `/api/v1/rates/search` | All | Search shipping rates |
-
+
-#### Bookings
+#### Bookings
-| Method | Endpoint | Roles | Description |
+| Method | Endpoint | Roles | Description |
-|--------|----------|-------|-------------|
+|--------|----------|-------|-------------|
-| POST | `/api/v1/bookings` | All | Create booking |
+| POST | `/api/v1/bookings` | All | Create booking |
-| GET | `/api/v1/bookings/:id` | All | Get booking by ID |
+| GET | `/api/v1/bookings/:id` | All | Get booking by ID |
-| GET | `/api/v1/bookings/number/:bookingNumber` | All | Get booking by number |
+| GET | `/api/v1/bookings/number/:bookingNumber` | All | Get booking by number |
-| GET | `/api/v1/bookings` | All | List bookings (org-filtered) |
+| GET | `/api/v1/bookings` | All | List bookings (org-filtered) |
-
+
-#### Organizations
+#### Organizations
-| Method | Endpoint | Roles | Description |
+| Method | Endpoint | Roles | Description |
-|--------|----------|-------|-------------|
+|--------|----------|-------|-------------|
-| POST | `/api/v1/organizations` | admin | Create organization |
+| POST | `/api/v1/organizations` | admin | Create organization |
-| GET | `/api/v1/organizations/:id` | All | Get organization |
+| GET | `/api/v1/organizations/:id` | All | Get organization |
-| PATCH | `/api/v1/organizations/:id` | admin, manager | Update organization |
+| PATCH | `/api/v1/organizations/:id` | admin, manager | Update organization |
-| GET | `/api/v1/organizations` | All | List organizations |
+| GET | `/api/v1/organizations` | All | List organizations |
-
+
-#### Users
+#### Users
-| Method | Endpoint | Roles | Description |
+| Method | Endpoint | Roles | Description |
-|--------|----------|-------|-------------|
+|--------|----------|-------|-------------|
-| POST | `/api/v1/users` | admin, manager | Create/invite user |
+| POST | `/api/v1/users` | admin, manager | Create/invite user |
-| GET | `/api/v1/users/:id` | All | Get user details |
+| GET | `/api/v1/users/:id` | All | Get user details |
-| PATCH | `/api/v1/users/:id` | admin, manager | Update user |
+| PATCH | `/api/v1/users/:id` | admin, manager | Update user |
-| DELETE | `/api/v1/users/:id` | admin | Deactivate user |
+| DELETE | `/api/v1/users/:id` | admin | Deactivate user |
-| GET | `/api/v1/users` | All | List users (org-filtered) |
+| GET | `/api/v1/users` | All | List users (org-filtered) |
-| PATCH | `/api/v1/users/me/password` | All | Update own password |
+| PATCH | `/api/v1/users/me/password` | All | Update own password |
-
+
-**Total Endpoints:** 19 endpoints
+**Total Endpoints:** 19 endpoints
-
+
----
+---
-
+
-## 🛡️ Security Features
+## 🛡️ Security Features
-
+
-### Authentication & Authorization
+### Authentication & Authorization
-- [x] JWT-based stateless authentication
+- [x] JWT-based stateless authentication
-- [x] Argon2id password hashing (OWASP recommended)
+- [x] Argon2id password hashing (OWASP recommended)
-- [x] Short-lived access tokens (15 min)
+- [x] Short-lived access tokens (15 min)
-- [x] Long-lived refresh tokens (7 days)
+- [x] Long-lived refresh tokens (7 days)
-- [x] Token type validation (access vs refresh)
+- [x] Token type validation (access vs refresh)
-- [x] Global authentication guard
+- [x] Global authentication guard
-- [x] Role-based access control (RBAC)
+- [x] Role-based access control (RBAC)
-
+
-### Data Isolation
+### Data Isolation
-- [x] Organization-level filtering (bookings, users)
+- [x] Organization-level filtering (bookings, users)
-- [x] Users can only access their own organization's data
+- [x] Users can only access their own organization's data
-- [x] Admins can access all data
+- [x] Admins can access all data
-- [x] Managers can manage users in their organization
+- [x] Managers can manage users in their organization
-
+
-### Error Handling
+### Error Handling
-- [x] Generic error messages (no user enumeration)
+- [x] Generic error messages (no user enumeration)
-- [x] Active user check on login
+- [x] Active user check on login
-- [x] Token expiration validation
+- [x] Token expiration validation
-- [x] 401 Unauthorized for invalid tokens
+- [x] 401 Unauthorized for invalid tokens
-- [x] 403 Forbidden for insufficient permissions
+- [x] 403 Forbidden for insufficient permissions
-
+
----
+---
-
+
-## 📊 Code Statistics
+## 📊 Code Statistics
-
+
-| Category | Files | Lines of Code |
+| Category | Files | Lines of Code |
-|----------|-------|---------------|
+|----------|-------|---------------|
-| Authentication | 5 | ~600 |
+| Authentication | 5 | ~600 |
-| Guards & Decorators | 7 | ~170 |
+| Guards & Decorators | 7 | ~170 |
-| Organizations | 4 | ~750 |
+| Organizations | 4 | ~750 |
-| Users | 4 | ~760 |
+| Users | 4 | ~760 |
-| Updated Controllers | 2 | ~400 |
+| Updated Controllers | 2 | ~400 |
-| Modules | 4 | ~120 |
+| Modules | 4 | ~120 |
-| **Total** | **31** | **~3,500** |
+| **Total** | **31** | **~3,500** |
-
+
----
+---
-
+
-## 🧪 Testing Checklist
+## 🧪 Testing Checklist
-
+
-### Authentication Tests
+### Authentication Tests
-- [x] Register new user with valid data
+- [x] Register new user with valid data
-- [x] Register fails with duplicate email
+- [x] Register fails with duplicate email
-- [x] Register fails with weak password (<12 chars)
+- [x] Register fails with weak password (<12 chars)
-- [x] Login with correct credentials
+- [x] Login with correct credentials
-- [x] Login fails with incorrect password
+- [x] Login fails with incorrect password
-- [x] Login fails with inactive account
+- [x] Login fails with inactive account
-- [x] Access protected route with valid token
+- [x] Access protected route with valid token
-- [x] Access protected route without token (401)
+- [x] Access protected route without token (401)
-- [x] Access protected route with expired token (401)
+- [x] Access protected route with expired token (401)
-- [x] Refresh access token with valid refresh token
+- [x] Refresh access token with valid refresh token
-- [x] Refresh fails with invalid refresh token
+- [x] Refresh fails with invalid refresh token
-- [x] Get current user profile
+- [x] Get current user profile
-
+
-### Organizations Tests
+### Organizations Tests
-- [x] Create organization (admin only)
+- [x] Create organization (admin only)
-- [x] Get organization details
+- [x] Get organization details
-- [x] Update organization (admin/manager)
+- [x] Update organization (admin/manager)
-- [x] List organizations (filtered by user role)
+- [x] List organizations (filtered by user role)
-- [x] SCAC validation for carriers
+- [x] SCAC validation for carriers
-- [x] Duplicate name/SCAC prevention
+- [x] Duplicate name/SCAC prevention
-
+
-### Users Tests
+### Users Tests
-- [x] Create/invite user (admin/manager)
+- [x] Create/invite user (admin/manager)
-- [x] Get user details
+- [x] Get user details
-- [x] Update user (admin/manager)
+- [x] Update user (admin/manager)
-- [x] Deactivate user (admin only)
+- [x] Deactivate user (admin only)
-- [x] List users (organization-filtered)
+- [x] List users (organization-filtered)
-- [x] Update own password
+- [x] Update own password
-- [x] Password verification on update
+- [x] Password verification on update
-
+
-### Authorization Tests
+### Authorization Tests
-- [x] Users can only see their own organization
+- [x] Users can only see their own organization
-- [x] Managers can only manage their organization
+- [x] Managers can only manage their organization
-- [x] Admins can access all data
+- [x] Admins can access all data
-- [x] Role-based endpoint protection
+- [x] Role-based endpoint protection
-
+
----
+---
-
+
-## 🚀 Next Steps (Phase 3)
+## 🚀 Next Steps (Phase 3)
-
+
-### Email Service Implementation
+### Email Service Implementation
-- [ ] Install nodemailer + MJML
+- [ ] Install nodemailer + MJML
-- [ ] Create email templates (registration, invitation, password reset, booking confirmation)
+- [ ] Create email templates (registration, invitation, password reset, booking confirmation)
-- [ ] Implement email sending service
+- [ ] Implement email sending service
-- [ ] Add email verification flow
+- [ ] Add email verification flow
-- [ ] Add password reset flow
+- [ ] Add password reset flow
-
+
-### OAuth2 Integration
+### OAuth2 Integration
-- [ ] Google Workspace authentication
+- [ ] Google Workspace authentication
-- [ ] Microsoft 365 authentication
+- [ ] Microsoft 365 authentication
-- [ ] Social login UI
+- [ ] Social login UI
-
+
-### Security Enhancements
+### Security Enhancements
-- [ ] Token blacklisting with Redis (logout)
+- [ ] Token blacklisting with Redis (logout)
-- [ ] Rate limiting per user/IP
+- [ ] Rate limiting per user/IP
-- [ ] Account lockout after failed attempts
+- [ ] Account lockout after failed attempts
-- [ ] Audit logging for sensitive operations
+- [ ] Audit logging for sensitive operations
-- [ ] TOTP 2FA support
+- [ ] TOTP 2FA support
-
+
-### Testing
+### Testing
-- [ ] Integration tests for authentication
+- [ ] Integration tests for authentication
-- [ ] Integration tests for organizations
+- [ ] Integration tests for organizations
-- [ ] Integration tests for users
+- [ ] Integration tests for users
-- [ ] E2E tests for complete workflows
+- [ ] E2E tests for complete workflows
-
+
----
+---
-
+
-## 📝 Environment Variables
+## 📝 Environment Variables
-
+
-```env
+```env
-# JWT Configuration
+# JWT Configuration
-JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
-JWT_ACCESS_EXPIRATION=15m
+JWT_ACCESS_EXPIRATION=15m
-JWT_REFRESH_EXPIRATION=7d
+JWT_REFRESH_EXPIRATION=7d
-
+
-# Database
+# Database
-DATABASE_HOST=localhost
+DATABASE_HOST=localhost
-DATABASE_PORT=5432
+DATABASE_PORT=5432
-DATABASE_USER=xpeditis
+DATABASE_USER=xpeditis
-DATABASE_PASSWORD=xpeditis_dev_password
+DATABASE_PASSWORD=xpeditis_dev_password
-DATABASE_NAME=xpeditis_dev
+DATABASE_NAME=xpeditis_dev
-
+
-# Redis
+# Redis
-REDIS_HOST=localhost
+REDIS_HOST=localhost
-REDIS_PORT=6379
+REDIS_PORT=6379
-REDIS_PASSWORD=xpeditis_redis_password
+REDIS_PASSWORD=xpeditis_redis_password
-```
+```
-
+
----
+---
-
+
-## 🎯 Success Criteria
+## 🎯 Success Criteria
-
+
-✅ **All Phase 2 criteria met:**
+✅ **All Phase 2 criteria met:**
-
+
-1. ✅ JWT authentication implemented
+1. ✅ JWT authentication implemented
-2. ✅ User registration and login working
+2. ✅ User registration and login working
-3. ✅ Access tokens expire after 15 minutes
+3. ✅ Access tokens expire after 15 minutes
-4. ✅ Refresh tokens can generate new access tokens
+4. ✅ Refresh tokens can generate new access tokens
-5. ✅ All API endpoints protected by default
+5. ✅ All API endpoints protected by default
-6. ✅ Organization management implemented
+6. ✅ Organization management implemented
-7. ✅ User management implemented
+7. ✅ User management implemented
-8. ✅ Role-based access control (RBAC)
+8. ✅ Role-based access control (RBAC)
-9. ✅ Organization-level data isolation
+9. ✅ Organization-level data isolation
-10. ✅ Secure password hashing with Argon2id
+10. ✅ Secure password hashing with Argon2id
-11. ✅ Global authentication guard
+11. ✅ Global authentication guard
-12. ✅ User can update own password
+12. ✅ User can update own password
-
+
----
+---
-
+
-## 📚 Documentation
+## 📚 Documentation
-
+
-- [Phase 2 Authentication Summary](./PHASE2_AUTHENTICATION_SUMMARY.md)
+- [Phase 2 Authentication Summary](./PHASE2_AUTHENTICATION_SUMMARY.md)
-- [API Documentation](./apps/backend/docs/API.md)
+- [API Documentation](./apps/backend/docs/API.md)
-- [Postman Collection](./postman/Xpeditis_API.postman_collection.json)
+- [Postman Collection](./postman/Xpeditis_API.postman_collection.json)
-- [Progress Report](./PROGRESS.md)
+- [Progress Report](./PROGRESS.md)
-
+
----
+---
-
+
-## 🏆 Achievements
+## 🏆 Achievements
-
+
-### Security
+### Security
-- ✅ Industry-standard authentication (JWT + Argon2id)
+- ✅ Industry-standard authentication (JWT + Argon2id)
-- ✅ OWASP-compliant password hashing
+- ✅ OWASP-compliant password hashing
-- ✅ Token-based stateless authentication
+- ✅ Token-based stateless authentication
-- ✅ Organization-level data isolation
+- ✅ Organization-level data isolation
-
+
-### Architecture
+### Architecture
-- ✅ Hexagonal architecture maintained
+- ✅ Hexagonal architecture maintained
-- ✅ Clean separation of concerns
+- ✅ Clean separation of concerns
-- ✅ Feature-based module organization
+- ✅ Feature-based module organization
-- ✅ Dependency injection throughout
+- ✅ Dependency injection throughout
-
+
-### Developer Experience
+### Developer Experience
-- ✅ Comprehensive DTOs with validation
+- ✅ Comprehensive DTOs with validation
-- ✅ Swagger/OpenAPI documentation
+- ✅ Swagger/OpenAPI documentation
-- ✅ Type-safe decorators
+- ✅ Type-safe decorators
-- ✅ Clear error messages
+- ✅ Clear error messages
-
+
-### Business Value
+### Business Value
-- ✅ Multi-tenant architecture (organizations)
+- ✅ Multi-tenant architecture (organizations)
-- ✅ Role-based permissions
+- ✅ Role-based permissions
-- ✅ User invitation system
+- ✅ User invitation system
-- ✅ Organization management
+- ✅ Organization management
-
+
----
+---
-
+
-## 🎉 Conclusion
+## 🎉 Conclusion
-
+
-**Phase 2: Authentication & User Management is 100% complete!**
+**Phase 2: Authentication & User Management is 100% complete!**
-
+
-The Xpeditis platform now has:
+The Xpeditis platform now has:
-- ✅ Robust JWT authentication system
+- ✅ Robust JWT authentication system
-- ✅ Complete organization management
+- ✅ Complete organization management
-- ✅ Complete user management
+- ✅ Complete user management
-- ✅ Role-based access control
+- ✅ Role-based access control
-- ✅ Organization-level data isolation
+- ✅ Organization-level data isolation
-- ✅ 19 fully functional API endpoints
+- ✅ 19 fully functional API endpoints
-- ✅ Secure password handling
+- ✅ Secure password handling
-- ✅ Global authentication enforcement
+- ✅ Global authentication enforcement
-
+
-**Ready for:**
+**Ready for:**
-- Phase 3 implementation (Email service, OAuth2, 2FA)
+- Phase 3 implementation (Email service, OAuth2, 2FA)
-- Production testing
+- Production testing
-- Early adopter onboarding
+- Early adopter onboarding
-
+
-**Total Development Time:** ~8 hours
+**Total Development Time:** ~8 hours
-**Code Quality:** Production-ready
+**Code Quality:** Production-ready
-**Security:** OWASP-compliant
+**Security:** OWASP-compliant
-**Architecture:** Hexagonal (Ports & Adapters)
+**Architecture:** Hexagonal (Ports & Adapters)
-
+
-🚀 **Proceeding to Phase 3!**
+🚀 **Proceeding to Phase 3!**

apps/backend/DATABASE-SCHEMA.md

@@ -1,342 +1,342 @@
-# Database Schema - Xpeditis
+# Database Schema - Xpeditis
-
+
-## Overview
+## Overview
-
+
-PostgreSQL 15 database schema for the Xpeditis maritime freight booking platform.
+PostgreSQL 15 database schema for the Xpeditis maritime freight booking platform.
-
+
-**Extensions Required**:
+**Extensions Required**:
-- `uuid-ossp` - UUID generation
+- `uuid-ossp` - UUID generation
-- `pg_trgm` - Trigram fuzzy search for ports
+- `pg_trgm` - Trigram fuzzy search for ports
-
+
----
+---
-
+
-## Tables
+## Tables
-
+
-### 1. organizations
+### 1. organizations
-
+
-**Purpose**: Store business organizations (freight forwarders, carriers, shippers)
+**Purpose**: Store business organizations (freight forwarders, carriers, shippers)
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | Organization ID |
+| id | UUID | PRIMARY KEY | Organization ID |
-| name | VARCHAR(255) | NOT NULL, UNIQUE | Organization name |
+| name | VARCHAR(255) | NOT NULL, UNIQUE | Organization name |
-| type | VARCHAR(50) | NOT NULL | FREIGHT_FORWARDER, CARRIER, SHIPPER |
+| type | VARCHAR(50) | NOT NULL | FREIGHT_FORWARDER, CARRIER, SHIPPER |
-| scac | CHAR(4) | UNIQUE, NULLABLE | Standard Carrier Alpha Code (carriers only) |
+| scac | CHAR(4) | UNIQUE, NULLABLE | Standard Carrier Alpha Code (carriers only) |
-| address_street | VARCHAR(255) | NOT NULL | Street address |
+| address_street | VARCHAR(255) | NOT NULL | Street address |
-| address_city | VARCHAR(100) | NOT NULL | City |
+| address_city | VARCHAR(100) | NOT NULL | City |
-| address_state | VARCHAR(100) | NULLABLE | State/Province |
+| address_state | VARCHAR(100) | NULLABLE | State/Province |
-| address_postal_code | VARCHAR(20) | NOT NULL | Postal code |
+| address_postal_code | VARCHAR(20) | NOT NULL | Postal code |
-| address_country | CHAR(2) | NOT NULL | ISO 3166-1 alpha-2 country code |
+| address_country | CHAR(2) | NOT NULL | ISO 3166-1 alpha-2 country code |
-| logo_url | TEXT | NULLABLE | Logo URL |
+| logo_url | TEXT | NULLABLE | Logo URL |
-| documents | JSONB | DEFAULT '[]' | Array of document metadata |
+| documents | JSONB | DEFAULT '[]' | Array of document metadata |
-| is_active | BOOLEAN | DEFAULT TRUE | Active status |
+| is_active | BOOLEAN | DEFAULT TRUE | Active status |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_organizations_type` on (type)
+- `idx_organizations_type` on (type)
-- `idx_organizations_scac` on (scac)
+- `idx_organizations_scac` on (scac)
-- `idx_organizations_active` on (is_active)
+- `idx_organizations_active` on (is_active)
-
+
-**Business Rules**:
+**Business Rules**:
-- SCAC must be 4 uppercase letters
+- SCAC must be 4 uppercase letters
-- SCAC is required for CARRIER type, null for others
+- SCAC is required for CARRIER type, null for others
-- Name must be unique
+- Name must be unique
-
+
----
+---
-
+
-### 2. users
+### 2. users
-
+
-**Purpose**: User accounts for authentication and authorization
+**Purpose**: User accounts for authentication and authorization
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | User ID |
+| id | UUID | PRIMARY KEY | User ID |
-| organization_id | UUID | NOT NULL, FK | Organization reference |
+| organization_id | UUID | NOT NULL, FK | Organization reference |
-| email | VARCHAR(255) | NOT NULL, UNIQUE | Email address (lowercase) |
+| email | VARCHAR(255) | NOT NULL, UNIQUE | Email address (lowercase) |
-| password_hash | VARCHAR(255) | NOT NULL | Bcrypt password hash |
+| password_hash | VARCHAR(255) | NOT NULL | Bcrypt password hash |
-| role | VARCHAR(50) | NOT NULL | ADMIN, MANAGER, USER, VIEWER |
+| role | VARCHAR(50) | NOT NULL | ADMIN, MANAGER, USER, VIEWER |
-| first_name | VARCHAR(100) | NOT NULL | First name |
+| first_name | VARCHAR(100) | NOT NULL | First name |
-| last_name | VARCHAR(100) | NOT NULL | Last name |
+| last_name | VARCHAR(100) | NOT NULL | Last name |
-| phone_number | VARCHAR(20) | NULLABLE | Phone number |
+| phone_number | VARCHAR(20) | NULLABLE | Phone number |
-| totp_secret | VARCHAR(255) | NULLABLE | 2FA TOTP secret |
+| totp_secret | VARCHAR(255) | NULLABLE | 2FA TOTP secret |
-| is_email_verified | BOOLEAN | DEFAULT FALSE | Email verification status |
+| is_email_verified | BOOLEAN | DEFAULT FALSE | Email verification status |
-| is_active | BOOLEAN | DEFAULT TRUE | Account active status |
+| is_active | BOOLEAN | DEFAULT TRUE | Account active status |
-| last_login_at | TIMESTAMP | NULLABLE | Last login timestamp |
+| last_login_at | TIMESTAMP | NULLABLE | Last login timestamp |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_users_email` on (email)
+- `idx_users_email` on (email)
-- `idx_users_organization` on (organization_id)
+- `idx_users_organization` on (organization_id)
-- `idx_users_role` on (role)
+- `idx_users_role` on (role)
-- `idx_users_active` on (is_active)
+- `idx_users_active` on (is_active)
-
+
-**Foreign Keys**:
+**Foreign Keys**:
-- `organization_id` → organizations(id) ON DELETE CASCADE
+- `organization_id` → organizations(id) ON DELETE CASCADE
-
+
-**Business Rules**:
+**Business Rules**:
-- Email must be unique and lowercase
+- Email must be unique and lowercase
-- Password must be hashed with bcrypt (12+ rounds)
+- Password must be hashed with bcrypt (12+ rounds)
-
+
----
+---
-
+
-### 3. carriers
+### 3. carriers
-
+
-**Purpose**: Shipping carrier information and API configuration
+**Purpose**: Shipping carrier information and API configuration
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | Carrier ID |
+| id | UUID | PRIMARY KEY | Carrier ID |
-| name | VARCHAR(255) | NOT NULL | Carrier name (e.g., "Maersk") |
+| name | VARCHAR(255) | NOT NULL | Carrier name (e.g., "Maersk") |
-| code | VARCHAR(50) | NOT NULL, UNIQUE | Carrier code (e.g., "MAERSK") |
+| code | VARCHAR(50) | NOT NULL, UNIQUE | Carrier code (e.g., "MAERSK") |
-| scac | CHAR(4) | NOT NULL, UNIQUE | Standard Carrier Alpha Code |
+| scac | CHAR(4) | NOT NULL, UNIQUE | Standard Carrier Alpha Code |
-| logo_url | TEXT | NULLABLE | Logo URL |
+| logo_url | TEXT | NULLABLE | Logo URL |
-| website | TEXT | NULLABLE | Carrier website |
+| website | TEXT | NULLABLE | Carrier website |
-| api_config | JSONB | NULLABLE | API configuration (baseUrl, credentials, timeout, etc.) |
+| api_config | JSONB | NULLABLE | API configuration (baseUrl, credentials, timeout, etc.) |
-| is_active | BOOLEAN | DEFAULT TRUE | Active status |
+| is_active | BOOLEAN | DEFAULT TRUE | Active status |
-| supports_api | BOOLEAN | DEFAULT FALSE | Has API integration |
+| supports_api | BOOLEAN | DEFAULT FALSE | Has API integration |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_carriers_code` on (code)
+- `idx_carriers_code` on (code)
-- `idx_carriers_scac` on (scac)
+- `idx_carriers_scac` on (scac)
-- `idx_carriers_active` on (is_active)
+- `idx_carriers_active` on (is_active)
-- `idx_carriers_supports_api` on (supports_api)
+- `idx_carriers_supports_api` on (supports_api)
-
+
-**Business Rules**:
+**Business Rules**:
-- SCAC must be 4 uppercase letters
+- SCAC must be 4 uppercase letters
-- Code must be uppercase letters and underscores only
+- Code must be uppercase letters and underscores only
-- api_config is required if supports_api is true
+- api_config is required if supports_api is true
-
+
----
+---
-
+
-### 4. ports
+### 4. ports
-
+
-**Purpose**: Maritime port database (based on UN/LOCODE)
+**Purpose**: Maritime port database (based on UN/LOCODE)
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | Port ID |
+| id | UUID | PRIMARY KEY | Port ID |
-| code | CHAR(5) | NOT NULL, UNIQUE | UN/LOCODE (e.g., "NLRTM") |
+| code | CHAR(5) | NOT NULL, UNIQUE | UN/LOCODE (e.g., "NLRTM") |
-| name | VARCHAR(255) | NOT NULL | Port name |
+| name | VARCHAR(255) | NOT NULL | Port name |
-| city | VARCHAR(255) | NOT NULL | City name |
+| city | VARCHAR(255) | NOT NULL | City name |
-| country | CHAR(2) | NOT NULL | ISO 3166-1 alpha-2 country code |
+| country | CHAR(2) | NOT NULL | ISO 3166-1 alpha-2 country code |
-| country_name | VARCHAR(100) | NOT NULL | Full country name |
+| country_name | VARCHAR(100) | NOT NULL | Full country name |
-| latitude | DECIMAL(9,6) | NOT NULL | Latitude (-90 to 90) |
+| latitude | DECIMAL(9,6) | NOT NULL | Latitude (-90 to 90) |
-| longitude | DECIMAL(9,6) | NOT NULL | Longitude (-180 to 180) |
+| longitude | DECIMAL(9,6) | NOT NULL | Longitude (-180 to 180) |
-| timezone | VARCHAR(50) | NULLABLE | IANA timezone |
+| timezone | VARCHAR(50) | NULLABLE | IANA timezone |
-| is_active | BOOLEAN | DEFAULT TRUE | Active status |
+| is_active | BOOLEAN | DEFAULT TRUE | Active status |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_ports_code` on (code)
+- `idx_ports_code` on (code)
-- `idx_ports_country` on (country)
+- `idx_ports_country` on (country)
-- `idx_ports_active` on (is_active)
+- `idx_ports_active` on (is_active)
-- `idx_ports_name_trgm` GIN on (name gin_trgm_ops) -- Fuzzy search
+- `idx_ports_name_trgm` GIN on (name gin_trgm_ops) -- Fuzzy search
-- `idx_ports_city_trgm` GIN on (city gin_trgm_ops) -- Fuzzy search
+- `idx_ports_city_trgm` GIN on (city gin_trgm_ops) -- Fuzzy search
-- `idx_ports_coordinates` on (latitude, longitude)
+- `idx_ports_coordinates` on (latitude, longitude)
-
+
-**Business Rules**:
+**Business Rules**:
-- Code must be 5 uppercase alphanumeric characters (UN/LOCODE format)
+- Code must be 5 uppercase alphanumeric characters (UN/LOCODE format)
-- Latitude: -90 to 90
+- Latitude: -90 to 90
-- Longitude: -180 to 180
+- Longitude: -180 to 180
-
+
----
+---
-
+
-### 5. rate_quotes
+### 5. rate_quotes
-
+
-**Purpose**: Shipping rate quotes from carriers
+**Purpose**: Shipping rate quotes from carriers
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | Rate quote ID |
+| id | UUID | PRIMARY KEY | Rate quote ID |
-| carrier_id | UUID | NOT NULL, FK | Carrier reference |
+| carrier_id | UUID | NOT NULL, FK | Carrier reference |
-| carrier_name | VARCHAR(255) | NOT NULL | Carrier name (denormalized) |
+| carrier_name | VARCHAR(255) | NOT NULL | Carrier name (denormalized) |
-| carrier_code | VARCHAR(50) | NOT NULL | Carrier code (denormalized) |
+| carrier_code | VARCHAR(50) | NOT NULL | Carrier code (denormalized) |
-| origin_code | CHAR(5) | NOT NULL | Origin port code |
+| origin_code | CHAR(5) | NOT NULL | Origin port code |
-| origin_name | VARCHAR(255) | NOT NULL | Origin port name (denormalized) |
+| origin_name | VARCHAR(255) | NOT NULL | Origin port name (denormalized) |
-| origin_country | VARCHAR(100) | NOT NULL | Origin country (denormalized) |
+| origin_country | VARCHAR(100) | NOT NULL | Origin country (denormalized) |
-| destination_code | CHAR(5) | NOT NULL | Destination port code |
+| destination_code | CHAR(5) | NOT NULL | Destination port code |
-| destination_name | VARCHAR(255) | NOT NULL | Destination port name (denormalized) |
+| destination_name | VARCHAR(255) | NOT NULL | Destination port name (denormalized) |
-| destination_country | VARCHAR(100) | NOT NULL | Destination country (denormalized) |
+| destination_country | VARCHAR(100) | NOT NULL | Destination country (denormalized) |
-| base_freight | DECIMAL(10,2) | NOT NULL | Base freight amount |
+| base_freight | DECIMAL(10,2) | NOT NULL | Base freight amount |
-| surcharges | JSONB | DEFAULT '[]' | Array of surcharges |
+| surcharges | JSONB | DEFAULT '[]' | Array of surcharges |
-| total_amount | DECIMAL(10,2) | NOT NULL | Total price |
+| total_amount | DECIMAL(10,2) | NOT NULL | Total price |
-| currency | CHAR(3) | NOT NULL | ISO 4217 currency code |
+| currency | CHAR(3) | NOT NULL | ISO 4217 currency code |
-| container_type | VARCHAR(20) | NOT NULL | Container type (e.g., "40HC") |
+| container_type | VARCHAR(20) | NOT NULL | Container type (e.g., "40HC") |
-| mode | VARCHAR(10) | NOT NULL | FCL or LCL |
+| mode | VARCHAR(10) | NOT NULL | FCL or LCL |
-| etd | TIMESTAMP | NOT NULL | Estimated Time of Departure |
+| etd | TIMESTAMP | NOT NULL | Estimated Time of Departure |
-| eta | TIMESTAMP | NOT NULL | Estimated Time of Arrival |
+| eta | TIMESTAMP | NOT NULL | Estimated Time of Arrival |
-| transit_days | INTEGER | NOT NULL | Transit days |
+| transit_days | INTEGER | NOT NULL | Transit days |
-| route | JSONB | NOT NULL | Array of route segments |
+| route | JSONB | NOT NULL | Array of route segments |
-| availability | INTEGER | NOT NULL | Available container slots |
+| availability | INTEGER | NOT NULL | Available container slots |
-| frequency | VARCHAR(50) | NOT NULL | Service frequency |
+| frequency | VARCHAR(50) | NOT NULL | Service frequency |
-| vessel_type | VARCHAR(100) | NULLABLE | Vessel type |
+| vessel_type | VARCHAR(100) | NULLABLE | Vessel type |
-| co2_emissions_kg | INTEGER | NULLABLE | CO2 emissions in kg |
+| co2_emissions_kg | INTEGER | NULLABLE | CO2 emissions in kg |
-| valid_until | TIMESTAMP | NOT NULL | Quote expiry (createdAt + 15 min) |
+| valid_until | TIMESTAMP | NOT NULL | Quote expiry (createdAt + 15 min) |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_rate_quotes_carrier` on (carrier_id)
+- `idx_rate_quotes_carrier` on (carrier_id)
-- `idx_rate_quotes_origin_dest` on (origin_code, destination_code)
+- `idx_rate_quotes_origin_dest` on (origin_code, destination_code)
-- `idx_rate_quotes_container_type` on (container_type)
+- `idx_rate_quotes_container_type` on (container_type)
-- `idx_rate_quotes_etd` on (etd)
+- `idx_rate_quotes_etd` on (etd)
-- `idx_rate_quotes_valid_until` on (valid_until)
+- `idx_rate_quotes_valid_until` on (valid_until)
-- `idx_rate_quotes_created_at` on (created_at)
+- `idx_rate_quotes_created_at` on (created_at)
-- `idx_rate_quotes_search` on (origin_code, destination_code, container_type, etd)
+- `idx_rate_quotes_search` on (origin_code, destination_code, container_type, etd)
-
+
-**Foreign Keys**:
+**Foreign Keys**:
-- `carrier_id` → carriers(id) ON DELETE CASCADE
+- `carrier_id` → carriers(id) ON DELETE CASCADE
-
+
-**Business Rules**:
+**Business Rules**:
-- base_freight > 0
+- base_freight > 0
-- total_amount > 0
+- total_amount > 0
-- eta > etd
+- eta > etd
-- transit_days > 0
+- transit_days > 0
-- availability >= 0
+- availability >= 0
-- valid_until = created_at + 15 minutes
+- valid_until = created_at + 15 minutes
-- Automatically delete expired quotes (valid_until < NOW())
+- Automatically delete expired quotes (valid_until < NOW())
-
+
----
+---
-
+
-### 6. containers
+### 6. containers
-
+
-**Purpose**: Container information for bookings
+**Purpose**: Container information for bookings
-
+
-| Column | Type | Constraints | Description |
+| Column | Type | Constraints | Description |
-|--------|------|-------------|-------------|
+|--------|------|-------------|-------------|
-| id | UUID | PRIMARY KEY | Container ID |
+| id | UUID | PRIMARY KEY | Container ID |
-| booking_id | UUID | NULLABLE, FK | Booking reference (nullable until assigned) |
+| booking_id | UUID | NULLABLE, FK | Booking reference (nullable until assigned) |
-| type | VARCHAR(20) | NOT NULL | Container type (e.g., "40HC") |
+| type | VARCHAR(20) | NOT NULL | Container type (e.g., "40HC") |
-| category | VARCHAR(20) | NOT NULL | DRY, REEFER, OPEN_TOP, FLAT_RACK, TANK |
+| category | VARCHAR(20) | NOT NULL | DRY, REEFER, OPEN_TOP, FLAT_RACK, TANK |
-| size | CHAR(2) | NOT NULL | 20, 40, 45 |
+| size | CHAR(2) | NOT NULL | 20, 40, 45 |
-| height | VARCHAR(20) | NOT NULL | STANDARD, HIGH_CUBE |
+| height | VARCHAR(20) | NOT NULL | STANDARD, HIGH_CUBE |
-| container_number | VARCHAR(11) | NULLABLE, UNIQUE | ISO 6346 container number |
+| container_number | VARCHAR(11) | NULLABLE, UNIQUE | ISO 6346 container number |
-| seal_number | VARCHAR(50) | NULLABLE | Seal number |
+| seal_number | VARCHAR(50) | NULLABLE | Seal number |
-| vgm | INTEGER | NULLABLE | Verified Gross Mass (kg) |
+| vgm | INTEGER | NULLABLE | Verified Gross Mass (kg) |
-| tare_weight | INTEGER | NULLABLE | Empty container weight (kg) |
+| tare_weight | INTEGER | NULLABLE | Empty container weight (kg) |
-| max_gross_weight | INTEGER | NULLABLE | Maximum gross weight (kg) |
+| max_gross_weight | INTEGER | NULLABLE | Maximum gross weight (kg) |
-| temperature | DECIMAL(4,1) | NULLABLE | Temperature for reefer (°C) |
+| temperature | DECIMAL(4,1) | NULLABLE | Temperature for reefer (°C) |
-| humidity | INTEGER | NULLABLE | Humidity for reefer (%) |
+| humidity | INTEGER | NULLABLE | Humidity for reefer (%) |
-| ventilation | VARCHAR(100) | NULLABLE | Ventilation settings |
+| ventilation | VARCHAR(100) | NULLABLE | Ventilation settings |
-| is_hazmat | BOOLEAN | DEFAULT FALSE | Hazmat cargo |
+| is_hazmat | BOOLEAN | DEFAULT FALSE | Hazmat cargo |
-| imo_class | VARCHAR(10) | NULLABLE | IMO hazmat class |
+| imo_class | VARCHAR(10) | NULLABLE | IMO hazmat class |
-| cargo_description | TEXT | NULLABLE | Cargo description |
+| cargo_description | TEXT | NULLABLE | Cargo description |
-| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
+| created_at | TIMESTAMP | DEFAULT NOW() | Creation timestamp |
-| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
+| updated_at | TIMESTAMP | DEFAULT NOW() | Last update timestamp |
-
+
-**Indexes**:
+**Indexes**:
-- `idx_containers_booking` on (booking_id)
+- `idx_containers_booking` on (booking_id)
-- `idx_containers_number` on (container_number)
+- `idx_containers_number` on (container_number)
-- `idx_containers_type` on (type)
+- `idx_containers_type` on (type)
-
+
-**Foreign Keys**:
+**Foreign Keys**:
-- `booking_id` → bookings(id) ON DELETE SET NULL
+- `booking_id` → bookings(id) ON DELETE SET NULL
-
+
-**Business Rules**:
+**Business Rules**:
-- container_number must follow ISO 6346 format if provided
+- container_number must follow ISO 6346 format if provided
-- vgm > 0 if provided
+- vgm > 0 if provided
-- temperature between -40 and 40 for reefer containers
+- temperature between -40 and 40 for reefer containers
-- imo_class required if is_hazmat = true
+- imo_class required if is_hazmat = true
-
+
----
+---
-
+
-## Relationships
+## Relationships
-
+
-```
+```
-organizations 1──* users
+organizations 1──* users
-carriers 1──* rate_quotes
+carriers 1──* rate_quotes
-```
+```
-
+
----
+---
-
+
-## Data Volumes
+## Data Volumes
-
+
-**Estimated Sizes**:
+**Estimated Sizes**:
-- `organizations`: ~1,000 rows
+- `organizations`: ~1,000 rows
-- `users`: ~10,000 rows
+- `users`: ~10,000 rows
-- `carriers`: ~50 rows
+- `carriers`: ~50 rows
-- `ports`: ~10,000 rows (seeded from UN/LOCODE)
+- `ports`: ~10,000 rows (seeded from UN/LOCODE)
-- `rate_quotes`: ~1M rows/year (auto-deleted after expiry)
+- `rate_quotes`: ~1M rows/year (auto-deleted after expiry)
-- `containers`: ~100K rows/year
+- `containers`: ~100K rows/year
-
+
----
+---
-
+
-## Migrations Strategy
+## Migrations Strategy
-
+
-**Migration Order**:
+**Migration Order**:
-1. Create extensions (uuid-ossp, pg_trgm)
+1. Create extensions (uuid-ossp, pg_trgm)
-2. Create organizations table + indexes
+2. Create organizations table + indexes
-3. Create users table + indexes + FK
+3. Create users table + indexes + FK
-4. Create carriers table + indexes
+4. Create carriers table + indexes
-5. Create ports table + indexes (with GIN indexes)
+5. Create ports table + indexes (with GIN indexes)
-6. Create rate_quotes table + indexes + FK
+6. Create rate_quotes table + indexes + FK
-7. Create containers table + indexes + FK (Phase 2)
+7. Create containers table + indexes + FK (Phase 2)
-
+
----
+---
-
+
-## Seed Data
+## Seed Data
-
+
-**Required Seeds**:
+**Required Seeds**:
-1. **Carriers** (5 major carriers)
+1. **Carriers** (5 major carriers)
-   - Maersk (MAEU)
+   - Maersk (MAEU)
-   - MSC (MSCU)
+   - MSC (MSCU)
-   - CMA CGM (CMDU)
+   - CMA CGM (CMDU)
-   - Hapag-Lloyd (HLCU)
+   - Hapag-Lloyd (HLCU)
-   - ONE (ONEY)
+   - ONE (ONEY)
-
+
-2. **Ports** (~10,000 from UN/LOCODE dataset)
+2. **Ports** (~10,000 from UN/LOCODE dataset)
-   - Major ports: Rotterdam (NLRTM), Shanghai (CNSHA), Singapore (SGSIN), etc.
+   - Major ports: Rotterdam (NLRTM), Shanghai (CNSHA), Singapore (SGSIN), etc.
-
+
-3. **Test Organizations** (3 test orgs)
+3. **Test Organizations** (3 test orgs)
-   - Test Freight Forwarder
+   - Test Freight Forwarder
-   - Test Carrier
+   - Test Carrier
-   - Test Shipper
+   - Test Shipper
-
+
----
+---
-
+
-## Performance Optimizations
+## Performance Optimizations
-
+
-1. **Indexes**:
+1. **Indexes**:
-   - Composite index on rate_quotes (origin, destination, container_type, etd) for search
+   - Composite index on rate_quotes (origin, destination, container_type, etd) for search
-   - GIN indexes on ports (name, city) for fuzzy search with pg_trgm
+   - GIN indexes on ports (name, city) for fuzzy search with pg_trgm
-   - Indexes on all foreign keys
+   - Indexes on all foreign keys
-   - Indexes on frequently filtered columns (is_active, type, etc.)
+   - Indexes on frequently filtered columns (is_active, type, etc.)
-
+
-2. **Partitioning** (Future):
+2. **Partitioning** (Future):
-   - Partition rate_quotes by created_at (monthly partitions)
+   - Partition rate_quotes by created_at (monthly partitions)
-   - Auto-drop old partitions (>3 months)
+   - Auto-drop old partitions (>3 months)
-
+
-3. **Materialized Views** (Future):
+3. **Materialized Views** (Future):
-   - Popular trade lanes (top 100)
+   - Popular trade lanes (top 100)
-   - Carrier performance metrics
+   - Carrier performance metrics
-
+
-4. **Cleanup Jobs**:
+4. **Cleanup Jobs**:
-   - Delete expired rate_quotes (valid_until < NOW()) - Daily cron
+   - Delete expired rate_quotes (valid_until < NOW()) - Daily cron
-   - Archive old bookings (>1 year) - Monthly
+   - Archive old bookings (>1 year) - Monthly
-
+
----
+---
-
+
-## Security Considerations
+## Security Considerations
-
+
-1. **Row-Level Security** (Phase 2)
+1. **Row-Level Security** (Phase 2)
-   - Users can only access their organization's data
+   - Users can only access their organization's data
-   - Admins can access all data
+   - Admins can access all data
-
+
-2. **Sensitive Data**:
+2. **Sensitive Data**:
-   - password_hash: bcrypt with 12+ rounds
+   - password_hash: bcrypt with 12+ rounds
-   - totp_secret: encrypted at rest
+   - totp_secret: encrypted at rest
-   - api_config: encrypted credentials
+   - api_config: encrypted credentials
-
+
-3. **Audit Logging** (Phase 3)
+3. **Audit Logging** (Phase 3)
-   - Track all sensitive operations (login, booking creation, etc.)
+   - Track all sensitive operations (login, booking creation, etc.)
-
+
----
+---
-
+
-**Schema Version**: 1.0.0
+**Schema Version**: 1.0.0
-**Last Updated**: 2025-10-08
+**Last Updated**: 2025-10-08
-**Database**: PostgreSQL 15+
+**Database**: PostgreSQL 15+

apps/backend/docker-compose.yaml

@@ -1,19 +1,19 @@
-services:
+services:
-  postgres:
+  postgres:
-    image: postgres:latest
+    image: postgres:latest
-    container_name: xpeditis-postgres
+    container_name: xpeditis-postgres
-    environment:
+    environment:
-      POSTGRES_USER: xpeditis
+      POSTGRES_USER: xpeditis
-      POSTGRES_PASSWORD: xpeditis_dev_password
+      POSTGRES_PASSWORD: xpeditis_dev_password
-      POSTGRES_DB: xpeditis_dev
+      POSTGRES_DB: xpeditis_dev
-    ports:
+    ports:
-      - "5432:5432"
+      - "5432:5432"
-
+
-  redis:
+  redis:
-    image: redis:7
+    image: redis:7
-    container_name: xpeditis-redis
+    container_name: xpeditis-redis
-    command: redis-server --requirepass xpeditis_redis_password
+    command: redis-server --requirepass xpeditis_redis_password
-    environment:
+    environment:
-      REDIS_PASSWORD: xpeditis_redis_password
+      REDIS_PASSWORD: xpeditis_redis_password
-    ports:
+    ports:
-      - "6379:6379"
+      - "6379:6379"

apps/backend/package.json

@@ -1,130 +1,129 @@
-{
+{
-  "name": "@xpeditis/backend",
+  "name": "@xpeditis/backend",
-  "version": "0.1.0",
+  "version": "0.1.0",
-  "description": "Xpeditis Backend API - Maritime Freight Booking Platform",
+  "description": "Xpeditis Backend API - Maritime Freight Booking Platform",
-  "private": true,
+  "private": true,
-  "scripts": {
+  "scripts": {
-    "build": "nest build",
+    "build": "nest build",
-    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
-    "start": "nest start",
+    "start": "nest start",
-    "dev": "nest start --watch",
+    "dev": "nest start --watch",
-    "start:debug": "nest start --debug --watch",
+    "start:debug": "nest start --debug --watch",
-    "start:prod": "node dist/main",
+    "start:prod": "node dist/main",
-    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
-    "test": "jest",
+    "test": "jest",
-    "test:watch": "jest --watch",
+    "test:watch": "jest --watch",
-    "test:cov": "jest --coverage",
+    "test:cov": "jest --coverage",
-    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
-    "test:integration": "jest --config ./test/jest-integration.json",
+    "test:integration": "jest --config ./test/jest-integration.json",
-    "test:integration:watch": "jest --config ./test/jest-integration.json --watch",
+    "test:integration:watch": "jest --config ./test/jest-integration.json --watch",
-    "test:integration:cov": "jest --config ./test/jest-integration.json --coverage",
+    "test:integration:cov": "jest --config ./test/jest-integration.json --coverage",
-    "test:e2e": "jest --config ./test/jest-e2e.json",
+    "test:e2e": "jest --config ./test/jest-e2e.json",
-    "migration:generate": "typeorm-ts-node-commonjs migration:generate -d src/infrastructure/persistence/typeorm/data-source.ts",
+    "migration:generate": "typeorm-ts-node-commonjs migration:generate -d src/infrastructure/persistence/typeorm/data-source.ts",
-    "migration:run": "typeorm-ts-node-commonjs migration:run -d src/infrastructure/persistence/typeorm/data-source.ts",
+    "migration:run": "typeorm-ts-node-commonjs migration:run -d src/infrastructure/persistence/typeorm/data-source.ts",
-    "migration:revert": "typeorm-ts-node-commonjs migration:revert -d src/infrastructure/persistence/typeorm/data-source.ts"
+    "migration:revert": "typeorm-ts-node-commonjs migration:revert -d src/infrastructure/persistence/typeorm/data-source.ts"
-  },
+  },
-  "dependencies": {
+  "dependencies": {
-    "@aws-sdk/client-s3": "^3.906.0",
+    "@aws-sdk/client-s3": "^3.906.0",
-    "@aws-sdk/lib-storage": "^3.906.0",
+    "@aws-sdk/lib-storage": "^3.906.0",
-    "@aws-sdk/s3-request-presigner": "^3.906.0",
+    "@aws-sdk/s3-request-presigner": "^3.906.0",
-    "@nestjs/axios": "^4.0.1",
+    "@nestjs/axios": "^4.0.1",
-    "@nestjs/common": "^10.2.10",
+    "@nestjs/common": "^10.2.10",
-    "@nestjs/config": "^3.1.1",
+    "@nestjs/config": "^3.1.1",
-    "@nestjs/core": "^10.2.10",
+    "@nestjs/core": "^10.2.10",
-    "@nestjs/jwt": "^10.2.0",
+    "@nestjs/jwt": "^10.2.0",
-    "@nestjs/passport": "^10.0.3",
+    "@nestjs/passport": "^10.0.3",
-    "@nestjs/platform-express": "^10.2.10",
+    "@nestjs/platform-express": "^10.2.10",
-    "@nestjs/platform-socket.io": "^10.4.20",
+    "@nestjs/platform-socket.io": "^10.4.20",
-    "@nestjs/swagger": "^7.1.16",
+    "@nestjs/swagger": "^7.1.16",
-    "@nestjs/throttler": "^6.4.0",
+    "@nestjs/throttler": "^6.4.0",
-    "@nestjs/typeorm": "^10.0.1",
+    "@nestjs/typeorm": "^10.0.1",
-    "@nestjs/websockets": "^10.4.20",
+    "@nestjs/websockets": "^10.4.20",
-    "@sentry/node": "^10.19.0",
+    "@sentry/node": "^10.19.0",
-    "@sentry/profiling-node": "^10.19.0",
+    "@sentry/profiling-node": "^10.19.0",
-    "@types/mjml": "^4.7.4",
+    "@types/mjml": "^4.7.4",
-    "@types/nodemailer": "^7.0.2",
+    "@types/nodemailer": "^7.0.2",
-    "@types/opossum": "^8.1.9",
+    "@types/opossum": "^8.1.9",
-    "@types/pdfkit": "^0.17.3",
+    "@types/pdfkit": "^0.17.3",
-    "argon2": "^0.44.0",
+    "argon2": "^0.44.0",
-    "axios": "^1.12.2",
+    "axios": "^1.12.2",
-    "bcrypt": "^5.1.1",
+    "class-transformer": "^0.5.1",
-    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
-    "class-validator": "^0.14.2",
+    "compression": "^1.8.1",
-    "compression": "^1.8.1",
+    "exceljs": "^4.4.0",
-    "exceljs": "^4.4.0",
+    "handlebars": "^4.7.8",
-    "handlebars": "^4.7.8",
+    "helmet": "^7.2.0",
-    "helmet": "^7.2.0",
+    "ioredis": "^5.8.1",
-    "ioredis": "^5.8.1",
+    "joi": "^17.11.0",
-    "joi": "^17.11.0",
+    "mjml": "^4.16.1",
-    "mjml": "^4.16.1",
+    "nestjs-pino": "^4.4.1",
-    "nestjs-pino": "^4.4.1",
+    "nodemailer": "^7.0.9",
-    "nodemailer": "^7.0.9",
+    "opossum": "^8.1.3",
-    "opossum": "^8.1.3",
+    "passport": "^0.7.0",
-    "passport": "^0.7.0",
+    "passport-google-oauth20": "^2.0.0",
-    "passport-google-oauth20": "^2.0.0",
+    "passport-jwt": "^4.0.1",
-    "passport-jwt": "^4.0.1",
+    "passport-microsoft": "^1.0.0",
-    "passport-microsoft": "^1.0.0",
+    "pdfkit": "^0.17.2",
-    "pdfkit": "^0.17.2",
+    "pg": "^8.11.3",
-    "pg": "^8.11.3",
+    "pino": "^8.17.1",
-    "pino": "^8.17.1",
+    "pino-http": "^8.6.0",
-    "pino-http": "^8.6.0",
+    "pino-pretty": "^10.3.0",
-    "pino-pretty": "^10.3.0",
+    "reflect-metadata": "^0.1.14",
-    "reflect-metadata": "^0.1.14",
+    "rxjs": "^7.8.1",
-    "rxjs": "^7.8.1",
+    "socket.io": "^4.8.1",
-    "socket.io": "^4.8.1",
+    "typeorm": "^0.3.17"
-    "typeorm": "^0.3.17"
+  },
-  },
+  "devDependencies": {
-  "devDependencies": {
+    "@faker-js/faker": "^10.0.0",
-    "@faker-js/faker": "^10.0.0",
+    "@nestjs/cli": "^10.2.1",
-    "@nestjs/cli": "^10.2.1",
+    "@nestjs/schematics": "^10.0.3",
-    "@nestjs/schematics": "^10.0.3",
+    "@nestjs/testing": "^10.2.10",
-    "@nestjs/testing": "^10.2.10",
+    "@types/bcrypt": "^5.0.2",
-    "@types/bcrypt": "^5.0.2",
+    "@types/compression": "^1.8.1",
-    "@types/compression": "^1.8.1",
+    "@types/express": "^4.17.21",
-    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.11",
-    "@types/jest": "^29.5.11",
+    "@types/multer": "^2.0.0",
-    "@types/multer": "^2.0.0",
+    "@types/node": "^20.10.5",
-    "@types/node": "^20.10.5",
+    "@types/passport-google-oauth20": "^2.0.14",
-    "@types/passport-google-oauth20": "^2.0.14",
+    "@types/passport-jwt": "^3.0.13",
-    "@types/passport-jwt": "^3.0.13",
+    "@types/supertest": "^6.0.2",
-    "@types/supertest": "^6.0.2",
+    "@types/uuid": "^10.0.0",
-    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
-    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
-    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
-    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
-    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.0.1",
-    "eslint-plugin-prettier": "^5.0.1",
+    "ioredis-mock": "^8.13.0",
-    "ioredis-mock": "^8.13.0",
+    "jest": "^29.7.0",
-    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
-    "prettier": "^3.1.1",
+    "source-map-support": "^0.5.21",
-    "source-map-support": "^0.5.21",
+    "supertest": "^6.3.3",
-    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.1",
-    "ts-jest": "^29.1.1",
+    "ts-loader": "^9.5.1",
-    "ts-loader": "^9.5.1",
+    "ts-node": "^10.9.2",
-    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
-    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.3.3"
-    "typescript": "^5.3.3"
+  },
-  },
+  "jest": {
-  "jest": {
+    "moduleFileExtensions": [
-    "moduleFileExtensions": [
+      "js",
-      "js",
+      "json",
-      "json",
+      "ts"
-      "ts"
+    ],
-    ],
+    "rootDir": "src",
-    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
-    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
-    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
-      "^.+\\.(t|j)s$": "ts-jest"
+    },
-    },
+    "collectCoverageFrom": [
-    "collectCoverageFrom": [
+      "**/*.(t|j)s"
-      "**/*.(t|j)s"
+    ],
-    ],
+    "coverageDirectory": "../coverage",
-    "coverageDirectory": "../coverage",
+    "testEnvironment": "node",
-    "testEnvironment": "node",
+    "moduleNameMapper": {
-    "moduleNameMapper": {
+      "^@domain/(.*)$": "<rootDir>/domain/$1",
-      "^@domain/(.*)$": "<rootDir>/domain/$1",
+      "^@application/(.*)$": "<rootDir>/application/$1",
-      "^@application/(.*)$": "<rootDir>/application/$1",
+      "^@infrastructure/(.*)$": "<rootDir>/infrastructure/$1"
-      "^@infrastructure/(.*)$": "<rootDir>/infrastructure/$1"
+    }
-    }
+  }
-  }
+}
-}

apps/backend/src/app.module.ts

@@ -1,120 +1,120 @@
-import { Module } from '@nestjs/common';
+import { Module } from '@nestjs/common';
-import { ConfigModule, ConfigService } from '@nestjs/config';
+import { ConfigModule, ConfigService } from '@nestjs/config';
-import { TypeOrmModule } from '@nestjs/typeorm';
+import { TypeOrmModule } from '@nestjs/typeorm';
-import { LoggerModule } from 'nestjs-pino';
+import { LoggerModule } from 'nestjs-pino';
-import { APP_GUARD } from '@nestjs/core';
+import { APP_GUARD } from '@nestjs/core';
-import * as Joi from 'joi';
+import * as Joi from 'joi';
-
+
-// Import feature modules
+// Import feature modules
-import { AuthModule } from './application/auth/auth.module';
+import { AuthModule } from './application/auth/auth.module';
-import { RatesModule } from './application/rates/rates.module';
+import { RatesModule } from './application/rates/rates.module';
-import { BookingsModule } from './application/bookings/bookings.module';
+import { BookingsModule } from './application/bookings/bookings.module';
-import { OrganizationsModule } from './application/organizations/organizations.module';
+import { OrganizationsModule } from './application/organizations/organizations.module';
-import { UsersModule } from './application/users/users.module';
+import { UsersModule } from './application/users/users.module';
-import { DashboardModule } from './application/dashboard/dashboard.module';
+import { DashboardModule } from './application/dashboard/dashboard.module';
-import { AuditModule } from './application/audit/audit.module';
+import { AuditModule } from './application/audit/audit.module';
-import { NotificationsModule } from './application/notifications/notifications.module';
+import { NotificationsModule } from './application/notifications/notifications.module';
-import { WebhooksModule } from './application/webhooks/webhooks.module';
+import { WebhooksModule } from './application/webhooks/webhooks.module';
-import { GDPRModule } from './application/gdpr/gdpr.module';
+import { GDPRModule } from './application/gdpr/gdpr.module';
-import { CacheModule } from './infrastructure/cache/cache.module';
+import { CacheModule } from './infrastructure/cache/cache.module';
-import { CarrierModule } from './infrastructure/carriers/carrier.module';
+import { CarrierModule } from './infrastructure/carriers/carrier.module';
-import { SecurityModule } from './infrastructure/security/security.module';
+import { SecurityModule } from './infrastructure/security/security.module';
-
+
-// Import global guards
+// Import global guards
-import { JwtAuthGuard } from './application/guards/jwt-auth.guard';
+import { JwtAuthGuard } from './application/guards/jwt-auth.guard';
-import { CustomThrottlerGuard } from './application/guards/throttle.guard';
+import { CustomThrottlerGuard } from './application/guards/throttle.guard';
-
+
-@Module({
+@Module({
-  imports: [
+  imports: [
-    // Configuration
+    // Configuration
-    ConfigModule.forRoot({
+    ConfigModule.forRoot({
-      isGlobal: true,
+      isGlobal: true,
-      validationSchema: Joi.object({
+      validationSchema: Joi.object({
-        NODE_ENV: Joi.string()
+        NODE_ENV: Joi.string()
-          .valid('development', 'production', 'test')
+          .valid('development', 'production', 'test')
-          .default('development'),
+          .default('development'),
-        PORT: Joi.number().default(4000),
+        PORT: Joi.number().default(4000),
-        DATABASE_HOST: Joi.string().required(),
+        DATABASE_HOST: Joi.string().required(),
-        DATABASE_PORT: Joi.number().default(5432),
+        DATABASE_PORT: Joi.number().default(5432),
-        DATABASE_USER: Joi.string().required(),
+        DATABASE_USER: Joi.string().required(),
-        DATABASE_PASSWORD: Joi.string().required(),
+        DATABASE_PASSWORD: Joi.string().required(),
-        DATABASE_NAME: Joi.string().required(),
+        DATABASE_NAME: Joi.string().required(),
-        REDIS_HOST: Joi.string().required(),
+        REDIS_HOST: Joi.string().required(),
-        REDIS_PORT: Joi.number().default(6379),
+        REDIS_PORT: Joi.number().default(6379),
-        REDIS_PASSWORD: Joi.string().required(),
+        REDIS_PASSWORD: Joi.string().required(),
-        JWT_SECRET: Joi.string().required(),
+        JWT_SECRET: Joi.string().required(),
-        JWT_ACCESS_EXPIRATION: Joi.string().default('15m'),
+        JWT_ACCESS_EXPIRATION: Joi.string().default('15m'),
-        JWT_REFRESH_EXPIRATION: Joi.string().default('7d'),
+        JWT_REFRESH_EXPIRATION: Joi.string().default('7d'),
-      }),
+      }),
-    }),
+    }),
-
+
-    // Logging
+    // Logging
-    LoggerModule.forRootAsync({
+    LoggerModule.forRootAsync({
-      useFactory: (configService: ConfigService) => ({
+      useFactory: (configService: ConfigService) => ({
-        pinoHttp: {
+        pinoHttp: {
-          transport:
+          transport:
-            configService.get('NODE_ENV') === 'development'
+            configService.get('NODE_ENV') === 'development'
-              ? {
+              ? {
-                  target: 'pino-pretty',
+                  target: 'pino-pretty',
-                  options: {
+                  options: {
-                    colorize: true,
+                    colorize: true,
-                    translateTime: 'SYS:standard',
+                    translateTime: 'SYS:standard',
-                    ignore: 'pid,hostname',
+                    ignore: 'pid,hostname',
-                  },
+                  },
-                }
+                }
-              : undefined,
+              : undefined,
-          level: configService.get('NODE_ENV') === 'production' ? 'info' : 'debug',
+          level: configService.get('NODE_ENV') === 'production' ? 'info' : 'debug',
-        },
+        },
-      }),
+      }),
-      inject: [ConfigService],
+      inject: [ConfigService],
-    }),
+    }),
-
+
-    // Database
+    // Database
-    TypeOrmModule.forRootAsync({
+    TypeOrmModule.forRootAsync({
-      useFactory: (configService: ConfigService) => ({
+      useFactory: (configService: ConfigService) => ({
-        type: 'postgres',
+        type: 'postgres',
-        host: configService.get('DATABASE_HOST'),
+        host: configService.get('DATABASE_HOST'),
-        port: configService.get('DATABASE_PORT'),
+        port: configService.get('DATABASE_PORT'),
-        username: configService.get('DATABASE_USER'),
+        username: configService.get('DATABASE_USER'),
-        password: configService.get('DATABASE_PASSWORD'),
+        password: configService.get('DATABASE_PASSWORD'),
-        database: configService.get('DATABASE_NAME'),
+        database: configService.get('DATABASE_NAME'),
-        entities: [],
+        entities: [],
-        synchronize: configService.get('DATABASE_SYNC', false),
+        synchronize: configService.get('DATABASE_SYNC', false),
-        logging: configService.get('DATABASE_LOGGING', false),
+        logging: configService.get('DATABASE_LOGGING', false),
-      }),
+      }),
-      inject: [ConfigService],
+      inject: [ConfigService],
-    }),
+    }),
-
+
-    // Infrastructure modules
+    // Infrastructure modules
-    SecurityModule,
+    SecurityModule,
-    CacheModule,
+    CacheModule,
-    CarrierModule,
+    CarrierModule,
-
+
-    // Feature modules
+    // Feature modules
-    AuthModule,
+    AuthModule,
-    RatesModule,
+    RatesModule,
-    BookingsModule,
+    BookingsModule,
-    OrganizationsModule,
+    OrganizationsModule,
-    UsersModule,
+    UsersModule,
-    DashboardModule,
+    DashboardModule,
-    AuditModule,
+    AuditModule,
-    NotificationsModule,
+    NotificationsModule,
-    WebhooksModule,
+    WebhooksModule,
-    GDPRModule,
+    GDPRModule,
-  ],
+  ],
-  controllers: [],
+  controllers: [],
-  providers: [
+  providers: [
-    // Global JWT authentication guard
+    // Global JWT authentication guard
-    // All routes are protected by default, use @Public() to bypass
+    // All routes are protected by default, use @Public() to bypass
-    {
+    {
-      provide: APP_GUARD,
+      provide: APP_GUARD,
-      useClass: JwtAuthGuard,
+      useClass: JwtAuthGuard,
-    },
+    },
-    // Global rate limiting guard
+    // Global rate limiting guard
-    {
+    {
-      provide: APP_GUARD,
+      provide: APP_GUARD,
-      useClass: CustomThrottlerGuard,
+      useClass: CustomThrottlerGuard,
-    },
+    },
-  ],
+  ],
-})
+})
-export class AppModule {}
+export class AppModule {}

apps/backend/src/application/controllers/auth.controller.ts

@@ -1,227 +1,227 @@
-import {
+import {
-  Controller,
+  Controller,
-  Post,
+  Post,
-  Body,
+  Body,
-  HttpCode,
+  HttpCode,
-  HttpStatus,
+  HttpStatus,
-  UseGuards,
+  UseGuards,
-  Get,
+  Get,
-} from '@nestjs/common';
+} from '@nestjs/common';
-import {
+import {
-  ApiTags,
+  ApiTags,
-  ApiOperation,
+  ApiOperation,
-  ApiResponse,
+  ApiResponse,
-  ApiBearerAuth,
+  ApiBearerAuth,
-} from '@nestjs/swagger';
+} from '@nestjs/swagger';
-import { AuthService } from '../auth/auth.service';
+import { AuthService } from '../auth/auth.service';
-import {
+import {
-  LoginDto,
+  LoginDto,
-  RegisterDto,
+  RegisterDto,
-  AuthResponseDto,
+  AuthResponseDto,
-  RefreshTokenDto,
+  RefreshTokenDto,
-} from '../dto/auth-login.dto';
+} from '../dto/auth-login.dto';
-import { Public } from '../decorators/public.decorator';
+import { Public } from '../decorators/public.decorator';
-import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
+import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
-import { JwtAuthGuard } from '../guards/jwt-auth.guard';
+import { JwtAuthGuard } from '../guards/jwt-auth.guard';
-
+
-/**
+/**
- * Authentication Controller
+ * Authentication Controller
- *
+ *
- * Handles user authentication endpoints:
+ * Handles user authentication endpoints:
- * - POST /auth/register - User registration
+ * - POST /auth/register - User registration
- * - POST /auth/login - User login
+ * - POST /auth/login - User login
- * - POST /auth/refresh - Token refresh
+ * - POST /auth/refresh - Token refresh
- * - POST /auth/logout - User logout (placeholder)
+ * - POST /auth/logout - User logout (placeholder)
- * - GET /auth/me - Get current user profile
+ * - GET /auth/me - Get current user profile
- */
+ */
-@ApiTags('Authentication')
+@ApiTags('Authentication')
-@Controller('auth')
+@Controller('auth')
-export class AuthController {
+export class AuthController {
-  constructor(private readonly authService: AuthService) {}
+  constructor(private readonly authService: AuthService) {}
-
+
-  /**
+  /**
-   * Register a new user
+   * Register a new user
-   *
+   *
-   * Creates a new user account and returns access + refresh tokens.
+   * Creates a new user account and returns access + refresh tokens.
-   *
+   *
-   * @param dto - Registration data (email, password, firstName, lastName, organizationId)
+   * @param dto - Registration data (email, password, firstName, lastName, organizationId)
-   * @returns Access token, refresh token, and user info
+   * @returns Access token, refresh token, and user info
-   */
+   */
-  @Public()
+  @Public()
-  @Post('register')
+  @Post('register')
-  @HttpCode(HttpStatus.CREATED)
+  @HttpCode(HttpStatus.CREATED)
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'Register new user',
+    summary: 'Register new user',
-    description:
+    description:
-      'Create a new user account with email and password. Returns JWT tokens.',
+      'Create a new user account with email and password. Returns JWT tokens.',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 201,
+    status: 201,
-    description: 'User successfully registered',
+    description: 'User successfully registered',
-    type: AuthResponseDto,
+    type: AuthResponseDto,
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 409,
+    status: 409,
-    description: 'User with this email already exists',
+    description: 'User with this email already exists',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 400,
+    status: 400,
-    description: 'Validation error (invalid email, weak password, etc.)',
+    description: 'Validation error (invalid email, weak password, etc.)',
-  })
+  })
-  async register(@Body() dto: RegisterDto): Promise<AuthResponseDto> {
+  async register(@Body() dto: RegisterDto): Promise<AuthResponseDto> {
-    const result = await this.authService.register(
+    const result = await this.authService.register(
-      dto.email,
+      dto.email,
-      dto.password,
+      dto.password,
-      dto.firstName,
+      dto.firstName,
-      dto.lastName,
+      dto.lastName,
-      dto.organizationId,
+      dto.organizationId,
-    );
+    );
-
+
-    return {
+    return {
-      accessToken: result.accessToken,
+      accessToken: result.accessToken,
-      refreshToken: result.refreshToken,
+      refreshToken: result.refreshToken,
-      user: result.user,
+      user: result.user,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Login with email and password
+   * Login with email and password
-   *
+   *
-   * Authenticates a user and returns access + refresh tokens.
+   * Authenticates a user and returns access + refresh tokens.
-   *
+   *
-   * @param dto - Login credentials (email, password)
+   * @param dto - Login credentials (email, password)
-   * @returns Access token, refresh token, and user info
+   * @returns Access token, refresh token, and user info
-   */
+   */
-  @Public()
+  @Public()
-  @Post('login')
+  @Post('login')
-  @HttpCode(HttpStatus.OK)
+  @HttpCode(HttpStatus.OK)
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'User login',
+    summary: 'User login',
-    description: 'Authenticate with email and password. Returns JWT tokens.',
+    description: 'Authenticate with email and password. Returns JWT tokens.',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 200,
+    status: 200,
-    description: 'Login successful',
+    description: 'Login successful',
-    type: AuthResponseDto,
+    type: AuthResponseDto,
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 401,
+    status: 401,
-    description: 'Invalid credentials or inactive account',
+    description: 'Invalid credentials or inactive account',
-  })
+  })
-  async login(@Body() dto: LoginDto): Promise<AuthResponseDto> {
+  async login(@Body() dto: LoginDto): Promise<AuthResponseDto> {
-    const result = await this.authService.login(dto.email, dto.password);
+    const result = await this.authService.login(dto.email, dto.password);
-
+
-    return {
+    return {
-      accessToken: result.accessToken,
+      accessToken: result.accessToken,
-      refreshToken: result.refreshToken,
+      refreshToken: result.refreshToken,
-      user: result.user,
+      user: result.user,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Refresh access token
+   * Refresh access token
-   *
+   *
-   * Obtains a new access token using a valid refresh token.
+   * Obtains a new access token using a valid refresh token.
-   *
+   *
-   * @param dto - Refresh token
+   * @param dto - Refresh token
-   * @returns New access token
+   * @returns New access token
-   */
+   */
-  @Public()
+  @Public()
-  @Post('refresh')
+  @Post('refresh')
-  @HttpCode(HttpStatus.OK)
+  @HttpCode(HttpStatus.OK)
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'Refresh access token',
+    summary: 'Refresh access token',
-    description:
+    description:
-      'Get a new access token using a valid refresh token. Refresh tokens are long-lived (7 days).',
+      'Get a new access token using a valid refresh token. Refresh tokens are long-lived (7 days).',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 200,
+    status: 200,
-    description: 'Token refreshed successfully',
+    description: 'Token refreshed successfully',
-    schema: {
+    schema: {
-      properties: {
+      properties: {
-        accessToken: { type: 'string', example: 'eyJhbGciOiJIUzI1NiIs...' },
+        accessToken: { type: 'string', example: 'eyJhbGciOiJIUzI1NiIs...' },
-      },
+      },
-    },
+    },
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 401,
+    status: 401,
-    description: 'Invalid or expired refresh token',
+    description: 'Invalid or expired refresh token',
-  })
+  })
-  async refresh(
+  async refresh(
-    @Body() dto: RefreshTokenDto,
+    @Body() dto: RefreshTokenDto,
-  ): Promise<{ accessToken: string }> {
+  ): Promise<{ accessToken: string }> {
-    const result =
+    const result =
-      await this.authService.refreshAccessToken(dto.refreshToken);
+      await this.authService.refreshAccessToken(dto.refreshToken);
-
+
-    return { accessToken: result.accessToken };
+    return { accessToken: result.accessToken };
-  }
+  }
-
+
-  /**
+  /**
-   * Logout (placeholder)
+   * Logout (placeholder)
-   *
+   *
-   * Currently a no-op endpoint. With JWT, logout is typically handled client-side
+   * Currently a no-op endpoint. With JWT, logout is typically handled client-side
-   * by removing tokens. For more security, implement token blacklisting with Redis.
+   * by removing tokens. For more security, implement token blacklisting with Redis.
-   *
+   *
-   * @returns Success message
+   * @returns Success message
-   */
+   */
-  @UseGuards(JwtAuthGuard)
+  @UseGuards(JwtAuthGuard)
-  @Post('logout')
+  @Post('logout')
-  @HttpCode(HttpStatus.OK)
+  @HttpCode(HttpStatus.OK)
-  @ApiBearerAuth()
+  @ApiBearerAuth()
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'Logout',
+    summary: 'Logout',
-    description:
+    description:
-      'Logout the current user. Currently handled client-side by removing tokens.',
+      'Logout the current user. Currently handled client-side by removing tokens.',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 200,
+    status: 200,
-    description: 'Logout successful',
+    description: 'Logout successful',
-    schema: {
+    schema: {
-      properties: {
+      properties: {
-        message: { type: 'string', example: 'Logout successful' },
+        message: { type: 'string', example: 'Logout successful' },
-      },
+      },
-    },
+    },
-  })
+  })
-  async logout(): Promise<{ message: string }> {
+  async logout(): Promise<{ message: string }> {
-    // TODO: Implement token blacklisting with Redis for more security
+    // TODO: Implement token blacklisting with Redis for more security
-    // For now, logout is handled client-side by removing tokens
+    // For now, logout is handled client-side by removing tokens
-    return { message: 'Logout successful' };
+    return { message: 'Logout successful' };
-  }
+  }
-
+
-  /**
+  /**
-   * Get current user profile
+   * Get current user profile
-   *
+   *
-   * Returns the profile of the currently authenticated user.
+   * Returns the profile of the currently authenticated user.
-   *
+   *
-   * @param user - Current user from JWT token
+   * @param user - Current user from JWT token
-   * @returns User profile
+   * @returns User profile
-   */
+   */
-  @UseGuards(JwtAuthGuard)
+  @UseGuards(JwtAuthGuard)
-  @Get('me')
+  @Get('me')
-  @ApiBearerAuth()
+  @ApiBearerAuth()
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'Get current user profile',
+    summary: 'Get current user profile',
-    description: 'Returns the profile of the authenticated user.',
+    description: 'Returns the profile of the authenticated user.',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 200,
+    status: 200,
-    description: 'User profile retrieved successfully',
+    description: 'User profile retrieved successfully',
-    schema: {
+    schema: {
-      properties: {
+      properties: {
-        id: { type: 'string', format: 'uuid' },
+        id: { type: 'string', format: 'uuid' },
-        email: { type: 'string', format: 'email' },
+        email: { type: 'string', format: 'email' },
-        firstName: { type: 'string' },
+        firstName: { type: 'string' },
-        lastName: { type: 'string' },
+        lastName: { type: 'string' },
-        role: { type: 'string', enum: ['admin', 'manager', 'user', 'viewer'] },
+        role: { type: 'string', enum: ['admin', 'manager', 'user', 'viewer'] },
-        organizationId: { type: 'string', format: 'uuid' },
+        organizationId: { type: 'string', format: 'uuid' },
-      },
+      },
-    },
+    },
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 401,
+    status: 401,
-    description: 'Unauthorized - invalid or missing token',
+    description: 'Unauthorized - invalid or missing token',
-  })
+  })
-  async getProfile(@CurrentUser() user: UserPayload) {
+  async getProfile(@CurrentUser() user: UserPayload) {
-    return user;
+    return user;
-  }
+  }
-}
+}

apps/backend/src/application/controllers/index.ts

@@ -1,2 +1,2 @@
-export * from './rates.controller';
+export * from './rates.controller';
-export * from './bookings.controller';
+export * from './bookings.controller';

apps/backend/src/application/controllers/organizations.controller.ts

@@ -1,366 +1,367 @@
-import {
+import {
-  Controller,
+  Controller,
-  Get,
+  Get,
-  Post,
+  Post,
-  Patch,
+  Patch,
-  Param,
+  Param,
-  Body,
+  Body,
-  Query,
+  Query,
-  HttpCode,
+  HttpCode,
-  HttpStatus,
+  HttpStatus,
-  Logger,
+  Logger,
-  UsePipes,
+  UsePipes,
-  ValidationPipe,
+  ValidationPipe,
-  NotFoundException,
+  NotFoundException,
-  ParseUUIDPipe,
+  ParseUUIDPipe,
-  ParseIntPipe,
+  ParseIntPipe,
-  DefaultValuePipe,
+  DefaultValuePipe,
-  UseGuards,
+  UseGuards,
-  ForbiddenException,
+  ForbiddenException,
-} from '@nestjs/common';
+  Inject,
-import {
+} from '@nestjs/common';
-  ApiTags,
+import {
-  ApiOperation,
+  ApiTags,
-  ApiResponse,
+  ApiOperation,
-  ApiBadRequestResponse,
+  ApiResponse,
-  ApiNotFoundResponse,
+  ApiBadRequestResponse,
-  ApiQuery,
+  ApiNotFoundResponse,
-  ApiParam,
+  ApiQuery,
-  ApiBearerAuth,
+  ApiParam,
-} from '@nestjs/swagger';
+  ApiBearerAuth,
-import {
+} from '@nestjs/swagger';
-  CreateOrganizationDto,
+import {
-  UpdateOrganizationDto,
+  CreateOrganizationDto,
-  OrganizationResponseDto,
+  UpdateOrganizationDto,
-  OrganizationListResponseDto,
+  OrganizationResponseDto,
-} from '../dto/organization.dto';
+  OrganizationListResponseDto,
-import { OrganizationMapper } from '../mappers/organization.mapper';
+} from '../dto/organization.dto';
-import { OrganizationRepository } from '../../domain/ports/out/organization.repository';
+import { OrganizationMapper } from '../mappers/organization.mapper';
-import { Organization, OrganizationType } from '../../domain/entities/organization.entity';
+import { OrganizationRepository, ORGANIZATION_REPOSITORY } from '../../domain/ports/out/organization.repository';
-import { JwtAuthGuard } from '../guards/jwt-auth.guard';
+import { Organization, OrganizationType } from '../../domain/entities/organization.entity';
-import { RolesGuard } from '../guards/roles.guard';
+import { JwtAuthGuard } from '../guards/jwt-auth.guard';
-import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
+import { RolesGuard } from '../guards/roles.guard';
-import { Roles } from '../decorators/roles.decorator';
+import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
-import { v4 as uuidv4 } from 'uuid';
+import { Roles } from '../decorators/roles.decorator';
-
+import { v4 as uuidv4 } from 'uuid';
-/**
+
- * Organizations Controller
+/**
- *
+ * Organizations Controller
- * Manages organization CRUD operations:
+ *
- * - Create organization (admin only)
+ * Manages organization CRUD operations:
- * - Get organization details
+ * - Create organization (admin only)
- * - Update organization (admin/manager)
+ * - Get organization details
- * - List organizations
+ * - Update organization (admin/manager)
- */
+ * - List organizations
-@ApiTags('Organizations')
+ */
-@Controller('api/v1/organizations')
+@ApiTags('Organizations')
-@UseGuards(JwtAuthGuard, RolesGuard)
+@Controller('api/v1/organizations')
-@ApiBearerAuth()
+@UseGuards(JwtAuthGuard, RolesGuard)
-export class OrganizationsController {
+@ApiBearerAuth()
-  private readonly logger = new Logger(OrganizationsController.name);
+export class OrganizationsController {
-
+  private readonly logger = new Logger(OrganizationsController.name);
-  constructor(
+
-    private readonly organizationRepository: OrganizationRepository,
+  constructor(
-  ) {}
+    @Inject(ORGANIZATION_REPOSITORY) private readonly organizationRepository: OrganizationRepository,
-
+  ) {}
-  /**
+
-   * Create a new organization
+  /**
-   *
+   * Create a new organization
-   * Admin-only endpoint to create a new organization.
+   *
-   */
+   * Admin-only endpoint to create a new organization.
-  @Post()
+   */
-  @HttpCode(HttpStatus.CREATED)
+  @Post()
-  @Roles('admin')
+  @HttpCode(HttpStatus.CREATED)
-  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
+  @Roles('admin')
-  @ApiOperation({
+  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
-    summary: 'Create new organization',
+  @ApiOperation({
-    description:
+    summary: 'Create new organization',
-      'Create a new organization (freight forwarder, carrier, or shipper). Admin-only.',
+    description:
-  })
+      'Create a new organization (freight forwarder, carrier, or shipper). Admin-only.',
-  @ApiResponse({
+  })
-    status: HttpStatus.CREATED,
+  @ApiResponse({
-    description: 'Organization created successfully',
+    status: HttpStatus.CREATED,
-    type: OrganizationResponseDto,
+    description: 'Organization created successfully',
-  })
+    type: OrganizationResponseDto,
-  @ApiResponse({
+  })
-    status: 401,
+  @ApiResponse({
-    description: 'Unauthorized - missing or invalid token',
+    status: 401,
-  })
+    description: 'Unauthorized - missing or invalid token',
-  @ApiResponse({
+  })
-    status: 403,
+  @ApiResponse({
-    description: 'Forbidden - requires admin role',
+    status: 403,
-  })
+    description: 'Forbidden - requires admin role',
-  @ApiBadRequestResponse({
+  })
-    description: 'Invalid request parameters',
+  @ApiBadRequestResponse({
-  })
+    description: 'Invalid request parameters',
-  async createOrganization(
+  })
-    @Body() dto: CreateOrganizationDto,
+  async createOrganization(
-    @CurrentUser() user: UserPayload,
+    @Body() dto: CreateOrganizationDto,
-  ): Promise<OrganizationResponseDto> {
+    @CurrentUser() user: UserPayload,
-    this.logger.log(
+  ): Promise<OrganizationResponseDto> {
-      `[Admin: ${user.email}] Creating organization: ${dto.name} (${dto.type})`,
+    this.logger.log(
-    );
+      `[Admin: ${user.email}] Creating organization: ${dto.name} (${dto.type})`,
-
+    );
-    try {
+
-      // Check for duplicate name
+    try {
-      const existingByName = await this.organizationRepository.findByName(dto.name);
+      // Check for duplicate name
-      if (existingByName) {
+      const existingByName = await this.organizationRepository.findByName(dto.name);
-        throw new ForbiddenException(
+      if (existingByName) {
-          `Organization with name "${dto.name}" already exists`,
+        throw new ForbiddenException(
-        );
+          `Organization with name "${dto.name}" already exists`,
-      }
+        );
-
+      }
-      // Check for duplicate SCAC if provided
+
-      if (dto.scac) {
+      // Check for duplicate SCAC if provided
-        const existingBySCAC = await this.organizationRepository.findBySCAC(dto.scac);
+      if (dto.scac) {
-        if (existingBySCAC) {
+        const existingBySCAC = await this.organizationRepository.findBySCAC(dto.scac);
-          throw new ForbiddenException(
+        if (existingBySCAC) {
-            `Organization with SCAC "${dto.scac}" already exists`,
+          throw new ForbiddenException(
-          );
+            `Organization with SCAC "${dto.scac}" already exists`,
-        }
+          );
-      }
+        }
-
+      }
-      // Create organization entity
+
-      const organization = Organization.create({
+      // Create organization entity
-        id: uuidv4(),
+      const organization = Organization.create({
-        name: dto.name,
+        id: uuidv4(),
-        type: dto.type,
+        name: dto.name,
-        scac: dto.scac,
+        type: dto.type,
-        address: OrganizationMapper.mapDtoToAddress(dto.address),
+        scac: dto.scac,
-        logoUrl: dto.logoUrl,
+        address: OrganizationMapper.mapDtoToAddress(dto.address),
-        documents: [],
+        logoUrl: dto.logoUrl,
-        isActive: true,
+        documents: [],
-      });
+        isActive: true,
-
+      });
-      // Save to database
+
-      const savedOrg = await this.organizationRepository.save(organization);
+      // Save to database
-
+      const savedOrg = await this.organizationRepository.save(organization);
-      this.logger.log(
+
-        `Organization created successfully: ${savedOrg.name} (${savedOrg.id})`,
+      this.logger.log(
-      );
+        `Organization created successfully: ${savedOrg.name} (${savedOrg.id})`,
-
+      );
-      return OrganizationMapper.toDto(savedOrg);
+
-    } catch (error: any) {
+      return OrganizationMapper.toDto(savedOrg);
-      this.logger.error(
+    } catch (error: any) {
-        `Organization creation failed: ${error?.message || 'Unknown error'}`,
+      this.logger.error(
-        error?.stack,
+        `Organization creation failed: ${error?.message || 'Unknown error'}`,
-      );
+        error?.stack,
-      throw error;
+      );
-    }
+      throw error;
-  }
+    }
-
+  }
-  /**
+
-   * Get organization by ID
+  /**
-   *
+   * Get organization by ID
-   * Retrieve details of a specific organization.
+   *
-   * Users can only view their own organization unless they are admins.
+   * Retrieve details of a specific organization.
-   */
+   * Users can only view their own organization unless they are admins.
-  @Get(':id')
+   */
-  @ApiOperation({
+  @Get(':id')
-    summary: 'Get organization by ID',
+  @ApiOperation({
-    description:
+    summary: 'Get organization by ID',
-      'Retrieve organization details. Users can view their own organization, admins can view any.',
+    description:
-  })
+      'Retrieve organization details. Users can view their own organization, admins can view any.',
-  @ApiParam({
+  })
-    name: 'id',
+  @ApiParam({
-    description: 'Organization ID (UUID)',
+    name: 'id',
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    description: 'Organization ID (UUID)',
-  })
+    example: '550e8400-e29b-41d4-a716-446655440000',
-  @ApiResponse({
+  })
-    status: HttpStatus.OK,
+  @ApiResponse({
-    description: 'Organization details retrieved successfully',
+    status: HttpStatus.OK,
-    type: OrganizationResponseDto,
+    description: 'Organization details retrieved successfully',
-  })
+    type: OrganizationResponseDto,
-  @ApiResponse({
+  })
-    status: 401,
+  @ApiResponse({
-    description: 'Unauthorized - missing or invalid token',
+    status: 401,
-  })
+    description: 'Unauthorized - missing or invalid token',
-  @ApiNotFoundResponse({
+  })
-    description: 'Organization not found',
+  @ApiNotFoundResponse({
-  })
+    description: 'Organization not found',
-  async getOrganization(
+  })
-    @Param('id', ParseUUIDPipe) id: string,
+  async getOrganization(
-    @CurrentUser() user: UserPayload,
+    @Param('id', ParseUUIDPipe) id: string,
-  ): Promise<OrganizationResponseDto> {
+    @CurrentUser() user: UserPayload,
-    this.logger.log(`[User: ${user.email}] Fetching organization: ${id}`);
+  ): Promise<OrganizationResponseDto> {
-
+    this.logger.log(`[User: ${user.email}] Fetching organization: ${id}`);
-    const organization = await this.organizationRepository.findById(id);
+
-    if (!organization) {
+    const organization = await this.organizationRepository.findById(id);
-      throw new NotFoundException(`Organization ${id} not found`);
+    if (!organization) {
-    }
+      throw new NotFoundException(`Organization ${id} not found`);
-
+    }
-    // Authorization: Users can only view their own organization (unless admin)
+
-    if (user.role !== 'admin' && organization.id !== user.organizationId) {
+    // Authorization: Users can only view their own organization (unless admin)
-      throw new ForbiddenException('You can only view your own organization');
+    if (user.role !== 'admin' && organization.id !== user.organizationId) {
-    }
+      throw new ForbiddenException('You can only view your own organization');
-
+    }
-    return OrganizationMapper.toDto(organization);
+
-  }
+    return OrganizationMapper.toDto(organization);
-
+  }
-  /**
+
-   * Update organization
+  /**
-   *
+   * Update organization
-   * Update organization details (name, address, logo, status).
+   *
-   * Requires admin or manager role.
+   * Update organization details (name, address, logo, status).
-   */
+   * Requires admin or manager role.
-  @Patch(':id')
+   */
-  @Roles('admin', 'manager')
+  @Patch(':id')
-  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
+  @Roles('admin', 'manager')
-  @ApiOperation({
+  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
-    summary: 'Update organization',
+  @ApiOperation({
-    description:
+    summary: 'Update organization',
-      'Update organization details (name, address, logo, status). Requires admin or manager role.',
+    description:
-  })
+      'Update organization details (name, address, logo, status). Requires admin or manager role.',
-  @ApiParam({
+  })
-    name: 'id',
+  @ApiParam({
-    description: 'Organization ID (UUID)',
+    name: 'id',
-  })
+    description: 'Organization ID (UUID)',
-  @ApiResponse({
+  })
-    status: HttpStatus.OK,
+  @ApiResponse({
-    description: 'Organization updated successfully',
+    status: HttpStatus.OK,
-    type: OrganizationResponseDto,
+    description: 'Organization updated successfully',
-  })
+    type: OrganizationResponseDto,
-  @ApiResponse({
+  })
-    status: 401,
+  @ApiResponse({
-    description: 'Unauthorized - missing or invalid token',
+    status: 401,
-  })
+    description: 'Unauthorized - missing or invalid token',
-  @ApiResponse({
+  })
-    status: 403,
+  @ApiResponse({
-    description: 'Forbidden - requires admin or manager role',
+    status: 403,
-  })
+    description: 'Forbidden - requires admin or manager role',
-  @ApiNotFoundResponse({
+  })
-    description: 'Organization not found',
+  @ApiNotFoundResponse({
-  })
+    description: 'Organization not found',
-  async updateOrganization(
+  })
-    @Param('id', ParseUUIDPipe) id: string,
+  async updateOrganization(
-    @Body() dto: UpdateOrganizationDto,
+    @Param('id', ParseUUIDPipe) id: string,
-    @CurrentUser() user: UserPayload,
+    @Body() dto: UpdateOrganizationDto,
-  ): Promise<OrganizationResponseDto> {
+    @CurrentUser() user: UserPayload,
-    this.logger.log(
+  ): Promise<OrganizationResponseDto> {
-      `[User: ${user.email}] Updating organization: ${id}`,
+    this.logger.log(
-    );
+      `[User: ${user.email}] Updating organization: ${id}`,
-
+    );
-    const organization = await this.organizationRepository.findById(id);
+
-    if (!organization) {
+    const organization = await this.organizationRepository.findById(id);
-      throw new NotFoundException(`Organization ${id} not found`);
+    if (!organization) {
-    }
+      throw new NotFoundException(`Organization ${id} not found`);
-
+    }
-    // Authorization: Managers can only update their own organization
+
-    if (user.role === 'manager' && organization.id !== user.organizationId) {
+    // Authorization: Managers can only update their own organization
-      throw new ForbiddenException('You can only update your own organization');
+    if (user.role === 'manager' && organization.id !== user.organizationId) {
-    }
+      throw new ForbiddenException('You can only update your own organization');
-
+    }
-    // Update fields
+
-    if (dto.name) {
+    // Update fields
-      organization.updateName(dto.name);
+    if (dto.name) {
-    }
+      organization.updateName(dto.name);
-
+    }
-    if (dto.address) {
+
-      organization.updateAddress(OrganizationMapper.mapDtoToAddress(dto.address));
+    if (dto.address) {
-    }
+      organization.updateAddress(OrganizationMapper.mapDtoToAddress(dto.address));
-
+    }
-    if (dto.logoUrl !== undefined) {
+
-      organization.updateLogoUrl(dto.logoUrl);
+    if (dto.logoUrl !== undefined) {
-    }
+      organization.updateLogoUrl(dto.logoUrl);
-
+    }
-    if (dto.isActive !== undefined) {
+
-      if (dto.isActive) {
+    if (dto.isActive !== undefined) {
-        organization.activate();
+      if (dto.isActive) {
-      } else {
+        organization.activate();
-        organization.deactivate();
+      } else {
-      }
+        organization.deactivate();
-    }
+      }
-
+    }
-    // Save updated organization
+
-    const updatedOrg = await this.organizationRepository.save(organization);
+    // Save updated organization
-
+    const updatedOrg = await this.organizationRepository.save(organization);
-    this.logger.log(`Organization updated successfully: ${updatedOrg.id}`);
+
-
+    this.logger.log(`Organization updated successfully: ${updatedOrg.id}`);
-    return OrganizationMapper.toDto(updatedOrg);
+
-  }
+    return OrganizationMapper.toDto(updatedOrg);
-
+  }
-  /**
+
-   * List organizations
+  /**
-   *
+   * List organizations
-   * Retrieve a paginated list of organizations.
+   *
-   * Admins can see all, others see only their own.
+   * Retrieve a paginated list of organizations.
-   */
+   * Admins can see all, others see only their own.
-  @Get()
+   */
-  @ApiOperation({
+  @Get()
-    summary: 'List organizations',
+  @ApiOperation({
-    description:
+    summary: 'List organizations',
-      'Retrieve a paginated list of organizations. Admins see all, others see only their own.',
+    description:
-  })
+      'Retrieve a paginated list of organizations. Admins see all, others see only their own.',
-  @ApiQuery({
+  })
-    name: 'page',
+  @ApiQuery({
-    required: false,
+    name: 'page',
-    description: 'Page number (1-based)',
+    required: false,
-    example: 1,
+    description: 'Page number (1-based)',
-  })
+    example: 1,
-  @ApiQuery({
+  })
-    name: 'pageSize',
+  @ApiQuery({
-    required: false,
+    name: 'pageSize',
-    description: 'Number of items per page',
+    required: false,
-    example: 20,
+    description: 'Number of items per page',
-  })
+    example: 20,
-  @ApiQuery({
+  })
-    name: 'type',
+  @ApiQuery({
-    required: false,
+    name: 'type',
-    description: 'Filter by organization type',
+    required: false,
-    enum: OrganizationType,
+    description: 'Filter by organization type',
-  })
+    enum: OrganizationType,
-  @ApiResponse({
+  })
-    status: HttpStatus.OK,
+  @ApiResponse({
-    description: 'Organizations list retrieved successfully',
+    status: HttpStatus.OK,
-    type: OrganizationListResponseDto,
+    description: 'Organizations list retrieved successfully',
-  })
+    type: OrganizationListResponseDto,
-  @ApiResponse({
+  })
-    status: 401,
+  @ApiResponse({
-    description: 'Unauthorized - missing or invalid token',
+    status: 401,
-  })
+    description: 'Unauthorized - missing or invalid token',
-  async listOrganizations(
+  })
-    @Query('page', new DefaultValuePipe(1), ParseIntPipe) page: number,
+  async listOrganizations(
-    @Query('pageSize', new DefaultValuePipe(20), ParseIntPipe) pageSize: number,
+    @Query('page', new DefaultValuePipe(1), ParseIntPipe) page: number,
-    @Query('type') type: OrganizationType | undefined,
+    @Query('pageSize', new DefaultValuePipe(20), ParseIntPipe) pageSize: number,
-    @CurrentUser() user: UserPayload,
+    @Query('type') type: OrganizationType | undefined,
-  ): Promise<OrganizationListResponseDto> {
+    @CurrentUser() user: UserPayload,
-    this.logger.log(
+  ): Promise<OrganizationListResponseDto> {
-      `[User: ${user.email}] Listing organizations: page=${page}, pageSize=${pageSize}, type=${type}`,
+    this.logger.log(
-    );
+      `[User: ${user.email}] Listing organizations: page=${page}, pageSize=${pageSize}, type=${type}`,
-
+    );
-    // Fetch organizations
+
-    let organizations: Organization[];
+    // Fetch organizations
-
+    let organizations: Organization[];
-    if (user.role === 'admin') {
+
-      // Admins can see all organizations
+    if (user.role === 'admin') {
-      organizations = await this.organizationRepository.findAll();
+      // Admins can see all organizations
-    } else {
+      organizations = await this.organizationRepository.findAll();
-      // Others see only their own organization
+    } else {
-      const userOrg = await this.organizationRepository.findById(user.organizationId);
+      // Others see only their own organization
-      organizations = userOrg ? [userOrg] : [];
+      const userOrg = await this.organizationRepository.findById(user.organizationId);
-    }
+      organizations = userOrg ? [userOrg] : [];
-
+    }
-    // Filter by type if provided
+
-    const filteredOrgs = type
+    // Filter by type if provided
-      ? organizations.filter(org => org.type === type)
+    const filteredOrgs = type
-      : organizations;
+      ? organizations.filter(org => org.type === type)
-
+      : organizations;
-    // Paginate
+
-    const startIndex = (page - 1) * pageSize;
+    // Paginate
-    const endIndex = startIndex + pageSize;
+    const startIndex = (page - 1) * pageSize;
-    const paginatedOrgs = filteredOrgs.slice(startIndex, endIndex);
+    const endIndex = startIndex + pageSize;
-
+    const paginatedOrgs = filteredOrgs.slice(startIndex, endIndex);
-    // Convert to DTOs
+
-    const orgDtos = OrganizationMapper.toDtoArray(paginatedOrgs);
+    // Convert to DTOs
-
+    const orgDtos = OrganizationMapper.toDtoArray(paginatedOrgs);
-    const totalPages = Math.ceil(filteredOrgs.length / pageSize);
+
-
+    const totalPages = Math.ceil(filteredOrgs.length / pageSize);
-    return {
+
-      organizations: orgDtos,
+    return {
-      total: filteredOrgs.length,
+      organizations: orgDtos,
-      page,
+      total: filteredOrgs.length,
-      pageSize,
+      page,
-      totalPages,
+      pageSize,
-    };
+      totalPages,
-  }
+    };
-}
+  }
+}

apps/backend/src/application/controllers/rates.controller.ts

@@ -1,119 +1,119 @@
-import {
+import {
-  Controller,
+  Controller,
-  Post,
+  Post,
-  Body,
+  Body,
-  HttpCode,
+  HttpCode,
-  HttpStatus,
+  HttpStatus,
-  Logger,
+  Logger,
-  UsePipes,
+  UsePipes,
-  ValidationPipe,
+  ValidationPipe,
-  UseGuards,
+  UseGuards,
-} from '@nestjs/common';
+} from '@nestjs/common';
-import {
+import {
-  ApiTags,
+  ApiTags,
-  ApiOperation,
+  ApiOperation,
-  ApiResponse,
+  ApiResponse,
-  ApiBadRequestResponse,
+  ApiBadRequestResponse,
-  ApiInternalServerErrorResponse,
+  ApiInternalServerErrorResponse,
-  ApiBearerAuth,
+  ApiBearerAuth,
-} from '@nestjs/swagger';
+} from '@nestjs/swagger';
-import { RateSearchRequestDto, RateSearchResponseDto } from '../dto';
+import { RateSearchRequestDto, RateSearchResponseDto } from '../dto';
-import { RateQuoteMapper } from '../mappers';
+import { RateQuoteMapper } from '../mappers';
-import { RateSearchService } from '../../domain/services/rate-search.service';
+import { RateSearchService } from '../../domain/services/rate-search.service';
-import { JwtAuthGuard } from '../guards/jwt-auth.guard';
+import { JwtAuthGuard } from '../guards/jwt-auth.guard';
-import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
+import { CurrentUser, UserPayload } from '../decorators/current-user.decorator';
-
+
-@ApiTags('Rates')
+@ApiTags('Rates')
-@Controller('api/v1/rates')
+@Controller('api/v1/rates')
-@ApiBearerAuth()
+@ApiBearerAuth()
-export class RatesController {
+export class RatesController {
-  private readonly logger = new Logger(RatesController.name);
+  private readonly logger = new Logger(RatesController.name);
-
+
-  constructor(private readonly rateSearchService: RateSearchService) {}
+  constructor(private readonly rateSearchService: RateSearchService) {}
-
+
-  @Post('search')
+  @Post('search')
-  @UseGuards(JwtAuthGuard)
+  @UseGuards(JwtAuthGuard)
-  @HttpCode(HttpStatus.OK)
+  @HttpCode(HttpStatus.OK)
-  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
+  @UsePipes(new ValidationPipe({ transform: true, whitelist: true }))
-  @ApiOperation({
+  @ApiOperation({
-    summary: 'Search shipping rates',
+    summary: 'Search shipping rates',
-    description:
+    description:
-      'Search for available shipping rates from multiple carriers. Results are cached for 15 minutes. Requires authentication.',
+      'Search for available shipping rates from multiple carriers. Results are cached for 15 minutes. Requires authentication.',
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: HttpStatus.OK,
+    status: HttpStatus.OK,
-    description: 'Rate search completed successfully',
+    description: 'Rate search completed successfully',
-    type: RateSearchResponseDto,
+    type: RateSearchResponseDto,
-  })
+  })
-  @ApiResponse({
+  @ApiResponse({
-    status: 401,
+    status: 401,
-    description: 'Unauthorized - missing or invalid token',
+    description: 'Unauthorized - missing or invalid token',
-  })
+  })
-  @ApiBadRequestResponse({
+  @ApiBadRequestResponse({
-    description: 'Invalid request parameters',
+    description: 'Invalid request parameters',
-    schema: {
+    schema: {
-      example: {
+      example: {
-        statusCode: 400,
+        statusCode: 400,
-        message: ['Origin must be a valid 5-character UN/LOCODE (e.g., NLRTM)'],
+        message: ['Origin must be a valid 5-character UN/LOCODE (e.g., NLRTM)'],
-        error: 'Bad Request',
+        error: 'Bad Request',
-      },
+      },
-    },
+    },
-  })
+  })
-  @ApiInternalServerErrorResponse({
+  @ApiInternalServerErrorResponse({
-    description: 'Internal server error',
+    description: 'Internal server error',
-  })
+  })
-  async searchRates(
+  async searchRates(
-    @Body() dto: RateSearchRequestDto,
+    @Body() dto: RateSearchRequestDto,
-    @CurrentUser() user: UserPayload,
+    @CurrentUser() user: UserPayload,
-  ): Promise<RateSearchResponseDto> {
+  ): Promise<RateSearchResponseDto> {
-    const startTime = Date.now();
+    const startTime = Date.now();
-    this.logger.log(
+    this.logger.log(
-      `[User: ${user.email}] Searching rates: ${dto.origin} → ${dto.destination}, ${dto.containerType}`,
+      `[User: ${user.email}] Searching rates: ${dto.origin} → ${dto.destination}, ${dto.containerType}`,
-    );
+    );
-
+
-    try {
+    try {
-      // Convert DTO to domain input
+      // Convert DTO to domain input
-      const searchInput = {
+      const searchInput = {
-        origin: dto.origin,
+        origin: dto.origin,
-        destination: dto.destination,
+        destination: dto.destination,
-        containerType: dto.containerType,
+        containerType: dto.containerType,
-        mode: dto.mode,
+        mode: dto.mode,
-        departureDate: new Date(dto.departureDate),
+        departureDate: new Date(dto.departureDate),
-        quantity: dto.quantity,
+        quantity: dto.quantity,
-        weight: dto.weight,
+        weight: dto.weight,
-        volume: dto.volume,
+        volume: dto.volume,
-        isHazmat: dto.isHazmat,
+        isHazmat: dto.isHazmat,
-        imoClass: dto.imoClass,
+        imoClass: dto.imoClass,
-      };
+      };
-
+
-      // Execute search
+      // Execute search
-      const result = await this.rateSearchService.execute(searchInput);
+      const result = await this.rateSearchService.execute(searchInput);
-
+
-      // Convert domain entities to DTOs
+      // Convert domain entities to DTOs
-      const quoteDtos = RateQuoteMapper.toDtoArray(result.quotes);
+      const quoteDtos = RateQuoteMapper.toDtoArray(result.quotes);
-
+
-      const responseTimeMs = Date.now() - startTime;
+      const responseTimeMs = Date.now() - startTime;
-      this.logger.log(
+      this.logger.log(
-        `Rate search completed: ${quoteDtos.length} quotes, ${responseTimeMs}ms`,
+        `Rate search completed: ${quoteDtos.length} quotes, ${responseTimeMs}ms`,
-      );
+      );
-
+
-      return {
+      return {
-        quotes: quoteDtos,
+        quotes: quoteDtos,
-        count: quoteDtos.length,
+        count: quoteDtos.length,
-        origin: dto.origin,
+        origin: dto.origin,
-        destination: dto.destination,
+        destination: dto.destination,
-        departureDate: dto.departureDate,
+        departureDate: dto.departureDate,
-        containerType: dto.containerType,
+        containerType: dto.containerType,
-        mode: dto.mode,
+        mode: dto.mode,
-        fromCache: false, // TODO: Implement cache detection
+        fromCache: false, // TODO: Implement cache detection
-        responseTimeMs,
+        responseTimeMs,
-      };
+      };
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(
+      this.logger.error(
-        `Rate search failed: ${error?.message || 'Unknown error'}`,
+        `Rate search failed: ${error?.message || 'Unknown error'}`,
-        error?.stack,
+        error?.stack,
-      );
+      );
-      throw error;
+      throw error;
-    }
+    }
-  }
+  }
-}
+}

apps/backend/src/application/controllers/users.controller.ts

@@ -19,6 +19,7 @@ import {
   UseGuards,
   ForbiddenException,
   ConflictException,
+  Inject,
 } from '@nestjs/common';
 import {
   ApiTags,
@@ -38,7 +39,7 @@ import {
   UserListResponseDto,
 } from '../dto/user.dto';
 import { UserMapper } from '../mappers/user.mapper';
-import { UserRepository } from '../../domain/ports/out/user.repository';
+import { UserRepository, USER_REPOSITORY } from '../../domain/ports/out/user.repository';
 import { User, UserRole as DomainUserRole } from '../../domain/entities/user.entity';
 import { JwtAuthGuard } from '../guards/jwt-auth.guard';
 import { RolesGuard } from '../guards/roles.guard';
@@ -66,7 +67,7 @@ import * as crypto from 'crypto';
 export class UsersController {
   private readonly logger = new Logger(UsersController.name);
 
-  constructor(private readonly userRepository: UserRepository) {}
+  constructor(@Inject(USER_REPOSITORY) private readonly userRepository: UserRepository) {}
 
   /**
    * Create/Invite a new user

apps/backend/src/application/decorators/current-user.decorator.ts

@@ -1,42 +1,42 @@
-import { createParamDecorator, ExecutionContext } from '@nestjs/common';
+import { createParamDecorator, ExecutionContext } from '@nestjs/common';
-
+
-/**
+/**
- * User payload interface extracted from JWT
+ * User payload interface extracted from JWT
- */
+ */
-export interface UserPayload {
+export interface UserPayload {
-  id: string;
+  id: string;
-  email: string;
+  email: string;
-  role: string;
+  role: string;
-  organizationId: string;
+  organizationId: string;
-  firstName: string;
+  firstName: string;
-  lastName: string;
+  lastName: string;
-}
+}
-
+
-/**
+/**
- * CurrentUser Decorator
+ * CurrentUser Decorator
- *
+ *
- * Extracts the authenticated user from the request object.
+ * Extracts the authenticated user from the request object.
- * Must be used with JwtAuthGuard.
+ * Must be used with JwtAuthGuard.
- *
+ *
- * Usage:
+ * Usage:
- * @UseGuards(JwtAuthGuard)
+ * @UseGuards(JwtAuthGuard)
- * @Get('me')
+ * @Get('me')
- * getProfile(@CurrentUser() user: UserPayload) {
+ * getProfile(@CurrentUser() user: UserPayload) {
- *   return user;
+ *   return user;
- * }
+ * }
- *
+ *
- * You can also extract a specific property:
+ * You can also extract a specific property:
- * @Get('my-bookings')
+ * @Get('my-bookings')
- * getMyBookings(@CurrentUser('id') userId: string) {
+ * getMyBookings(@CurrentUser('id') userId: string) {
- *   return this.bookingService.findByUserId(userId);
+ *   return this.bookingService.findByUserId(userId);
- * }
+ * }
- */
+ */
-export const CurrentUser = createParamDecorator(
+export const CurrentUser = createParamDecorator(
-  (data: keyof UserPayload | undefined, ctx: ExecutionContext) => {
+  (data: keyof UserPayload | undefined, ctx: ExecutionContext) => {
-    const request = ctx.switchToHttp().getRequest();
+    const request = ctx.switchToHttp().getRequest();
-    const user = request.user;
+    const user = request.user;
-
+
-    // If a specific property is requested, return only that property
+    // If a specific property is requested, return only that property
-    return data ? user?.[data] : user;
+    return data ? user?.[data] : user;
-  },
+  },
-);
+);

apps/backend/src/application/decorators/index.ts

@@ -1,3 +1,3 @@
-export * from './current-user.decorator';
+export * from './current-user.decorator';
-export * from './public.decorator';
+export * from './public.decorator';
-export * from './roles.decorator';
+export * from './roles.decorator';

apps/backend/src/application/decorators/public.decorator.ts

@@ -1,16 +1,16 @@
-import { SetMetadata } from '@nestjs/common';
+import { SetMetadata } from '@nestjs/common';
-
+
-/**
+/**
- * Public Decorator
+ * Public Decorator
- *
+ *
- * Marks a route as public, bypassing JWT authentication.
+ * Marks a route as public, bypassing JWT authentication.
- * Use this for routes that should be accessible without a token.
+ * Use this for routes that should be accessible without a token.
- *
+ *
- * Usage:
+ * Usage:
- * @Public()
+ * @Public()
- * @Post('login')
+ * @Post('login')
- * login(@Body() dto: LoginDto) {
+ * login(@Body() dto: LoginDto) {
- *   return this.authService.login(dto.email, dto.password);
+ *   return this.authService.login(dto.email, dto.password);
- * }
+ * }
- */
+ */
-export const Public = () => SetMetadata('isPublic', true);
+export const Public = () => SetMetadata('isPublic', true);

apps/backend/src/application/decorators/roles.decorator.ts

@@ -1,23 +1,23 @@
-import { SetMetadata } from '@nestjs/common';
+import { SetMetadata } from '@nestjs/common';
-
+
-/**
+/**
- * Roles Decorator
+ * Roles Decorator
- *
+ *
- * Specifies which roles are allowed to access a route.
+ * Specifies which roles are allowed to access a route.
- * Must be used with both JwtAuthGuard and RolesGuard.
+ * Must be used with both JwtAuthGuard and RolesGuard.
- *
+ *
- * Available roles:
+ * Available roles:
- * - 'admin': Full system access
+ * - 'admin': Full system access
- * - 'manager': Manage bookings and users within organization
+ * - 'manager': Manage bookings and users within organization
- * - 'user': Create and view bookings
+ * - 'user': Create and view bookings
- * - 'viewer': Read-only access
+ * - 'viewer': Read-only access
- *
+ *
- * Usage:
+ * Usage:
- * @UseGuards(JwtAuthGuard, RolesGuard)
+ * @UseGuards(JwtAuthGuard, RolesGuard)
- * @Roles('admin', 'manager')
+ * @Roles('admin', 'manager')
- * @Delete('bookings/:id')
+ * @Delete('bookings/:id')
- * deleteBooking(@Param('id') id: string) {
+ * deleteBooking(@Param('id') id: string) {
- *   return this.bookingService.delete(id);
+ *   return this.bookingService.delete(id);
- * }
+ * }
- */
+ */
-export const Roles = (...roles: string[]) => SetMetadata('roles', roles);
+export const Roles = (...roles: string[]) => SetMetadata('roles', roles);

apps/backend/src/application/dto/auth-login.dto.ts

@@ -1,104 +1,104 @@
-import { IsEmail, IsString, MinLength } from 'class-validator';
+import { IsEmail, IsString, MinLength } from 'class-validator';
-import { ApiProperty } from '@nestjs/swagger';
+import { ApiProperty } from '@nestjs/swagger';
-
+
-export class LoginDto {
+export class LoginDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'john.doe@acme.com',
+    example: 'john.doe@acme.com',
-    description: 'Email address',
+    description: 'Email address',
-  })
+  })
-  @IsEmail({}, { message: 'Invalid email format' })
+  @IsEmail({}, { message: 'Invalid email format' })
-  email: string;
+  email: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'SecurePassword123!',
+    example: 'SecurePassword123!',
-    description: 'Password (minimum 12 characters)',
+    description: 'Password (minimum 12 characters)',
-    minLength: 12,
+    minLength: 12,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(12, { message: 'Password must be at least 12 characters' })
+  @MinLength(12, { message: 'Password must be at least 12 characters' })
-  password: string;
+  password: string;
-}
+}
-
+
-export class RegisterDto {
+export class RegisterDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'john.doe@acme.com',
+    example: 'john.doe@acme.com',
-    description: 'Email address',
+    description: 'Email address',
-  })
+  })
-  @IsEmail({}, { message: 'Invalid email format' })
+  @IsEmail({}, { message: 'Invalid email format' })
-  email: string;
+  email: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'SecurePassword123!',
+    example: 'SecurePassword123!',
-    description: 'Password (minimum 12 characters)',
+    description: 'Password (minimum 12 characters)',
-    minLength: 12,
+    minLength: 12,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(12, { message: 'Password must be at least 12 characters' })
+  @MinLength(12, { message: 'Password must be at least 12 characters' })
-  password: string;
+  password: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'John',
+    example: 'John',
-    description: 'First name',
+    description: 'First name',
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'First name must be at least 2 characters' })
+  @MinLength(2, { message: 'First name must be at least 2 characters' })
-  firstName: string;
+  firstName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Doe',
+    example: 'Doe',
-    description: 'Last name',
+    description: 'Last name',
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'Last name must be at least 2 characters' })
+  @MinLength(2, { message: 'Last name must be at least 2 characters' })
-  lastName: string;
+  lastName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Organization ID',
+    description: 'Organization ID',
-  })
+  })
-  @IsString()
+  @IsString()
-  organizationId: string;
+  organizationId: string;
-}
+}
-
+
-export class AuthResponseDto {
+export class AuthResponseDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
-    description: 'JWT access token (valid 15 minutes)',
+    description: 'JWT access token (valid 15 minutes)',
-  })
+  })
-  accessToken: string;
+  accessToken: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
-    description: 'JWT refresh token (valid 7 days)',
+    description: 'JWT refresh token (valid 7 days)',
-  })
+  })
-  refreshToken: string;
+  refreshToken: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: {
+    example: {
-      id: '550e8400-e29b-41d4-a716-446655440000',
+      id: '550e8400-e29b-41d4-a716-446655440000',
-      email: 'john.doe@acme.com',
+      email: 'john.doe@acme.com',
-      firstName: 'John',
+      firstName: 'John',
-      lastName: 'Doe',
+      lastName: 'Doe',
-      role: 'user',
+      role: 'user',
-      organizationId: '550e8400-e29b-41d4-a716-446655440001',
+      organizationId: '550e8400-e29b-41d4-a716-446655440001',
-    },
+    },
-    description: 'User information',
+    description: 'User information',
-  })
+  })
-  user: {
+  user: {
-    id: string;
+    id: string;
-    email: string;
+    email: string;
-    firstName: string;
+    firstName: string;
-    lastName: string;
+    lastName: string;
-    role: string;
+    role: string;
-    organizationId: string;
+    organizationId: string;
-  };
+  };
-}
+}
-
+
-export class RefreshTokenDto {
+export class RefreshTokenDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+    example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
-    description: 'Refresh token',
+    description: 'Refresh token',
-  })
+  })
-  @IsString()
+  @IsString()
-  refreshToken: string;
+  refreshToken: string;
-}
+}

apps/backend/src/application/dto/booking-response.dto.ts

@@ -1,184 +1,184 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { PortDto, PricingDto } from './rate-search-response.dto';
+import { PortDto, PricingDto } from './rate-search-response.dto';
-
+
-export class BookingAddressDto {
+export class BookingAddressDto {
-  @ApiProperty({ example: '123 Main Street' })
+  @ApiProperty({ example: '123 Main Street' })
-  street: string;
+  street: string;
-
+
-  @ApiProperty({ example: 'Rotterdam' })
+  @ApiProperty({ example: 'Rotterdam' })
-  city: string;
+  city: string;
-
+
-  @ApiProperty({ example: '3000 AB' })
+  @ApiProperty({ example: '3000 AB' })
-  postalCode: string;
+  postalCode: string;
-
+
-  @ApiProperty({ example: 'NL' })
+  @ApiProperty({ example: 'NL' })
-  country: string;
+  country: string;
-}
+}
-
+
-export class BookingPartyDto {
+export class BookingPartyDto {
-  @ApiProperty({ example: 'Acme Corporation' })
+  @ApiProperty({ example: 'Acme Corporation' })
-  name: string;
+  name: string;
-
+
-  @ApiProperty({ type: BookingAddressDto })
+  @ApiProperty({ type: BookingAddressDto })
-  address: BookingAddressDto;
+  address: BookingAddressDto;
-
+
-  @ApiProperty({ example: 'John Doe' })
+  @ApiProperty({ example: 'John Doe' })
-  contactName: string;
+  contactName: string;
-
+
-  @ApiProperty({ example: 'john.doe@acme.com' })
+  @ApiProperty({ example: 'john.doe@acme.com' })
-  contactEmail: string;
+  contactEmail: string;
-
+
-  @ApiProperty({ example: '+31612345678' })
+  @ApiProperty({ example: '+31612345678' })
-  contactPhone: string;
+  contactPhone: string;
-}
+}
-
+
-export class BookingContainerDto {
+export class BookingContainerDto {
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({ example: '40HC' })
+  @ApiProperty({ example: '40HC' })
-  type: string;
+  type: string;
-
+
-  @ApiPropertyOptional({ example: 'ABCU1234567' })
+  @ApiPropertyOptional({ example: 'ABCU1234567' })
-  containerNumber?: string;
+  containerNumber?: string;
-
+
-  @ApiPropertyOptional({ example: 22000 })
+  @ApiPropertyOptional({ example: 22000 })
-  vgm?: number;
+  vgm?: number;
-
+
-  @ApiPropertyOptional({ example: -18 })
+  @ApiPropertyOptional({ example: -18 })
-  temperature?: number;
+  temperature?: number;
-
+
-  @ApiPropertyOptional({ example: 'SEAL123456' })
+  @ApiPropertyOptional({ example: 'SEAL123456' })
-  sealNumber?: string;
+  sealNumber?: string;
-}
+}
-
+
-export class BookingRateQuoteDto {
+export class BookingRateQuoteDto {
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({ example: 'Maersk Line' })
+  @ApiProperty({ example: 'Maersk Line' })
-  carrierName: string;
+  carrierName: string;
-
+
-  @ApiProperty({ example: 'MAERSK' })
+  @ApiProperty({ example: 'MAERSK' })
-  carrierCode: string;
+  carrierCode: string;
-
+
-  @ApiProperty({ type: PortDto })
+  @ApiProperty({ type: PortDto })
-  origin: PortDto;
+  origin: PortDto;
-
+
-  @ApiProperty({ type: PortDto })
+  @ApiProperty({ type: PortDto })
-  destination: PortDto;
+  destination: PortDto;
-
+
-  @ApiProperty({ type: PricingDto })
+  @ApiProperty({ type: PricingDto })
-  pricing: PricingDto;
+  pricing: PricingDto;
-
+
-  @ApiProperty({ example: '40HC' })
+  @ApiProperty({ example: '40HC' })
-  containerType: string;
+  containerType: string;
-
+
-  @ApiProperty({ example: 'FCL' })
+  @ApiProperty({ example: 'FCL' })
-  mode: string;
+  mode: string;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  etd: string;
+  etd: string;
-
+
-  @ApiProperty({ example: '2025-03-17T14:00:00Z' })
+  @ApiProperty({ example: '2025-03-17T14:00:00Z' })
-  eta: string;
+  eta: string;
-
+
-  @ApiProperty({ example: 30 })
+  @ApiProperty({ example: 30 })
-  transitDays: number;
+  transitDays: number;
-}
+}
-
+
-export class BookingResponseDto {
+export class BookingResponseDto {
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({ example: 'WCM-2025-ABC123', description: 'Unique booking number' })
+  @ApiProperty({ example: 'WCM-2025-ABC123', description: 'Unique booking number' })
-  bookingNumber: string;
+  bookingNumber: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'draft',
+    example: 'draft',
-    enum: ['draft', 'pending_confirmation', 'confirmed', 'in_transit', 'delivered', 'cancelled'],
+    enum: ['draft', 'pending_confirmation', 'confirmed', 'in_transit', 'delivered', 'cancelled'],
-  })
+  })
-  status: string;
+  status: string;
-
+
-  @ApiProperty({ type: BookingPartyDto })
+  @ApiProperty({ type: BookingPartyDto })
-  shipper: BookingPartyDto;
+  shipper: BookingPartyDto;
-
+
-  @ApiProperty({ type: BookingPartyDto })
+  @ApiProperty({ type: BookingPartyDto })
-  consignee: BookingPartyDto;
+  consignee: BookingPartyDto;
-
+
-  @ApiProperty({ example: 'Electronics and consumer goods' })
+  @ApiProperty({ example: 'Electronics and consumer goods' })
-  cargoDescription: string;
+  cargoDescription: string;
-
+
-  @ApiProperty({ type: [BookingContainerDto] })
+  @ApiProperty({ type: [BookingContainerDto] })
-  containers: BookingContainerDto[];
+  containers: BookingContainerDto[];
-
+
-  @ApiPropertyOptional({ example: 'Please handle with care. Delivery before 5 PM.' })
+  @ApiPropertyOptional({ example: 'Please handle with care. Delivery before 5 PM.' })
-  specialInstructions?: string;
+  specialInstructions?: string;
-
+
-  @ApiProperty({ type: BookingRateQuoteDto, description: 'Associated rate quote details' })
+  @ApiProperty({ type: BookingRateQuoteDto, description: 'Associated rate quote details' })
-  rateQuote: BookingRateQuoteDto;
+  rateQuote: BookingRateQuoteDto;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  createdAt: string;
+  createdAt: string;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  updatedAt: string;
+  updatedAt: string;
-}
+}
-
+
-export class BookingListItemDto {
+export class BookingListItemDto {
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({ example: 'WCM-2025-ABC123' })
+  @ApiProperty({ example: 'WCM-2025-ABC123' })
-  bookingNumber: string;
+  bookingNumber: string;
-
+
-  @ApiProperty({ example: 'draft' })
+  @ApiProperty({ example: 'draft' })
-  status: string;
+  status: string;
-
+
-  @ApiProperty({ example: 'Acme Corporation' })
+  @ApiProperty({ example: 'Acme Corporation' })
-  shipperName: string;
+  shipperName: string;
-
+
-  @ApiProperty({ example: 'Shanghai Imports Ltd' })
+  @ApiProperty({ example: 'Shanghai Imports Ltd' })
-  consigneeName: string;
+  consigneeName: string;
-
+
-  @ApiProperty({ example: 'NLRTM' })
+  @ApiProperty({ example: 'NLRTM' })
-  originPort: string;
+  originPort: string;
-
+
-  @ApiProperty({ example: 'CNSHA' })
+  @ApiProperty({ example: 'CNSHA' })
-  destinationPort: string;
+  destinationPort: string;
-
+
-  @ApiProperty({ example: 'Maersk Line' })
+  @ApiProperty({ example: 'Maersk Line' })
-  carrierName: string;
+  carrierName: string;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  etd: string;
+  etd: string;
-
+
-  @ApiProperty({ example: '2025-03-17T14:00:00Z' })
+  @ApiProperty({ example: '2025-03-17T14:00:00Z' })
-  eta: string;
+  eta: string;
-
+
-  @ApiProperty({ example: 1700.0 })
+  @ApiProperty({ example: 1700.0 })
-  totalAmount: number;
+  totalAmount: number;
-
+
-  @ApiProperty({ example: 'USD' })
+  @ApiProperty({ example: 'USD' })
-  currency: string;
+  currency: string;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  createdAt: string;
+  createdAt: string;
-}
+}
-
+
-export class BookingListResponseDto {
+export class BookingListResponseDto {
-  @ApiProperty({ type: [BookingListItemDto] })
+  @ApiProperty({ type: [BookingListItemDto] })
-  bookings: BookingListItemDto[];
+  bookings: BookingListItemDto[];
-
+
-  @ApiProperty({ example: 25, description: 'Total number of bookings' })
+  @ApiProperty({ example: 25, description: 'Total number of bookings' })
-  total: number;
+  total: number;
-
+
-  @ApiProperty({ example: 1, description: 'Current page number' })
+  @ApiProperty({ example: 1, description: 'Current page number' })
-  page: number;
+  page: number;
-
+
-  @ApiProperty({ example: 20, description: 'Items per page' })
+  @ApiProperty({ example: 20, description: 'Items per page' })
-  pageSize: number;
+  pageSize: number;
-
+
-  @ApiProperty({ example: 2, description: 'Total number of pages' })
+  @ApiProperty({ example: 2, description: 'Total number of pages' })
-  totalPages: number;
+  totalPages: number;
-}
+}

apps/backend/src/application/dto/create-booking-request.dto.ts

@@ -1,119 +1,119 @@
-import { IsString, IsUUID, IsOptional, ValidateNested, IsArray, IsEmail, Matches, MinLength } from 'class-validator';
+import { IsString, IsUUID, IsOptional, ValidateNested, IsArray, IsEmail, Matches, MinLength } from 'class-validator';
-import { Type } from 'class-transformer';
+import { Type } from 'class-transformer';
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
+
-export class AddressDto {
+export class AddressDto {
-  @ApiProperty({ example: '123 Main Street' })
+  @ApiProperty({ example: '123 Main Street' })
-  @IsString()
+  @IsString()
-  @MinLength(5, { message: 'Street must be at least 5 characters' })
+  @MinLength(5, { message: 'Street must be at least 5 characters' })
-  street: string;
+  street: string;
-
+
-  @ApiProperty({ example: 'Rotterdam' })
+  @ApiProperty({ example: 'Rotterdam' })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'City must be at least 2 characters' })
+  @MinLength(2, { message: 'City must be at least 2 characters' })
-  city: string;
+  city: string;
-
+
-  @ApiProperty({ example: '3000 AB' })
+  @ApiProperty({ example: '3000 AB' })
-  @IsString()
+  @IsString()
-  postalCode: string;
+  postalCode: string;
-
+
-  @ApiProperty({ example: 'NL', description: 'ISO 3166-1 alpha-2 country code' })
+  @ApiProperty({ example: 'NL', description: 'ISO 3166-1 alpha-2 country code' })
-  @IsString()
+  @IsString()
-  @Matches(/^[A-Z]{2}$/, { message: 'Country must be a valid 2-letter ISO country code' })
+  @Matches(/^[A-Z]{2}$/, { message: 'Country must be a valid 2-letter ISO country code' })
-  country: string;
+  country: string;
-}
+}
-
+
-export class PartyDto {
+export class PartyDto {
-  @ApiProperty({ example: 'Acme Corporation' })
+  @ApiProperty({ example: 'Acme Corporation' })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'Name must be at least 2 characters' })
+  @MinLength(2, { message: 'Name must be at least 2 characters' })
-  name: string;
+  name: string;
-
+
-  @ApiProperty({ type: AddressDto })
+  @ApiProperty({ type: AddressDto })
-  @ValidateNested()
+  @ValidateNested()
-  @Type(() => AddressDto)
+  @Type(() => AddressDto)
-  address: AddressDto;
+  address: AddressDto;
-
+
-  @ApiProperty({ example: 'John Doe' })
+  @ApiProperty({ example: 'John Doe' })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'Contact name must be at least 2 characters' })
+  @MinLength(2, { message: 'Contact name must be at least 2 characters' })
-  contactName: string;
+  contactName: string;
-
+
-  @ApiProperty({ example: 'john.doe@acme.com' })
+  @ApiProperty({ example: 'john.doe@acme.com' })
-  @IsEmail({}, { message: 'Contact email must be a valid email address' })
+  @IsEmail({}, { message: 'Contact email must be a valid email address' })
-  contactEmail: string;
+  contactEmail: string;
-
+
-  @ApiProperty({ example: '+31612345678' })
+  @ApiProperty({ example: '+31612345678' })
-  @IsString()
+  @IsString()
-  @Matches(/^\+?[1-9]\d{1,14}$/, { message: 'Contact phone must be a valid international phone number' })
+  @Matches(/^\+?[1-9]\d{1,14}$/, { message: 'Contact phone must be a valid international phone number' })
-  contactPhone: string;
+  contactPhone: string;
-}
+}
-
+
-export class ContainerDto {
+export class ContainerDto {
-  @ApiProperty({ example: '40HC', description: 'Container type' })
+  @ApiProperty({ example: '40HC', description: 'Container type' })
-  @IsString()
+  @IsString()
-  type: string;
+  type: string;
-
+
-  @ApiPropertyOptional({ example: 'ABCU1234567', description: 'Container number (11 characters)' })
+  @ApiPropertyOptional({ example: 'ABCU1234567', description: 'Container number (11 characters)' })
-  @IsOptional()
+  @IsOptional()
-  @IsString()
+  @IsString()
-  @Matches(/^[A-Z]{4}\d{7}$/, { message: 'Container number must be 4 letters followed by 7 digits' })
+  @Matches(/^[A-Z]{4}\d{7}$/, { message: 'Container number must be 4 letters followed by 7 digits' })
-  containerNumber?: string;
+  containerNumber?: string;
-
+
-  @ApiPropertyOptional({ example: 22000, description: 'Verified Gross Mass in kg' })
+  @ApiPropertyOptional({ example: 22000, description: 'Verified Gross Mass in kg' })
-  @IsOptional()
+  @IsOptional()
-  vgm?: number;
+  vgm?: number;
-
+
-  @ApiPropertyOptional({ example: -18, description: 'Temperature in Celsius (for reefer containers)' })
+  @ApiPropertyOptional({ example: -18, description: 'Temperature in Celsius (for reefer containers)' })
-  @IsOptional()
+  @IsOptional()
-  temperature?: number;
+  temperature?: number;
-
+
-  @ApiPropertyOptional({ example: 'SEAL123456', description: 'Seal number' })
+  @ApiPropertyOptional({ example: 'SEAL123456', description: 'Seal number' })
-  @IsOptional()
+  @IsOptional()
-  @IsString()
+  @IsString()
-  sealNumber?: string;
+  sealNumber?: string;
-}
+}
-
+
-export class CreateBookingRequestDto {
+export class CreateBookingRequestDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Rate quote ID from previous search'
+    description: 'Rate quote ID from previous search'
-  })
+  })
-  @IsUUID(4, { message: 'Rate quote ID must be a valid UUID' })
+  @IsUUID(4, { message: 'Rate quote ID must be a valid UUID' })
-  rateQuoteId: string;
+  rateQuoteId: string;
-
+
-  @ApiProperty({ type: PartyDto, description: 'Shipper details' })
+  @ApiProperty({ type: PartyDto, description: 'Shipper details' })
-  @ValidateNested()
+  @ValidateNested()
-  @Type(() => PartyDto)
+  @Type(() => PartyDto)
-  shipper: PartyDto;
+  shipper: PartyDto;
-
+
-  @ApiProperty({ type: PartyDto, description: 'Consignee details' })
+  @ApiProperty({ type: PartyDto, description: 'Consignee details' })
-  @ValidateNested()
+  @ValidateNested()
-  @Type(() => PartyDto)
+  @Type(() => PartyDto)
-  consignee: PartyDto;
+  consignee: PartyDto;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Electronics and consumer goods',
+    example: 'Electronics and consumer goods',
-    description: 'Cargo description'
+    description: 'Cargo description'
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(10, { message: 'Cargo description must be at least 10 characters' })
+  @MinLength(10, { message: 'Cargo description must be at least 10 characters' })
-  cargoDescription: string;
+  cargoDescription: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    type: [ContainerDto],
+    type: [ContainerDto],
-    description: 'Container details (can be empty for initial booking)'
+    description: 'Container details (can be empty for initial booking)'
-  })
+  })
-  @IsArray()
+  @IsArray()
-  @ValidateNested({ each: true })
+  @ValidateNested({ each: true })
-  @Type(() => ContainerDto)
+  @Type(() => ContainerDto)
-  containers: ContainerDto[];
+  containers: ContainerDto[];
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'Please handle with care. Delivery before 5 PM.',
+    example: 'Please handle with care. Delivery before 5 PM.',
-    description: 'Special instructions for the carrier'
+    description: 'Special instructions for the carrier'
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @IsString()
+  @IsString()
-  specialInstructions?: string;
+  specialInstructions?: string;
-}
+}

apps/backend/src/application/dto/index.ts

@@ -1,9 +1,9 @@
-// Rate Search DTOs
+// Rate Search DTOs
-export * from './rate-search-request.dto';
+export * from './rate-search-request.dto';
-export * from './rate-search-response.dto';
+export * from './rate-search-response.dto';
-
+
-// Booking DTOs
+// Booking DTOs
-export * from './create-booking-request.dto';
+export * from './create-booking-request.dto';
-export * from './booking-response.dto';
+export * from './booking-response.dto';
-export * from './booking-filter.dto';
+export * from './booking-filter.dto';
-export * from './booking-export.dto';
+export * from './booking-export.dto';

apps/backend/src/application/dto/organization.dto.ts

@@ -1,301 +1,301 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import {
+import {
-  IsString,
+  IsString,
-  IsEnum,
+  IsEnum,
-  IsNotEmpty,
+  IsNotEmpty,
-  MinLength,
+  MinLength,
-  MaxLength,
+  MaxLength,
-  IsOptional,
+  IsOptional,
-  IsUrl,
+  IsUrl,
-  IsBoolean,
+  IsBoolean,
-  ValidateNested,
+  ValidateNested,
-  Matches,
+  Matches,
-  IsUUID,
+  IsUUID,
-} from 'class-validator';
+} from 'class-validator';
-import { Type } from 'class-transformer';
+import { Type } from 'class-transformer';
-import { OrganizationType } from '../../domain/entities/organization.entity';
+import { OrganizationType } from '../../domain/entities/organization.entity';
-
+
-/**
+/**
- * Address DTO
+ * Address DTO
- */
+ */
-export class AddressDto {
+export class AddressDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: '123 Main Street',
+    example: '123 Main Street',
-    description: 'Street address',
+    description: 'Street address',
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsNotEmpty()
+  @IsNotEmpty()
-  street: string;
+  street: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Rotterdam',
+    example: 'Rotterdam',
-    description: 'City',
+    description: 'City',
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsNotEmpty()
+  @IsNotEmpty()
-  city: string;
+  city: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'South Holland',
+    example: 'South Holland',
-    description: 'State or province',
+    description: 'State or province',
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  state?: string;
+  state?: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '3000 AB',
+    example: '3000 AB',
-    description: 'Postal code',
+    description: 'Postal code',
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsNotEmpty()
+  @IsNotEmpty()
-  postalCode: string;
+  postalCode: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'NL',
+    example: 'NL',
-    description: 'Country code (ISO 3166-1 alpha-2)',
+    description: 'Country code (ISO 3166-1 alpha-2)',
-    minLength: 2,
+    minLength: 2,
-    maxLength: 2,
+    maxLength: 2,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(2)
+  @MinLength(2)
-  @MaxLength(2)
+  @MaxLength(2)
-  @Matches(/^[A-Z]{2}$/, { message: 'Country must be a 2-letter ISO code (e.g., NL, US, CN)' })
+  @Matches(/^[A-Z]{2}$/, { message: 'Country must be a 2-letter ISO code (e.g., NL, US, CN)' })
-  country: string;
+  country: string;
-}
+}
-
+
-/**
+/**
- * Create Organization DTO
+ * Create Organization DTO
- */
+ */
-export class CreateOrganizationDto {
+export class CreateOrganizationDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Acme Freight Forwarding',
+    example: 'Acme Freight Forwarding',
-    description: 'Organization name',
+    description: 'Organization name',
-    minLength: 2,
+    minLength: 2,
-    maxLength: 200,
+    maxLength: 200,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsNotEmpty()
+  @IsNotEmpty()
-  @MinLength(2)
+  @MinLength(2)
-  @MaxLength(200)
+  @MaxLength(200)
-  name: string;
+  name: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: OrganizationType.FREIGHT_FORWARDER,
+    example: OrganizationType.FREIGHT_FORWARDER,
-    description: 'Organization type',
+    description: 'Organization type',
-    enum: OrganizationType,
+    enum: OrganizationType,
-  })
+  })
-  @IsEnum(OrganizationType)
+  @IsEnum(OrganizationType)
-  type: OrganizationType;
+  type: OrganizationType;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'MAEU',
+    example: 'MAEU',
-    description: 'Standard Carrier Alpha Code (4 uppercase letters, required for carriers only)',
+    description: 'Standard Carrier Alpha Code (4 uppercase letters, required for carriers only)',
-    minLength: 4,
+    minLength: 4,
-    maxLength: 4,
+    maxLength: 4,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  @MinLength(4)
+  @MinLength(4)
-  @MaxLength(4)
+  @MaxLength(4)
-  @Matches(/^[A-Z]{4}$/, { message: 'SCAC must be 4 uppercase letters (e.g., MAEU, MSCU)' })
+  @Matches(/^[A-Z]{4}$/, { message: 'SCAC must be 4 uppercase letters (e.g., MAEU, MSCU)' })
-  scac?: string;
+  scac?: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Organization address',
+    description: 'Organization address',
-    type: AddressDto,
+    type: AddressDto,
-  })
+  })
-  @ValidateNested()
+  @ValidateNested()
-  @Type(() => AddressDto)
+  @Type(() => AddressDto)
-  address: AddressDto;
+  address: AddressDto;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'https://example.com/logo.png',
+    example: 'https://example.com/logo.png',
-    description: 'Logo URL',
+    description: 'Logo URL',
-  })
+  })
-  @IsUrl()
+  @IsUrl()
-  @IsOptional()
+  @IsOptional()
-  logoUrl?: string;
+  logoUrl?: string;
-}
+}
-
+
-/**
+/**
- * Update Organization DTO
+ * Update Organization DTO
- */
+ */
-export class UpdateOrganizationDto {
+export class UpdateOrganizationDto {
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'Acme Freight Forwarding Inc.',
+    example: 'Acme Freight Forwarding Inc.',
-    description: 'Organization name',
+    description: 'Organization name',
-    minLength: 2,
+    minLength: 2,
-    maxLength: 200,
+    maxLength: 200,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  @MinLength(2)
+  @MinLength(2)
-  @MaxLength(200)
+  @MaxLength(200)
-  name?: string;
+  name?: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'Organization address',
+    description: 'Organization address',
-    type: AddressDto,
+    type: AddressDto,
-  })
+  })
-  @ValidateNested()
+  @ValidateNested()
-  @Type(() => AddressDto)
+  @Type(() => AddressDto)
-  @IsOptional()
+  @IsOptional()
-  address?: AddressDto;
+  address?: AddressDto;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'https://example.com/logo.png',
+    example: 'https://example.com/logo.png',
-    description: 'Logo URL',
+    description: 'Logo URL',
-  })
+  })
-  @IsUrl()
+  @IsUrl()
-  @IsOptional()
+  @IsOptional()
-  logoUrl?: string;
+  logoUrl?: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: true,
+    example: true,
-    description: 'Active status',
+    description: 'Active status',
-  })
+  })
-  @IsBoolean()
+  @IsBoolean()
-  @IsOptional()
+  @IsOptional()
-  isActive?: boolean;
+  isActive?: boolean;
-}
+}
-
+
-/**
+/**
- * Organization Document DTO
+ * Organization Document DTO
- */
+ */
-export class OrganizationDocumentDto {
+export class OrganizationDocumentDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Document ID',
+    description: 'Document ID',
-  })
+  })
-  @IsUUID()
+  @IsUUID()
-  id: string;
+  id: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'business_license',
+    example: 'business_license',
-    description: 'Document type',
+    description: 'Document type',
-  })
+  })
-  @IsString()
+  @IsString()
-  type: string;
+  type: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Business License 2025',
+    example: 'Business License 2025',
-    description: 'Document name',
+    description: 'Document name',
-  })
+  })
-  @IsString()
+  @IsString()
-  name: string;
+  name: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'https://s3.amazonaws.com/xpeditis/documents/doc123.pdf',
+    example: 'https://s3.amazonaws.com/xpeditis/documents/doc123.pdf',
-    description: 'Document URL',
+    description: 'Document URL',
-  })
+  })
-  @IsUrl()
+  @IsUrl()
-  url: string;
+  url: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '2025-01-15T10:00:00Z',
+    example: '2025-01-15T10:00:00Z',
-    description: 'Upload timestamp',
+    description: 'Upload timestamp',
-  })
+  })
-  uploadedAt: Date;
+  uploadedAt: Date;
-}
+}
-
+
-/**
+/**
- * Organization Response DTO
+ * Organization Response DTO
- */
+ */
-export class OrganizationResponseDto {
+export class OrganizationResponseDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Organization ID',
+    description: 'Organization ID',
-  })
+  })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Acme Freight Forwarding',
+    example: 'Acme Freight Forwarding',
-    description: 'Organization name',
+    description: 'Organization name',
-  })
+  })
-  name: string;
+  name: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: OrganizationType.FREIGHT_FORWARDER,
+    example: OrganizationType.FREIGHT_FORWARDER,
-    description: 'Organization type',
+    description: 'Organization type',
-    enum: OrganizationType,
+    enum: OrganizationType,
-  })
+  })
-  type: OrganizationType;
+  type: OrganizationType;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'MAEU',
+    example: 'MAEU',
-    description: 'Standard Carrier Alpha Code (carriers only)',
+    description: 'Standard Carrier Alpha Code (carriers only)',
-  })
+  })
-  scac?: string;
+  scac?: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Organization address',
+    description: 'Organization address',
-    type: AddressDto,
+    type: AddressDto,
-  })
+  })
-  address: AddressDto;
+  address: AddressDto;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'https://example.com/logo.png',
+    example: 'https://example.com/logo.png',
-    description: 'Logo URL',
+    description: 'Logo URL',
-  })
+  })
-  logoUrl?: string;
+  logoUrl?: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Organization documents',
+    description: 'Organization documents',
-    type: [OrganizationDocumentDto],
+    type: [OrganizationDocumentDto],
-  })
+  })
-  documents: OrganizationDocumentDto[];
+  documents: OrganizationDocumentDto[];
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: true,
+    example: true,
-    description: 'Active status',
+    description: 'Active status',
-  })
+  })
-  isActive: boolean;
+  isActive: boolean;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '2025-01-01T00:00:00Z',
+    example: '2025-01-01T00:00:00Z',
-    description: 'Creation timestamp',
+    description: 'Creation timestamp',
-  })
+  })
-  createdAt: Date;
+  createdAt: Date;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '2025-01-15T10:00:00Z',
+    example: '2025-01-15T10:00:00Z',
-    description: 'Last update timestamp',
+    description: 'Last update timestamp',
-  })
+  })
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-/**
+/**
- * Organization List Response DTO
+ * Organization List Response DTO
- */
+ */
-export class OrganizationListResponseDto {
+export class OrganizationListResponseDto {
-  @ApiProperty({
+  @ApiProperty({
-    description: 'List of organizations',
+    description: 'List of organizations',
-    type: [OrganizationResponseDto],
+    type: [OrganizationResponseDto],
-  })
+  })
-  organizations: OrganizationResponseDto[];
+  organizations: OrganizationResponseDto[];
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 25,
+    example: 25,
-    description: 'Total number of organizations',
+    description: 'Total number of organizations',
-  })
+  })
-  total: number;
+  total: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 1,
+    example: 1,
-    description: 'Current page number',
+    description: 'Current page number',
-  })
+  })
-  page: number;
+  page: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 20,
+    example: 20,
-    description: 'Page size',
+    description: 'Page size',
-  })
+  })
-  pageSize: number;
+  pageSize: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 2,
+    example: 2,
-    description: 'Total number of pages',
+    description: 'Total number of pages',
-  })
+  })
-  totalPages: number;
+  totalPages: number;
-}
+}

apps/backend/src/application/dto/rate-search-request.dto.ts

@@ -1,97 +1,97 @@
-import { IsString, IsDateString, IsEnum, IsOptional, IsInt, Min, IsBoolean, Matches } from 'class-validator';
+import { IsString, IsDateString, IsEnum, IsOptional, IsInt, Min, IsBoolean, Matches } from 'class-validator';
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
+
-export class RateSearchRequestDto {
+export class RateSearchRequestDto {
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Origin port code (UN/LOCODE)',
+    description: 'Origin port code (UN/LOCODE)',
-    example: 'NLRTM',
+    example: 'NLRTM',
-    pattern: '^[A-Z]{5}$',
+    pattern: '^[A-Z]{5}$',
-  })
+  })
-  @IsString()
+  @IsString()
-  @Matches(/^[A-Z]{5}$/, { message: 'Origin must be a valid 5-character UN/LOCODE (e.g., NLRTM)' })
+  @Matches(/^[A-Z]{5}$/, { message: 'Origin must be a valid 5-character UN/LOCODE (e.g., NLRTM)' })
-  origin: string;
+  origin: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Destination port code (UN/LOCODE)',
+    description: 'Destination port code (UN/LOCODE)',
-    example: 'CNSHA',
+    example: 'CNSHA',
-    pattern: '^[A-Z]{5}$',
+    pattern: '^[A-Z]{5}$',
-  })
+  })
-  @IsString()
+  @IsString()
-  @Matches(/^[A-Z]{5}$/, { message: 'Destination must be a valid 5-character UN/LOCODE (e.g., CNSHA)' })
+  @Matches(/^[A-Z]{5}$/, { message: 'Destination must be a valid 5-character UN/LOCODE (e.g., CNSHA)' })
-  destination: string;
+  destination: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Container type',
+    description: 'Container type',
-    example: '40HC',
+    example: '40HC',
-    enum: ['20DRY', '20HC', '40DRY', '40HC', '40REEFER', '45HC'],
+    enum: ['20DRY', '20HC', '40DRY', '40HC', '40REEFER', '45HC'],
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsEnum(['20DRY', '20HC', '40DRY', '40HC', '40REEFER', '45HC'], {
+  @IsEnum(['20DRY', '20HC', '40DRY', '40HC', '40REEFER', '45HC'], {
-    message: 'Container type must be one of: 20DRY, 20HC, 40DRY, 40HC, 40REEFER, 45HC',
+    message: 'Container type must be one of: 20DRY, 20HC, 40DRY, 40HC, 40REEFER, 45HC',
-  })
+  })
-  containerType: string;
+  containerType: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Shipping mode',
+    description: 'Shipping mode',
-    example: 'FCL',
+    example: 'FCL',
-    enum: ['FCL', 'LCL'],
+    enum: ['FCL', 'LCL'],
-  })
+  })
-  @IsEnum(['FCL', 'LCL'], { message: 'Mode must be either FCL or LCL' })
+  @IsEnum(['FCL', 'LCL'], { message: 'Mode must be either FCL or LCL' })
-  mode: 'FCL' | 'LCL';
+  mode: 'FCL' | 'LCL';
-
+
-  @ApiProperty({
+  @ApiProperty({
-    description: 'Desired departure date (ISO 8601 format)',
+    description: 'Desired departure date (ISO 8601 format)',
-    example: '2025-02-15',
+    example: '2025-02-15',
-  })
+  })
-  @IsDateString({}, { message: 'Departure date must be a valid ISO 8601 date string' })
+  @IsDateString({}, { message: 'Departure date must be a valid ISO 8601 date string' })
-  departureDate: string;
+  departureDate: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'Number of containers',
+    description: 'Number of containers',
-    example: 2,
+    example: 2,
-    minimum: 1,
+    minimum: 1,
-    default: 1,
+    default: 1,
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @IsInt()
+  @IsInt()
-  @Min(1, { message: 'Quantity must be at least 1' })
+  @Min(1, { message: 'Quantity must be at least 1' })
-  quantity?: number;
+  quantity?: number;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'Total cargo weight in kg',
+    description: 'Total cargo weight in kg',
-    example: 20000,
+    example: 20000,
-    minimum: 0,
+    minimum: 0,
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @IsInt()
+  @IsInt()
-  @Min(0, { message: 'Weight must be non-negative' })
+  @Min(0, { message: 'Weight must be non-negative' })
-  weight?: number;
+  weight?: number;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'Total cargo volume in cubic meters',
+    description: 'Total cargo volume in cubic meters',
-    example: 50.5,
+    example: 50.5,
-    minimum: 0,
+    minimum: 0,
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @Min(0, { message: 'Volume must be non-negative' })
+  @Min(0, { message: 'Volume must be non-negative' })
-  volume?: number;
+  volume?: number;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'Whether cargo is hazardous material',
+    description: 'Whether cargo is hazardous material',
-    example: false,
+    example: false,
-    default: false,
+    default: false,
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @IsBoolean()
+  @IsBoolean()
-  isHazmat?: boolean;
+  isHazmat?: boolean;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    description: 'IMO hazmat class (required if isHazmat is true)',
+    description: 'IMO hazmat class (required if isHazmat is true)',
-    example: '3',
+    example: '3',
-    pattern: '^[1-9](\\.[1-9])?$',
+    pattern: '^[1-9](\\.[1-9])?$',
-  })
+  })
-  @IsOptional()
+  @IsOptional()
-  @IsString()
+  @IsString()
-  @Matches(/^[1-9](\.[1-9])?$/, { message: 'IMO class must be in format X or X.Y (e.g., 3 or 3.1)' })
+  @Matches(/^[1-9](\.[1-9])?$/, { message: 'IMO class must be in format X or X.Y (e.g., 3 or 3.1)' })
-  imoClass?: string;
+  imoClass?: string;
-}
+}

apps/backend/src/application/dto/rate-search-response.dto.ts

@@ -1,148 +1,148 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
+
-export class PortDto {
+export class PortDto {
-  @ApiProperty({ example: 'NLRTM' })
+  @ApiProperty({ example: 'NLRTM' })
-  code: string;
+  code: string;
-
+
-  @ApiProperty({ example: 'Rotterdam' })
+  @ApiProperty({ example: 'Rotterdam' })
-  name: string;
+  name: string;
-
+
-  @ApiProperty({ example: 'Netherlands' })
+  @ApiProperty({ example: 'Netherlands' })
-  country: string;
+  country: string;
-}
+}
-
+
-export class SurchargeDto {
+export class SurchargeDto {
-  @ApiProperty({ example: 'BAF', description: 'Surcharge type code' })
+  @ApiProperty({ example: 'BAF', description: 'Surcharge type code' })
-  type: string;
+  type: string;
-
+
-  @ApiProperty({ example: 'Bunker Adjustment Factor' })
+  @ApiProperty({ example: 'Bunker Adjustment Factor' })
-  description: string;
+  description: string;
-
+
-  @ApiProperty({ example: 150.0 })
+  @ApiProperty({ example: 150.0 })
-  amount: number;
+  amount: number;
-
+
-  @ApiProperty({ example: 'USD' })
+  @ApiProperty({ example: 'USD' })
-  currency: string;
+  currency: string;
-}
+}
-
+
-export class PricingDto {
+export class PricingDto {
-  @ApiProperty({ example: 1500.0, description: 'Base ocean freight' })
+  @ApiProperty({ example: 1500.0, description: 'Base ocean freight' })
-  baseFreight: number;
+  baseFreight: number;
-
+
-  @ApiProperty({ type: [SurchargeDto] })
+  @ApiProperty({ type: [SurchargeDto] })
-  surcharges: SurchargeDto[];
+  surcharges: SurchargeDto[];
-
+
-  @ApiProperty({ example: 1700.0, description: 'Total amount including all surcharges' })
+  @ApiProperty({ example: 1700.0, description: 'Total amount including all surcharges' })
-  totalAmount: number;
+  totalAmount: number;
-
+
-  @ApiProperty({ example: 'USD' })
+  @ApiProperty({ example: 'USD' })
-  currency: string;
+  currency: string;
-}
+}
-
+
-export class RouteSegmentDto {
+export class RouteSegmentDto {
-  @ApiProperty({ example: 'NLRTM' })
+  @ApiProperty({ example: 'NLRTM' })
-  portCode: string;
+  portCode: string;
-
+
-  @ApiProperty({ example: 'Port of Rotterdam' })
+  @ApiProperty({ example: 'Port of Rotterdam' })
-  portName: string;
+  portName: string;
-
+
-  @ApiPropertyOptional({ example: '2025-02-15T10:00:00Z' })
+  @ApiPropertyOptional({ example: '2025-02-15T10:00:00Z' })
-  arrival?: string;
+  arrival?: string;
-
+
-  @ApiPropertyOptional({ example: '2025-02-15T14:00:00Z' })
+  @ApiPropertyOptional({ example: '2025-02-15T14:00:00Z' })
-  departure?: string;
+  departure?: string;
-
+
-  @ApiPropertyOptional({ example: 'MAERSK ESSEX' })
+  @ApiPropertyOptional({ example: 'MAERSK ESSEX' })
-  vesselName?: string;
+  vesselName?: string;
-
+
-  @ApiPropertyOptional({ example: '025W' })
+  @ApiPropertyOptional({ example: '025W' })
-  voyageNumber?: string;
+  voyageNumber?: string;
-}
+}
-
+
-export class RateQuoteDto {
+export class RateQuoteDto {
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440000' })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440001' })
+  @ApiProperty({ example: '550e8400-e29b-41d4-a716-446655440001' })
-  carrierId: string;
+  carrierId: string;
-
+
-  @ApiProperty({ example: 'Maersk Line' })
+  @ApiProperty({ example: 'Maersk Line' })
-  carrierName: string;
+  carrierName: string;
-
+
-  @ApiProperty({ example: 'MAERSK' })
+  @ApiProperty({ example: 'MAERSK' })
-  carrierCode: string;
+  carrierCode: string;
-
+
-  @ApiProperty({ type: PortDto })
+  @ApiProperty({ type: PortDto })
-  origin: PortDto;
+  origin: PortDto;
-
+
-  @ApiProperty({ type: PortDto })
+  @ApiProperty({ type: PortDto })
-  destination: PortDto;
+  destination: PortDto;
-
+
-  @ApiProperty({ type: PricingDto })
+  @ApiProperty({ type: PricingDto })
-  pricing: PricingDto;
+  pricing: PricingDto;
-
+
-  @ApiProperty({ example: '40HC' })
+  @ApiProperty({ example: '40HC' })
-  containerType: string;
+  containerType: string;
-
+
-  @ApiProperty({ example: 'FCL', enum: ['FCL', 'LCL'] })
+  @ApiProperty({ example: 'FCL', enum: ['FCL', 'LCL'] })
-  mode: 'FCL' | 'LCL';
+  mode: 'FCL' | 'LCL';
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z', description: 'Estimated Time of Departure' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z', description: 'Estimated Time of Departure' })
-  etd: string;
+  etd: string;
-
+
-  @ApiProperty({ example: '2025-03-17T14:00:00Z', description: 'Estimated Time of Arrival' })
+  @ApiProperty({ example: '2025-03-17T14:00:00Z', description: 'Estimated Time of Arrival' })
-  eta: string;
+  eta: string;
-
+
-  @ApiProperty({ example: 30, description: 'Transit time in days' })
+  @ApiProperty({ example: 30, description: 'Transit time in days' })
-  transitDays: number;
+  transitDays: number;
-
+
-  @ApiProperty({ type: [RouteSegmentDto], description: 'Route segments with port details' })
+  @ApiProperty({ type: [RouteSegmentDto], description: 'Route segments with port details' })
-  route: RouteSegmentDto[];
+  route: RouteSegmentDto[];
-
+
-  @ApiProperty({ example: 85, description: 'Available container slots' })
+  @ApiProperty({ example: 85, description: 'Available container slots' })
-  availability: number;
+  availability: number;
-
+
-  @ApiProperty({ example: 'Weekly' })
+  @ApiProperty({ example: 'Weekly' })
-  frequency: string;
+  frequency: string;
-
+
-  @ApiPropertyOptional({ example: 'Container Ship' })
+  @ApiPropertyOptional({ example: 'Container Ship' })
-  vesselType?: string;
+  vesselType?: string;
-
+
-  @ApiPropertyOptional({ example: 12500.5, description: 'CO2 emissions in kg' })
+  @ApiPropertyOptional({ example: 12500.5, description: 'CO2 emissions in kg' })
-  co2EmissionsKg?: number;
+  co2EmissionsKg?: number;
-
+
-  @ApiProperty({ example: '2025-02-15T10:15:00Z', description: 'Quote expiration timestamp' })
+  @ApiProperty({ example: '2025-02-15T10:15:00Z', description: 'Quote expiration timestamp' })
-  validUntil: string;
+  validUntil: string;
-
+
-  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
+  @ApiProperty({ example: '2025-02-15T10:00:00Z' })
-  createdAt: string;
+  createdAt: string;
-}
+}
-
+
-export class RateSearchResponseDto {
+export class RateSearchResponseDto {
-  @ApiProperty({ type: [RateQuoteDto] })
+  @ApiProperty({ type: [RateQuoteDto] })
-  quotes: RateQuoteDto[];
+  quotes: RateQuoteDto[];
-
+
-  @ApiProperty({ example: 5, description: 'Total number of quotes returned' })
+  @ApiProperty({ example: 5, description: 'Total number of quotes returned' })
-  count: number;
+  count: number;
-
+
-  @ApiProperty({ example: 'NLRTM' })
+  @ApiProperty({ example: 'NLRTM' })
-  origin: string;
+  origin: string;
-
+
-  @ApiProperty({ example: 'CNSHA' })
+  @ApiProperty({ example: 'CNSHA' })
-  destination: string;
+  destination: string;
-
+
-  @ApiProperty({ example: '2025-02-15' })
+  @ApiProperty({ example: '2025-02-15' })
-  departureDate: string;
+  departureDate: string;
-
+
-  @ApiProperty({ example: '40HC' })
+  @ApiProperty({ example: '40HC' })
-  containerType: string;
+  containerType: string;
-
+
-  @ApiProperty({ example: 'FCL' })
+  @ApiProperty({ example: 'FCL' })
-  mode: string;
+  mode: string;
-
+
-  @ApiProperty({ example: true, description: 'Whether results were served from cache' })
+  @ApiProperty({ example: true, description: 'Whether results were served from cache' })
-  fromCache: boolean;
+  fromCache: boolean;
-
+
-  @ApiProperty({ example: 234, description: 'Query response time in milliseconds' })
+  @ApiProperty({ example: 234, description: 'Query response time in milliseconds' })
-  responseTimeMs: number;
+  responseTimeMs: number;
-}
+}

apps/backend/src/application/dto/user.dto.ts

@@ -1,236 +1,236 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import {
+import {
-  IsString,
+  IsString,
-  IsEmail,
+  IsEmail,
-  IsEnum,
+  IsEnum,
-  IsNotEmpty,
+  IsNotEmpty,
-  MinLength,
+  MinLength,
-  MaxLength,
+  MaxLength,
-  IsOptional,
+  IsOptional,
-  IsBoolean,
+  IsBoolean,
-  IsUUID,
+  IsUUID,
-} from 'class-validator';
+} from 'class-validator';
-
+
-/**
+/**
- * User roles enum
+ * User roles enum
- */
+ */
-export enum UserRole {
+export enum UserRole {
-  ADMIN = 'admin',
+  ADMIN = 'admin',
-  MANAGER = 'manager',
+  MANAGER = 'manager',
-  USER = 'user',
+  USER = 'user',
-  VIEWER = 'viewer',
+  VIEWER = 'viewer',
-}
+}
-
+
-/**
+/**
- * Create User DTO (for admin/manager inviting users)
+ * Create User DTO (for admin/manager inviting users)
- */
+ */
-export class CreateUserDto {
+export class CreateUserDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'jane.doe@acme.com',
+    example: 'jane.doe@acme.com',
-    description: 'User email address',
+    description: 'User email address',
-  })
+  })
-  @IsEmail({}, { message: 'Invalid email format' })
+  @IsEmail({}, { message: 'Invalid email format' })
-  email: string;
+  email: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Jane',
+    example: 'Jane',
-    description: 'First name',
+    description: 'First name',
-    minLength: 2,
+    minLength: 2,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'First name must be at least 2 characters' })
+  @MinLength(2, { message: 'First name must be at least 2 characters' })
-  firstName: string;
+  firstName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Doe',
+    example: 'Doe',
-    description: 'Last name',
+    description: 'Last name',
-    minLength: 2,
+    minLength: 2,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(2, { message: 'Last name must be at least 2 characters' })
+  @MinLength(2, { message: 'Last name must be at least 2 characters' })
-  lastName: string;
+  lastName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: UserRole.USER,
+    example: UserRole.USER,
-    description: 'User role',
+    description: 'User role',
-    enum: UserRole,
+    enum: UserRole,
-  })
+  })
-  @IsEnum(UserRole)
+  @IsEnum(UserRole)
-  role: UserRole;
+  role: UserRole;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Organization ID',
+    description: 'Organization ID',
-  })
+  })
-  @IsUUID()
+  @IsUUID()
-  organizationId: string;
+  organizationId: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'TempPassword123!',
+    example: 'TempPassword123!',
-    description: 'Temporary password (min 12 characters). If not provided, a random one will be generated.',
+    description: 'Temporary password (min 12 characters). If not provided, a random one will be generated.',
-    minLength: 12,
+    minLength: 12,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  @MinLength(12, { message: 'Password must be at least 12 characters' })
+  @MinLength(12, { message: 'Password must be at least 12 characters' })
-  password?: string;
+  password?: string;
-}
+}
-
+
-/**
+/**
- * Update User DTO
+ * Update User DTO
- */
+ */
-export class UpdateUserDto {
+export class UpdateUserDto {
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'Jane',
+    example: 'Jane',
-    description: 'First name',
+    description: 'First name',
-    minLength: 2,
+    minLength: 2,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  @MinLength(2)
+  @MinLength(2)
-  firstName?: string;
+  firstName?: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: 'Doe',
+    example: 'Doe',
-    description: 'Last name',
+    description: 'Last name',
-    minLength: 2,
+    minLength: 2,
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsOptional()
+  @IsOptional()
-  @MinLength(2)
+  @MinLength(2)
-  lastName?: string;
+  lastName?: string;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: UserRole.MANAGER,
+    example: UserRole.MANAGER,
-    description: 'User role',
+    description: 'User role',
-    enum: UserRole,
+    enum: UserRole,
-  })
+  })
-  @IsEnum(UserRole)
+  @IsEnum(UserRole)
-  @IsOptional()
+  @IsOptional()
-  role?: UserRole;
+  role?: UserRole;
-
+
-  @ApiPropertyOptional({
+  @ApiPropertyOptional({
-    example: true,
+    example: true,
-    description: 'Active status',
+    description: 'Active status',
-  })
+  })
-  @IsBoolean()
+  @IsBoolean()
-  @IsOptional()
+  @IsOptional()
-  isActive?: boolean;
+  isActive?: boolean;
-}
+}
-
+
-/**
+/**
- * Update Password DTO
+ * Update Password DTO
- */
+ */
-export class UpdatePasswordDto {
+export class UpdatePasswordDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: 'OldPassword123!',
+    example: 'OldPassword123!',
-    description: 'Current password',
+    description: 'Current password',
-  })
+  })
-  @IsString()
+  @IsString()
-  @IsNotEmpty()
+  @IsNotEmpty()
-  currentPassword: string;
+  currentPassword: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'NewSecurePassword456!',
+    example: 'NewSecurePassword456!',
-    description: 'New password (min 12 characters)',
+    description: 'New password (min 12 characters)',
-    minLength: 12,
+    minLength: 12,
-  })
+  })
-  @IsString()
+  @IsString()
-  @MinLength(12, { message: 'Password must be at least 12 characters' })
+  @MinLength(12, { message: 'Password must be at least 12 characters' })
-  newPassword: string;
+  newPassword: string;
-}
+}
-
+
-/**
+/**
- * User Response DTO
+ * User Response DTO
- */
+ */
-export class UserResponseDto {
+export class UserResponseDto {
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'User ID',
+    description: 'User ID',
-  })
+  })
-  id: string;
+  id: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'john.doe@acme.com',
+    example: 'john.doe@acme.com',
-    description: 'User email',
+    description: 'User email',
-  })
+  })
-  email: string;
+  email: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'John',
+    example: 'John',
-    description: 'First name',
+    description: 'First name',
-  })
+  })
-  firstName: string;
+  firstName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 'Doe',
+    example: 'Doe',
-    description: 'Last name',
+    description: 'Last name',
-  })
+  })
-  lastName: string;
+  lastName: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: UserRole.USER,
+    example: UserRole.USER,
-    description: 'User role',
+    description: 'User role',
-    enum: UserRole,
+    enum: UserRole,
-  })
+  })
-  role: UserRole;
+  role: UserRole;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '550e8400-e29b-41d4-a716-446655440000',
+    example: '550e8400-e29b-41d4-a716-446655440000',
-    description: 'Organization ID',
+    description: 'Organization ID',
-  })
+  })
-  organizationId: string;
+  organizationId: string;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: true,
+    example: true,
-    description: 'Active status',
+    description: 'Active status',
-  })
+  })
-  isActive: boolean;
+  isActive: boolean;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '2025-01-01T00:00:00Z',
+    example: '2025-01-01T00:00:00Z',
-    description: 'Creation timestamp',
+    description: 'Creation timestamp',
-  })
+  })
-  createdAt: Date;
+  createdAt: Date;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: '2025-01-15T10:00:00Z',
+    example: '2025-01-15T10:00:00Z',
-    description: 'Last update timestamp',
+    description: 'Last update timestamp',
-  })
+  })
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-/**
+/**
- * User List Response DTO
+ * User List Response DTO
- */
+ */
-export class UserListResponseDto {
+export class UserListResponseDto {
-  @ApiProperty({
+  @ApiProperty({
-    description: 'List of users',
+    description: 'List of users',
-    type: [UserResponseDto],
+    type: [UserResponseDto],
-  })
+  })
-  users: UserResponseDto[];
+  users: UserResponseDto[];
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 15,
+    example: 15,
-    description: 'Total number of users',
+    description: 'Total number of users',
-  })
+  })
-  total: number;
+  total: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 1,
+    example: 1,
-    description: 'Current page number',
+    description: 'Current page number',
-  })
+  })
-  page: number;
+  page: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 20,
+    example: 20,
-    description: 'Page size',
+    description: 'Page size',
-  })
+  })
-  pageSize: number;
+  pageSize: number;
-
+
-  @ApiProperty({
+  @ApiProperty({
-    example: 1,
+    example: 1,
-    description: 'Total number of pages',
+    description: 'Total number of pages',
-  })
+  })
-  totalPages: number;
+  totalPages: number;
-}
+}

apps/backend/src/application/guards/index.ts

@@ -1,2 +1,2 @@
-export * from './jwt-auth.guard';
+export * from './jwt-auth.guard';
-export * from './roles.guard';
+export * from './roles.guard';

apps/backend/src/application/guards/jwt-auth.guard.ts

@@ -1,45 +1,45 @@
-import { Injectable, ExecutionContext } from '@nestjs/common';
+import { Injectable, ExecutionContext } from '@nestjs/common';
-import { AuthGuard } from '@nestjs/passport';
+import { AuthGuard } from '@nestjs/passport';
-import { Reflector } from '@nestjs/core';
+import { Reflector } from '@nestjs/core';
-
+
-/**
+/**
- * JWT Authentication Guard
+ * JWT Authentication Guard
- *
+ *
- * This guard:
+ * This guard:
- * - Uses the JWT strategy to authenticate requests
+ * - Uses the JWT strategy to authenticate requests
- * - Checks for valid JWT token in Authorization header
+ * - Checks for valid JWT token in Authorization header
- * - Attaches user object to request if authentication succeeds
+ * - Attaches user object to request if authentication succeeds
- * - Can be bypassed with @Public() decorator
+ * - Can be bypassed with @Public() decorator
- *
+ *
- * Usage:
+ * Usage:
- * @UseGuards(JwtAuthGuard)
+ * @UseGuards(JwtAuthGuard)
- * @Get('protected')
+ * @Get('protected')
- * protectedRoute(@CurrentUser() user: UserPayload) {
+ * protectedRoute(@CurrentUser() user: UserPayload) {
- *   return { user };
+ *   return { user };
- * }
+ * }
- */
+ */
-@Injectable()
+@Injectable()
-export class JwtAuthGuard extends AuthGuard('jwt') {
+export class JwtAuthGuard extends AuthGuard('jwt') {
-  constructor(private reflector: Reflector) {
+  constructor(private reflector: Reflector) {
-    super();
+    super();
-  }
+  }
-
+
-  /**
+  /**
-   * Determine if the route should be accessible without authentication
+   * Determine if the route should be accessible without authentication
-   * Routes decorated with @Public() will bypass this guard
+   * Routes decorated with @Public() will bypass this guard
-   */
+   */
-  canActivate(context: ExecutionContext) {
+  canActivate(context: ExecutionContext) {
-    // Check if route is marked as public
+    // Check if route is marked as public
-    const isPublic = this.reflector.getAllAndOverride<boolean>('isPublic', [
+    const isPublic = this.reflector.getAllAndOverride<boolean>('isPublic', [
-      context.getHandler(),
+      context.getHandler(),
-      context.getClass(),
+      context.getClass(),
-    ]);
+    ]);
-
+
-    if (isPublic) {
+    if (isPublic) {
-      return true;
+      return true;
-    }
+    }
-
+
-    // Otherwise, perform JWT authentication
+    // Otherwise, perform JWT authentication
-    return super.canActivate(context);
+    return super.canActivate(context);
-  }
+  }
-}
+}

apps/backend/src/application/guards/roles.guard.ts

@@ -1,46 +1,46 @@
-import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common';
+import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common';
-import { Reflector } from '@nestjs/core';
+import { Reflector } from '@nestjs/core';
-
+
-/**
+/**
- * Roles Guard for Role-Based Access Control (RBAC)
+ * Roles Guard for Role-Based Access Control (RBAC)
- *
+ *
- * This guard:
+ * This guard:
- * - Checks if the authenticated user has the required role(s)
+ * - Checks if the authenticated user has the required role(s)
- * - Works in conjunction with JwtAuthGuard
+ * - Works in conjunction with JwtAuthGuard
- * - Uses @Roles() decorator to specify required roles
+ * - Uses @Roles() decorator to specify required roles
- *
+ *
- * Usage:
+ * Usage:
- * @UseGuards(JwtAuthGuard, RolesGuard)
+ * @UseGuards(JwtAuthGuard, RolesGuard)
- * @Roles('admin', 'manager')
+ * @Roles('admin', 'manager')
- * @Get('admin-only')
+ * @Get('admin-only')
- * adminRoute(@CurrentUser() user: UserPayload) {
+ * adminRoute(@CurrentUser() user: UserPayload) {
- *   return { message: 'Admin access granted' };
+ *   return { message: 'Admin access granted' };
- * }
+ * }
- */
+ */
-@Injectable()
+@Injectable()
-export class RolesGuard implements CanActivate {
+export class RolesGuard implements CanActivate {
-  constructor(private reflector: Reflector) {}
+  constructor(private reflector: Reflector) {}
-
+
-  canActivate(context: ExecutionContext): boolean {
+  canActivate(context: ExecutionContext): boolean {
-    // Get required roles from @Roles() decorator
+    // Get required roles from @Roles() decorator
-    const requiredRoles = this.reflector.getAllAndOverride<string[]>('roles', [
+    const requiredRoles = this.reflector.getAllAndOverride<string[]>('roles', [
-      context.getHandler(),
+      context.getHandler(),
-      context.getClass(),
+      context.getClass(),
-    ]);
+    ]);
-
+
-    // If no roles are required, allow access
+    // If no roles are required, allow access
-    if (!requiredRoles || requiredRoles.length === 0) {
+    if (!requiredRoles || requiredRoles.length === 0) {
-      return true;
+      return true;
-    }
+    }
-
+
-    // Get user from request (should be set by JwtAuthGuard)
+    // Get user from request (should be set by JwtAuthGuard)
-    const { user } = context.switchToHttp().getRequest();
+    const { user } = context.switchToHttp().getRequest();
-
+
-    // Check if user has any of the required roles
+    // Check if user has any of the required roles
-    if (!user || !user.role) {
+    if (!user || !user.role) {
-      return false;
+      return false;
-    }
+    }
-
+
-    return requiredRoles.includes(user.role);
+    return requiredRoles.includes(user.role);
-  }
+  }
-}
+}

apps/backend/src/application/mappers/booking.mapper.ts

@@ -1,168 +1,168 @@
-import { Booking } from '../../domain/entities/booking.entity';
+import { Booking } from '../../domain/entities/booking.entity';
-import { RateQuote } from '../../domain/entities/rate-quote.entity';
+import { RateQuote } from '../../domain/entities/rate-quote.entity';
-import {
+import {
-  BookingResponseDto,
+  BookingResponseDto,
-  BookingAddressDto,
+  BookingAddressDto,
-  BookingPartyDto,
+  BookingPartyDto,
-  BookingContainerDto,
+  BookingContainerDto,
-  BookingRateQuoteDto,
+  BookingRateQuoteDto,
-  BookingListItemDto,
+  BookingListItemDto,
-} from '../dto/booking-response.dto';
+} from '../dto/booking-response.dto';
-import {
+import {
-  CreateBookingRequestDto,
+  CreateBookingRequestDto,
-  PartyDto,
+  PartyDto,
-  AddressDto,
+  AddressDto,
-  ContainerDto,
+  ContainerDto,
-} from '../dto/create-booking-request.dto';
+} from '../dto/create-booking-request.dto';
-
+
-export class BookingMapper {
+export class BookingMapper {
-  /**
+  /**
-   * Map CreateBookingRequestDto to domain inputs
+   * Map CreateBookingRequestDto to domain inputs
-   */
+   */
-  static toCreateBookingInput(dto: CreateBookingRequestDto) {
+  static toCreateBookingInput(dto: CreateBookingRequestDto) {
-    return {
+    return {
-      rateQuoteId: dto.rateQuoteId,
+      rateQuoteId: dto.rateQuoteId,
-      shipper: {
+      shipper: {
-        name: dto.shipper.name,
+        name: dto.shipper.name,
-        address: {
+        address: {
-          street: dto.shipper.address.street,
+          street: dto.shipper.address.street,
-          city: dto.shipper.address.city,
+          city: dto.shipper.address.city,
-          postalCode: dto.shipper.address.postalCode,
+          postalCode: dto.shipper.address.postalCode,
-          country: dto.shipper.address.country,
+          country: dto.shipper.address.country,
-        },
+        },
-        contactName: dto.shipper.contactName,
+        contactName: dto.shipper.contactName,
-        contactEmail: dto.shipper.contactEmail,
+        contactEmail: dto.shipper.contactEmail,
-        contactPhone: dto.shipper.contactPhone,
+        contactPhone: dto.shipper.contactPhone,
-      },
+      },
-      consignee: {
+      consignee: {
-        name: dto.consignee.name,
+        name: dto.consignee.name,
-        address: {
+        address: {
-          street: dto.consignee.address.street,
+          street: dto.consignee.address.street,
-          city: dto.consignee.address.city,
+          city: dto.consignee.address.city,
-          postalCode: dto.consignee.address.postalCode,
+          postalCode: dto.consignee.address.postalCode,
-          country: dto.consignee.address.country,
+          country: dto.consignee.address.country,
-        },
+        },
-        contactName: dto.consignee.contactName,
+        contactName: dto.consignee.contactName,
-        contactEmail: dto.consignee.contactEmail,
+        contactEmail: dto.consignee.contactEmail,
-        contactPhone: dto.consignee.contactPhone,
+        contactPhone: dto.consignee.contactPhone,
-      },
+      },
-      cargoDescription: dto.cargoDescription,
+      cargoDescription: dto.cargoDescription,
-      containers: dto.containers.map((c) => ({
+      containers: dto.containers.map((c) => ({
-        type: c.type,
+        type: c.type,
-        containerNumber: c.containerNumber,
+        containerNumber: c.containerNumber,
-        vgm: c.vgm,
+        vgm: c.vgm,
-        temperature: c.temperature,
+        temperature: c.temperature,
-        sealNumber: c.sealNumber,
+        sealNumber: c.sealNumber,
-      })),
+      })),
-      specialInstructions: dto.specialInstructions,
+      specialInstructions: dto.specialInstructions,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map Booking entity and RateQuote to BookingResponseDto
+   * Map Booking entity and RateQuote to BookingResponseDto
-   */
+   */
-  static toDto(booking: Booking, rateQuote: RateQuote): BookingResponseDto {
+  static toDto(booking: Booking, rateQuote: RateQuote): BookingResponseDto {
-    return {
+    return {
-      id: booking.id,
+      id: booking.id,
-      bookingNumber: booking.bookingNumber.value,
+      bookingNumber: booking.bookingNumber.value,
-      status: booking.status.value,
+      status: booking.status.value,
-      shipper: {
+      shipper: {
-        name: booking.shipper.name,
+        name: booking.shipper.name,
-        address: {
+        address: {
-          street: booking.shipper.address.street,
+          street: booking.shipper.address.street,
-          city: booking.shipper.address.city,
+          city: booking.shipper.address.city,
-          postalCode: booking.shipper.address.postalCode,
+          postalCode: booking.shipper.address.postalCode,
-          country: booking.shipper.address.country,
+          country: booking.shipper.address.country,
-        },
+        },
-        contactName: booking.shipper.contactName,
+        contactName: booking.shipper.contactName,
-        contactEmail: booking.shipper.contactEmail,
+        contactEmail: booking.shipper.contactEmail,
-        contactPhone: booking.shipper.contactPhone,
+        contactPhone: booking.shipper.contactPhone,
-      },
+      },
-      consignee: {
+      consignee: {
-        name: booking.consignee.name,
+        name: booking.consignee.name,
-        address: {
+        address: {
-          street: booking.consignee.address.street,
+          street: booking.consignee.address.street,
-          city: booking.consignee.address.city,
+          city: booking.consignee.address.city,
-          postalCode: booking.consignee.address.postalCode,
+          postalCode: booking.consignee.address.postalCode,
-          country: booking.consignee.address.country,
+          country: booking.consignee.address.country,
-        },
+        },
-        contactName: booking.consignee.contactName,
+        contactName: booking.consignee.contactName,
-        contactEmail: booking.consignee.contactEmail,
+        contactEmail: booking.consignee.contactEmail,
-        contactPhone: booking.consignee.contactPhone,
+        contactPhone: booking.consignee.contactPhone,
-      },
+      },
-      cargoDescription: booking.cargoDescription,
+      cargoDescription: booking.cargoDescription,
-      containers: booking.containers.map((c) => ({
+      containers: booking.containers.map((c) => ({
-        id: c.id,
+        id: c.id,
-        type: c.type,
+        type: c.type,
-        containerNumber: c.containerNumber,
+        containerNumber: c.containerNumber,
-        vgm: c.vgm,
+        vgm: c.vgm,
-        temperature: c.temperature,
+        temperature: c.temperature,
-        sealNumber: c.sealNumber,
+        sealNumber: c.sealNumber,
-      })),
+      })),
-      specialInstructions: booking.specialInstructions,
+      specialInstructions: booking.specialInstructions,
-      rateQuote: {
+      rateQuote: {
-        id: rateQuote.id,
+        id: rateQuote.id,
-        carrierName: rateQuote.carrierName,
+        carrierName: rateQuote.carrierName,
-        carrierCode: rateQuote.carrierCode,
+        carrierCode: rateQuote.carrierCode,
-        origin: {
+        origin: {
-          code: rateQuote.origin.code,
+          code: rateQuote.origin.code,
-          name: rateQuote.origin.name,
+          name: rateQuote.origin.name,
-          country: rateQuote.origin.country,
+          country: rateQuote.origin.country,
-        },
+        },
-        destination: {
+        destination: {
-          code: rateQuote.destination.code,
+          code: rateQuote.destination.code,
-          name: rateQuote.destination.name,
+          name: rateQuote.destination.name,
-          country: rateQuote.destination.country,
+          country: rateQuote.destination.country,
-        },
+        },
-        pricing: {
+        pricing: {
-          baseFreight: rateQuote.pricing.baseFreight,
+          baseFreight: rateQuote.pricing.baseFreight,
-          surcharges: rateQuote.pricing.surcharges.map((s) => ({
+          surcharges: rateQuote.pricing.surcharges.map((s) => ({
-            type: s.type,
+            type: s.type,
-            description: s.description,
+            description: s.description,
-            amount: s.amount,
+            amount: s.amount,
-            currency: s.currency,
+            currency: s.currency,
-          })),
+          })),
-          totalAmount: rateQuote.pricing.totalAmount,
+          totalAmount: rateQuote.pricing.totalAmount,
-          currency: rateQuote.pricing.currency,
+          currency: rateQuote.pricing.currency,
-        },
+        },
-        containerType: rateQuote.containerType,
+        containerType: rateQuote.containerType,
-        mode: rateQuote.mode,
+        mode: rateQuote.mode,
-        etd: rateQuote.etd.toISOString(),
+        etd: rateQuote.etd.toISOString(),
-        eta: rateQuote.eta.toISOString(),
+        eta: rateQuote.eta.toISOString(),
-        transitDays: rateQuote.transitDays,
+        transitDays: rateQuote.transitDays,
-      },
+      },
-      createdAt: booking.createdAt.toISOString(),
+      createdAt: booking.createdAt.toISOString(),
-      updatedAt: booking.updatedAt.toISOString(),
+      updatedAt: booking.updatedAt.toISOString(),
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map Booking entity to list item DTO (simplified view)
+   * Map Booking entity to list item DTO (simplified view)
-   */
+   */
-  static toListItemDto(booking: Booking, rateQuote: RateQuote): BookingListItemDto {
+  static toListItemDto(booking: Booking, rateQuote: RateQuote): BookingListItemDto {
-    return {
+    return {
-      id: booking.id,
+      id: booking.id,
-      bookingNumber: booking.bookingNumber.value,
+      bookingNumber: booking.bookingNumber.value,
-      status: booking.status.value,
+      status: booking.status.value,
-      shipperName: booking.shipper.name,
+      shipperName: booking.shipper.name,
-      consigneeName: booking.consignee.name,
+      consigneeName: booking.consignee.name,
-      originPort: rateQuote.origin.code,
+      originPort: rateQuote.origin.code,
-      destinationPort: rateQuote.destination.code,
+      destinationPort: rateQuote.destination.code,
-      carrierName: rateQuote.carrierName,
+      carrierName: rateQuote.carrierName,
-      etd: rateQuote.etd.toISOString(),
+      etd: rateQuote.etd.toISOString(),
-      eta: rateQuote.eta.toISOString(),
+      eta: rateQuote.eta.toISOString(),
-      totalAmount: rateQuote.pricing.totalAmount,
+      totalAmount: rateQuote.pricing.totalAmount,
-      currency: rateQuote.pricing.currency,
+      currency: rateQuote.pricing.currency,
-      createdAt: booking.createdAt.toISOString(),
+      createdAt: booking.createdAt.toISOString(),
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map array of bookings to list item DTOs
+   * Map array of bookings to list item DTOs
-   */
+   */
-  static toListItemDtoArray(
+  static toListItemDtoArray(
-    bookings: Array<{ booking: Booking; rateQuote: RateQuote }>
+    bookings: Array<{ booking: Booking; rateQuote: RateQuote }>
-  ): BookingListItemDto[] {
+  ): BookingListItemDto[] {
-    return bookings.map(({ booking, rateQuote }) => this.toListItemDto(booking, rateQuote));
+    return bookings.map(({ booking, rateQuote }) => this.toListItemDto(booking, rateQuote));
-  }
+  }
-}
+}

apps/backend/src/application/mappers/index.ts

@@ -1,2 +1,2 @@
-export * from './rate-quote.mapper';
+export * from './rate-quote.mapper';
-export * from './booking.mapper';
+export * from './booking.mapper';

apps/backend/src/application/mappers/organization.mapper.ts

@@ -1,83 +1,83 @@
-import {
+import {
-  Organization,
+  Organization,
-  OrganizationAddress,
+  OrganizationAddress,
-  OrganizationDocument,
+  OrganizationDocument,
-} from '../../domain/entities/organization.entity';
+} from '../../domain/entities/organization.entity';
-import {
+import {
-  OrganizationResponseDto,
+  OrganizationResponseDto,
-  OrganizationDocumentDto,
+  OrganizationDocumentDto,
-  AddressDto,
+  AddressDto,
-} from '../dto/organization.dto';
+} from '../dto/organization.dto';
-
+
-/**
+/**
- * Organization Mapper
+ * Organization Mapper
- *
+ *
- * Maps between Organization domain entities and DTOs
+ * Maps between Organization domain entities and DTOs
- */
+ */
-export class OrganizationMapper {
+export class OrganizationMapper {
-  /**
+  /**
-   * Convert Organization entity to DTO
+   * Convert Organization entity to DTO
-   */
+   */
-  static toDto(organization: Organization): OrganizationResponseDto {
+  static toDto(organization: Organization): OrganizationResponseDto {
-    return {
+    return {
-      id: organization.id,
+      id: organization.id,
-      name: organization.name,
+      name: organization.name,
-      type: organization.type,
+      type: organization.type,
-      scac: organization.scac,
+      scac: organization.scac,
-      address: this.mapAddressToDto(organization.address),
+      address: this.mapAddressToDto(organization.address),
-      logoUrl: organization.logoUrl,
+      logoUrl: organization.logoUrl,
-      documents: organization.documents.map(doc => this.mapDocumentToDto(doc)),
+      documents: organization.documents.map(doc => this.mapDocumentToDto(doc)),
-      isActive: organization.isActive,
+      isActive: organization.isActive,
-      createdAt: organization.createdAt,
+      createdAt: organization.createdAt,
-      updatedAt: organization.updatedAt,
+      updatedAt: organization.updatedAt,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Convert array of Organization entities to DTOs
+   * Convert array of Organization entities to DTOs
-   */
+   */
-  static toDtoArray(organizations: Organization[]): OrganizationResponseDto[] {
+  static toDtoArray(organizations: Organization[]): OrganizationResponseDto[] {
-    return organizations.map(org => this.toDto(org));
+    return organizations.map(org => this.toDto(org));
-  }
+  }
-
+
-  /**
+  /**
-   * Map Address entity to DTO
+   * Map Address entity to DTO
-   */
+   */
-  private static mapAddressToDto(address: OrganizationAddress): AddressDto {
+  private static mapAddressToDto(address: OrganizationAddress): AddressDto {
-    return {
+    return {
-      street: address.street,
+      street: address.street,
-      city: address.city,
+      city: address.city,
-      state: address.state,
+      state: address.state,
-      postalCode: address.postalCode,
+      postalCode: address.postalCode,
-      country: address.country,
+      country: address.country,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map Document entity to DTO
+   * Map Document entity to DTO
-   */
+   */
-  private static mapDocumentToDto(
+  private static mapDocumentToDto(
-    document: OrganizationDocument,
+    document: OrganizationDocument,
-  ): OrganizationDocumentDto {
+  ): OrganizationDocumentDto {
-    return {
+    return {
-      id: document.id,
+      id: document.id,
-      type: document.type,
+      type: document.type,
-      name: document.name,
+      name: document.name,
-      url: document.url,
+      url: document.url,
-      uploadedAt: document.uploadedAt,
+      uploadedAt: document.uploadedAt,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map DTO Address to domain Address
+   * Map DTO Address to domain Address
-   */
+   */
-  static mapDtoToAddress(dto: AddressDto): OrganizationAddress {
+  static mapDtoToAddress(dto: AddressDto): OrganizationAddress {
-    return {
+    return {
-      street: dto.street,
+      street: dto.street,
-      city: dto.city,
+      city: dto.city,
-      state: dto.state,
+      state: dto.state,
-      postalCode: dto.postalCode,
+      postalCode: dto.postalCode,
-      country: dto.country,
+      country: dto.country,
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/application/mappers/rate-quote.mapper.ts

@@ -1,69 +1,69 @@
-import { RateQuote } from '../../domain/entities/rate-quote.entity';
+import { RateQuote } from '../../domain/entities/rate-quote.entity';
-import {
+import {
-  RateQuoteDto,
+  RateQuoteDto,
-  PortDto,
+  PortDto,
-  SurchargeDto,
+  SurchargeDto,
-  PricingDto,
+  PricingDto,
-  RouteSegmentDto,
+  RouteSegmentDto,
-} from '../dto/rate-search-response.dto';
+} from '../dto/rate-search-response.dto';
-
+
-export class RateQuoteMapper {
+export class RateQuoteMapper {
-  /**
+  /**
-   * Map domain RateQuote entity to DTO
+   * Map domain RateQuote entity to DTO
-   */
+   */
-  static toDto(entity: RateQuote): RateQuoteDto {
+  static toDto(entity: RateQuote): RateQuoteDto {
-    return {
+    return {
-      id: entity.id,
+      id: entity.id,
-      carrierId: entity.carrierId,
+      carrierId: entity.carrierId,
-      carrierName: entity.carrierName,
+      carrierName: entity.carrierName,
-      carrierCode: entity.carrierCode,
+      carrierCode: entity.carrierCode,
-      origin: {
+      origin: {
-        code: entity.origin.code,
+        code: entity.origin.code,
-        name: entity.origin.name,
+        name: entity.origin.name,
-        country: entity.origin.country,
+        country: entity.origin.country,
-      },
+      },
-      destination: {
+      destination: {
-        code: entity.destination.code,
+        code: entity.destination.code,
-        name: entity.destination.name,
+        name: entity.destination.name,
-        country: entity.destination.country,
+        country: entity.destination.country,
-      },
+      },
-      pricing: {
+      pricing: {
-        baseFreight: entity.pricing.baseFreight,
+        baseFreight: entity.pricing.baseFreight,
-        surcharges: entity.pricing.surcharges.map((s) => ({
+        surcharges: entity.pricing.surcharges.map((s) => ({
-          type: s.type,
+          type: s.type,
-          description: s.description,
+          description: s.description,
-          amount: s.amount,
+          amount: s.amount,
-          currency: s.currency,
+          currency: s.currency,
-        })),
+        })),
-        totalAmount: entity.pricing.totalAmount,
+        totalAmount: entity.pricing.totalAmount,
-        currency: entity.pricing.currency,
+        currency: entity.pricing.currency,
-      },
+      },
-      containerType: entity.containerType,
+      containerType: entity.containerType,
-      mode: entity.mode,
+      mode: entity.mode,
-      etd: entity.etd.toISOString(),
+      etd: entity.etd.toISOString(),
-      eta: entity.eta.toISOString(),
+      eta: entity.eta.toISOString(),
-      transitDays: entity.transitDays,
+      transitDays: entity.transitDays,
-      route: entity.route.map((segment) => ({
+      route: entity.route.map((segment) => ({
-        portCode: segment.portCode,
+        portCode: segment.portCode,
-        portName: segment.portName,
+        portName: segment.portName,
-        arrival: segment.arrival?.toISOString(),
+        arrival: segment.arrival?.toISOString(),
-        departure: segment.departure?.toISOString(),
+        departure: segment.departure?.toISOString(),
-        vesselName: segment.vesselName,
+        vesselName: segment.vesselName,
-        voyageNumber: segment.voyageNumber,
+        voyageNumber: segment.voyageNumber,
-      })),
+      })),
-      availability: entity.availability,
+      availability: entity.availability,
-      frequency: entity.frequency,
+      frequency: entity.frequency,
-      vesselType: entity.vesselType,
+      vesselType: entity.vesselType,
-      co2EmissionsKg: entity.co2EmissionsKg,
+      co2EmissionsKg: entity.co2EmissionsKg,
-      validUntil: entity.validUntil.toISOString(),
+      validUntil: entity.validUntil.toISOString(),
-      createdAt: entity.createdAt.toISOString(),
+      createdAt: entity.createdAt.toISOString(),
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map array of RateQuote entities to DTOs
+   * Map array of RateQuote entities to DTOs
-   */
+   */
-  static toDtoArray(entities: RateQuote[]): RateQuoteDto[] {
+  static toDtoArray(entities: RateQuote[]): RateQuoteDto[] {
-    return entities.map((entity) => this.toDto(entity));
+    return entities.map((entity) => this.toDto(entity));
-  }
+  }
-}
+}

apps/backend/src/application/rates/rates.module.ts

@@ -4,16 +4,28 @@ import { RatesController } from '../controllers/rates.controller';
 import { CacheModule } from '../../infrastructure/cache/cache.module';
 import { CarrierModule } from '../../infrastructure/carriers/carrier.module';
 
+// Import domain services
+import { RateSearchService } from '../../domain/services/rate-search.service';
+
 // Import domain ports
 import { RATE_QUOTE_REPOSITORY } from '../../domain/ports/out/rate-quote.repository';
+import { PORT_REPOSITORY } from '../../domain/ports/out/port.repository';
+import { CARRIER_REPOSITORY } from '../../domain/ports/out/carrier.repository';
+import { CACHE_PORT } from '../../domain/ports/out/cache.port';
+
+// Import infrastructure implementations
 import { TypeOrmRateQuoteRepository } from '../../infrastructure/persistence/typeorm/repositories/typeorm-rate-quote.repository';
+import { TypeOrmPortRepository } from '../../infrastructure/persistence/typeorm/repositories/typeorm-port.repository';
+import { TypeOrmCarrierRepository } from '../../infrastructure/persistence/typeorm/repositories/typeorm-carrier.repository';
 import { RateQuoteOrmEntity } from '../../infrastructure/persistence/typeorm/entities/rate-quote.orm-entity';
+import { PortOrmEntity } from '../../infrastructure/persistence/typeorm/entities/port.orm-entity';
+import { CarrierOrmEntity } from '../../infrastructure/persistence/typeorm/entities/carrier.orm-entity';
 
 @Module({
   imports: [
     CacheModule,
     CarrierModule,
-    TypeOrmModule.forFeature([RateQuoteOrmEntity]), // 👈 Add this
+    TypeOrmModule.forFeature([RateQuoteOrmEntity, PortOrmEntity, CarrierOrmEntity]),
   ],
   controllers: [RatesController],
   providers: [
@@ -21,9 +33,43 @@ import { RateQuoteOrmEntity } from '../../infrastructure/persistence/typeorm/ent
       provide: RATE_QUOTE_REPOSITORY,
       useClass: TypeOrmRateQuoteRepository,
     },
+    {
+      provide: PORT_REPOSITORY,
+      useClass: TypeOrmPortRepository,
+    },
+    {
+      provide: CARRIER_REPOSITORY,
+      useClass: TypeOrmCarrierRepository,
+    },
+    {
+      provide: RateSearchService,
+      useFactory: (
+        cache: any,
+        rateQuoteRepo: any,
+        portRepo: any,
+        carrierRepo: any,
+      ) => {
+        // For now, create service with empty connectors array
+        // TODO: Inject actual carrier connectors
+        return new RateSearchService(
+          [],
+          cache,
+          rateQuoteRepo,
+          portRepo,
+          carrierRepo,
+        );
+      },
+      inject: [
+        CACHE_PORT,
+        RATE_QUOTE_REPOSITORY,
+        PORT_REPOSITORY,
+        CARRIER_REPOSITORY,
+      ],
+    },
   ],
   exports: [
-    RATE_QUOTE_REPOSITORY, // optional, if used in other modules
+    RATE_QUOTE_REPOSITORY,
+    RateSearchService,
   ],
 })
 export class RatesModule {}

apps/backend/src/domain/entities/booking.entity.ts

@@ -1,299 +1,299 @@
-/**
+/**
- * Booking Entity
+ * Booking Entity
- *
+ *
- * Represents a freight booking
+ * Represents a freight booking
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Must have valid rate quote
+ * - Must have valid rate quote
- * - Shipper and consignee are required
+ * - Shipper and consignee are required
- * - Status transitions must follow allowed paths
+ * - Status transitions must follow allowed paths
- * - Containers can be added/updated until confirmed
+ * - Containers can be added/updated until confirmed
- * - Cannot modify confirmed bookings (except status)
+ * - Cannot modify confirmed bookings (except status)
- */
+ */
-
+
-import { BookingNumber } from '../value-objects/booking-number.vo';
+import { BookingNumber } from '../value-objects/booking-number.vo';
-import { BookingStatus } from '../value-objects/booking-status.vo';
+import { BookingStatus } from '../value-objects/booking-status.vo';
-
+
-export interface Address {
+export interface Address {
-  street: string;
+  street: string;
-  city: string;
+  city: string;
-  postalCode: string;
+  postalCode: string;
-  country: string;
+  country: string;
-}
+}
-
+
-export interface Party {
+export interface Party {
-  name: string;
+  name: string;
-  address: Address;
+  address: Address;
-  contactName: string;
+  contactName: string;
-  contactEmail: string;
+  contactEmail: string;
-  contactPhone: string;
+  contactPhone: string;
-}
+}
-
+
-export interface BookingContainer {
+export interface BookingContainer {
-  id: string;
+  id: string;
-  type: string;
+  type: string;
-  containerNumber?: string;
+  containerNumber?: string;
-  vgm?: number; // Verified Gross Mass in kg
+  vgm?: number; // Verified Gross Mass in kg
-  temperature?: number; // For reefer containers
+  temperature?: number; // For reefer containers
-  sealNumber?: string;
+  sealNumber?: string;
-}
+}
-
+
-export interface BookingProps {
+export interface BookingProps {
-  id: string;
+  id: string;
-  bookingNumber: BookingNumber;
+  bookingNumber: BookingNumber;
-  userId: string;
+  userId: string;
-  organizationId: string;
+  organizationId: string;
-  rateQuoteId: string;
+  rateQuoteId: string;
-  status: BookingStatus;
+  status: BookingStatus;
-  shipper: Party;
+  shipper: Party;
-  consignee: Party;
+  consignee: Party;
-  cargoDescription: string;
+  cargoDescription: string;
-  containers: BookingContainer[];
+  containers: BookingContainer[];
-  specialInstructions?: string;
+  specialInstructions?: string;
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class Booking {
+export class Booking {
-  private readonly props: BookingProps;
+  private readonly props: BookingProps;
-
+
-  private constructor(props: BookingProps) {
+  private constructor(props: BookingProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new Booking
+   * Factory method to create a new Booking
-   */
+   */
-  static create(
+  static create(
-    props: Omit<BookingProps, 'bookingNumber' | 'status' | 'createdAt' | 'updatedAt'> & {
+    props: Omit<BookingProps, 'bookingNumber' | 'status' | 'createdAt' | 'updatedAt'> & {
-      id: string;
+      id: string;
-      bookingNumber?: BookingNumber;
+      bookingNumber?: BookingNumber;
-      status?: BookingStatus;
+      status?: BookingStatus;
-    }
+    }
-  ): Booking {
+  ): Booking {
-    const now = new Date();
+    const now = new Date();
-
+
-    const bookingProps: BookingProps = {
+    const bookingProps: BookingProps = {
-      ...props,
+      ...props,
-      bookingNumber: props.bookingNumber || BookingNumber.generate(),
+      bookingNumber: props.bookingNumber || BookingNumber.generate(),
-      status: props.status || BookingStatus.create('draft'),
+      status: props.status || BookingStatus.create('draft'),
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    };
+    };
-
+
-    // Validate business rules
+    // Validate business rules
-    Booking.validate(bookingProps);
+    Booking.validate(bookingProps);
-
+
-    return new Booking(bookingProps);
+    return new Booking(bookingProps);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate business rules
+   * Validate business rules
-   */
+   */
-  private static validate(props: BookingProps): void {
+  private static validate(props: BookingProps): void {
-    if (!props.userId) {
+    if (!props.userId) {
-      throw new Error('User ID is required');
+      throw new Error('User ID is required');
-    }
+    }
-
+
-    if (!props.organizationId) {
+    if (!props.organizationId) {
-      throw new Error('Organization ID is required');
+      throw new Error('Organization ID is required');
-    }
+    }
-
+
-    if (!props.rateQuoteId) {
+    if (!props.rateQuoteId) {
-      throw new Error('Rate quote ID is required');
+      throw new Error('Rate quote ID is required');
-    }
+    }
-
+
-    if (!props.shipper || !props.shipper.name) {
+    if (!props.shipper || !props.shipper.name) {
-      throw new Error('Shipper information is required');
+      throw new Error('Shipper information is required');
-    }
+    }
-
+
-    if (!props.consignee || !props.consignee.name) {
+    if (!props.consignee || !props.consignee.name) {
-      throw new Error('Consignee information is required');
+      throw new Error('Consignee information is required');
-    }
+    }
-
+
-    if (!props.cargoDescription || props.cargoDescription.length < 10) {
+    if (!props.cargoDescription || props.cargoDescription.length < 10) {
-      throw new Error('Cargo description must be at least 10 characters');
+      throw new Error('Cargo description must be at least 10 characters');
-    }
+    }
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get bookingNumber(): BookingNumber {
+  get bookingNumber(): BookingNumber {
-    return this.props.bookingNumber;
+    return this.props.bookingNumber;
-  }
+  }
-
+
-  get userId(): string {
+  get userId(): string {
-    return this.props.userId;
+    return this.props.userId;
-  }
+  }
-
+
-  get organizationId(): string {
+  get organizationId(): string {
-    return this.props.organizationId;
+    return this.props.organizationId;
-  }
+  }
-
+
-  get rateQuoteId(): string {
+  get rateQuoteId(): string {
-    return this.props.rateQuoteId;
+    return this.props.rateQuoteId;
-  }
+  }
-
+
-  get status(): BookingStatus {
+  get status(): BookingStatus {
-    return this.props.status;
+    return this.props.status;
-  }
+  }
-
+
-  get shipper(): Party {
+  get shipper(): Party {
-    return { ...this.props.shipper };
+    return { ...this.props.shipper };
-  }
+  }
-
+
-  get consignee(): Party {
+  get consignee(): Party {
-    return { ...this.props.consignee };
+    return { ...this.props.consignee };
-  }
+  }
-
+
-  get cargoDescription(): string {
+  get cargoDescription(): string {
-    return this.props.cargoDescription;
+    return this.props.cargoDescription;
-  }
+  }
-
+
-  get containers(): BookingContainer[] {
+  get containers(): BookingContainer[] {
-    return [...this.props.containers];
+    return [...this.props.containers];
-  }
+  }
-
+
-  get specialInstructions(): string | undefined {
+  get specialInstructions(): string | undefined {
-    return this.props.specialInstructions;
+    return this.props.specialInstructions;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  /**
+  /**
-   * Update booking status
+   * Update booking status
-   */
+   */
-  updateStatus(newStatus: BookingStatus): Booking {
+  updateStatus(newStatus: BookingStatus): Booking {
-    if (!this.status.canTransitionTo(newStatus)) {
+    if (!this.status.canTransitionTo(newStatus)) {
-      throw new Error(
+      throw new Error(
-        `Cannot transition from ${this.status.value} to ${newStatus.value}`
+        `Cannot transition from ${this.status.value} to ${newStatus.value}`
-      );
+      );
-    }
+    }
-
+
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      status: newStatus,
+      status: newStatus,
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Add container to booking
+   * Add container to booking
-   */
+   */
-  addContainer(container: BookingContainer): Booking {
+  addContainer(container: BookingContainer): Booking {
-    if (!this.status.canBeModified()) {
+    if (!this.status.canBeModified()) {
-      throw new Error('Cannot modify containers after booking is confirmed');
+      throw new Error('Cannot modify containers after booking is confirmed');
-    }
+    }
-
+
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      containers: [...this.props.containers, container],
+      containers: [...this.props.containers, container],
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Update container information
+   * Update container information
-   */
+   */
-  updateContainer(containerId: string, updates: Partial<BookingContainer>): Booking {
+  updateContainer(containerId: string, updates: Partial<BookingContainer>): Booking {
-    if (!this.status.canBeModified()) {
+    if (!this.status.canBeModified()) {
-      throw new Error('Cannot modify containers after booking is confirmed');
+      throw new Error('Cannot modify containers after booking is confirmed');
-    }
+    }
-
+
-    const containerIndex = this.props.containers.findIndex((c) => c.id === containerId);
+    const containerIndex = this.props.containers.findIndex((c) => c.id === containerId);
-    if (containerIndex === -1) {
+    if (containerIndex === -1) {
-      throw new Error(`Container ${containerId} not found`);
+      throw new Error(`Container ${containerId} not found`);
-    }
+    }
-
+
-    const updatedContainers = [...this.props.containers];
+    const updatedContainers = [...this.props.containers];
-    updatedContainers[containerIndex] = {
+    updatedContainers[containerIndex] = {
-      ...updatedContainers[containerIndex],
+      ...updatedContainers[containerIndex],
-      ...updates,
+      ...updates,
-    };
+    };
-
+
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      containers: updatedContainers,
+      containers: updatedContainers,
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Remove container from booking
+   * Remove container from booking
-   */
+   */
-  removeContainer(containerId: string): Booking {
+  removeContainer(containerId: string): Booking {
-    if (!this.status.canBeModified()) {
+    if (!this.status.canBeModified()) {
-      throw new Error('Cannot modify containers after booking is confirmed');
+      throw new Error('Cannot modify containers after booking is confirmed');
-    }
+    }
-
+
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      containers: this.props.containers.filter((c) => c.id !== containerId),
+      containers: this.props.containers.filter((c) => c.id !== containerId),
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Update cargo description
+   * Update cargo description
-   */
+   */
-  updateCargoDescription(description: string): Booking {
+  updateCargoDescription(description: string): Booking {
-    if (!this.status.canBeModified()) {
+    if (!this.status.canBeModified()) {
-      throw new Error('Cannot modify cargo description after booking is confirmed');
+      throw new Error('Cannot modify cargo description after booking is confirmed');
-    }
+    }
-
+
-    if (description.length < 10) {
+    if (description.length < 10) {
-      throw new Error('Cargo description must be at least 10 characters');
+      throw new Error('Cargo description must be at least 10 characters');
-    }
+    }
-
+
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      cargoDescription: description,
+      cargoDescription: description,
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Update special instructions
+   * Update special instructions
-   */
+   */
-  updateSpecialInstructions(instructions: string): Booking {
+  updateSpecialInstructions(instructions: string): Booking {
-    return new Booking({
+    return new Booking({
-      ...this.props,
+      ...this.props,
-      specialInstructions: instructions,
+      specialInstructions: instructions,
-      updatedAt: new Date(),
+      updatedAt: new Date(),
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Check if booking can be cancelled
+   * Check if booking can be cancelled
-   */
+   */
-  canBeCancelled(): boolean {
+  canBeCancelled(): boolean {
-    return !this.status.isFinal();
+    return !this.status.isFinal();
-  }
+  }
-
+
-  /**
+  /**
-   * Cancel booking
+   * Cancel booking
-   */
+   */
-  cancel(): Booking {
+  cancel(): Booking {
-    if (!this.canBeCancelled()) {
+    if (!this.canBeCancelled()) {
-      throw new Error('Cannot cancel booking in final state');
+      throw new Error('Cannot cancel booking in final state');
-    }
+    }
-
+
-    return this.updateStatus(BookingStatus.create('cancelled'));
+    return this.updateStatus(BookingStatus.create('cancelled'));
-  }
+  }
-
+
-  /**
+  /**
-   * Equality check
+   * Equality check
-   */
+   */
-  equals(other: Booking): boolean {
+  equals(other: Booking): boolean {
-    return this.id === other.id;
+    return this.id === other.id;
-  }
+  }
-}
+}

apps/backend/src/domain/entities/carrier.entity.ts

@@ -1,182 +1,182 @@
-/**
+/**
- * Carrier Entity
+ * Carrier Entity
- *
+ *
- * Represents a shipping carrier (e.g., Maersk, MSC, CMA CGM)
+ * Represents a shipping carrier (e.g., Maersk, MSC, CMA CGM)
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Carrier code must be unique
+ * - Carrier code must be unique
- * - SCAC code must be valid (4 uppercase letters)
+ * - SCAC code must be valid (4 uppercase letters)
- * - API configuration is optional (for carriers with API integration)
+ * - API configuration is optional (for carriers with API integration)
- */
+ */
-
+
-export interface CarrierApiConfig {
+export interface CarrierApiConfig {
-  baseUrl: string;
+  baseUrl: string;
-  apiKey?: string;
+  apiKey?: string;
-  clientId?: string;
+  clientId?: string;
-  clientSecret?: string;
+  clientSecret?: string;
-  timeout: number; // in milliseconds
+  timeout: number; // in milliseconds
-  retryAttempts: number;
+  retryAttempts: number;
-  circuitBreakerThreshold: number;
+  circuitBreakerThreshold: number;
-}
+}
-
+
-export interface CarrierProps {
+export interface CarrierProps {
-  id: string;
+  id: string;
-  name: string;
+  name: string;
-  code: string; // Unique carrier code (e.g., 'MAERSK', 'MSC')
+  code: string; // Unique carrier code (e.g., 'MAERSK', 'MSC')
-  scac: string; // Standard Carrier Alpha Code
+  scac: string; // Standard Carrier Alpha Code
-  logoUrl?: string;
+  logoUrl?: string;
-  website?: string;
+  website?: string;
-  apiConfig?: CarrierApiConfig;
+  apiConfig?: CarrierApiConfig;
-  isActive: boolean;
+  isActive: boolean;
-  supportsApi: boolean; // True if carrier has API integration
+  supportsApi: boolean; // True if carrier has API integration
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class Carrier {
+export class Carrier {
-  private readonly props: CarrierProps;
+  private readonly props: CarrierProps;
-
+
-  private constructor(props: CarrierProps) {
+  private constructor(props: CarrierProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new Carrier
+   * Factory method to create a new Carrier
-   */
+   */
-  static create(props: Omit<CarrierProps, 'createdAt' | 'updatedAt'>): Carrier {
+  static create(props: Omit<CarrierProps, 'createdAt' | 'updatedAt'>): Carrier {
-    const now = new Date();
+    const now = new Date();
-
+
-    // Validate SCAC code
+    // Validate SCAC code
-    if (!Carrier.isValidSCAC(props.scac)) {
+    if (!Carrier.isValidSCAC(props.scac)) {
-      throw new Error('Invalid SCAC code format. Must be 4 uppercase letters.');
+      throw new Error('Invalid SCAC code format. Must be 4 uppercase letters.');
-    }
+    }
-
+
-    // Validate carrier code
+    // Validate carrier code
-    if (!Carrier.isValidCarrierCode(props.code)) {
+    if (!Carrier.isValidCarrierCode(props.code)) {
-      throw new Error('Invalid carrier code format. Must be uppercase letters and underscores only.');
+      throw new Error('Invalid carrier code format. Must be uppercase letters and underscores only.');
-    }
+    }
-
+
-    // Validate API config if carrier supports API
+    // Validate API config if carrier supports API
-    if (props.supportsApi && !props.apiConfig) {
+    if (props.supportsApi && !props.apiConfig) {
-      throw new Error('Carriers with API support must have API configuration.');
+      throw new Error('Carriers with API support must have API configuration.');
-    }
+    }
-
+
-    return new Carrier({
+    return new Carrier({
-      ...props,
+      ...props,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: CarrierProps): Carrier {
+  static fromPersistence(props: CarrierProps): Carrier {
-    return new Carrier(props);
+    return new Carrier(props);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate SCAC code format
+   * Validate SCAC code format
-   */
+   */
-  private static isValidSCAC(scac: string): boolean {
+  private static isValidSCAC(scac: string): boolean {
-    const scacPattern = /^[A-Z]{4}$/;
+    const scacPattern = /^[A-Z]{4}$/;
-    return scacPattern.test(scac);
+    return scacPattern.test(scac);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate carrier code format
+   * Validate carrier code format
-   */
+   */
-  private static isValidCarrierCode(code: string): boolean {
+  private static isValidCarrierCode(code: string): boolean {
-    const codePattern = /^[A-Z_]+$/;
+    const codePattern = /^[A-Z_]+$/;
-    return codePattern.test(code);
+    return codePattern.test(code);
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get name(): string {
+  get name(): string {
-    return this.props.name;
+    return this.props.name;
-  }
+  }
-
+
-  get code(): string {
+  get code(): string {
-    return this.props.code;
+    return this.props.code;
-  }
+  }
-
+
-  get scac(): string {
+  get scac(): string {
-    return this.props.scac;
+    return this.props.scac;
-  }
+  }
-
+
-  get logoUrl(): string | undefined {
+  get logoUrl(): string | undefined {
-    return this.props.logoUrl;
+    return this.props.logoUrl;
-  }
+  }
-
+
-  get website(): string | undefined {
+  get website(): string | undefined {
-    return this.props.website;
+    return this.props.website;
-  }
+  }
-
+
-  get apiConfig(): CarrierApiConfig | undefined {
+  get apiConfig(): CarrierApiConfig | undefined {
-    return this.props.apiConfig ? { ...this.props.apiConfig } : undefined;
+    return this.props.apiConfig ? { ...this.props.apiConfig } : undefined;
-  }
+  }
-
+
-  get isActive(): boolean {
+  get isActive(): boolean {
-    return this.props.isActive;
+    return this.props.isActive;
-  }
+  }
-
+
-  get supportsApi(): boolean {
+  get supportsApi(): boolean {
-    return this.props.supportsApi;
+    return this.props.supportsApi;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  hasApiIntegration(): boolean {
+  hasApiIntegration(): boolean {
-    return this.props.supportsApi && !!this.props.apiConfig;
+    return this.props.supportsApi && !!this.props.apiConfig;
-  }
+  }
-
+
-  updateApiConfig(apiConfig: CarrierApiConfig): void {
+  updateApiConfig(apiConfig: CarrierApiConfig): void {
-    if (!this.props.supportsApi) {
+    if (!this.props.supportsApi) {
-      throw new Error('Cannot update API config for carrier without API support.');
+      throw new Error('Cannot update API config for carrier without API support.');
-    }
+    }
-
+
-    this.props.apiConfig = { ...apiConfig };
+    this.props.apiConfig = { ...apiConfig };
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateLogoUrl(logoUrl: string): void {
+  updateLogoUrl(logoUrl: string): void {
-    this.props.logoUrl = logoUrl;
+    this.props.logoUrl = logoUrl;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateWebsite(website: string): void {
+  updateWebsite(website: string): void {
-    this.props.website = website;
+    this.props.website = website;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  deactivate(): void {
+  deactivate(): void {
-    this.props.isActive = false;
+    this.props.isActive = false;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  activate(): void {
+  activate(): void {
-    this.props.isActive = true;
+    this.props.isActive = true;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): CarrierProps {
+  toObject(): CarrierProps {
-    return {
+    return {
-      ...this.props,
+      ...this.props,
-      apiConfig: this.props.apiConfig ? { ...this.props.apiConfig } : undefined,
+      apiConfig: this.props.apiConfig ? { ...this.props.apiConfig } : undefined,
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/entities/container.entity.ts

@@ -1,297 +1,297 @@
-/**
+/**
- * Container Entity
+ * Container Entity
- *
+ *
- * Represents a shipping container in a booking
+ * Represents a shipping container in a booking
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Container number must follow ISO 6346 format (when provided)
+ * - Container number must follow ISO 6346 format (when provided)
- * - VGM (Verified Gross Mass) is required for export shipments
+ * - VGM (Verified Gross Mass) is required for export shipments
- * - Temperature must be within valid range for reefer containers
+ * - Temperature must be within valid range for reefer containers
- */
+ */
-
+
-export enum ContainerCategory {
+export enum ContainerCategory {
-  DRY = 'DRY',
+  DRY = 'DRY',
-  REEFER = 'REEFER',
+  REEFER = 'REEFER',
-  OPEN_TOP = 'OPEN_TOP',
+  OPEN_TOP = 'OPEN_TOP',
-  FLAT_RACK = 'FLAT_RACK',
+  FLAT_RACK = 'FLAT_RACK',
-  TANK = 'TANK',
+  TANK = 'TANK',
-}
+}
-
+
-export enum ContainerSize {
+export enum ContainerSize {
-  TWENTY = '20',
+  TWENTY = '20',
-  FORTY = '40',
+  FORTY = '40',
-  FORTY_FIVE = '45',
+  FORTY_FIVE = '45',
-}
+}
-
+
-export enum ContainerHeight {
+export enum ContainerHeight {
-  STANDARD = 'STANDARD',
+  STANDARD = 'STANDARD',
-  HIGH_CUBE = 'HIGH_CUBE',
+  HIGH_CUBE = 'HIGH_CUBE',
-}
+}
-
+
-export interface ContainerProps {
+export interface ContainerProps {
-  id: string;
+  id: string;
-  bookingId?: string; // Optional until container is assigned to a booking
+  bookingId?: string; // Optional until container is assigned to a booking
-  type: string; // e.g., '20DRY', '40HC', '40REEFER'
+  type: string; // e.g., '20DRY', '40HC', '40REEFER'
-  category: ContainerCategory;
+  category: ContainerCategory;
-  size: ContainerSize;
+  size: ContainerSize;
-  height: ContainerHeight;
+  height: ContainerHeight;
-  containerNumber?: string; // ISO 6346 format (assigned by carrier)
+  containerNumber?: string; // ISO 6346 format (assigned by carrier)
-  sealNumber?: string;
+  sealNumber?: string;
-  vgm?: number; // Verified Gross Mass in kg
+  vgm?: number; // Verified Gross Mass in kg
-  tareWeight?: number; // Empty container weight in kg
+  tareWeight?: number; // Empty container weight in kg
-  maxGrossWeight?: number; // Maximum gross weight in kg
+  maxGrossWeight?: number; // Maximum gross weight in kg
-  temperature?: number; // For reefer containers (°C)
+  temperature?: number; // For reefer containers (°C)
-  humidity?: number; // For reefer containers (%)
+  humidity?: number; // For reefer containers (%)
-  ventilation?: string; // For reefer containers
+  ventilation?: string; // For reefer containers
-  isHazmat: boolean;
+  isHazmat: boolean;
-  imoClass?: string; // IMO hazmat class (if hazmat)
+  imoClass?: string; // IMO hazmat class (if hazmat)
-  cargoDescription?: string;
+  cargoDescription?: string;
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class Container {
+export class Container {
-  private readonly props: ContainerProps;
+  private readonly props: ContainerProps;
-
+
-  private constructor(props: ContainerProps) {
+  private constructor(props: ContainerProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new Container
+   * Factory method to create a new Container
-   */
+   */
-  static create(props: Omit<ContainerProps, 'createdAt' | 'updatedAt'>): Container {
+  static create(props: Omit<ContainerProps, 'createdAt' | 'updatedAt'>): Container {
-    const now = new Date();
+    const now = new Date();
-
+
-    // Validate container number format if provided
+    // Validate container number format if provided
-    if (props.containerNumber && !Container.isValidContainerNumber(props.containerNumber)) {
+    if (props.containerNumber && !Container.isValidContainerNumber(props.containerNumber)) {
-      throw new Error('Invalid container number format. Must follow ISO 6346 standard.');
+      throw new Error('Invalid container number format. Must follow ISO 6346 standard.');
-    }
+    }
-
+
-    // Validate VGM if provided
+    // Validate VGM if provided
-    if (props.vgm !== undefined && props.vgm <= 0) {
+    if (props.vgm !== undefined && props.vgm <= 0) {
-      throw new Error('VGM must be positive.');
+      throw new Error('VGM must be positive.');
-    }
+    }
-
+
-    // Validate temperature for reefer containers
+    // Validate temperature for reefer containers
-    if (props.category === ContainerCategory.REEFER) {
+    if (props.category === ContainerCategory.REEFER) {
-      if (props.temperature === undefined) {
+      if (props.temperature === undefined) {
-        throw new Error('Temperature is required for reefer containers.');
+        throw new Error('Temperature is required for reefer containers.');
-      }
+      }
-      if (props.temperature < -40 || props.temperature > 40) {
+      if (props.temperature < -40 || props.temperature > 40) {
-        throw new Error('Temperature must be between -40°C and +40°C.');
+        throw new Error('Temperature must be between -40°C and +40°C.');
-      }
+      }
-    }
+    }
-
+
-    // Validate hazmat
+    // Validate hazmat
-    if (props.isHazmat && !props.imoClass) {
+    if (props.isHazmat && !props.imoClass) {
-      throw new Error('IMO class is required for hazmat containers.');
+      throw new Error('IMO class is required for hazmat containers.');
-    }
+    }
-
+
-    return new Container({
+    return new Container({
-      ...props,
+      ...props,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: ContainerProps): Container {
+  static fromPersistence(props: ContainerProps): Container {
-    return new Container(props);
+    return new Container(props);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate ISO 6346 container number format
+   * Validate ISO 6346 container number format
-   * Format: 4 letters (owner code) + 6 digits + 1 check digit
+   * Format: 4 letters (owner code) + 6 digits + 1 check digit
-   * Example: MSCU1234567
+   * Example: MSCU1234567
-   */
+   */
-  private static isValidContainerNumber(containerNumber: string): boolean {
+  private static isValidContainerNumber(containerNumber: string): boolean {
-    const pattern = /^[A-Z]{4}\d{7}$/;
+    const pattern = /^[A-Z]{4}\d{7}$/;
-    if (!pattern.test(containerNumber)) {
+    if (!pattern.test(containerNumber)) {
-      return false;
+      return false;
-    }
+    }
-
+
-    // Validate check digit (ISO 6346 algorithm)
+    // Validate check digit (ISO 6346 algorithm)
-    const ownerCode = containerNumber.substring(0, 4);
+    const ownerCode = containerNumber.substring(0, 4);
-    const serialNumber = containerNumber.substring(4, 10);
+    const serialNumber = containerNumber.substring(4, 10);
-    const checkDigit = parseInt(containerNumber.substring(10, 11), 10);
+    const checkDigit = parseInt(containerNumber.substring(10, 11), 10);
-
+
-    // Convert letters to numbers (A=10, B=12, C=13, ..., Z=38)
+    // Convert letters to numbers (A=10, B=12, C=13, ..., Z=38)
-    const letterValues: { [key: string]: number } = {};
+    const letterValues: { [key: string]: number } = {};
-    'ABCDEFGHIJKLMNOPQRSTUVWXYZ'.split('').forEach((letter, index) => {
+    'ABCDEFGHIJKLMNOPQRSTUVWXYZ'.split('').forEach((letter, index) => {
-      letterValues[letter] = 10 + index + Math.floor(index / 2);
+      letterValues[letter] = 10 + index + Math.floor(index / 2);
-    });
+    });
-
+
-    // Calculate sum
+    // Calculate sum
-    let sum = 0;
+    let sum = 0;
-    for (let i = 0; i < ownerCode.length; i++) {
+    for (let i = 0; i < ownerCode.length; i++) {
-      sum += letterValues[ownerCode[i]] * Math.pow(2, i);
+      sum += letterValues[ownerCode[i]] * Math.pow(2, i);
-    }
+    }
-    for (let i = 0; i < serialNumber.length; i++) {
+    for (let i = 0; i < serialNumber.length; i++) {
-      sum += parseInt(serialNumber[i], 10) * Math.pow(2, i + 4);
+      sum += parseInt(serialNumber[i], 10) * Math.pow(2, i + 4);
-    }
+    }
-
+
-    // Check digit = sum % 11 (if 10, use 0)
+    // Check digit = sum % 11 (if 10, use 0)
-    const calculatedCheckDigit = sum % 11 === 10 ? 0 : sum % 11;
+    const calculatedCheckDigit = sum % 11 === 10 ? 0 : sum % 11;
-
+
-    return calculatedCheckDigit === checkDigit;
+    return calculatedCheckDigit === checkDigit;
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get bookingId(): string | undefined {
+  get bookingId(): string | undefined {
-    return this.props.bookingId;
+    return this.props.bookingId;
-  }
+  }
-
+
-  get type(): string {
+  get type(): string {
-    return this.props.type;
+    return this.props.type;
-  }
+  }
-
+
-  get category(): ContainerCategory {
+  get category(): ContainerCategory {
-    return this.props.category;
+    return this.props.category;
-  }
+  }
-
+
-  get size(): ContainerSize {
+  get size(): ContainerSize {
-    return this.props.size;
+    return this.props.size;
-  }
+  }
-
+
-  get height(): ContainerHeight {
+  get height(): ContainerHeight {
-    return this.props.height;
+    return this.props.height;
-  }
+  }
-
+
-  get containerNumber(): string | undefined {
+  get containerNumber(): string | undefined {
-    return this.props.containerNumber;
+    return this.props.containerNumber;
-  }
+  }
-
+
-  get sealNumber(): string | undefined {
+  get sealNumber(): string | undefined {
-    return this.props.sealNumber;
+    return this.props.sealNumber;
-  }
+  }
-
+
-  get vgm(): number | undefined {
+  get vgm(): number | undefined {
-    return this.props.vgm;
+    return this.props.vgm;
-  }
+  }
-
+
-  get tareWeight(): number | undefined {
+  get tareWeight(): number | undefined {
-    return this.props.tareWeight;
+    return this.props.tareWeight;
-  }
+  }
-
+
-  get maxGrossWeight(): number | undefined {
+  get maxGrossWeight(): number | undefined {
-    return this.props.maxGrossWeight;
+    return this.props.maxGrossWeight;
-  }
+  }
-
+
-  get temperature(): number | undefined {
+  get temperature(): number | undefined {
-    return this.props.temperature;
+    return this.props.temperature;
-  }
+  }
-
+
-  get humidity(): number | undefined {
+  get humidity(): number | undefined {
-    return this.props.humidity;
+    return this.props.humidity;
-  }
+  }
-
+
-  get ventilation(): string | undefined {
+  get ventilation(): string | undefined {
-    return this.props.ventilation;
+    return this.props.ventilation;
-  }
+  }
-
+
-  get isHazmat(): boolean {
+  get isHazmat(): boolean {
-    return this.props.isHazmat;
+    return this.props.isHazmat;
-  }
+  }
-
+
-  get imoClass(): string | undefined {
+  get imoClass(): string | undefined {
-    return this.props.imoClass;
+    return this.props.imoClass;
-  }
+  }
-
+
-  get cargoDescription(): string | undefined {
+  get cargoDescription(): string | undefined {
-    return this.props.cargoDescription;
+    return this.props.cargoDescription;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  isReefer(): boolean {
+  isReefer(): boolean {
-    return this.props.category === ContainerCategory.REEFER;
+    return this.props.category === ContainerCategory.REEFER;
-  }
+  }
-
+
-  isDry(): boolean {
+  isDry(): boolean {
-    return this.props.category === ContainerCategory.DRY;
+    return this.props.category === ContainerCategory.DRY;
-  }
+  }
-
+
-  isHighCube(): boolean {
+  isHighCube(): boolean {
-    return this.props.height === ContainerHeight.HIGH_CUBE;
+    return this.props.height === ContainerHeight.HIGH_CUBE;
-  }
+  }
-
+
-  getTEU(): number {
+  getTEU(): number {
-    // Twenty-foot Equivalent Unit
+    // Twenty-foot Equivalent Unit
-    if (this.props.size === ContainerSize.TWENTY) {
+    if (this.props.size === ContainerSize.TWENTY) {
-      return 1;
+      return 1;
-    } else if (this.props.size === ContainerSize.FORTY || this.props.size === ContainerSize.FORTY_FIVE) {
+    } else if (this.props.size === ContainerSize.FORTY || this.props.size === ContainerSize.FORTY_FIVE) {
-      return 2;
+      return 2;
-    }
+    }
-    return 0;
+    return 0;
-  }
+  }
-
+
-  getPayload(): number | undefined {
+  getPayload(): number | undefined {
-    if (this.props.vgm !== undefined && this.props.tareWeight !== undefined) {
+    if (this.props.vgm !== undefined && this.props.tareWeight !== undefined) {
-      return this.props.vgm - this.props.tareWeight;
+      return this.props.vgm - this.props.tareWeight;
-    }
+    }
-    return undefined;
+    return undefined;
-  }
+  }
-
+
-  assignContainerNumber(containerNumber: string): void {
+  assignContainerNumber(containerNumber: string): void {
-    if (!Container.isValidContainerNumber(containerNumber)) {
+    if (!Container.isValidContainerNumber(containerNumber)) {
-      throw new Error('Invalid container number format.');
+      throw new Error('Invalid container number format.');
-    }
+    }
-    this.props.containerNumber = containerNumber;
+    this.props.containerNumber = containerNumber;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  assignSealNumber(sealNumber: string): void {
+  assignSealNumber(sealNumber: string): void {
-    this.props.sealNumber = sealNumber;
+    this.props.sealNumber = sealNumber;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  setVGM(vgm: number): void {
+  setVGM(vgm: number): void {
-    if (vgm <= 0) {
+    if (vgm <= 0) {
-      throw new Error('VGM must be positive.');
+      throw new Error('VGM must be positive.');
-    }
+    }
-    this.props.vgm = vgm;
+    this.props.vgm = vgm;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  setTemperature(temperature: number): void {
+  setTemperature(temperature: number): void {
-    if (!this.isReefer()) {
+    if (!this.isReefer()) {
-      throw new Error('Cannot set temperature for non-reefer container.');
+      throw new Error('Cannot set temperature for non-reefer container.');
-    }
+    }
-    if (temperature < -40 || temperature > 40) {
+    if (temperature < -40 || temperature > 40) {
-      throw new Error('Temperature must be between -40°C and +40°C.');
+      throw new Error('Temperature must be between -40°C and +40°C.');
-    }
+    }
-    this.props.temperature = temperature;
+    this.props.temperature = temperature;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  setCargoDescription(description: string): void {
+  setCargoDescription(description: string): void {
-    this.props.cargoDescription = description;
+    this.props.cargoDescription = description;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  assignToBooking(bookingId: string): void {
+  assignToBooking(bookingId: string): void {
-    this.props.bookingId = bookingId;
+    this.props.bookingId = bookingId;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): ContainerProps {
+  toObject(): ContainerProps {
-    return { ...this.props };
+    return { ...this.props };
-  }
+  }
-}
+}

apps/backend/src/domain/entities/index.ts

@@ -1,13 +1,13 @@
-/**
+/**
- * Domain Entities Barrel Export
+ * Domain Entities Barrel Export
- *
+ *
- * All core domain entities for the Xpeditis platform
+ * All core domain entities for the Xpeditis platform
- */
+ */
-
+
-export * from './organization.entity';
+export * from './organization.entity';
-export * from './user.entity';
+export * from './user.entity';
-export * from './carrier.entity';
+export * from './carrier.entity';
-export * from './port.entity';
+export * from './port.entity';
-export * from './rate-quote.entity';
+export * from './rate-quote.entity';
-export * from './container.entity';
+export * from './container.entity';
-export * from './booking.entity';
+export * from './booking.entity';

apps/backend/src/domain/entities/organization.entity.ts

@@ -1,201 +1,201 @@
-/**
+/**
- * Organization Entity
+ * Organization Entity
- *
+ *
- * Represents a business organization (freight forwarder, carrier, or shipper)
+ * Represents a business organization (freight forwarder, carrier, or shipper)
- * in the Xpeditis platform.
+ * in the Xpeditis platform.
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - SCAC code must be unique across all carrier organizations
+ * - SCAC code must be unique across all carrier organizations
- * - Name must be unique
+ * - Name must be unique
- * - Type must be valid (FREIGHT_FORWARDER, CARRIER, SHIPPER)
+ * - Type must be valid (FREIGHT_FORWARDER, CARRIER, SHIPPER)
- */
+ */
-
+
-export enum OrganizationType {
+export enum OrganizationType {
-  FREIGHT_FORWARDER = 'FREIGHT_FORWARDER',
+  FREIGHT_FORWARDER = 'FREIGHT_FORWARDER',
-  CARRIER = 'CARRIER',
+  CARRIER = 'CARRIER',
-  SHIPPER = 'SHIPPER',
+  SHIPPER = 'SHIPPER',
-}
+}
-
+
-export interface OrganizationAddress {
+export interface OrganizationAddress {
-  street: string;
+  street: string;
-  city: string;
+  city: string;
-  state?: string;
+  state?: string;
-  postalCode: string;
+  postalCode: string;
-  country: string;
+  country: string;
-}
+}
-
+
-export interface OrganizationDocument {
+export interface OrganizationDocument {
-  id: string;
+  id: string;
-  type: string;
+  type: string;
-  name: string;
+  name: string;
-  url: string;
+  url: string;
-  uploadedAt: Date;
+  uploadedAt: Date;
-}
+}
-
+
-export interface OrganizationProps {
+export interface OrganizationProps {
-  id: string;
+  id: string;
-  name: string;
+  name: string;
-  type: OrganizationType;
+  type: OrganizationType;
-  scac?: string; // Standard Carrier Alpha Code (for carriers only)
+  scac?: string; // Standard Carrier Alpha Code (for carriers only)
-  address: OrganizationAddress;
+  address: OrganizationAddress;
-  logoUrl?: string;
+  logoUrl?: string;
-  documents: OrganizationDocument[];
+  documents: OrganizationDocument[];
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-  isActive: boolean;
+  isActive: boolean;
-}
+}
-
+
-export class Organization {
+export class Organization {
-  private readonly props: OrganizationProps;
+  private readonly props: OrganizationProps;
-
+
-  private constructor(props: OrganizationProps) {
+  private constructor(props: OrganizationProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new Organization
+   * Factory method to create a new Organization
-   */
+   */
-  static create(props: Omit<OrganizationProps, 'createdAt' | 'updatedAt'>): Organization {
+  static create(props: Omit<OrganizationProps, 'createdAt' | 'updatedAt'>): Organization {
-    const now = new Date();
+    const now = new Date();
-
+
-    // Validate SCAC code if provided
+    // Validate SCAC code if provided
-    if (props.scac && !Organization.isValidSCAC(props.scac)) {
+    if (props.scac && !Organization.isValidSCAC(props.scac)) {
-      throw new Error('Invalid SCAC code format. Must be 4 uppercase letters.');
+      throw new Error('Invalid SCAC code format. Must be 4 uppercase letters.');
-    }
+    }
-
+
-    // Validate that carriers have SCAC codes
+    // Validate that carriers have SCAC codes
-    if (props.type === OrganizationType.CARRIER && !props.scac) {
+    if (props.type === OrganizationType.CARRIER && !props.scac) {
-      throw new Error('Carrier organizations must have a SCAC code.');
+      throw new Error('Carrier organizations must have a SCAC code.');
-    }
+    }
-
+
-    // Validate that non-carriers don't have SCAC codes
+    // Validate that non-carriers don't have SCAC codes
-    if (props.type !== OrganizationType.CARRIER && props.scac) {
+    if (props.type !== OrganizationType.CARRIER && props.scac) {
-      throw new Error('Only carrier organizations can have SCAC codes.');
+      throw new Error('Only carrier organizations can have SCAC codes.');
-    }
+    }
-
+
-    return new Organization({
+    return new Organization({
-      ...props,
+      ...props,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: OrganizationProps): Organization {
+  static fromPersistence(props: OrganizationProps): Organization {
-    return new Organization(props);
+    return new Organization(props);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate SCAC code format
+   * Validate SCAC code format
-   * SCAC = Standard Carrier Alpha Code (4 uppercase letters)
+   * SCAC = Standard Carrier Alpha Code (4 uppercase letters)
-   */
+   */
-  private static isValidSCAC(scac: string): boolean {
+  private static isValidSCAC(scac: string): boolean {
-    const scacPattern = /^[A-Z]{4}$/;
+    const scacPattern = /^[A-Z]{4}$/;
-    return scacPattern.test(scac);
+    return scacPattern.test(scac);
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get name(): string {
+  get name(): string {
-    return this.props.name;
+    return this.props.name;
-  }
+  }
-
+
-  get type(): OrganizationType {
+  get type(): OrganizationType {
-    return this.props.type;
+    return this.props.type;
-  }
+  }
-
+
-  get scac(): string | undefined {
+  get scac(): string | undefined {
-    return this.props.scac;
+    return this.props.scac;
-  }
+  }
-
+
-  get address(): OrganizationAddress {
+  get address(): OrganizationAddress {
-    return { ...this.props.address };
+    return { ...this.props.address };
-  }
+  }
-
+
-  get logoUrl(): string | undefined {
+  get logoUrl(): string | undefined {
-    return this.props.logoUrl;
+    return this.props.logoUrl;
-  }
+  }
-
+
-  get documents(): OrganizationDocument[] {
+  get documents(): OrganizationDocument[] {
-    return [...this.props.documents];
+    return [...this.props.documents];
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  get isActive(): boolean {
+  get isActive(): boolean {
-    return this.props.isActive;
+    return this.props.isActive;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  isCarrier(): boolean {
+  isCarrier(): boolean {
-    return this.props.type === OrganizationType.CARRIER;
+    return this.props.type === OrganizationType.CARRIER;
-  }
+  }
-
+
-  isFreightForwarder(): boolean {
+  isFreightForwarder(): boolean {
-    return this.props.type === OrganizationType.FREIGHT_FORWARDER;
+    return this.props.type === OrganizationType.FREIGHT_FORWARDER;
-  }
+  }
-
+
-  isShipper(): boolean {
+  isShipper(): boolean {
-    return this.props.type === OrganizationType.SHIPPER;
+    return this.props.type === OrganizationType.SHIPPER;
-  }
+  }
-
+
-  updateName(name: string): void {
+  updateName(name: string): void {
-    if (!name || name.trim().length === 0) {
+    if (!name || name.trim().length === 0) {
-      throw new Error('Organization name cannot be empty.');
+      throw new Error('Organization name cannot be empty.');
-    }
+    }
-    this.props.name = name.trim();
+    this.props.name = name.trim();
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateAddress(address: OrganizationAddress): void {
+  updateAddress(address: OrganizationAddress): void {
-    this.props.address = { ...address };
+    this.props.address = { ...address };
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateLogoUrl(logoUrl: string): void {
+  updateLogoUrl(logoUrl: string): void {
-    this.props.logoUrl = logoUrl;
+    this.props.logoUrl = logoUrl;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  addDocument(document: OrganizationDocument): void {
+  addDocument(document: OrganizationDocument): void {
-    this.props.documents.push(document);
+    this.props.documents.push(document);
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  removeDocument(documentId: string): void {
+  removeDocument(documentId: string): void {
-    this.props.documents = this.props.documents.filter(doc => doc.id !== documentId);
+    this.props.documents = this.props.documents.filter(doc => doc.id !== documentId);
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  deactivate(): void {
+  deactivate(): void {
-    this.props.isActive = false;
+    this.props.isActive = false;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  activate(): void {
+  activate(): void {
-    this.props.isActive = true;
+    this.props.isActive = true;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): OrganizationProps {
+  toObject(): OrganizationProps {
-    return {
+    return {
-      ...this.props,
+      ...this.props,
-      address: { ...this.props.address },
+      address: { ...this.props.address },
-      documents: [...this.props.documents],
+      documents: [...this.props.documents],
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/entities/port.entity.ts

@@ -1,205 +1,205 @@
-/**
+/**
- * Port Entity
+ * Port Entity
- *
+ *
- * Represents a maritime port (based on UN/LOCODE standard)
+ * Represents a maritime port (based on UN/LOCODE standard)
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Port code must follow UN/LOCODE format (2-letter country + 3-letter location)
+ * - Port code must follow UN/LOCODE format (2-letter country + 3-letter location)
- * - Coordinates must be valid latitude/longitude
+ * - Coordinates must be valid latitude/longitude
- */
+ */
-
+
-export interface PortCoordinates {
+export interface PortCoordinates {
-  latitude: number;
+  latitude: number;
-  longitude: number;
+  longitude: number;
-}
+}
-
+
-export interface PortProps {
+export interface PortProps {
-  id: string;
+  id: string;
-  code: string; // UN/LOCODE (e.g., 'NLRTM' for Rotterdam)
+  code: string; // UN/LOCODE (e.g., 'NLRTM' for Rotterdam)
-  name: string; // Port name
+  name: string; // Port name
-  city: string;
+  city: string;
-  country: string; // ISO 3166-1 alpha-2 country code
+  country: string; // ISO 3166-1 alpha-2 country code
-  countryName: string; // Full country name
+  countryName: string; // Full country name
-  coordinates: PortCoordinates;
+  coordinates: PortCoordinates;
-  timezone?: string; // IANA timezone (e.g., 'Europe/Amsterdam')
+  timezone?: string; // IANA timezone (e.g., 'Europe/Amsterdam')
-  isActive: boolean;
+  isActive: boolean;
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class Port {
+export class Port {
-  private readonly props: PortProps;
+  private readonly props: PortProps;
-
+
-  private constructor(props: PortProps) {
+  private constructor(props: PortProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new Port
+   * Factory method to create a new Port
-   */
+   */
-  static create(props: Omit<PortProps, 'createdAt' | 'updatedAt'>): Port {
+  static create(props: Omit<PortProps, 'createdAt' | 'updatedAt'>): Port {
-    const now = new Date();
+    const now = new Date();
-
+
-    // Validate UN/LOCODE format
+    // Validate UN/LOCODE format
-    if (!Port.isValidUNLOCODE(props.code)) {
+    if (!Port.isValidUNLOCODE(props.code)) {
-      throw new Error('Invalid port code format. Must follow UN/LOCODE format (e.g., NLRTM).');
+      throw new Error('Invalid port code format. Must follow UN/LOCODE format (e.g., NLRTM).');
-    }
+    }
-
+
-    // Validate country code
+    // Validate country code
-    if (!Port.isValidCountryCode(props.country)) {
+    if (!Port.isValidCountryCode(props.country)) {
-      throw new Error('Invalid country code. Must be ISO 3166-1 alpha-2 format (e.g., NL).');
+      throw new Error('Invalid country code. Must be ISO 3166-1 alpha-2 format (e.g., NL).');
-    }
+    }
-
+
-    // Validate coordinates
+    // Validate coordinates
-    if (!Port.isValidCoordinates(props.coordinates)) {
+    if (!Port.isValidCoordinates(props.coordinates)) {
-      throw new Error('Invalid coordinates.');
+      throw new Error('Invalid coordinates.');
-    }
+    }
-
+
-    return new Port({
+    return new Port({
-      ...props,
+      ...props,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: PortProps): Port {
+  static fromPersistence(props: PortProps): Port {
-    return new Port(props);
+    return new Port(props);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate UN/LOCODE format (5 characters: 2-letter country code + 3-letter location code)
+   * Validate UN/LOCODE format (5 characters: 2-letter country code + 3-letter location code)
-   */
+   */
-  private static isValidUNLOCODE(code: string): boolean {
+  private static isValidUNLOCODE(code: string): boolean {
-    const unlocodePattern = /^[A-Z]{2}[A-Z0-9]{3}$/;
+    const unlocodePattern = /^[A-Z]{2}[A-Z0-9]{3}$/;
-    return unlocodePattern.test(code);
+    return unlocodePattern.test(code);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate ISO 3166-1 alpha-2 country code
+   * Validate ISO 3166-1 alpha-2 country code
-   */
+   */
-  private static isValidCountryCode(code: string): boolean {
+  private static isValidCountryCode(code: string): boolean {
-    const countryCodePattern = /^[A-Z]{2}$/;
+    const countryCodePattern = /^[A-Z]{2}$/;
-    return countryCodePattern.test(code);
+    return countryCodePattern.test(code);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate coordinates
+   * Validate coordinates
-   */
+   */
-  private static isValidCoordinates(coords: PortCoordinates): boolean {
+  private static isValidCoordinates(coords: PortCoordinates): boolean {
-    const { latitude, longitude } = coords;
+    const { latitude, longitude } = coords;
-    return latitude >= -90 && latitude <= 90 && longitude >= -180 && longitude <= 180;
+    return latitude >= -90 && latitude <= 90 && longitude >= -180 && longitude <= 180;
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get code(): string {
+  get code(): string {
-    return this.props.code;
+    return this.props.code;
-  }
+  }
-
+
-  get name(): string {
+  get name(): string {
-    return this.props.name;
+    return this.props.name;
-  }
+  }
-
+
-  get city(): string {
+  get city(): string {
-    return this.props.city;
+    return this.props.city;
-  }
+  }
-
+
-  get country(): string {
+  get country(): string {
-    return this.props.country;
+    return this.props.country;
-  }
+  }
-
+
-  get countryName(): string {
+  get countryName(): string {
-    return this.props.countryName;
+    return this.props.countryName;
-  }
+  }
-
+
-  get coordinates(): PortCoordinates {
+  get coordinates(): PortCoordinates {
-    return { ...this.props.coordinates };
+    return { ...this.props.coordinates };
-  }
+  }
-
+
-  get timezone(): string | undefined {
+  get timezone(): string | undefined {
-    return this.props.timezone;
+    return this.props.timezone;
-  }
+  }
-
+
-  get isActive(): boolean {
+  get isActive(): boolean {
-    return this.props.isActive;
+    return this.props.isActive;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  /**
+  /**
-   * Get display name (e.g., "Rotterdam, Netherlands (NLRTM)")
+   * Get display name (e.g., "Rotterdam, Netherlands (NLRTM)")
-   */
+   */
-  getDisplayName(): string {
+  getDisplayName(): string {
-    return `${this.props.name}, ${this.props.countryName} (${this.props.code})`;
+    return `${this.props.name}, ${this.props.countryName} (${this.props.code})`;
-  }
+  }
-
+
-  /**
+  /**
-   * Calculate distance to another port (Haversine formula)
+   * Calculate distance to another port (Haversine formula)
-   * Returns distance in kilometers
+   * Returns distance in kilometers
-   */
+   */
-  distanceTo(otherPort: Port): number {
+  distanceTo(otherPort: Port): number {
-    const R = 6371; // Earth's radius in kilometers
+    const R = 6371; // Earth's radius in kilometers
-    const lat1 = this.toRadians(this.props.coordinates.latitude);
+    const lat1 = this.toRadians(this.props.coordinates.latitude);
-    const lat2 = this.toRadians(otherPort.coordinates.latitude);
+    const lat2 = this.toRadians(otherPort.coordinates.latitude);
-    const deltaLat = this.toRadians(otherPort.coordinates.latitude - this.props.coordinates.latitude);
+    const deltaLat = this.toRadians(otherPort.coordinates.latitude - this.props.coordinates.latitude);
-    const deltaLon = this.toRadians(otherPort.coordinates.longitude - this.props.coordinates.longitude);
+    const deltaLon = this.toRadians(otherPort.coordinates.longitude - this.props.coordinates.longitude);
-
+
-    const a =
+    const a =
-      Math.sin(deltaLat / 2) * Math.sin(deltaLat / 2) +
+      Math.sin(deltaLat / 2) * Math.sin(deltaLat / 2) +
-      Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) * Math.sin(deltaLon / 2);
+      Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) * Math.sin(deltaLon / 2);
-
+
-    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
-
+
-    return R * c;
+    return R * c;
-  }
+  }
-
+
-  private toRadians(degrees: number): number {
+  private toRadians(degrees: number): number {
-    return degrees * (Math.PI / 180);
+    return degrees * (Math.PI / 180);
-  }
+  }
-
+
-  updateCoordinates(coordinates: PortCoordinates): void {
+  updateCoordinates(coordinates: PortCoordinates): void {
-    if (!Port.isValidCoordinates(coordinates)) {
+    if (!Port.isValidCoordinates(coordinates)) {
-      throw new Error('Invalid coordinates.');
+      throw new Error('Invalid coordinates.');
-    }
+    }
-    this.props.coordinates = { ...coordinates };
+    this.props.coordinates = { ...coordinates };
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateTimezone(timezone: string): void {
+  updateTimezone(timezone: string): void {
-    this.props.timezone = timezone;
+    this.props.timezone = timezone;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  deactivate(): void {
+  deactivate(): void {
-    this.props.isActive = false;
+    this.props.isActive = false;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  activate(): void {
+  activate(): void {
-    this.props.isActive = true;
+    this.props.isActive = true;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): PortProps {
+  toObject(): PortProps {
-    return {
+    return {
-      ...this.props,
+      ...this.props,
-      coordinates: { ...this.props.coordinates },
+      coordinates: { ...this.props.coordinates },
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/entities/rate-quote.entity.spec.ts

@@ -1,240 +1,240 @@
-/**
+/**
- * RateQuote Entity Unit Tests
+ * RateQuote Entity Unit Tests
- */
+ */
-
+
-import { RateQuote } from './rate-quote.entity';
+import { RateQuote } from './rate-quote.entity';
-
+
-describe('RateQuote Entity', () => {
+describe('RateQuote Entity', () => {
-  const validProps = {
+  const validProps = {
-    id: 'quote-1',
+    id: 'quote-1',
-    carrierId: 'carrier-1',
+    carrierId: 'carrier-1',
-    carrierName: 'Maersk',
+    carrierName: 'Maersk',
-    carrierCode: 'MAERSK',
+    carrierCode: 'MAERSK',
-    origin: {
+    origin: {
-      code: 'NLRTM',
+      code: 'NLRTM',
-      name: 'Rotterdam',
+      name: 'Rotterdam',
-      country: 'Netherlands',
+      country: 'Netherlands',
-    },
+    },
-    destination: {
+    destination: {
-      code: 'USNYC',
+      code: 'USNYC',
-      name: 'New York',
+      name: 'New York',
-      country: 'United States',
+      country: 'United States',
-    },
+    },
-    pricing: {
+    pricing: {
-      baseFreight: 1000,
+      baseFreight: 1000,
-      surcharges: [
+      surcharges: [
-        { type: 'BAF', description: 'Bunker Adjustment Factor', amount: 100, currency: 'USD' },
+        { type: 'BAF', description: 'Bunker Adjustment Factor', amount: 100, currency: 'USD' },
-      ],
+      ],
-      totalAmount: 1100,
+      totalAmount: 1100,
-      currency: 'USD',
+      currency: 'USD',
-    },
+    },
-    containerType: '40HC',
+    containerType: '40HC',
-    mode: 'FCL' as const,
+    mode: 'FCL' as const,
-    etd: new Date('2025-11-01'),
+    etd: new Date('2025-11-01'),
-    eta: new Date('2025-11-20'),
+    eta: new Date('2025-11-20'),
-    transitDays: 19,
+    transitDays: 19,
-    route: [
+    route: [
-      {
+      {
-        portCode: 'NLRTM',
+        portCode: 'NLRTM',
-        portName: 'Rotterdam',
+        portName: 'Rotterdam',
-        departure: new Date('2025-11-01'),
+        departure: new Date('2025-11-01'),
-      },
+      },
-      {
+      {
-        portCode: 'USNYC',
+        portCode: 'USNYC',
-        portName: 'New York',
+        portName: 'New York',
-        arrival: new Date('2025-11-20'),
+        arrival: new Date('2025-11-20'),
-      },
+      },
-    ],
+    ],
-    availability: 50,
+    availability: 50,
-    frequency: 'Weekly',
+    frequency: 'Weekly',
-    vesselType: 'Container Ship',
+    vesselType: 'Container Ship',
-    co2EmissionsKg: 2500,
+    co2EmissionsKg: 2500,
-  };
+  };
-
+
-  describe('create', () => {
+  describe('create', () => {
-    it('should create rate quote with valid props', () => {
+    it('should create rate quote with valid props', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.id).toBe('quote-1');
+      expect(rateQuote.id).toBe('quote-1');
-      expect(rateQuote.carrierName).toBe('Maersk');
+      expect(rateQuote.carrierName).toBe('Maersk');
-      expect(rateQuote.origin.code).toBe('NLRTM');
+      expect(rateQuote.origin.code).toBe('NLRTM');
-      expect(rateQuote.destination.code).toBe('USNYC');
+      expect(rateQuote.destination.code).toBe('USNYC');
-      expect(rateQuote.pricing.totalAmount).toBe(1100);
+      expect(rateQuote.pricing.totalAmount).toBe(1100);
-    });
+    });
-
+
-    it('should set validUntil to 15 minutes from now', () => {
+    it('should set validUntil to 15 minutes from now', () => {
-      const before = new Date();
+      const before = new Date();
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      const after = new Date();
+      const after = new Date();
-
+
-      const expectedValidUntil = new Date(before.getTime() + 15 * 60 * 1000);
+      const expectedValidUntil = new Date(before.getTime() + 15 * 60 * 1000);
-      const diff = Math.abs(rateQuote.validUntil.getTime() - expectedValidUntil.getTime());
+      const diff = Math.abs(rateQuote.validUntil.getTime() - expectedValidUntil.getTime());
-
+
-      // Allow 1 second tolerance for test execution time
+      // Allow 1 second tolerance for test execution time
-      expect(diff).toBeLessThan(1000);
+      expect(diff).toBeLessThan(1000);
-    });
+    });
-
+
-    it('should throw error for non-positive total price', () => {
+    it('should throw error for non-positive total price', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          pricing: { ...validProps.pricing, totalAmount: 0 },
+          pricing: { ...validProps.pricing, totalAmount: 0 },
-        })
+        })
-      ).toThrow('Total price must be positive');
+      ).toThrow('Total price must be positive');
-    });
+    });
-
+
-    it('should throw error for non-positive base freight', () => {
+    it('should throw error for non-positive base freight', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          pricing: { ...validProps.pricing, baseFreight: 0 },
+          pricing: { ...validProps.pricing, baseFreight: 0 },
-        })
+        })
-      ).toThrow('Base freight must be positive');
+      ).toThrow('Base freight must be positive');
-    });
+    });
-
+
-    it('should throw error if ETA is not after ETD', () => {
+    it('should throw error if ETA is not after ETD', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          eta: new Date('2025-10-31'),
+          eta: new Date('2025-10-31'),
-        })
+        })
-      ).toThrow('ETA must be after ETD');
+      ).toThrow('ETA must be after ETD');
-    });
+    });
-
+
-    it('should throw error for non-positive transit days', () => {
+    it('should throw error for non-positive transit days', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          transitDays: 0,
+          transitDays: 0,
-        })
+        })
-      ).toThrow('Transit days must be positive');
+      ).toThrow('Transit days must be positive');
-    });
+    });
-
+
-    it('should throw error for negative availability', () => {
+    it('should throw error for negative availability', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          availability: -1,
+          availability: -1,
-        })
+        })
-      ).toThrow('Availability cannot be negative');
+      ).toThrow('Availability cannot be negative');
-    });
+    });
-
+
-    it('should throw error if route has less than 2 segments', () => {
+    it('should throw error if route has less than 2 segments', () => {
-      expect(() =>
+      expect(() =>
-        RateQuote.create({
+        RateQuote.create({
-          ...validProps,
+          ...validProps,
-          route: [{ portCode: 'NLRTM', portName: 'Rotterdam' }],
+          route: [{ portCode: 'NLRTM', portName: 'Rotterdam' }],
-        })
+        })
-      ).toThrow('Route must have at least origin and destination');
+      ).toThrow('Route must have at least origin and destination');
-    });
+    });
-  });
+  });
-
+
-  describe('isValid', () => {
+  describe('isValid', () => {
-    it('should return true for non-expired quote', () => {
+    it('should return true for non-expired quote', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.isValid()).toBe(true);
+      expect(rateQuote.isValid()).toBe(true);
-    });
+    });
-
+
-    it('should return false for expired quote', () => {
+    it('should return false for expired quote', () => {
-      const expiredQuote = RateQuote.fromPersistence({
+      const expiredQuote = RateQuote.fromPersistence({
-        ...validProps,
+        ...validProps,
-        validUntil: new Date(Date.now() - 1000), // 1 second ago
+        validUntil: new Date(Date.now() - 1000), // 1 second ago
-        createdAt: new Date(),
+        createdAt: new Date(),
-        updatedAt: new Date(),
+        updatedAt: new Date(),
-      });
+      });
-      expect(expiredQuote.isValid()).toBe(false);
+      expect(expiredQuote.isValid()).toBe(false);
-    });
+    });
-  });
+  });
-
+
-  describe('isExpired', () => {
+  describe('isExpired', () => {
-    it('should return false for non-expired quote', () => {
+    it('should return false for non-expired quote', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.isExpired()).toBe(false);
+      expect(rateQuote.isExpired()).toBe(false);
-    });
+    });
-
+
-    it('should return true for expired quote', () => {
+    it('should return true for expired quote', () => {
-      const expiredQuote = RateQuote.fromPersistence({
+      const expiredQuote = RateQuote.fromPersistence({
-        ...validProps,
+        ...validProps,
-        validUntil: new Date(Date.now() - 1000),
+        validUntil: new Date(Date.now() - 1000),
-        createdAt: new Date(),
+        createdAt: new Date(),
-        updatedAt: new Date(),
+        updatedAt: new Date(),
-      });
+      });
-      expect(expiredQuote.isExpired()).toBe(true);
+      expect(expiredQuote.isExpired()).toBe(true);
-    });
+    });
-  });
+  });
-
+
-  describe('hasAvailability', () => {
+  describe('hasAvailability', () => {
-    it('should return true when availability > 0', () => {
+    it('should return true when availability > 0', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.hasAvailability()).toBe(true);
+      expect(rateQuote.hasAvailability()).toBe(true);
-    });
+    });
-
+
-    it('should return false when availability = 0', () => {
+    it('should return false when availability = 0', () => {
-      const rateQuote = RateQuote.create({ ...validProps, availability: 0 });
+      const rateQuote = RateQuote.create({ ...validProps, availability: 0 });
-      expect(rateQuote.hasAvailability()).toBe(false);
+      expect(rateQuote.hasAvailability()).toBe(false);
-    });
+    });
-  });
+  });
-
+
-  describe('getTotalSurcharges', () => {
+  describe('getTotalSurcharges', () => {
-    it('should calculate total surcharges', () => {
+    it('should calculate total surcharges', () => {
-      const rateQuote = RateQuote.create({
+      const rateQuote = RateQuote.create({
-        ...validProps,
+        ...validProps,
-        pricing: {
+        pricing: {
-          baseFreight: 1000,
+          baseFreight: 1000,
-          surcharges: [
+          surcharges: [
-            { type: 'BAF', description: 'BAF', amount: 100, currency: 'USD' },
+            { type: 'BAF', description: 'BAF', amount: 100, currency: 'USD' },
-            { type: 'CAF', description: 'CAF', amount: 50, currency: 'USD' },
+            { type: 'CAF', description: 'CAF', amount: 50, currency: 'USD' },
-          ],
+          ],
-          totalAmount: 1150,
+          totalAmount: 1150,
-          currency: 'USD',
+          currency: 'USD',
-        },
+        },
-      });
+      });
-      expect(rateQuote.getTotalSurcharges()).toBe(150);
+      expect(rateQuote.getTotalSurcharges()).toBe(150);
-    });
+    });
-  });
+  });
-
+
-  describe('getTransshipmentCount', () => {
+  describe('getTransshipmentCount', () => {
-    it('should return 0 for direct route', () => {
+    it('should return 0 for direct route', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.getTransshipmentCount()).toBe(0);
+      expect(rateQuote.getTransshipmentCount()).toBe(0);
-    });
+    });
-
+
-    it('should return correct count for route with transshipments', () => {
+    it('should return correct count for route with transshipments', () => {
-      const rateQuote = RateQuote.create({
+      const rateQuote = RateQuote.create({
-        ...validProps,
+        ...validProps,
-        route: [
+        route: [
-          { portCode: 'NLRTM', portName: 'Rotterdam' },
+          { portCode: 'NLRTM', portName: 'Rotterdam' },
-          { portCode: 'ESBCN', portName: 'Barcelona' },
+          { portCode: 'ESBCN', portName: 'Barcelona' },
-          { portCode: 'USNYC', portName: 'New York' },
+          { portCode: 'USNYC', portName: 'New York' },
-        ],
+        ],
-      });
+      });
-      expect(rateQuote.getTransshipmentCount()).toBe(1);
+      expect(rateQuote.getTransshipmentCount()).toBe(1);
-    });
+    });
-  });
+  });
-
+
-  describe('isDirectRoute', () => {
+  describe('isDirectRoute', () => {
-    it('should return true for direct route', () => {
+    it('should return true for direct route', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      expect(rateQuote.isDirectRoute()).toBe(true);
+      expect(rateQuote.isDirectRoute()).toBe(true);
-    });
+    });
-
+
-    it('should return false for route with transshipments', () => {
+    it('should return false for route with transshipments', () => {
-      const rateQuote = RateQuote.create({
+      const rateQuote = RateQuote.create({
-        ...validProps,
+        ...validProps,
-        route: [
+        route: [
-          { portCode: 'NLRTM', portName: 'Rotterdam' },
+          { portCode: 'NLRTM', portName: 'Rotterdam' },
-          { portCode: 'ESBCN', portName: 'Barcelona' },
+          { portCode: 'ESBCN', portName: 'Barcelona' },
-          { portCode: 'USNYC', portName: 'New York' },
+          { portCode: 'USNYC', portName: 'New York' },
-        ],
+        ],
-      });
+      });
-      expect(rateQuote.isDirectRoute()).toBe(false);
+      expect(rateQuote.isDirectRoute()).toBe(false);
-    });
+    });
-  });
+  });
-
+
-  describe('getPricePerDay', () => {
+  describe('getPricePerDay', () => {
-    it('should calculate price per day', () => {
+    it('should calculate price per day', () => {
-      const rateQuote = RateQuote.create(validProps);
+      const rateQuote = RateQuote.create(validProps);
-      const pricePerDay = rateQuote.getPricePerDay();
+      const pricePerDay = rateQuote.getPricePerDay();
-      expect(pricePerDay).toBeCloseTo(1100 / 19, 2);
+      expect(pricePerDay).toBeCloseTo(1100 / 19, 2);
-    });
+    });
-  });
+  });
-});
+});

apps/backend/src/domain/entities/rate-quote.entity.ts

@@ -1,277 +1,277 @@
-/**
+/**
- * RateQuote Entity
+ * RateQuote Entity
- *
+ *
- * Represents a shipping rate quote from a carrier
+ * Represents a shipping rate quote from a carrier
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Price must be positive
+ * - Price must be positive
- * - ETA must be after ETD
+ * - ETA must be after ETD
- * - Transit days must be positive
+ * - Transit days must be positive
- * - Rate quotes expire after 15 minutes (cache TTL)
+ * - Rate quotes expire after 15 minutes (cache TTL)
- * - Availability must be between 0 and actual capacity
+ * - Availability must be between 0 and actual capacity
- */
+ */
-
+
-export interface RouteSegment {
+export interface RouteSegment {
-  portCode: string;
+  portCode: string;
-  portName: string;
+  portName: string;
-  arrival?: Date;
+  arrival?: Date;
-  departure?: Date;
+  departure?: Date;
-  vesselName?: string;
+  vesselName?: string;
-  voyageNumber?: string;
+  voyageNumber?: string;
-}
+}
-
+
-export interface Surcharge {
+export interface Surcharge {
-  type: string; // e.g., 'BAF', 'CAF', 'THC', 'ISPS'
+  type: string; // e.g., 'BAF', 'CAF', 'THC', 'ISPS'
-  description: string;
+  description: string;
-  amount: number;
+  amount: number;
-  currency: string;
+  currency: string;
-}
+}
-
+
-export interface PriceBreakdown {
+export interface PriceBreakdown {
-  baseFreight: number;
+  baseFreight: number;
-  surcharges: Surcharge[];
+  surcharges: Surcharge[];
-  totalAmount: number;
+  totalAmount: number;
-  currency: string;
+  currency: string;
-}
+}
-
+
-export interface RateQuoteProps {
+export interface RateQuoteProps {
-  id: string;
+  id: string;
-  carrierId: string;
+  carrierId: string;
-  carrierName: string;
+  carrierName: string;
-  carrierCode: string;
+  carrierCode: string;
-  origin: {
+  origin: {
-    code: string;
+    code: string;
-    name: string;
+    name: string;
-    country: string;
+    country: string;
-  };
+  };
-  destination: {
+  destination: {
-    code: string;
+    code: string;
-    name: string;
+    name: string;
-    country: string;
+    country: string;
-  };
+  };
-  pricing: PriceBreakdown;
+  pricing: PriceBreakdown;
-  containerType: string; // e.g., '20DRY', '40HC', '40REEFER'
+  containerType: string; // e.g., '20DRY', '40HC', '40REEFER'
-  mode: 'FCL' | 'LCL';
+  mode: 'FCL' | 'LCL';
-  etd: Date; // Estimated Time of Departure
+  etd: Date; // Estimated Time of Departure
-  eta: Date; // Estimated Time of Arrival
+  eta: Date; // Estimated Time of Arrival
-  transitDays: number;
+  transitDays: number;
-  route: RouteSegment[];
+  route: RouteSegment[];
-  availability: number; // Available container slots
+  availability: number; // Available container slots
-  frequency: string; // e.g., 'Weekly', 'Bi-weekly'
+  frequency: string; // e.g., 'Weekly', 'Bi-weekly'
-  vesselType?: string; // e.g., 'Container Ship', 'Ro-Ro'
+  vesselType?: string; // e.g., 'Container Ship', 'Ro-Ro'
-  co2EmissionsKg?: number; // CO2 emissions in kg
+  co2EmissionsKg?: number; // CO2 emissions in kg
-  validUntil: Date; // When this quote expires (typically createdAt + 15 min)
+  validUntil: Date; // When this quote expires (typically createdAt + 15 min)
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class RateQuote {
+export class RateQuote {
-  private readonly props: RateQuoteProps;
+  private readonly props: RateQuoteProps;
-
+
-  private constructor(props: RateQuoteProps) {
+  private constructor(props: RateQuoteProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new RateQuote
+   * Factory method to create a new RateQuote
-   */
+   */
-  static create(
+  static create(
-    props: Omit<RateQuoteProps, 'id' | 'validUntil' | 'createdAt' | 'updatedAt'> & { id: string }
+    props: Omit<RateQuoteProps, 'id' | 'validUntil' | 'createdAt' | 'updatedAt'> & { id: string }
-  ): RateQuote {
+  ): RateQuote {
-    const now = new Date();
+    const now = new Date();
-    const validUntil = new Date(now.getTime() + 15 * 60 * 1000); // 15 minutes
+    const validUntil = new Date(now.getTime() + 15 * 60 * 1000); // 15 minutes
-
+
-    // Validate pricing
+    // Validate pricing
-    if (props.pricing.totalAmount <= 0) {
+    if (props.pricing.totalAmount <= 0) {
-      throw new Error('Total price must be positive.');
+      throw new Error('Total price must be positive.');
-    }
+    }
-
+
-    if (props.pricing.baseFreight <= 0) {
+    if (props.pricing.baseFreight <= 0) {
-      throw new Error('Base freight must be positive.');
+      throw new Error('Base freight must be positive.');
-    }
+    }
-
+
-    // Validate dates
+    // Validate dates
-    if (props.eta <= props.etd) {
+    if (props.eta <= props.etd) {
-      throw new Error('ETA must be after ETD.');
+      throw new Error('ETA must be after ETD.');
-    }
+    }
-
+
-    // Validate transit days
+    // Validate transit days
-    if (props.transitDays <= 0) {
+    if (props.transitDays <= 0) {
-      throw new Error('Transit days must be positive.');
+      throw new Error('Transit days must be positive.');
-    }
+    }
-
+
-    // Validate availability
+    // Validate availability
-    if (props.availability < 0) {
+    if (props.availability < 0) {
-      throw new Error('Availability cannot be negative.');
+      throw new Error('Availability cannot be negative.');
-    }
+    }
-
+
-    // Validate route has at least origin and destination
+    // Validate route has at least origin and destination
-    if (props.route.length < 2) {
+    if (props.route.length < 2) {
-      throw new Error('Route must have at least origin and destination ports.');
+      throw new Error('Route must have at least origin and destination ports.');
-    }
+    }
-
+
-    return new RateQuote({
+    return new RateQuote({
-      ...props,
+      ...props,
-      validUntil,
+      validUntil,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: RateQuoteProps): RateQuote {
+  static fromPersistence(props: RateQuoteProps): RateQuote {
-    return new RateQuote(props);
+    return new RateQuote(props);
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get carrierId(): string {
+  get carrierId(): string {
-    return this.props.carrierId;
+    return this.props.carrierId;
-  }
+  }
-
+
-  get carrierName(): string {
+  get carrierName(): string {
-    return this.props.carrierName;
+    return this.props.carrierName;
-  }
+  }
-
+
-  get carrierCode(): string {
+  get carrierCode(): string {
-    return this.props.carrierCode;
+    return this.props.carrierCode;
-  }
+  }
-
+
-  get origin(): { code: string; name: string; country: string } {
+  get origin(): { code: string; name: string; country: string } {
-    return { ...this.props.origin };
+    return { ...this.props.origin };
-  }
+  }
-
+
-  get destination(): { code: string; name: string; country: string } {
+  get destination(): { code: string; name: string; country: string } {
-    return { ...this.props.destination };
+    return { ...this.props.destination };
-  }
+  }
-
+
-  get pricing(): PriceBreakdown {
+  get pricing(): PriceBreakdown {
-    return {
+    return {
-      ...this.props.pricing,
+      ...this.props.pricing,
-      surcharges: [...this.props.pricing.surcharges],
+      surcharges: [...this.props.pricing.surcharges],
-    };
+    };
-  }
+  }
-
+
-  get containerType(): string {
+  get containerType(): string {
-    return this.props.containerType;
+    return this.props.containerType;
-  }
+  }
-
+
-  get mode(): 'FCL' | 'LCL' {
+  get mode(): 'FCL' | 'LCL' {
-    return this.props.mode;
+    return this.props.mode;
-  }
+  }
-
+
-  get etd(): Date {
+  get etd(): Date {
-    return this.props.etd;
+    return this.props.etd;
-  }
+  }
-
+
-  get eta(): Date {
+  get eta(): Date {
-    return this.props.eta;
+    return this.props.eta;
-  }
+  }
-
+
-  get transitDays(): number {
+  get transitDays(): number {
-    return this.props.transitDays;
+    return this.props.transitDays;
-  }
+  }
-
+
-  get route(): RouteSegment[] {
+  get route(): RouteSegment[] {
-    return [...this.props.route];
+    return [...this.props.route];
-  }
+  }
-
+
-  get availability(): number {
+  get availability(): number {
-    return this.props.availability;
+    return this.props.availability;
-  }
+  }
-
+
-  get frequency(): string {
+  get frequency(): string {
-    return this.props.frequency;
+    return this.props.frequency;
-  }
+  }
-
+
-  get vesselType(): string | undefined {
+  get vesselType(): string | undefined {
-    return this.props.vesselType;
+    return this.props.vesselType;
-  }
+  }
-
+
-  get co2EmissionsKg(): number | undefined {
+  get co2EmissionsKg(): number | undefined {
-    return this.props.co2EmissionsKg;
+    return this.props.co2EmissionsKg;
-  }
+  }
-
+
-  get validUntil(): Date {
+  get validUntil(): Date {
-    return this.props.validUntil;
+    return this.props.validUntil;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  /**
+  /**
-   * Check if the rate quote is still valid (not expired)
+   * Check if the rate quote is still valid (not expired)
-   */
+   */
-  isValid(): boolean {
+  isValid(): boolean {
-    return new Date() < this.props.validUntil;
+    return new Date() < this.props.validUntil;
-  }
+  }
-
+
-  /**
+  /**
-   * Check if the rate quote has expired
+   * Check if the rate quote has expired
-   */
+   */
-  isExpired(): boolean {
+  isExpired(): boolean {
-    return new Date() >= this.props.validUntil;
+    return new Date() >= this.props.validUntil;
-  }
+  }
-
+
-  /**
+  /**
-   * Check if containers are available
+   * Check if containers are available
-   */
+   */
-  hasAvailability(): boolean {
+  hasAvailability(): boolean {
-    return this.props.availability > 0;
+    return this.props.availability > 0;
-  }
+  }
-
+
-  /**
+  /**
-   * Get total surcharges amount
+   * Get total surcharges amount
-   */
+   */
-  getTotalSurcharges(): number {
+  getTotalSurcharges(): number {
-    return this.props.pricing.surcharges.reduce((sum, surcharge) => sum + surcharge.amount, 0);
+    return this.props.pricing.surcharges.reduce((sum, surcharge) => sum + surcharge.amount, 0);
-  }
+  }
-
+
-  /**
+  /**
-   * Get number of transshipments (route segments minus 2 for origin and destination)
+   * Get number of transshipments (route segments minus 2 for origin and destination)
-   */
+   */
-  getTransshipmentCount(): number {
+  getTransshipmentCount(): number {
-    return Math.max(0, this.props.route.length - 2);
+    return Math.max(0, this.props.route.length - 2);
-  }
+  }
-
+
-  /**
+  /**
-   * Check if this is a direct route (no transshipments)
+   * Check if this is a direct route (no transshipments)
-   */
+   */
-  isDirectRoute(): boolean {
+  isDirectRoute(): boolean {
-    return this.getTransshipmentCount() === 0;
+    return this.getTransshipmentCount() === 0;
-  }
+  }
-
+
-  /**
+  /**
-   * Get price per day (for comparison)
+   * Get price per day (for comparison)
-   */
+   */
-  getPricePerDay(): number {
+  getPricePerDay(): number {
-    return this.props.pricing.totalAmount / this.props.transitDays;
+    return this.props.pricing.totalAmount / this.props.transitDays;
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): RateQuoteProps {
+  toObject(): RateQuoteProps {
-    return {
+    return {
-      ...this.props,
+      ...this.props,
-      origin: { ...this.props.origin },
+      origin: { ...this.props.origin },
-      destination: { ...this.props.destination },
+      destination: { ...this.props.destination },
-      pricing: {
+      pricing: {
-        ...this.props.pricing,
+        ...this.props.pricing,
-        surcharges: [...this.props.pricing.surcharges],
+        surcharges: [...this.props.pricing.surcharges],
-      },
+      },
-      route: [...this.props.route],
+      route: [...this.props.route],
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/entities/user.entity.ts

@@ -1,250 +1,250 @@
-/**
+/**
- * User Entity
+ * User Entity
- *
+ *
- * Represents a user account in the Xpeditis platform.
+ * Represents a user account in the Xpeditis platform.
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Email must be valid and unique
+ * - Email must be valid and unique
- * - Password must meet complexity requirements (enforced at application layer)
+ * - Password must meet complexity requirements (enforced at application layer)
- * - Users belong to an organization
+ * - Users belong to an organization
- * - Role-based access control (Admin, Manager, User, Viewer)
+ * - Role-based access control (Admin, Manager, User, Viewer)
- */
+ */
-
+
-export enum UserRole {
+export enum UserRole {
-  ADMIN = 'admin',           // Full system access
+  ADMIN = 'admin',           // Full system access
-  MANAGER = 'manager',       // Manage bookings and users within organization
+  MANAGER = 'manager',       // Manage bookings and users within organization
-  USER = 'user',             // Create and view bookings
+  USER = 'user',             // Create and view bookings
-  VIEWER = 'viewer',         // Read-only access
+  VIEWER = 'viewer',         // Read-only access
-}
+}
-
+
-export interface UserProps {
+export interface UserProps {
-  id: string;
+  id: string;
-  organizationId: string;
+  organizationId: string;
-  email: string;
+  email: string;
-  passwordHash: string;
+  passwordHash: string;
-  role: UserRole;
+  role: UserRole;
-  firstName: string;
+  firstName: string;
-  lastName: string;
+  lastName: string;
-  phoneNumber?: string;
+  phoneNumber?: string;
-  totpSecret?: string; // For 2FA
+  totpSecret?: string; // For 2FA
-  isEmailVerified: boolean;
+  isEmailVerified: boolean;
-  isActive: boolean;
+  isActive: boolean;
-  lastLoginAt?: Date;
+  lastLoginAt?: Date;
-  createdAt: Date;
+  createdAt: Date;
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}
-
+
-export class User {
+export class User {
-  private readonly props: UserProps;
+  private readonly props: UserProps;
-
+
-  private constructor(props: UserProps) {
+  private constructor(props: UserProps) {
-    this.props = props;
+    this.props = props;
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to create a new User
+   * Factory method to create a new User
-   */
+   */
-  static create(
+  static create(
-    props: Omit<UserProps, 'createdAt' | 'updatedAt' | 'isEmailVerified' | 'isActive' | 'lastLoginAt'>
+    props: Omit<UserProps, 'createdAt' | 'updatedAt' | 'isEmailVerified' | 'isActive' | 'lastLoginAt'>
-  ): User {
+  ): User {
-    const now = new Date();
+    const now = new Date();
-
+
-    // Validate email format (basic validation)
+    // Validate email format (basic validation)
-    if (!User.isValidEmail(props.email)) {
+    if (!User.isValidEmail(props.email)) {
-      throw new Error('Invalid email format.');
+      throw new Error('Invalid email format.');
-    }
+    }
-
+
-    return new User({
+    return new User({
-      ...props,
+      ...props,
-      isEmailVerified: false,
+      isEmailVerified: false,
-      isActive: true,
+      isActive: true,
-      createdAt: now,
+      createdAt: now,
-      updatedAt: now,
+      updatedAt: now,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Factory method to reconstitute from persistence
+   * Factory method to reconstitute from persistence
-   */
+   */
-  static fromPersistence(props: UserProps): User {
+  static fromPersistence(props: UserProps): User {
-    return new User(props);
+    return new User(props);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate email format
+   * Validate email format
-   */
+   */
-  private static isValidEmail(email: string): boolean {
+  private static isValidEmail(email: string): boolean {
-    const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    return emailPattern.test(email);
+    return emailPattern.test(email);
-  }
+  }
-
+
-  // Getters
+  // Getters
-  get id(): string {
+  get id(): string {
-    return this.props.id;
+    return this.props.id;
-  }
+  }
-
+
-  get organizationId(): string {
+  get organizationId(): string {
-    return this.props.organizationId;
+    return this.props.organizationId;
-  }
+  }
-
+
-  get email(): string {
+  get email(): string {
-    return this.props.email;
+    return this.props.email;
-  }
+  }
-
+
-  get passwordHash(): string {
+  get passwordHash(): string {
-    return this.props.passwordHash;
+    return this.props.passwordHash;
-  }
+  }
-
+
-  get role(): UserRole {
+  get role(): UserRole {
-    return this.props.role;
+    return this.props.role;
-  }
+  }
-
+
-  get firstName(): string {
+  get firstName(): string {
-    return this.props.firstName;
+    return this.props.firstName;
-  }
+  }
-
+
-  get lastName(): string {
+  get lastName(): string {
-    return this.props.lastName;
+    return this.props.lastName;
-  }
+  }
-
+
-  get fullName(): string {
+  get fullName(): string {
-    return `${this.props.firstName} ${this.props.lastName}`;
+    return `${this.props.firstName} ${this.props.lastName}`;
-  }
+  }
-
+
-  get phoneNumber(): string | undefined {
+  get phoneNumber(): string | undefined {
-    return this.props.phoneNumber;
+    return this.props.phoneNumber;
-  }
+  }
-
+
-  get totpSecret(): string | undefined {
+  get totpSecret(): string | undefined {
-    return this.props.totpSecret;
+    return this.props.totpSecret;
-  }
+  }
-
+
-  get isEmailVerified(): boolean {
+  get isEmailVerified(): boolean {
-    return this.props.isEmailVerified;
+    return this.props.isEmailVerified;
-  }
+  }
-
+
-  get isActive(): boolean {
+  get isActive(): boolean {
-    return this.props.isActive;
+    return this.props.isActive;
-  }
+  }
-
+
-  get lastLoginAt(): Date | undefined {
+  get lastLoginAt(): Date | undefined {
-    return this.props.lastLoginAt;
+    return this.props.lastLoginAt;
-  }
+  }
-
+
-  get createdAt(): Date {
+  get createdAt(): Date {
-    return this.props.createdAt;
+    return this.props.createdAt;
-  }
+  }
-
+
-  get updatedAt(): Date {
+  get updatedAt(): Date {
-    return this.props.updatedAt;
+    return this.props.updatedAt;
-  }
+  }
-
+
-  // Business methods
+  // Business methods
-  has2FAEnabled(): boolean {
+  has2FAEnabled(): boolean {
-    return !!this.props.totpSecret;
+    return !!this.props.totpSecret;
-  }
+  }
-
+
-  isAdmin(): boolean {
+  isAdmin(): boolean {
-    return this.props.role === UserRole.ADMIN;
+    return this.props.role === UserRole.ADMIN;
-  }
+  }
-
+
-  isManager(): boolean {
+  isManager(): boolean {
-    return this.props.role === UserRole.MANAGER;
+    return this.props.role === UserRole.MANAGER;
-  }
+  }
-
+
-  isRegularUser(): boolean {
+  isRegularUser(): boolean {
-    return this.props.role === UserRole.USER;
+    return this.props.role === UserRole.USER;
-  }
+  }
-
+
-  isViewer(): boolean {
+  isViewer(): boolean {
-    return this.props.role === UserRole.VIEWER;
+    return this.props.role === UserRole.VIEWER;
-  }
+  }
-
+
-  canManageUsers(): boolean {
+  canManageUsers(): boolean {
-    return this.props.role === UserRole.ADMIN || this.props.role === UserRole.MANAGER;
+    return this.props.role === UserRole.ADMIN || this.props.role === UserRole.MANAGER;
-  }
+  }
-
+
-  canCreateBookings(): boolean {
+  canCreateBookings(): boolean {
-    return (
+    return (
-      this.props.role === UserRole.ADMIN ||
+      this.props.role === UserRole.ADMIN ||
-      this.props.role === UserRole.MANAGER ||
+      this.props.role === UserRole.MANAGER ||
-      this.props.role === UserRole.USER
+      this.props.role === UserRole.USER
-    );
+    );
-  }
+  }
-
+
-  updatePassword(newPasswordHash: string): void {
+  updatePassword(newPasswordHash: string): void {
-    this.props.passwordHash = newPasswordHash;
+    this.props.passwordHash = newPasswordHash;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateRole(newRole: UserRole): void {
+  updateRole(newRole: UserRole): void {
-    this.props.role = newRole;
+    this.props.role = newRole;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateFirstName(firstName: string): void {
+  updateFirstName(firstName: string): void {
-    if (!firstName || firstName.trim().length === 0) {
+    if (!firstName || firstName.trim().length === 0) {
-      throw new Error('First name cannot be empty.');
+      throw new Error('First name cannot be empty.');
-    }
+    }
-    this.props.firstName = firstName.trim();
+    this.props.firstName = firstName.trim();
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateLastName(lastName: string): void {
+  updateLastName(lastName: string): void {
-    if (!lastName || lastName.trim().length === 0) {
+    if (!lastName || lastName.trim().length === 0) {
-      throw new Error('Last name cannot be empty.');
+      throw new Error('Last name cannot be empty.');
-    }
+    }
-    this.props.lastName = lastName.trim();
+    this.props.lastName = lastName.trim();
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  updateProfile(firstName: string, lastName: string, phoneNumber?: string): void {
+  updateProfile(firstName: string, lastName: string, phoneNumber?: string): void {
-    if (!firstName || firstName.trim().length === 0) {
+    if (!firstName || firstName.trim().length === 0) {
-      throw new Error('First name cannot be empty.');
+      throw new Error('First name cannot be empty.');
-    }
+    }
-    if (!lastName || lastName.trim().length === 0) {
+    if (!lastName || lastName.trim().length === 0) {
-      throw new Error('Last name cannot be empty.');
+      throw new Error('Last name cannot be empty.');
-    }
+    }
-
+
-    this.props.firstName = firstName.trim();
+    this.props.firstName = firstName.trim();
-    this.props.lastName = lastName.trim();
+    this.props.lastName = lastName.trim();
-    this.props.phoneNumber = phoneNumber;
+    this.props.phoneNumber = phoneNumber;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  verifyEmail(): void {
+  verifyEmail(): void {
-    this.props.isEmailVerified = true;
+    this.props.isEmailVerified = true;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  enable2FA(totpSecret: string): void {
+  enable2FA(totpSecret: string): void {
-    this.props.totpSecret = totpSecret;
+    this.props.totpSecret = totpSecret;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  disable2FA(): void {
+  disable2FA(): void {
-    this.props.totpSecret = undefined;
+    this.props.totpSecret = undefined;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  recordLogin(): void {
+  recordLogin(): void {
-    this.props.lastLoginAt = new Date();
+    this.props.lastLoginAt = new Date();
-  }
+  }
-
+
-  deactivate(): void {
+  deactivate(): void {
-    this.props.isActive = false;
+    this.props.isActive = false;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  activate(): void {
+  activate(): void {
-    this.props.isActive = true;
+    this.props.isActive = true;
-    this.props.updatedAt = new Date();
+    this.props.updatedAt = new Date();
-  }
+  }
-
+
-  /**
+  /**
-   * Convert to plain object for persistence
+   * Convert to plain object for persistence
-   */
+   */
-  toObject(): UserProps {
+  toObject(): UserProps {
-    return { ...this.props };
+    return { ...this.props };
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/carrier-timeout.exception.ts

@@ -1,16 +1,16 @@
-/**
+/**
- * CarrierTimeoutException
+ * CarrierTimeoutException
- *
+ *
- * Thrown when a carrier API call times out
+ * Thrown when a carrier API call times out
- */
+ */
-
+
-export class CarrierTimeoutException extends Error {
+export class CarrierTimeoutException extends Error {
-  constructor(
+  constructor(
-    public readonly carrierName: string,
+    public readonly carrierName: string,
-    public readonly timeoutMs: number
+    public readonly timeoutMs: number
-  ) {
+  ) {
-    super(`Carrier ${carrierName} timed out after ${timeoutMs}ms`);
+    super(`Carrier ${carrierName} timed out after ${timeoutMs}ms`);
-    this.name = 'CarrierTimeoutException';
+    this.name = 'CarrierTimeoutException';
-    Object.setPrototypeOf(this, CarrierTimeoutException.prototype);
+    Object.setPrototypeOf(this, CarrierTimeoutException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/carrier-unavailable.exception.ts

@@ -1,16 +1,16 @@
-/**
+/**
- * CarrierUnavailableException
+ * CarrierUnavailableException
- *
+ *
- * Thrown when a carrier is unavailable or not responding
+ * Thrown when a carrier is unavailable or not responding
- */
+ */
-
+
-export class CarrierUnavailableException extends Error {
+export class CarrierUnavailableException extends Error {
-  constructor(
+  constructor(
-    public readonly carrierName: string,
+    public readonly carrierName: string,
-    public readonly reason?: string
+    public readonly reason?: string
-  ) {
+  ) {
-    super(`Carrier ${carrierName} is unavailable${reason ? `: ${reason}` : ''}`);
+    super(`Carrier ${carrierName} is unavailable${reason ? `: ${reason}` : ''}`);
-    this.name = 'CarrierUnavailableException';
+    this.name = 'CarrierUnavailableException';
-    Object.setPrototypeOf(this, CarrierUnavailableException.prototype);
+    Object.setPrototypeOf(this, CarrierUnavailableException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/index.ts

@@ -1,12 +1,12 @@
-/**
+/**
- * Domain Exceptions Barrel Export
+ * Domain Exceptions Barrel Export
- *
+ *
- * All domain exceptions for the Xpeditis platform
+ * All domain exceptions for the Xpeditis platform
- */
+ */
-
+
-export * from './invalid-port-code.exception';
+export * from './invalid-port-code.exception';
-export * from './invalid-rate-quote.exception';
+export * from './invalid-rate-quote.exception';
-export * from './carrier-timeout.exception';
+export * from './carrier-timeout.exception';
-export * from './carrier-unavailable.exception';
+export * from './carrier-unavailable.exception';
-export * from './rate-quote-expired.exception';
+export * from './rate-quote-expired.exception';
-export * from './port-not-found.exception';
+export * from './port-not-found.exception';

apps/backend/src/domain/exceptions/invalid-booking-number.exception.ts

@@ -1,6 +1,6 @@
-export class InvalidBookingNumberException extends Error {
+export class InvalidBookingNumberException extends Error {
-  constructor(value: string) {
+  constructor(value: string) {
-    super(`Invalid booking number format: ${value}. Expected format: WCM-YYYY-XXXXXX`);
+    super(`Invalid booking number format: ${value}. Expected format: WCM-YYYY-XXXXXX`);
-    this.name = 'InvalidBookingNumberException';
+    this.name = 'InvalidBookingNumberException';
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/invalid-booking-status.exception.ts

@@ -1,8 +1,8 @@
-export class InvalidBookingStatusException extends Error {
+export class InvalidBookingStatusException extends Error {
-  constructor(value: string) {
+  constructor(value: string) {
-    super(
+    super(
-      `Invalid booking status: ${value}. Valid statuses: draft, pending_confirmation, confirmed, in_transit, delivered, cancelled`
+      `Invalid booking status: ${value}. Valid statuses: draft, pending_confirmation, confirmed, in_transit, delivered, cancelled`
-    );
+    );
-    this.name = 'InvalidBookingStatusException';
+    this.name = 'InvalidBookingStatusException';
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/invalid-port-code.exception.ts

@@ -1,13 +1,13 @@
-/**
+/**
- * InvalidPortCodeException
+ * InvalidPortCodeException
- *
+ *
- * Thrown when a port code is invalid or not found
+ * Thrown when a port code is invalid or not found
- */
+ */
-
+
-export class InvalidPortCodeException extends Error {
+export class InvalidPortCodeException extends Error {
-  constructor(portCode: string, message?: string) {
+  constructor(portCode: string, message?: string) {
-    super(message || `Invalid port code: ${portCode}`);
+    super(message || `Invalid port code: ${portCode}`);
-    this.name = 'InvalidPortCodeException';
+    this.name = 'InvalidPortCodeException';
-    Object.setPrototypeOf(this, InvalidPortCodeException.prototype);
+    Object.setPrototypeOf(this, InvalidPortCodeException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/invalid-rate-quote.exception.ts

@@ -1,13 +1,13 @@
-/**
+/**
- * InvalidRateQuoteException
+ * InvalidRateQuoteException
- *
+ *
- * Thrown when a rate quote is invalid or malformed
+ * Thrown when a rate quote is invalid or malformed
- */
+ */
-
+
-export class InvalidRateQuoteException extends Error {
+export class InvalidRateQuoteException extends Error {
-  constructor(message: string) {
+  constructor(message: string) {
-    super(message);
+    super(message);
-    this.name = 'InvalidRateQuoteException';
+    this.name = 'InvalidRateQuoteException';
-    Object.setPrototypeOf(this, InvalidRateQuoteException.prototype);
+    Object.setPrototypeOf(this, InvalidRateQuoteException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/port-not-found.exception.ts

@@ -1,13 +1,13 @@
-/**
+/**
- * PortNotFoundException
+ * PortNotFoundException
- *
+ *
- * Thrown when a port is not found in the database
+ * Thrown when a port is not found in the database
- */
+ */
-
+
-export class PortNotFoundException extends Error {
+export class PortNotFoundException extends Error {
-  constructor(public readonly portCode: string) {
+  constructor(public readonly portCode: string) {
-    super(`Port not found: ${portCode}`);
+    super(`Port not found: ${portCode}`);
-    this.name = 'PortNotFoundException';
+    this.name = 'PortNotFoundException';
-    Object.setPrototypeOf(this, PortNotFoundException.prototype);
+    Object.setPrototypeOf(this, PortNotFoundException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/exceptions/rate-quote-expired.exception.ts

@@ -1,16 +1,16 @@
-/**
+/**
- * RateQuoteExpiredException
+ * RateQuoteExpiredException
- *
+ *
- * Thrown when attempting to use an expired rate quote
+ * Thrown when attempting to use an expired rate quote
- */
+ */
-
+
-export class RateQuoteExpiredException extends Error {
+export class RateQuoteExpiredException extends Error {
-  constructor(
+  constructor(
-    public readonly rateQuoteId: string,
+    public readonly rateQuoteId: string,
-    public readonly expiredAt: Date
+    public readonly expiredAt: Date
-  ) {
+  ) {
-    super(`Rate quote ${rateQuoteId} expired at ${expiredAt.toISOString()}`);
+    super(`Rate quote ${rateQuoteId} expired at ${expiredAt.toISOString()}`);
-    this.name = 'RateQuoteExpiredException';
+    this.name = 'RateQuoteExpiredException';
-    Object.setPrototypeOf(this, RateQuoteExpiredException.prototype);
+    Object.setPrototypeOf(this, RateQuoteExpiredException.prototype);
-  }
+  }
-}
+}

apps/backend/src/domain/ports/in/get-ports.port.ts

@@ -1,45 +1,45 @@
-/**
+/**
- * GetPortsPort (API Port - Input)
+ * GetPortsPort (API Port - Input)
- *
+ *
- * Defines the interface for port autocomplete and retrieval
+ * Defines the interface for port autocomplete and retrieval
- */
+ */
-
+
-import { Port } from '../../entities/port.entity';
+import { Port } from '../../entities/port.entity';
-
+
-export interface PortSearchInput {
+export interface PortSearchInput {
-  query: string; // Search query (port name, city, or code)
+  query: string; // Search query (port name, city, or code)
-  limit?: number; // Max results (default: 10)
+  limit?: number; // Max results (default: 10)
-  countryFilter?: string; // ISO country code filter
+  countryFilter?: string; // ISO country code filter
-}
+}
-
+
-export interface PortSearchOutput {
+export interface PortSearchOutput {
-  ports: Port[];
+  ports: Port[];
-  totalMatches: number;
+  totalMatches: number;
-}
+}
-
+
-export interface GetPortInput {
+export interface GetPortInput {
-  portCode: string; // UN/LOCODE
+  portCode: string; // UN/LOCODE
-}
+}
-
+
-export interface GetPortsPort {
+export interface GetPortsPort {
-  /**
+  /**
-   * Search ports by query (autocomplete)
+   * Search ports by query (autocomplete)
-   * @param input - Port search parameters
+   * @param input - Port search parameters
-   * @returns Matching ports
+   * @returns Matching ports
-   */
+   */
-  search(input: PortSearchInput): Promise<PortSearchOutput>;
+  search(input: PortSearchInput): Promise<PortSearchOutput>;
-
+
-  /**
+  /**
-   * Get port by code
+   * Get port by code
-   * @param input - Port code
+   * @param input - Port code
-   * @returns Port entity
+   * @returns Port entity
-   */
+   */
-  getByCode(input: GetPortInput): Promise<Port>;
+  getByCode(input: GetPortInput): Promise<Port>;
-
+
-  /**
+  /**
-   * Get multiple ports by codes
+   * Get multiple ports by codes
-   * @param portCodes - Array of port codes
+   * @param portCodes - Array of port codes
-   * @returns Array of ports
+   * @returns Array of ports
-   */
+   */
-  getByCodes(portCodes: string[]): Promise<Port[]>;
+  getByCodes(portCodes: string[]): Promise<Port[]>;
-}
+}

apps/backend/src/domain/ports/in/index.ts

@@ -1,9 +1,9 @@
-/**
+/**
- * API Ports (Input) Barrel Export
+ * API Ports (Input) Barrel Export
- *
+ *
- * All input ports (use case interfaces) for the Xpeditis platform
+ * All input ports (use case interfaces) for the Xpeditis platform
- */
+ */
-
+
-export * from './search-rates.port';
+export * from './search-rates.port';
-export * from './get-ports.port';
+export * from './get-ports.port';
-export * from './validate-availability.port';
+export * from './validate-availability.port';

apps/backend/src/domain/ports/in/search-rates.port.ts

@@ -1,44 +1,44 @@
-/**
+/**
- * SearchRatesPort (API Port - Input)
+ * SearchRatesPort (API Port - Input)
- *
+ *
- * Defines the interface for searching shipping rates
+ * Defines the interface for searching shipping rates
- * This is the entry point for the rate search use case
+ * This is the entry point for the rate search use case
- */
+ */
-
+
-import { RateQuote } from '../../entities/rate-quote.entity';
+import { RateQuote } from '../../entities/rate-quote.entity';
-
+
-export interface RateSearchInput {
+export interface RateSearchInput {
-  origin: string; // Port code (UN/LOCODE)
+  origin: string; // Port code (UN/LOCODE)
-  destination: string; // Port code (UN/LOCODE)
+  destination: string; // Port code (UN/LOCODE)
-  containerType: string; // e.g., '20DRY', '40HC'
+  containerType: string; // e.g., '20DRY', '40HC'
-  mode: 'FCL' | 'LCL';
+  mode: 'FCL' | 'LCL';
-  departureDate: Date;
+  departureDate: Date;
-  quantity?: number; // Number of containers (default: 1)
+  quantity?: number; // Number of containers (default: 1)
-  weight?: number; // For LCL (kg)
+  weight?: number; // For LCL (kg)
-  volume?: number; // For LCL (CBM)
+  volume?: number; // For LCL (CBM)
-  isHazmat?: boolean;
+  isHazmat?: boolean;
-  imoClass?: string; // If hazmat
+  imoClass?: string; // If hazmat
-  carrierPreferences?: string[]; // Specific carrier codes to query
+  carrierPreferences?: string[]; // Specific carrier codes to query
-}
+}
-
+
-export interface RateSearchOutput {
+export interface RateSearchOutput {
-  quotes: RateQuote[];
+  quotes: RateQuote[];
-  searchId: string;
+  searchId: string;
-  searchedAt: Date;
+  searchedAt: Date;
-  totalResults: number;
+  totalResults: number;
-  carrierResults: {
+  carrierResults: {
-    carrierName: string;
+    carrierName: string;
-    status: 'success' | 'error' | 'timeout';
+    status: 'success' | 'error' | 'timeout';
-    resultCount: number;
+    resultCount: number;
-    errorMessage?: string;
+    errorMessage?: string;
-  }[];
+  }[];
-}
+}
-
+
-export interface SearchRatesPort {
+export interface SearchRatesPort {
-  /**
+  /**
-   * Execute rate search across multiple carriers
+   * Execute rate search across multiple carriers
-   * @param input - Rate search parameters
+   * @param input - Rate search parameters
-   * @returns Rate quotes from available carriers
+   * @returns Rate quotes from available carriers
-   */
+   */
-  execute(input: RateSearchInput): Promise<RateSearchOutput>;
+  execute(input: RateSearchInput): Promise<RateSearchOutput>;
-}
+}

apps/backend/src/domain/ports/in/validate-availability.port.ts

@@ -1,27 +1,27 @@
-/**
+/**
- * ValidateAvailabilityPort (API Port - Input)
+ * ValidateAvailabilityPort (API Port - Input)
- *
+ *
- * Defines the interface for validating container availability
+ * Defines the interface for validating container availability
- */
+ */
-
+
-export interface AvailabilityInput {
+export interface AvailabilityInput {
-  rateQuoteId: string;
+  rateQuoteId: string;
-  quantity: number; // Number of containers requested
+  quantity: number; // Number of containers requested
-}
+}
-
+
-export interface AvailabilityOutput {
+export interface AvailabilityOutput {
-  isAvailable: boolean;
+  isAvailable: boolean;
-  availableQuantity: number;
+  availableQuantity: number;
-  requestedQuantity: number;
+  requestedQuantity: number;
-  rateQuoteId: string;
+  rateQuoteId: string;
-  validUntil: Date;
+  validUntil: Date;
-}
+}
-
+
-export interface ValidateAvailabilityPort {
+export interface ValidateAvailabilityPort {
-  /**
+  /**
-   * Validate if containers are available for a rate quote
+   * Validate if containers are available for a rate quote
-   * @param input - Availability check parameters
+   * @param input - Availability check parameters
-   * @returns Availability status
+   * @returns Availability status
-   */
+   */
-  execute(input: AvailabilityInput): Promise<AvailabilityOutput>;
+  execute(input: AvailabilityInput): Promise<AvailabilityOutput>;
-}
+}

apps/backend/src/domain/services/availability-validation.service.ts

@@ -1,48 +1,48 @@
-/**
+/**
- * AvailabilityValidationService
+ * AvailabilityValidationService
- *
+ *
- * Domain service for validating container availability
+ * Domain service for validating container availability
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Check if rate quote is still valid (not expired)
+ * - Check if rate quote is still valid (not expired)
- * - Verify requested quantity is available
+ * - Verify requested quantity is available
- */
+ */
-
+
-import {
+import {
-  ValidateAvailabilityPort,
+  ValidateAvailabilityPort,
-  AvailabilityInput,
+  AvailabilityInput,
-  AvailabilityOutput,
+  AvailabilityOutput,
-} from '../ports/in/validate-availability.port';
+} from '../ports/in/validate-availability.port';
-import { RateQuoteRepository } from '../ports/out/rate-quote.repository';
+import { RateQuoteRepository } from '../ports/out/rate-quote.repository';
-import { InvalidRateQuoteException } from '../exceptions/invalid-rate-quote.exception';
+import { InvalidRateQuoteException } from '../exceptions/invalid-rate-quote.exception';
-import { RateQuoteExpiredException } from '../exceptions/rate-quote-expired.exception';
+import { RateQuoteExpiredException } from '../exceptions/rate-quote-expired.exception';
-
+
-export class AvailabilityValidationService implements ValidateAvailabilityPort {
+export class AvailabilityValidationService implements ValidateAvailabilityPort {
-  constructor(private readonly rateQuoteRepository: RateQuoteRepository) {}
+  constructor(private readonly rateQuoteRepository: RateQuoteRepository) {}
-
+
-  async execute(input: AvailabilityInput): Promise<AvailabilityOutput> {
+  async execute(input: AvailabilityInput): Promise<AvailabilityOutput> {
-    // Find rate quote
+    // Find rate quote
-    const rateQuote = await this.rateQuoteRepository.findById(input.rateQuoteId);
+    const rateQuote = await this.rateQuoteRepository.findById(input.rateQuoteId);
-
+
-    if (!rateQuote) {
+    if (!rateQuote) {
-      throw new InvalidRateQuoteException(`Rate quote not found: ${input.rateQuoteId}`);
+      throw new InvalidRateQuoteException(`Rate quote not found: ${input.rateQuoteId}`);
-    }
+    }
-
+
-    // Check if rate quote has expired
+    // Check if rate quote has expired
-    if (rateQuote.isExpired()) {
+    if (rateQuote.isExpired()) {
-      throw new RateQuoteExpiredException(rateQuote.id, rateQuote.validUntil);
+      throw new RateQuoteExpiredException(rateQuote.id, rateQuote.validUntil);
-    }
+    }
-
+
-    // Check availability
+    // Check availability
-    const availableQuantity = rateQuote.availability;
+    const availableQuantity = rateQuote.availability;
-    const isAvailable = availableQuantity >= input.quantity;
+    const isAvailable = availableQuantity >= input.quantity;
-
+
-    return {
+    return {
-      isAvailable,
+      isAvailable,
-      availableQuantity,
+      availableQuantity,
-      requestedQuantity: input.quantity,
+      requestedQuantity: input.quantity,
-      rateQuoteId: rateQuote.id,
+      rateQuoteId: rateQuote.id,
-      validUntil: rateQuote.validUntil,
+      validUntil: rateQuote.validUntil,
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/services/index.ts

@@ -1,10 +1,10 @@
-/**
+/**
- * Domain Services Barrel Export
+ * Domain Services Barrel Export
- *
+ *
- * All domain services for the Xpeditis platform
+ * All domain services for the Xpeditis platform
- */
+ */
-
+
-export * from './rate-search.service';
+export * from './rate-search.service';
-export * from './port-search.service';
+export * from './port-search.service';
-export * from './availability-validation.service';
+export * from './availability-validation.service';
-export * from './booking.service';
+export * from './booking.service';

apps/backend/src/domain/services/port-search.service.ts

@@ -1,65 +1,65 @@
-/**
+/**
- * PortSearchService
+ * PortSearchService
- *
+ *
- * Domain service for port search and autocomplete
+ * Domain service for port search and autocomplete
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Fuzzy search on port name, city, and code
+ * - Fuzzy search on port name, city, and code
- * - Return top 10 results by default
+ * - Return top 10 results by default
- * - Support country filtering
+ * - Support country filtering
- */
+ */
-
+
-import { Port } from '../entities/port.entity';
+import { Port } from '../entities/port.entity';
-import { GetPortsPort, PortSearchInput, PortSearchOutput, GetPortInput } from '../ports/in/get-ports.port';
+import { GetPortsPort, PortSearchInput, PortSearchOutput, GetPortInput } from '../ports/in/get-ports.port';
-import { PortRepository } from '../ports/out/port.repository';
+import { PortRepository } from '../ports/out/port.repository';
-import { PortNotFoundException } from '../exceptions/port-not-found.exception';
+import { PortNotFoundException } from '../exceptions/port-not-found.exception';
-
+
-export class PortSearchService implements GetPortsPort {
+export class PortSearchService implements GetPortsPort {
-  private static readonly DEFAULT_LIMIT = 10;
+  private static readonly DEFAULT_LIMIT = 10;
-
+
-  constructor(private readonly portRepository: PortRepository) {}
+  constructor(private readonly portRepository: PortRepository) {}
-
+
-  async search(input: PortSearchInput): Promise<PortSearchOutput> {
+  async search(input: PortSearchInput): Promise<PortSearchOutput> {
-    const limit = input.limit || PortSearchService.DEFAULT_LIMIT;
+    const limit = input.limit || PortSearchService.DEFAULT_LIMIT;
-    const query = input.query.trim();
+    const query = input.query.trim();
-
+
-    if (query.length === 0) {
+    if (query.length === 0) {
-      return {
+      return {
-        ports: [],
+        ports: [],
-        totalMatches: 0,
+        totalMatches: 0,
-      };
+      };
-    }
+    }
-
+
-    // Search using repository fuzzy search
+    // Search using repository fuzzy search
-    const ports = await this.portRepository.search(query, limit, input.countryFilter);
+    const ports = await this.portRepository.search(query, limit, input.countryFilter);
-
+
-    return {
+    return {
-      ports,
+      ports,
-      totalMatches: ports.length,
+      totalMatches: ports.length,
-    };
+    };
-  }
+  }
-
+
-  async getByCode(input: GetPortInput): Promise<Port> {
+  async getByCode(input: GetPortInput): Promise<Port> {
-    const port = await this.portRepository.findByCode(input.portCode);
+    const port = await this.portRepository.findByCode(input.portCode);
-
+
-    if (!port) {
+    if (!port) {
-      throw new PortNotFoundException(input.portCode);
+      throw new PortNotFoundException(input.portCode);
-    }
+    }
-
+
-    return port;
+    return port;
-  }
+  }
-
+
-  async getByCodes(portCodes: string[]): Promise<Port[]> {
+  async getByCodes(portCodes: string[]): Promise<Port[]> {
-    const ports = await this.portRepository.findByCodes(portCodes);
+    const ports = await this.portRepository.findByCodes(portCodes);
-
+
-    // Check if all ports were found
+    // Check if all ports were found
-    const foundCodes = ports.map((p) => p.code);
+    const foundCodes = ports.map((p) => p.code);
-    const missingCodes = portCodes.filter((code) => !foundCodes.includes(code));
+    const missingCodes = portCodes.filter((code) => !foundCodes.includes(code));
-
+
-    if (missingCodes.length > 0) {
+    if (missingCodes.length > 0) {
-      throw new PortNotFoundException(missingCodes[0]);
+      throw new PortNotFoundException(missingCodes[0]);
-    }
+    }
-
+
-    return ports;
+    return ports;
-  }
+  }
-}
+}

apps/backend/src/domain/services/rate-search.service.ts

@@ -1,165 +1,165 @@
-/**
+/**
- * RateSearchService
+ * RateSearchService
- *
+ *
- * Domain service implementing the rate search business logic
+ * Domain service implementing the rate search business logic
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Query multiple carriers in parallel
+ * - Query multiple carriers in parallel
- * - Cache results for 15 minutes
+ * - Cache results for 15 minutes
- * - Handle carrier timeouts gracefully (5s max)
+ * - Handle carrier timeouts gracefully (5s max)
- * - Return results even if some carriers fail
+ * - Return results even if some carriers fail
- */
+ */
-
+
-import { RateQuote } from '../entities/rate-quote.entity';
+import { RateQuote } from '../entities/rate-quote.entity';
-import { SearchRatesPort, RateSearchInput, RateSearchOutput } from '../ports/in/search-rates.port';
+import { SearchRatesPort, RateSearchInput, RateSearchOutput } from '../ports/in/search-rates.port';
-import { CarrierConnectorPort } from '../ports/out/carrier-connector.port';
+import { CarrierConnectorPort } from '../ports/out/carrier-connector.port';
-import { CachePort } from '../ports/out/cache.port';
+import { CachePort } from '../ports/out/cache.port';
-import { RateQuoteRepository } from '../ports/out/rate-quote.repository';
+import { RateQuoteRepository } from '../ports/out/rate-quote.repository';
-import { PortRepository } from '../ports/out/port.repository';
+import { PortRepository } from '../ports/out/port.repository';
-import { CarrierRepository } from '../ports/out/carrier.repository';
+import { CarrierRepository } from '../ports/out/carrier.repository';
-import { PortNotFoundException } from '../exceptions/port-not-found.exception';
+import { PortNotFoundException } from '../exceptions/port-not-found.exception';
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4 } from 'uuid';
-
+
-export class RateSearchService implements SearchRatesPort {
+export class RateSearchService implements SearchRatesPort {
-  private static readonly CACHE_TTL_SECONDS = 15 * 60; // 15 minutes
+  private static readonly CACHE_TTL_SECONDS = 15 * 60; // 15 minutes
-
+
-  constructor(
+  constructor(
-    private readonly carrierConnectors: CarrierConnectorPort[],
+    private readonly carrierConnectors: CarrierConnectorPort[],
-    private readonly cache: CachePort,
+    private readonly cache: CachePort,
-    private readonly rateQuoteRepository: RateQuoteRepository,
+    private readonly rateQuoteRepository: RateQuoteRepository,
-    private readonly portRepository: PortRepository,
+    private readonly portRepository: PortRepository,
-    private readonly carrierRepository: CarrierRepository
+    private readonly carrierRepository: CarrierRepository
-  ) {}
+  ) {}
-
+
-  async execute(input: RateSearchInput): Promise<RateSearchOutput> {
+  async execute(input: RateSearchInput): Promise<RateSearchOutput> {
-    const searchId = uuidv4();
+    const searchId = uuidv4();
-    const searchedAt = new Date();
+    const searchedAt = new Date();
-
+
-    // Validate ports exist
+    // Validate ports exist
-    await this.validatePorts(input.origin, input.destination);
+    await this.validatePorts(input.origin, input.destination);
-
+
-    // Generate cache key
+    // Generate cache key
-    const cacheKey = this.generateCacheKey(input);
+    const cacheKey = this.generateCacheKey(input);
-
+
-    // Check cache first
+    // Check cache first
-    const cachedResults = await this.cache.get<RateSearchOutput>(cacheKey);
+    const cachedResults = await this.cache.get<RateSearchOutput>(cacheKey);
-    if (cachedResults) {
+    if (cachedResults) {
-      return cachedResults;
+      return cachedResults;
-    }
+    }
-
+
-    // Filter carriers if preferences specified
+    // Filter carriers if preferences specified
-    const connectorsToQuery = this.filterCarrierConnectors(input.carrierPreferences);
+    const connectorsToQuery = this.filterCarrierConnectors(input.carrierPreferences);
-
+
-    // Query all carriers in parallel with Promise.allSettled
+    // Query all carriers in parallel with Promise.allSettled
-    const carrierResults = await Promise.allSettled(
+    const carrierResults = await Promise.allSettled(
-      connectorsToQuery.map((connector) => this.queryCarrier(connector, input))
+      connectorsToQuery.map((connector) => this.queryCarrier(connector, input))
-    );
+    );
-
+
-    // Process results
+    // Process results
-    const quotes: RateQuote[] = [];
+    const quotes: RateQuote[] = [];
-    const carrierResultsSummary: RateSearchOutput['carrierResults'] = [];
+    const carrierResultsSummary: RateSearchOutput['carrierResults'] = [];
-
+
-    for (let i = 0; i < carrierResults.length; i++) {
+    for (let i = 0; i < carrierResults.length; i++) {
-      const result = carrierResults[i];
+      const result = carrierResults[i];
-      const connector = connectorsToQuery[i];
+      const connector = connectorsToQuery[i];
-      const carrierName = connector.getCarrierName();
+      const carrierName = connector.getCarrierName();
-
+
-      if (result.status === 'fulfilled') {
+      if (result.status === 'fulfilled') {
-        const carrierQuotes = result.value;
+        const carrierQuotes = result.value;
-        quotes.push(...carrierQuotes);
+        quotes.push(...carrierQuotes);
-
+
-        carrierResultsSummary.push({
+        carrierResultsSummary.push({
-          carrierName,
+          carrierName,
-          status: 'success',
+          status: 'success',
-          resultCount: carrierQuotes.length,
+          resultCount: carrierQuotes.length,
-        });
+        });
-      } else {
+      } else {
-        // Handle error
+        // Handle error
-        const error = result.reason;
+        const error = result.reason;
-        carrierResultsSummary.push({
+        carrierResultsSummary.push({
-          carrierName,
+          carrierName,
-          status: error.name === 'CarrierTimeoutException' ? 'timeout' : 'error',
+          status: error.name === 'CarrierTimeoutException' ? 'timeout' : 'error',
-          resultCount: 0,
+          resultCount: 0,
-          errorMessage: error.message,
+          errorMessage: error.message,
-        });
+        });
-      }
+      }
-    }
+    }
-
+
-    // Save rate quotes to database
+    // Save rate quotes to database
-    if (quotes.length > 0) {
+    if (quotes.length > 0) {
-      await this.rateQuoteRepository.saveMany(quotes);
+      await this.rateQuoteRepository.saveMany(quotes);
-    }
+    }
-
+
-    // Build output
+    // Build output
-    const output: RateSearchOutput = {
+    const output: RateSearchOutput = {
-      quotes,
+      quotes,
-      searchId,
+      searchId,
-      searchedAt,
+      searchedAt,
-      totalResults: quotes.length,
+      totalResults: quotes.length,
-      carrierResults: carrierResultsSummary,
+      carrierResults: carrierResultsSummary,
-    };
+    };
-
+
-    // Cache results
+    // Cache results
-    await this.cache.set(cacheKey, output, RateSearchService.CACHE_TTL_SECONDS);
+    await this.cache.set(cacheKey, output, RateSearchService.CACHE_TTL_SECONDS);
-
+
-    return output;
+    return output;
-  }
+  }
-
+
-  private async validatePorts(originCode: string, destinationCode: string): Promise<void> {
+  private async validatePorts(originCode: string, destinationCode: string): Promise<void> {
-    const [origin, destination] = await Promise.all([
+    const [origin, destination] = await Promise.all([
-      this.portRepository.findByCode(originCode),
+      this.portRepository.findByCode(originCode),
-      this.portRepository.findByCode(destinationCode),
+      this.portRepository.findByCode(destinationCode),
-    ]);
+    ]);
-
+
-    if (!origin) {
+    if (!origin) {
-      throw new PortNotFoundException(originCode);
+      throw new PortNotFoundException(originCode);
-    }
+    }
-
+
-    if (!destination) {
+    if (!destination) {
-      throw new PortNotFoundException(destinationCode);
+      throw new PortNotFoundException(destinationCode);
-    }
+    }
-  }
+  }
-
+
-  private generateCacheKey(input: RateSearchInput): string {
+  private generateCacheKey(input: RateSearchInput): string {
-    const parts = [
+    const parts = [
-      'rate-search',
+      'rate-search',
-      input.origin,
+      input.origin,
-      input.destination,
+      input.destination,
-      input.containerType,
+      input.containerType,
-      input.mode,
+      input.mode,
-      input.departureDate.toISOString().split('T')[0],
+      input.departureDate.toISOString().split('T')[0],
-      input.quantity || 1,
+      input.quantity || 1,
-      input.isHazmat ? 'hazmat' : 'standard',
+      input.isHazmat ? 'hazmat' : 'standard',
-    ];
+    ];
-
+
-    return parts.join(':');
+    return parts.join(':');
-  }
+  }
-
+
-  private filterCarrierConnectors(carrierPreferences?: string[]): CarrierConnectorPort[] {
+  private filterCarrierConnectors(carrierPreferences?: string[]): CarrierConnectorPort[] {
-    if (!carrierPreferences || carrierPreferences.length === 0) {
+    if (!carrierPreferences || carrierPreferences.length === 0) {
-      return this.carrierConnectors;
+      return this.carrierConnectors;
-    }
+    }
-
+
-    return this.carrierConnectors.filter((connector) =>
+    return this.carrierConnectors.filter((connector) =>
-      carrierPreferences.includes(connector.getCarrierCode())
+      carrierPreferences.includes(connector.getCarrierCode())
-    );
+    );
-  }
+  }
-
+
-  private async queryCarrier(
+  private async queryCarrier(
-    connector: CarrierConnectorPort,
+    connector: CarrierConnectorPort,
-    input: RateSearchInput
+    input: RateSearchInput
-  ): Promise<RateQuote[]> {
+  ): Promise<RateQuote[]> {
-    return connector.searchRates({
+    return connector.searchRates({
-      origin: input.origin,
+      origin: input.origin,
-      destination: input.destination,
+      destination: input.destination,
-      containerType: input.containerType,
+      containerType: input.containerType,
-      mode: input.mode,
+      mode: input.mode,
-      departureDate: input.departureDate,
+      departureDate: input.departureDate,
-      quantity: input.quantity,
+      quantity: input.quantity,
-      weight: input.weight,
+      weight: input.weight,
-      volume: input.volume,
+      volume: input.volume,
-      isHazmat: input.isHazmat,
+      isHazmat: input.isHazmat,
-      imoClass: input.imoClass,
+      imoClass: input.imoClass,
-    });
+    });
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/booking-number.vo.ts

@@ -1,77 +1,77 @@
-/**
+/**
- * BookingNumber Value Object
+ * BookingNumber Value Object
- *
+ *
- * Represents a unique booking reference number
+ * Represents a unique booking reference number
- * Format: WCM-YYYY-XXXXXX (e.g., WCM-2025-ABC123)
+ * Format: WCM-YYYY-XXXXXX (e.g., WCM-2025-ABC123)
- * - WCM: WebCargo Maritime prefix
+ * - WCM: WebCargo Maritime prefix
- * - YYYY: Current year
+ * - YYYY: Current year
- * - XXXXXX: 6 alphanumeric characters
+ * - XXXXXX: 6 alphanumeric characters
- */
+ */
-
+
-import { InvalidBookingNumberException } from '../exceptions/invalid-booking-number.exception';
+import { InvalidBookingNumberException } from '../exceptions/invalid-booking-number.exception';
-
+
-export class BookingNumber {
+export class BookingNumber {
-  private readonly _value: string;
+  private readonly _value: string;
-
+
-  private constructor(value: string) {
+  private constructor(value: string) {
-    this._value = value;
+    this._value = value;
-  }
+  }
-
+
-  get value(): string {
+  get value(): string {
-    return this._value;
+    return this._value;
-  }
+  }
-
+
-  /**
+  /**
-   * Generate a new booking number
+   * Generate a new booking number
-   */
+   */
-  static generate(): BookingNumber {
+  static generate(): BookingNumber {
-    const year = new Date().getFullYear();
+    const year = new Date().getFullYear();
-    const random = BookingNumber.generateRandomString(6);
+    const random = BookingNumber.generateRandomString(6);
-    const value = `WCM-${year}-${random}`;
+    const value = `WCM-${year}-${random}`;
-    return new BookingNumber(value);
+    return new BookingNumber(value);
-  }
+  }
-
+
-  /**
+  /**
-   * Create BookingNumber from string
+   * Create BookingNumber from string
-   */
+   */
-  static fromString(value: string): BookingNumber {
+  static fromString(value: string): BookingNumber {
-    if (!BookingNumber.isValid(value)) {
+    if (!BookingNumber.isValid(value)) {
-      throw new InvalidBookingNumberException(value);
+      throw new InvalidBookingNumberException(value);
-    }
+    }
-    return new BookingNumber(value);
+    return new BookingNumber(value);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate booking number format
+   * Validate booking number format
-   */
+   */
-  static isValid(value: string): boolean {
+  static isValid(value: string): boolean {
-    const pattern = /^WCM-\d{4}-[A-Z0-9]{6}$/;
+    const pattern = /^WCM-\d{4}-[A-Z0-9]{6}$/;
-    return pattern.test(value);
+    return pattern.test(value);
-  }
+  }
-
+
-  /**
+  /**
-   * Generate random alphanumeric string
+   * Generate random alphanumeric string
-   */
+   */
-  private static generateRandomString(length: number): string {
+  private static generateRandomString(length: number): string {
-    const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'; // Exclude ambiguous chars: 0,O,1,I
+    const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'; // Exclude ambiguous chars: 0,O,1,I
-    let result = '';
+    let result = '';
-    for (let i = 0; i < length; i++) {
+    for (let i = 0; i < length; i++) {
-      result += chars.charAt(Math.floor(Math.random() * chars.length));
+      result += chars.charAt(Math.floor(Math.random() * chars.length));
-    }
+    }
-    return result;
+    return result;
-  }
+  }
-
+
-  /**
+  /**
-   * Equality check
+   * Equality check
-   */
+   */
-  equals(other: BookingNumber): boolean {
+  equals(other: BookingNumber): boolean {
-    return this._value === other._value;
+    return this._value === other._value;
-  }
+  }
-
+
-  /**
+  /**
-   * String representation
+   * String representation
-   */
+   */
-  toString(): string {
+  toString(): string {
-    return this._value;
+    return this._value;
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/booking-status.vo.ts

@@ -1,110 +1,110 @@
-/**
+/**
- * BookingStatus Value Object
+ * BookingStatus Value Object
- *
+ *
- * Represents the current status of a booking
+ * Represents the current status of a booking
- */
+ */
-
+
-import { InvalidBookingStatusException } from '../exceptions/invalid-booking-status.exception';
+import { InvalidBookingStatusException } from '../exceptions/invalid-booking-status.exception';
-
+
-export type BookingStatusValue =
+export type BookingStatusValue =
-  | 'draft'
+  | 'draft'
-  | 'pending_confirmation'
+  | 'pending_confirmation'
-  | 'confirmed'
+  | 'confirmed'
-  | 'in_transit'
+  | 'in_transit'
-  | 'delivered'
+  | 'delivered'
-  | 'cancelled';
+  | 'cancelled';
-
+
-export class BookingStatus {
+export class BookingStatus {
-  private static readonly VALID_STATUSES: BookingStatusValue[] = [
+  private static readonly VALID_STATUSES: BookingStatusValue[] = [
-    'draft',
+    'draft',
-    'pending_confirmation',
+    'pending_confirmation',
-    'confirmed',
+    'confirmed',
-    'in_transit',
+    'in_transit',
-    'delivered',
+    'delivered',
-    'cancelled',
+    'cancelled',
-  ];
+  ];
-
+
-  private static readonly STATUS_TRANSITIONS: Record<BookingStatusValue, BookingStatusValue[]> = {
+  private static readonly STATUS_TRANSITIONS: Record<BookingStatusValue, BookingStatusValue[]> = {
-    draft: ['pending_confirmation', 'cancelled'],
+    draft: ['pending_confirmation', 'cancelled'],
-    pending_confirmation: ['confirmed', 'cancelled'],
+    pending_confirmation: ['confirmed', 'cancelled'],
-    confirmed: ['in_transit', 'cancelled'],
+    confirmed: ['in_transit', 'cancelled'],
-    in_transit: ['delivered', 'cancelled'],
+    in_transit: ['delivered', 'cancelled'],
-    delivered: [],
+    delivered: [],
-    cancelled: [],
+    cancelled: [],
-  };
+  };
-
+
-  private readonly _value: BookingStatusValue;
+  private readonly _value: BookingStatusValue;
-
+
-  private constructor(value: BookingStatusValue) {
+  private constructor(value: BookingStatusValue) {
-    this._value = value;
+    this._value = value;
-  }
+  }
-
+
-  get value(): BookingStatusValue {
+  get value(): BookingStatusValue {
-    return this._value;
+    return this._value;
-  }
+  }
-
+
-  /**
+  /**
-   * Create BookingStatus from string
+   * Create BookingStatus from string
-   */
+   */
-  static create(value: string): BookingStatus {
+  static create(value: string): BookingStatus {
-    if (!BookingStatus.isValid(value)) {
+    if (!BookingStatus.isValid(value)) {
-      throw new InvalidBookingStatusException(value);
+      throw new InvalidBookingStatusException(value);
-    }
+    }
-    return new BookingStatus(value as BookingStatusValue);
+    return new BookingStatus(value as BookingStatusValue);
-  }
+  }
-
+
-  /**
+  /**
-   * Validate status value
+   * Validate status value
-   */
+   */
-  static isValid(value: string): boolean {
+  static isValid(value: string): boolean {
-    return BookingStatus.VALID_STATUSES.includes(value as BookingStatusValue);
+    return BookingStatus.VALID_STATUSES.includes(value as BookingStatusValue);
-  }
+  }
-
+
-  /**
+  /**
-   * Check if transition to another status is allowed
+   * Check if transition to another status is allowed
-   */
+   */
-  canTransitionTo(newStatus: BookingStatus): boolean {
+  canTransitionTo(newStatus: BookingStatus): boolean {
-    const allowedTransitions = BookingStatus.STATUS_TRANSITIONS[this._value];
+    const allowedTransitions = BookingStatus.STATUS_TRANSITIONS[this._value];
-    return allowedTransitions.includes(newStatus._value);
+    return allowedTransitions.includes(newStatus._value);
-  }
+  }
-
+
-  /**
+  /**
-   * Transition to new status
+   * Transition to new status
-   */
+   */
-  transitionTo(newStatus: BookingStatus): BookingStatus {
+  transitionTo(newStatus: BookingStatus): BookingStatus {
-    if (!this.canTransitionTo(newStatus)) {
+    if (!this.canTransitionTo(newStatus)) {
-      throw new Error(
+      throw new Error(
-        `Invalid status transition from ${this._value} to ${newStatus._value}`
+        `Invalid status transition from ${this._value} to ${newStatus._value}`
-      );
+      );
-    }
+    }
-    return newStatus;
+    return newStatus;
-  }
+  }
-
+
-  /**
+  /**
-   * Check if booking is in a final state
+   * Check if booking is in a final state
-   */
+   */
-  isFinal(): boolean {
+  isFinal(): boolean {
-    return this._value === 'delivered' || this._value === 'cancelled';
+    return this._value === 'delivered' || this._value === 'cancelled';
-  }
+  }
-
+
-  /**
+  /**
-   * Check if booking can be modified
+   * Check if booking can be modified
-   */
+   */
-  canBeModified(): boolean {
+  canBeModified(): boolean {
-    return this._value === 'draft' || this._value === 'pending_confirmation';
+    return this._value === 'draft' || this._value === 'pending_confirmation';
-  }
+  }
-
+
-  /**
+  /**
-   * Equality check
+   * Equality check
-   */
+   */
-  equals(other: BookingStatus): boolean {
+  equals(other: BookingStatus): boolean {
-    return this._value === other._value;
+    return this._value === other._value;
-  }
+  }
-
+
-  /**
+  /**
-   * String representation
+   * String representation
-   */
+   */
-  toString(): string {
+  toString(): string {
-    return this._value;
+    return this._value;
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/container-type.vo.ts

@@ -1,107 +1,107 @@
-/**
+/**
- * ContainerType Value Object
+ * ContainerType Value Object
- *
+ *
- * Encapsulates container type validation and behavior
+ * Encapsulates container type validation and behavior
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Container type must be valid (e.g., 20DRY, 40HC, 40REEFER)
+ * - Container type must be valid (e.g., 20DRY, 40HC, 40REEFER)
- * - Container type is immutable
+ * - Container type is immutable
- *
+ *
- * Format: {SIZE}{HEIGHT_MODIFIER?}{CATEGORY}
+ * Format: {SIZE}{HEIGHT_MODIFIER?}{CATEGORY}
- * Examples: 20DRY, 40HC, 40REEFER, 45HCREEFER
+ * Examples: 20DRY, 40HC, 40REEFER, 45HCREEFER
- */
+ */
-
+
-export class ContainerType {
+export class ContainerType {
-  private readonly value: string;
+  private readonly value: string;
-
+
-  // Valid container types
+  // Valid container types
-  private static readonly VALID_TYPES = [
+  private static readonly VALID_TYPES = [
-    '20DRY',
+    '20DRY',
-    '40DRY',
+    '40DRY',
-    '20HC',
+    '20HC',
-    '40HC',
+    '40HC',
-    '45HC',
+    '45HC',
-    '20REEFER',
+    '20REEFER',
-    '40REEFER',
+    '40REEFER',
-    '40HCREEFER',
+    '40HCREEFER',
-    '45HCREEFER',
+    '45HCREEFER',
-    '20OT', // Open Top
+    '20OT', // Open Top
-    '40OT',
+    '40OT',
-    '20FR', // Flat Rack
+    '20FR', // Flat Rack
-    '40FR',
+    '40FR',
-    '20TANK',
+    '20TANK',
-    '40TANK',
+    '40TANK',
-  ];
+  ];
-
+
-  private constructor(type: string) {
+  private constructor(type: string) {
-    this.value = type;
+    this.value = type;
-  }
+  }
-
+
-  static create(type: string): ContainerType {
+  static create(type: string): ContainerType {
-    if (!type || type.trim().length === 0) {
+    if (!type || type.trim().length === 0) {
-      throw new Error('Container type cannot be empty.');
+      throw new Error('Container type cannot be empty.');
-    }
+    }
-
+
-    const normalized = type.trim().toUpperCase();
+    const normalized = type.trim().toUpperCase();
-
+
-    if (!ContainerType.isValid(normalized)) {
+    if (!ContainerType.isValid(normalized)) {
-      throw new Error(
+      throw new Error(
-        `Invalid container type: ${type}. Valid types: ${ContainerType.VALID_TYPES.join(', ')}`
+        `Invalid container type: ${type}. Valid types: ${ContainerType.VALID_TYPES.join(', ')}`
-      );
+      );
-    }
+    }
-
+
-    return new ContainerType(normalized);
+    return new ContainerType(normalized);
-  }
+  }
-
+
-  private static isValid(type: string): boolean {
+  private static isValid(type: string): boolean {
-    return ContainerType.VALID_TYPES.includes(type);
+    return ContainerType.VALID_TYPES.includes(type);
-  }
+  }
-
+
-  getValue(): string {
+  getValue(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-
+
-  getSize(): string {
+  getSize(): string {
-    // Extract size (first 2 digits)
+    // Extract size (first 2 digits)
-    return this.value.match(/^\d+/)?.[0] || '';
+    return this.value.match(/^\d+/)?.[0] || '';
-  }
+  }
-
+
-  getTEU(): number {
+  getTEU(): number {
-    const size = this.getSize();
+    const size = this.getSize();
-    if (size === '20') return 1;
+    if (size === '20') return 1;
-    if (size === '40' || size === '45') return 2;
+    if (size === '40' || size === '45') return 2;
-    return 0;
+    return 0;
-  }
+  }
-
+
-  isDry(): boolean {
+  isDry(): boolean {
-    return this.value.includes('DRY');
+    return this.value.includes('DRY');
-  }
+  }
-
+
-  isReefer(): boolean {
+  isReefer(): boolean {
-    return this.value.includes('REEFER');
+    return this.value.includes('REEFER');
-  }
+  }
-
+
-  isHighCube(): boolean {
+  isHighCube(): boolean {
-    return this.value.includes('HC');
+    return this.value.includes('HC');
-  }
+  }
-
+
-  isOpenTop(): boolean {
+  isOpenTop(): boolean {
-    return this.value.includes('OT');
+    return this.value.includes('OT');
-  }
+  }
-
+
-  isFlatRack(): boolean {
+  isFlatRack(): boolean {
-    return this.value.includes('FR');
+    return this.value.includes('FR');
-  }
+  }
-
+
-  isTank(): boolean {
+  isTank(): boolean {
-    return this.value.includes('TANK');
+    return this.value.includes('TANK');
-  }
+  }
-
+
-  equals(other: ContainerType): boolean {
+  equals(other: ContainerType): boolean {
-    return this.value === other.value;
+    return this.value === other.value;
-  }
+  }
-
+
-  toString(): string {
+  toString(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/date-range.vo.ts

@@ -1,120 +1,120 @@
-/**
+/**
- * DateRange Value Object
+ * DateRange Value Object
- *
+ *
- * Encapsulates ETD/ETA date range with validation
+ * Encapsulates ETD/ETA date range with validation
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - End date must be after start date
+ * - End date must be after start date
- * - Dates cannot be in the past (for new shipments)
+ * - Dates cannot be in the past (for new shipments)
- * - Date range is immutable
+ * - Date range is immutable
- */
+ */
-
+
-export class DateRange {
+export class DateRange {
-  private readonly startDate: Date;
+  private readonly startDate: Date;
-  private readonly endDate: Date;
+  private readonly endDate: Date;
-
+
-  private constructor(startDate: Date, endDate: Date) {
+  private constructor(startDate: Date, endDate: Date) {
-    this.startDate = startDate;
+    this.startDate = startDate;
-    this.endDate = endDate;
+    this.endDate = endDate;
-  }
+  }
-
+
-  static create(startDate: Date, endDate: Date, allowPastDates = false): DateRange {
+  static create(startDate: Date, endDate: Date, allowPastDates = false): DateRange {
-    if (!startDate || !endDate) {
+    if (!startDate || !endDate) {
-      throw new Error('Start date and end date are required.');
+      throw new Error('Start date and end date are required.');
-    }
+    }
-
+
-    if (endDate <= startDate) {
+    if (endDate <= startDate) {
-      throw new Error('End date must be after start date.');
+      throw new Error('End date must be after start date.');
-    }
+    }
-
+
-    if (!allowPastDates) {
+    if (!allowPastDates) {
-      const now = new Date();
+      const now = new Date();
-      now.setHours(0, 0, 0, 0); // Reset time to start of day
+      now.setHours(0, 0, 0, 0); // Reset time to start of day
-
+
-      if (startDate < now) {
+      if (startDate < now) {
-        throw new Error('Start date cannot be in the past.');
+        throw new Error('Start date cannot be in the past.');
-      }
+      }
-    }
+    }
-
+
-    return new DateRange(new Date(startDate), new Date(endDate));
+    return new DateRange(new Date(startDate), new Date(endDate));
-  }
+  }
-
+
-  /**
+  /**
-   * Create from ETD and transit days
+   * Create from ETD and transit days
-   */
+   */
-  static fromTransitDays(etd: Date, transitDays: number): DateRange {
+  static fromTransitDays(etd: Date, transitDays: number): DateRange {
-    if (transitDays <= 0) {
+    if (transitDays <= 0) {
-      throw new Error('Transit days must be positive.');
+      throw new Error('Transit days must be positive.');
-    }
+    }
-
+
-    const eta = new Date(etd);
+    const eta = new Date(etd);
-    eta.setDate(eta.getDate() + transitDays);
+    eta.setDate(eta.getDate() + transitDays);
-
+
-    return DateRange.create(etd, eta, true);
+    return DateRange.create(etd, eta, true);
-  }
+  }
-
+
-  getStartDate(): Date {
+  getStartDate(): Date {
-    return new Date(this.startDate);
+    return new Date(this.startDate);
-  }
+  }
-
+
-  getEndDate(): Date {
+  getEndDate(): Date {
-    return new Date(this.endDate);
+    return new Date(this.endDate);
-  }
+  }
-
+
-  getDurationInDays(): number {
+  getDurationInDays(): number {
-    const diffTime = this.endDate.getTime() - this.startDate.getTime();
+    const diffTime = this.endDate.getTime() - this.startDate.getTime();
-    return Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+    return Math.ceil(diffTime / (1000 * 60 * 60 * 24));
-  }
+  }
-
+
-  getDurationInHours(): number {
+  getDurationInHours(): number {
-    const diffTime = this.endDate.getTime() - this.startDate.getTime();
+    const diffTime = this.endDate.getTime() - this.startDate.getTime();
-    return Math.ceil(diffTime / (1000 * 60 * 60));
+    return Math.ceil(diffTime / (1000 * 60 * 60));
-  }
+  }
-
+
-  contains(date: Date): boolean {
+  contains(date: Date): boolean {
-    return date >= this.startDate && date <= this.endDate;
+    return date >= this.startDate && date <= this.endDate;
-  }
+  }
-
+
-  overlaps(other: DateRange): boolean {
+  overlaps(other: DateRange): boolean {
-    return (
+    return (
-      this.startDate <= other.endDate && this.endDate >= other.startDate
+      this.startDate <= other.endDate && this.endDate >= other.startDate
-    );
+    );
-  }
+  }
-
+
-  isFutureRange(): boolean {
+  isFutureRange(): boolean {
-    const now = new Date();
+    const now = new Date();
-    return this.startDate > now;
+    return this.startDate > now;
-  }
+  }
-
+
-  isPastRange(): boolean {
+  isPastRange(): boolean {
-    const now = new Date();
+    const now = new Date();
-    return this.endDate < now;
+    return this.endDate < now;
-  }
+  }
-
+
-  isCurrentRange(): boolean {
+  isCurrentRange(): boolean {
-    const now = new Date();
+    const now = new Date();
-    return this.contains(now);
+    return this.contains(now);
-  }
+  }
-
+
-  equals(other: DateRange): boolean {
+  equals(other: DateRange): boolean {
-    return (
+    return (
-      this.startDate.getTime() === other.startDate.getTime() &&
+      this.startDate.getTime() === other.startDate.getTime() &&
-      this.endDate.getTime() === other.endDate.getTime()
+      this.endDate.getTime() === other.endDate.getTime()
-    );
+    );
-  }
+  }
-
+
-  toString(): string {
+  toString(): string {
-    return `${this.formatDate(this.startDate)} - ${this.formatDate(this.endDate)}`;
+    return `${this.formatDate(this.startDate)} - ${this.formatDate(this.endDate)}`;
-  }
+  }
-
+
-  private formatDate(date: Date): string {
+  private formatDate(date: Date): string {
-    return date.toISOString().split('T')[0];
+    return date.toISOString().split('T')[0];
-  }
+  }
-
+
-  toObject(): { startDate: Date; endDate: Date } {
+  toObject(): { startDate: Date; endDate: Date } {
-    return {
+    return {
-      startDate: new Date(this.startDate),
+      startDate: new Date(this.startDate),
-      endDate: new Date(this.endDate),
+      endDate: new Date(this.endDate),
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/email.vo.spec.ts

@@ -1,70 +1,70 @@
-/**
+/**
- * Email Value Object Unit Tests
+ * Email Value Object Unit Tests
- */
+ */
-
+
-import { Email } from './email.vo';
+import { Email } from './email.vo';
-
+
-describe('Email Value Object', () => {
+describe('Email Value Object', () => {
-  describe('create', () => {
+  describe('create', () => {
-    it('should create email with valid format', () => {
+    it('should create email with valid format', () => {
-      const email = Email.create('user@example.com');
+      const email = Email.create('user@example.com');
-      expect(email.getValue()).toBe('user@example.com');
+      expect(email.getValue()).toBe('user@example.com');
-    });
+    });
-
+
-    it('should normalize email to lowercase', () => {
+    it('should normalize email to lowercase', () => {
-      const email = Email.create('User@Example.COM');
+      const email = Email.create('User@Example.COM');
-      expect(email.getValue()).toBe('user@example.com');
+      expect(email.getValue()).toBe('user@example.com');
-    });
+    });
-
+
-    it('should trim whitespace', () => {
+    it('should trim whitespace', () => {
-      const email = Email.create('  user@example.com  ');
+      const email = Email.create('  user@example.com  ');
-      expect(email.getValue()).toBe('user@example.com');
+      expect(email.getValue()).toBe('user@example.com');
-    });
+    });
-
+
-    it('should throw error for empty email', () => {
+    it('should throw error for empty email', () => {
-      expect(() => Email.create('')).toThrow('Email cannot be empty.');
+      expect(() => Email.create('')).toThrow('Email cannot be empty.');
-    });
+    });
-
+
-    it('should throw error for invalid format', () => {
+    it('should throw error for invalid format', () => {
-      expect(() => Email.create('invalid-email')).toThrow('Invalid email format');
+      expect(() => Email.create('invalid-email')).toThrow('Invalid email format');
-      expect(() => Email.create('@example.com')).toThrow('Invalid email format');
+      expect(() => Email.create('@example.com')).toThrow('Invalid email format');
-      expect(() => Email.create('user@')).toThrow('Invalid email format');
+      expect(() => Email.create('user@')).toThrow('Invalid email format');
-      expect(() => Email.create('user@.com')).toThrow('Invalid email format');
+      expect(() => Email.create('user@.com')).toThrow('Invalid email format');
-    });
+    });
-  });
+  });
-
+
-  describe('getDomain', () => {
+  describe('getDomain', () => {
-    it('should return email domain', () => {
+    it('should return email domain', () => {
-      const email = Email.create('user@example.com');
+      const email = Email.create('user@example.com');
-      expect(email.getDomain()).toBe('example.com');
+      expect(email.getDomain()).toBe('example.com');
-    });
+    });
-  });
+  });
-
+
-  describe('getLocalPart', () => {
+  describe('getLocalPart', () => {
-    it('should return email local part', () => {
+    it('should return email local part', () => {
-      const email = Email.create('user@example.com');
+      const email = Email.create('user@example.com');
-      expect(email.getLocalPart()).toBe('user');
+      expect(email.getLocalPart()).toBe('user');
-    });
+    });
-  });
+  });
-
+
-  describe('equals', () => {
+  describe('equals', () => {
-    it('should return true for same email', () => {
+    it('should return true for same email', () => {
-      const email1 = Email.create('user@example.com');
+      const email1 = Email.create('user@example.com');
-      const email2 = Email.create('user@example.com');
+      const email2 = Email.create('user@example.com');
-      expect(email1.equals(email2)).toBe(true);
+      expect(email1.equals(email2)).toBe(true);
-    });
+    });
-
+
-    it('should return false for different emails', () => {
+    it('should return false for different emails', () => {
-      const email1 = Email.create('user1@example.com');
+      const email1 = Email.create('user1@example.com');
-      const email2 = Email.create('user2@example.com');
+      const email2 = Email.create('user2@example.com');
-      expect(email1.equals(email2)).toBe(false);
+      expect(email1.equals(email2)).toBe(false);
-    });
+    });
-  });
+  });
-
+
-  describe('toString', () => {
+  describe('toString', () => {
-    it('should return email as string', () => {
+    it('should return email as string', () => {
-      const email = Email.create('user@example.com');
+      const email = Email.create('user@example.com');
-      expect(email.toString()).toBe('user@example.com');
+      expect(email.toString()).toBe('user@example.com');
-    });
+    });
-  });
+  });
-});
+});

apps/backend/src/domain/value-objects/email.vo.ts

@@ -1,60 +1,60 @@
-/**
+/**
- * Email Value Object
+ * Email Value Object
- *
+ *
- * Encapsulates email address validation and behavior
+ * Encapsulates email address validation and behavior
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Email must be valid format
+ * - Email must be valid format
- * - Email is case-insensitive (stored lowercase)
+ * - Email is case-insensitive (stored lowercase)
- * - Email is immutable
+ * - Email is immutable
- */
+ */
-
+
-export class Email {
+export class Email {
-  private readonly value: string;
+  private readonly value: string;
-
+
-  private constructor(email: string) {
+  private constructor(email: string) {
-    this.value = email;
+    this.value = email;
-  }
+  }
-
+
-  static create(email: string): Email {
+  static create(email: string): Email {
-    if (!email || email.trim().length === 0) {
+    if (!email || email.trim().length === 0) {
-      throw new Error('Email cannot be empty.');
+      throw new Error('Email cannot be empty.');
-    }
+    }
-
+
-    const normalized = email.trim().toLowerCase();
+    const normalized = email.trim().toLowerCase();
-
+
-    if (!Email.isValid(normalized)) {
+    if (!Email.isValid(normalized)) {
-      throw new Error(`Invalid email format: ${email}`);
+      throw new Error(`Invalid email format: ${email}`);
-    }
+    }
-
+
-    return new Email(normalized);
+    return new Email(normalized);
-  }
+  }
-
+
-  private static isValid(email: string): boolean {
+  private static isValid(email: string): boolean {
-    // RFC 5322 simplified email regex
+    // RFC 5322 simplified email regex
-    const emailPattern =
+    const emailPattern =
-      /^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+      /^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
-
+
-    return emailPattern.test(email);
+    return emailPattern.test(email);
-  }
+  }
-
+
-  getValue(): string {
+  getValue(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-
+
-  getDomain(): string {
+  getDomain(): string {
-    return this.value.split('@')[1];
+    return this.value.split('@')[1];
-  }
+  }
-
+
-  getLocalPart(): string {
+  getLocalPart(): string {
-    return this.value.split('@')[0];
+    return this.value.split('@')[0];
-  }
+  }
-
+
-  equals(other: Email): boolean {
+  equals(other: Email): boolean {
-    return this.value === other.value;
+    return this.value === other.value;
-  }
+  }
-
+
-  toString(): string {
+  toString(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/index.ts

@@ -1,13 +1,13 @@
-/**
+/**
- * Domain Value Objects Barrel Export
+ * Domain Value Objects Barrel Export
- *
+ *
- * All value objects for the Xpeditis platform
+ * All value objects for the Xpeditis platform
- */
+ */
-
+
-export * from './email.vo';
+export * from './email.vo';
-export * from './port-code.vo';
+export * from './port-code.vo';
-export * from './money.vo';
+export * from './money.vo';
-export * from './container-type.vo';
+export * from './container-type.vo';
-export * from './date-range.vo';
+export * from './date-range.vo';
-export * from './booking-number.vo';
+export * from './booking-number.vo';
-export * from './booking-status.vo';
+export * from './booking-status.vo';

apps/backend/src/domain/value-objects/money.vo.spec.ts

@@ -1,133 +1,133 @@
-/**
+/**
- * Money Value Object Unit Tests
+ * Money Value Object Unit Tests
- */
+ */
-
+
-import { Money } from './money.vo';
+import { Money } from './money.vo';
-
+
-describe('Money Value Object', () => {
+describe('Money Value Object', () => {
-  describe('create', () => {
+  describe('create', () => {
-    it('should create money with valid amount and currency', () => {
+    it('should create money with valid amount and currency', () => {
-      const money = Money.create(100, 'USD');
+      const money = Money.create(100, 'USD');
-      expect(money.getAmount()).toBe(100);
+      expect(money.getAmount()).toBe(100);
-      expect(money.getCurrency()).toBe('USD');
+      expect(money.getCurrency()).toBe('USD');
-    });
+    });
-
+
-    it('should round to 2 decimal places', () => {
+    it('should round to 2 decimal places', () => {
-      const money = Money.create(100.999, 'USD');
+      const money = Money.create(100.999, 'USD');
-      expect(money.getAmount()).toBe(101);
+      expect(money.getAmount()).toBe(101);
-    });
+    });
-
+
-    it('should throw error for negative amount', () => {
+    it('should throw error for negative amount', () => {
-      expect(() => Money.create(-100, 'USD')).toThrow('Amount cannot be negative');
+      expect(() => Money.create(-100, 'USD')).toThrow('Amount cannot be negative');
-    });
+    });
-
+
-    it('should throw error for invalid currency', () => {
+    it('should throw error for invalid currency', () => {
-      expect(() => Money.create(100, 'XXX')).toThrow('Invalid currency code');
+      expect(() => Money.create(100, 'XXX')).toThrow('Invalid currency code');
-    });
+    });
-
+
-    it('should normalize currency to uppercase', () => {
+    it('should normalize currency to uppercase', () => {
-      const money = Money.create(100, 'usd');
+      const money = Money.create(100, 'usd');
-      expect(money.getCurrency()).toBe('USD');
+      expect(money.getCurrency()).toBe('USD');
-    });
+    });
-  });
+  });
-
+
-  describe('zero', () => {
+  describe('zero', () => {
-    it('should create zero amount', () => {
+    it('should create zero amount', () => {
-      const money = Money.zero('USD');
+      const money = Money.zero('USD');
-      expect(money.getAmount()).toBe(0);
+      expect(money.getAmount()).toBe(0);
-      expect(money.isZero()).toBe(true);
+      expect(money.isZero()).toBe(true);
-    });
+    });
-  });
+  });
-
+
-  describe('add', () => {
+  describe('add', () => {
-    it('should add two money amounts', () => {
+    it('should add two money amounts', () => {
-      const money1 = Money.create(100, 'USD');
+      const money1 = Money.create(100, 'USD');
-      const money2 = Money.create(50, 'USD');
+      const money2 = Money.create(50, 'USD');
-      const result = money1.add(money2);
+      const result = money1.add(money2);
-      expect(result.getAmount()).toBe(150);
+      expect(result.getAmount()).toBe(150);
-    });
+    });
-
+
-    it('should throw error for currency mismatch', () => {
+    it('should throw error for currency mismatch', () => {
-      const money1 = Money.create(100, 'USD');
+      const money1 = Money.create(100, 'USD');
-      const money2 = Money.create(50, 'EUR');
+      const money2 = Money.create(50, 'EUR');
-      expect(() => money1.add(money2)).toThrow('Currency mismatch');
+      expect(() => money1.add(money2)).toThrow('Currency mismatch');
-    });
+    });
-  });
+  });
-
+
-  describe('subtract', () => {
+  describe('subtract', () => {
-    it('should subtract two money amounts', () => {
+    it('should subtract two money amounts', () => {
-      const money1 = Money.create(100, 'USD');
+      const money1 = Money.create(100, 'USD');
-      const money2 = Money.create(30, 'USD');
+      const money2 = Money.create(30, 'USD');
-      const result = money1.subtract(money2);
+      const result = money1.subtract(money2);
-      expect(result.getAmount()).toBe(70);
+      expect(result.getAmount()).toBe(70);
-    });
+    });
-
+
-    it('should throw error for negative result', () => {
+    it('should throw error for negative result', () => {
-      const money1 = Money.create(50, 'USD');
+      const money1 = Money.create(50, 'USD');
-      const money2 = Money.create(100, 'USD');
+      const money2 = Money.create(100, 'USD');
-      expect(() => money1.subtract(money2)).toThrow('negative amount');
+      expect(() => money1.subtract(money2)).toThrow('negative amount');
-    });
+    });
-  });
+  });
-
+
-  describe('multiply', () => {
+  describe('multiply', () => {
-    it('should multiply money amount', () => {
+    it('should multiply money amount', () => {
-      const money = Money.create(100, 'USD');
+      const money = Money.create(100, 'USD');
-      const result = money.multiply(2);
+      const result = money.multiply(2);
-      expect(result.getAmount()).toBe(200);
+      expect(result.getAmount()).toBe(200);
-    });
+    });
-
+
-    it('should throw error for negative multiplier', () => {
+    it('should throw error for negative multiplier', () => {
-      const money = Money.create(100, 'USD');
+      const money = Money.create(100, 'USD');
-      expect(() => money.multiply(-2)).toThrow('Multiplier cannot be negative');
+      expect(() => money.multiply(-2)).toThrow('Multiplier cannot be negative');
-    });
+    });
-  });
+  });
-
+
-  describe('divide', () => {
+  describe('divide', () => {
-    it('should divide money amount', () => {
+    it('should divide money amount', () => {
-      const money = Money.create(100, 'USD');
+      const money = Money.create(100, 'USD');
-      const result = money.divide(2);
+      const result = money.divide(2);
-      expect(result.getAmount()).toBe(50);
+      expect(result.getAmount()).toBe(50);
-    });
+    });
-
+
-    it('should throw error for zero divisor', () => {
+    it('should throw error for zero divisor', () => {
-      const money = Money.create(100, 'USD');
+      const money = Money.create(100, 'USD');
-      expect(() => money.divide(0)).toThrow('Divisor must be positive');
+      expect(() => money.divide(0)).toThrow('Divisor must be positive');
-    });
+    });
-  });
+  });
-
+
-  describe('comparisons', () => {
+  describe('comparisons', () => {
-    it('should compare greater than', () => {
+    it('should compare greater than', () => {
-      const money1 = Money.create(100, 'USD');
+      const money1 = Money.create(100, 'USD');
-      const money2 = Money.create(50, 'USD');
+      const money2 = Money.create(50, 'USD');
-      expect(money1.isGreaterThan(money2)).toBe(true);
+      expect(money1.isGreaterThan(money2)).toBe(true);
-      expect(money2.isGreaterThan(money1)).toBe(false);
+      expect(money2.isGreaterThan(money1)).toBe(false);
-    });
+    });
-
+
-    it('should compare less than', () => {
+    it('should compare less than', () => {
-      const money1 = Money.create(50, 'USD');
+      const money1 = Money.create(50, 'USD');
-      const money2 = Money.create(100, 'USD');
+      const money2 = Money.create(100, 'USD');
-      expect(money1.isLessThan(money2)).toBe(true);
+      expect(money1.isLessThan(money2)).toBe(true);
-      expect(money2.isLessThan(money1)).toBe(false);
+      expect(money2.isLessThan(money1)).toBe(false);
-    });
+    });
-
+
-    it('should compare equality', () => {
+    it('should compare equality', () => {
-      const money1 = Money.create(100, 'USD');
+      const money1 = Money.create(100, 'USD');
-      const money2 = Money.create(100, 'USD');
+      const money2 = Money.create(100, 'USD');
-      const money3 = Money.create(50, 'USD');
+      const money3 = Money.create(50, 'USD');
-      expect(money1.isEqualTo(money2)).toBe(true);
+      expect(money1.isEqualTo(money2)).toBe(true);
-      expect(money1.isEqualTo(money3)).toBe(false);
+      expect(money1.isEqualTo(money3)).toBe(false);
-    });
+    });
-  });
+  });
-
+
-  describe('format', () => {
+  describe('format', () => {
-    it('should format USD with $ symbol', () => {
+    it('should format USD with $ symbol', () => {
-      const money = Money.create(100.5, 'USD');
+      const money = Money.create(100.5, 'USD');
-      expect(money.format()).toBe('$100.50');
+      expect(money.format()).toBe('$100.50');
-    });
+    });
-
+
-    it('should format EUR with € symbol', () => {
+    it('should format EUR with € symbol', () => {
-      const money = Money.create(100.5, 'EUR');
+      const money = Money.create(100.5, 'EUR');
-      expect(money.format()).toBe('€100.50');
+      expect(money.format()).toBe('€100.50');
-    });
+    });
-  });
+  });
-});
+});

apps/backend/src/domain/value-objects/money.vo.ts

@@ -1,137 +1,137 @@
-/**
+/**
- * Money Value Object
+ * Money Value Object
- *
+ *
- * Encapsulates currency and amount with proper validation
+ * Encapsulates currency and amount with proper validation
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Amount must be non-negative
+ * - Amount must be non-negative
- * - Currency must be valid ISO 4217 code
+ * - Currency must be valid ISO 4217 code
- * - Money is immutable
+ * - Money is immutable
- * - Arithmetic operations return new Money instances
+ * - Arithmetic operations return new Money instances
- */
+ */
-
+
-export class Money {
+export class Money {
-  private readonly amount: number;
+  private readonly amount: number;
-  private readonly currency: string;
+  private readonly currency: string;
-
+
-  private static readonly SUPPORTED_CURRENCIES = ['USD', 'EUR', 'GBP', 'CNY', 'JPY'];
+  private static readonly SUPPORTED_CURRENCIES = ['USD', 'EUR', 'GBP', 'CNY', 'JPY'];
-
+
-  private constructor(amount: number, currency: string) {
+  private constructor(amount: number, currency: string) {
-    this.amount = amount;
+    this.amount = amount;
-    this.currency = currency;
+    this.currency = currency;
-  }
+  }
-
+
-  static create(amount: number, currency: string): Money {
+  static create(amount: number, currency: string): Money {
-    if (amount < 0) {
+    if (amount < 0) {
-      throw new Error('Amount cannot be negative.');
+      throw new Error('Amount cannot be negative.');
-    }
+    }
-
+
-    const normalizedCurrency = currency.trim().toUpperCase();
+    const normalizedCurrency = currency.trim().toUpperCase();
-
+
-    if (!Money.isValidCurrency(normalizedCurrency)) {
+    if (!Money.isValidCurrency(normalizedCurrency)) {
-      throw new Error(
+      throw new Error(
-        `Invalid currency code: ${currency}. Supported currencies: ${Money.SUPPORTED_CURRENCIES.join(', ')}`
+        `Invalid currency code: ${currency}. Supported currencies: ${Money.SUPPORTED_CURRENCIES.join(', ')}`
-      );
+      );
-    }
+    }
-
+
-    // Round to 2 decimal places to avoid floating point issues
+    // Round to 2 decimal places to avoid floating point issues
-    const roundedAmount = Math.round(amount * 100) / 100;
+    const roundedAmount = Math.round(amount * 100) / 100;
-
+
-    return new Money(roundedAmount, normalizedCurrency);
+    return new Money(roundedAmount, normalizedCurrency);
-  }
+  }
-
+
-  static zero(currency: string): Money {
+  static zero(currency: string): Money {
-    return Money.create(0, currency);
+    return Money.create(0, currency);
-  }
+  }
-
+
-  private static isValidCurrency(currency: string): boolean {
+  private static isValidCurrency(currency: string): boolean {
-    return Money.SUPPORTED_CURRENCIES.includes(currency);
+    return Money.SUPPORTED_CURRENCIES.includes(currency);
-  }
+  }
-
+
-  getAmount(): number {
+  getAmount(): number {
-    return this.amount;
+    return this.amount;
-  }
+  }
-
+
-  getCurrency(): string {
+  getCurrency(): string {
-    return this.currency;
+    return this.currency;
-  }
+  }
-
+
-  add(other: Money): Money {
+  add(other: Money): Money {
-    this.ensureSameCurrency(other);
+    this.ensureSameCurrency(other);
-    return Money.create(this.amount + other.amount, this.currency);
+    return Money.create(this.amount + other.amount, this.currency);
-  }
+  }
-
+
-  subtract(other: Money): Money {
+  subtract(other: Money): Money {
-    this.ensureSameCurrency(other);
+    this.ensureSameCurrency(other);
-    const result = this.amount - other.amount;
+    const result = this.amount - other.amount;
-    if (result < 0) {
+    if (result < 0) {
-      throw new Error('Subtraction would result in negative amount.');
+      throw new Error('Subtraction would result in negative amount.');
-    }
+    }
-    return Money.create(result, this.currency);
+    return Money.create(result, this.currency);
-  }
+  }
-
+
-  multiply(multiplier: number): Money {
+  multiply(multiplier: number): Money {
-    if (multiplier < 0) {
+    if (multiplier < 0) {
-      throw new Error('Multiplier cannot be negative.');
+      throw new Error('Multiplier cannot be negative.');
-    }
+    }
-    return Money.create(this.amount * multiplier, this.currency);
+    return Money.create(this.amount * multiplier, this.currency);
-  }
+  }
-
+
-  divide(divisor: number): Money {
+  divide(divisor: number): Money {
-    if (divisor <= 0) {
+    if (divisor <= 0) {
-      throw new Error('Divisor must be positive.');
+      throw new Error('Divisor must be positive.');
-    }
+    }
-    return Money.create(this.amount / divisor, this.currency);
+    return Money.create(this.amount / divisor, this.currency);
-  }
+  }
-
+
-  isGreaterThan(other: Money): boolean {
+  isGreaterThan(other: Money): boolean {
-    this.ensureSameCurrency(other);
+    this.ensureSameCurrency(other);
-    return this.amount > other.amount;
+    return this.amount > other.amount;
-  }
+  }
-
+
-  isLessThan(other: Money): boolean {
+  isLessThan(other: Money): boolean {
-    this.ensureSameCurrency(other);
+    this.ensureSameCurrency(other);
-    return this.amount < other.amount;
+    return this.amount < other.amount;
-  }
+  }
-
+
-  isEqualTo(other: Money): boolean {
+  isEqualTo(other: Money): boolean {
-    return this.currency === other.currency && this.amount === other.amount;
+    return this.currency === other.currency && this.amount === other.amount;
-  }
+  }
-
+
-  isZero(): boolean {
+  isZero(): boolean {
-    return this.amount === 0;
+    return this.amount === 0;
-  }
+  }
-
+
-  private ensureSameCurrency(other: Money): void {
+  private ensureSameCurrency(other: Money): void {
-    if (this.currency !== other.currency) {
+    if (this.currency !== other.currency) {
-      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);
+      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);
-    }
+    }
-  }
+  }
-
+
-  /**
+  /**
-   * Format as string with currency symbol
+   * Format as string with currency symbol
-   */
+   */
-  format(): string {
+  format(): string {
-    const symbols: { [key: string]: string } = {
+    const symbols: { [key: string]: string } = {
-      USD: '$',
+      USD: '$',
-      EUR: '€',
+      EUR: '€',
-      GBP: '£',
+      GBP: '£',
-      CNY: '¥',
+      CNY: '¥',
-      JPY: '¥',
+      JPY: '¥',
-    };
+    };
-
+
-    const symbol = symbols[this.currency] || this.currency;
+    const symbol = symbols[this.currency] || this.currency;
-    return `${symbol}${this.amount.toFixed(2)}`;
+    return `${symbol}${this.amount.toFixed(2)}`;
-  }
+  }
-
+
-  toString(): string {
+  toString(): string {
-    return this.format();
+    return this.format();
-  }
+  }
-
+
-  toObject(): { amount: number; currency: string } {
+  toObject(): { amount: number; currency: string } {
-    return {
+    return {
-      amount: this.amount,
+      amount: this.amount,
-      currency: this.currency,
+      currency: this.currency,
-    };
+    };
-  }
+  }
-}
+}

apps/backend/src/domain/value-objects/port-code.vo.ts

@@ -1,66 +1,66 @@
-/**
+/**
- * PortCode Value Object
+ * PortCode Value Object
- *
+ *
- * Encapsulates UN/LOCODE port code validation and behavior
+ * Encapsulates UN/LOCODE port code validation and behavior
- *
+ *
- * Business Rules:
+ * Business Rules:
- * - Port code must follow UN/LOCODE format (2-letter country + 3-letter/digit location)
+ * - Port code must follow UN/LOCODE format (2-letter country + 3-letter/digit location)
- * - Port code is always uppercase
+ * - Port code is always uppercase
- * - Port code is immutable
+ * - Port code is immutable
- *
+ *
- * Format: CCLLL
+ * Format: CCLLL
- * - CC: ISO 3166-1 alpha-2 country code
+ * - CC: ISO 3166-1 alpha-2 country code
- * - LLL: 3-character location code (letters or digits)
+ * - LLL: 3-character location code (letters or digits)
- *
+ *
- * Examples: NLRTM (Rotterdam), USNYC (New York), SGSIN (Singapore)
+ * Examples: NLRTM (Rotterdam), USNYC (New York), SGSIN (Singapore)
- */
+ */
-
+
-export class PortCode {
+export class PortCode {
-  private readonly value: string;
+  private readonly value: string;
-
+
-  private constructor(code: string) {
+  private constructor(code: string) {
-    this.value = code;
+    this.value = code;
-  }
+  }
-
+
-  static create(code: string): PortCode {
+  static create(code: string): PortCode {
-    if (!code || code.trim().length === 0) {
+    if (!code || code.trim().length === 0) {
-      throw new Error('Port code cannot be empty.');
+      throw new Error('Port code cannot be empty.');
-    }
+    }
-
+
-    const normalized = code.trim().toUpperCase();
+    const normalized = code.trim().toUpperCase();
-
+
-    if (!PortCode.isValid(normalized)) {
+    if (!PortCode.isValid(normalized)) {
-      throw new Error(
+      throw new Error(
-        `Invalid port code format: ${code}. Must follow UN/LOCODE format (e.g., NLRTM, USNYC).`
+        `Invalid port code format: ${code}. Must follow UN/LOCODE format (e.g., NLRTM, USNYC).`
-      );
+      );
-    }
+    }
-
+
-    return new PortCode(normalized);
+    return new PortCode(normalized);
-  }
+  }
-
+
-  private static isValid(code: string): boolean {
+  private static isValid(code: string): boolean {
-    // UN/LOCODE format: 2-letter country code + 3-character location code
+    // UN/LOCODE format: 2-letter country code + 3-character location code
-    const unlocodePattern = /^[A-Z]{2}[A-Z0-9]{3}$/;
+    const unlocodePattern = /^[A-Z]{2}[A-Z0-9]{3}$/;
-    return unlocodePattern.test(code);
+    return unlocodePattern.test(code);
-  }
+  }
-
+
-  getValue(): string {
+  getValue(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-
+
-  getCountryCode(): string {
+  getCountryCode(): string {
-    return this.value.substring(0, 2);
+    return this.value.substring(0, 2);
-  }
+  }
-
+
-  getLocationCode(): string {
+  getLocationCode(): string {
-    return this.value.substring(2);
+    return this.value.substring(2);
-  }
+  }
-
+
-  equals(other: PortCode): boolean {
+  equals(other: PortCode): boolean {
-    return this.value === other.value;
+    return this.value === other.value;
-  }
+  }
-
+
-  toString(): string {
+  toString(): string {
-    return this.value;
+    return this.value;
-  }
+  }
-}
+}

apps/backend/src/infrastructure/cache/cache.module.ts

@@ -1,21 +1,22 @@
-/**
+/**
- * Cache Module
+ * Cache Module
- *
+ *
- * Provides Redis cache adapter as CachePort implementation
+ * Provides Redis cache adapter as CachePort implementation
- */
+ */
-
+
-import { Module, Global } from '@nestjs/common';
+import { Module, Global } from '@nestjs/common';
-import { RedisCacheAdapter } from './redis-cache.adapter';
+import { RedisCacheAdapter } from './redis-cache.adapter';
-
+import { CACHE_PORT } from '../../domain/ports/out/cache.port';
-@Global()
+
-@Module({
+@Global()
-  providers: [
+@Module({
-    {
+  providers: [
-      provide: 'CachePort',
+    {
-      useClass: RedisCacheAdapter,
+      provide: CACHE_PORT,
-    },
+      useClass: RedisCacheAdapter,
-    RedisCacheAdapter,
+    },
-  ],
+    RedisCacheAdapter,
-  exports: ['CachePort', RedisCacheAdapter],
+  ],
-})
+  exports: [CACHE_PORT, RedisCacheAdapter],
-export class CacheModule {}
+})
+export class CacheModule {}

apps/backend/src/infrastructure/cache/redis-cache.adapter.ts

@@ -1,181 +1,181 @@
-/**
+/**
- * Redis Cache Adapter
+ * Redis Cache Adapter
- *
+ *
- * Implements CachePort interface using Redis (ioredis)
+ * Implements CachePort interface using Redis (ioredis)
- */
+ */
-
+
-import { Injectable, OnModuleInit, OnModuleDestroy, Logger } from '@nestjs/common';
+import { Injectable, OnModuleInit, OnModuleDestroy, Logger } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
+import { ConfigService } from '@nestjs/config';
-import Redis from 'ioredis';
+import Redis from 'ioredis';
-import { CachePort } from '../../domain/ports/out/cache.port';
+import { CachePort } from '../../domain/ports/out/cache.port';
-
+
-@Injectable()
+@Injectable()
-export class RedisCacheAdapter implements CachePort, OnModuleInit, OnModuleDestroy {
+export class RedisCacheAdapter implements CachePort, OnModuleInit, OnModuleDestroy {
-  private readonly logger = new Logger(RedisCacheAdapter.name);
+  private readonly logger = new Logger(RedisCacheAdapter.name);
-  private client: Redis;
+  private client: Redis;
-  private stats = {
+  private stats = {
-    hits: 0,
+    hits: 0,
-    misses: 0,
+    misses: 0,
-  };
+  };
-
+
-  constructor(private readonly configService: ConfigService) {}
+  constructor(private readonly configService: ConfigService) {}
-
+
-  async onModuleInit(): Promise<void> {
+  async onModuleInit(): Promise<void> {
-    const host = this.configService.get<string>('REDIS_HOST', 'localhost');
+    const host = this.configService.get<string>('REDIS_HOST', 'localhost');
-    const port = this.configService.get<number>('REDIS_PORT', 6379);
+    const port = this.configService.get<number>('REDIS_PORT', 6379);
-    const password = this.configService.get<string>('REDIS_PASSWORD');
+    const password = this.configService.get<string>('REDIS_PASSWORD');
-    const db = this.configService.get<number>('REDIS_DB', 0);
+    const db = this.configService.get<number>('REDIS_DB', 0);
-
+
-    this.client = new Redis({
+    this.client = new Redis({
-      host,
+      host,
-      port,
+      port,
-      password,
+      password,
-      db,
+      db,
-      retryStrategy: (times) => {
+      retryStrategy: (times) => {
-        const delay = Math.min(times * 50, 2000);
+        const delay = Math.min(times * 50, 2000);
-        return delay;
+        return delay;
-      },
+      },
-      maxRetriesPerRequest: 3,
+      maxRetriesPerRequest: 3,
-    });
+    });
-
+
-    this.client.on('connect', () => {
+    this.client.on('connect', () => {
-      this.logger.log(`Connected to Redis at ${host}:${port}`);
+      this.logger.log(`Connected to Redis at ${host}:${port}`);
-    });
+    });
-
+
-    this.client.on('error', (err) => {
+    this.client.on('error', (err) => {
-      this.logger.error(`Redis connection error: ${err.message}`);
+      this.logger.error(`Redis connection error: ${err.message}`);
-    });
+    });
-
+
-    this.client.on('ready', () => {
+    this.client.on('ready', () => {
-      this.logger.log('Redis client ready');
+      this.logger.log('Redis client ready');
-    });
+    });
-  }
+  }
-
+
-  async onModuleDestroy(): Promise<void> {
+  async onModuleDestroy(): Promise<void> {
-    await this.client.quit();
+    await this.client.quit();
-    this.logger.log('Redis connection closed');
+    this.logger.log('Redis connection closed');
-  }
+  }
-
+
-  async get<T>(key: string): Promise<T | null> {
+  async get<T>(key: string): Promise<T | null> {
-    try {
+    try {
-      const value = await this.client.get(key);
+      const value = await this.client.get(key);
-
+
-      if (value === null) {
+      if (value === null) {
-        this.stats.misses++;
+        this.stats.misses++;
-        return null;
+        return null;
-      }
+      }
-
+
-      this.stats.hits++;
+      this.stats.hits++;
-      return JSON.parse(value) as T;
+      return JSON.parse(value) as T;
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error getting key ${key}: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error getting key ${key}: ${error?.message || 'Unknown error'}`);
-      return null;
+      return null;
-    }
+    }
-  }
+  }
-
+
-  async set<T>(key: string, value: T, ttlSeconds?: number): Promise<void> {
+  async set<T>(key: string, value: T, ttlSeconds?: number): Promise<void> {
-    try {
+    try {
-      const serialized = JSON.stringify(value);
+      const serialized = JSON.stringify(value);
-      if (ttlSeconds) {
+      if (ttlSeconds) {
-        await this.client.setex(key, ttlSeconds, serialized);
+        await this.client.setex(key, ttlSeconds, serialized);
-      } else {
+      } else {
-        await this.client.set(key, serialized);
+        await this.client.set(key, serialized);
-      }
+      }
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error setting key ${key}: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error setting key ${key}: ${error?.message || 'Unknown error'}`);
-      throw error;
+      throw error;
-    }
+    }
-  }
+  }
-
+
-  async delete(key: string): Promise<void> {
+  async delete(key: string): Promise<void> {
-    try {
+    try {
-      await this.client.del(key);
+      await this.client.del(key);
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error deleting key ${key}: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error deleting key ${key}: ${error?.message || 'Unknown error'}`);
-      throw error;
+      throw error;
-    }
+    }
-  }
+  }
-
+
-  async deleteMany(keys: string[]): Promise<void> {
+  async deleteMany(keys: string[]): Promise<void> {
-    if (keys.length === 0) return;
+    if (keys.length === 0) return;
-
+
-    try {
+    try {
-      await this.client.del(...keys);
+      await this.client.del(...keys);
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error deleting keys: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error deleting keys: ${error?.message || 'Unknown error'}`);
-      throw error;
+      throw error;
-    }
+    }
-  }
+  }
-
+
-  async exists(key: string): Promise<boolean> {
+  async exists(key: string): Promise<boolean> {
-    try {
+    try {
-      const result = await this.client.exists(key);
+      const result = await this.client.exists(key);
-      return result === 1;
+      return result === 1;
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error checking key existence ${key}: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error checking key existence ${key}: ${error?.message || 'Unknown error'}`);
-      return false;
+      return false;
-    }
+    }
-  }
+  }
-
+
-  async ttl(key: string): Promise<number> {
+  async ttl(key: string): Promise<number> {
-    try {
+    try {
-      return await this.client.ttl(key);
+      return await this.client.ttl(key);
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error getting TTL for key ${key}: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error getting TTL for key ${key}: ${error?.message || 'Unknown error'}`);
-      return -2;
+      return -2;
-    }
+    }
-  }
+  }
-
+
-  async clear(): Promise<void> {
+  async clear(): Promise<void> {
-    try {
+    try {
-      await this.client.flushdb();
+      await this.client.flushdb();
-      this.logger.warn('Redis database cleared');
+      this.logger.warn('Redis database cleared');
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error clearing cache: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error clearing cache: ${error?.message || 'Unknown error'}`);
-      throw error;
+      throw error;
-    }
+    }
-  }
+  }
-
+
-  async getStats(): Promise<{
+  async getStats(): Promise<{
-    hits: number;
+    hits: number;
-    misses: number;
+    misses: number;
-    hitRate: number;
+    hitRate: number;
-    keyCount: number;
+    keyCount: number;
-  }> {
+  }> {
-    try {
+    try {
-      const keyCount = await this.client.dbsize();
+      const keyCount = await this.client.dbsize();
-      const total = this.stats.hits + this.stats.misses;
+      const total = this.stats.hits + this.stats.misses;
-      const hitRate = total > 0 ? this.stats.hits / total : 0;
+      const hitRate = total > 0 ? this.stats.hits / total : 0;
-
+
-      return {
+      return {
-        hits: this.stats.hits,
+        hits: this.stats.hits,
-        misses: this.stats.misses,
+        misses: this.stats.misses,
-        hitRate: Math.round(hitRate * 10000) / 100, // Percentage with 2 decimals
+        hitRate: Math.round(hitRate * 10000) / 100, // Percentage with 2 decimals
-        keyCount,
+        keyCount,
-      };
+      };
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error getting stats: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error getting stats: ${error?.message || 'Unknown error'}`);
-      return {
+      return {
-        hits: this.stats.hits,
+        hits: this.stats.hits,
-        misses: this.stats.misses,
+        misses: this.stats.misses,
-        hitRate: 0,
+        hitRate: 0,
-        keyCount: 0,
+        keyCount: 0,
-      };
+      };
-    }
+    }
-  }
+  }
-
+
-  /**
+  /**
-   * Reset statistics (useful for testing)
+   * Reset statistics (useful for testing)
-   */
+   */
-  resetStats(): void {
+  resetStats(): void {
-    this.stats.hits = 0;
+    this.stats.hits = 0;
-    this.stats.misses = 0;
+    this.stats.misses = 0;
-  }
+  }
-
+
-  /**
+  /**
-   * Get Redis client (for advanced usage)
+   * Get Redis client (for advanced usage)
-   */
+   */
-  getClient(): Redis {
+  getClient(): Redis {
-    return this.client;
+    return this.client;
-  }
+  }
-}
+}

apps/backend/src/infrastructure/carriers/carrier.module.ts

@@ -1,75 +1,75 @@
-/**
+/**
- * Carrier Module
+ * Carrier Module
- *
+ *
- * Provides all carrier connector implementations
+ * Provides all carrier connector implementations
- */
+ */
-
+
-import { Module } from '@nestjs/common';
+import { Module } from '@nestjs/common';
-import { MaerskConnector } from './maersk/maersk.connector';
+import { MaerskConnector } from './maersk/maersk.connector';
-import { MSCConnectorAdapter } from './msc/msc.connector';
+import { MSCConnectorAdapter } from './msc/msc.connector';
-import { MSCRequestMapper } from './msc/msc.mapper';
+import { MSCRequestMapper } from './msc/msc.mapper';
-import { CMACGMConnectorAdapter } from './cma-cgm/cma-cgm.connector';
+import { CMACGMConnectorAdapter } from './cma-cgm/cma-cgm.connector';
-import { CMACGMRequestMapper } from './cma-cgm/cma-cgm.mapper';
+import { CMACGMRequestMapper } from './cma-cgm/cma-cgm.mapper';
-import { HapagLloydConnectorAdapter } from './hapag-lloyd/hapag-lloyd.connector';
+import { HapagLloydConnectorAdapter } from './hapag-lloyd/hapag-lloyd.connector';
-import { HapagLloydRequestMapper } from './hapag-lloyd/hapag-lloyd.mapper';
+import { HapagLloydRequestMapper } from './hapag-lloyd/hapag-lloyd.mapper';
-import { ONEConnectorAdapter } from './one/one.connector';
+import { ONEConnectorAdapter } from './one/one.connector';
-import { ONERequestMapper } from './one/one.mapper';
+import { ONERequestMapper } from './one/one.mapper';
-
+
-@Module({
+@Module({
-  providers: [
+  providers: [
-    // Maersk
+    // Maersk
-    MaerskConnector,
+    MaerskConnector,
-
+
-    // MSC
+    // MSC
-    MSCRequestMapper,
+    MSCRequestMapper,
-    MSCConnectorAdapter,
+    MSCConnectorAdapter,
-
+
-    // CMA CGM
+    // CMA CGM
-    CMACGMRequestMapper,
+    CMACGMRequestMapper,
-    CMACGMConnectorAdapter,
+    CMACGMConnectorAdapter,
-
+
-    // Hapag-Lloyd
+    // Hapag-Lloyd
-    HapagLloydRequestMapper,
+    HapagLloydRequestMapper,
-    HapagLloydConnectorAdapter,
+    HapagLloydConnectorAdapter,
-
+
-    // ONE
+    // ONE
-    ONERequestMapper,
+    ONERequestMapper,
-    ONEConnectorAdapter,
+    ONEConnectorAdapter,
-
+
-    // Factory that provides all connectors
+    // Factory that provides all connectors
-    {
+    {
-      provide: 'CarrierConnectors',
+      provide: 'CarrierConnectors',
-      useFactory: (
+      useFactory: (
-        maerskConnector: MaerskConnector,
+        maerskConnector: MaerskConnector,
-        mscConnector: MSCConnectorAdapter,
+        mscConnector: MSCConnectorAdapter,
-        cmacgmConnector: CMACGMConnectorAdapter,
+        cmacgmConnector: CMACGMConnectorAdapter,
-        hapagConnector: HapagLloydConnectorAdapter,
+        hapagConnector: HapagLloydConnectorAdapter,
-        oneConnector: ONEConnectorAdapter,
+        oneConnector: ONEConnectorAdapter,
-      ) => {
+      ) => {
-        return [
+        return [
-          maerskConnector,
+          maerskConnector,
-          mscConnector,
+          mscConnector,
-          cmacgmConnector,
+          cmacgmConnector,
-          hapagConnector,
+          hapagConnector,
-          oneConnector,
+          oneConnector,
-        ];
+        ];
-      },
+      },
-      inject: [
+      inject: [
-        MaerskConnector,
+        MaerskConnector,
-        MSCConnectorAdapter,
+        MSCConnectorAdapter,
-        CMACGMConnectorAdapter,
+        CMACGMConnectorAdapter,
-        HapagLloydConnectorAdapter,
+        HapagLloydConnectorAdapter,
-        ONEConnectorAdapter,
+        ONEConnectorAdapter,
-      ],
+      ],
-    },
+    },
-  ],
+  ],
-  exports: [
+  exports: [
-    'CarrierConnectors',
+    'CarrierConnectors',
-    MaerskConnector,
+    MaerskConnector,
-    MSCConnectorAdapter,
+    MSCConnectorAdapter,
-    CMACGMConnectorAdapter,
+    CMACGMConnectorAdapter,
-    HapagLloydConnectorAdapter,
+    HapagLloydConnectorAdapter,
-    ONEConnectorAdapter,
+    ONEConnectorAdapter,
-  ],
+  ],
-})
+})
-export class CarrierModule {}
+export class CarrierModule {}

apps/backend/src/infrastructure/carriers/maersk/maersk-request.mapper.ts

@@ -1,54 +1,54 @@
-/**
+/**
- * Maersk Request Mapper
+ * Maersk Request Mapper
- *
+ *
- * Maps internal domain format to Maersk API format
+ * Maps internal domain format to Maersk API format
- */
+ */
-
+
-import { CarrierRateSearchInput } from '../../../domain/ports/out/carrier-connector.port';
+import { CarrierRateSearchInput } from '../../../domain/ports/out/carrier-connector.port';
-import { MaerskRateSearchRequest } from './maersk.types';
+import { MaerskRateSearchRequest } from './maersk.types';
-
+
-export class MaerskRequestMapper {
+export class MaerskRequestMapper {
-  /**
+  /**
-   * Map domain rate search input to Maersk API request
+   * Map domain rate search input to Maersk API request
-   */
+   */
-  static toMaerskRateSearchRequest(input: CarrierRateSearchInput): MaerskRateSearchRequest {
+  static toMaerskRateSearchRequest(input: CarrierRateSearchInput): MaerskRateSearchRequest {
-    const { size, type } = this.parseContainerType(input.containerType);
+    const { size, type } = this.parseContainerType(input.containerType);
-
+
-    return {
+    return {
-      originPortCode: input.origin,
+      originPortCode: input.origin,
-      destinationPortCode: input.destination,
+      destinationPortCode: input.destination,
-      containerSize: size,
+      containerSize: size,
-      containerType: type,
+      containerType: type,
-      cargoMode: input.mode,
+      cargoMode: input.mode,
-      estimatedDepartureDate: input.departureDate.toISOString(),
+      estimatedDepartureDate: input.departureDate.toISOString(),
-      numberOfContainers: input.quantity || 1,
+      numberOfContainers: input.quantity || 1,
-      cargoWeight: input.weight,
+      cargoWeight: input.weight,
-      cargoVolume: input.volume,
+      cargoVolume: input.volume,
-      isDangerousGoods: input.isHazmat || false,
+      isDangerousGoods: input.isHazmat || false,
-      imoClass: input.imoClass,
+      imoClass: input.imoClass,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Parse container type (e.g., '40HC' -> { size: '40', type: 'DRY' })
+   * Parse container type (e.g., '40HC' -> { size: '40', type: 'DRY' })
-   */
+   */
-  private static parseContainerType(containerType: string): { size: string; type: string } {
+  private static parseContainerType(containerType: string): { size: string; type: string } {
-    // Extract size (first 2 digits)
+    // Extract size (first 2 digits)
-    const sizeMatch = containerType.match(/^(\d{2})/);
+    const sizeMatch = containerType.match(/^(\d{2})/);
-    const size = sizeMatch ? sizeMatch[1] : '40';
+    const size = sizeMatch ? sizeMatch[1] : '40';
-
+
-    // Determine type
+    // Determine type
-    let type = 'DRY';
+    let type = 'DRY';
-    if (containerType.includes('REEFER')) {
+    if (containerType.includes('REEFER')) {
-      type = 'REEFER';
+      type = 'REEFER';
-    } else if (containerType.includes('OT')) {
+    } else if (containerType.includes('OT')) {
-      type = 'OPEN_TOP';
+      type = 'OPEN_TOP';
-    } else if (containerType.includes('FR')) {
+    } else if (containerType.includes('FR')) {
-      type = 'FLAT_RACK';
+      type = 'FLAT_RACK';
-    } else if (containerType.includes('TANK')) {
+    } else if (containerType.includes('TANK')) {
-      type = 'TANK';
+      type = 'TANK';
-    }
+    }
-
+
-    return { size, type };
+    return { size, type };
-  }
+  }
-}
+}

apps/backend/src/infrastructure/carriers/maersk/maersk-response.mapper.ts

@@ -1,111 +1,111 @@
-/**
+/**
- * Maersk Response Mapper
+ * Maersk Response Mapper
- *
+ *
- * Maps Maersk API response to domain entities
+ * Maps Maersk API response to domain entities
- */
+ */
-
+
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4 } from 'uuid';
-import { RateQuote } from '../../../domain/entities/rate-quote.entity';
+import { RateQuote } from '../../../domain/entities/rate-quote.entity';
-import { MaerskRateSearchResponse, MaerskRateResult, MaerskRouteSegment } from './maersk.types';
+import { MaerskRateSearchResponse, MaerskRateResult, MaerskRouteSegment } from './maersk.types';
-
+
-export class MaerskResponseMapper {
+export class MaerskResponseMapper {
-  /**
+  /**
-   * Map Maersk API response to domain RateQuote entities
+   * Map Maersk API response to domain RateQuote entities
-   */
+   */
-  static toRateQuotes(
+  static toRateQuotes(
-    response: MaerskRateSearchResponse,
+    response: MaerskRateSearchResponse,
-    originCode: string,
+    originCode: string,
-    destinationCode: string
+    destinationCode: string
-  ): RateQuote[] {
+  ): RateQuote[] {
-    return response.results.map((result) => this.toRateQuote(result, originCode, destinationCode));
+    return response.results.map((result) => this.toRateQuote(result, originCode, destinationCode));
-  }
+  }
-
+
-  /**
+  /**
-   * Map single Maersk rate result to RateQuote domain entity
+   * Map single Maersk rate result to RateQuote domain entity
-   */
+   */
-  private static toRateQuote(
+  private static toRateQuote(
-    result: MaerskRateResult,
+    result: MaerskRateResult,
-    originCode: string,
+    originCode: string,
-    destinationCode: string
+    destinationCode: string
-  ): RateQuote {
+  ): RateQuote {
-    const surcharges = result.pricing.charges.map((charge) => ({
+    const surcharges = result.pricing.charges.map((charge) => ({
-      type: charge.chargeCode,
+      type: charge.chargeCode,
-      description: charge.chargeName,
+      description: charge.chargeName,
-      amount: charge.amount,
+      amount: charge.amount,
-      currency: charge.currency,
+      currency: charge.currency,
-    }));
+    }));
-
+
-    const route = result.schedule.routeSchedule.map((segment) =>
+    const route = result.schedule.routeSchedule.map((segment) =>
-      this.mapRouteSegment(segment)
+      this.mapRouteSegment(segment)
-    );
+    );
-
+
-    return RateQuote.create({
+    return RateQuote.create({
-      id: uuidv4(),
+      id: uuidv4(),
-      carrierId: 'maersk-carrier-id', // TODO: Get from carrier repository
+      carrierId: 'maersk-carrier-id', // TODO: Get from carrier repository
-      carrierName: 'Maersk Line',
+      carrierName: 'Maersk Line',
-      carrierCode: 'MAERSK',
+      carrierCode: 'MAERSK',
-      origin: {
+      origin: {
-        code: result.routeDetails.origin.unlocCode,
+        code: result.routeDetails.origin.unlocCode,
-        name: result.routeDetails.origin.cityName,
+        name: result.routeDetails.origin.cityName,
-        country: result.routeDetails.origin.countryName,
+        country: result.routeDetails.origin.countryName,
-      },
+      },
-      destination: {
+      destination: {
-        code: result.routeDetails.destination.unlocCode,
+        code: result.routeDetails.destination.unlocCode,
-        name: result.routeDetails.destination.cityName,
+        name: result.routeDetails.destination.cityName,
-        country: result.routeDetails.destination.countryName,
+        country: result.routeDetails.destination.countryName,
-      },
+      },
-      pricing: {
+      pricing: {
-        baseFreight: result.pricing.oceanFreight,
+        baseFreight: result.pricing.oceanFreight,
-        surcharges,
+        surcharges,
-        totalAmount: result.pricing.totalAmount,
+        totalAmount: result.pricing.totalAmount,
-        currency: result.pricing.currency,
+        currency: result.pricing.currency,
-      },
+      },
-      containerType: this.mapContainerType(result.equipment.type),
+      containerType: this.mapContainerType(result.equipment.type),
-      mode: 'FCL', // Maersk typically handles FCL
+      mode: 'FCL', // Maersk typically handles FCL
-      etd: new Date(result.routeDetails.departureDate),
+      etd: new Date(result.routeDetails.departureDate),
-      eta: new Date(result.routeDetails.arrivalDate),
+      eta: new Date(result.routeDetails.arrivalDate),
-      transitDays: result.routeDetails.transitTime,
+      transitDays: result.routeDetails.transitTime,
-      route,
+      route,
-      availability: result.bookingDetails.equipmentAvailability,
+      availability: result.bookingDetails.equipmentAvailability,
-      frequency: result.schedule.frequency,
+      frequency: result.schedule.frequency,
-      vesselType: result.vesselInfo?.type,
+      vesselType: result.vesselInfo?.type,
-      co2EmissionsKg: result.sustainability?.co2Emissions,
+      co2EmissionsKg: result.sustainability?.co2Emissions,
-    });
+    });
-  }
+  }
-
+
-  /**
+  /**
-   * Map Maersk route segment to domain format
+   * Map Maersk route segment to domain format
-   */
+   */
-  private static mapRouteSegment(segment: MaerskRouteSegment): any {
+  private static mapRouteSegment(segment: MaerskRouteSegment): any {
-    return {
+    return {
-      portCode: segment.portCode,
+      portCode: segment.portCode,
-      portName: segment.portName,
+      portName: segment.portName,
-      arrival: segment.arrivalDate ? new Date(segment.arrivalDate) : undefined,
+      arrival: segment.arrivalDate ? new Date(segment.arrivalDate) : undefined,
-      departure: segment.departureDate ? new Date(segment.departureDate) : undefined,
+      departure: segment.departureDate ? new Date(segment.departureDate) : undefined,
-      vesselName: segment.vesselName,
+      vesselName: segment.vesselName,
-      voyageNumber: segment.voyageNumber,
+      voyageNumber: segment.voyageNumber,
-    };
+    };
-  }
+  }
-
+
-  /**
+  /**
-   * Map Maersk container type to internal format
+   * Map Maersk container type to internal format
-   */
+   */
-  private static mapContainerType(maerskType: string): string {
+  private static mapContainerType(maerskType: string): string {
-    // Map Maersk container types to standard format
+    // Map Maersk container types to standard format
-    const typeMap: { [key: string]: string } = {
+    const typeMap: { [key: string]: string } = {
-      '20DRY': '20DRY',
+      '20DRY': '20DRY',
-      '40DRY': '40DRY',
+      '40DRY': '40DRY',
-      '40HC': '40HC',
+      '40HC': '40HC',
-      '45HC': '45HC',
+      '45HC': '45HC',
-      '20REEFER': '20REEFER',
+      '20REEFER': '20REEFER',
-      '40REEFER': '40REEFER',
+      '40REEFER': '40REEFER',
-      '40HCREEFER': '40HCREEFER',
+      '40HCREEFER': '40HCREEFER',
-      '20OT': '20OT',
+      '20OT': '20OT',
-      '40OT': '40OT',
+      '40OT': '40OT',
-      '20FR': '20FR',
+      '20FR': '20FR',
-      '40FR': '40FR',
+      '40FR': '40FR',
-    };
+    };
-
+
-    return typeMap[maerskType] || maerskType;
+    return typeMap[maerskType] || maerskType;
-  }
+  }
-}
+}

apps/backend/src/infrastructure/carriers/maersk/maersk.connector.ts

@@ -1,110 +1,110 @@
-/**
+/**
- * Maersk Connector
+ * Maersk Connector
- *
+ *
- * Implementation of CarrierConnectorPort for Maersk API
+ * Implementation of CarrierConnectorPort for Maersk API
- */
+ */
-
+
-import { Injectable } from '@nestjs/common';
+import { Injectable } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
+import { ConfigService } from '@nestjs/config';
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4 } from 'uuid';
-import { BaseCarrierConnector, CarrierConfig } from '../base-carrier.connector';
+import { BaseCarrierConnector, CarrierConfig } from '../base-carrier.connector';
-import {
+import {
-  CarrierRateSearchInput,
+  CarrierRateSearchInput,
-  CarrierAvailabilityInput,
+  CarrierAvailabilityInput,
-} from '../../../domain/ports/out/carrier-connector.port';
+} from '../../../domain/ports/out/carrier-connector.port';
-import { RateQuote } from '../../../domain/entities/rate-quote.entity';
+import { RateQuote } from '../../../domain/entities/rate-quote.entity';
-import { MaerskRequestMapper } from './maersk-request.mapper';
+import { MaerskRequestMapper } from './maersk-request.mapper';
-import { MaerskResponseMapper } from './maersk-response.mapper';
+import { MaerskResponseMapper } from './maersk-response.mapper';
-import { MaerskRateSearchRequest, MaerskRateSearchResponse } from './maersk.types';
+import { MaerskRateSearchRequest, MaerskRateSearchResponse } from './maersk.types';
-
+
-@Injectable()
+@Injectable()
-export class MaerskConnector extends BaseCarrierConnector {
+export class MaerskConnector extends BaseCarrierConnector {
-  constructor(private readonly configService: ConfigService) {
+  constructor(private readonly configService: ConfigService) {
-    const config: CarrierConfig = {
+    const config: CarrierConfig = {
-      name: 'Maersk',
+      name: 'Maersk',
-      code: 'MAERSK',
+      code: 'MAERSK',
-      baseUrl: configService.get<string>('MAERSK_API_BASE_URL', 'https://api.maersk.com/v1'),
+      baseUrl: configService.get<string>('MAERSK_API_BASE_URL', 'https://api.maersk.com/v1'),
-      timeout: 5000, // 5 seconds
+      timeout: 5000, // 5 seconds
-      maxRetries: 2,
+      maxRetries: 2,
-      circuitBreakerThreshold: 50, // Open circuit after 50% failures
+      circuitBreakerThreshold: 50, // Open circuit after 50% failures
-      circuitBreakerTimeout: 30000, // Wait 30s before half-open
+      circuitBreakerTimeout: 30000, // Wait 30s before half-open
-    };
+    };
-
+
-    super(config);
+    super(config);
-  }
+  }
-
+
-  async searchRates(input: CarrierRateSearchInput): Promise<RateQuote[]> {
+  async searchRates(input: CarrierRateSearchInput): Promise<RateQuote[]> {
-    try {
+    try {
-      // Map domain input to Maersk API format
+      // Map domain input to Maersk API format
-      const maerskRequest = MaerskRequestMapper.toMaerskRateSearchRequest(input);
+      const maerskRequest = MaerskRequestMapper.toMaerskRateSearchRequest(input);
-
+
-      // Make API request with circuit breaker
+      // Make API request with circuit breaker
-      const response = await this.requestWithCircuitBreaker<MaerskRateSearchResponse>({
+      const response = await this.requestWithCircuitBreaker<MaerskRateSearchResponse>({
-        method: 'POST',
+        method: 'POST',
-        url: '/rates/search',
+        url: '/rates/search',
-        data: maerskRequest,
+        data: maerskRequest,
-        headers: {
+        headers: {
-          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
+          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
-        },
+        },
-      });
+      });
-
+
-      // Map Maersk API response to domain entities
+      // Map Maersk API response to domain entities
-      const rateQuotes = MaerskResponseMapper.toRateQuotes(
+      const rateQuotes = MaerskResponseMapper.toRateQuotes(
-        response.data,
+        response.data,
-        input.origin,
+        input.origin,
-        input.destination
+        input.destination
-      );
+      );
-
+
-      this.logger.log(`Found ${rateQuotes.length} rate quotes from Maersk`);
+      this.logger.log(`Found ${rateQuotes.length} rate quotes from Maersk`);
-      return rateQuotes;
+      return rateQuotes;
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error searching Maersk rates: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error searching Maersk rates: ${error?.message || 'Unknown error'}`);
-      // Return empty array instead of throwing - allows other carriers to succeed
+      // Return empty array instead of throwing - allows other carriers to succeed
-      return [];
+      return [];
-    }
+    }
-  }
+  }
-
+
-  async checkAvailability(input: CarrierAvailabilityInput): Promise<number> {
+  async checkAvailability(input: CarrierAvailabilityInput): Promise<number> {
-    try {
+    try {
-      const response = await this.requestWithCircuitBreaker<{ availability: number }>({
+      const response = await this.requestWithCircuitBreaker<{ availability: number }>({
-        method: 'POST',
+        method: 'POST',
-        url: '/availability/check',
+        url: '/availability/check',
-        data: {
+        data: {
-          origin: input.origin,
+          origin: input.origin,
-          destination: input.destination,
+          destination: input.destination,
-          containerType: input.containerType,
+          containerType: input.containerType,
-          departureDate: input.departureDate.toISOString(),
+          departureDate: input.departureDate.toISOString(),
-          quantity: input.quantity,
+          quantity: input.quantity,
-        },
+        },
-        headers: {
+        headers: {
-          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
+          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
-        },
+        },
-      });
+      });
-
+
-      return response.data.availability;
+      return response.data.availability;
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.error(`Error checking Maersk availability: ${error?.message || 'Unknown error'}`);
+      this.logger.error(`Error checking Maersk availability: ${error?.message || 'Unknown error'}`);
-      return 0;
+      return 0;
-    }
+    }
-  }
+  }
-
+
-  /**
+  /**
-   * Override health check to use Maersk-specific endpoint
+   * Override health check to use Maersk-specific endpoint
-   */
+   */
-  async healthCheck(): Promise<boolean> {
+  async healthCheck(): Promise<boolean> {
-    try {
+    try {
-      await this.requestWithCircuitBreaker({
+      await this.requestWithCircuitBreaker({
-        method: 'GET',
+        method: 'GET',
-        url: '/status',
+        url: '/status',
-        timeout: 3000,
+        timeout: 3000,
-        headers: {
+        headers: {
-          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
+          'API-Key': this.configService.get<string>('MAERSK_API_KEY'),
-        },
+        },
-      });
+      });
-      return true;
+      return true;
-    } catch (error: any) {
+    } catch (error: any) {
-      this.logger.warn(`Maersk health check failed: ${error?.message || 'Unknown error'}`);
+      this.logger.warn(`Maersk health check failed: ${error?.message || 'Unknown error'}`);
-      return false;
+      return false;
-    }
+    }
-  }
+  }
-}
+}

apps/backend/src/infrastructure/carriers/maersk/maersk.types.ts

@@ -1,110 +1,110 @@
-/**
+/**
- * Maersk API Types
+ * Maersk API Types
- *
+ *
- * Type definitions for Maersk API requests and responses
+ * Type definitions for Maersk API requests and responses
- */
+ */
-
+
-export interface MaerskRateSearchRequest {
+export interface MaerskRateSearchRequest {
-  originPortCode: string;
+  originPortCode: string;
-  destinationPortCode: string;
+  destinationPortCode: string;
-  containerSize: string; // '20', '40', '45'
+  containerSize: string; // '20', '40', '45'
-  containerType: string; // 'DRY', 'REEFER', etc.
+  containerType: string; // 'DRY', 'REEFER', etc.
-  cargoMode: 'FCL' | 'LCL';
+  cargoMode: 'FCL' | 'LCL';
-  estimatedDepartureDate: string; // ISO 8601
+  estimatedDepartureDate: string; // ISO 8601
-  numberOfContainers?: number;
+  numberOfContainers?: number;
-  cargoWeight?: number; // kg
+  cargoWeight?: number; // kg
-  cargoVolume?: number; // CBM
+  cargoVolume?: number; // CBM
-  isDangerousGoods?: boolean;
+  isDangerousGoods?: boolean;
-  imoClass?: string;
+  imoClass?: string;
-}
+}
-
+
-export interface MaerskRateSearchResponse {
+export interface MaerskRateSearchResponse {
-  searchId: string;
+  searchId: string;
-  searchDate: string;
+  searchDate: string;
-  results: MaerskRateResult[];
+  results: MaerskRateResult[];
-}
+}
-
+
-export interface MaerskRateResult {
+export interface MaerskRateResult {
-  quoteId: string;
+  quoteId: string;
-  routeDetails: {
+  routeDetails: {
-    origin: MaerskPort;
+    origin: MaerskPort;
-    destination: MaerskPort;
+    destination: MaerskPort;
-    transitTime: number; // days
+    transitTime: number; // days
-    departureDate: string; // ISO 8601
+    departureDate: string; // ISO 8601
-    arrivalDate: string; // ISO 8601
+    arrivalDate: string; // ISO 8601
-  };
+  };
-  pricing: {
+  pricing: {
-    oceanFreight: number;
+    oceanFreight: number;
-    currency: string;
+    currency: string;
-    charges: MaerskCharge[];
+    charges: MaerskCharge[];
-    totalAmount: number;
+    totalAmount: number;
-  };
+  };
-  equipment: {
+  equipment: {
-    type: string;
+    type: string;
-    quantity: number;
+    quantity: number;
-  };
+  };
-  schedule: {
+  schedule: {
-    routeSchedule: MaerskRouteSegment[];
+    routeSchedule: MaerskRouteSegment[];
-    frequency: string;
+    frequency: string;
-    serviceString: string;
+    serviceString: string;
-  };
+  };
-  vesselInfo?: {
+  vesselInfo?: {
-    name: string;
+    name: string;
-    type: string;
+    type: string;
-    operator: string;
+    operator: string;
-  };
+  };
-  bookingDetails: {
+  bookingDetails: {
-    validUntil: string; // ISO 8601
+    validUntil: string; // ISO 8601
-    equipmentAvailability: number;
+    equipmentAvailability: number;
-  };
+  };
-  sustainability?: {
+  sustainability?: {
-    co2Emissions: number; // kg
+    co2Emissions: number; // kg
-    co2PerTEU: number;
+    co2PerTEU: number;
-  };
+  };
-}
+}
-
+
-export interface MaerskPort {
+export interface MaerskPort {
-  unlocCode: string;
+  unlocCode: string;
-  cityName: string;
+  cityName: string;
-  countryName: string;
+  countryName: string;
-  countryCode: string;
+  countryCode: string;
-}
+}
-
+
-export interface MaerskCharge {
+export interface MaerskCharge {
-  chargeCode: string;
+  chargeCode: string;
-  chargeName: string;
+  chargeName: string;
-  amount: number;
+  amount: number;
-  currency: string;
+  currency: string;
-}
+}
-
+
-export interface MaerskRouteSegment {
+export interface MaerskRouteSegment {
-  sequenceNumber: number;
+  sequenceNumber: number;
-  portCode: string;
+  portCode: string;
-  portName: string;
+  portName: string;
-  countryCode: string;
+  countryCode: string;
-  arrivalDate?: string;
+  arrivalDate?: string;
-  departureDate?: string;
+  departureDate?: string;
-  vesselName?: string;
+  vesselName?: string;
-  voyageNumber?: string;
+  voyageNumber?: string;
-  transportMode: 'VESSEL' | 'TRUCK' | 'RAIL';
+  transportMode: 'VESSEL' | 'TRUCK' | 'RAIL';
-}
+}
-
+
-export interface MaerskAvailabilityRequest {
+export interface MaerskAvailabilityRequest {
-  origin: string;
+  origin: string;
-  destination: string;
+  destination: string;
-  containerType: string;
+  containerType: string;
-  departureDate: string;
+  departureDate: string;
-  quantity: number;
+  quantity: number;
-}
+}
-
+
-export interface MaerskAvailabilityResponse {
+export interface MaerskAvailabilityResponse {
-  availability: number;
+  availability: number;
-  validUntil: string;
+  validUntil: string;
-}
+}
-
+
-export interface MaerskErrorResponse {
+export interface MaerskErrorResponse {
-  errorCode: string;
+  errorCode: string;
-  errorMessage: string;
+  errorMessage: string;
-  timestamp: string;
+  timestamp: string;
-  path: string;
+  path: string;
-}
+}

apps/backend/src/infrastructure/persistence/typeorm/data-source.ts

@@ -1,27 +1,27 @@
-/**
+/**
- * TypeORM Data Source Configuration
+ * TypeORM Data Source Configuration
- *
+ *
- * Used for migrations and CLI commands
+ * Used for migrations and CLI commands
- */
+ */
-
+
-import { DataSource } from 'typeorm';
+import { DataSource } from 'typeorm';
-import { config } from 'dotenv';
+import { config } from 'dotenv';
-import { join } from 'path';
+import { join } from 'path';
-
+
-// Load environment variables
+// Load environment variables
-config();
+config();
-
+
-export const AppDataSource = new DataSource({
+export const AppDataSource = new DataSource({
-  type: 'postgres',
+  type: 'postgres',
-  host: process.env.DATABASE_HOST || 'localhost',
+  host: process.env.DATABASE_HOST || 'localhost',
-  port: parseInt(process.env.DATABASE_PORT || '5432', 10),
+  port: parseInt(process.env.DATABASE_PORT || '5432', 10),
-  username: process.env.DATABASE_USER || 'xpeditis',
+  username: process.env.DATABASE_USER || 'xpeditis',
-  password: process.env.DATABASE_PASSWORD || 'xpeditis_dev_password',
+  password: process.env.DATABASE_PASSWORD || 'xpeditis_dev_password',
-  database: process.env.DATABASE_NAME || 'xpeditis_dev',
+  database: process.env.DATABASE_NAME || 'xpeditis_dev',
-  entities: [join(__dirname, 'entities', '*.orm-entity.{ts,js}')],
+  entities: [join(__dirname, 'entities', '*.orm-entity.{ts,js}')],
-  migrations: [join(__dirname, 'migrations', '*.{ts,js}')],
+  migrations: [join(__dirname, 'migrations', '*.{ts,js}')],
-  subscribers: [],
+  subscribers: [],
-  synchronize: false, // Never use in production
+  synchronize: false, // Never use in production
-  logging: process.env.NODE_ENV === 'development',
+  logging: process.env.NODE_ENV === 'development',
-  ssl: process.env.DATABASE_SSL === 'true' ? { rejectUnauthorized: false } : false,
+  ssl: process.env.DATABASE_SSL === 'true' ? { rejectUnauthorized: false } : false,
-});
+});

apps/backend/src/infrastructure/persistence/typeorm/entities/carrier.orm-entity.ts

@@ -1,47 +1,47 @@
-/**
+/**
- * Carrier ORM Entity (Infrastructure Layer)
+ * Carrier ORM Entity (Infrastructure Layer)
- *
+ *
- * TypeORM entity for carrier persistence
+ * TypeORM entity for carrier persistence
- */
+ */
-
+
-import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
+import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
-
+
-@Entity('carriers')
+@Entity('carriers')
-@Index('idx_carriers_code', ['code'])
+@Index('idx_carriers_code', ['code'])
-@Index('idx_carriers_scac', ['scac'])
+@Index('idx_carriers_scac', ['scac'])
-@Index('idx_carriers_active', ['isActive'])
+@Index('idx_carriers_active', ['isActive'])
-@Index('idx_carriers_supports_api', ['supportsApi'])
+@Index('idx_carriers_supports_api', ['supportsApi'])
-export class CarrierOrmEntity {
+export class CarrierOrmEntity {
-  @PrimaryColumn('uuid')
+  @PrimaryColumn('uuid')
-  id: string;
+  id: string;
-
+
-  @Column({ type: 'varchar', length: 255 })
+  @Column({ type: 'varchar', length: 255 })
-  name: string;
+  name: string;
-
+
-  @Column({ type: 'varchar', length: 50, unique: true })
+  @Column({ type: 'varchar', length: 50, unique: true })
-  code: string;
+  code: string;
-
+
-  @Column({ type: 'char', length: 4, unique: true })
+  @Column({ type: 'char', length: 4, unique: true })
-  scac: string;
+  scac: string;
-
+
-  @Column({ name: 'logo_url', type: 'text', nullable: true })
+  @Column({ name: 'logo_url', type: 'text', nullable: true })
-  logoUrl: string | null;
+  logoUrl: string | null;
-
+
-  @Column({ type: 'text', nullable: true })
+  @Column({ type: 'text', nullable: true })
-  website: string | null;
+  website: string | null;
-
+
-  @Column({ name: 'api_config', type: 'jsonb', nullable: true })
+  @Column({ name: 'api_config', type: 'jsonb', nullable: true })
-  apiConfig: any | null;
+  apiConfig: any | null;
-
+
-  @Column({ name: 'is_active', type: 'boolean', default: true })
+  @Column({ name: 'is_active', type: 'boolean', default: true })
-  isActive: boolean;
+  isActive: boolean;
-
+
-  @Column({ name: 'supports_api', type: 'boolean', default: false })
+  @Column({ name: 'supports_api', type: 'boolean', default: false })
-  supportsApi: boolean;
+  supportsApi: boolean;
-
+
-  @CreateDateColumn({ name: 'created_at' })
+  @CreateDateColumn({ name: 'created_at' })
-  createdAt: Date;
+  createdAt: Date;
-
+
-  @UpdateDateColumn({ name: 'updated_at' })
+  @UpdateDateColumn({ name: 'updated_at' })
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}

apps/backend/src/infrastructure/persistence/typeorm/entities/index.ts

@@ -1,11 +1,11 @@
-/**
+/**
- * TypeORM Entities Barrel Export
+ * TypeORM Entities Barrel Export
- *
+ *
- * All ORM entities for persistence layer
+ * All ORM entities for persistence layer
- */
+ */
-
+
-export * from './organization.orm-entity';
+export * from './organization.orm-entity';
-export * from './user.orm-entity';
+export * from './user.orm-entity';
-export * from './carrier.orm-entity';
+export * from './carrier.orm-entity';
-export * from './port.orm-entity';
+export * from './port.orm-entity';
-export * from './rate-quote.orm-entity';
+export * from './rate-quote.orm-entity';

apps/backend/src/infrastructure/persistence/typeorm/entities/organization.orm-entity.ts

@@ -1,55 +1,55 @@
-/**
+/**
- * Organization ORM Entity (Infrastructure Layer)
+ * Organization ORM Entity (Infrastructure Layer)
- *
+ *
- * TypeORM entity for organization persistence
+ * TypeORM entity for organization persistence
- */
+ */
-
+
-import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
+import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
-
+
-@Entity('organizations')
+@Entity('organizations')
-@Index('idx_organizations_type', ['type'])
+@Index('idx_organizations_type', ['type'])
-@Index('idx_organizations_scac', ['scac'])
+@Index('idx_organizations_scac', ['scac'])
-@Index('idx_organizations_active', ['isActive'])
+@Index('idx_organizations_active', ['isActive'])
-export class OrganizationOrmEntity {
+export class OrganizationOrmEntity {
-  @PrimaryColumn('uuid')
+  @PrimaryColumn('uuid')
-  id: string;
+  id: string;
-
+
-  @Column({ type: 'varchar', length: 255, unique: true })
+  @Column({ type: 'varchar', length: 255, unique: true })
-  name: string;
+  name: string;
-
+
-  @Column({ type: 'varchar', length: 50 })
+  @Column({ type: 'varchar', length: 50 })
-  type: string;
+  type: string;
-
+
-  @Column({ type: 'char', length: 4, nullable: true, unique: true })
+  @Column({ type: 'char', length: 4, nullable: true, unique: true })
-  scac: string | null;
+  scac: string | null;
-
+
-  @Column({ name: 'address_street', type: 'varchar', length: 255 })
+  @Column({ name: 'address_street', type: 'varchar', length: 255 })
-  addressStreet: string;
+  addressStreet: string;
-
+
-  @Column({ name: 'address_city', type: 'varchar', length: 100 })
+  @Column({ name: 'address_city', type: 'varchar', length: 100 })
-  addressCity: string;
+  addressCity: string;
-
+
-  @Column({ name: 'address_state', type: 'varchar', length: 100, nullable: true })
+  @Column({ name: 'address_state', type: 'varchar', length: 100, nullable: true })
-  addressState: string | null;
+  addressState: string | null;
-
+
-  @Column({ name: 'address_postal_code', type: 'varchar', length: 20 })
+  @Column({ name: 'address_postal_code', type: 'varchar', length: 20 })
-  addressPostalCode: string;
+  addressPostalCode: string;
-
+
-  @Column({ name: 'address_country', type: 'char', length: 2 })
+  @Column({ name: 'address_country', type: 'char', length: 2 })
-  addressCountry: string;
+  addressCountry: string;
-
+
-  @Column({ name: 'logo_url', type: 'text', nullable: true })
+  @Column({ name: 'logo_url', type: 'text', nullable: true })
-  logoUrl: string | null;
+  logoUrl: string | null;
-
+
-  @Column({ type: 'jsonb', default: '[]' })
+  @Column({ type: 'jsonb', default: '[]' })
-  documents: any[];
+  documents: any[];
-
+
-  @Column({ name: 'is_active', type: 'boolean', default: true })
+  @Column({ name: 'is_active', type: 'boolean', default: true })
-  isActive: boolean;
+  isActive: boolean;
-
+
-  @CreateDateColumn({ name: 'created_at' })
+  @CreateDateColumn({ name: 'created_at' })
-  createdAt: Date;
+  createdAt: Date;
-
+
-  @UpdateDateColumn({ name: 'updated_at' })
+  @UpdateDateColumn({ name: 'updated_at' })
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}

apps/backend/src/infrastructure/persistence/typeorm/entities/port.orm-entity.ts

@@ -1,52 +1,52 @@
-/**
+/**
- * Port ORM Entity (Infrastructure Layer)
+ * Port ORM Entity (Infrastructure Layer)
- *
+ *
- * TypeORM entity for port persistence
+ * TypeORM entity for port persistence
- */
+ */
-
+
-import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
+import { Entity, Column, PrimaryColumn, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
-
+
-@Entity('ports')
+@Entity('ports')
-@Index('idx_ports_code', ['code'])
+@Index('idx_ports_code', ['code'])
-@Index('idx_ports_country', ['country'])
+@Index('idx_ports_country', ['country'])
-@Index('idx_ports_active', ['isActive'])
+@Index('idx_ports_active', ['isActive'])
-@Index('idx_ports_name_trgm', ['name'])
+@Index('idx_ports_name_trgm', ['name'])
-@Index('idx_ports_city_trgm', ['city'])
+@Index('idx_ports_city_trgm', ['city'])
-@Index('idx_ports_coordinates', ['latitude', 'longitude'])
+@Index('idx_ports_coordinates', ['latitude', 'longitude'])
-export class PortOrmEntity {
+export class PortOrmEntity {
-  @PrimaryColumn('uuid')
+  @PrimaryColumn('uuid')
-  id: string;
+  id: string;
-
+
-  @Column({ type: 'char', length: 5, unique: true })
+  @Column({ type: 'char', length: 5, unique: true })
-  code: string;
+  code: string;
-
+
-  @Column({ type: 'varchar', length: 255 })
+  @Column({ type: 'varchar', length: 255 })
-  name: string;
+  name: string;
-
+
-  @Column({ type: 'varchar', length: 255 })
+  @Column({ type: 'varchar', length: 255 })
-  city: string;
+  city: string;
-
+
-  @Column({ type: 'char', length: 2 })
+  @Column({ type: 'char', length: 2 })
-  country: string;
+  country: string;
-
+
-  @Column({ name: 'country_name', type: 'varchar', length: 100 })
+  @Column({ name: 'country_name', type: 'varchar', length: 100 })
-  countryName: string;
+  countryName: string;
-
+
-  @Column({ type: 'decimal', precision: 9, scale: 6 })
+  @Column({ type: 'decimal', precision: 9, scale: 6 })
-  latitude: number;
+  latitude: number;
-
+
-  @Column({ type: 'decimal', precision: 9, scale: 6 })
+  @Column({ type: 'decimal', precision: 9, scale: 6 })
-  longitude: number;
+  longitude: number;
-
+
-  @Column({ type: 'varchar', length: 50, nullable: true })
+  @Column({ type: 'varchar', length: 50, nullable: true })
-  timezone: string | null;
+  timezone: string | null;
-
+
-  @Column({ name: 'is_active', type: 'boolean', default: true })
+  @Column({ name: 'is_active', type: 'boolean', default: true })
-  isActive: boolean;
+  isActive: boolean;
-
+
-  @CreateDateColumn({ name: 'created_at' })
+  @CreateDateColumn({ name: 'created_at' })
-  createdAt: Date;
+  createdAt: Date;
-
+
-  @UpdateDateColumn({ name: 'updated_at' })
+  @UpdateDateColumn({ name: 'updated_at' })
-  updatedAt: Date;
+  updatedAt: Date;
-}
+}