...

specs/features/README.md

@@ -0,0 +1,19 @@
+# Digital Freezone Customer Portal Features
+
+This directory contains detailed specifications for all features of the Digital Freezone Customer Portal.
+
+## Feature Categories
+
+- [Authentication & User Management](authentication.md) - Login, profile management, and KYC
+- [Financial Management](financial.md) - Wallet functionality and transaction handling
+- [RWDA Management](rwda.md) - Real World Digital Asset management features
+- [Communication & Support](communication.md) - Tickets, inbox, and notification systems
+- [Legal & Compliance](legal.md) - Contract management and regulatory compliance
+
+Each feature specification includes:
+- Detailed description
+- User interface requirements
+- Functional requirements
+- Data requirements
+- Integration points
+- Security considerations

specs/features/authentication.md

@@ -0,0 +1,58 @@
+# Authentication & User Management
+
+## 1. Login
+
+### Description
+
+The login system provides secure access to the Digital Freezone Customer Portal, ensuring that only authorized users can access the platform and their personal information.
+
+### UI Requirements
+
+- Clean, minimalist login form
+- Fields for username/email and password
+- "Forgot password" link (*)
+- Two-factor authentication option (*)
+- Error messaging for invalid credentials
+- Loading state during authentication (use webassembly?)
+- Redirect to last accessed page after successful login (*)
+
+### Functional Requirements
+
+- WebAssembly-based secret management & private key mgmt
+- Email verification
+- Two-factor authentication via SMS or authenticator app (*)
+- Session management with configurable timeout (*)
+- Account lockout after multiple failed attempts(*)
+- Password strength enforcement(*)
+- Audit logging of login attempts (successful and failed) (*)
+
+
+## 2. Profile Management
+
+### Description
+
+The profile management system allows users to maintain their personal information, contact details, and preferences, ensuring that the platform has accurate and up-to-date information.
+
+### UI Requirements
+
+- Comprehensive profile dashboard
+- Editable fields with inline validation (*)
+- Profile completeness indicator
+- Section-based organization (personal info, contact details, preferences) (*)
+- Avatar/profile picture upload with preview (*)
+- Save/cancel buttons for each section
+- Success/error notifications for updates
+
+## 3. KYC (Know Your Customer)
+
+### Description
+The KYC system enables users to verify their identity in compliance with regulatory requirements, allowing them to access higher-level services within the Digital Freezone.
+
+### UI Requirements (3e party)
+- Step-by-step verification wizard
+- Document upload interface with drag-and-drop
+- Mobile camera integration for document capture
+- Verification status dashboard
+- Progress indicators for multi-step processes
+- Clear instructions for each verification step
+- Verification history and document archive

specs/features/communication.md

@@ -0,0 +1,110 @@
+# Communication & Support
+
+## 1. Tickets
+
+### Description
+The ticket system provides a structured way for users to request support, report issues, or initiate processes that require staff intervention, ensuring that all requests are tracked and resolved efficiently.
+
+### UI Requirements
+
+- Ticket creation form with type selection and priority
+- Ticket listing with status indicators and filtering
+- Detailed ticket view with comment thread
+- File attachment capability with preview
+- Status and workflow progress indicators
+- Related ticket suggestions
+- Search functionality across tickets
+- Sorting and filtering options
+
+### Functional Requirements
+
+- Ticket creation with:
+  - Type selection (support, technical, billing, etc.)
+  - Subject and description fields
+  - Priority selection
+  - Attachment upload
+- Ticket workflow management:
+  - +- evert flow will be managed this way
+  - Status tracking (open, in progress, resolved, etc.)
+  - Assignment to staff members
+  - SLA tracking and escalation
+  - Workflow steps based on ticket type
+- Comment system:
+  - Rich text formatting (markdown)
+  - @mentions for staff or departments
+  - File attachments
+  - Internal notes (staff only)
+- Notification system for ticket updates
+- Ticket linking and relationship management
+- Knowledge base integration for suggested solutions
+- Satisfaction surveys upon resolution
+- Linking to RWDA, Companies (Entities), Voting Request, ...
+
+### Data Requirements
+- Ticket metadata (type, subject, priority, etc.)
+- Ticket status and history
+- Comment thread
+- File attachments (need generic way how to deal with files, the webdav?)
+- Workflow configuration by ticket type
+- SLA definitions and tracking data
+- User and staff assignment information
+
+
+## 2. Inbox
+
+### Description
+The inbox system provides a centralized communication channel between users and the Digital Freezone platform, enabling efficient information exchange and notification delivery.
+
+### UI Requirements
+- Message listing with unread indicators
+- Message categorization with visual labels
+- Message detail view with threaded replies
+- Compose interface with formatting options (*)
+- Search and filter functionality (*)
+- Attachment handling with preview (*)
+- Bulk action capabilities (mark read, archive, etc.) (*)
+- Mobile-responsive design for on-the-go access (*)
+
+### Functional Requirements
+
+- Message reception from system and staff
+- Message composition and replies
+- Message categorization with labels (*)
+- Attachment handling (upload and download) (*)
+- Search across message content and metadata (*)
+- Filtering by date, sender, label, etc. (*)
+- Read/unread status tracking
+- Message archiving and deletion (*)
+- Integration with ticket system (comments appear in inbox)
+
+## 3. Actions
+
+> TODO: maybe this is part of the ticketing system?
+
+### Description
+
+The actions system provides users with a clear overview of tasks that require their attention or input, ensuring that workflow processes progress efficiently and users are aware of their responsibilities.
+
+### UI Requirements (*)
+
+- Action center dashboard with priority indicators
+- Action cards with clear descriptions and deadlines
+- Filtering and sorting options
+- Calendar view for deadline management
+- Completion tracking with progress indicators
+- Related entity links (tickets, RWDAs, etc.)
+- Mobile notifications for urgent actions
+- Historical view of completed actions
+
+### Functional Requirements (*)
+
+- Action creation based on workflow triggers
+- Action assignment to specific users
+- Deadline setting and tracking
+- Priority assignment and escalation
+- Action completion verification
+- Dependency management between actions
+- Reminder generation for approaching deadlines
+- Action delegation (if permitted)
+- Audit trail of action history
+- Reporting on action completion rates

specs/features/financial.md

@@ -0,0 +1,46 @@
+# Financial Management
+
+## 1. Wallet
+
+### Description
+The wallet system provides users with the ability to manage their funds within the Digital Freezone platform, enabling them to deposit, withdraw, and track their financial assets.
+
+### UI Requirements
+- Dashboard showing current balances across all currencies
+- Transaction history with filtering and search capabilities
+- Visual graphs of balance history and spending patterns
+- Top-up interface with multiple payment options
+- Withdrawal interface with security verification
+- Receipt generation for all transactions
+- Currency conversion calculator
+- Spending analytics with categorization
+
+### Functional Requirements
+
+- Multi-currency support (EUR, CHF, USD)
+- Deposit functionality via:
+  - Credit/debit card (Stripe integration)
+  - Bank transfer
+  - Other payment methods as applicable
+- Withdrawal functionality to verified bank accounts (*)
+- Transaction history with detailed metadata
+- Balance tracking and reconciliation (*)
+- Currency conversion with real-time rates (*)
+- Transaction notifications
+
+
+## 2. Real World Digital Assets (RWDA) Financial Management
+
+### Description
+The RWDA financial management system enables users to purchase, sell, and track the financial performance of their Real World Digital Assets within the platform.
+
+### UI Requirements
+- Portfolio dashboard showing asset allocation and value
+- Purchase interface with asset selection and payment options
+- Transaction confirmation screens with terms and conditions
+- Asset performance tracking with visual charts
+- Dividend/return tracking and history
+- Tax reporting interface
+- Portfolio diversification visualization
+- Risk assessment indicators
+

specs/features/legal.md

@@ -0,0 +1,62 @@
+# Legal & Compliance
+
+## 1. Contracts
+
+### Description
+The contract management system enables users to view, sign, and manage legal agreements related to their activities within the Digital Freezone, ensuring proper documentation and compliance with legal requirements.
+
+### UI Requirements
+
+- Contract listing with status indicators
+- Contract detail view with markdown rendering
+- Signature interface (based on signing with private key)
+- Signature status visualization
+- Version comparison view (*)
+- Contract template browser (*)
+- Search and filter functionality (*)
+- Print and download options (*)
+
+### Functional Requirements
+
+- Contract presentation in readable format (markdown)
+- Digital signature collection:
+  - Certificate-based signatures
+- Multi-party signing workflow:
+  - Sequential or parallel signing
+  - Reminder notifications (use tickets)
+  - Deadline enforcement
+- Signature verification and validation
+- Contract versioning and change tracking (*)
+- Contract template management (*)
+- Audit trail of all contract activities (*)
+- Expiration and renewal management (*)
+- Contract search by content or metadata (*)
+
+
+## 2. Terms & Conditions (Policies)
+
+### Description
+The terms and policies system manages the presentation, acceptance, and tracking of legal terms, privacy policies, and other agreements that govern the use of the Digital Freezone platform.
+
+### UI Requirements
+
+- Terms and policies listing with version information
+- Policy viewer with clear formatting (markdown viewer)
+- Version comparison view (*)
+- Acceptance tracking and history (*)
+- Notification center for policy updates (*)
+- Search functionality across policy content (*)
+- Language selection for multilingual policies (*)
+- Print and download options (*)
+
+### Functional Requirements
+
+- Policy presentation in readable format
+- Version management with effective dates (*)
+- Acceptance collection and tracking (*)
+- Notification of policy updates requiring acceptance (*)
+- Forced acceptance for critical policy changes
+- Policy acceptance history for audit purposes (*)
+- Language localization of policies (*)
+- Search across policy content (*)
+- Policy update workflow with approval process (*)