propongo 1.3.4__py3-none-any.whl

app/models.py

@@ -0,0 +1,201 @@
+"""Data models for Propongo.
+
+Tasks and budget items are stored as dictionaries with the following structure:
+
+Task dict:
+    {
+        'id': str,                # UUID
+        'name': str,              # Task name
+        'description': str,       # Task description
+        'lead_entity': str,       # Organization responsible
+        'start_month': int,       # Start month (1-12)
+        'start_year': int,        # Start year
+        'duration_months': int,   # Duration in months
+    }
+
+BudgetItem dict:
+    {
+        'id': str,                # UUID
+        'task_id': str,           # Associated task UUID
+        'name': str,              # Item name
+        'cost_per_unit': float,   # Unit cost
+        'units': float,           # Number of units
+    }
+
+Custom Section dict:
+    {
+        'id': str,                # UUID
+        'title': str,             # Section title
+        'content': str,           # Markdown content
+        'order': int,             # Display order
+    }
+"""
+
+import json
+import logging
+import os
+import shutil
+import sys
+from dataclasses import dataclass, field, asdict
+from typing import Optional
+from datetime import datetime
+import uuid
+
+logger = logging.getLogger(__name__)
+
+if sys.platform == "win32":
+    _DATA_ROOT = os.path.join(os.path.expanduser("~"), "Documents", "Propongo")
+else:
+    _DATA_ROOT = os.path.join(os.path.dirname(os.path.dirname(__file__)), "data")
+PROPOSALS_DIR = os.path.join(_DATA_ROOT, "proposals")
+TEMPLATES_DIR = os.path.join(_DATA_ROOT, "templates")
+
+
+def _migrate_from_propongo2() -> None:
+    """Migrate user data from Propongo2 to Propongo on Windows."""
+    if sys.platform != "win32":
+        return
+    old_root = os.path.join(os.path.expanduser("~"), "Documents", "Propongo2")
+    if not os.path.isdir(old_root):
+        return
+    if os.path.isdir(_DATA_ROOT):
+        return
+    try:
+        shutil.copytree(old_root, _DATA_ROOT)
+        logger.info("Migrated data from %s to %s", old_root, _DATA_ROOT)
+    except OSError:
+        logger.warning("Could not migrate data from %s", old_root)
+
+
+def ensure_dirs() -> None:
+    """Ensure data directories exist."""
+    _migrate_from_propongo2()
+    os.makedirs(PROPOSALS_DIR, exist_ok=True)
+    os.makedirs(TEMPLATES_DIR, exist_ok=True)
+
+
+@dataclass
+class Proposal:
+    """A project proposal containing tasks, budget items, and custom sections."""
+    id: str = field(default_factory=lambda: str(uuid.uuid4()))
+    title: str = "Untitled Proposal"
+    client_name: str = ""
+    subtitle: str = ""
+    created_at: str = field(default_factory=lambda: datetime.now().isoformat())
+    updated_at: str = field(default_factory=lambda: datetime.now().isoformat())
+
+    project_summary: str = ""
+    scope: str = ""
+    tasks: list = field(default_factory=list)
+    qualifications: str = ""
+
+    budget_items: list = field(default_factory=list)
+    budget_item_timings: dict = field(default_factory=dict)
+    start_date: str = field(default_factory=lambda: datetime.now().strftime("%Y-%m-%d"))
+    end_date: str = ""
+    indirect_percent: float = 0.0
+    show_budget_description: bool = False
+    budget_description: str = ""
+    timeline_use_days: bool = False
+    timeline_show_budget: bool = False
+    custom_sections: list = field(default_factory=list)
+
+    is_template: bool = False
+    template_name: str = ""
+    template_category: str = ""
+
+    milestones: list = field(default_factory=list)
+    reports: list = field(default_factory=list)
+
+    def to_dict(self) -> dict:
+        """Serialize the proposal to a dictionary."""
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Proposal":
+        """Create a Proposal from a dictionary, ignoring unknown fields."""
+        return cls(**{k: v for k, v in data.items() if k in cls.__dataclass_fields__})
+
+    def save(self):
+        """Save the proposal to disk as a JSON file."""
+        ensure_dirs()
+        self.updated_at = datetime.now().isoformat()
+        target_dir = TEMPLATES_DIR if self.is_template else PROPOSALS_DIR
+        filepath = os.path.join(target_dir, f"{self.id}.json")
+        tmp = filepath + ".tmp"
+        with open(tmp, "w") as f:
+            json.dump(self.to_dict(), f, indent=2)
+            f.write("\n")
+        os.replace(tmp, filepath)
+
+    @classmethod
+    def load(cls, proposal_id: str, is_template: bool = False) -> Optional["Proposal"]:
+        """Load a proposal or template by ID from disk."""
+        target_dir = TEMPLATES_DIR if is_template else PROPOSALS_DIR
+        filepath = os.path.join(target_dir, f"{proposal_id}.json")
+        if not os.path.exists(filepath):
+            return None
+        try:
+            with open(filepath, "r") as f:
+                return cls.from_dict(json.load(f))
+        except (json.JSONDecodeError, OSError):
+            return None
+
+    @classmethod
+    def list_all(cls) -> list:
+        """List all proposals, returning summaries sorted by most recent."""
+        ensure_dirs()
+        proposals = []
+        for filename in sorted(os.listdir(PROPOSALS_DIR)):
+            if filename.endswith(".json"):
+                try:
+                    with open(os.path.join(PROPOSALS_DIR, filename), "r") as f:
+                        data = json.load(f)
+                        proposals.append({
+                            "id": data.get("id", filename.replace(".json", "")),
+                            "title": data.get("title", "Untitled"),
+                            "client_name": data.get("client_name", ""),
+                            "updated_at": data.get("updated_at", ""),
+                        })
+                except (json.JSONDecodeError, OSError):
+                    continue
+        return sorted(proposals, key=lambda x: x["updated_at"], reverse=True)
+
+    @classmethod
+    def list_templates(cls) -> list:
+        """List all templates, returning summaries sorted by most recent."""
+        ensure_dirs()
+        templates = []
+        for filename in sorted(os.listdir(TEMPLATES_DIR)):
+            if filename.endswith(".json"):
+                try:
+                    with open(os.path.join(TEMPLATES_DIR, filename), "r") as f:
+                        data = json.load(f)
+                        templates.append({
+                            "id": data.get("id", filename.replace(".json", "")),
+                            "title": data.get("title", "Untitled"),
+                            "template_name": data.get("template_name", ""),
+                            "template_category": data.get("template_category", ""),
+                            "updated_at": data.get("updated_at", ""),
+                        })
+                except (json.JSONDecodeError, OSError):
+                    continue
+        return sorted(templates, key=lambda x: x["updated_at"], reverse=True)
+
+    @classmethod
+    def delete(cls, proposal_id: str, is_template: bool = False) -> bool:
+        """Delete a proposal or template by ID. Returns True if deleted."""
+        target_dir = TEMPLATES_DIR if is_template else PROPOSALS_DIR
+        filepath = os.path.join(target_dir, f"{proposal_id}.json")
+        if os.path.exists(filepath):
+            os.remove(filepath)
+            return True
+        return False
+
+    @property
+    def total_budget(self) -> float:
+        """Compute total budget as the sum of cost_per_unit * units for all items."""
+        return sum(
+            item.get("cost_per_unit", 0) * item.get("units", 0)
+            for item in self.budget_items
+        )

app/snippets/deliverables.json

@@ -0,0 +1,32 @@
+[
+    {
+        "id": "del-survey",
+        "title": "Field Survey Report",
+        "content": "## Field Survey Report\n\nA comprehensive field survey will be conducted to assess current conditions, identify key features, and document existing resources. The survey will include:\n\n- Site walkthrough and observation\n- Photo documentation of key areas\n- GPS mapping of boundaries and features\n- Data collection using standardized protocols\n- Analysis and written report with recommendations\n\n**Deliverable:** Written report with maps, photographs, and management recommendations.",
+        "category": "deliverables"
+    },
+    {
+        "id": "del-assessment",
+        "title": "Natural Resource Assessment",
+        "content": "## Natural Resource Assessment\n\nA detailed assessment of natural resources within the project area, including:\n\n- Inventory of plant and animal species\n- Habitat condition evaluation\n- Water quality and hydrology review\n- Soil analysis and erosion risk mapping\n- Comparison with regional benchmarks\n\n**Deliverable:** Technical report with data tables, maps, and condition ratings.",
+        "category": "deliverables"
+    },
+    {
+        "id": "del-management-plan",
+        "title": "Management Plan",
+        "content": "## Conservation Management Plan\n\nA comprehensive management plan outlining strategies and actions for long-term resource stewardship:\n\n- Current conditions summary\n- Goals and objectives\n- Recommended management actions\n- Implementation schedule\n- Monitoring and evaluation framework\n- Budget estimates for implementation\n\n**Deliverable:** Written plan with appendices, maps, and implementation timeline.",
+        "category": "deliverables"
+    },
+    {
+        "id": "del-monitoring",
+        "title": "Monitoring Protocol",
+        "content": "## Monitoring Protocol\n\nEstablishment of a monitoring program to track conservation outcomes:\n\n- Key performance indicators (KPIs)\n- Sampling design and methods\n- Data collection schedules\n- Reporting templates\n- Adaptive management triggers\n\n**Deliverable:** Monitoring protocol document with data sheets and reporting schedule.",
+        "category": "deliverables"
+    },
+    {
+        "id": "del-gis",
+        "title": "GIS Mapping Package",
+        "content": "## GIS Mapping Package\n\nDigital mapping products to support project planning and implementation:\n\n- Base maps with aerial imagery\n- Land cover/land use classification\n- Habitat type mapping\n- Topographic analysis\n- Project area boundary delineation\n\n**Deliverable:** GIS geodatabase, PDF maps, and web map viewer.",
+        "category": "deliverables"
+    }
+]

app/snippets/organization.json

@@ -0,0 +1,26 @@
+[
+    {
+        "id": "org-about",
+        "title": "About Our Organization",
+        "content": "VR Conservation is dedicated to the preservation and restoration of natural resources through science-based conservation practices. Our team combines decades of field experience with cutting-edge technology to deliver measurable conservation outcomes for communities, landowners, and government agencies.",
+        "category": "organization"
+    },
+    {
+        "id": "org-mission",
+        "title": "Mission Statement",
+        "content": "Our mission is to protect and restore critical ecosystems through collaborative conservation, research, and community engagement. We work alongside stakeholders to develop sustainable solutions that balance ecological integrity with community needs.",
+        "category": "organization"
+    },
+    {
+        "id": "org-experience",
+        "title": "Relevant Experience",
+        "content": "Our team has successfully completed over 50 conservation projects across the region, including watershed restoration, wildlife habitat improvement, and natural resource assessments. We maintain strong relationships with state and federal agencies, ensuring our work meets or exceeds regulatory standards.",
+        "category": "organization"
+    },
+    {
+        "id": "org-team",
+        "title": "Team Qualifications",
+        "content": "Our interdisciplinary team includes certified wildlife biologists, hydrologists, GIS specialists, and project managers. Each team member holds relevant certifications and brings a minimum of 10 years of field experience to every project.",
+        "category": "organization"
+    }
+]

app/snippets.py

@@ -0,0 +1,156 @@
+"""Snippet management for reusable text blocks."""
+
+import json
+import os
+import sys
+import uuid
+import logging
+from typing import Tuple, Dict, List, Any
+from flask import Blueprint, render_template, request, jsonify, Response
+from .config import ERROR_MESSAGES
+
+logger = logging.getLogger(__name__)
+
+snippets_bp = Blueprint("snippets", __name__)
+
+_PKG_DIR = os.path.join(os.path.dirname(os.path.dirname(__file__)), "snippets")
+if sys.platform == "win32":
+    SNIPPETS_DIR = os.path.join(os.path.expanduser("~"), "Documents", "Propongo", "snippets")
+else:
+    SNIPPETS_DIR = _PKG_DIR
+CUSTOM_DIR = os.path.join(SNIPPETS_DIR, "custom")
+
+
+def ensure_dirs():
+    """Ensure snippet directories exist."""
+    os.makedirs(SNIPPETS_DIR, exist_ok=True)
+    os.makedirs(CUSTOM_DIR, exist_ok=True)
+
+
+def load_snippets(filename):
+    """Load stock snippets from the package directory."""
+    filepath = os.path.join(_PKG_DIR, filename)
+    if os.path.exists(filepath):
+        with open(filepath, "r") as f:
+            return json.load(f)
+    return []
+
+
+def save_snippets(filename, data):
+    """Save snippets to a JSON file."""
+    ensure_dirs()
+    filepath = os.path.join(SNIPPETS_DIR, filename)
+    with open(filepath, "w") as f:
+        json.dump(data, f, indent=2)
+
+
+def load_custom_snippets():
+    """Load all user-created custom snippets."""
+    ensure_dirs()
+    snippets = []
+    for filename in sorted(os.listdir(CUSTOM_DIR)):
+        if filename.endswith(".json"):
+            with open(os.path.join(CUSTOM_DIR, filename), "r") as f:
+                snippets.append(json.load(f))
+    return snippets
+
+
+@snippets_bp.route("/snippets")
+def get_all_snippets():
+    """Return all snippets grouped by category."""
+    return jsonify({
+        "organization": load_snippets("organization.json"),
+        "deliverables": load_snippets("deliverables.json"),
+        "custom": load_custom_snippets(),
+    })
+
+
+@snippets_bp.route("/snippets/<category>", methods=["POST"])
+def add_snippet(category):
+    """Add a new snippet to the given category."""
+    data = request.get_json()
+    if not data or "title" not in data or "content" not in data:
+        return jsonify({"error": "title and content required"}), 400
+
+    snippet = {
+        "id": data.get("id", uuid.uuid4().hex[:8]),
+        "title": data["title"],
+        "content": data["content"],
+        "category": category,
+    }
+
+    if category == "custom":
+        ensure_dirs()
+        filepath = os.path.join(CUSTOM_DIR, f"{snippet['id']}.json")
+        with open(filepath, "w") as f:
+            json.dump(snippet, f, indent=2)
+    elif category in ("organization", "deliverables"):
+        snippets = load_snippets(f"{category}.json")
+        snippets.append(snippet)
+        save_snippets(f"{category}.json", snippets)
+    else:
+        return jsonify({"error": "Invalid category"}), 400
+
+    return jsonify(snippet), 201
+
+
+@snippets_bp.route("/snippets/<category>/<snippet_id>", methods=["DELETE"])
+def delete_snippet(category, snippet_id):
+    """Delete a snippet by category and ID."""
+    if category == "custom":
+        filepath = os.path.join(CUSTOM_DIR, f"{snippet_id}.json")
+        if os.path.exists(filepath):
+            os.remove(filepath)
+            return jsonify({"ok": True})
+    elif category in ("organization", "deliverables"):
+        snippets = load_snippets(f"{category}.json")
+        snippets = [s for s in snippets if s.get("id") != snippet_id]
+        save_snippets(f"{category}.json", snippets)
+        return jsonify({"ok": True})
+
+    return jsonify(ERROR_MESSAGES['SECTION_NOT_FOUND']), 404
+
+
+@snippets_bp.route("/snippets/import", methods=["POST"])
+def import_snippet():
+    """Import a snippet from a .md, .txt, or .docx file."""
+    if "file" not in request.files:
+        return jsonify(ERROR_MESSAGES['NO_FILE']), 400
+
+    file = request.files["file"]
+    if not file.filename:
+        return jsonify(ERROR_MESSAGES['NO_FILE']), 400
+
+    filename = file.filename.lower()
+    title = request.form.get("title", "").strip()
+    if not title:
+        title = os.path.splitext(file.filename)[0]
+
+    try:
+        if filename.endswith(".md") or filename.endswith(".markdown") or filename.endswith(".txt"):
+            content = file.read().decode("utf-8")
+        elif filename.endswith(".docx"):
+            from docx import Document
+            doc = Document(file)
+            content = "\n\n".join(p.text for p in doc.paragraphs if p.text.strip())
+        else:
+            return jsonify({"error": "Unsupported file type. Use .md, .txt, or .docx"}), 400
+    except Exception as e:
+        return jsonify({"error": f"Failed to read file: {str(e)}"}), 400
+
+    if not content.strip():
+        return jsonify({"error": "File is empty"}), 400
+
+    snippet = {
+        "id": uuid.uuid4().hex[:8],
+        "title": title,
+        "content": content,
+        "category": "custom",
+    }
+
+    ensure_dirs()
+    filepath = os.path.join(CUSTOM_DIR, f"{snippet['id']}.json")
+    with open(filepath, "w") as f:
+        json.dump(snippet, f, indent=2)
+
+    return jsonify(snippet), 201