https://github.com/wisdomfirm/fms-framework
The Core Automation Backbone for WisdomFirm. A modular, config-driven Python framework for internal workflows.
https://github.com/wisdomfirm/fms-framework
automation framework internal-tools python timesheet wisdomfirm workflow-engine
Last synced: 4 months ago
JSON representation
The Core Automation Backbone for WisdomFirm. A modular, config-driven Python framework for internal workflows.
- Host: GitHub
- URL: https://github.com/wisdomfirm/fms-framework
- Owner: WisdomFirm
- License: mit
- Created: 2025-12-09T12:58:46.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-12-10T17:10:33.000Z (5 months ago)
- Last Synced: 2025-12-11T02:57:58.755Z (5 months ago)
- Topics: automation, framework, internal-tools, python, timesheet, wisdomfirm, workflow-engine
- Language: Python
- Homepage: https://wisdomfirm.com
- Size: 31.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FMS Framework 🏗️
**The Core Automation Backbone for [WisdomFirm](https://github.com/WisdomFirm).**
**FMS (Flow Management System)** is a modular, config-driven Python framework designed to orchestrate internal workflows, automate administrative tasks, and manage AI agent pipelines. It serves as the foundational "Operating System" for WisdomFirm's automated business logic.
---
## ⚠️ Pre-Release Notice
This project is currently in active development (`v0.2.0`). Features are subject to change, and stability is not guaranteed. It is intended for testing and development purposes only.
---
## 🚀 Key Features
* **🔌 Modular Architecture:** Plug-and-play design. New capabilities (like AI agents or SEO bots) can be added as isolated modules without touching the core engine.
* **⚙️ Config-Driven:** Fully controlled via `config/settings.yaml`. No hard-coding required to switch tasks on or off.
* **⏱️ Automated TimeSheet:** Built-in module to log runtime sessions and user activity into CSV format automatically.
* **🛡️ Scalable Core:** Lightweight `FMSEngine` designed to handle sequential task execution efficiently.
---
## 📂 Project Structure
```text
fms-framework/
├── .github/ # Workflow (CI/CD) and Issue Templates
├── config/
│ └── settings.yaml # Central Configuration
├── core/
│ ├── engine.py # The Brain (Task Runner)
│ └── base_module.py # Interface Definition
├── modules/
│ ├── system_monitor.py # Host Analysis Module
│ └── timesheet.py # Time Logging Module
├── main.py # Entry Point
└── requirements.txt # Dependencies
```
## 🛠️ Installation & Usage
### 1. Prerequisites
* Python 3.8 or higher
### 2. Installation
Clone the repository and install dependencies:
```bash
git clone [https://github.com/WisdomFirm/fms-framework.git](https://github.com/WisdomFirm/fms-framework.git)
cd fms-framework
pip install -r requirements.txt
```
### 3. Configuration
Edit `config/settings.yaml` to define which modules to run:
```yaml
app_name: "WisdomFirm FMS Core"
tasks:
- "system_monitor"
- "timesheet"
```
### 4. Run the Engine
Execute the main script to start the automation pipeline:
```bash
python main.py
```
## 📦 Built-in Modules
### 1. System Monitor (`system_monitor`)
Analyzes the host infrastructure to ensure the environment is ready for automation tasks.
* **Checks:** OS Version, Processor Architecture, Python Runtime.
### 2. TimeSheet Logger (`timesheet`)
Automatically logs the session start time and user identity.
* **Output:** Generates/Updates `timesheet_data.csv`.
* **Fields:** Timestamp, User, Action, Status.
---
## 🔮 Roadmap
* [ ] **AI Connector Module:** Integration with Google Gemini Pro API.
* [ ] **SEO Auto-Generator:** Automated content structure generation.
* [ ] **Notification Service:** Line Notify integration for task completion alerts.
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
Built with ❤️ by WisdomFirm Team
Innovating Education & Business through AI Automation.