# MAGNUM ERP

# Release Notes

**Project:** MAGNUM ERP – Engineering Operations Platform

**Company:** MAGNUM ENGINEERING

---

# Purpose

This document records all official releases of MAGNUM ERP.

Each release includes:

* New features
* Improvements
* Bug fixes
* Database changes
* Breaking changes
* Upgrade notes

---

# Version Numbering

MAGNUM ERP follows Semantic Versioning.

Format

```text
MAJOR.MINOR.PATCH
```

Example

```text
1.2.5
```

Meaning

* **MAJOR** – Significant changes or new modules.
* **MINOR** – New features and enhancements.
* **PATCH** – Bug fixes and small improvements.

Examples

| Version | Description               |
| ------- | ------------------------- |
| 0.1.0   | Initial Foundation        |
| 0.2.0   | Database & Authentication |
| 0.3.0   | Customer Management       |
| 0.4.0   | Enquiries & Tasks         |
| 0.5.0   | BOQ Builder               |
| 0.6.0   | Estimating                |
| 0.7.0   | Quotations                |
| 0.8.0   | Projects                  |
| 0.9.0   | Purchasing                |
| 1.0.0   | First Production Release  |

---

# Release History

---

# Version 0.1.0

**Status:** In Development

## Release Date

Not Released

## New Features

* FastAPI project created.
* Bootstrap user interface.
* Application shell.
* Login page.
* Technical dashboard.
* Sidebar navigation.
* Initial documentation.

## Improvements

* Modular project structure.
* Responsive layout.
* Foundation for future modules.

## Database

No database connected yet.

## Known Issues

* Login uses temporary credentials.
* Dashboard uses placeholder data.
* No persistent storage.

---

# Version 0.2.0

**Status:** Planned

## Planned Features

* PostgreSQL integration.
* SQLAlchemy models.
* Alembic migrations.
* User authentication.
* Roles and permissions.
* Dashboard connected to live database.

## Database Changes

Initial database schema created.

Tables

* Users
* Roles
* Customers
* Contacts
* Enquiries
* Tasks

---

# Version 0.3.0

**Status:** Planned

## Planned Features

Customer Management Module

* Customer records
* Contacts
* Search
* Customer history
* Document attachments

---

# Version 0.4.0

**Status:** Planned

## Planned Features

Enquiry & Task Management

* Create enquiries
* Assign estimators
* Automatic task generation
* Workflow tracking
* Dashboard integration

---

# Version 0.5.0

**Status:** Planned

## Planned Features

BOQ Builder

* BOQ creation
* Sections
* Items
* Automatic totals
* Engineering notes

---

# Version 0.6.0

**Status:** Planned

## Planned Features

Estimating Module

* Material pricing
* Labour pricing
* Equipment pricing
* Overheads
* Profit & mark-up calculations
* Estimate approval

---

# Version 0.7.0

**Status:** Planned

## Planned Features

Quotation Module

* Professional PDF generation
* Revision control
* Approval workflow
* Email quotations

---

# Version 0.8.0

**Status:** Planned

## Planned Features

Project Management

* Project workspace
* Task management
* Drawings
* Site notes
* Documents
* Progress tracking
* Variations

---

# Version 0.9.0

**Status:** Planned

## Planned Features

Purchasing Module

* Supplier database
* Purchase orders
* Delivery tracking
* Stock control

---

# Version 1.0.0

**Status:** Planned

## First Production Release

Features Included

### Foundation

* Authentication
* User management
* Role-based security
* Dashboard
* Notifications
* Audit logging

### Customer Management

* Customer records
* Contacts
* Document management

### Enquiries

* Workflow management
* Assignment
* Tracking

### Technical Department

* Design
* BOQ Builder
* Estimating
* Quotations

### Projects

* Project management
* Tasks
* Documents
* Progress

### Purchasing

* Suppliers
* Purchase orders
* Deliveries

### Reporting

* KPIs
* Financial reports
* Productivity reports

---

# Upgrade Notes

For every future release, record:

* Database migrations required.
* Configuration changes.
* New dependencies.
* Breaking API changes.
* Manual upgrade steps.

---

# Deprecation Policy

Features marked as deprecated will remain supported for at least one major version before removal.

Deprecated features will be clearly documented in the relevant release notes.

---

# Release Checklist

Before every official release:

* All automated tests pass.
* Database migrations completed.
* Documentation updated.
* API documentation reviewed.
* UI tested.
* Security review completed.
* Performance checked.
* Version number updated.
* Release notes completed.
* Git tag created.

---

# Long-Term Vision

MAGNUM ERP will evolve through incremental releases, with each version introducing stable, tested functionality.

Every release should improve usability, performance, and engineering workflows while maintaining compatibility and protecting existing customer data.