How soheyb-roukas/topographix works
Project Type and Purpose
• Topographix is a single-process Windows desktop application built in Delphi (Pascal) with the VCL framework.
• Its goal is to match 3D coordinate points to axis profiles, compute distances, and show the results in an ordered list.
File Structure
• Top-level files:
• Topographix.dpr / .dproj – your main Delphi project.
• Unit1.pas/.dfm and Unit2.pas/.dfm – VCL forms handling the user interface and user interactions.
• “Test Assets” folder – sample input files (text data).
README for Extra Clues
• It calls out key features (coordinate matching, distance calculations, neat outputs) and warns about locale decimal settings.
• Technologies: Pascal, VCL, Windows 32/64-bit. No external web services or microservices—just a local, monolithic app.
a. Main Components
• User Interface Layer (VCL Forms)
• Domain Logic Layer (coordinate matching + distance computation)
• Data Access Layer (file readers for axis profiles and point lists)
• Windows OS & File System (external environment)
b. Relationships & Data Flow
1. User enters or loads point data via the UI.
2. UI calls into the Domain Logic to match coordinates and calculate distances.
3. Domain Logic reads axis definitions and point files from disk (using the Data Access layer).
4. Domain Logic returns an ordered list of results back to the UI.
5. UI renders the list for the user.
c. Architectural Patterns
• Layered / “Onion” style: Presentation → Business Logic → Data Access
• Monolithic, event-driven desktop app
d. Key Technologies
• Delphi Pascal units (Unit1.pas, Unit2.pas)
• VCL Forms (.dfm) for UI components
• Windows API / File I/O
• Localization concern (decimal separator)