openconstructionerp 0.2.1__tar.gz

openconstructionerp-0.2.1/.env.example

@@ -0,0 +1,25 @@
+# Database (default: SQLite, no config needed)
+# DATABASE_URL=sqlite+aiosqlite:///./openestimate.db
+# For PostgreSQL:
+# DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/openestimate
+
+# Auth
+JWT_SECRET=change-me-in-production
+
+# Redis (optional)
+# REDIS_URL=redis://localhost:6379/0
+
+# S3/MinIO (optional)
+# S3_ENDPOINT=http://localhost:9000
+# S3_ACCESS_KEY=minioadmin
+# S3_SECRET_KEY=minioadmin
+
+# AI (optional — add your provider key)
+# OPENAI_API_KEY=sk-...
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# Vector search backend (default: lancedb)
+# VECTOR_BACKEND=lancedb
+
+# Demo accounts (set to false in production)
+# SEED_DEMO=true

openconstructionerp-0.2.1/.gitignore

@@ -0,0 +1,115 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+
+# Node
+node_modules/
+frontend/dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.production
+
+# Database
+*.db
+*.db-shm
+*.db-wal
+*.sqlite3
+openestimate.db*
+
+# Docker volumes
+pg_data/
+minio_data/
+qdrant_data/
+
+# Testing
+htmlcov/
+.coverage
+coverage.xml
+.pytest_cache/
+frontend/test-results/
+frontend/e2e-results/
+*.trace.zip
+
+# Build
+*.tar.gz
+*.whl
+frontend/stats.html
+
+# Logs
+*.log
+logs/
+
+# Generated
+backend/locales/
+i18n-audit/
+translation_keys.txt
+
+# Claude Code / MCP
+.claude/
+.mcp.json
+.playwright-mcp/
+
+# QA / Dev artifacts
+screenshots/
+!docs/screenshots/
+qa-tests/
+ux-review/
+QA_*.md
+UX_*.md
+TESTING_PLAN.md
+TAKEOFF_TESTING_PLAN.md
+IMPROVEMENTS_TODO.md
+AUDIT_*.md
+REVIEW_PROGRESS.md
+test-screenshots/
+
+# Dev screenshots & images
+*.png
+*.jpeg
+*.jpg
+!frontend/public/favicon.png
+!frontend/public/logo.png
+!docs/screenshots/*.png
+!frontend/public/og-image.png
+!frontend/public/*.jpg
+!frontend/public/*.jpeg
+
+# QA test scripts (contain demo credentials)
+backend/qa_*.py
+backend/tmp_*.json
+
+# LanceDB local data
+lancedb_data/
+*.lance
+
+# Cached data
+*.parquet
+.openestimator/
+
+# Desktop build
+desktop/dist/
+desktop/build/
+desktop/src-tauri/target/
+desktop/src-tauri/binaries/
+
+# Backup files
+*.backup.*

openconstructionerp-0.2.1/CLAUDE.md

@@ -0,0 +1,60 @@
+# CLAUDE.md — Backend (FastAPI)
+
+Parent: [../CLAUDE.md](../CLAUDE.md)
+
+## Контекст
+
+FastAPI backend для OpenEstimate. Async-first, module-based architecture.
+Все бизнес-модули в `app/modules/`. Core framework в `app/core/`.
+
+## Команды
+
+```bash
+uvicorn app.main:create_app --factory --reload --port 8000
+pytest
+pytest --cov=app --cov-report=term
+ruff check app/ tests/
+ruff format app/ tests/
+alembic upgrade head
+alembic revision --autogenerate -m "description"
+```
+
+## Архитектурные правила
+
+### Layered Architecture
+
+```
+Router (HTTP) → Service (Business Logic) → Repository (Data Access) → Database
+                     ↕                            ↕
+                  Events/Hooks              SQLAlchemy Models
+                     ↕
+                 Validation
+```
+
+- **Router**: только HTTP логика. НЕ бизнес-логика.
+- **Service**: вся бизнес-логика. Stateless. Events, hooks, validation.
+- **Repository**: data access. SQLAlchemy queries only.
+- **Models**: SQLAlchemy ORM. Наследуют `app.database.Base`.
+- **Schemas**: Pydantic v2 request/response.
+
+### Database Conventions
+
+- Table names: `oe_{module}_{entity}`
+- All tables: `id` (UUID PK), `created_at`, `updated_at`, `created_by`
+- JSONB для metadata
+- Temporal: `valid_from`, `valid_to` для versioned records
+
+### Validation — обязательна при любом импорте данных
+
+```python
+report = await validation_engine.validate(data=parsed, rule_sets=["gaeb", "boq_quality"])
+if report.has_errors:
+    return ImportResult(status="validation_failed", report=report)
+```
+
+### Performance Targets
+
+- CRUD: < 200ms (p95)
+- BOQ load 1000 positions: < 500ms
+- Validation 1000 positions: < 2s
+- CWICR search: < 100ms

openconstructionerp-0.2.1/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: openconstructionerp
+Version: 0.2.1
+Summary: The #1 open-source platform for construction cost estimation — BOQ, 4D/5D, AI, CAD/BIM takeoff
+Project-URL: Homepage, https://datadrivenconstruction.io/erp
+Project-URL: Documentation, https://openconstructionerp.com/docs
+Project-URL: Repository, https://github.com/datadrivenconstruction/OpenConstructionERP
+Project-URL: Issues, https://github.com/datadrivenconstruction/OpenConstructionERP/issues
+Project-URL: Changelog, https://github.com/datadrivenconstruction/OpenConstructionERP/blob/main/CHANGELOG.md
+Author-email: Artem Boiko <info@datadrivenconstruction.io>
+Maintainer-email: Data Driven Construction <info@datadrivenconstruction.io>
+License-Expression: AGPL-3.0-or-later
+Keywords: bill-of-quantities,bim,boq,cad,construction,cost-estimation,cwicr,din276,erp,fastapi,gaeb,ifc,masterformat,nrm,open-source,quantity-surveying,react,revit
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: alembic>=1.14.0
+Requires-Dist: bcrypt>=4.0.0
+Requires-Dist: email-validator>=2.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: orjson>=3.10.0
+Requires-Dist: pdfplumber>=0.11.0
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: python-multipart>=0.0.12
+Requires-Dist: reportlab>=4.0.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.36
+Requires-Dist: structlog>=24.4.0
+Requires-Dist: tenacity>=9.0.0
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.40.0; extra == 'ai'
+Requires-Dist: openai>=1.55.0; extra == 'ai'
+Requires-Dist: qdrant-client>=1.12.0; extra == 'ai'
+Requires-Dist: sentence-transformers>=3.3.0; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == 'all'
+Requires-Dist: asyncpg>=0.30.0; extra == 'all'
+Requires-Dist: boto3>=1.35.0; extra == 'all'
+Requires-Dist: celery[redis]>=5.4.0; extra == 'all'
+Requires-Dist: fastembed>=0.4.0; extra == 'all'
+Requires-Dist: lancedb>=0.17.0; extra == 'all'
+Requires-Dist: openai>=1.55.0; extra == 'all'
+Requires-Dist: opencv-python-headless>=4.10.0; extra == 'all'
+Requires-Dist: paddleocr>=2.9.0; extra == 'all'
+Requires-Dist: pillow>=11.0.0; extra == 'all'
+Requires-Dist: psycopg2-binary>=2.9.10; extra == 'all'
+Requires-Dist: pyarrow>=18.0.0; extra == 'all'
+Requires-Dist: pymupdf>=1.25.0; extra == 'all'
+Requires-Dist: qdrant-client>=1.12.0; extra == 'all'
+Requires-Dist: sentence-transformers>=3.3.0; extra == 'all'
+Requires-Dist: ultralytics>=8.3.0; extra == 'all'
+Provides-Extra: cv
+Requires-Dist: opencv-python-headless>=4.10.0; extra == 'cv'
+Requires-Dist: paddleocr>=2.9.0; extra == 'cv'
+Requires-Dist: pillow>=11.0.0; extra == 'cv'
+Requires-Dist: pymupdf>=1.25.0; extra == 'cv'
+Requires-Dist: ultralytics>=8.3.0; extra == 'cv'
+Provides-Extra: dev
+Requires-Dist: factory-boy>=3.3.0; extra == 'dev'
+Requires-Dist: httpx>=0.28.0; extra == 'dev'
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pyinstaller>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: asyncpg>=0.30.0; extra == 'server'
+Requires-Dist: boto3>=1.35.0; extra == 'server'
+Requires-Dist: celery[redis]>=5.4.0; extra == 'server'
+Requires-Dist: psycopg2-binary>=2.9.10; extra == 'server'
+Provides-Extra: vector
+Requires-Dist: fastembed>=0.4.0; extra == 'vector'
+Requires-Dist: lancedb>=0.17.0; extra == 'vector'
+Requires-Dist: pyarrow>=18.0.0; extra == 'vector'
+Description-Content-Type: text/markdown
+
+# OpenConstructionERP
+
+**The #1 open-source platform for construction cost estimation**
+
+Professional BOQ, 4D scheduling, 5D cost model, AI-powered estimation, CAD/BIM takeoff — all in one platform.
+
+## Quick Start
+
+```bash
+pip install openconstructionerp
+openconstructionerp serve --open
+```
+
+Opens at http://localhost:8080 with SQLite — zero configuration needed.
+
+## Features
+
+- **BOQ Editor** — Hierarchical Bill of Quantities with AG Grid, markups, validation, export (PDF/Excel/CSV/GAEB)
+- **55,000+ Cost Items** — CWICR database across 11 regions with resource breakdown
+- **7,000+ Resource Catalog** — Materials, labor, equipment with prices
+- **AI Estimation** — Generate BOQ from text, photo, PDF, Excel, or CAD/BIM (7 LLM providers)
+- **4D Schedule** — Gantt chart with CPM, dependencies, auto-generate from BOQ
+- **5D Cost Model** — Earned Value Management, S-curve, budget tracking
+- **20 Regional Standards** — DIN 276, NRM, MasterFormat, GAEB, and 16 more
+- **21 Languages** — Full i18n with RTL support
+- **42 Validation Rules** — Automatic compliance checking
+
+## CLI Commands
+
+```bash
+openconstructionerp serve [--host HOST] [--port PORT] [--open]
+openconstructionerp init [--data-dir DIR]
+openconstructionerp seed [--demo]
+openconstructionerp version
+```
+
+## Links
+
+- [Documentation](https://openconstructionerp.com/docs)
+- [GitHub](https://github.com/datadrivenconstruction/OpenConstructionERP)
+- [Telegram Community](https://t.me/datadrivenconstruction)
+
+## License
+
+AGPL-3.0 — [Data Driven Construction](https://datadrivenconstruction.io)

openconstructionerp-0.2.1/README.md

@@ -0,0 +1,45 @@
+# OpenConstructionERP
+
+**The #1 open-source platform for construction cost estimation**
+
+Professional BOQ, 4D scheduling, 5D cost model, AI-powered estimation, CAD/BIM takeoff — all in one platform.
+
+## Quick Start
+
+```bash
+pip install openconstructionerp
+openconstructionerp serve --open
+```
+
+Opens at http://localhost:8080 with SQLite — zero configuration needed.
+
+## Features
+
+- **BOQ Editor** — Hierarchical Bill of Quantities with AG Grid, markups, validation, export (PDF/Excel/CSV/GAEB)
+- **55,000+ Cost Items** — CWICR database across 11 regions with resource breakdown
+- **7,000+ Resource Catalog** — Materials, labor, equipment with prices
+- **AI Estimation** — Generate BOQ from text, photo, PDF, Excel, or CAD/BIM (7 LLM providers)
+- **4D Schedule** — Gantt chart with CPM, dependencies, auto-generate from BOQ
+- **5D Cost Model** — Earned Value Management, S-curve, budget tracking
+- **20 Regional Standards** — DIN 276, NRM, MasterFormat, GAEB, and 16 more
+- **21 Languages** — Full i18n with RTL support
+- **42 Validation Rules** — Automatic compliance checking
+
+## CLI Commands
+
+```bash
+openconstructionerp serve [--host HOST] [--port PORT] [--open]
+openconstructionerp init [--data-dir DIR]
+openconstructionerp seed [--demo]
+openconstructionerp version
+```
+
+## Links
+
+- [Documentation](https://openconstructionerp.com/docs)
+- [GitHub](https://github.com/datadrivenconstruction/OpenConstructionERP)
+- [Telegram Community](https://t.me/datadrivenconstruction)
+
+## License
+
+AGPL-3.0 — [Data Driven Construction](https://datadrivenconstruction.io)

openconstructionerp-0.2.1/alembic/env.py

@@ -0,0 +1,71 @@
+"""Alembic migration environment.
+
+Auto-discovers all module models via Base.metadata.
+"""
+
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import pool
+from sqlalchemy.engine import Connection
+from sqlalchemy import create_engine
+
+from app.config import get_settings
+from app.database import Base
+
+# Import all module models so they're registered with Base.metadata.
+# This is done automatically by the module loader at runtime,
+# but we need it here for autogenerate to work.
+from app.modules.users import models as _users  # noqa: F401
+from app.modules.projects import models as _projects  # noqa: F401
+from app.modules.boq import models as _boq  # noqa: F401
+from app.modules.costs import models as _costs  # noqa: F401
+from app.modules.assemblies import models as _asm  # noqa: F401
+from app.modules.schedule import models as _sched  # noqa: F401
+from app.modules.costmodel import models as _cm  # noqa: F401
+from app.modules.ai import models as _ai  # noqa: F401
+from app.modules.tendering import models as _tender  # noqa: F401
+from app.modules.catalog import models as _catalog  # noqa: F401
+from app.modules.takeoff import models as _takeoff  # noqa: F401
+
+config = context.config
+settings = get_settings()
+
+# Render UUID columns properly for autogenerate
+def render_item(type_, obj, autogen_context):
+    """Custom render for UUID type."""
+    if type_ == "type" and hasattr(obj, "__class__") and obj.__class__.__name__ == "GUID":
+        return "sa.String(36)"
+    return False
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    url = settings.database_sync_url
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = create_engine(settings.database_sync_url, poolclass=pool.NullPool)
+
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

openconstructionerp-0.2.1/alembic/script.py.mako

@@ -0,0 +1,26 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

openconstructionerp-0.2.1/alembic/versions/129188e46db8_init_create_all_tables.py

@@ -0,0 +1,32 @@
+"""init: create all tables
+
+Revision ID: 129188e46db8
+Revises:
+Create Date: 2026-03-26 14:32:37.263344
+
+Note: Tables are auto-created by SQLAlchemy Base.metadata.create_all() at startup.
+This migration exists as a baseline marker for Alembic version tracking.
+On fresh databases, all tables already exist before this migration runs.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '129188e46db8'
+down_revision: Union[str, None] = None
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # Tables are created by SQLAlchemy at app startup.
+    # This migration serves as the Alembic baseline.
+    pass
+
+
+def downgrade() -> None:
+    # No-op: tables are managed by SQLAlchemy metadata.
+    pass

openconstructionerp-0.2.1/alembic.ini

@@ -0,0 +1,35 @@
+[alembic]
+script_location = alembic
+sqlalchemy.url = sqlite:///./openestimate.db
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s

openconstructionerp-0.2.1/app/__main__.py

@@ -0,0 +1,56 @@
+"""Entry point for PyInstaller / standalone execution.
+
+Usage:
+    python -m app                    # Dev mode
+    openestimate-server.exe          # Production (PyInstaller bundle)
+"""
+
+import os
+import sys
+import multiprocessing
+
+
+def main() -> None:
+    """Start the OpenConstructionERP backend server."""
+    import uvicorn
+
+    # Parse CLI args: --host X --port Y
+    host = "127.0.0.1"
+    port = 8741
+    args = sys.argv[1:]
+    for i, arg in enumerate(args):
+        if arg == "--host" and i + 1 < len(args):
+            host = args[i + 1]
+        elif arg == "--port" and i + 1 < len(args):
+            try:
+                port = int(args[i + 1])
+            except ValueError:
+                pass
+
+    # Also check env vars as fallback
+    host = os.environ.get("HOST", host)
+    port = int(os.environ.get("PORT", str(port)))
+
+    # Desktop app mode: serve frontend, production settings
+    if getattr(sys, "frozen", False):
+        os.environ.setdefault("SERVE_FRONTEND", "1")
+        os.environ.setdefault("APP_ENV", "production")
+        os.environ.setdefault("APP_DEBUG", "false")
+
+    print(f"Starting OpenConstructionERP on http://{host}:{port}")
+
+    # Use direct app import for PyInstaller compatibility
+    from app.main import create_app
+    app = create_app()
+
+    uvicorn.run(
+        app,
+        host=host,
+        port=port,
+        log_level="info",
+    )
+
+
+if __name__ == "__main__":
+    multiprocessing.freeze_support()
+    main()