Compare commits
24 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| c1535e744f | |||
| 15602a976f | |||
| ffc60a6c0f | |||
| 53844ace9a | |||
| f8022279ad | |||
| 763638abd5 | |||
| 99bc442495 | |||
| 61fe16a0ea | |||
| 14979dba4b | |||
| 015586a9df | |||
| 3992384d96 | |||
| cf523cbd86 | |||
| 21cf570cbc | |||
| 4c0586cce8 | |||
| b3c219aa57 | |||
| 31e6359df4 | |||
| d4008569ca | |||
| 836594a863 | |||
| 19db7c1093 | |||
| ee55f1ecef | |||
| 0cca55da0c | |||
| ca3d5e7890 | |||
| be4de13618 | |||
| 682f13543e |
@@ -0,0 +1,12 @@
|
||||
# API Keys (Required to enable respective provider)
|
||||
ANTHROPIC_API_KEY="your_anthropic_api_key_here" # Required: Format: sk-ant-api03-...
|
||||
PERPLEXITY_API_KEY="your_perplexity_api_key_here" # Optional: Format: pplx-...
|
||||
OPENAI_API_KEY="your_openai_api_key_here" # Optional, for OpenAI models. Format: sk-proj-...
|
||||
GOOGLE_API_KEY="your_google_api_key_here" # Optional, for Google Gemini models.
|
||||
MISTRAL_API_KEY="your_mistral_key_here" # Optional, for Mistral AI models.
|
||||
XAI_API_KEY="YOUR_XAI_KEY_HERE" # Optional, for xAI AI models.
|
||||
GROQ_API_KEY="YOUR_GROQ_KEY_HERE" # Optional, for Groq models.
|
||||
OPENROUTER_API_KEY="YOUR_OPENROUTER_KEY_HERE" # Optional, for OpenRouter models.
|
||||
AZURE_OPENAI_API_KEY="your_azure_key_here" # Optional, for Azure OpenAI models (requires endpoint in .taskmaster/config.json).
|
||||
OLLAMA_API_KEY="your_ollama_api_key_here" # Optional: For remote Ollama servers that require authentication.
|
||||
GITHUB_API_KEY="your_github_api_key_here" # Optional: For GitHub import/export features. Format: ghp_... or github_pat_...
|
||||
+26
@@ -1,3 +1,29 @@
|
||||
*.bak
|
||||
*.tmp
|
||||
/legal-docx-v3-fixed/
|
||||
|
||||
# Logs
|
||||
logs
|
||||
*.log
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
dev-debug.log
|
||||
# Dependency directories
|
||||
node_modules/
|
||||
# Environment variables
|
||||
.env
|
||||
# Editor directories and files
|
||||
.idea
|
||||
.vscode
|
||||
*.suo
|
||||
*.ntvs*
|
||||
*.njsproj
|
||||
*.sln
|
||||
*.sw?
|
||||
# OS specific
|
||||
.DS_Store
|
||||
|
||||
# Task files
|
||||
# tasks.json
|
||||
# tasks/
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
{
|
||||
"models": {
|
||||
"main": {
|
||||
"provider": "claude-code",
|
||||
"modelId": "opus",
|
||||
"maxTokens": 32000,
|
||||
"temperature": 0.2
|
||||
},
|
||||
"research": {
|
||||
"provider": "claude-code",
|
||||
"modelId": "opus",
|
||||
"maxTokens": 32000,
|
||||
"temperature": 0.1
|
||||
},
|
||||
"fallback": {
|
||||
"provider": "claude-code",
|
||||
"modelId": "sonnet",
|
||||
"maxTokens": 64000,
|
||||
"temperature": 0.2
|
||||
}
|
||||
},
|
||||
"global": {
|
||||
"logLevel": "info",
|
||||
"debug": false,
|
||||
"defaultNumTasks": 10,
|
||||
"defaultSubtasks": 5,
|
||||
"defaultPriority": "medium",
|
||||
"projectName": "Task Master",
|
||||
"ollamaBaseURL": "http://localhost:11434/api",
|
||||
"bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com",
|
||||
"responseLanguage": "Hebrew",
|
||||
"enableCodebaseAnalysis": true,
|
||||
"enableProxy": false,
|
||||
"anonymousTelemetry": true,
|
||||
"userId": "1234567890"
|
||||
},
|
||||
"claudeCode": {},
|
||||
"codexCli": {},
|
||||
"grokCli": {
|
||||
"timeout": 120000,
|
||||
"workingDirectory": null,
|
||||
"defaultModel": "grok-4-latest"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"currentTag": "master",
|
||||
"lastSwitched": "2026-06-03T07:25:36.666Z",
|
||||
"branchTagMapping": {},
|
||||
"migrationNoticeShown": true
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
{
|
||||
"master": {
|
||||
"tasks": [
|
||||
{
|
||||
"id": "1",
|
||||
"title": "fix: subject-only direct-access report naming (tight hyphen) + case-folder upload",
|
||||
"description": "Report file uses subject-only canonical naming and is uploaded to the case folder correctly.",
|
||||
"details": "DirectAccessReportGenerator: em-dash -> tight hyphen; sanitize via LocalFilesystemClient::sanitizeFileName; save Document with skipNetworkUpload, relate to Case, explicit uploadDocument + DB realign to canonical stored name.",
|
||||
"testStrategy": "",
|
||||
"status": "in-progress",
|
||||
"dependencies": [],
|
||||
"priority": "high",
|
||||
"subtasks": [],
|
||||
"updatedAt": "2026-06-03T07:30:42.898Z"
|
||||
}
|
||||
],
|
||||
"metadata": {
|
||||
"version": "1.0.0",
|
||||
"lastModified": "2026-06-03T07:30:42.899Z",
|
||||
"taskCount": 1,
|
||||
"completedCount": 0,
|
||||
"tags": [
|
||||
"master"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
<context>
|
||||
# Overview
|
||||
[Provide a high-level overview of your product here. Explain what problem it solves, who it's for, and why it's valuable.]
|
||||
|
||||
# Core Features
|
||||
[List and describe the main features of your product. For each feature, include:
|
||||
- What it does
|
||||
- Why it's important
|
||||
- How it works at a high level]
|
||||
|
||||
# User Experience
|
||||
[Describe the user journey and experience. Include:
|
||||
- User personas
|
||||
- Key user flows
|
||||
- UI/UX considerations]
|
||||
</context>
|
||||
<PRD>
|
||||
# Technical Architecture
|
||||
[Outline the technical implementation details:
|
||||
- System components
|
||||
- Data models
|
||||
- APIs and integrations
|
||||
- Infrastructure requirements]
|
||||
|
||||
# Development Roadmap
|
||||
[Break down the development process into phases:
|
||||
- MVP requirements
|
||||
- Future enhancements
|
||||
- Do not think about timelines whatsoever -- all that matters is scope and detailing exactly what needs to be build in each phase so it can later be cut up into tasks]
|
||||
|
||||
# Logical Dependency Chain
|
||||
[Define the logical order of development:
|
||||
- Which features need to be built first (foundation)
|
||||
- Getting as quickly as possible to something usable/visible front end that works
|
||||
- Properly pacing and scoping each feature so it is atomic but can also be built upon and improved as development approaches]
|
||||
|
||||
# Risks and Mitigations
|
||||
[Identify potential risks and how they'll be addressed:
|
||||
- Technical challenges
|
||||
- Figuring out the MVP that we can build upon
|
||||
- Resource constraints]
|
||||
|
||||
# Appendix
|
||||
[Include any additional information:
|
||||
- Research findings
|
||||
- Technical specifications]
|
||||
</PRD>
|
||||
@@ -0,0 +1,511 @@
|
||||
<rpg-method>
|
||||
# Repository Planning Graph (RPG) Method - PRD Template
|
||||
|
||||
This template teaches you (AI or human) how to create structured, dependency-aware PRDs using the RPG methodology from Microsoft Research. The key insight: separate WHAT (functional) from HOW (structural), then connect them with explicit dependencies.
|
||||
|
||||
## Core Principles
|
||||
|
||||
1. **Dual-Semantics**: Think functional (capabilities) AND structural (code organization) separately, then map them
|
||||
2. **Explicit Dependencies**: Never assume - always state what depends on what
|
||||
3. **Topological Order**: Build foundation first, then layers on top
|
||||
4. **Progressive Refinement**: Start broad, refine iteratively
|
||||
|
||||
## How to Use This Template
|
||||
|
||||
- Follow the instructions in each `<instruction>` block
|
||||
- Look at `<example>` blocks to see good vs bad patterns
|
||||
- Fill in the content sections with your project details
|
||||
- The AI reading this will learn the RPG method by following along
|
||||
- Task Master will parse the resulting PRD into dependency-aware tasks
|
||||
|
||||
## Recommended Tools for Creating PRDs
|
||||
|
||||
When using this template to **create** a PRD (not parse it), use **code-context-aware AI assistants** for best results:
|
||||
|
||||
**Why?** The AI needs to understand your existing codebase to make good architectural decisions about modules, dependencies, and integration points.
|
||||
|
||||
**Recommended tools:**
|
||||
- **Claude Code** (claude-code CLI) - Best for structured reasoning and large contexts
|
||||
- **Cursor/Windsurf** - IDE integration with full codebase context
|
||||
- **Gemini CLI** (gemini-cli) - Massive context window for large codebases
|
||||
- **Codex/Grok CLI** - Strong code generation with context awareness
|
||||
|
||||
**Note:** Once your PRD is created, `task-master parse-prd` works with any configured AI model - it just needs to read the PRD text itself, not your codebase.
|
||||
</rpg-method>
|
||||
|
||||
---
|
||||
|
||||
<overview>
|
||||
<instruction>
|
||||
Start with the problem, not the solution. Be specific about:
|
||||
- What pain point exists?
|
||||
- Who experiences it?
|
||||
- Why existing solutions don't work?
|
||||
- What success looks like (measurable outcomes)?
|
||||
|
||||
Keep this section focused - don't jump into implementation details yet.
|
||||
</instruction>
|
||||
|
||||
## Problem Statement
|
||||
[Describe the core problem. Be concrete about user pain points.]
|
||||
|
||||
## Target Users
|
||||
[Define personas, their workflows, and what they're trying to achieve.]
|
||||
|
||||
## Success Metrics
|
||||
[Quantifiable outcomes. Examples: "80% task completion via autopilot", "< 5% manual intervention rate"]
|
||||
|
||||
</overview>
|
||||
|
||||
---
|
||||
|
||||
<functional-decomposition>
|
||||
<instruction>
|
||||
Now think about CAPABILITIES (what the system DOES), not code structure yet.
|
||||
|
||||
Step 1: Identify high-level capability domains
|
||||
- Think: "What major things does this system do?"
|
||||
- Examples: Data Management, Core Processing, Presentation Layer
|
||||
|
||||
Step 2: For each capability, enumerate specific features
|
||||
- Use explore-exploit strategy:
|
||||
* Exploit: What features are REQUIRED for core value?
|
||||
* Explore: What features make this domain COMPLETE?
|
||||
|
||||
Step 3: For each feature, define:
|
||||
- Description: What it does in one sentence
|
||||
- Inputs: What data/context it needs
|
||||
- Outputs: What it produces/returns
|
||||
- Behavior: Key logic or transformations
|
||||
|
||||
<example type="good">
|
||||
Capability: Data Validation
|
||||
Feature: Schema validation
|
||||
- Description: Validate JSON payloads against defined schemas
|
||||
- Inputs: JSON object, schema definition
|
||||
- Outputs: Validation result (pass/fail) + error details
|
||||
- Behavior: Iterate fields, check types, enforce constraints
|
||||
|
||||
Feature: Business rule validation
|
||||
- Description: Apply domain-specific validation rules
|
||||
- Inputs: Validated data object, rule set
|
||||
- Outputs: Boolean + list of violated rules
|
||||
- Behavior: Execute rules sequentially, short-circuit on failure
|
||||
</example>
|
||||
|
||||
<example type="bad">
|
||||
Capability: validation.js
|
||||
(Problem: This is a FILE, not a CAPABILITY. Mixing structure into functional thinking.)
|
||||
|
||||
Capability: Validation
|
||||
Feature: Make sure data is good
|
||||
(Problem: Too vague. No inputs/outputs. Not actionable.)
|
||||
</example>
|
||||
</instruction>
|
||||
|
||||
## Capability Tree
|
||||
|
||||
### Capability: [Name]
|
||||
[Brief description of what this capability domain covers]
|
||||
|
||||
#### Feature: [Name]
|
||||
- **Description**: [One sentence]
|
||||
- **Inputs**: [What it needs]
|
||||
- **Outputs**: [What it produces]
|
||||
- **Behavior**: [Key logic]
|
||||
|
||||
#### Feature: [Name]
|
||||
- **Description**:
|
||||
- **Inputs**:
|
||||
- **Outputs**:
|
||||
- **Behavior**:
|
||||
|
||||
### Capability: [Name]
|
||||
...
|
||||
|
||||
</functional-decomposition>
|
||||
|
||||
---
|
||||
|
||||
<structural-decomposition>
|
||||
<instruction>
|
||||
NOW think about code organization. Map capabilities to actual file/folder structure.
|
||||
|
||||
Rules:
|
||||
1. Each capability maps to a module (folder or file)
|
||||
2. Features within a capability map to functions/classes
|
||||
3. Use clear module boundaries - each module has ONE responsibility
|
||||
4. Define what each module exports (public interface)
|
||||
|
||||
The goal: Create a clear mapping between "what it does" (functional) and "where it lives" (structural).
|
||||
|
||||
<example type="good">
|
||||
Capability: Data Validation
|
||||
→ Maps to: src/validation/
|
||||
├── schema-validator.js (Schema validation feature)
|
||||
├── rule-validator.js (Business rule validation feature)
|
||||
└── index.js (Public exports)
|
||||
|
||||
Exports:
|
||||
- validateSchema(data, schema)
|
||||
- validateRules(data, rules)
|
||||
</example>
|
||||
|
||||
<example type="bad">
|
||||
Capability: Data Validation
|
||||
→ Maps to: src/utils.js
|
||||
(Problem: "utils" is not a clear module boundary. Where do I find validation logic?)
|
||||
|
||||
Capability: Data Validation
|
||||
→ Maps to: src/validation/everything.js
|
||||
(Problem: One giant file. Features should map to separate files for maintainability.)
|
||||
</example>
|
||||
</instruction>
|
||||
|
||||
## Repository Structure
|
||||
|
||||
```
|
||||
project-root/
|
||||
├── src/
|
||||
│ ├── [module-name]/ # Maps to: [Capability Name]
|
||||
│ │ ├── [file].js # Maps to: [Feature Name]
|
||||
│ │ └── index.js # Public exports
|
||||
│ └── [module-name]/
|
||||
├── tests/
|
||||
└── docs/
|
||||
```
|
||||
|
||||
## Module Definitions
|
||||
|
||||
### Module: [Name]
|
||||
- **Maps to capability**: [Capability from functional decomposition]
|
||||
- **Responsibility**: [Single clear purpose]
|
||||
- **File structure**:
|
||||
```
|
||||
module-name/
|
||||
├── feature1.js
|
||||
├── feature2.js
|
||||
└── index.js
|
||||
```
|
||||
- **Exports**:
|
||||
- `functionName()` - [what it does]
|
||||
- `ClassName` - [what it does]
|
||||
|
||||
</structural-decomposition>
|
||||
|
||||
---
|
||||
|
||||
<dependency-graph>
|
||||
<instruction>
|
||||
This is THE CRITICAL SECTION for Task Master parsing.
|
||||
|
||||
Define explicit dependencies between modules. This creates the topological order for task execution.
|
||||
|
||||
Rules:
|
||||
1. List modules in dependency order (foundation first)
|
||||
2. For each module, state what it depends on
|
||||
3. Foundation modules should have NO dependencies
|
||||
4. Every non-foundation module should depend on at least one other module
|
||||
5. Think: "What must EXIST before I can build this module?"
|
||||
|
||||
<example type="good">
|
||||
Foundation Layer (no dependencies):
|
||||
- error-handling: No dependencies
|
||||
- config-manager: No dependencies
|
||||
- base-types: No dependencies
|
||||
|
||||
Data Layer:
|
||||
- schema-validator: Depends on [base-types, error-handling]
|
||||
- data-ingestion: Depends on [schema-validator, config-manager]
|
||||
|
||||
Core Layer:
|
||||
- algorithm-engine: Depends on [base-types, error-handling]
|
||||
- pipeline-orchestrator: Depends on [algorithm-engine, data-ingestion]
|
||||
</example>
|
||||
|
||||
<example type="bad">
|
||||
- validation: Depends on API
|
||||
- API: Depends on validation
|
||||
(Problem: Circular dependency. This will cause build/runtime issues.)
|
||||
|
||||
- user-auth: Depends on everything
|
||||
(Problem: Too many dependencies. Should be more focused.)
|
||||
</example>
|
||||
</instruction>
|
||||
|
||||
## Dependency Chain
|
||||
|
||||
### Foundation Layer (Phase 0)
|
||||
No dependencies - these are built first.
|
||||
|
||||
- **[Module Name]**: [What it provides]
|
||||
- **[Module Name]**: [What it provides]
|
||||
|
||||
### [Layer Name] (Phase 1)
|
||||
- **[Module Name]**: Depends on [[module-from-phase-0], [module-from-phase-0]]
|
||||
- **[Module Name]**: Depends on [[module-from-phase-0]]
|
||||
|
||||
### [Layer Name] (Phase 2)
|
||||
- **[Module Name]**: Depends on [[module-from-phase-1], [module-from-foundation]]
|
||||
|
||||
[Continue building up layers...]
|
||||
|
||||
</dependency-graph>
|
||||
|
||||
---
|
||||
|
||||
<implementation-roadmap>
|
||||
<instruction>
|
||||
Turn the dependency graph into concrete development phases.
|
||||
|
||||
Each phase should:
|
||||
1. Have clear entry criteria (what must exist before starting)
|
||||
2. Contain tasks that can be parallelized (no inter-dependencies within phase)
|
||||
3. Have clear exit criteria (how do we know phase is complete?)
|
||||
4. Build toward something USABLE (not just infrastructure)
|
||||
|
||||
Phase ordering follows topological sort of dependency graph.
|
||||
|
||||
<example type="good">
|
||||
Phase 0: Foundation
|
||||
Entry: Clean repository
|
||||
Tasks:
|
||||
- Implement error handling utilities
|
||||
- Create base type definitions
|
||||
- Setup configuration system
|
||||
Exit: Other modules can import foundation without errors
|
||||
|
||||
Phase 1: Data Layer
|
||||
Entry: Phase 0 complete
|
||||
Tasks:
|
||||
- Implement schema validator (uses: base types, error handling)
|
||||
- Build data ingestion pipeline (uses: validator, config)
|
||||
Exit: End-to-end data flow from input to validated output
|
||||
</example>
|
||||
|
||||
<example type="bad">
|
||||
Phase 1: Build Everything
|
||||
Tasks:
|
||||
- API
|
||||
- Database
|
||||
- UI
|
||||
- Tests
|
||||
(Problem: No clear focus. Too broad. Dependencies not considered.)
|
||||
</example>
|
||||
</instruction>
|
||||
|
||||
## Development Phases
|
||||
|
||||
### Phase 0: [Foundation Name]
|
||||
**Goal**: [What foundational capability this establishes]
|
||||
|
||||
**Entry Criteria**: [What must be true before starting]
|
||||
|
||||
**Tasks**:
|
||||
- [ ] [Task name] (depends on: [none or list])
|
||||
- Acceptance criteria: [How we know it's done]
|
||||
- Test strategy: [What tests prove it works]
|
||||
|
||||
- [ ] [Task name] (depends on: [none or list])
|
||||
|
||||
**Exit Criteria**: [Observable outcome that proves phase complete]
|
||||
|
||||
**Delivers**: [What can users/developers do after this phase?]
|
||||
|
||||
---
|
||||
|
||||
### Phase 1: [Layer Name]
|
||||
**Goal**:
|
||||
|
||||
**Entry Criteria**: Phase 0 complete
|
||||
|
||||
**Tasks**:
|
||||
- [ ] [Task name] (depends on: [[tasks-from-phase-0]])
|
||||
- [ ] [Task name] (depends on: [[tasks-from-phase-0]])
|
||||
|
||||
**Exit Criteria**:
|
||||
|
||||
**Delivers**:
|
||||
|
||||
---
|
||||
|
||||
[Continue with more phases...]
|
||||
|
||||
</implementation-roadmap>
|
||||
|
||||
---
|
||||
|
||||
<test-strategy>
|
||||
<instruction>
|
||||
Define how testing will be integrated throughout development (TDD approach).
|
||||
|
||||
Specify:
|
||||
1. Test pyramid ratios (unit vs integration vs e2e)
|
||||
2. Coverage requirements
|
||||
3. Critical test scenarios
|
||||
4. Test generation guidelines for Surgical Test Generator
|
||||
|
||||
This section guides the AI when generating tests during the RED phase of TDD.
|
||||
|
||||
<example type="good">
|
||||
Critical Test Scenarios for Data Validation module:
|
||||
- Happy path: Valid data passes all checks
|
||||
- Edge cases: Empty strings, null values, boundary numbers
|
||||
- Error cases: Invalid types, missing required fields
|
||||
- Integration: Validator works with ingestion pipeline
|
||||
</example>
|
||||
</instruction>
|
||||
|
||||
## Test Pyramid
|
||||
|
||||
```
|
||||
/\
|
||||
/E2E\ ← [X]% (End-to-end, slow, comprehensive)
|
||||
/------\
|
||||
/Integration\ ← [Y]% (Module interactions)
|
||||
/------------\
|
||||
/ Unit Tests \ ← [Z]% (Fast, isolated, deterministic)
|
||||
/----------------\
|
||||
```
|
||||
|
||||
## Coverage Requirements
|
||||
- Line coverage: [X]% minimum
|
||||
- Branch coverage: [X]% minimum
|
||||
- Function coverage: [X]% minimum
|
||||
- Statement coverage: [X]% minimum
|
||||
|
||||
## Critical Test Scenarios
|
||||
|
||||
### [Module/Feature Name]
|
||||
**Happy path**:
|
||||
- [Scenario description]
|
||||
- Expected: [What should happen]
|
||||
|
||||
**Edge cases**:
|
||||
- [Scenario description]
|
||||
- Expected: [What should happen]
|
||||
|
||||
**Error cases**:
|
||||
- [Scenario description]
|
||||
- Expected: [How system handles failure]
|
||||
|
||||
**Integration points**:
|
||||
- [What interactions to test]
|
||||
- Expected: [End-to-end behavior]
|
||||
|
||||
## Test Generation Guidelines
|
||||
[Specific instructions for Surgical Test Generator about what to focus on, what patterns to follow, project-specific test conventions]
|
||||
|
||||
</test-strategy>
|
||||
|
||||
---
|
||||
|
||||
<architecture>
|
||||
<instruction>
|
||||
Describe technical architecture, data models, and key design decisions.
|
||||
|
||||
Keep this section AFTER functional/structural decomposition - implementation details come after understanding structure.
|
||||
</instruction>
|
||||
|
||||
## System Components
|
||||
[Major architectural pieces and their responsibilities]
|
||||
|
||||
## Data Models
|
||||
[Core data structures, schemas, database design]
|
||||
|
||||
## Technology Stack
|
||||
[Languages, frameworks, key libraries]
|
||||
|
||||
**Decision: [Technology/Pattern]**
|
||||
- **Rationale**: [Why chosen]
|
||||
- **Trade-offs**: [What we're giving up]
|
||||
- **Alternatives considered**: [What else we looked at]
|
||||
|
||||
</architecture>
|
||||
|
||||
---
|
||||
|
||||
<risks>
|
||||
<instruction>
|
||||
Identify risks that could derail development and how to mitigate them.
|
||||
|
||||
Categories:
|
||||
- Technical risks (complexity, unknowns)
|
||||
- Dependency risks (blocking issues)
|
||||
- Scope risks (creep, underestimation)
|
||||
</instruction>
|
||||
|
||||
## Technical Risks
|
||||
**Risk**: [Description]
|
||||
- **Impact**: [High/Medium/Low - effect on project]
|
||||
- **Likelihood**: [High/Medium/Low]
|
||||
- **Mitigation**: [How to address]
|
||||
- **Fallback**: [Plan B if mitigation fails]
|
||||
|
||||
## Dependency Risks
|
||||
[External dependencies, blocking issues]
|
||||
|
||||
## Scope Risks
|
||||
[Scope creep, underestimation, unclear requirements]
|
||||
|
||||
</risks>
|
||||
|
||||
---
|
||||
|
||||
<appendix>
|
||||
## References
|
||||
[Papers, documentation, similar systems]
|
||||
|
||||
## Glossary
|
||||
[Domain-specific terms]
|
||||
|
||||
## Open Questions
|
||||
[Things to resolve during development]
|
||||
</appendix>
|
||||
|
||||
---
|
||||
|
||||
<task-master-integration>
|
||||
# How Task Master Uses This PRD
|
||||
|
||||
When you run `task-master parse-prd <file>.txt`, the parser:
|
||||
|
||||
1. **Extracts capabilities** → Main tasks
|
||||
- Each `### Capability:` becomes a top-level task
|
||||
|
||||
2. **Extracts features** → Subtasks
|
||||
- Each `#### Feature:` becomes a subtask under its capability
|
||||
|
||||
3. **Parses dependencies** → Task dependencies
|
||||
- `Depends on: [X, Y]` sets task.dependencies = ["X", "Y"]
|
||||
|
||||
4. **Orders by phases** → Task priorities
|
||||
- Phase 0 tasks = highest priority
|
||||
- Phase N tasks = lower priority, properly sequenced
|
||||
|
||||
5. **Uses test strategy** → Test generation context
|
||||
- Feeds test scenarios to Surgical Test Generator during implementation
|
||||
|
||||
**Result**: A dependency-aware task graph that can be executed in topological order.
|
||||
|
||||
## Why RPG Structure Matters
|
||||
|
||||
Traditional flat PRDs lead to:
|
||||
- ❌ Unclear task dependencies
|
||||
- ❌ Arbitrary task ordering
|
||||
- ❌ Circular dependencies discovered late
|
||||
- ❌ Poorly scoped tasks
|
||||
|
||||
RPG-structured PRDs provide:
|
||||
- ✅ Explicit dependency chains
|
||||
- ✅ Topological execution order
|
||||
- ✅ Clear module boundaries
|
||||
- ✅ Validated task graph before implementation
|
||||
|
||||
## Tips for Best Results
|
||||
|
||||
1. **Spend time on dependency graph** - This is the most valuable section for Task Master
|
||||
2. **Keep features atomic** - Each feature should be independently testable
|
||||
3. **Progressive refinement** - Start broad, use `task-master expand` to break down complex tasks
|
||||
4. **Use research mode** - `task-master parse-prd --research` leverages AI for better task generation
|
||||
</task-master-integration>
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,19 @@
|
||||
#!/bin/bash
|
||||
set -euo pipefail
|
||||
|
||||
VERSION=$(python3 -c "import json; print(json.load(open('manifest.json'))['version'])")
|
||||
MODULE=$(python3 -c "import json; m=json.load(open('manifest.json')); print(m.get('module', m['name']))")
|
||||
ZIPNAME="${MODULE}-${VERSION}.zip"
|
||||
|
||||
if [[ -f README.md ]]; then
|
||||
sed -i "s/\*\*גרסה:\*\* [^ |]*/\*\*גרסה:\*\* ${VERSION}/" README.md
|
||||
fi
|
||||
|
||||
echo "Building $ZIPNAME..."
|
||||
rm -f "$ZIPNAME"
|
||||
zip -r "$ZIPNAME" manifest.json files/ scripts/ \
|
||||
-x "*.DS_Store" "*__MACOSX*" "*.zip" 2>/dev/null || \
|
||||
zip -r "$ZIPNAME" manifest.json files/ \
|
||||
-x "*.DS_Store" "*__MACOSX*" "*.zip"
|
||||
|
||||
echo "✓ Built: $ZIPNAME ($(du -h "$ZIPNAME" | cut -f1))"
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,76 +0,0 @@
|
||||
<?php
|
||||
|
||||
namespace Espo\Modules\LegalAssistance\Hooks\Case;
|
||||
|
||||
use Espo\ORM\Entity;
|
||||
use Espo\ORM\EntityManager;
|
||||
use Espo\Core\Utils\Log;
|
||||
|
||||
class CreateDirectAccessTasks
|
||||
{
|
||||
public function __construct(
|
||||
private EntityManager $entityManager,
|
||||
private Log $log
|
||||
) {}
|
||||
|
||||
public function afterSave(Entity $entity, array $options): void
|
||||
{
|
||||
if (!empty($options['skipHooks'])) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (!$entity->isAttributeChanged('cLegalAidType')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$newValue = $entity->get('cLegalAidType');
|
||||
$oldValue = $entity->getFetched('cLegalAidType');
|
||||
|
||||
if ($newValue !== 'DirectAccess' || $oldValue === 'DirectAccess') {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->log->info("LegalAssistance: Creating direct access tasks for case {$entity->getId()}");
|
||||
|
||||
$assignedUserId = $entity->get('assignedUserId');
|
||||
$now = new \DateTime('now', new \DateTimeZone('Asia/Jerusalem'));
|
||||
|
||||
$tasks = [
|
||||
[
|
||||
'name' => 'שיחת טלפון ראשונה עם הלקוח',
|
||||
'dateEnd' => (clone $now)->modify('+2 days')->format('Y-m-d'),
|
||||
'priority' => 'High',
|
||||
'description' => 'יש ליצור קשר ראשוני עם הלקוח תוך 48 שעות ממועד קבלת המינוי.',
|
||||
],
|
||||
[
|
||||
'name' => 'פגישה עם הלקוח',
|
||||
'dateEnd' => (clone $now)->modify('+7 days')->format('Y-m-d'),
|
||||
'priority' => 'Normal',
|
||||
'description' => 'לקבוע ולקיים פגישה ראשונה עם הלקוח. לתעד נוכחים ותוכן הפגישה.',
|
||||
],
|
||||
[
|
||||
'name' => 'שליחת דוח גישה ישירה',
|
||||
'dateEnd' => (clone $now)->modify('+14 days')->format('Y-m-d'),
|
||||
'priority' => 'High',
|
||||
'description' => 'למלא ולשלוח דוח דיווח ראשוני לסיוע המשפטי. ניתן לבקש משירה: "תיצרי דוח גישה ישירה".',
|
||||
],
|
||||
];
|
||||
|
||||
foreach ($tasks as $taskData) {
|
||||
$task = $this->entityManager->getNewEntity('Task');
|
||||
$task->set([
|
||||
'name' => $taskData['name'],
|
||||
'status' => 'Not Started',
|
||||
'priority' => $taskData['priority'],
|
||||
'dateEnd' => $taskData['dateEnd'],
|
||||
'description' => $taskData['description'],
|
||||
'parentType' => 'Case',
|
||||
'parentId' => $entity->getId(),
|
||||
'assignedUserId' => $assignedUserId,
|
||||
]);
|
||||
$this->entityManager->saveEntity($task, ['skipHooks' => false]);
|
||||
}
|
||||
|
||||
$this->log->info("LegalAssistance: Created 3 direct access tasks for case {$entity->getId()}");
|
||||
}
|
||||
}
|
||||
@@ -1,34 +1,8 @@
|
||||
{
|
||||
"fields": {
|
||||
"cLegalAidType": "Legal Aid Type",
|
||||
"cAppointmentDate": "Appointment Date",
|
||||
"cAidType": "Aid Type",
|
||||
"cUrgencyLevel": "Urgency Level",
|
||||
"cFilingDeadline": "Filing Deadline"
|
||||
"labels": {
|
||||
"LegalAssistance": "Legal Assistance"
|
||||
},
|
||||
"options": {
|
||||
"cLegalAidType": {
|
||||
"": "",
|
||||
"DirectAccess": "Direct Access",
|
||||
"Regular": "Regular",
|
||||
"Duty": "Duty"
|
||||
},
|
||||
"cAidType": {
|
||||
"": "",
|
||||
"הגשת ערעור": "Filing Appeal",
|
||||
"יעוץ והדרכה": "Counseling & Guidance",
|
||||
"סיוע נוסף ביטוח לאומי": "Additional NI Aid",
|
||||
"סיוע נוסף תחום אחר": "Additional Aid Other",
|
||||
"אי מתן סיוע": "No Aid Provided"
|
||||
},
|
||||
"cUrgencyLevel": {
|
||||
"": "",
|
||||
"רגיל": "Normal",
|
||||
"דחוף": "Urgent",
|
||||
"בהול": "Critical"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"directAccessReports": "Direct Access Reports"
|
||||
"tabs": {
|
||||
"LegalAssistance": "Legal Assistance"
|
||||
}
|
||||
}
|
||||
|
||||
-150
@@ -1,150 +0,0 @@
|
||||
{
|
||||
"scopeName": "Direct Access Report",
|
||||
"scopeNamesPlural": "Direct Access Reports",
|
||||
"labels": {
|
||||
"Create DirectAccessReport": "Create Direct Access Report"
|
||||
},
|
||||
"fields": {
|
||||
"name": "Report Name",
|
||||
"number": "Number",
|
||||
"status": "Status",
|
||||
"case": "Case",
|
||||
"aidType": "Aid Type",
|
||||
"urgencyLevel": "Urgency Level",
|
||||
"appointmentDate": "Appointment Date",
|
||||
"filingDeadline": "Filing Deadline",
|
||||
"additionalUrgency": "Additional Urgency",
|
||||
"additionalDeadline": "Additional Deadline",
|
||||
"firstContactDate": "First Contact Date",
|
||||
"contactDelayReason": "Contact Delay Reason",
|
||||
"meetingDate": "Meeting Date",
|
||||
"meetingDelayReason": "Meeting Delay Reason",
|
||||
"meetingAttendees": "Meeting Attendees",
|
||||
"contactStatus": "Contact Status",
|
||||
"contactStatusDetail": "Contact Status Detail",
|
||||
"proceedingNumber": "Proceeding Number",
|
||||
"courtName": "Court Name",
|
||||
"proceedingSubject": "Proceeding Subject",
|
||||
"claimSummary": "Claim Summary",
|
||||
"defenseClaims": "Defense Claims",
|
||||
"q1DocsReviewed": "Committee Reviewed All Documents?",
|
||||
"q1DocsDetail": "Documents Detail",
|
||||
"q2Reasoned": "Decision Reasoned?",
|
||||
"q2ReasonDetail": "Missing Reasoning Detail",
|
||||
"q3PanelMatch": "Panel Matches Impairments?",
|
||||
"q4PanelComposition": "Panel Composition",
|
||||
"q5ComplaintsAddressed": "All Complaints Addressed?",
|
||||
"q6ComplaintsDetail": "Missing Complaints Detail",
|
||||
"q7ClinicalExam": "Clinical Exam Performed?",
|
||||
"q8ClinicalGap": "Clinical vs Documents Gap",
|
||||
"q9MoharaApplied": "Mohara Doctrine Applied?",
|
||||
"q9MoharaDetail": "Missing Mohara Data",
|
||||
"q10RehabGap": "Rehab Officer vs Committee Gap?",
|
||||
"q10RehabDetail": "Gap Detail",
|
||||
"q11ScoreGap": "Score vs Condition Gap?",
|
||||
"q11ScoreDetail": "Score Gap Detail",
|
||||
"q12UniqueAspects": "Unique Aspects Addressed?",
|
||||
"q12UniqueDetail": "Unique Aspects Detail",
|
||||
"recommendationType": "Recommendation Type",
|
||||
"recommendationDetail": "Recommendation Detail",
|
||||
"additionalAidNeeded": "Additional Aid Needed",
|
||||
"additionalAidNIDetail": "Additional NI Aid Detail",
|
||||
"additionalAidOtherDetail": "Additional Other Aid Detail",
|
||||
"additionalAidUrgency": "Additional Aid Urgency",
|
||||
"additionalAidDeadlines": "Additional Aid Deadlines",
|
||||
"willingToRepresent": "Willing to Represent?",
|
||||
"notes": "General Notes",
|
||||
"assignedUser": "Assigned User",
|
||||
"teams": "Teams",
|
||||
"createdAt": "Created At",
|
||||
"modifiedAt": "Modified At",
|
||||
"createdBy": "Created By",
|
||||
"modifiedBy": "Modified By"
|
||||
},
|
||||
"options": {
|
||||
"status": {
|
||||
"Draft": "Draft",
|
||||
"Submitted": "Submitted",
|
||||
"Approved": "Approved",
|
||||
"Rejected": "Rejected"
|
||||
},
|
||||
"aidType": {
|
||||
"": "",
|
||||
"הגשת ערעור": "Filing Appeal",
|
||||
"יעוץ והדרכה": "Counseling & Guidance",
|
||||
"סיוע נוסף ביטוח לאומי": "Additional NI Aid",
|
||||
"סיוע נוסף תחום אחר": "Additional Aid Other",
|
||||
"אי מתן סיוע": "No Aid Provided"
|
||||
},
|
||||
"urgencyLevel": {
|
||||
"": "",
|
||||
"רגיל": "Normal",
|
||||
"דחוף": "Urgent",
|
||||
"בהול": "Critical"
|
||||
},
|
||||
"additionalUrgency": {
|
||||
"": "",
|
||||
"רגיל": "Normal",
|
||||
"דחוף": "Urgent",
|
||||
"בהול": "Critical"
|
||||
},
|
||||
"contactStatus": {
|
||||
"": "",
|
||||
"תקין": "Normal",
|
||||
"לא תקין": "Not Normal"
|
||||
},
|
||||
"courtName": {
|
||||
"": "",
|
||||
"בית הדין האזורי לעבודה ירושלים": "Regional Labor Court Jerusalem",
|
||||
"בית הדין האזורי לעבודה תל אביב": "Regional Labor Court Tel Aviv",
|
||||
"בית הדין האזורי לעבודה חיפה": "Regional Labor Court Haifa",
|
||||
"בית הדין האזורי לעבודה באר שבע": "Regional Labor Court Be'er Sheva",
|
||||
"בית הדין האזורי לעבודה נצרת": "Regional Labor Court Nazareth",
|
||||
"בית הדין הארצי לעבודה": "National Labor Court"
|
||||
},
|
||||
"proceedingSubject": {
|
||||
"": "",
|
||||
"נכות כללית": "General Disability",
|
||||
"נכות מעבודה": "Work Disability",
|
||||
"נכות איבה": "Hostility Disability",
|
||||
"ניידות": "Mobility",
|
||||
"אי כושר": "Incapacity",
|
||||
"שירותים מיוחדים": "Special Services",
|
||||
"סיעוד": "Nursing Care",
|
||||
"גמלת הבטחת הכנסה": "Income Support",
|
||||
"דמי אבטלה": "Unemployment Benefits",
|
||||
"אחר": "Other"
|
||||
},
|
||||
"recommendationType": {
|
||||
"": "",
|
||||
"ייעוץ והדרכה חלף ייצוג": "Counseling Instead of Representation",
|
||||
"ויתור הלקוח": "Client Waiver",
|
||||
"החלפת ייצוג": "Change Representation",
|
||||
"לא נוצר קשר": "No Contact Made",
|
||||
"לא התקיימה פגישה": "No Meeting Held",
|
||||
"עדיין לא ניתן להחליט": "Cannot Decide Yet",
|
||||
"נדרשים מסמכים נוספים": "Additional Documents Required",
|
||||
"המלצה לסירוב": "Recommendation to Refuse"
|
||||
},
|
||||
"additionalAidNeeded": {
|
||||
"": "",
|
||||
"לא נחוץ": "Not Needed",
|
||||
"נחוץ בתחום ביטוח לאומי": "Needed - NI Field",
|
||||
"נחוץ בתחום אחר": "Needed - Other Field"
|
||||
},
|
||||
"additionalAidUrgency": {
|
||||
"": "",
|
||||
"רגיל": "Normal",
|
||||
"דחוף": "Urgent",
|
||||
"בהול": "Critical"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"case": "Case"
|
||||
},
|
||||
"presetFilters": {
|
||||
"draft": "Draft",
|
||||
"submitted": "Submitted",
|
||||
"approved": "Approved"
|
||||
}
|
||||
}
|
||||
@@ -1,8 +1,2 @@
|
||||
{
|
||||
"scopeNames": {
|
||||
"DirectAccessReport": "Direct Access Report"
|
||||
},
|
||||
"scopeNamesPlural": {
|
||||
"DirectAccessReport": "Direct Access Reports"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"labels": {
|
||||
"LegalAssistance": "סיוע משפטי"
|
||||
},
|
||||
"tabs": {
|
||||
"LegalAssistance": "סיוע משפטי"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,2 @@
|
||||
{
|
||||
}
|
||||
@@ -1,20 +1,8 @@
|
||||
{
|
||||
"fields": {
|
||||
"cLegalAidType": "סוג מינוי סיוע משפטי",
|
||||
"cAppointmentDate": "מועד קבלת המינוי",
|
||||
"cAidType": "מהות הסיוע",
|
||||
"cUrgencyLevel": "דחיפות",
|
||||
"cFilingDeadline": "מועד אחרון להגשה"
|
||||
"labels": {
|
||||
"LegalAssistance": "סיוע משפטי"
|
||||
},
|
||||
"options": {
|
||||
"cLegalAidType": {
|
||||
"": "",
|
||||
"DirectAccess": "גישה ישירה",
|
||||
"Regular": "מינוי רגיל",
|
||||
"Duty": "תורנות"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"directAccessReports": "דוחות גישה ישירה"
|
||||
"tabs": {
|
||||
"LegalAssistance": "סיוע משפטי"
|
||||
}
|
||||
}
|
||||
|
||||
-150
@@ -1,150 +0,0 @@
|
||||
{
|
||||
"scopeName": "דוח גישה ישירה",
|
||||
"scopeNamesPlural": "דוחות גישה ישירה",
|
||||
"labels": {
|
||||
"Create DirectAccessReport": "צור דוח גישה ישירה"
|
||||
},
|
||||
"fields": {
|
||||
"name": "שם הדוח",
|
||||
"number": "מספר",
|
||||
"status": "סטטוס",
|
||||
"case": "תיק",
|
||||
"aidType": "מהות הסיוע",
|
||||
"urgencyLevel": "דחיפות הליך",
|
||||
"appointmentDate": "מועד קבלת המינוי",
|
||||
"filingDeadline": "מועד אחרון להגשה",
|
||||
"additionalUrgency": "דחיפות הליך נוסף",
|
||||
"additionalDeadline": "מועדים להליך נוסף",
|
||||
"firstContactDate": "תאריך יצירת קשר ראשוני",
|
||||
"contactDelayReason": "סיבת עיכוב (אם לא תוך 48 שעות)",
|
||||
"meetingDate": "תאריך פגישה עם הלקוח",
|
||||
"meetingDelayReason": "סיבת עיכוב פגישה",
|
||||
"meetingAttendees": "נוכחים בפגישה",
|
||||
"contactStatus": "מצב קשר עם הלקוח",
|
||||
"contactStatusDetail": "פירוט מצב קשר",
|
||||
"proceedingNumber": "מספר הליך",
|
||||
"courtName": "בית הדין",
|
||||
"proceedingSubject": "עניין ההליך",
|
||||
"claimSummary": "תמצית התביעה/הערעור",
|
||||
"defenseClaims": "טענות ההגנה",
|
||||
"q1DocsReviewed": "הוועדה התייחסה לכל המסמכים?",
|
||||
"q1DocsDetail": "פירוט מסמכים",
|
||||
"q2Reasoned": "ההחלטה מנומקת?",
|
||||
"q2ReasonDetail": "פירוט הנמקה חסרה",
|
||||
"q3PanelMatch": "הרכב תואם ליקויים?",
|
||||
"q4PanelComposition": "הרכב הוועדה / הרכב חסר",
|
||||
"q5ComplaintsAddressed": "התייחסו לכל התלונות?",
|
||||
"q6ComplaintsDetail": "פירוט תלונות חסרות",
|
||||
"q7ClinicalExam": "בדיקה קלינית נערכה?",
|
||||
"q8ClinicalGap": "פער בדיקה קלינית vs מסמכים",
|
||||
"q9MoharaApplied": "בחינת הלכת מוהרה (גיל, רקע, השכלה)?",
|
||||
"q9MoharaDetail": "נתונים חסרים (מוהרה)",
|
||||
"q10RehabGap": "פער פקיד שיקום vs ועדה?",
|
||||
"q10RehabDetail": "פירוט הפער",
|
||||
"q11ScoreGap": "פער ניקוד vs מצב ומסמכים?",
|
||||
"q11ScoreDetail": "פירוט פער הניקוד",
|
||||
"q12UniqueAspects": "התייחסות להיבטים ייחודיים?",
|
||||
"q12UniqueDetail": "פירוט היבטים ייחודיים",
|
||||
"recommendationType": "סוג ההמלצה",
|
||||
"recommendationDetail": "פירוט ההמלצה",
|
||||
"additionalAidNeeded": "צורך בסיוע נוסף",
|
||||
"additionalAidNIDetail": "פירוט סיוע נוסף (ביטוח לאומי)",
|
||||
"additionalAidOtherDetail": "פירוט סיוע נוסף (תחום אחר)",
|
||||
"additionalAidUrgency": "דחיפות הסיוע הנוסף",
|
||||
"additionalAidDeadlines": "מועדים (סיוע נוסף)",
|
||||
"willingToRepresent": "בתחום התמחות + מעוניין לייצג?",
|
||||
"notes": "הערות כלליות",
|
||||
"assignedUser": "אחראי",
|
||||
"teams": "צוותים",
|
||||
"createdAt": "נוצר ב",
|
||||
"modifiedAt": "עודכן ב",
|
||||
"createdBy": "נוצר על ידי",
|
||||
"modifiedBy": "עודכן על ידי"
|
||||
},
|
||||
"options": {
|
||||
"status": {
|
||||
"Draft": "טיוטה",
|
||||
"Submitted": "נשלח",
|
||||
"Approved": "אושר",
|
||||
"Rejected": "נדחה"
|
||||
},
|
||||
"aidType": {
|
||||
"": "",
|
||||
"הגשת ערעור": "הגשת ערעור",
|
||||
"יעוץ והדרכה": "יעוץ והדרכה",
|
||||
"סיוע נוסף ביטוח לאומי": "סיוע נוסף ביטוח לאומי",
|
||||
"סיוע נוסף תחום אחר": "סיוע נוסף תחום אחר",
|
||||
"אי מתן סיוע": "אי מתן סיוע"
|
||||
},
|
||||
"urgencyLevel": {
|
||||
"": "",
|
||||
"רגיל": "רגיל",
|
||||
"דחוף": "דחוף",
|
||||
"בהול": "בהול"
|
||||
},
|
||||
"additionalUrgency": {
|
||||
"": "",
|
||||
"רגיל": "רגיל",
|
||||
"דחוף": "דחוף",
|
||||
"בהול": "בהול"
|
||||
},
|
||||
"contactStatus": {
|
||||
"": "",
|
||||
"תקין": "תקין",
|
||||
"לא תקין": "לא תקין"
|
||||
},
|
||||
"courtName": {
|
||||
"": "",
|
||||
"בית הדין האזורי לעבודה ירושלים": "בית הדין האזורי לעבודה ירושלים",
|
||||
"בית הדין האזורי לעבודה תל אביב": "בית הדין האזורי לעבודה תל אביב",
|
||||
"בית הדין האזורי לעבודה חיפה": "בית הדין האזורי לעבודה חיפה",
|
||||
"בית הדין האזורי לעבודה באר שבע": "בית הדין האזורי לעבודה באר שבע",
|
||||
"בית הדין האזורי לעבודה נצרת": "בית הדין האזורי לעבודה נצרת",
|
||||
"בית הדין הארצי לעבודה": "בית הדין הארצי לעבודה"
|
||||
},
|
||||
"proceedingSubject": {
|
||||
"": "",
|
||||
"נכות כללית": "נכות כללית",
|
||||
"נכות מעבודה": "נכות מעבודה",
|
||||
"נכות איבה": "נכות איבה",
|
||||
"ניידות": "ניידות",
|
||||
"אי כושר": "אי כושר",
|
||||
"שירותים מיוחדים": "שירותים מיוחדים",
|
||||
"סיעוד": "סיעוד",
|
||||
"גמלת הבטחת הכנסה": "גמלת הבטחת הכנסה",
|
||||
"דמי אבטלה": "דמי אבטלה",
|
||||
"אחר": "אחר"
|
||||
},
|
||||
"recommendationType": {
|
||||
"": "",
|
||||
"ייעוץ והדרכה חלף ייצוג": "ייעוץ והדרכה חלף ייצוג",
|
||||
"ויתור הלקוח": "ויתור הלקוח",
|
||||
"החלפת ייצוג": "החלפת ייצוג",
|
||||
"לא נוצר קשר": "לא נוצר קשר",
|
||||
"לא התקיימה פגישה": "לא התקיימה פגישה",
|
||||
"עדיין לא ניתן להחליט": "עדיין לא ניתן להחליט",
|
||||
"נדרשים מסמכים נוספים": "נדרשים מסמכים נוספים",
|
||||
"המלצה לסירוב": "המלצה לסירוב"
|
||||
},
|
||||
"additionalAidNeeded": {
|
||||
"": "",
|
||||
"לא נחוץ": "לא נחוץ",
|
||||
"נחוץ בתחום ביטוח לאומי": "נחוץ בתחום ביטוח לאומי",
|
||||
"נחוץ בתחום אחר": "נחוץ בתחום אחר"
|
||||
},
|
||||
"additionalAidUrgency": {
|
||||
"": "",
|
||||
"רגיל": "רגיל",
|
||||
"דחוף": "דחוף",
|
||||
"בהול": "בהול"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"case": "תיק"
|
||||
},
|
||||
"presetFilters": {
|
||||
"draft": "טיוטות",
|
||||
"submitted": "נשלחו",
|
||||
"approved": "אושרו"
|
||||
}
|
||||
}
|
||||
@@ -1,8 +1,2 @@
|
||||
{
|
||||
"scopeNames": {
|
||||
"DirectAccessReport": "דוח גישה ישירה"
|
||||
},
|
||||
"scopeNamesPlural": {
|
||||
"DirectAccessReport": "דוחות גישה ישירה"
|
||||
}
|
||||
}
|
||||
|
||||
+2
-2
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"tools": {
|
||||
"generate_initial_report": {
|
||||
"handler": "Espo\\Modules\\LegalAssistance\\SmartAssistant\\Tools\\GenerateInitialReport",
|
||||
"generate_direct_access_report": {
|
||||
"handler": "Espo\\Modules\\LegalAssistance\\SmartAssistant\\Tools\\DirectAccessReportGenerator",
|
||||
"requiresCase": true
|
||||
}
|
||||
}
|
||||
|
||||
-36
@@ -1,36 +0,0 @@
|
||||
{
|
||||
"controller": "controllers/record",
|
||||
"boolFilterList": ["onlyMy"],
|
||||
"iconClass": "fas fa-file-alt",
|
||||
"color": "#6C3483",
|
||||
"kanbanViewMode": true,
|
||||
"statusField": "status",
|
||||
"filterList": [
|
||||
{
|
||||
"name": "draft",
|
||||
"style": "default"
|
||||
},
|
||||
{
|
||||
"name": "submitted",
|
||||
"style": "warning"
|
||||
},
|
||||
{
|
||||
"name": "approved",
|
||||
"style": "success"
|
||||
}
|
||||
],
|
||||
"menu": {
|
||||
"list": {
|
||||
"buttons": []
|
||||
},
|
||||
"detail": {
|
||||
"buttons": []
|
||||
}
|
||||
},
|
||||
"relationshipPanels": {
|
||||
"case": {
|
||||
"select": true,
|
||||
"create": false
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,43 +1,2 @@
|
||||
{
|
||||
"fields": {
|
||||
"cLegalAidType": {
|
||||
"type": "enum",
|
||||
"options": ["", "DirectAccess", "Regular", "Duty"],
|
||||
"audited": true,
|
||||
"displayAsLabel": true,
|
||||
"style": {
|
||||
"DirectAccess": "primary",
|
||||
"Regular": "default",
|
||||
"Duty": "info"
|
||||
}
|
||||
},
|
||||
"cAppointmentDate": {
|
||||
"type": "date"
|
||||
},
|
||||
"cAidType": {
|
||||
"type": "enum",
|
||||
"options": ["", "הגשת ערעור", "יעוץ והדרכה", "סיוע נוסף ביטוח לאומי", "סיוע נוסף תחום א��ר", "אי מתן סיוע"]
|
||||
},
|
||||
"cUrgencyLevel": {
|
||||
"type": "enum",
|
||||
"options": ["", "רגיל", "דחוף", "��הול"],
|
||||
"displayAsLabel": true,
|
||||
"style": {
|
||||
"רגיל": "default",
|
||||
"דחוף": "warning",
|
||||
"בהול": "danger"
|
||||
}
|
||||
},
|
||||
"cFilingDeadline": {
|
||||
"type": "date"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"directAccessReports": {
|
||||
"type": "hasMany",
|
||||
"entity": "DirectAccessReport",
|
||||
"foreign": "case",
|
||||
"layoutRelationshipsDisabled": false
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
-269
@@ -1,269 +0,0 @@
|
||||
{
|
||||
"fields": {
|
||||
"name": {
|
||||
"type": "varchar",
|
||||
"required": true,
|
||||
"pattern": "$noBadCharacters"
|
||||
},
|
||||
"number": {
|
||||
"type": "autoincrement",
|
||||
"index": true
|
||||
},
|
||||
"status": {
|
||||
"type": "enum",
|
||||
"options": ["Draft", "Submitted", "Approved", "Rejected"],
|
||||
"default": "Draft",
|
||||
"audited": true,
|
||||
"displayAsLabel": true,
|
||||
"style": {
|
||||
"Draft": "default",
|
||||
"Submitted": "warning",
|
||||
"Approved": "success",
|
||||
"Rejected": "danger"
|
||||
}
|
||||
},
|
||||
"case": {
|
||||
"type": "link",
|
||||
"required": true
|
||||
},
|
||||
|
||||
"aidType": {
|
||||
"type": "enum",
|
||||
"options": ["", "הגשת ערעור", "יעוץ והדרכה", "סיוע נוסף ביטוח לאומי", "סיוע נוסף תחום אחר", "אי מתן סיוע"],
|
||||
"audited": true
|
||||
},
|
||||
"urgencyLevel": {
|
||||
"type": "enum",
|
||||
"options": ["", "רגיל", "דחוף", "בהול"],
|
||||
"default": "רגיל",
|
||||
"displayAsLabel": true,
|
||||
"style": {
|
||||
"רגיל": "default",
|
||||
"דחוף": "warning",
|
||||
"בהול": "danger"
|
||||
}
|
||||
},
|
||||
"appointmentDate": {
|
||||
"type": "date"
|
||||
},
|
||||
"filingDeadline": {
|
||||
"type": "date"
|
||||
},
|
||||
"additionalUrgency": {
|
||||
"type": "enum",
|
||||
"options": ["", "רגיל", "דחוף", "בהול"]
|
||||
},
|
||||
"additionalDeadline": {
|
||||
"type": "varchar",
|
||||
"maxLength": 150
|
||||
},
|
||||
|
||||
"firstContactDate": {
|
||||
"type": "date"
|
||||
},
|
||||
"contactDelayReason": {
|
||||
"type": "text"
|
||||
},
|
||||
"meetingDate": {
|
||||
"type": "date"
|
||||
},
|
||||
"meetingDelayReason": {
|
||||
"type": "text"
|
||||
},
|
||||
"meetingAttendees": {
|
||||
"type": "text"
|
||||
},
|
||||
"contactStatus": {
|
||||
"type": "enum",
|
||||
"options": ["", "תקין", "לא תקין"]
|
||||
},
|
||||
"contactStatusDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"proceedingNumber": {
|
||||
"type": "varchar",
|
||||
"maxLength": 50
|
||||
},
|
||||
"courtName": {
|
||||
"type": "enum",
|
||||
"options": ["", "בית הדין האזורי לעבודה ירושלים", "בית הדין האזורי לעבודה תל אביב", "בית הדין האזורי לעבודה חיפה", "בית הדין האזורי לעבודה באר שבע", "בית הדין האזורי לעבודה נצרת", "בית הדין הארצי לעבודה"]
|
||||
},
|
||||
"proceedingSubject": {
|
||||
"type": "enum",
|
||||
"options": ["", "נכות כללית", "נכות מעבודה", "נכות איבה", "ניידות", "אי כושר", "שירותים מיוחדים", "סיעוד", "גמלת הבטחת הכנסה", "דמי אבטלה", "אחר"]
|
||||
},
|
||||
"claimSummary": {
|
||||
"type": "text"
|
||||
},
|
||||
"defenseClaims": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"q1DocsReviewed": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q1DocsDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"q2Reasoned": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q2ReasonDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"q3PanelMatch": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q4PanelComposition": {
|
||||
"type": "text"
|
||||
},
|
||||
"q5ComplaintsAddressed": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q6ComplaintsDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"q7ClinicalExam": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q8ClinicalGap": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"q9MoharaApplied": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q9MoharaDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"q10RehabGap": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q10RehabDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"q11ScoreGap": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q11ScoreDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"q12UniqueAspects": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
"q12UniqueDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"recommendationType": {
|
||||
"type": "enum",
|
||||
"options": ["", "ייעוץ והדרכה חלף ייצוג", "ויתור הלקוח", "החלפת ייצוג", "לא נוצר קשר", "לא התקיימה פגישה", "עדיין לא ניתן להחליט", "נדרשים מסמכים נוספים", "המלצה לסירוב"]
|
||||
},
|
||||
"recommendationDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"additionalAidNeeded": {
|
||||
"type": "enum",
|
||||
"options": ["", "לא נחוץ", "נחוץ בתחום ביטוח לאומי", "נחוץ בתחום אחר"]
|
||||
},
|
||||
"additionalAidNIDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"additionalAidOtherDetail": {
|
||||
"type": "text"
|
||||
},
|
||||
"additionalAidUrgency": {
|
||||
"type": "enum",
|
||||
"options": ["", "רגיל", "דחוף", "בהול"]
|
||||
},
|
||||
"additionalAidDeadlines": {
|
||||
"type": "varchar",
|
||||
"maxLength": 150
|
||||
},
|
||||
"willingToRepresent": {
|
||||
"type": "bool",
|
||||
"default": false
|
||||
},
|
||||
|
||||
"notes": {
|
||||
"type": "text"
|
||||
},
|
||||
|
||||
"createdAt": {
|
||||
"type": "datetime",
|
||||
"readOnly": true
|
||||
},
|
||||
"modifiedAt": {
|
||||
"type": "datetime",
|
||||
"readOnly": true
|
||||
},
|
||||
"createdBy": {
|
||||
"type": "link",
|
||||
"readOnly": true,
|
||||
"view": "views/fields/user"
|
||||
},
|
||||
"modifiedBy": {
|
||||
"type": "link",
|
||||
"readOnly": true,
|
||||
"view": "views/fields/user"
|
||||
},
|
||||
"assignedUser": {
|
||||
"type": "link",
|
||||
"view": "views/fields/assigned-user"
|
||||
},
|
||||
"teams": {
|
||||
"type": "linkMultiple",
|
||||
"view": "views/fields/teams"
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"case": {
|
||||
"type": "belongsTo",
|
||||
"entity": "Case",
|
||||
"foreign": "directAccessReports"
|
||||
},
|
||||
"createdBy": {
|
||||
"type": "belongsTo",
|
||||
"entity": "User"
|
||||
},
|
||||
"modifiedBy": {
|
||||
"type": "belongsTo",
|
||||
"entity": "User"
|
||||
},
|
||||
"assignedUser": {
|
||||
"type": "belongsTo",
|
||||
"entity": "User"
|
||||
},
|
||||
"teams": {
|
||||
"type": "hasMany",
|
||||
"entity": "Team",
|
||||
"relationName": "entityTeam",
|
||||
"layoutRelationshipsDisabled": true
|
||||
}
|
||||
},
|
||||
"collection": {
|
||||
"orderBy": "createdAt",
|
||||
"order": "desc",
|
||||
"textFilterFields": ["name", "number"]
|
||||
},
|
||||
"indexes": {
|
||||
"status": {
|
||||
"columns": ["status", "deleted"]
|
||||
},
|
||||
"createdAt": {
|
||||
"columns": ["createdAt"]
|
||||
}
|
||||
}
|
||||
}
|
||||
-81
@@ -1,81 +0,0 @@
|
||||
[
|
||||
{
|
||||
"label": "כותרת ופרטי תיק",
|
||||
"rows": [
|
||||
[{"name": "name"}, {"name": "number"}],
|
||||
[{"name": "case"}, {"name": "status"}],
|
||||
[{"name": "assignedUser"}, {"name": "teams"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "מהות הסיוע",
|
||||
"rows": [
|
||||
[{"name": "aidType"}, {"name": "urgencyLevel"}],
|
||||
[{"name": "appointmentDate"}, {"name": "filingDeadline"}],
|
||||
[{"name": "additionalUrgency"}, {"name": "additionalDeadline"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "קשר עם הלקוח",
|
||||
"rows": [
|
||||
[{"name": "firstContactDate"}, {"name": "contactDelayReason"}],
|
||||
[{"name": "meetingDate"}, {"name": "meetingDelayReason"}],
|
||||
[{"name": "meetingAttendees"}, {"name": "contactStatus"}],
|
||||
[{"name": "contactStatusDetail"}, false]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "פרטי ההליך",
|
||||
"rows": [
|
||||
[{"name": "proceedingNumber"}, {"name": "courtName"}],
|
||||
[{"name": "proceedingSubject"}, false],
|
||||
[{"name": "claimSummary", "fullWidth": true}],
|
||||
[{"name": "defenseClaims", "fullWidth": true}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "בחינת סיכוי משפטי — נכות",
|
||||
"rows": [
|
||||
[{"name": "q1DocsReviewed"}, {"name": "q1DocsDetail"}],
|
||||
[{"name": "q2Reasoned"}, {"name": "q2ReasonDetail"}],
|
||||
[{"name": "q3PanelMatch"}, {"name": "q4PanelComposition"}],
|
||||
[{"name": "q5ComplaintsAddressed"}, {"name": "q6ComplaintsDetail"}],
|
||||
[{"name": "q7ClinicalExam"}, {"name": "q8ClinicalGap"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "בחינת סיכוי משפטי — אי כושר",
|
||||
"rows": [
|
||||
[{"name": "q9MoharaApplied"}, {"name": "q9MoharaDetail"}],
|
||||
[{"name": "q10RehabGap"}, {"name": "q10RehabDetail"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "בחינת סיכוי משפטי — שירותים מיוחדים/סיעוד",
|
||||
"rows": [
|
||||
[{"name": "q11ScoreGap"}, {"name": "q11ScoreDetail"}],
|
||||
[{"name": "q12UniqueAspects"}, {"name": "q12UniqueDetail"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "המלצה",
|
||||
"rows": [
|
||||
[{"name": "recommendationType"}, false],
|
||||
[{"name": "recommendationDetail", "fullWidth": true}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "מיצוי זכויות",
|
||||
"rows": [
|
||||
[{"name": "additionalAidNeeded"}, {"name": "additionalAidUrgency"}],
|
||||
[{"name": "additionalAidNIDetail"}, {"name": "additionalAidOtherDetail"}],
|
||||
[{"name": "additionalAidDeadlines"}, {"name": "willingToRepresent"}]
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "הערות",
|
||||
"rows": [
|
||||
[{"name": "notes", "fullWidth": true}]
|
||||
]
|
||||
}
|
||||
]
|
||||
-11
@@ -1,11 +0,0 @@
|
||||
[
|
||||
{
|
||||
"rows": [
|
||||
[{"name": "name"}],
|
||||
[{"name": "case"}],
|
||||
[{"name": "status"}],
|
||||
[{"name": "aidType"}],
|
||||
[{"name": "recommendationType"}]
|
||||
]
|
||||
}
|
||||
]
|
||||
-10
@@ -1,10 +0,0 @@
|
||||
[
|
||||
{"name": "number", "width": 8},
|
||||
{"name": "name", "link": true},
|
||||
{"name": "case", "width": 20},
|
||||
{"name": "status", "width": 12},
|
||||
{"name": "aidType", "width": 15},
|
||||
{"name": "recommendationType", "width": 15},
|
||||
{"name": "createdAt", "width": 15},
|
||||
{"name": "assignedUser", "width": 15}
|
||||
]
|
||||
-15
@@ -1,15 +0,0 @@
|
||||
{
|
||||
"entity": true,
|
||||
"object": true,
|
||||
"stream": true,
|
||||
"tab": false,
|
||||
"acl": true,
|
||||
"aclPortal": false,
|
||||
"disabled": false,
|
||||
"module": "LegalAssistance",
|
||||
"isCustom": false,
|
||||
"notifications": true,
|
||||
"calendar": false,
|
||||
"activity": false,
|
||||
"kanbanStatusIgnoreList": ["Approved", "Rejected"]
|
||||
}
|
||||
@@ -1,214 +0,0 @@
|
||||
<?php
|
||||
|
||||
namespace Espo\Modules\LegalAssistance\Services;
|
||||
|
||||
use Espo\Core\Exceptions\Error;
|
||||
use Espo\Core\InjectableFactory;
|
||||
use Espo\ORM\EntityManager;
|
||||
use Espo\Core\Utils\Log;
|
||||
use Espo\Core\Utils\DateTime as DateTimeUtil;
|
||||
use Espo\Entities\User;
|
||||
|
||||
class DirectAccessReportService
|
||||
{
|
||||
public function __construct(
|
||||
private EntityManager $entityManager,
|
||||
private InjectableFactory $injectableFactory,
|
||||
private Log $log,
|
||||
private User $user,
|
||||
private DateTimeUtil $dateTimeUtil
|
||||
) {}
|
||||
|
||||
public function generateReport(string $caseId, string $userId, array $params): array
|
||||
{
|
||||
$case = $this->entityManager->getEntityById('Case', $caseId);
|
||||
if (!$case) {
|
||||
throw new Error("Case {$caseId} not found.");
|
||||
}
|
||||
|
||||
$contact = null;
|
||||
$contactId = $case->get('contactId');
|
||||
if ($contactId) {
|
||||
$contact = $this->entityManager->getEntityById('Contact', $contactId);
|
||||
}
|
||||
|
||||
// Build report name
|
||||
$contactName = $contact
|
||||
? ($contact->get('firstName') . ' ' . $contact->get('lastName'))
|
||||
: 'ללא איש קשר';
|
||||
$reportName = "דוח גישה ישיר�� — {$contactName}";
|
||||
|
||||
// Extract legal analysis from nested object
|
||||
$legalAnalysis = $params['legalAnalysis'] ?? [];
|
||||
if (is_string($legalAnalysis)) {
|
||||
$legalAnalysis = json_decode($legalAnalysis, true) ?? [];
|
||||
}
|
||||
|
||||
// Create DirectAccessReport entity
|
||||
$report = $this->entityManager->getNewEntity('DirectAccessReport');
|
||||
$report->set([
|
||||
'name' => $reportName,
|
||||
'status' => 'Draft',
|
||||
'caseId' => $caseId,
|
||||
'assignedUserId' => $userId,
|
||||
|
||||
// Section ב' �� מהות הסיוע
|
||||
'aidType' => $params['aidType'] ?? null,
|
||||
'urgencyLevel' => $params['urgencyLevel'] ?? null,
|
||||
'appointmentDate' => $this->normalizeDate($params['appointmentDate'] ?? null),
|
||||
'filingDeadline' => $this->normalizeDate($params['filingDeadline'] ?? null),
|
||||
'additionalUrgency' => $params['additionalUrgency'] ?? null,
|
||||
'additionalDeadline' => $params['additionalDeadline'] ?? null,
|
||||
|
||||
// Section ג' — קשר עם הלקוח
|
||||
'firstContactDate' => $this->normalizeDate($params['firstContactDate'] ?? null),
|
||||
'contactDelayReason' => $params['contactDelayReason'] ?? null,
|
||||
'meetingDate' => $this->normalizeDate($params['meetingDate'] ?? null),
|
||||
'meetingDelayReason' => $params['meetingDelayReason'] ?? null,
|
||||
'meetingAttendees' => $params['meetingAttendees'] ?? null,
|
||||
'contactStatus' => $params['contactStatus'] ?? null,
|
||||
'contactStatusDetail' => $params['contactStatusDetail'] ?? null,
|
||||
|
||||
// Section ד' — פרטי ההליך
|
||||
'proceedingNumber' => $params['proceedingNumber'] ?? $case->get('cCourtCaseNumber'),
|
||||
'courtName' => $params['courtName'] ?? null,
|
||||
'proceedingSubject' => $params['proceedingSubject'] ?? null,
|
||||
'claimSummary' => $params['claimSummary'] ?? null,
|
||||
'defenseClaims' => $params['defenseClaims'] ?? null,
|
||||
|
||||
// Section ה'-ז' — בחינת סיכוי משפטי
|
||||
'q1DocsReviewed' => $legalAnalysis['q1DocsReviewed'] ?? false,
|
||||
'q1DocsDetail' => $legalAnalysis['q1DocsDetail'] ?? null,
|
||||
'q2Reasoned' => $legalAnalysis['q2Reasoned'] ?? false,
|
||||
'q2ReasonDetail' => $legalAnalysis['q2ReasonDetail'] ?? null,
|
||||
'q3PanelMatch' => $legalAnalysis['q3PanelMatch'] ?? false,
|
||||
'q4PanelComposition' => $legalAnalysis['q4PanelComposition'] ?? null,
|
||||
'q5ComplaintsAddressed' => $legalAnalysis['q5ComplaintsAddressed'] ?? false,
|
||||
'q6ComplaintsDetail' => $legalAnalysis['q6ComplaintsDetail'] ?? null,
|
||||
'q7ClinicalExam' => $legalAnalysis['q7ClinicalExam'] ?? false,
|
||||
'q8ClinicalGap' => $legalAnalysis['q8ClinicalGap'] ?? null,
|
||||
'q9MoharaApplied' => $legalAnalysis['q9MoharaApplied'] ?? false,
|
||||
'q9MoharaDetail' => $legalAnalysis['q9MoharaDetail'] ?? null,
|
||||
'q10RehabGap' => $legalAnalysis['q10RehabGap'] ?? false,
|
||||
'q10RehabDetail' => $legalAnalysis['q10RehabDetail'] ?? null,
|
||||
'q11ScoreGap' => $legalAnalysis['q11ScoreGap'] ?? false,
|
||||
'q11ScoreDetail' => $legalAnalysis['q11ScoreDetail'] ?? null,
|
||||
'q12UniqueAspects' => $legalAnalysis['q12UniqueAspects'] ?? false,
|
||||
'q12UniqueDetail' => $legalAnalysis['q12UniqueDetail'] ?? null,
|
||||
|
||||
// Section ח' — המלצה
|
||||
'recommendationType' => $params['recommendationType'] ?? null,
|
||||
'recommendationDetail' => $params['recommendationDetail'] ?? null,
|
||||
|
||||
// Section ט' — מיצוי זכויות
|
||||
'additionalAidNeeded' => $params['additionalAidNeeded'] ?? null,
|
||||
'additionalAidNIDetail' => $params['additionalAidNIDetail'] ?? null,
|
||||
'additionalAidOtherDetail' => $params['additionalAidOtherDetail'] ?? null,
|
||||
'additionalAidUrgency' => $params['additionalAidUrgency'] ?? null,
|
||||
'additionalAidDeadlines' => $params['additionalAidDeadlines'] ?? null,
|
||||
'willingToRepresent' => $params['willingToRepresent'] ?? false,
|
||||
|
||||
// Section י' — הערות
|
||||
'notes' => $params['notes'] ?? null,
|
||||
]);
|
||||
|
||||
$this->entityManager->saveEntity($report);
|
||||
|
||||
$this->log->info("LegalAssistance: Created DirectAccessReport {$report->getId()} for case {$caseId}");
|
||||
|
||||
// Also update Case fields if provided
|
||||
$caseUpdated = false;
|
||||
if (!empty($params['appointmentDate']) && !$case->get('cAppointmentDate')) {
|
||||
$case->set('cAppointmentDate', $this->normalizeDate($params['appointmentDate']));
|
||||
$caseUpdated = true;
|
||||
}
|
||||
if (!empty($params['aidType']) && !$case->get('cAidType')) {
|
||||
$case->set('cAidType', $params['aidType']);
|
||||
$caseUpdated = true;
|
||||
}
|
||||
if (!empty($params['urgencyLevel']) && !$case->get('cUrgencyLevel')) {
|
||||
$case->set('cUrgencyLevel', $params['urgencyLevel']);
|
||||
$caseUpdated = true;
|
||||
}
|
||||
if (!empty($params['filingDeadline']) && !$case->get('cFilingDeadline')) {
|
||||
$case->set('cFilingDeadline', $this->normalizeDate($params['filingDeadline']));
|
||||
$caseUpdated = true;
|
||||
}
|
||||
if ($caseUpdated) {
|
||||
$this->entityManager->saveEntity($case, ['skipHooks' => true]);
|
||||
}
|
||||
|
||||
// Generate DOCX using template
|
||||
$docxResult = $this->generateDocx($report, $case, $contact, $userId);
|
||||
|
||||
$msg = "✅ דוח גישה ישירה נוצר בהצלחה: \"{$reportName}\"";
|
||||
if (!empty($docxResult['fileName'])) {
|
||||
$msg .= "\n📄 מסמך DOCX נוצר: {$docxResult['fileName']}";
|
||||
}
|
||||
|
||||
return [
|
||||
'success' => true,
|
||||
'message' => $msg,
|
||||
'entityType' => 'DirectAccessReport',
|
||||
'entityId' => $report->getId(),
|
||||
];
|
||||
}
|
||||
|
||||
private function generateDocx($report, $case, $contact, string $userId): array
|
||||
{
|
||||
// Try to use LocalDocumentTemplateService if available
|
||||
try {
|
||||
$templateServiceClass = 'Espo\\Modules\\LocalDocuments\\Services\\LocalDocumentTemplateService';
|
||||
if (!class_exists($templateServiceClass)) {
|
||||
$templateServiceClass = 'Espo\\Modules\\NetworkStorageIntegration\\Services\\DocumentTemplateService';
|
||||
}
|
||||
|
||||
if (!class_exists($templateServiceClass)) {
|
||||
$this->log->warning("LegalAssistance: No template service available for DOCX generation");
|
||||
return ['success' => false, 'error' => 'No template service'];
|
||||
}
|
||||
|
||||
// Find the template
|
||||
$template = $this->entityManager
|
||||
->getRDBRepository('DocumentTemplate')
|
||||
->where(['name' => 'דוח גישה ישירה'])
|
||||
->findOne();
|
||||
|
||||
if (!$template) {
|
||||
$this->log->warning("LegalAssistance: Template 'דוח גישה ישירה' not found");
|
||||
return ['success' => false, 'error' => 'Template not found'];
|
||||
}
|
||||
|
||||
$templateService = $this->injectableFactory->create($templateServiceClass);
|
||||
|
||||
$result = $templateService->createFromTemplate(
|
||||
$template->getId(),
|
||||
'Case',
|
||||
$case->getId(),
|
||||
$report->get('name')
|
||||
);
|
||||
|
||||
return $result;
|
||||
} catch (\Throwable $e) {
|
||||
$this->log->error("LegalAssistance: DOCX generation failed: " . $e->getMessage());
|
||||
return ['success' => false, 'error' => $e->getMessage()];
|
||||
}
|
||||
}
|
||||
|
||||
private function normalizeDate(?string $value): ?string
|
||||
{
|
||||
if (!$value) return null;
|
||||
|
||||
// Handle DD/MM/YYYY format
|
||||
if (preg_match('/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/', $value, $m)) {
|
||||
return "{$m[3]}-{$m[2]}-{$m[1]}";
|
||||
}
|
||||
|
||||
// Handle YYYY-MM-DD format (already correct)
|
||||
if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {
|
||||
return $value;
|
||||
}
|
||||
|
||||
return $value;
|
||||
}
|
||||
}
|
||||
+461
@@ -0,0 +1,461 @@
|
||||
<?php
|
||||
/************************************************************************
|
||||
* Direct Access Report Generator
|
||||
*
|
||||
* Takes JSON params from Shira (AI assistant), generates a DOCX report
|
||||
* using PHPWord TemplateProcessor, and attaches it to the Case as a
|
||||
* Document. No entity creation — data goes directly into the template.
|
||||
************************************************************************/
|
||||
|
||||
namespace Espo\Modules\LegalAssistance\SmartAssistant\Tools;
|
||||
|
||||
use Espo\Core\Exceptions\Error;
|
||||
use Espo\Core\InjectableFactory;
|
||||
use Espo\ORM\EntityManager;
|
||||
use Espo\Core\Utils\Log;
|
||||
use Espo\Entities\User;
|
||||
use Espo\Modules\NetworkStorageIntegration\Services\NetworkDocumentService;
|
||||
use Espo\Modules\NetworkStorageIntegration\Classes\LocalFilesystemClient;
|
||||
use PhpOffice\PhpWord\TemplateProcessor;
|
||||
|
||||
class DirectAccessReportGenerator
|
||||
{
|
||||
private const TEMP_DIR = 'data/tmp/';
|
||||
private const TEMPLATE_NAME = 'דוח גישה ישירה';
|
||||
|
||||
public function __construct(
|
||||
private EntityManager $entityManager,
|
||||
private InjectableFactory $injectableFactory,
|
||||
private Log $log,
|
||||
private User $user
|
||||
) {}
|
||||
|
||||
public function execute(array $params, ?string $caseId, string $userId): array
|
||||
{
|
||||
if (!$caseId) {
|
||||
throw new Error('generate_direct_access_report requires a case context.');
|
||||
}
|
||||
|
||||
$this->log->info("LegalAssistance: Generating direct access report for case {$caseId}");
|
||||
|
||||
$case = $this->entityManager->getEntityById('Case', $caseId);
|
||||
if (!$case) {
|
||||
throw new Error("Case {$caseId} not found.");
|
||||
}
|
||||
|
||||
// Get contact
|
||||
$contact = null;
|
||||
$contactId = $case->get('contactId');
|
||||
if (!$contactId) {
|
||||
$contactsIds = $case->getLinkMultipleIdList('contacts');
|
||||
if (!empty($contactsIds)) {
|
||||
$contactId = $contactsIds[0];
|
||||
}
|
||||
}
|
||||
if ($contactId) {
|
||||
$contact = $this->entityManager->getEntityById('Contact', $contactId);
|
||||
}
|
||||
|
||||
$contactName = $contact
|
||||
? trim($contact->get('firstName') . ' ' . $contact->get('lastName'))
|
||||
: 'ללא איש קשר';
|
||||
|
||||
// Get assigned user name — prefer case's assignedUser, then userId, then current user
|
||||
$assignedUserName = '';
|
||||
$caseAssignedUserId = $case->get('assignedUserId');
|
||||
if ($caseAssignedUserId) {
|
||||
$caseAssignedUser = $this->entityManager->getEntityById('User', $caseAssignedUserId);
|
||||
if ($caseAssignedUser) {
|
||||
$assignedUserName = $caseAssignedUser->get('name') ?? '';
|
||||
}
|
||||
}
|
||||
if (empty($assignedUserName) && $userId) {
|
||||
$assignedUser = $this->entityManager->getEntityById('User', $userId);
|
||||
if ($assignedUser) {
|
||||
$assignedUserName = $assignedUser->get('name') ?? '';
|
||||
}
|
||||
}
|
||||
if (empty($assignedUserName)) {
|
||||
$assignedUserName = $this->user->get('name') ?? '';
|
||||
}
|
||||
// Filter out system/API user names
|
||||
if (in_array(strtolower($assignedUserName), ['api', 'x-api-key', 'system', 'admin'], true)) {
|
||||
$assignedUserName = '';
|
||||
}
|
||||
|
||||
// Build placeholder data directly from params
|
||||
$data = $this->buildPlaceholderData($params, $case, $contactName, $assignedUserName);
|
||||
|
||||
// Add checkbox mappings
|
||||
$this->addCheckboxData($data, $params);
|
||||
|
||||
// Find template and generate DOCX. Subject-only, tight hyphen (rule N1).
|
||||
$templatePath = $this->resolveTemplatePath();
|
||||
$documentName = "דוח גישה ישירה-{$contactName}";
|
||||
$baseName = LocalFilesystemClient::sanitizeFileName($documentName);
|
||||
if ($baseName === '') {
|
||||
$baseName = 'דוח גישה ישירה';
|
||||
}
|
||||
$fileName = $baseName . '.docx';
|
||||
$outputPath = self::TEMP_DIR . uniqid('report_') . '.docx';
|
||||
|
||||
if (!is_dir(self::TEMP_DIR)) {
|
||||
mkdir(self::TEMP_DIR, 0775, true);
|
||||
}
|
||||
|
||||
$this->processTemplate($templatePath, $outputPath, $data);
|
||||
|
||||
// Read generated file
|
||||
$content = file_get_contents($outputPath);
|
||||
@unlink($outputPath);
|
||||
|
||||
// Clean up temp template if downloaded from storage
|
||||
if (str_starts_with($templatePath, self::TEMP_DIR)) {
|
||||
@unlink($templatePath);
|
||||
}
|
||||
|
||||
// Create Attachment
|
||||
$attachment = $this->entityManager->getNewEntity('Attachment');
|
||||
$attachment->set([
|
||||
'name' => $fileName,
|
||||
'type' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
|
||||
'role' => 'Attachment',
|
||||
'size' => strlen($content),
|
||||
'relatedType' => 'Document',
|
||||
]);
|
||||
$this->entityManager->saveEntity($attachment);
|
||||
file_put_contents('data/upload/' . $attachment->getId(), $content);
|
||||
|
||||
// Create Document linked to Case
|
||||
$document = $this->entityManager->getNewEntity('Document');
|
||||
$document->set([
|
||||
'name' => $documentName,
|
||||
'fileId' => $attachment->getId(),
|
||||
'fileName' => $fileName,
|
||||
'assignedUserId' => $userId,
|
||||
'type' => 'דוח',
|
||||
]);
|
||||
// Suppress the NSI upload hook (fires before the Case link below); we
|
||||
// upload explicitly with the Case so it lands in the case folder.
|
||||
$this->entityManager->saveEntity($document, ['skipNetworkUpload' => true]);
|
||||
|
||||
// Link Document to Case (via Case side of relationship)
|
||||
$this->entityManager->getRDBRepository('Case')
|
||||
->getRelation($case, 'documents')
|
||||
->relate($document);
|
||||
|
||||
// Upload to the case folder; align DB names to the canonical stored name.
|
||||
try {
|
||||
$nds = $this->injectableFactory->create(NetworkDocumentService::class);
|
||||
if ($nds->isEnabled()) {
|
||||
$result = $nds->uploadDocument($document, $attachment, 'Case', $caseId);
|
||||
|
||||
if (!empty($result['success'])) {
|
||||
$storedName = $result['fileName'] ?? $fileName;
|
||||
$storedBase = pathinfo($storedName, PATHINFO_FILENAME) ?: $documentName;
|
||||
|
||||
$document->set([
|
||||
'name' => $storedBase,
|
||||
'fileName' => $storedName,
|
||||
'storageType' => 'network',
|
||||
'networkStoragePath' => $result['path'] ?? null,
|
||||
'networkStorageFileName' => $storedName,
|
||||
'networkStorageSize' => $result['size'] ?? strlen($content),
|
||||
'networkStorageModifiedAt' => date('Y-m-d H:i:s'),
|
||||
]);
|
||||
$this->entityManager->saveEntity($document, [
|
||||
'skipNetworkUpload' => true,
|
||||
'silent' => true,
|
||||
]);
|
||||
|
||||
$attachment->set('name', $storedName);
|
||||
$this->entityManager->saveEntity($attachment, ['silent' => true]);
|
||||
|
||||
$sourcePath = 'data/upload/' . $attachment->getSourceId();
|
||||
if (file_exists($sourcePath)) {
|
||||
@unlink($sourcePath);
|
||||
}
|
||||
|
||||
$documentName = $storedBase;
|
||||
}
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
// Document is safely persisted in Espo; the network copy is best-effort.
|
||||
$this->log->warning(
|
||||
"LegalAssistance: failed to copy report to network storage for Case {$caseId}: " .
|
||||
$e->getMessage()
|
||||
);
|
||||
}
|
||||
|
||||
$this->log->info("LegalAssistance: Report generated — Document {$document->getId()} attached to Case {$caseId}");
|
||||
|
||||
return [
|
||||
'success' => true,
|
||||
'message' => "✅ דוח גישה ישירה נוצר בהצלחה: \"{$documentName}\"\n📄 המסמך צורף לתיק.",
|
||||
'entityType' => 'Document',
|
||||
'entityId' => $document->getId(),
|
||||
];
|
||||
}
|
||||
|
||||
private function buildPlaceholderData(array $params, $case, string $contactName, string $assignedUserName): array
|
||||
{
|
||||
$legalAnalysis = $params['legalAnalysis'] ?? [];
|
||||
if (is_string($legalAnalysis)) {
|
||||
$legalAnalysis = json_decode($legalAnalysis, true) ?? [];
|
||||
} elseif (is_object($legalAnalysis)) {
|
||||
$legalAnalysis = (array) $legalAnalysis;
|
||||
}
|
||||
|
||||
// Fallback: if AI sent legalAnalysis fields flat (not nested), pick them up
|
||||
$laFields = ['q1DocsDetail', 'q2ReasonDetail', 'q4PanelComposition', 'q6ComplaintsDetail',
|
||||
'q8ClinicalGap', 'q9MoharaDetail', 'q10RehabDetail', 'q11ScoreDetail', 'q12UniqueDetail'];
|
||||
foreach ($laFields as $f) {
|
||||
if (empty($legalAnalysis[$f]) && !empty($params[$f])) {
|
||||
$legalAnalysis[$f] = $params[$f];
|
||||
}
|
||||
}
|
||||
|
||||
return [
|
||||
// Header
|
||||
'cLegalAidNumber' => $params['legalAidNumber'] ?? $case->get('cLegalAidNumber') ?? '',
|
||||
'contactName' => $contactName,
|
||||
'assignedUserName' => $assignedUserName,
|
||||
'reportDate' => $this->formatDate(date('Y-m-d')),
|
||||
|
||||
// Aid type & urgency
|
||||
'appointmentDate' => $this->formatDate($this->normalizeDate($params['appointmentDate'] ?? null)),
|
||||
'filingDeadline' => $this->formatDate($this->normalizeDate($params['filingDeadline'] ?? null)),
|
||||
'additionalDeadline' => $params['additionalDeadline'] ?? '',
|
||||
|
||||
// Client contact
|
||||
'firstContactDate' => $this->formatDate($this->normalizeDate($params['firstContactDate'] ?? null)),
|
||||
'contactDelayReason' => $params['contactDelayReason'] ?? '',
|
||||
'meetingDate' => $this->formatDate($this->normalizeDate($params['meetingDate'] ?? null)),
|
||||
'meetingDelayReason' => $params['meetingDelayReason'] ?? '',
|
||||
'meetingAttendees' => $params['meetingAttendees'] ?? '',
|
||||
'contactStatusDetail' => $params['contactStatusDetail'] ?? '',
|
||||
|
||||
// Proceeding details
|
||||
'proceedingNumber' => $params['proceedingNumber'] ?? $case->get('cCourtCaseNumber') ?? '',
|
||||
'courtName' => $params['courtName'] ?? '',
|
||||
'proceedingSubject' => $params['proceedingSubject'] ?? '',
|
||||
'claimSummary' => $params['claimSummary'] ?? '',
|
||||
'defenseClaims' => $params['defenseClaims'] ?? '',
|
||||
|
||||
// Legal analysis
|
||||
'q1DocsDetail' => $legalAnalysis['q1DocsDetail'] ?? '',
|
||||
'q2ReasonDetail' => $legalAnalysis['q2ReasonDetail'] ?? '',
|
||||
'q4PanelComposition' => $legalAnalysis['q4PanelComposition'] ?? '',
|
||||
'q6ComplaintsDetail' => $legalAnalysis['q6ComplaintsDetail'] ?? '',
|
||||
'q8ClinicalGap' => $legalAnalysis['q8ClinicalGap'] ?? '',
|
||||
'q9MoharaDetail' => $legalAnalysis['q9MoharaDetail'] ?? '',
|
||||
'q10RehabDetail' => $legalAnalysis['q10RehabDetail'] ?? '',
|
||||
'q11ScoreDetail' => $legalAnalysis['q11ScoreDetail'] ?? '',
|
||||
'q12UniqueDetail' => $legalAnalysis['q12UniqueDetail'] ?? '',
|
||||
|
||||
// Recommendation
|
||||
'recommendationDetail' => $params['recommendationDetail'] ?? '',
|
||||
|
||||
// Additional aid
|
||||
'additionalAidNIDetail' => $params['additionalAidNIDetail'] ?? '',
|
||||
'additionalAidOtherDetail' => $params['additionalAidOtherDetail'] ?? '',
|
||||
'additionalAidDeadlines' => $params['additionalAidDeadlines'] ?? '',
|
||||
|
||||
// Notes
|
||||
'notes' => $params['notes'] ?? '',
|
||||
];
|
||||
}
|
||||
|
||||
private function addCheckboxData(array &$data, array $params): void
|
||||
{
|
||||
$CHK = "☑\u{00A0}";
|
||||
$UNCHK = "☐\u{00A0}";
|
||||
|
||||
$urgency = $params['urgencyLevel'] ?? '';
|
||||
$data['chk_urgency_regular'] = ($urgency === 'רגיל') ? $CHK : $UNCHK;
|
||||
$data['chk_urgency_urgent'] = ($urgency === 'דחוף') ? $CHK : $UNCHK;
|
||||
$data['chk_urgency_emergency'] = ($urgency === 'בהול') ? $CHK : $UNCHK;
|
||||
|
||||
$aidType = $params['aidType'] ?? '';
|
||||
$data['chk_aid_appeal'] = ($aidType === 'הגשת ערעור') ? $CHK : $UNCHK;
|
||||
$data['chk_aid_consulting'] = ($aidType === 'יעוץ והדרכה') ? $CHK : $UNCHK;
|
||||
$data['chk_aid_additional_ni'] = ($aidType === 'סיוע נוסף ביטוח לאומי') ? $CHK : $UNCHK;
|
||||
$data['chk_aid_additional_other'] = ($aidType === 'סיוע נוסף תחום אחר') ? $CHK : $UNCHK;
|
||||
$data['chk_aid_none'] = ($aidType === 'אי מתן סיוע') ? $CHK : $UNCHK;
|
||||
|
||||
$addUrgency = $params['additionalUrgency'] ?? '';
|
||||
$data['chk_add_urgency_regular'] = ($addUrgency === 'רגיל') ? $CHK : $UNCHK;
|
||||
$data['chk_add_urgency_urgent'] = ($addUrgency === 'דחוף') ? $CHK : $UNCHK;
|
||||
$data['chk_add_urgency_emergency'] = ($addUrgency === 'בהול') ? $CHK : $UNCHK;
|
||||
|
||||
$contactStatus = $params['contactStatus'] ?? '';
|
||||
$data['chk_contact_ok'] = ($contactStatus === 'תקין') ? $CHK : $UNCHK;
|
||||
$data['chk_contact_bad'] = ($contactStatus === 'לא תקין') ? $CHK : $UNCHK;
|
||||
|
||||
$rec = $params['recommendationType'] ?? '';
|
||||
$data['chk_rec_proceed'] = ($rec === 'המשך ייצוג') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_consulting'] = ($rec === 'ייעוץ והדרכה חלף ייצוג') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_waiver'] = ($rec === 'ויתור הלקוח') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_replacement'] = ($rec === 'החלפת ייצוג') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_no_contact'] = ($rec === 'לא נוצר קשר') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_no_meeting'] = ($rec === 'לא התקיימה פגישה') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_undecided'] = ($rec === 'עדיין לא ניתן להחליט') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_docs_needed'] = ($rec === 'נדרשים מסמכים נוספים') ? $CHK : $UNCHK;
|
||||
$data['chk_rec_refusal'] = ($rec === 'המלצה לסירוב') ? $CHK : $UNCHK;
|
||||
|
||||
$addAid = $params['additionalAidNeeded'] ?? '';
|
||||
$data['chk_no_additional'] = ($addAid === 'לא נחוץ') ? $CHK : $UNCHK;
|
||||
$data['chk_additional_ni'] = ($addAid === 'נחוץ בתחום ביטוח לאומי') ? $CHK : $UNCHK;
|
||||
$data['chk_additional_other'] = ($addAid === 'נחוץ בתחום אחר') ? $CHK : $UNCHK;
|
||||
|
||||
$addAidUrgency = $params['additionalAidUrgency'] ?? '';
|
||||
$data['chk_add_aid_regular'] = ($addAidUrgency === 'רגיל') ? $CHK : $UNCHK;
|
||||
$data['chk_add_aid_urgent'] = ($addAidUrgency === 'דחוף') ? $CHK : $UNCHK;
|
||||
$data['chk_add_aid_emergency'] = ($addAidUrgency === 'בהול') ? $CHK : $UNCHK;
|
||||
|
||||
$data['chk_willing_to_represent'] = !empty($params['willingToRepresent']) ? $CHK : $UNCHK;
|
||||
}
|
||||
|
||||
private function resolveTemplatePath(): string
|
||||
{
|
||||
$template = $this->entityManager
|
||||
->getRDBRepository('DocumentTemplate')
|
||||
->where(['name' => self::TEMPLATE_NAME])
|
||||
->findOne();
|
||||
|
||||
if ($template) {
|
||||
$templatePath = $template->get('templatePath');
|
||||
if ($templatePath) {
|
||||
// Try as-is (absolute or relative)
|
||||
if (file_exists($templatePath)) {
|
||||
return $templatePath;
|
||||
}
|
||||
|
||||
// Try under data/document-templates/
|
||||
$resolved = 'data/document-templates/' . ltrim($templatePath, '/');
|
||||
if (file_exists($resolved)) {
|
||||
return $resolved;
|
||||
}
|
||||
|
||||
// Download from NetworkStorage (WebDAV)
|
||||
$downloaded = $this->downloadTemplateFromStorage($templatePath);
|
||||
if ($downloaded) {
|
||||
return $downloaded;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Fallback: known locations
|
||||
$fallbackPaths = [
|
||||
'data/document-templates/direct-access-report.docx',
|
||||
'custom/Espo/Modules/LegalAssistance/templates/direct-access-report.docx',
|
||||
];
|
||||
|
||||
foreach ($fallbackPaths as $path) {
|
||||
if (file_exists($path)) {
|
||||
return $path;
|
||||
}
|
||||
}
|
||||
|
||||
throw new Error("Template '" . self::TEMPLATE_NAME . "' not found.");
|
||||
}
|
||||
|
||||
private function downloadTemplateFromStorage(string $templatePath): ?string
|
||||
{
|
||||
try {
|
||||
$nds = $this->injectableFactory->create(
|
||||
\Espo\Modules\NetworkStorageIntegration\Services\NetworkDocumentService::class
|
||||
);
|
||||
$client = $nds->getClient();
|
||||
|
||||
// Try Templates/{templatePath} on the storage
|
||||
$integration = $this->entityManager->getEntityById('Integration', 'NetworkStorage');
|
||||
$templatesFolderPath = 'Templates';
|
||||
if ($integration && $integration->get('enabled')) {
|
||||
$data = (array) ($integration->get('data') ?? []);
|
||||
$templatesFolderPath = $data['templatesFolderPath'] ?? 'Templates';
|
||||
}
|
||||
|
||||
$storagePath = $templatesFolderPath . '/' . $templatePath;
|
||||
|
||||
if (!$client->exists($storagePath)) {
|
||||
$this->log->debug("LegalAssistance: Template not found on storage: {$storagePath}");
|
||||
return null;
|
||||
}
|
||||
|
||||
$content = $client->downloadFile($storagePath);
|
||||
|
||||
// Save locally for this request
|
||||
if (!is_dir(self::TEMP_DIR)) {
|
||||
mkdir(self::TEMP_DIR, 0775, true);
|
||||
}
|
||||
$localPath = self::TEMP_DIR . 'template_' . uniqid() . '.docx';
|
||||
file_put_contents($localPath, $content);
|
||||
|
||||
$this->log->debug("LegalAssistance: Template downloaded from storage: {$storagePath} → {$localPath}");
|
||||
return $localPath;
|
||||
} catch (\Exception $e) {
|
||||
$this->log->warning("LegalAssistance: Failed to download template from storage: " . $e->getMessage());
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
private function processTemplate(string $inputPath, string $outputPath, array $data): void
|
||||
{
|
||||
// Ensure PHPWord autoloader is registered
|
||||
if (!class_exists(TemplateProcessor::class, false)) {
|
||||
$autoloader = 'vendor/phpoffice/phpword/src/PhpWord/Autoloader.php';
|
||||
if (file_exists($autoloader)) {
|
||||
require_once $autoloader;
|
||||
\PhpOffice\PhpWord\Autoloader::register();
|
||||
}
|
||||
}
|
||||
|
||||
$processor = new TemplateProcessor($inputPath);
|
||||
|
||||
foreach ($data as $key => $value) {
|
||||
if ($value === null) {
|
||||
$value = '';
|
||||
}
|
||||
if (is_array($value)) {
|
||||
$value = implode(', ', $value);
|
||||
} elseif (is_bool($value)) {
|
||||
$value = $value ? 'כן' : 'לא';
|
||||
}
|
||||
$processor->setValue($key, (string) $value);
|
||||
}
|
||||
|
||||
$processor->saveAs($outputPath);
|
||||
|
||||
// Fix space preservation: PHPWord strips whitespace from <w:t> elements
|
||||
// that lack xml:space="preserve", causing words to stick together in RTL docs.
|
||||
$zip = new \ZipArchive();
|
||||
if ($zip->open($outputPath) === true) {
|
||||
$xml = $zip->getFromName('word/document.xml');
|
||||
$xml = preg_replace('/<w:t(?=[ >\/])(?![^>]*xml:space)/', '<w:t xml:space="preserve"', $xml);
|
||||
$zip->addFromString('word/document.xml', $xml);
|
||||
$zip->close();
|
||||
}
|
||||
}
|
||||
|
||||
private function normalizeDate(?string $value): ?string
|
||||
{
|
||||
if (!$value) return null;
|
||||
if (preg_match('/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/', $value, $m)) {
|
||||
return "{$m[3]}-{$m[2]}-{$m[1]}";
|
||||
}
|
||||
if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $value)) {
|
||||
return $value;
|
||||
}
|
||||
return $value;
|
||||
}
|
||||
|
||||
private function formatDate(?string $date): string
|
||||
{
|
||||
if (!$date) return '';
|
||||
if (preg_match('/^(\d{4})-(\d{2})-(\d{2})$/', $date, $m)) {
|
||||
return "{$m[3]}.{$m[2]}.{$m[1]}";
|
||||
}
|
||||
return $date;
|
||||
}
|
||||
}
|
||||
-33
@@ -1,33 +0,0 @@
|
||||
<?php
|
||||
|
||||
namespace Espo\Modules\LegalAssistance\SmartAssistant\Tools;
|
||||
|
||||
use Espo\Core\Exceptions\Error;
|
||||
use Espo\Core\InjectableFactory;
|
||||
use Espo\ORM\EntityManager;
|
||||
use Espo\Core\Utils\Log;
|
||||
use Espo\Modules\LegalAssistance\Services\DirectAccessReportService;
|
||||
|
||||
class GenerateInitialReport
|
||||
{
|
||||
public function __construct(
|
||||
private EntityManager $entityManager,
|
||||
private InjectableFactory $injectableFactory,
|
||||
private Log $log
|
||||
) {}
|
||||
|
||||
public function execute(array $params, ?string $caseId, string $userId): array
|
||||
{
|
||||
if (!$caseId) {
|
||||
throw new Error('generate_initial_report requires a case context.');
|
||||
}
|
||||
|
||||
$this->log->info("LegalAssistance: Generating initial report for case {$caseId}");
|
||||
|
||||
$service = $this->injectableFactory->create(DirectAccessReportService::class);
|
||||
|
||||
$result = $service->generateReport($caseId, $userId, $params);
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
+3
-3
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"name": "LegalAssistance",
|
||||
"version": "1.1.0",
|
||||
"version": "2.0.10",
|
||||
"acceptableVersions": [">=8.0.0"],
|
||||
"php": [">=8.1"],
|
||||
"releaseDate": "2026-04-06",
|
||||
"releaseDate": "2026-06-03",
|
||||
"author": "Marcus-Law",
|
||||
"description": "סיוע משפטי — דוח גישה ישירה, משימות אוטומטיות, אינטגרציה עם שירה",
|
||||
"description": "סיוע משפטי — יצירת דוח גישה ישירה (JSON ישירות ל-DOCX), אינטגרציה עם שירה",
|
||||
"scripts": {
|
||||
"afterInstall": "scripts/AfterInstall.php",
|
||||
"afterUninstall": "scripts/AfterUninstall.php"
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"tools": {
|
||||
"generate_initial_report": {
|
||||
"description": "Generate Direct Access initial report (דוח דיווח ראשוני — גישה ישירה). Call ONLY after collecting ALL required data through conversation with the lawyer. This tool creates a DirectAccessReport entity and generates a DOCX document.",
|
||||
"generate_direct_access_report": {
|
||||
"description": "Generate Direct Access report (דוח גישה ישירה) as DOCX and attach to Case. Call ONLY after collecting ALL required data through conversation with the lawyer. This tool generates the DOCX directly and attaches it to the Case as a Document — no intermediate entity is created.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
@@ -67,6 +67,7 @@
|
||||
},
|
||||
"courtName": {
|
||||
"type": "string",
|
||||
"enum": ["בית הדין האזורי לעבודה ירושלים", "בית הדין האזורי לעבודה תל אביב", "בית הדין האזורי לעבודה חיפה", "בית הדין האזורי לעבודה באר שבע", "בית הדין האזורי לעבודה נצרת", "בית הדין הארצי לעבודה"],
|
||||
"description": "בית הדין"
|
||||
},
|
||||
"proceedingSubject": {
|
||||
@@ -108,8 +109,8 @@
|
||||
},
|
||||
"recommendationType": {
|
||||
"type": "string",
|
||||
"enum": ["ייעוץ והדרכה חלף ייצוג", "ויתור הלקוח", "החלפת ייצוג", "לא נוצר קשר", "לא התקיימה פגישה", "עדיין לא ניתן להחליט", "נדרשים מסמכים נוספים", "המלצה לסירוב"],
|
||||
"description": "סוג ההמלצה/ההודעה"
|
||||
"enum": ["המשך ייצוג", "ייעוץ והדרכה חלף ייצוג", "ויתור הלקוח", "החלפת ייצוג", "לא נוצר קשר", "לא התקיימה פגישה", "עדיין לא ניתן להחליט", "נדרשים מסמכים נוספים", "המלצה לסירוב"],
|
||||
"description": "סוג ההמלצה/ההודעה — בחר ׳המשך ייצוג׳ כשמומלץ להגיש ערעור או להמשיך בייצוג"
|
||||
},
|
||||
"recommendationDetail": {
|
||||
"type": "string",
|
||||
|
||||
+21
-43
@@ -2,9 +2,11 @@
|
||||
/************************************************************************
|
||||
* LegalAssistance Extension — AfterInstall
|
||||
*
|
||||
* 1. Deploy plugin files to ai-gateway plugins/ directory
|
||||
* 2. Create DocumentTemplate for the direct access report
|
||||
* 3. Clear cache
|
||||
* 1. Create DocumentTemplate for the direct access report
|
||||
* 2. Clear cache
|
||||
*
|
||||
* Note: ai-gateway plugin deployment removed — legal tools are now
|
||||
* built into shira-hermes (api/services/legal_tools.py) since Phase 3.
|
||||
************************************************************************/
|
||||
|
||||
use Espo\Core\Container;
|
||||
@@ -24,13 +26,14 @@ class AfterInstall
|
||||
|
||||
$log->info('LegalAssistance: Running AfterInstall...');
|
||||
|
||||
// 1. Deploy ai-gateway plugin files
|
||||
$this->deployPluginFiles($log);
|
||||
// 0. Ensure custom i18n directories exist for all supported locales
|
||||
$config = $container->getByClass(Config::class);
|
||||
$this->ensureI18nDirectories($config, $log);
|
||||
|
||||
// 2. Create DocumentTemplate
|
||||
// 1. Create DocumentTemplate
|
||||
$this->createDocumentTemplate($entityManager, $log);
|
||||
|
||||
// 3. Clear cache
|
||||
// 2. Clear cache
|
||||
try {
|
||||
$dataManager = $container->getByClass(DataManager::class);
|
||||
$dataManager->clearCache();
|
||||
@@ -42,50 +45,25 @@ class AfterInstall
|
||||
$log->info('LegalAssistance: AfterInstall completed.');
|
||||
}
|
||||
|
||||
private function deployPluginFiles(Log $log): void
|
||||
private function ensureI18nDirectories(Config $config, Log $log): void
|
||||
{
|
||||
// Source: extension's plugins/ directory (relative to EspoCRM root after install)
|
||||
$sourceDir = 'custom/Espo/Modules/LegalAssistance/../../../../../../plugins/legal-assistance';
|
||||
$basePath = 'custom/Espo/Custom/Resources/i18n';
|
||||
|
||||
// Try common ai-gateway locations
|
||||
$gatewayPaths = [
|
||||
'/home/chaim/ai-gateway/plugins/legal-assistance',
|
||||
'/opt/ai-gateway/plugins/legal-assistance',
|
||||
];
|
||||
$language = $config->get('language', 'en_US');
|
||||
|
||||
// Find actual source files within the extension package
|
||||
$extPluginDir = __DIR__ . '/../plugins/legal-assistance';
|
||||
$locales = array_unique(['en_US', 'fa_IR', 'he_IL', $language]);
|
||||
|
||||
if (!is_dir($extPluginDir)) {
|
||||
$log->warning("LegalAssistance: Plugin source directory not found at {$extPluginDir}");
|
||||
return;
|
||||
}
|
||||
foreach ($locales as $locale) {
|
||||
$dir = $basePath . '/' . $locale;
|
||||
|
||||
foreach ($gatewayPaths as $targetDir) {
|
||||
$parentDir = dirname($targetDir);
|
||||
if (!is_dir($parentDir)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!is_dir($targetDir)) {
|
||||
mkdir($targetDir, 0755, true);
|
||||
}
|
||||
|
||||
$files = ['tools.json', 'prompts.json'];
|
||||
foreach ($files as $file) {
|
||||
$src = $extPluginDir . '/' . $file;
|
||||
$dst = $targetDir . '/' . $file;
|
||||
if (file_exists($src)) {
|
||||
copy($src, $dst);
|
||||
$log->info("LegalAssistance: Deployed {$file} to {$targetDir}");
|
||||
if (!is_dir($dir)) {
|
||||
if (mkdir($dir, 0775, true)) {
|
||||
$log->info("LegalAssistance: Created i18n directory: {$dir}");
|
||||
} else {
|
||||
$log->warning("LegalAssistance: Failed to create i18n directory: {$dir}");
|
||||
}
|
||||
}
|
||||
|
||||
$log->info("LegalAssistance: Plugin files deployed to {$targetDir}");
|
||||
return;
|
||||
}
|
||||
|
||||
$log->warning('LegalAssistance: Could not find ai-gateway plugins directory. Deploy manually.');
|
||||
}
|
||||
|
||||
private function createDocumentTemplate(EntityManager $entityManager, Log $log): void
|
||||
|
||||
+121
-20
@@ -2,12 +2,18 @@
|
||||
/************************************************************************
|
||||
* LegalAssistance Extension — AfterUninstall
|
||||
*
|
||||
* 1. Remove plugin files from ai-gateway
|
||||
* 2. Clear cache
|
||||
* 1. Drop LegalAid and DirectAccessReport DB tables (with warning log)
|
||||
* 2. Remove LegalAssistance-specific columns from Case table
|
||||
* 3. Remove DocumentTemplate records created by this extension
|
||||
* 4. Clear cache
|
||||
*
|
||||
* Note: ai-gateway plugin cleanup removed — legal tools are now
|
||||
* built into shira-hermes since Phase 3.
|
||||
************************************************************************/
|
||||
|
||||
use Espo\Core\Container;
|
||||
use Espo\Core\DataManager;
|
||||
use Espo\Core\ORM\EntityManager;
|
||||
use Espo\Core\Utils\Log;
|
||||
|
||||
class AfterUninstall
|
||||
@@ -16,36 +22,131 @@ class AfterUninstall
|
||||
{
|
||||
/** @var Log $log */
|
||||
$log = $container->getByClass(Log::class);
|
||||
/** @var EntityManager $entityManager */
|
||||
$entityManager = $container->getByClass(EntityManager::class);
|
||||
|
||||
$log->info('LegalAssistance: Running AfterUninstall...');
|
||||
|
||||
// Remove ai-gateway plugin files
|
||||
$gatewayPaths = [
|
||||
'/home/chaim/ai-gateway/plugins/legal-assistance',
|
||||
'/opt/ai-gateway/plugins/legal-assistance',
|
||||
];
|
||||
// 1. Drop tables created by this extension
|
||||
$this->dropTables($entityManager, $log);
|
||||
|
||||
foreach ($gatewayPaths as $dir) {
|
||||
if (is_dir($dir)) {
|
||||
$files = glob($dir . '/*');
|
||||
foreach ($files as $file) {
|
||||
if (is_file($file)) {
|
||||
unlink($file);
|
||||
}
|
||||
}
|
||||
rmdir($dir);
|
||||
$log->info("LegalAssistance: Removed plugin files from {$dir}");
|
||||
}
|
||||
}
|
||||
// 2. Remove LegalAssistance-specific columns from Case
|
||||
$this->cleanCaseColumns($entityManager, $log);
|
||||
|
||||
// Clear cache
|
||||
// 3. Remove DocumentTemplate records
|
||||
$this->removeDocumentTemplates($entityManager, $log);
|
||||
|
||||
// 4. Remove custom i18n files
|
||||
$this->removeCustomI18n($log);
|
||||
|
||||
// 5. Clear cache
|
||||
try {
|
||||
$dataManager = $container->getByClass(DataManager::class);
|
||||
$dataManager->clearCache();
|
||||
$log->info('LegalAssistance: Cache cleared.');
|
||||
} catch (\Throwable $e) {
|
||||
$log->warning('LegalAssistance: Cache clear failed: ' . $e->getMessage());
|
||||
}
|
||||
|
||||
$log->info('LegalAssistance: AfterUninstall completed.');
|
||||
}
|
||||
|
||||
private function dropTables(EntityManager $entityManager, Log $log): void
|
||||
{
|
||||
$pdo = $entityManager->getPDO();
|
||||
|
||||
$tables = ['legal_aid', 'direct_access_report'];
|
||||
|
||||
foreach ($tables as $table) {
|
||||
try {
|
||||
$check = $pdo->query("SHOW TABLES LIKE '{$table}'")->rowCount();
|
||||
if ($check > 0) {
|
||||
$count = $pdo->query("SELECT COUNT(*) FROM `{$table}`")->fetchColumn();
|
||||
$log->warning("LegalAssistance: Dropping table '{$table}' ({$count} rows).");
|
||||
$pdo->exec("DROP TABLE `{$table}`");
|
||||
$log->info("LegalAssistance: Table '{$table}' dropped.");
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
$log->warning("LegalAssistance: Failed to drop table '{$table}': " . $e->getMessage());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private function cleanCaseColumns(EntityManager $entityManager, Log $log): void
|
||||
{
|
||||
$pdo = $entityManager->getPDO();
|
||||
|
||||
// Only columns that LegalAssistance module added to Case
|
||||
$columns = [
|
||||
'c_legal_aid_type',
|
||||
'c_aid_type',
|
||||
'c_urgency_level',
|
||||
'c_appointment_date',
|
||||
'c_filing_deadline',
|
||||
];
|
||||
|
||||
try {
|
||||
$stmt = $pdo->query("SHOW COLUMNS FROM `case`");
|
||||
$existing = array_column($stmt->fetchAll(\PDO::FETCH_ASSOC), 'Field');
|
||||
|
||||
foreach ($columns as $col) {
|
||||
if (in_array($col, $existing)) {
|
||||
$pdo->exec("ALTER TABLE `case` DROP COLUMN `{$col}`");
|
||||
$log->info("LegalAssistance: Dropped column case.{$col}");
|
||||
}
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
$log->warning("LegalAssistance: Failed to clean Case columns: " . $e->getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
private function removeDocumentTemplates(EntityManager $entityManager, Log $log): void
|
||||
{
|
||||
try {
|
||||
$template = $entityManager
|
||||
->getRDBRepository('DocumentTemplate')
|
||||
->where(['name' => 'דוח גישה ישירה'])
|
||||
->findOne();
|
||||
|
||||
if ($template) {
|
||||
$fileId = $template->get('fileId');
|
||||
$entityManager->removeEntity($template);
|
||||
$log->info("LegalAssistance: Removed DocumentTemplate 'דוח גישה ישירה'");
|
||||
|
||||
// Remove the attachment file
|
||||
if ($fileId) {
|
||||
$attachment = $entityManager->getEntityById('Attachment', $fileId);
|
||||
if ($attachment) {
|
||||
$filePath = 'data/upload/' . $fileId;
|
||||
if (file_exists($filePath)) {
|
||||
unlink($filePath);
|
||||
}
|
||||
$entityManager->removeEntity($attachment);
|
||||
$log->info("LegalAssistance: Removed template attachment file");
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
$log->warning("LegalAssistance: Failed to remove DocumentTemplate: " . $e->getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
private function removeCustomI18n(Log $log): void
|
||||
{
|
||||
$files = [
|
||||
'custom/Espo/Custom/Resources/i18n/fa_IR/DirectAccessReport.json',
|
||||
'custom/Espo/Custom/Resources/i18n/fa_IR/LegalAid.json',
|
||||
'custom/Espo/Custom/Resources/i18n/he_IL/DirectAccessReport.json',
|
||||
'custom/Espo/Custom/Resources/i18n/he_IL/LegalAid.json',
|
||||
'custom/Espo/Custom/Resources/i18n/en_US/DirectAccessReport.json',
|
||||
'custom/Espo/Custom/Resources/i18n/en_US/LegalAid.json',
|
||||
];
|
||||
|
||||
foreach ($files as $file) {
|
||||
if (file_exists($file)) {
|
||||
unlink($file);
|
||||
$log->info("LegalAssistance: Removed {$file}");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Binary file not shown.
Reference in New Issue
Block a user