Feng Shui Analysis & Art Recommendations Webapp

Job ID: 39637558

Budget: $250 – $750 USD

Project Title:
Feng Shui Metaphysics Analysis Platform with Decorative Art Recommendations

Objective:
Build a web-based application that allows users to submit personal and location-based information, and returns a customized Feng Shui analysis using an external metaphysics API (e.g., YishuAPI). The results are interpreted by ChatGPT and combined with customized Feng Shui art suggestions (e.g., fish paintings, lucky objects).

===================================
User Journey:
Step 1: Input Form
User fills out a form with the following fields:

Personal Data
Name

Gender

Date of Birth (Gregorian & Lunar options)

Time of Birth (optional but preferred)

Place of Birth

House or Workplace Info
Address (or manually input longitude/latitude)

Floor plan or simple layout (optional image upload)

Facing direction (optional: compass input or dropdown)

Intention (select one or multiple)
Wealth

Health

Career

Relationship

Family harmony

Business prosperity

============================
System Flow:
User submits form

System calls external Chinese metaphysics API (e.g., YishuAPI) with necessary parameters (e.g., BaZi birth chart, Xuan Kong Fei Xing flying star calculations, Qimen Dunjia if applicable)

Receive and parse response data

Use ChatGPT to:

Interpret the results in plain language (English/Chinese toggle)

Highlight good/inauspicious directions and elements

Suggest what kind of art, color, or object is suitable

Decorative Feng Shui Art Recommendation Logic (handled via ChatGPT or backend logic)
Example:

If user’s wealth star is in SE direction → Recommend 9 koi fish painting, with 6 fish swimming left, 3 right.

If user lacks Wood element → Suggest bamboo art or green mountain paintings.

If family health issue → Suggest "流动山水画" (flowing water paintings) placed at east.

Output format:

Recommended art theme (e.g., 九鱼聚财)

Orientation (left/right/up/down)

Placement direction (e.g., south-facing wall)

Number of objects (e.g., 9 fish, 3 lotus, 2 deer)

Link to purchase (optional from your site)

============================
Backend Requirements
Admin panel to:

Manage analysis pricing

Upload decorative art library with tags (e.g., wealth, health, career)

Review API usage

View user analysis logs

========================
Payment Integration (Frontend)
After form submission, system requires payment (via Stripe, Toyyibpay, or FPX)

Once payment is confirmed, trigger API call and show result

Email and/or downloadable PDF report (optional)

=========================================
Frontend Design Suggestion (UI)
Home Page

Introduction to service

Benefits of personalized Feng Shui + decorative art

Call-to-Action: “Start My Analysis”

Form Page

Easy multi-step form

Simple visuals or icons (e.g., gender, time picker)

Payment Gateway Page

Result Page

Personal chart summary

Recommendations

Suggested art

(Optional) image previews of canvas/feng shui paintings

Admin Panel (separate login)

Dashboard with usage logs

API key management

Upload/manage art content

========================
Technologies Recommended
Frontend: React / Vue.js

Backend: Node.js / Python

API Integration: YishuAPI or other Chinese metaphysics providers

AI Interpretation: ChatGPT API

Database: MongoDB / PostgreSQL

Payment: Stripe / FPX

================================================
Feng Shui Analysis System — Developer Specification
1. System Overview
The system is a web-based Feng Shui analysis tool. It allows users to input personal and location data (e.g., home or work address), then fetches Feng Shui information from a third-party API. Results will be interpreted by OpenAI ChatGPT and matched with suggested Feng Shui canvas art (e.g., 九鱼图, 金鹿财树, 聚宝盆) from the admin database.

2. Key Features
==========================
User Panel
User Registration/Login

Login with email and password.

Password reset via email.

Dashboard

Submit new Feng Shui analysis.

View past analysis records.

Input Form for Feng Shui Calculation

Full Name

Gender

Date of Birth & Time (Gregorian + Chinese Lunar Auto Conversion)

Current Location Type (Home / Office / Business)

Address of Location

Direction of Main Door (Select N, S, E, W, NE, etc.)

Floor Plan upload (optional)

Analysis Results Page

API Feng Shui data fetched and interpreted by ChatGPT.

Canvas Art Recommendations:

What kind of art (e.g. 九鱼图 – how many fish, position left/right, with/without lotus, etc.)

Placement suggestion (which room, which wall)

Optional download in PDF

=======================================
Admin Panel
Admin Login

Secure login for staff/admins

User Management

View user database and access logs.

Artwork Management

Add/Edit/Delete Feng Shui Art templates (with image, name, tag, meaning, placement suggestion)

Analysis Management

View submitted user data and results

Manual override of suggestion (optional)

Settings Panel

Set price per analysis (hidden from users)

Connect API key (YishuAPI or other)

3. API Integration
Third-Party API (e.g., YishuAPI, APIStore)
Use user input (birth date, location direction) to request:

BaZi (八字)

Flying Star (流年飞星 / 流月飞星)

House Compatibility

Lucky and Unlucky Directions

API returns raw metaphysical data

====== ChatGPT Integration (via OpenAI)
Explain API results in simple language

Match art recommendations based on API results and logic rules

E.g., if Southwest is unlucky this year → suggest to place calming art in SW

If need more water element → recommend 九鱼图 on East wall

4. UI Design (Suggestion)
======= User Login Page
Clean and modern form UI

Register / Login / Forgot Password options

======= User Dashboard
Left-side menu: Dashboard | New Analysis | Past Reports | Logout

Center: Welcome message + shortcuts

======= New Analysis Page
Step-by-step wizard:

Fill in personal info

Fill in house details

Confirm and Submit

========= Results Page
Summary of Feng Shui info

Text explanation (ChatGPT)

Recommended canvas art with images and room placement

Button to “Download PDF” or “Order Art Now”

=======================
Admin Dashboard
Top menu: Users | Analysis | Art Templates | Settings | Logout

Table views with filters and action buttons

5. Optional Features (for later)
Payment gateway integration (Stripe, Billplz, Toyyibpay)

WhatsApp notification when analysis ready

Multi-language support (English, 中文)

6. Technology Stack Suggestion
Frontend: ReactJS or Vue.js

Backend: Node.js / Python Flask / Laravel

Database: MySQL / MongoDB

AI: OpenAI API (for ChatGPT explanation)

API Integration: YishuAPI / other paid BaZi/Flying Star API

Hosting: AWS / DigitalOcean / shared host

Security: HTTPS, JWT for user sessions
Related categories: Python MySQL Bootstrap Vue.js REST API