dct-os 0.1.0__tar.gz

dct_os-0.1.0/.gitignore

@@ -0,0 +1,56 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+.eggs/
+.venv/
+venv/
+env/
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.classpath
+.settings/
+
+# OS
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Environment and secrets
+.env
+.env.*
+*.pem
+*.key
+
+# Database
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Flask instance folder
+instance/
+
+# Claude Code
+.claude/
+
+# Distribution
+*.spec

dct_os-0.1.0/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to DCT-OS will be documented in this file.
+
+## [0.1.0] - 2026-05-31
+
+Initial public release.
+
+### Core Features
+
+- **Project management**: Create, edit, archive, and filter projects with client, code, and date tracking
+- **Three-axis cost model**: Work Orders (client scope), Cost Codes (internal budget), Purchase Orders (financial commitment)
+- **WO-CC matrix**: Restrict which cost codes are valid for each work order
+- **PO drawdown**: Track committed spend against purchase order values in real time
+
+### Docket Entry
+
+- **Header + lines model**: Each docket has a header (date, supplier, docket number, PO) with multiple line items (WO, CC, resource, qty, rate)
+- **Copy docket**: One-click duplication of a previous docket with today's date for recurring plant/labour
+- **PDF/image viewer**: Side-by-side document viewer with folder browse, file dropdown, and prev/next navigation
+- **Source fingerprinting**: SHA-256 hash of source documents stored per docket for duplicate detection
+- **Duplicate warning**: Amber banner when a loaded file's fingerprint matches an existing docket
+- **Resource auto-fill**: Select a resource to auto-populate description, unit, and rate
+- **Cascading dropdowns**: WO selection filters available cost codes per line
+
+### Docket Summary Report
+
+- **Supplier-based reporting**: Generate summaries by supplier with date range or specific docket selection
+- **Category grouping**: Toggle between categorised view (grouped by resource category with subtotals) and flat resource list
+- **CSV export**: One-click export of summary data
+- **Claim tagging**: Mark dockets as claimed with a reference string (e.g. invoice number) for tracking
+- **Hide claimed filter**: Filter out already-claimed dockets from the picker
+
+### Grid & Navigation
+
+- **AG-Grid integration**: Sortable, filterable, resizable columns across all entity types
+- **Continuous scroll**: No pagination on docket grid
+- **Claimed status**: Visual indicator (green tint) for claimed dockets in the grid
+- **Sidebar project list**: Searchable with Active/All filter and quick-edit pencil button
+
+### Technical
+
+- **Flask + SQLite**: Zero-dependency backend, single-file database
+- **Cache busting**: Timestamp-based URL versioning prevents stale browser assets after updates
+- **REST API**: Standard JSON endpoints for all operations
+- **38 automated tests**: Full API test coverage including CRUD, summary, claims, hash checks, and duplicate detection
+- **Demo seed data**: Fictional "Riverbend Shire Council" dataset with 4 projects, 106 dockets, 25 resources

dct_os-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,20 @@
+# Contributing to DCT-OS
+
+Thanks for your interest in contributing to DCT-OS.
+
+## Before You Submit a Pull Request
+
+A Contributor Licence Agreement (CLA) is currently being configured via [CLA Assistant](https://cla-assistant.io/). Until the CLA is in place, we cannot merge pull requests.
+
+**In the meantime, please open an issue first** to discuss any proposed changes. This ensures your contribution aligns with the project direction and avoids wasted effort.
+
+## How to Contribute
+
+1. **Open an issue** describing the bug, feature, or improvement you have in mind.
+2. **Discuss** the approach with the maintainers before writing code.
+3. Once the CLA is live, **fork the repo**, make your changes, and submit a pull request.
+4. **Sign the CLA** when prompted on your first PR — it's a one-time process via GitHub OAuth.
+
+## Code of Conduct
+
+Be respectful, constructive, and professional. We're building tools for engineers — keep the signal-to-noise ratio high.

dct_os-0.1.0/LICENSE

@@ -0,0 +1,65 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Andy Unger
+Licensed Work:        DCT-OS
+                      The Licensed Work is (c) 2026 Andy Unger.
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided such use does not include offering the
+                      Licensed Work to third parties on a hosted or
+                      embedded basis to derive revenue from the
+                      functionality of the Licensed Work.
+Change Date:          Four years from the date the Licensed Work is
+                      published, on a per-release basis.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact: astral2@gmx.de
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create
+derivative works, redistribute, and make non-production use of the
+Licensed Work. The Licensor may make an Additional Use Grant, above,
+permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first
+publicly available distribution of a specific version of the Licensed
+Work under this License, whichever comes first, the Licensor hereby
+grants you rights under the terms of the Change License, and the rights
+granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or
+authorized resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative
+works of the Licensed Work, are subject to this License. This License
+applies separately for each version of the Licensed Work and the Change
+Date may vary for each version of the Licensed Work released by
+Licensor.
+
+You must conspicuously display this License on each original or modified
+copy of the Licensed Work. If you receive the Licensed Work in original
+or modified form from a third party, the terms and conditions set forth
+in this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will
+automatically terminate your rights under this License for the current
+and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or
+logo of Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
+PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES
+AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION)
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+NON-INFRINGEMENT, AND TITLE.

dct_os-0.1.0/LICENSING.md

@@ -0,0 +1,37 @@
+# DCT-OS Licensing
+
+DCT-OS is released under the [Business Source License 1.1](LICENSE). This page explains what that means in plain English.
+
+## What's Free
+
+| Use Case | Allowed? |
+|---|---|
+| Engineer running it on their laptop for daily cost tracking | Yes — free, always |
+| Small contractor using it internally across their projects | Yes — free, always |
+| Council or organisation adopting it internally | Yes — free, always |
+| Modifying the code to fit your internal workflow | Yes — free, always |
+| Contributing improvements back via pull request | Yes — free, always |
+
+No registration, no licence key, no usage limits, no phone-home.
+
+## What Needs a Commercial Licence
+
+| Use Case | Licence Required? |
+|---|---|
+| Hosting DCT-OS as a SaaS and charging others to use it | Yes — commercial licence required |
+| Bundling DCT-OS into a product you sell | Yes — commercial licence required |
+| Reselling DCT-OS as your own product | Yes — commercial licence required |
+
+The line is simple: **if you're deriving revenue from offering DCT-OS functionality to third parties, you need a commercial licence.** Using it internally for your own work is always free.
+
+## The Four-Year Conversion
+
+Each release of DCT-OS automatically converts to the [Apache Licence 2.0](https://www.apache.org/licenses/LICENSE-2.0) four years after its publication date. Once converted, that version is fully open source with no restrictions beyond the Apache 2.0 terms.
+
+New releases start their own four-year clock under the BSL.
+
+## Commercial Licensing
+
+For commercial licence enquiries, pricing, or questions about whether your use case requires a licence:
+
+**astral2@gmx.de**

dct_os-0.1.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: dct-os
+Version: 0.1.0
+Summary: Daily cost tracking for civil engineering
+Project-URL: Homepage, https://github.com/h3ylis/dct-os
+Project-URL: Issues, https://github.com/h3ylis/dct-os/issues
+Author-email: Andy Unger <astral2@gmx.de>
+License-Expression: BUSL-1.1
+License-File: LICENSE
+Keywords: civil-engineering,cost-tracking,project-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.11
+Requires-Dist: flask>=3.0
+Description-Content-Type: text/markdown
+
+# DCT-OS
+
+**Daily cost tracking, done right.**
+
+DCT-OS is a cost tracking platform built for civil engineering — project managers, site engineers, and contractors who need to track daily costs without fighting enterprise software. SQLite-backed, self-hostable, and ready to deploy.
+
+## Features
+
+- Project and cost code management
+- Daily docket entry with resource rate lookups
+- PDF-assisted manual entry (PDF viewer + form side-by-side)
+- Project summary, cost code breakdown, and supplier spend reports
+- CSV and Excel export
+- REST API for all operations
+- Single binary or `pip install` — runs anywhere
+
+## Installation (Windows)
+
+You only need to do this once. After that, DCT-OS starts automatically every time you turn on your computer.
+
+### Option A: Let Claude do it
+
+If you have [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed, open it and paste this:
+
+```
+Install DCT-OS for me. Run: pip install dct-os, then run: dct-os install.
+If Python isn't installed, download and install it from python.org first
+(make sure "Add Python to PATH" is ticked). After install, run: dct-os
+to start it and open the browser.
+```
+
+Claude will handle the rest. Once it's done, bookmark [http://localhost:5000](http://localhost:5000) and you're set.
+
+### Option B: Do it yourself
+
+### Step 1: Install Python
+
+1. Go to [python.org/downloads](https://www.python.org/downloads/)
+2. Click the big yellow **Download Python** button
+3. Run the installer
+4. **Important:** Tick the box that says **"Add Python to PATH"** at the bottom of the first screen
+5. Click **Install Now** and wait for it to finish
+
+### Step 2: Install DCT-OS
+
+1. Press the **Windows key**, type `cmd`, and press **Enter** to open a command prompt
+2. Type the following and press **Enter**:
+
+```
+pip install dct-os
+```
+
+Wait for it to finish (you'll see some download progress, then it returns to the blinking cursor).
+
+3. Type the following and press **Enter**:
+
+```
+dct-os install
+```
+
+You'll see a confirmation message. That's it. You're done with the command prompt and can close it.
+
+### Step 3: Start DCT-OS
+
+Type the following and press **Enter**:
+
+```
+dct-os
+```
+
+Your browser will open to DCT-OS with demo data loaded. Have a click around.
+
+From now on, **DCT-OS starts automatically when you log in to Windows**. No command prompt needed. Just open your browser and go to:
+
+**[http://localhost:5000](http://localhost:5000)**
+
+> **Tip:** Bookmark that address. It's your DCT-OS.
+
+### Updating
+
+When a new version is available, a banner will appear at the top of DCT-OS. To update:
+
+1. Open a command prompt (Windows key, type `cmd`, Enter)
+2. Type:
+
+```
+pip install --upgrade dct-os
+```
+
+3. Close the command prompt. DCT-OS will use the new version next time it starts.
+
+Your data is never touched during updates.
+
+### Uninstalling
+
+To stop DCT-OS from starting automatically (your data is kept):
+
+```
+dct-os uninstall
+```
+
+To fully remove:
+
+```
+pip uninstall dct-os
+```
+
+Your database stays in your user folder at `%LOCALAPPDATA%\DCT-OS\` unless you delete it manually.
+
+---
+
+## Quick Start (for developers)
+
+```bash
+pip install dct-os
+dct-os
+```
+
+Your browser opens automatically to [http://localhost:5000](http://localhost:5000). Demo data loads on first run.
+
+### Auto-start on Windows
+
+```bash
+dct-os install     # creates a silent startup entry
+dct-os uninstall   # removes it (keeps your data)
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/h3ylis/dct-os.git
+cd dct-os
+pip install -e .
+dct-os
+```
+
+### Options
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `DCT_PORT` | `5000` | Server port |
+| `DCT_HOST` | `127.0.0.1` | Bind address |
+| `DCT_DATA_DIR` | `.` (current dir) | Where to store the database |
+| `DCT_NO_SEED` | unset | Set to `1` to start with an empty database |
+
+## Licence and Use
+
+DCT-OS is released under the [Business Source License 1.1](LICENSE).
+
+**What this means:**
+
+- **Free for internal use** — engineers, contractors, and organisations running it for their own cost tracking. Modify it, deploy it internally, use it on every project. No cost, no limits, no phone-home.
+- **Commercial licence required** for hosted or embedded use — if you're offering DCT-OS to third parties as a service, bundling it into a product you sell, or reselling it, you need a commercial licence.
+- **Converts to Apache 2.0** after four years per release — every version eventually becomes fully open under the Apache Licence.
+
+See [LICENSING.md](LICENSING.md) for the full breakdown of what's free and what needs a commercial licence.
+
+For commercial licensing enquiries: **astral2@gmx.de**
+
+## Contributing
+
+We welcome contributions. A Contributor Licence Agreement (CLA) is being configured — please open an issue for discussion before submitting pull requests.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## Contact
+
+- Commercial licensing: astral2@gmx.de
+- Bug reports and feature requests: [GitHub Issues](../../issues)

dct_os-0.1.0/README.md

@@ -0,0 +1,169 @@
+# DCT-OS
+
+**Daily cost tracking, done right.**
+
+DCT-OS is a cost tracking platform built for civil engineering — project managers, site engineers, and contractors who need to track daily costs without fighting enterprise software. SQLite-backed, self-hostable, and ready to deploy.
+
+## Features
+
+- Project and cost code management
+- Daily docket entry with resource rate lookups
+- PDF-assisted manual entry (PDF viewer + form side-by-side)
+- Project summary, cost code breakdown, and supplier spend reports
+- CSV and Excel export
+- REST API for all operations
+- Single binary or `pip install` — runs anywhere
+
+## Installation (Windows)
+
+You only need to do this once. After that, DCT-OS starts automatically every time you turn on your computer.
+
+### Option A: Let Claude do it
+
+If you have [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed, open it and paste this:
+
+```
+Install DCT-OS for me. Run: pip install dct-os, then run: dct-os install.
+If Python isn't installed, download and install it from python.org first
+(make sure "Add Python to PATH" is ticked). After install, run: dct-os
+to start it and open the browser.
+```
+
+Claude will handle the rest. Once it's done, bookmark [http://localhost:5000](http://localhost:5000) and you're set.
+
+### Option B: Do it yourself
+
+### Step 1: Install Python
+
+1. Go to [python.org/downloads](https://www.python.org/downloads/)
+2. Click the big yellow **Download Python** button
+3. Run the installer
+4. **Important:** Tick the box that says **"Add Python to PATH"** at the bottom of the first screen
+5. Click **Install Now** and wait for it to finish
+
+### Step 2: Install DCT-OS
+
+1. Press the **Windows key**, type `cmd`, and press **Enter** to open a command prompt
+2. Type the following and press **Enter**:
+
+```
+pip install dct-os
+```
+
+Wait for it to finish (you'll see some download progress, then it returns to the blinking cursor).
+
+3. Type the following and press **Enter**:
+
+```
+dct-os install
+```
+
+You'll see a confirmation message. That's it. You're done with the command prompt and can close it.
+
+### Step 3: Start DCT-OS
+
+Type the following and press **Enter**:
+
+```
+dct-os
+```
+
+Your browser will open to DCT-OS with demo data loaded. Have a click around.
+
+From now on, **DCT-OS starts automatically when you log in to Windows**. No command prompt needed. Just open your browser and go to:
+
+**[http://localhost:5000](http://localhost:5000)**
+
+> **Tip:** Bookmark that address. It's your DCT-OS.
+
+### Updating
+
+When a new version is available, a banner will appear at the top of DCT-OS. To update:
+
+1. Open a command prompt (Windows key, type `cmd`, Enter)
+2. Type:
+
+```
+pip install --upgrade dct-os
+```
+
+3. Close the command prompt. DCT-OS will use the new version next time it starts.
+
+Your data is never touched during updates.
+
+### Uninstalling
+
+To stop DCT-OS from starting automatically (your data is kept):
+
+```
+dct-os uninstall
+```
+
+To fully remove:
+
+```
+pip uninstall dct-os
+```
+
+Your database stays in your user folder at `%LOCALAPPDATA%\DCT-OS\` unless you delete it manually.
+
+---
+
+## Quick Start (for developers)
+
+```bash
+pip install dct-os
+dct-os
+```
+
+Your browser opens automatically to [http://localhost:5000](http://localhost:5000). Demo data loads on first run.
+
+### Auto-start on Windows
+
+```bash
+dct-os install     # creates a silent startup entry
+dct-os uninstall   # removes it (keeps your data)
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/h3ylis/dct-os.git
+cd dct-os
+pip install -e .
+dct-os
+```
+
+### Options
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `DCT_PORT` | `5000` | Server port |
+| `DCT_HOST` | `127.0.0.1` | Bind address |
+| `DCT_DATA_DIR` | `.` (current dir) | Where to store the database |
+| `DCT_NO_SEED` | unset | Set to `1` to start with an empty database |
+
+## Licence and Use
+
+DCT-OS is released under the [Business Source License 1.1](LICENSE).
+
+**What this means:**
+
+- **Free for internal use** — engineers, contractors, and organisations running it for their own cost tracking. Modify it, deploy it internally, use it on every project. No cost, no limits, no phone-home.
+- **Commercial licence required** for hosted or embedded use — if you're offering DCT-OS to third parties as a service, bundling it into a product you sell, or reselling it, you need a commercial licence.
+- **Converts to Apache 2.0** after four years per release — every version eventually becomes fully open under the Apache Licence.
+
+See [LICENSING.md](LICENSING.md) for the full breakdown of what's free and what needs a commercial licence.
+
+For commercial licensing enquiries: **astral2@gmx.de**
+
+## Contributing
+
+We welcome contributions. A Contributor Licence Agreement (CLA) is being configured — please open an issue for discussion before submitting pull requests.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## Contact
+
+- Commercial licensing: astral2@gmx.de
+- Bug reports and feature requests: [GitHub Issues](../../issues)

dct_os-0.1.0/dct_os/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

dct_os-0.1.0/dct_os/__main__.py

@@ -0,0 +1,3 @@
+from dct_os.app import main
+
+main()

dct_os-0.1.0/dct_os/api/__init__.py

@@ -0,0 +1,28 @@
+from flask import Blueprint, jsonify
+
+from .projects import bp as projects_bp
+from .cost_codes import bp as cost_codes_bp
+from .resources import bp as resources_bp
+from .dockets import bp as dockets_bp
+from .work_orders import bp as work_orders_bp
+from .purchase_orders import bp as purchase_orders_bp
+
+api = Blueprint("api", __name__, url_prefix="/api")
+
+api.register_blueprint(projects_bp)
+api.register_blueprint(cost_codes_bp)
+api.register_blueprint(resources_bp)
+api.register_blueprint(dockets_bp)
+api.register_blueprint(work_orders_bp)
+api.register_blueprint(purchase_orders_bp)
+
+
+@api.route("/version", methods=["GET"])
+def version_info():
+    from dct_os import __version__
+    from dct_os.db import get_update_info
+    info = {"version": __version__}
+    update = get_update_info()
+    if update:
+        info["update_available"] = update["latest"]
+    return jsonify(info)