Build Wallcraft OS MVP

SOFTWARE DEVELOPMENT REQUIREMENT

Perfeccity Wallcraft OS — MVP Development

1. Project Overview

We are looking for an experienced Full-Stack Developer or Software Development Team to design and develop Perfeccity Wallcraft OS, an integrated web-based application for wall panel product management, 2D wall design, project configuration, BOM management and technical PDF generation.

The objective is to build one integrated business application with independently governed functional modules.

2. Required Technology Stack

- Frontend: React + TypeScript
- Backend: Java + Spring Boot
- Architecture Governance: Spring Modulith
- Architecture: Contract-Driven Modular Monolith
- Database: PostgreSQL
- Database Migration: Flyway
- API: REST API
- Authentication: Spring Security
- File Storage: S3-compatible storage
- PDF Generation: Java-based PDF generation
- Testing: JUnit 5 + Testcontainers
- Deployment: Docker

3. Functional Requirements

The application must include the following modules:

1. Authentication and User Management

- Login and logout.
- Role-based access control.
- Admin, Designer and Consultant permissions.

2. Mini PLM — Product Management

- SKU Master dashboard.
- Create, edit and manage SKUs.
- Product-specific dynamic forms.
- Product specifications.
- Enable/disable SKUs.

3. Mini CAD — Designer Canvas

- Create and manage wall designs.
- Straight and L-shaped wall configuration.
- DXF file import.
- 2D wall geometry and layout.
- Zone creation and management.
- Product placement.
- Product assignment.
- Lighting and furniture representation.
- Manual Reference BOM preparation.
- Save and publish designs.

4. Design Library — Designer

- Design listing and management.
- Search and filtering.
- Design classification.
- Design publication.

5. Design Library — Consultant

- Browse published designs.
- Search and filter.
- Design preview.
- Select designs for projects.

6. Mini Configuration — Consultant Canvas

- Create project-specific configurations.
- View wall geometry and product placements.
- Prepare Actual Project BOM.
- Add permitted SKU lines.
- Enter and edit quantities.
- Save and submit BOM for validation.

7. Calculator Logic — BOM Governance

- Actual BOM validation.
- GREEN / AMBER / RED validation status.
- Approval eligibility.
- BOM approval.
- Protection of approved quantities.

8. Project PDF Generation

- Generate technical production specification PDFs.
- Include project information, design information, product specifications and approved Actual BOM.
- Exclude commercial pricing and tax calculations.

4. Primary Application Screens

The MVP must contain seven primary screens:

1. SKU Master.
2. New SKU.
3. Designer Canvas.
4. Design Library — Designer.
5. Design Library — Consultant.
6. Consultant Canvas.
7. Project PDF.

5. Mandatory Business Rules

The developer must follow these requirements:

- Every SKU must have a stable and unique SKU ID.
- Every design must have a stable design ID.
- Save and Publish must remain separate operations.
- Consultants cannot modify published source designs.
- Reference BOM and Actual Project BOM must remain independent.
- BOM quantities must be entered manually.
- Geometry must never automatically generate BOM quantities.
- Approved BOM quantities must be protected.
- Product specifications must remain under SKU Master ownership.
- Backend authorization is mandatory.

6. Architecture Requirements

The application must follow a Contract-Driven Modular Monolith architecture using Spring Boot and Spring Modulith.

Requirements:

- One integrated application.
- One application deployment.
- Independently governed business modules.
- Controlled internal module communication.
- Clear database ownership.
- No microservices in the MVP.

The governing principle is:

One Fact → One Authoritative Owner → Many Controlled Consumers.

7. Developer Responsibilities

The selected developer/team will be responsible for:

- Technical architecture.
- UI/UX implementation.
- Frontend development.
- Backend development.
- Database design.
- REST API development.
- DXF and geometry implementation.
- BOM validation logic.
- PDF generation.
- Unit and integration testing.
- Deployment.
- Technical documentation.
- Complete source-code handover.

8. Expected Deliverables

- Complete working web application.
- React frontend source code.
- Spring Boot backend source code.
- PostgreSQL database.
- Flyway migration scripts.
- REST API documentation.
- Spring Modulith architecture documentation.
- Automated test cases.
- Docker deployment configuration.
- Technical documentation.
- Complete source code and handover.

9. Development Proposal Required

Interested developers or companies must provide:

1. Relevant development experience.
2. Previous Java/Spring Boot projects.
3. Spring Modulith or Modular Monolith experience.
4. React and TypeScript experience.
5. DXF/CAD/2D geometry development experience.
6. Proposed development team.
7. Estimated development timeline.
8. Module-wise development cost.
9. Total project development cost.
10. Testing and maintenance cost.
11. Phase-wise payment milestones.

10. Important Project Conditions

The development must follow the existing Perfeccity Wallcraft OS Contract Baseline v0.3.3 and MVP Software Requirements Specification.

Developers are not authorized to independently change business rules, data ownership, user permissions, BOM logic or application architecture.

Unresolved business decisions must be identified and approved before dependent implementation.

11. Project Objective

Build a reliable, maintainable and scalable MVP that connects:

Product Management → Design Creation → Design Publication → Project Configuration → Actual BOM → BOM Validation → Approval → Protection → Technical PDF Generation.

We are looking for a developer who understands both software engineering and the technical requirements of a CAD-like product configuration application.

Interested developers are invited to submit their technical and commercial proposals.