📚 Asset Valuer Pro Technical Documentation Index
⚠️ Important Note:
This repository contains only the technical documentation for Asset Valuer Pro. The source code is maintained in a separate repository and is not included in this documentation repository.
🏗️ Overview
This index serves as a central navigation point for all technical documentation related to the Asset Valuer Pro (AVP) system. Documentation is organized by category to help developers, business analysts, and project stakeholders quickly find relevant information.
📋 Getting Started
- README - Introduction to the documentation repository
- Business Technical Overview - High-level overview of the system
- Technology Stack - Technical components and frameworks used
- Repository Structure - Organization of the source code
- Handoff Guide - Guide for new team members
🏗️ System Architecture
Core Architecture
- Repository Structure - Source code organization
- Business Technical Map - Business processes to technical components mapping
Specialized Components
- Mobile Data Collection - Mobile data collection implementation
- Report Business Technical Map - Reporting system components
🔧 Component Documentation
API Controllers
- API Controllers Inventory - List of all API controllers
- AssetController - Asset management endpoints
- ComponentController - Component management endpoints
- ImportController - Data import/export endpoints
- JobController - Job management endpoints
- ReportsController - Report generation endpoints
Data Models
- Models Inventory - List of all data models
- Asset - Asset model documentation
- Component - Component model documentation
- Job - Job model documentation
- ValuationProfile - Valuation profile model documentation
Business Logic Services
- Services Inventory - List of all business logic services
- ReportingServices - Report generation services
- ValuationServices - Valuation calculation services
- ImportExportServices - Data import/export services
Report Generators
- Reports Inventory - List of all report generators
- GeneralValuationReport - General valuation report documentation
- InsuranceValuationReport - Insurance valuation report documentation
- RenewalCostReport - Renewal cost report documentation
📋 Process Workflows
- Valuation Process Workflow - End-to-end valuation process
- Field Data Collection Workflow - Field data collection process
- Reporting Process Workflow - Report generation process
📊 Data Dictionaries
- Asset Fields Dictionary - Asset field definitions and usage
- Valuation Fields Dictionary - Valuation field definitions and usage
🔧 Developer Guidelines
- Emoji Reference - Emoji usage guidance in documentation
- Version Notes Guidelines - Version differences documentation
📝 Enhancement Plans
- Documentation Enhancement Plan - Ongoing documentation improvements
📋 Quick Reference Guides
Version Differences
- V2 to V3 Migration - Key differences between Version 2 and Version 3
Common Workflows
| Workflow | Documentation | Related API | Models |
|---|---|---|---|
| Create New Asset | Valuation Process | AssetController | Asset |
| Import Asset Register | Valuation Process | ImportController | Asset |
| Run Field Collection | Field Data Collection | ContentController | Asset, Note |
| Generate Reports | Reporting Process | ReportsController | AssetValuation |
📋 Documentation Standards
All documentation in this repository follows these standards:
- Uses Markdown format with standardized emoji prefixes
- Includes both technical implementation details and business context
- Cross-references related documentation for easier navigation
- Distinguishes between Version 2 and Version 3 features where applicable
- Provides code examples for key technical concepts
📋 Maintenance and Updates
This documentation is a living resource that requires regular updates:
- New components should be added to relevant inventory documents
- Process changes should be reflected in workflow documentation
- Version differences should be clearly noted in affected documents
- The Documentation Enhancement Plan tracks documentation improvement tasks
📋 Contributing
To contribute to this documentation:
- Follow the emoji usage guidelines in Emoji Reference
- Maintain consistent formatting with existing documents
- Cross-reference related documentation where appropriate
- Update the relevant inventory documents for new components
- Keep the Documentation Index updated with new documents