Project _ Mach-iq

byNithish B

# ROLE You are a Principal Product Architect, Manufacturing ERP Consultant, Precision Engineering Domain Expert, Senior SaaS Architect, UX Designer, and Full Stack Engineering Lead. Your job is NOT to build screens. Your job is to design and build a scalable enterprise SaaS product that solves one of the biggest operational bottlenecks inside precision engineering companies. Think like someone designing the future "Salesforce for Precision Engineering." Do not cut corners. Question assumptions. Challenge bad product decisions. Recommend better architecture whenever appropriate. --- # PRODUCT NAME Working Name: MachIQ This is a temporary product name. --- # PRODUCT VISION MachIQ is a Vertical SaaS platform built exclusively for precision engineering manufacturers. Our mission is to reduce quotation turnaround time from days to minutes while standardizing commercial operations. The software must become the operating system for manufacturing commercial teams. Long-term vision: Lead Management ↓ RFQ Management ↓ Estimation ↓ Quotation ↓ Customer Negotiation ↓ Purchase Order ↓ Production Planning ↓ Delivery ↓ Invoice ↓ Analytics Version 1 focuses ONLY on RFQ and Estimation. --- # THE PROBLEM Today the workflow looks like: Customer sends RFQ ↓ Email ↓ Engineering Drawing (PDF / STEP) ↓ Senior Estimator ↓ Manual Material Calculation ↓ Machine Selection ↓ Cycle Time Calculation ↓ Excel Cost Sheet ↓ Management Approval ↓ Quotation PDF ↓ Customer Problems: • Estimation depends on one senior engineer • Quoting takes several hours or days • Material prices constantly change • Machine hourly costs constantly change • Quotes are inconsistent • Companies ignore RFQs because of limited bandwidth • Slow quotation leads to lost business We are NOT replacing estimators. We are making estimators dramatically more productive. --- # TARGET CUSTOMER Precision Engineering Companies Initially: Coimbatore Future: India Global Ideal Customer: Revenue ₹10 Cr–₹75 Cr Employees 25–150 Machines 5–30 CNC/VMC RFQs 30–300/month Current software: Excel WhatsApp Email Tally ERP (optional) --- # PRODUCT PHILOSOPHY MachIQ is NOT: ERP Inventory Production Planning CAD Software Machine Monitoring AI replacing engineers MachIQ IS: Commercial Workflow Software. The estimator remains in control. The software organizes information, calculations, costing, quotations and RFQs. --- # CORE PRODUCT FLOW Login ↓ Dashboard ↓ Customer ↓ Project ↓ RFQ ↓ Upload Drawing ↓ Estimate ↓ Generate Quote ↓ Track Status Everything should revolve around Projects. One Project can contain multiple RFQs and revisions. --- # VERSION 1 MODULES Authentication Organizations Customers Projects RFQs Material Library Machine Library Estimation Workspace Cost Engine Quote Generator Tracker Settings Audit Logs No ERP. --- # MULTI TENANCY Every company is a tenant. Implement proper Row-Level Security. Every organization should only see its own data. Never trust frontend filtering. Security is mandatory. --- # DATABASE Design production-ready PostgreSQL schema. Use: Organizations Users Customers Projects RFQs RFQ Files Materials Material Price History Machines Machine Rate History Estimates Estimate Line Items Quotes Settings Audit Logs Future-ready schema. --- # COST ENGINE The estimator should never manually remember rates. Implement centralized: Material Library Machine Library Settings Estimator Override Snapshots Old quotations should never change when rates change later. Every quotation must preserve historical pricing. --- # ESTIMATION ENGINE Estimator enters: Material Machine Runtime Tool Cost Labour Cost Margin Software calculates: Subtotal Tax Final Price Profit Support custom cost components. Do NOT hardcode. Design a flexible estimate line-item model. --- # PROJECT STRUCTURE Customer ↓ Project ↓ RFQ ↓ Estimate ↓ Quote ↓ Future Purchase Order Projects should become the central object. --- # PRODUCT INTELLIGENCE Version 1 should NOT perform OCR or CAD parsing. Instead implement: Suggest Values Logic: Search previous RFQs. If similar project or part exists: Suggest Material Machine Manufacturing Process Margin Estimator must manually accept suggestions. Nothing should auto-apply. No fake AI. --- # STORAGE Private storage only. RFQ Drawings Quote PDFs Signed URLs. Never public. --- # USER ROLES Owner Estimator Sales Different permissions. Implement using Row-Level Security. --- # LANGUAGE SUPPORT Support: English Tamil Kannada Malayalam Translate UI only. Never translate engineering terms. Language stored per user. --- # DESIGN Industrial. Enterprise. Professional. Desktop First. No startup style. No glassmorphism. No excessive animations. Think Siemens, Autodesk, SAP, Linear. --- # USER EXPERIENCE Estimator should never wonder: "What do I do next?" Workflow must always be obvious. Every screen should have one primary action. --- # FUTURE ROADMAP Design architecture for future modules: Approval Workflow Previous Quote Intelligence Supplier Pricing Drawing Analysis Cycle Time Prediction Machine Learning Production Planning Customer Portal Analytics API Integrations Do NOT build these now. Only architect for them. --- # OUTPUT EXPECTED I want you to act like the founding CTO. Produce: 1. Complete product architecture 2. Information architecture 3. Database architecture 4. API architecture 5. Component architecture 6. Frontend architecture 7. Backend architecture 8. Authentication 9. Storage architecture 10. Security model 11. Row-Level Security 12. UX flows 13. Screen-by-screen breakdown 14. Database schema 15. Cost engine design 16. Estimation engine 17. Quote generation engine 18. Suggest Values logic 19. Future scalability 20. Build the complete Version 1 application from scratch using best engineering practices. Whenever you think the product can be improved, explain why and implement the better solution instead of blindly following the specification.

LandingProjectsLoginAuditLogs
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 5

Project _ Mach-iq

Introduction

Project _ Mach-iq is a Vertical SaaS platform designed exclusively for precision engineering manufacturers. The primary goal of this project is to streamline and expedite the quotation process, reducing turnaround time from days to minutes while standardizing commercial operations. This document outlines the system requirements for the initial version of Mach-iq, focusing on RFQ and Estimation modules.

System Overview

Mach-iq is designed to become the operating system for manufacturing commercial teams, focusing initially on RFQ and Estimation processes. The platform will support precision engineering companies, particularly in Coimbatore, with plans for expansion across India and globally. The target customers are companies with revenues between ₹10 Cr and ₹75 Cr, employing 25 to 150 people, and operating 5 to 30 CNC/VMC machines.

Page 2 of 5

Source Content Inventory

  • Organizations: Each company is a tenant with its own data.
  • Users: Different roles with specific permissions.
  • Customers: Managed within the system.
  • Projects: Central object containing multiple RFQs and revisions.
  • RFQs: Managed and tracked within the system.
  • Materials and Machines: Libraries with historical pricing.
  • Estimates and Quotes: Generated and preserved with historical pricing.
  • Settings and Audit Logs: Configurable and trackable within the system.

Functional Requirements as Story Points

  • As an Owner, I should be able to manage organization-wide settings and permissions.
  • As an Estimator, I should be able to create and manage RFQs and estimates.
  • As a Salesperson, I should be able to track the status of quotes and customer interactions.
  • As an Estimator, I should be able to upload engineering drawings and generate quotes.
  • As a User, I should be able to view and manage projects and associated RFQs.
  • As an Estimator, I should be able to override suggested values for materials and machines.
  • As a User, I should be able to access the platform in English, Tamil, Kannada, or Malayalam.

User Personas

  • Owner: Manages the organization, settings, and permissions.
  • Estimator: Responsible for creating RFQs, estimates, and managing the estimation process.
  • Salesperson: Tracks quotes and customer interactions.
Page 3 of 5

Core User Flows

  • Owner configures organization settings -> Estimator creates RFQ -> Uploads drawing -> Generates estimate -> Generates quote -> Salesperson tracks quote status.
  • Estimator searches previous RFQs -> Receives suggestions for materials and machines -> Manually accepts suggestions -> Generates quote.

Visuals Colors and Theme

  • primary: #1A5276 (Deep Blue)
  • primary_light: #5499C7 (Light Blue)
  • secondary: #F39C12 (Amber)
  • accent: #E74C3C (Vibrant Red)
  • highlight: #F4D03F (Gold)
  • bg: #F2F3F4 (Light Gray)
  • surface: rgba(255, 255, 255, 0.8)
  • text: #2C3E50 (Dark Slate)
  • text_muted: #7F8C8D (Gray)
  • border: rgba(44, 62, 80, 0.2)

Signature Design Concept

The homepage of Mach-iq will feature an interactive workflow animation that visually represents the transformation of an RFQ into a finalized quote. Using motion/react, the animation will depict a digital conveyor belt where RFQs enter, undergo estimation, and emerge as polished quotes. Users can click on different stages to view detailed information, and hovering over elements will reveal additional insights. This dynamic representation will engage users and provide a clear understanding of the platform's capabilities.

Page 4 of 5

Landing Hero Motion Brief

The landing hero will feature a continuously moving 2D composition where RFQs are transformed into quotes. The animation will start with RFQs being uploaded, followed by a series of calculations and adjustments, culminating in a finalized quote. This loop will last 10 seconds and will be interactive, allowing users to pause and explore each stage. The animation will be responsive, ensuring a seamless experience across devices.

Interaction Model & Motion Direction

The intended interaction model for the landing page is "animated," featuring moderate scroll-triggered reveals and hover transitions. This approach will provide a polished and engaging experience, suitable for a feature-rich product page.

Non-Functional Requirements

  • Ensure data security with row-level security.
  • Support multilingual UI with language stored per user.
  • Preserve historical pricing in quotes.
  • Implement private storage for RFQ drawings and quote PDFs.
Page 5 of 5

Tech Stack

  • Frontend: React for Web
  • Backend: Python, FastAPI
  • Database: PostgreSQL
  • AI Models: Not applicable for Version 1
  • Local Orchestration: Docker, docker-compose
  • Server-side Orchestration: Kubernetes

Assumptions and Constraints

  • The platform will initially support precision engineering companies in Coimbatore.
  • Future scalability is a priority, with architecture designed for additional modules.
  • The platform will not replace estimators but enhance their productivity.

Glossary

  • RFQ: Request for Quotation
  • CNC/VMC: Computer Numerical Control/Vertical Machining Center
  • Estimator: A professional responsible for creating estimates and quotes.
  • Quote: A formal statement of promise by a supplier to supply the goods or services required by a buyer at specified prices and within a specified period.
Landing design preview
Landing: View Info
Login: Sign In
Dashboard: View Overview
Projects: Select Project
RFQ: Create RFQ
RFQ: Upload Drawing
Estimation: Create Estimate
Estimation: Review Suggestions
Estimation: Override Values
Estimation: Calculate Cost
Quote: Generate Quote
Quote: Preserve Pricing
Landing design preview
Landing: View Info
Login: Sign In
Dashboard: View Overview
Projects: Select Project
RFQ: Create RFQ
RFQ: Upload Drawing
Estimation: Create Estimate
Estimation: Review Suggestions
Estimation: Override Values
Estimation: Calculate Cost
Quote: Generate Quote
Quote: Preserve Pricing