MindLedger Specification

Home / MindLedger / MindLedger Specification

MindLedger

Living Version – Continuously Evolving

MindLedger is continuously evolving. Modules and features are updated as technology improves, open-source components are released, and laws change. The AI core ensures system integrity, compliance, security, and continuous improvement.

Overview

MindLedger is a fully modular, open-source business management platform designed for service-based businesses, studios, salons, repair shops, professional services, and organizations requiring flexible CRM, scheduling, billing, compliance, and operational management.

Built around a modular architecture, MindLedger allows businesses to enable only the features they need while expanding functionality through optional plugin modules. The platform is designed to be customizable, privacy-focused, end-to-end encrypted, and continuously evolving.

The integrated AI assistant acts as the intelligent operating layer for MindLedger, allowing users to configure workflows, create custom processes, receive guidance, automate tasks, and maintain compliance through natural language and voice interaction.

Core Architecture

MindLedger is built using a modular system design:

Core modules provide the essential foundation of the platform.
Optional plugin modules extend functionality for specific industries and advanced use cases.
AI assistance connects all modules through natural language interaction.
All modules are designed with open-source components.
All sensitive information is protected through end-to-end encryption.
Users maintain control over their data, workflows, and customization.

Core Modules

AI Assistant Core

The AI assistant is the intelligence layer that connects and manages the MindLedger ecosystem.

Features:

Natural language control of all modules
Voice-to-text input for hands-free operation
Voice-on-demand accessibility for blind and visually impaired users
Step-by-step guidance and interactive tutorials
Split-screen guidance with adjustable AI workspace size
User-defined AI name and personality customization
AI-assisted workflow creation
AI-assisted module customization
AI recommendations for services, pricing, and improvements
Automated compliance monitoring
System integrity monitoring
Debugging assistance
Report generation for changes, updates, and recommendations
Encrypted AI activity logs

CRM Core Module

The CRM module manages customers, leads, relationships, and communications.

Features:

Contact management
Lead management
Customer profiles
Custom fields and categories
Tags and segmentation
Activity history
Appointment history
Call and communication tracking
Task management
Import and export capabilities
Duplicate detection
Data validation
Encrypted client records
Role-based access control

AI enhancements:

Lead scoring
Follow-up recommendations
Client engagement predictions
Inactive client alerts
Referral recommendations
Relationship insights
Automated task suggestions

Scheduling & Appointment Core Module

The scheduling module manages appointments, resources, and availability.

Features:

Appointment creation and management
Multiple calendars
Resource scheduling
Staff scheduling
Room, equipment, and space reservations
Recurring appointments
Appointment reminders
Cancellation tracking
Waitlists
Service-based scheduling

Supports:

Dance studios
Salons
Repair shops
Fitness centers
Schools
Professional services

Billing & Financial Core Module

The billing module manages revenue, payments, invoicing, and financial tracking.

Features:

Appointment pricing
Service pricing
Discounts
Packages
Membership billing
Recurring payments
Invoice creation
Multiple invoice line items
Payment tracking
Partial payments
Refund management
Account balances
Revenue tracking

Payment support:

Cash
Credit card
ACH
Check
Package credits
Membership payments
Bitcoin payments

Bitcoin support includes:

Point-of-sale Bitcoin value recording
Exchange value tracking
Transaction history

Tax & Compliance Core Module

The compliance module helps businesses manage tax-related information.

Features:

Sales tax calculation
Location-based tax rules
Multi-jurisdiction support
Tax exemption management
Tax certificate storage
Tax reporting
Compliance records
Audit trails

Employee and contractor compliance:

Employee classification
Contractor classification
W-4 tracking
W-9 tracking
Payroll tax records
W-2 preparation support
1099-NEC preparation support

AI compliance features:

Monthly review of tax and regulatory updates
Compliance change reports
Legal requirement annotations
Compliance alerts

Workforce & Payroll Core Module

Features:

Employee management
Contractor management
Hourly employees
Salaried employees
Commission-based employees
Independent contractors
Payroll tracking
Contractor payments
Commission calculations
Benefits tracking
Payroll reporting

Reporting & Analytics Core Module

Features:

Revenue dashboards
Client activity reports
Appointment reports
Payment reports
Tax reports
Payroll reports
Commission reports
Budget forecasting
Cash flow analysis
Revenue predictions
Shortfall warnings

AI analytics:

Business recommendations
Market analysis
Performance improvements
Workflow optimization

Security Core Module

Security is integrated throughout MindLedger.

Features:

End-to-end encryption
Two-factor authentication
Role-based permissions
Secure data storage
Encrypted backups
Audit logs
Security monitoring

AI security assistance:

Operating system scanning
Malware detection
Trojan detection
Phishing detection
Corrupted file detection
System repair assistance
Security recommendations

Backup & Recovery Core Module

Features:

Scheduled backups
Backup recommendations
Restore assistance
Disaster recovery planning
Hardware failure guidance
Encrypted backup storage

User Customization Core Module

Features:

Business branding
Business name display
Logo integration
Theme customization
Dashboard customization
Module visibility controls
Custom fields
Workflow customization
User interface preferences

Browser Access & User Dashboard Core Module

The Browser Access & User Dashboard Core Module provides secure browser-based access to MindLedger, allowing authorized users to access their personalized workspace and manage enabled MindLedger functions from any supported web browser.

Features

Secure browser-based login from supported devices.
Credential-based authentication with two-factor authentication.
End-to-end encryption for protected data and communications.
Role-based access control and permission management.
Secure session management, session expiration, and logout controls.
Personalized user dashboard for each authorized user.
Customizable dashboard layouts, widgets, panels, and quick-access controls.
Drag-and-drop dashboard customization.
Show and hide individual dashboard components.
Business name, logo, and branding customization.
User-selectable themes, appearance, and interface preferences.
Dashboard access to enabled MindLedger modules.
Schedule overview and upcoming appointment display.
Staff, resource, room, studio, equipment, and space availability.
Client activity and follow-up information.
Outstanding invoices, balances, payments, and financial summaries.
Revenue summaries and business performance indicators.
Tasks, reminders, notifications, and alerts.
Inventory and low-stock alerts when the inventory module is enabled.
Tax and compliance notifications.
Backup and system health status.
Security notifications and system integrity alerts.
Recent activity and audit history.
Configurable dashboard display values based on user permissions.
Real-time synchronization of authorized changes across connected devices.

Scheduling Management

View schedules by day, week, month, employee, contractor, location, room, studio, equipment, or other resource.
Create, modify, reschedule, and cancel appointments.
Create and modify recurring appointments.
Manage staff and contractor availability.
Manage rooms, studios, chairs, service bays, equipment, and other bookable resources.
Detect scheduling conflicts before changes are committed.
Display location addresses associated with bookable spaces for applicable tax and jurisdiction calculations.
Apply scheduling-related pricing, discounts, packages, memberships, and taxes according to configured business rules.
Synchronize scheduling changes across authorized browser sessions and other MindLedger interfaces.

Natural Language Scheduling

Allow users to modify schedules through natural-language text commands.
Interpret scheduling requests according to the user’s permissions, business configuration, available resources, and existing appointments.
Verify availability and identify conflicts before making changes.
Present consequential scheduling changes for user confirmation before execution.
Provide clear confirmation of completed changes.
Maintain an auditable record of scheduling actions.

Voice Scheduling and Dashboard Control

Voice-to-text input for scheduling and dashboard commands.
Voice-based creation, modification, rescheduling, and cancellation of appointments.
Voice-based navigation of dashboard functions.
Voice commands for viewing schedules, availability, client information, financial summaries, tasks, and notifications.
Voice commands for customizing dashboard visibility and layout.
Voice-on-demand responses for users who require auditory interaction.
Adjustable speech rate, tone, and verbosity.
Accessible voice interaction across supported MindLedger modules.

AI Dashboard Assistance

Provide step-by-step guidance for dashboard and module operations.
Explain available functions and workflows.
Provide an adjustable split-screen interface with AI guidance on one side and the active MindLedger workspace on the other.
Allow users to resize the AI guidance area.
Explain proposed scheduling changes before execution.
Identify conflicts, missing information, permission restrictions, and potential consequences.
Recommend relevant actions while keeping consequential changes under user control.
Report completed changes and provide an activity summary.
Assist users with customizing their dashboard and enabled modules through natural language.

Security and Audit Controls

Enforce user permissions for every dashboard and scheduling action.
Require appropriate authentication for sensitive operations.
Provide confirmation controls for consequential changes.
Maintain secure audit records of dashboard and scheduling activity.
Record relevant user, timestamp, action, affected record, and result information.
Provide session timeout and secure logout.
Protect dashboard communications and sensitive information through end-to-end encryption where applicable.
Prevent unauthorized users from accessing restricted modules, records, schedules, or business information.

Examples

“Show me today’s schedule.”
“Move John’s appointment from 2 PM to 3 PM.”
“Schedule Sarah with Maria tomorrow at 10 AM.”
“Show me the available appointments Friday afternoon.”
“Move all of Mike’s appointments next Tuesday back 30 minutes.”
“Cancel Lisa’s appointment and notify her.”
“Book Studio B from 2 PM to 4 PM.”
“Show me all unpaid invoices.”
“Hide the revenue widget.”
“Put today’s appointments next to client activity.”
“Show me clients I haven’t contacted in 30 days.”
“Open the payroll dashboard.”
“What changed in my schedule today?”

The Browser Access & User Dashboard Core Module serves as the primary browser-based control center for MindLedger while maintaining the modular architecture of the platform. Each enabled module can expose its authorized functions, information, notifications, and controls through the user dashboard without requiring all users to have access to every system function.

Optional Plugin Modules

Optional plugins allow MindLedger to expand based on business needs.

Inventory Management Plugin

Features:

Inventory tracking
Barcode scanning
QR code scanning
Product management
Stock alerts
Automated reorder suggestions
Receipt scanning
OCR expense tracking
Supplier management
Procurement recommendations

Industry Template Plugins

Preconfigured business templates:

Dance Studio
Hair & Beauty Salon
Automotive Repair
Fitness Center
Music School
Massage & Spa
Tattoo Studio
Generic Service Business

Each template provides:

Industry-specific terminology
Default workflows
Recommended services
Custom fields
Scheduling rules
Reporting layouts

The AI assistant can recommend additional services and workflows based on industry needs.

Communication Plugin

Features:

Secure messaging
Email integration
SMS integration
Communication history
Automated reminders
Follow-up workflows
Message compliance tracking

Marketing & Customer Growth Plugin

Features:

Campaign management
Customer segmentation
Referral tracking
Promotions
Client retention tools
Engagement analytics

Market Research Plugin

Features:

Competitor monitoring
Industry trend analysis
Pricing recommendations
Service expansion suggestions
Business improvement recommendations

Community Innovation Plugin

Features:

User-created workflow sharing
Community templates
Innovation submissions
AI validation
Community changelog
Celebration announcements for accepted innovations

Specification Branding License (SBL)

Standard

Fully AGPL-3.0+ compliant system
Copyleft enforced for network deployments
Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/

Optional

Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/mindledger/

License & Notice Requirements

MindLedger is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+). By contributing to this project, you agree that your contributions will also be released under this license.

Please note the following:

All contributions must comply with the AGPL-3.0+ terms.
Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
MindLedger specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update notice.md.
When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.

Notice – MindLedger

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

Roxanne Ardary, roxanneardary.com – March 11, 2026
Created the repository for MindLedger. Developed the initial open-source AI-powered personal knowledge and mind management platform for capturing, organizing, and intelligently retrieving thoughts, ideas, and personal data with privacy-first architecture.
[Add other contributors here] – [Date]
[Describe contribution in one sentence]

License – MindLedger

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points

You are free to use, modify, and distribute the code.
All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.