Product Features

# MWS Architect Office Management System v1.0

A premium PHP + MySQL web application for architects, architecture studios, and design offices to manage clients, projects, drawings, approvals, site visits, invoices, staff, pay slips, holidays, vendors, and client collaboration from one private web portal.

## Version

**Stable Release:** v1.0

## Core Features

### Premium Admin UI

- Modern MWS Premium Admin UI Framework
- Dark premium sidebar
- Clean card-based dashboard
- Responsive forms and tables
- Mobile-friendly layout
- Consistent view/history pages
- Professional architecture office branding

### Installer & System Setup

- First-time installer
- Compatibility check screen
- PHP version check
- PDO and PDO MySQL check
- Upload/config writability checks
- Dynamic App URL setup
- Database setup
- Admin account creation
- Upgrade-safe migration logic using table/column checks
- After-install delete/rename install folder reminder

### Admin Dashboard

- Quick business overview
- Project statistics
- Client and drawing activity
- Pending approvals
- Revenue and invoice summary
- Quick links for daily operations

### Clients

- Add, edit, list, and view clients
- Client code generation
- Client login/password setup
- Client status control
- Client history page
- View linked projects
- View linked drawings and approvals
- View linked quotations
- View linked invoices
- View client-uploaded files

### Client Portal

Clients can log in and access only their own project-related information.

- Client dashboard
- Project progress overview
- Shared drawings/downloads
- Invoice viewing/downloads
- Client upload area for reference files, approvals, photos, ID/address proofs, measurements, and comments

### Projects

- Add, edit, list, and view projects
- Project code generation
- Client assignment
- Project type, location, area, budget, stage, status, and dates
- Project history with drawings, quotations, invoices, and site visits

### Drawings & Approvals

- Upload drawings and documents
- Supported files include JPG, PNG, PDF, DOC, DOCX, Excel, DWG, and ZIP
- Drawing type management from settings
- Version/revision tracking
- Approval status tracking
- Client/internal comments
- Staff-owned drawing access logic
- Staff can always add, view, and edit their own drawings
- Role-based access for other drawings

### Site Visits

- Add, edit, list, and view site visits
- Project assignment
- Visit date
- Visited by field supports admin and staff
- Site condition
- Progress percentage
- Issues found
- Contractor remarks
- Next action
- Staff can edit only their own site visits

### Quotations / BOQ

- Create and list quotations/BOQ records
- Project/client assignment
- Quote number and validity
- Subtotal, tax, discount, total
- Notes and status
- Visible in project and client history

### Invoices

- Create and list invoices
- Client selection with email auto-fill
- Product/service/custom item rows
- Quantity, price, tax, total calculation
- Discount, paid amount, due amount
- Print/PDF-style invoice view
- Email/WhatsApp-style workflow support
- Staff field removed from invoice forms and lists

### Staff

- Add, edit, list, and view staff
- Roles simplified to Project Manager and Architect
- Staff login password creation
- Mandatory email
- Duplicate employee code prevention
- Salary and bank details
- Multiple deductions support
- Staff view page matching client view UI
- Staff portal-style menu for own account, pay slips, holidays, projects, clients, drawings, and site visits based on role permissions

### Pay Slips

- Create and manage pay slips
- Duplicate prevention for same employee and month
- Staff salary fetched dynamically
- Permanent deductions fetched dynamically from staff profile
- Monthly deduction support such as LOP handled at pay slip level
- Digital copy note; signature not required
- Staff can view their own pay slips

### Holidays

- Add, edit, and list holidays as admin
- Staff can view holidays only
- Staff cannot add or edit holidays

### Vendors

- Vendor/contractor records
- Category, contact person, phone, email, GST number, rating, address, and notes

### Settings

- Studio settings
- Logo and business details
- Email / SMTP settings
- Drawing type add/remove management
- Role-based staff access settings for Project Manager and Architect
- System information

## Role & Permission Summary

### Admin

- Full access to all modules
- Can manage staff, clients, projects, drawings, site visits, quotations, invoices, pay slips, holidays, vendors, settings, and reports

### Project Manager

- Access depends on admin role settings
- Can work with assigned/allowed clients, projects, drawings, and site visits
- Can view own pay slips and holidays

### Architect

- Access depends on admin role settings
- Can always add, view, and edit own drawings/approvals
- Can view own pay slips and holidays
- Can work with allowed projects, clients, and site visits

### Client

- Private client portal access only
- Can view own projects, drawings, invoices, and uploaded files
- Can upload project-related documents/files

## Installation

1. Extract the ZIP file.
2. Upload or place the folder in your server/local directory.
3. Create a MySQL database.
4. Open the app URL in your browser.
5. Run the installer from `/install/`.
6. Enter App URL, database details, studio details, and admin login details.
7. Complete installation.
8. Delete or rename the `install` folder after setup.
9. Login as admin and update Settings.

## Recommended Local URL
auto

## Recommended Requirements

- PHP 8.0 or higher
- MySQL 5.7+ / MariaDB compatible
- PDO extension enabled
- PDO MySQL extension enabled
- File uploads enabled
- Writable `uploads/` directory
- Writable `config/` directory during installation

## Default Demo Login

Use the admin account created during installation.

For demo/test installations, common credentials may be:

```text
Demo URL: https://webapp.manishwebstudio.com/mws-architect-office-management-system/

Admin Account > username: admin, password: admin123
Client Account > username/email: client, password: client123
Architect Account > username/email: architect@example.com, password: architect123
Project Manager Account > username/email: manager@example.com, password: manager123

Need Customization?? Need help in installing on your server/ hosting/ domain??  Write at manishwebstudio@gmail.com or Chat on WhatsApp

```

Change the password before using the system in production.

## Folder Structure

```text
assets/ CSS and JavaScript
config/ App configuration
includes/ Shared layout, auth, and helper functions
install/ Installer and compatibility setup
modules/ Application modules
uploads/ Uploaded files and documents
database/ Database reference SQL
```

## Important Notes

- Delete or rename the `install` folder after installation.
- Keep regular database and uploads backups.
- Configure SMTP from Settings for reliable email delivery.
- Use strong passwords for admin, staff, and clients.
- This is a private office management system and should be hosted behind secure login.

## License

Proprietary – Redistribution, modification, or resale is prohibited without permission from the author.