# OSSM Configurator Roadmap

This document outlines the planned features, improvements, and milestones for the OSSM Configurator project.

## 🚀 Phase 1: Core Configuration & Data Integrity (Current Focus)
The primary goal is to ensure the configurator accurately represents all available OSSM components and generates a perfect Bill of Materials.

*   **Actuator Components**: Complete the mapping for all actuator body variations (Standard, AIM, iHSV, etc.).
*   **Stand & Mounting**: Finalize the hardware requirements for all stand types and mounting solutions.
*   **BOM Logic**: Refine the dependency logic (e.g., "replaces" field) to ensure no duplicate or missing parts.
*   **Price Accuracy**: Implement precise pricing for all hardware components.
*   **Import/Export**: Finalize the BOM export/import cycle for saving and resuming builds.

## 🎨 Phase 2: User Experience & Aesthetics
Moving beyond functionality to create a premium, intuitive configuration experience.

*   [x] **Dark Mode**: High-quality dark mode support across all components.
*   **Micro-animations**: Smooth transitions between wizard steps and hover effects on components.
*   **Loading States**: Add skeleton loaders and progress indicators for the Zip export process.
*   **Mobile Optimization**: Ensure the configurator is fully responsive for mobile builders.

## 🧊 Phase 3: Advanced Visualization (The Next Frontier)
Introducing 3D visualization to help users see their build before they print.

*   **Interactive 3D Preview**: Implement a real-time 3D renderer using React Three Fiber.
*   **Dynamic Customization**: Update the 3D model in real-time based on selected Primary and Accent colors.
*   **Compatibility Highlighting**: Visually show how components fit together in the 3D space.
*   **Exploded View**: Create an interactive exploded view component to help with assembly visualization.

## 🌐 Phase 4: Localization & Exporting
Making the tool accessible to the global OSSM community.

*   **Multi-language Support**: Translate the interface into major languages (German, Spanish, French, etc.).
*   **Multi-currency**: Dynamic currency conversion for the BOM summary.
*   **Imperial/Metric Toggle**: Support both systems for hardware and measurements.

## 🛠️ Phase 5: Build Guides & Integration
Becoming the central hub for starting an OSSM build.

*   **Integrated Assembly Guides**: Show assembly steps/READMEs directly within the configurator.
*   **FAQ & Troubleshooting**: A built-in guide for common build issues.
*   **Community Preset Gallery**: Allow users to share their configurations as presets for others to use.

---

## 📋 TODO List

### High Priority
- [ ] Finalize Actuator Components and mapping to BOM [In Progress]
- [ ] Finalize Stand Components and mapping to BOM
- [ ] Finalize PCB Components and mapping to BOM
- [ ] Finalize Toy Mounts Components and mapping to BOM
- [ ] Finalize Remote Control Components and mapping to BOM
- [ ] Finalize Mounting Components and mapping to BOM
- [ ] Finalize Other Components and mapping to BOM
- [ ] Finalize Colors and mapping to BOM
- [ ] Finalize Pricing and mapping to BOM
- [ ] Finalize BOM Export and mapping to BOM
- [ ] Finalize BOM Import and mapping to BOM

### Features & Infrastructure
- [ ] Finalize Storage and sharing of BOMs
- [ ] Add references to original hardware files and designs
- [ ] Add Readme/assembly instructions for each component
- [ ] Add FAQ and troubleshooting guide
- [ ] Add support for multiple languages
- [ ] Add support for multiple currencies
- [ ] Add 3D render of final product with all components and options selected and colored [Planned - Phase 3]

### Future Considerations
- [ ] Add support for multiple payment methods
- [ ] Add support for multiple shipping methods
- [ ] Add support for multiple shipping countries
- [ ] Add support for multiple shipping regions
- [ ] Add support for multiple shipping cities