How ahmadabulhawa/aqar-ai works
Aqar AI is a room-design and furniture-catalog product: users provide room details, receive a tailored furniture selection and rendered design, and can browse or manage products and templates. A separate catalog-import capability ingests retailer products for use in the catalog. The map reflects documented imports and relationships in the SOURCE INDEX and README; several frontend-to-backend connections and unsampled service internals are not verified.
Main entry points: design_routes.py Design workflow · main.py FastAPI application · route.ts Backend proxy · database.py Application database
Components 20
User experience
- Web app
frontend/src/app/page.tsx - Design studio
frontend/src/app/studio/page.tsx - Templates UI
frontend/src/app/templates/page.tsx - Product shop
frontend/src/app/shop/page.tsx - Backend proxy
frontend/src/app/api/backend/[...path]/route.ts
Room design
- Room intake
app/routes/room_routes.py - Design workflow
app/routes/design_routes.py - Room analysis
app/services/room_analysis_service.py - Space constraints
app/services/architectural_constraint_service.py - Furniture selection
app/services/unified_selection_service.py - Composition fit
app/services/composition_fit_service.py - Design rendering
app/services/openai_image_service.py - Design templates
app/services/design_template_service.py
Furniture catalog
- Furniture management
app/routes/furniture_routes.py - Retailer import
app/catalog_import/runner.py - Retailer adapters
app/catalog_import/adapters - IKEA product import
app/services/ikea_product_import_service.py
Backend platform
- Application database
app/database.py - FastAPI application
app/main.py
Other components
- User
Connections 23
- User → Web app: uses
frontend/src/app/page.tsx - User → Design studio: edits designs
frontend/src/app/studio/page.tsx - User → Templates UI: browses
frontend/src/app/templates/page.tsx - User → Product shop: browses products
frontend/src/app/shop/page.tsx - Web app → Backend proxy: requests
- Design studio → Backend proxy: requests
- Templates UI → Backend proxy: requests
- Product shop → Backend proxy: requests
- Backend proxy → FastAPI application: forwards requests
- FastAPI application → Room intake: mounts routes
app/main.py - FastAPI application → Design workflow: mounts routes
app/main.py - FastAPI application → Furniture management: mounts routes
app/main.py - FastAPI application → Application database: initializes
app/main.py - Room intake → Application database: stores room requests
app/routes/room_routes.py - Design workflow → Room analysis: uses analysis
app/routes/design_routes.py - Design workflow → Space constraints: builds constraints
app/routes/design_routes.py - Design workflow → Furniture selection: selects products
app/routes/design_routes.py - Design workflow → Composition fit: checks fit
app/routes/design_routes.py - Design workflow → Design rendering: renders design
app/routes/design_routes.py - Design workflow → Design templates: matches templates
app/routes/design_routes.py - Furniture management → Application database: reads and writes
app/routes/furniture_routes.py - Retailer import → Retailer adapters: dispatches imports
- IKEA product import → Application database: adds products
README.md