Factor Manager

Factor Manager is a Windows desktop maintenance tracker for production lines, equipment, and interval-based maintenance items.

Features

• Manage production lines and equipment with add, rename, duplicate, and delete workflows.
• Track maintenance items with day-based periods, last-check dates, and same-day completion state.
• Show due-today and overdue summaries across the current dataset.
• Use simulation mode to preview future maintenance status without saving simulated changes.
• Load English and Traditional Chinese UI strings from locale JSON files.
• Persist maintenance records locally as JSON and create sample data when no database is available.

Build and Run

Requirements:

• CMake 3.20 or newer.
• A MinGW toolchain that can build C and C++17 sources.
• Windows desktop libraries used by the CMake configuration.

The CMake executable target is factor_manager. From the repository root:

cmake -S . -B build -G "MinGW Makefiles"
cmake --build build

Run the built application:

.\build\factor_manager.exe

The preferred database file is data/maintenance/database.json. The application also has a legacy fallback for data/database.json when the preferred file is missing. UI locale files are loaded from data/locales/.

To prepare a Windows release package after a successful build:

powershell -ExecutionPolicy Bypass -File scripts/package_release.ps1 -Version v1.0.3

The package script collects the executable, runtime DLLs, data/, README.md, and LICENSE into a versioned distribution folder and zip archive.

Project Structure

• app_include/ - public C++ headers for the domain model, storage, and localization.
• src_cpp/ - C++17 application code, raygui bridge code, persistence, and UI flow.
• src/ - bundled C dependency source, including src/cJSON.c.
• include/ - third-party headers used by the desktop GUI build.
• lib/ - bundled raylib libraries for the MinGW build.
• data/maintenance/ - tracked maintenance database seed data.
• data/locales/ - English and Traditional Chinese UI language files.
• scripts/ - release packaging helper scripts.
• legacy_src/ - earlier C implementation kept for reference.
• CMakeLists.txt - build definition for the factor_manager target.

Download

The latest public release is v1.0.3 on GitHub Releases: https://github.com/Ansenchen123/factor/releases

摘要

• Factor Manager 是 Windows 桌面維護追蹤工具，適合管理產線、設備與週期性保養項目。
• 專案使用 C++17、CMake、raylib、raygui 與 cJSON，資料以本機 JSON 檔保存。
• CMake 目標名稱是 factor_manager，主要資料檔位於 data/maintenance/database.json。
• 應用程式支援到期與逾期摘要，也能用模擬模式預覽未來維護狀態。
• 最新公開版本為 v1.0.3，可從 GitHub Releases 頁面下載。