radionica3d/docs/README.md

Radionica 3D Project Documentation

Welcome to the official documentation for the Radionica 3D platform. This document provides a high-level overview of the project, its goals, and the technology stack.

Overview

Radionica 3D is a full-stack web application designed for a 3D printing studio based in Montenegro. It allows users to:

• Upload 3D models (STL, OBJ, etc.).
• Receive quotes and track order progress.
• Interact with administrators via a real-time chat.
• View a portfolio of previous works.
• Manage reviews and blog posts.

The platform follows a "Trust-based" business model: Pay on delivery, trust in every layer.

Technology Stack

The project is built using modern, robust technologies:

Frontend

• Framework: Vue 3 (Composition API)
• Build Tool: Vite 6
• State Management: Pinia
• Styling: Tailwind CSS
• Routing: Vue Router
• Localization: vue-i18n with a custom split/merge system.
• Animations: @vueuse/motion
• 3D Rendering: Three.js for STL previews.

Backend

• Framework: FastAPI (Python 3.11+)
• Database: SQLite (managed via raw SQL and custom migration scripts).
• Authentication: JWT-based (JSON Web Tokens).
• Communication: WebSockets for real-time order chat.
• Background Tasks: Telegram integration for admin notifications.

Documentation Navigation

• Architecture: Detailed system design and folder structure.
• Frontend Guide: UI components, state, and localization.
• Backend Guide: API routes, database schema, and services.
• Development Guide: How to run locally, add features, and test.
• Admin Tutorial: Step-by-step guide to extending the Admin Panel.
• Deployment Guide: Production setup and build scripts.