Skip to content

codedelta1824/Thesis-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Student Thesis Manager Engine

A robust, modular, terminal-based Command Line Interface (CLI) application built with Python. The Student Thesis Manager Engine is designed to streamline high-volume academic thesis printing and binding operations by providing comprehensive financial tracking, workflow management, reporting, and logistics monitoring within a fully local environment.

Overview

The Student Thesis Manager Engine digitizes and automates the management of student thesis production workflows. It eliminates the inefficiencies of manual record-keeping by centralizing data management, automating financial calculations, and generating operational reports.

The application stores data locally using structured JSON databases while maintaining synchronized human-readable text backups for quick inspection and auditing. It also incorporates defensive input-handling mechanisms that prevent accidental navigation errors caused by unintended keystrokes.

To ensure long-term compatibility, the system includes data sanitation and normalization routines capable of processing legacy records, removing formatting inconsistencies, and converting historical data into clean, structured datasets suitable for analysis and reporting.

Project Objectives

The primary objective of this software is to provide a reliable, dependency-free local management platform for thesis printing and binding operations.

Financial Accuracy

  • Eliminate calculation errors across varying page counts, paper types, and binding methods.
  • Support multiple pricing structures and billing scenarios.
  • Automate profit and loss calculations.

Operational Tracking

  • Monitor thesis production through multiple workflow stages.
  • Track checked, unchecked, pending, delivered, and undelivered orders.
  • Improve transparency across production and delivery pipelines.

Data Portability

  • Generate timestamped CSV exports for reporting, auditing, and spreadsheet analysis.
  • Enable seamless data migration and external record management.

System Reliability

  • Protect against runtime data inconsistencies.
  • Maintain stable application flow through controlled navigation systems.
  • Reduce risks associated with malformed records and user input errors.

Key Features

Data Entry & Record Management

Multi-Entry Ledger Processing (Option 1)

  • Create individual or bulk student records.
  • Built-in validation for text and numerical inputs.
  • Streamlined batch data entry workflow.

Unified Account Merging (Option 6)

  • Merge duplicate customer records.
  • Consolidate quantities, costs, and billing information.
  • Prevent database duplication and record fragmentation.

Surcharges & Billing Adjustments (Options 7 & 12)

  • Apply discounts to existing accounts.
  • Add additional charges or outstanding balances.
  • Update customer invoices dynamically.

Financial Intelligence & Auditing

Three-Way Financial Matrix (Option 5)

Generate analytical financial summaries categorized into:

  • Overall Accounts
  • Delivered Accounts
  • Undelivered Accounts

Profit & Loss Statement Engine (Option 9)

Calculate:

  • Revenue
  • Printing expenses
  • Binding expenses
  • Operational costs
  • Net profit/loss
  • Available cash reserves

Accounts Receivable Management (Options 10 & 13)

Track:

  • Collected payments
  • Outstanding balances
  • Pending receivables
  • Business liquidity status

Logistics & Workflow Management

Production Milestone Manager (Option 11)

Manage production stages using status indicators such as:

  • Checked
  • Unchecked
  • Pending

Delivery Management Board (Option 15)

Monitor delivery status through:

  • Delivered
  • Pending Delivery

Live updates ensure accurate operational visibility.

System Safety & Reliability

Navigation Protection System

The application uses controlled input gates to prevent accidental menu skips caused by rapid typing or key spamming.

Universal CSV Export Engine

CSV export functionality is integrated throughout major reporting modules, generating timestamped spreadsheets within a dedicated export directory for easy access and long-term record retention.

Project Structure

student_thesis_manager/
│
├── main.py
│   └── Application entry point
│
├── thesis_data.json
│   └── Primary JSON database
│
├── thesis_data.txt
│   └── Auto-synchronized text backup
│
├── src/
│   │
│   ├── __init__.py
│   │   └── Package initializer
│   │
│   ├── cli.py
│   │   └── Terminal UI, menus, and navigation controls
│   │
│   ├── config.py
│   │   └── Global pricing, configuration, and environment settings
│   │
│   ├── core.py
│   │   └── Financial calculations and business logic
│   │
│   ├── storage.py
│   │   └── Database operations and synchronization services
│   │
│   └── exporter.py
│       └── CSV export utilities
│
└── exports/
    │
    ├── three_way_financial_summary_YYYYMMDD_HHMMSS.csv
    ├── logistics_and_delivery_schedule_YYYYMMDD_HHMMSS.csv
    └── general_accounts_receivable_roster_YYYYMMDD_HHMMSS.csv

Technology Stack

Component Technology
Language Python 3.x
Interface Terminal / CLI
Database JSON
Reporting CSV
Architecture Modular, Layered, Decoupled
Deployment Local Environment

Design Philosophy

The application follows a modular architecture that separates:

  • User Interface Layer
  • Business Logic Layer
  • Data Storage Layer
  • Export & Reporting Layer
  • Configuration Layer

This separation improves maintainability, scalability, testing, and future extensibility while keeping the system lightweight and dependency-free.

Future Expansion Opportunities

The architecture has been designed to support future enhancements, including:

  • Web-based dashboards
  • REST API integrations
  • SQL database backends
  • Networked client-server deployments
  • Multi-user authentication systems
  • Cloud synchronization capabilities

These upgrades can be implemented without modifying the core financial calculation engine.

Conclusion

The Student Thesis Manager Engine transforms traditional thesis printing and binding management from manual spreadsheets and fragmented records into a structured, reliable, and scalable operational platform. By combining financial automation, workflow tracking, and reporting capabilities within a modular architecture, the system provides a strong foundation for both current operations and future expansion.

Contact

For technical inquiries, deployment assistance, bug reports, feature requests, or collaboration opportunities:

Email: codedelta1824@gmail.com

Support

If you find this project useful, consider starring the repository. Contributing improvements through pull requests or issue submissions is appreciated.

About

Thesis Manager is a Python CLI tool for organizing thesis workflow. It stores thesis details, tracks expenses, and exports records using JSON/text storage, providing a lightweight command-line interface for managing research data, budgets, and project information in one place.

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages