Focus: Change Logs Migration to Standalone Astro Pages & Global Style Centralization

• a. [03_landingPage] (Landing Page): Migrated all client app and API iteration change logs into dedicated standalone Astro pages (app-v0-0-1.astro to app-v0-0-6.astro, api-v1-0-0.astro, freeradius-saga.astro).
• b. [global.css] (Styles): Centralized all landing page design system tokens, typography, markdown renderer, alerts, timeline, and layout styles into global.css.
• c. [nav.astro] (Header): Added universal language switcher toggle script and made header logo link to home.
• d. [documentation.astro] (Docs): Fixed tab navigation, URL parameter tab switching (?tab=...), and popstate handling.
• e. [12-app-versioning-rule.md] (Rules): Updated project versioning rule to mandate maintaining all change logs directly in 03_landingPage/src/pages/changelog/ Astro version files.
• f. [pubspec.yaml]: Bumped version to 0.0.6+60.

Focus: Universal Sub-Menu Permission Resolution Engine & Project Rule Update

• a. [09-authentification-rule.md] (Rules): Added Universal Sub-Menu Permission Resolution Rule requiring automatic candidate key expansion, parent category fallback, and hierarchical level enforcement.
• b. [auth_provider.dart] (Frontend): Implemented full Universal Sub-Menu Permission Resolution Engine with comprehensive alias dictionary (_permissionAliases) and category parent fallback.
• c. [auth_middleware.dart] (Backend): Implemented matching Universal Sub-Menu Permission Resolution Engine for backend API middleware.
• d. [pubspec.yaml]: Bumped version to 0.0.6+59.

Focus: Fix Read-Write Landmark Role Permission Engine

• a. [auth_provider.dart] (Frontend): Added key alias mapping (maps_management|landmarks <-> maps_management|landmarks_list) in hasPermission().
• b. [landmarks_list_view.dart] (Frontend): Updated write/delete permission checks to accept both landmarks_list and landmarks keys.
• c. [landmark_detail_sheet.dart] (Frontend): Added Edit IconButton to header row when canWrite permission is granted.
• d. [auth_middleware.dart] (Backend): Added key alias mapping in request.hasPermission() helper extension.
• e. [landmark_controller.dart] (Backend): Updated _createLandmark, _updateLandmark, and _deleteLandmark permission checks.
• f. [pubspec.yaml]: Bumped version to 0.0.6+58.

Focus: App update required download link redirection & localization

• a. [app_localization.dart] (Frontend): Added localized translation keys (updateRequired, updateRequiredDesc, updateNow, contactSupport) for EN and ID.
• b. [update_required_page.dart] (Frontend): Updated update button handler to launch https://swainet.id/download/ with LaunchMode.externalApplication and replaced hardcoded strings with AppLocale keys.
• c. [pubspec.yaml]: Bumped version to 0.0.6+57.

Focus: Fix Google Maps open directions launching on Android app

• a. [AndroidManifest.xml] (Android): Added <intent> queries for https and geo schemes under <queries> to comply with Android 11+ package visibility requirement.
• b. [landmark_detail_sheet.dart] (Frontend): Updated _openInGoogleMaps to use directions URL (/maps/dir/?api=1&destination=...), set LaunchMode.externalApplication, and provided geo: scheme fallback.
• c. [pubspec.yaml]: Bumped version to 0.0.6+56.

Focus: Landmark Label form field & Landmark search bar feature

• a. [app_localization.dart] (Frontend): Added localized keys for EN and ID.
• b. [map_landmark.dart] (Frontend): Added label field to MapLandmark model.
• c. [landmark_model.dart] (Backend): Added label field to LandmarkModel.
• d. [landmark_repository/controller] (Backend): Added label parameter parsing and persistence.
• e. [landmark_data_section/form_page] (Frontend): Rendered Landmark Label form input above Description section.
• f. [landmark_provider.dart] (Frontend): Updated search matching logic to query Name, Label, Theme/Category, and Description.
• g. [landmarks_list_view.dart] (Frontend): Integrated top search bar TextField and added category tag and label display.
• h. [pubspec.yaml]: Bumped version to 0.0.6+55.

Focus: Fix Employee Role Menu & Action Permission Engine (Read-Only, Read-Write, Full Access)

• a. [role_form_page.dart] (Frontend): Removed unconditional base key saving in RoleFormDialog._saveRole().
• b. [auth_provider.dart] (Frontend): Refactored AuthProvider.hasPermission() to enforce strict level checks.
• c. [landmarks_list_view.dart] (Frontend): Added canWrite and canDelete permission checks to show/hide Add and Delete buttons.
• d. [customer_management_view.dart] (Frontend): Replaced raw auth.tier == 'vendor' with permission checks.
• e. [vpn/radius/profile management] (Frontend): Differentiated write and delete permission checks.
• f. [role_management_page.dart] (Frontend): Added permission checks to show/hide create role card and role delete button.
• g. [auth_middleware.dart] (Backend): Injected permissions into request context and added request.hasPermission() helper extension.
• h. [controllers] (Backend): Added server-side permission validation on POST/PUT/DELETE routes.
• i. [pubspec.yaml]: Bumped version to 0.0.6+54.

Focus: Fix settings router prefix matching and tenant isolation checking in backend API

• a. [settings_controller.dart] (Backend): Prepended /<vendorId>/settings prefixes to all sub-routes.
• b. [pubspec.yaml]: Bumped version to 0.0.6+53.

Focus: Responsive layout refactoring for WhatsApp settings view

• a. [whatsapp_gateway_settings_view.dart] (Frontend): Wrapped form inside LayoutBuilder.
• b. [pubspec.yaml]: Bumped version to 0.0.6+52.

Focus: Remove unused _staffDataSource field from CustomerSyncRepository

• a. [customer_sync_repository.dart] (Backend): Removed unused _staffDataSource field.
• b. [server.dart] (Backend): Removed staffDataSource argument from CustomerSyncRepository.
• c. [pubspec.yaml]: Bumped version to 0.0.6+51.

Focus: Fix named parameters error in updateCustomer signature

• a. [customer_repository.dart]: Added missing optional named parameters to updateCustomer.
• b. [pubspec.yaml]: Bumped version to 0.0.6+50.

Focus: Fix missing email parameters in CustomerModel constructor calls

• a. [customer_repository.dart]: Added required email parameter to CustomerModel constructor calls.
• b. [pubspec.yaml]: Bumped version to 0.0.6+49.

Focus: Refactor backend customer repository by splitting sync/scheduler logic

• a. [customer_repository.dart]: Extracted ONU landmark sync, PPPoE session disconnect, and automatic cron isolation scheduler logic.
• b. [customer_sync_repository.dart]: Created a dedicated repository for sync actions.
• c. [server.dart]: Mounted and wired CustomerSyncRepository dependency.
• d. [pubspec.yaml]: Bumped version to 0.0.6+48.

Focus: Refactor settings page by splitting into multiple view files

• a. [settings_management_page.dart]: Cleaned up file by moving sub-views and helpers to widgets directory.
• b. [section_card.dart]: Created generic card styling container.
• c. [general_settings_view.dart]: Created General settings tab view component.
• d. [brand_settings_view.dart]: Created Brand settings tab view component.
• e. [payment_gateway_settings_view.dart]: Created Payment Gateway settings tab view component.
• f. [account_settings_view.dart]: Created Account settings tab view component.
• g. [whatsapp_gateway_settings_view.dart]: Created WhatsApp settings tab view component.
• h. [pubspec.yaml]: Bumped version to 0.0.6+47.

Focus: Fix BoxDecoration border compiler error

• a. [settings_management_page.dart]: Changed BorderSide to Border.all.
• b. [pubspec.yaml]: Bumped version to 0.0.6+46.

Focus: Fix Undefined Variable invoiceNumber in Customer Repository

• a. [customer_repository.dart] (Backend): Declared generatedInvoiceNumber outside the conditional check.
• b. [pubspec.yaml]: Bumped version to 0.0.6+45.

Focus: Complete WhatsApp (WAHA) Integration & Multi-Tenant Session Control

• a. [.env & .env.example]: Added WAHA server environment variables.
• b. [env_config.dart]: Exposed WAHA settings properties.
• c. [whatsapp_service.dart]: Implemented WhatsApp API wrapper.
• d. [settings_remote_data_source & repository]: Implemented database CRUD and auditing.
• e. [settings_controller & server.dart]: Mounted WhatsApp control endpoints.
• f. [auth_middleware.dart]: Bypassed JWT token validation for incoming WhatsApp webhooks.
• g. [customer_repository & data_source]: Integrated WhatsApp message triggers.
• h. [app_localization.dart]: Registered WhatsApp Gateway translations.
• i. [vendor_features.dart]: Mounted settings_whatsapp_gateway permission key.
• j. [settings_service & provider]: Built state controllers.
• k. [settings_management_page.dart]: Implemented form fields and connection status card.
• l. [pubspec.yaml]: Bumped version to 0.0.6+44.

Focus: Release v0.0.6a43 - Add real-time server WIB clock to drawer footer

Focus: Release v0.0.6+41 - Auto-Activation & Expired Customer Billing Integration

Focus: Release v0.0.6+37

Focus: Release v0.0.6+37

Focus: Release v0.0.6+37

Focus: Release v0.0.6+37

Focus: Dynamic PDF Discount Calculations and Transfer Notes Formatting

• a. [pdf_invoice_service.dart] (Backend): Configured dynamic table item row formatting to automatically append localized (Diskon) or (Discount) tags and negative price/amount prefixes for discount types.
• b. [pubspec.yaml]: Bumped version to 0.0.6+37.

Focus: Filter Soft-Deleted Invoices on UI List

• a. [invoice_view.dart]: Added an explicit isDeleted exclusion filter to the local filtered list.
• b. [pubspec.yaml]: Bumped version to 0.0.6+36.

Focus: ObjectId Robust Parsing, Vendor Settings Fallback & Invoice Prefix Formatting

• a. [invoice_model & customer_model] (Frontend): Implemented robust parseId helper inside fromMap factory methods.
• b. [invoice_repository & customer_repository] (Backend): Configured merged vendor custom settings map.
• c. [invoice_repository & customer_repository] (Backend): Updated _generateInvoiceNumber prefix.
• d. [pubspec.yaml]: Bumped version to 0.0.6+35.

Focus: Invoice Form Grid Alignment, Localization & Delete Dialogue Upgrades

• a. [invoice_form_page.dart]: Redesigned form to grid-aligned two-column layout.
• b. [invoice_model.dart]: Added optional customerAddress and customerPhone properties.
• c. [pdf_invoice_service.dart] (Backend): Implemented complete PDF localization.
• d. [customer_repository.dart] (Backend): Updated auto-invoice activation to capture address and phone.
• e. [invoice_repository & controller] (Backend): Forwarded language query parameters down to PDF service.
• f. [invoice_view.dart] (Frontend): Appended language parameters to download URLs.
• g. [pubspec.yaml]: Bumped version to 0.0.6+34.

Focus: Unified Customer Onboarding & Complete Digital Signature Invoicing Flow

• a. [vendor_features.dart]: Consolidated onboarding submenu keys under customer_onboarding. Registered customer_invoices key.
• b. [app_localization.dart]: Registered English and Indonesian localizations.
• c. [customer_management_page.dart]: Wired route mappings.
• d. [customer_management_view.dart]: Refactored onboarding panel with unified status progress dropdown filters.
• e. [pdf_invoice_service.dart] (Backend): Built PDF compiler.
• f. [invoice_model.dart]: Ported model supporting line items categorized by 'product' or 'discount'.
• g. [invoice_repository.dart] (Backend): Tied auto-invoice generation hooks to status changes.
• h. [invoice_controller.dart] (Backend): Exposed CRUD endpoints and verification HTML pages.
• i. [auth_middleware.dart] (Backend): Configured path bypasses.
• j. [invoice_service & provider] (Frontend): Added provider state management.
• k. [invoice_view.dart] (Frontend): Built clean invoices list table view.
• l. [invoice_form_page.dart] (Frontend): Implemented comprehensive manual invoice form.
• m. [pubspec.yaml]: Bumped version to 0.0.6+33.

Focus: Add new customer floating action button only on customer onboarding panel

• a. [customer_management_view.dart]: Configured Scaffold's floatingActionButton to show register FAB only on onboarding tab with write permissions.
• b. [pubspec.yaml]: Bumped version to 0.0.6+32.

Focus: Fix unused variable compiler warnings in CustomerManagementView

• a. [customer_management_view.dart]: Removed unused hasWritePermission and auth variables.
• b. [pubspec.yaml]: Bumped version to 0.0.6+31.

Focus: Fix Undefined isSuper Getter Compile Error in AuthProvider

• a. [auth_provider.dart]: Defined isSuper and userTier getters in AuthProvider.
• b. [customer_form_page.dart]: Updated line 321 to use auth.isSuper.
• c. [pubspec.yaml]: Bumped version to 0.0.6+30.

Focus: Connection Preservation & Field Merging on Onboarding Status Changes

• a. [customer_form_page.dart]: Implemented client-side field preservation in _save().
• b. [customer_repository.dart]: Configured _syncCustomerOnuLandmark to conditionally update port connections.
• c. [pubspec.yaml]: Bumped version to 0.0.6+29.

Focus: Dynamic Status-Based Customer ONU Landmark Marker Colors

• a. [customer_repository.dart]: Updated customer lifecycle methods to sync active status to ONU landmark metadata.
• b. [map_display_view.dart]: Implemented dynamic color mapping for customer ONU markers.
• c. [pubspec.yaml]: Bumped version to 0.0.6+28.

Focus: Prefix-Matching & Landmark Connection Sanitization on Customer Deletion

• a. [customer_repository.dart]: Replaced exact port ID matching with prefix-matching (matching onu-$tokenId).
• b. [pubspec.yaml]: Bumped version to 0.0.6+27.

Focus: Customer Deletion Workspace Sanitization & Dialog Overflow Fixes

• a. [customer_form_page.dart]: Wrapped tabView inside Expanded to enable proper scrolling inside dialogs.
• b. [customer_repository.dart]: Updated deleteCustomer logic to perform bidirectional connection cleanup.
• c. [pubspec.yaml]: Bumped version to 0.0.6+26.

Focus: Three-Stage Customer Onboarding & Permissions Alignment

• a. [customer_form_page.dart]: Implemented dynamic tabs list based on custom permissions.
• b. [app_localization.dart]: Defined and translated onboarding progress and pppoe validations.
• c. [pubspec.yaml]: Bumped version to 0.0.6+25.

Focus: Refactor VPN User card actions and dialog layout integration

• a. [vpn_management_view.dart]: Censored password on card, added InkWell to open VpnUserForm in read-only mode on tap.
• b. [vpn_user_form.dart]: Refactored to support read-only mode and password obscuring visibility toggle.
• c. [pubspec.yaml]: Bumped version to 0.0.6+24.

Focus: Update VPN User card UI layout to match Radius style

• a. [vpn_management_view.dart]: Redesigned _buildUserCard layout dimensions to match _buildRouterCard.
• b. [pubspec.yaml]: Bumped version to 0.0.6+23.

Focus: Dissect generated MikroTik VPN script commands

• a. [vpn_management_view.dart]: Split single script string into three distinct commands (Remove Client, Remove Route, Add Client).
• b. [pubspec.yaml]: Bumped version to 0.0.6+22.

Focus: Update generated MikroTik L2TP client command configuration

• a. [vpn_management_view.dart]: Added allow=mschap2 to generated L2TP client config command.
• b. [pubspec.yaml]: Bumped version to 0.0.6+21.

Focus: Unify save button label on General settings/Account tab

• a. [settings_management_page.dart]: Unified top-right save button label to display default "Save" across all settings tabs.
• b. [pubspec.yaml]: Bumped version to 0.0.6+20.

Focus: Unified save button for General Settings/Account Password change tab

• a. [settings_management_page.dart]: Declared global key for Account settings. Included General settings tab in top-right AppBar save actions.
• b. [pubspec.yaml]: Bumped version to 0.0.6+19.

Focus: Remove custom magenta colors from top-right save button to use default theme colors

• a. [settings_management_page.dart]: Removed custom landmarkMagenta color styling from top-right AppBar save button.
• b. [pubspec.yaml]: Bumped version to 0.0.6+18.

Focus: Unified save button in settings AppBar actions and optional field validation removal

• a. [settings_management_page.dart]: Placed unified Save button in AppBar actions that dynamically triggers active form save.
• b. [pubspec.yaml]: Bumped version to 0.0.6+17.

Focus: Settings page cleanup, tooltip guidelines, and compact button refactoring

• a. [app_localization.dart]: Added localized string keys for brand settings inputs.
• b. [settings_management_page.dart]: Replaced active cooldown text with localized key. Added help tooltip button.
• c. [pubspec.yaml]: Bumped version to 0.0.6+16.

Focus: Settings page layout refactoring to dynamic tab bar

• a. [settings_management_page.dart]: Refactored to use dynamic DefaultTabController and ButtonsTabBar.
• b. [pubspec.yaml]: Bumped version to 0.0.6+15.

Focus: fix: resolve OTP verification UNAUTHORIZED error & add spam warning

• a. [auth_middleware.dart]: Exempted auth/change-password from session token requirement.
• b. [app_localization.dart]: Added checkSpamWarning key with translations.
• c. [otp_dialog.dart]: Displayed warning note about emails potentially arriving in Spam/Junk folder.
• d. [env_config.dart]: Added 01_API/.env to search paths.

Focus: feat: add Account settings and Change Password via Email OTP

• a. [app_localization.dart]: Added localized string keys and translations.
• b. [vendor_features.dart]: Integrated settings_account sub-feature.
• c. [auth_provider.dart]: Updated access verification to always allow account settings.
• d. [auth_service.dart]: Integrated password change request helper.
• e. [settings_management_page.dart]: Implemented AccountSettingsView widget with OTP verification flow.

Focus: feat: fix env file for API reference part 2

Focus: feat: fix env file for API reference

Focus: feat: localize language preferences, fix ODP form template

Focus: Customer & Network Management Localization

• a. [app_localization.dart]: Added defaultKey localization key and translations.
• b. [radius_management_view.dart]: Localized card actions and delete dialogs.
• c. [profile_management_view.dart]: Localized profile creation/update status alerts.
• d. [vpn_management_view.dart]: Localized add-vpn action and tunnel profile labels.
• e. [vpn_user_form.dart]: Localized form input field decorations and validators.
• f. [pppoe_profile_form.dart]: Localized form input boxes and pool assignments.
• g. [router_registration_form.dart]: Localized TabBar tabs and general details inputs.
• h. [pubspec.yaml]: Bumped version to 0.0.6+9.

Focus: Detail Sheet Image URLs Resolution

• a. [landmark_detail_sheet.dart]: Imported ApiConfig and prepended ApiConfig.baseUrl prefix.
• b. [pubspec.yaml]: Bumped version to 0.0.6+8.

Focus: Landmark ODP Form Fixes

• a. [landmark_controller.dart]: Parsed and forwarded metadata and distanceKm fields.
• b. [landmark_connection_section.dart]: Added unique ValueKey to PhotoUploadWidget.
• c. [landmark_pop_form.dart]: Assigned unique ValueKeys to device PhotoUploadWidget elements.
• d. [landmark_form_page.dart]: Implemented _onAttenuationPhotoChanged callback.
• e. [pubspec.yaml]: Bumped version to 0.0.6+7.

Focus: Maps and Landmark Management Localization

• a. [app_localization.dart]: Added localization keys and translations.
• b. [landmark_form_page.dart]: Localized form page titles and action buttons.
• c. [landmark_connection_section.dart]: Localized section headers and distance fields.
• d. [landmark_data_section.dart]: Localized dropdown labels and validators.
• e. [landmark_style_section.dart]: Localized owned-pole checkboxes and color pickers.
• f. [landmark_pop_form.dart]: Localized device lists and port management.
• g. [landmark_detail_sheet.dart]: Localized navigation headers and port specifications.
• h. [pubspec.yaml]: Bumped version to 0.0.6+6.

Focus: Staff Management Localization

• a. [app_localization.dart]: Added localization keys and translations for Staff, Roles, Employees.
• b. [vendor_features.dart]: Added VendorFeatureLocalization extension.
• c. [vendor_drawer.dart]: Simplified feature tile localization.
• d. [staff_management_page.dart]: Localized tab views and appBar title.
• e. [role_management_page.dart]: Localized headers, buttons, cards, and snackbars.
• f. [employee_management_page.dart]: Localized cards and text fields.
• g. [role_form_page.dart]: Localized edit/create headers and segmented buttons.
• h. [employee_form_page.dart]: Localized form fields and status choices.
• i. [pubspec.yaml]: Bumped version to 0.0.6+5.

Focus: Localization Rule Enforcement

• a. [15-localization-rule.md]: Created localization rule to enforce flutter_localization and context extensions.
• b. [pubspec.yaml]: Bumped version to 0.0.6+4.

Focus: Settings Localization Integration

• a. [app_localization.dart]: Created translation keys and English/Indonesian maps.
• b. [settings_provider.dart]: Added translation triggers.
• c. [main.dart]: Configured MaterialApp with localized delegates.
• d. [settings_management_page.dart]: Applied localized strings on all tabs.
• e. [vendor_drawer.dart]: Added localized labels for navigation.
• f. [pubspec.yaml]: Bumped version to 0.0.6+3.

Focus: Settings Menu with General, Brand, and Payment Gateway sub-menus

• a. [settings_remote_data_source.dart]: Created settings remote data source.
• b. [settings_repository.dart]: Created settings repository with input validation.
• c. [settings_controller.dart]: Created settings route controllers.
• d. [vendor_controller.dart]: Registered settings router namespace.
• e. [server.dart]: Wired settings backend modules.
• f. [storage_service.dart]: Added theme and language settings persistence.
• g. [vendor_features.dart]: Registered settings category and sub-features.
• h. [vendor_drawer.dart]: Added drawer navigation mapping.
• i. [settings_service.dart]: Added settings API requests service.
• j. [settings_provider.dart]: Added state provider for customizations.
• k. [settings_management_page.dart]: Built tabbed settings page.
• l. [main.dart]: Registered SettingsProvider globally.
• m. [customer_dashboard_page.dart]: Added settings icon button.
• n. [ispana_dashboard_page.dart]: Added settings icon button.
• o. [pubspec.yaml]: Bumped version to 0.0.6+2.

Focus: Start of v0.0.6 Iteration

• a. [pubspec.yaml]: Bumped version to 0.0.6+70 to initiate v0.0.6 development.