How beingfaisal/car-showroom-management-system works
Purpose and Runtime
This is a Windows desktop Car Showroom Management System. It is a C# WinForms application targeting .NET Framework 4.7.2, built from CSM Project.sln and CSM Project/CSM Project.csproj. The deployed executable is CSM Project/bin/Release/CSM Project.exe.
Application Entry and Shell
Startup is defined by CSM Project/Program.cs, which launches the WinForms UI. CSM Project/Form1.cs is likely the initial sign-in form, based on compiled resource naming (LogInForm) and the README. Navigation is form-to-form rather than through a web/API layer.
Role-Based Workflow Boundary
The application distinguishes manager and salesman experiences. Compiled resource names identify manager, salesman, and login screens; the corresponding source is represented by the numbered WinForms forms:
• CSM Project/Form1.cs
• CSM Project/Form2.cs
• CSM Project/Form3.cs
• CSM Project/Form4.cs
Authentication determines which menu/control flow the user enters. The database must contain an initial manager account; managers subsequently administer employees.
Showroom Operations UI
Business operations are implemented directly in WinForms code-behind plus generated layout/resource files. The form set provides the primary functional modules for employee management, car management, and vehicle sales:
• CSM Project/Form5.cs
• CSM Project/Form6.cs
• CSM Project/Form7.cs
• CSM Project/Form8.cs
• CSM Project/Form9.cs
• CSM Project/Form10.cs
The absence of separate domain/service/data-access directories indicates that UI event handlers likely own validation, navigation, and SQL interaction.
Data Layer and Database Contract
SQL Server is the external persistence service. CSM Schema.sql is the authoritative database bootstrap contract and must be run before the application is connected. A typed ADO.NET dataset is included:
• CSM Project/CSMDataSet.xsd
• CSM Project/CSMDataSet.Designer.cs
Connection configuration is expected at the application boundary in CSM Project/App.config; local generated settings are under CSM Project/Properties/Settings.settings. Core flow is: user action in a form → direct database read/write via the connected application → refreshed UI/state.
Presentation and Shared UI Elements
Each form follows WinForms partial-class separation: behavior in .cs, generated controls/layout in .Designer.cs, and localized/embedded assets in .resx, for example CSM Project/Form1.Designer.cs and CSM Project/Form1.resx. Shared dialog and visual components include:
• CSM Project/CustomMsgBox.cs
• CSM Project/CustomSuccessBox.cs
• CSM Project/CircularPictureBox.cs
• CSM Project/LockBitmap.cs
These form the common feedback and image-rendering boundary used by operational screens.
Build Artifacts and Infrastructure
The application runs locally on Windows with the .NET Framework runtime and a reachable SQL Server instance. Build outputs are committed under CSM Project/bin/Debug and CSM Project/bin/Release; intermediate output is under CSM Project/obj. No server-side application, HTTP interface, cloud infrastructure, or test project is represented in the repository tree.
Main entry points: Form1.cs Sign-in form · Form5.cs Showroom operations forms · CSM Project.csproj WinForms project · App.config Connection configuration
Components 15
WinForms Desktop App
- CSM Project solution
CSM Project.sln - WinForms project
CSM Project/CSM Project.csproj - Application startup
CSM Project/Program.cs - Sign-in form · Authenticates users and selects a role workflow.
CSM Project/Form1.cs - Manager and salesman screens · Role-specific menus and control flow.
CSM Project/Form2.cs - Showroom operations forms · Employee, car, and vehicle-sales workflows execute in form event handlers.
CSM Project/Form5.cs - Generated form layout and assets
CSM Project/Form1.Designer.cs - Shared feedback and image UI
CSM Project/CustomMsgBox.cs
Data & Persistence
- Connection configuration
CSM Project/App.config - Generated settings
CSM Project/Properties/Settings.settings - Typed ADO.NET dataset
CSM Project/CSMDataSet.xsd - Database bootstrap schema · Must be applied before the application connects.
CSM Schema.sql - SQL Server · Stores accounts, employees, cars, and sales data.
Runtime Platform
- Windows .NET Framework
- Release executable
CSM Project/bin/Release/CSM Project.exe
Connections 16
- CSM Project solution → WinForms project: builds
- WinForms project → Application startup: contains
- WinForms project → Release executable: produces
- Windows .NET Framework → Release executable: runs
- Application startup → Sign-in form: launches
- Sign-in form → Manager and salesman screens: routes by role
- Manager and salesman screens → Showroom operations forms: opens workflows
- Sign-in form → Generated form layout and assets: uses layout and resources
- Showroom operations forms → Generated form layout and assets: uses generated controls
- Showroom operations forms → Shared feedback and image UI: shows feedback and images
- Connection configuration → Generated settings: loads settings
- Connection configuration → SQL Server: configures connection
- Typed ADO.NET dataset → SQL Server: maps database data
- Sign-in form → SQL Server: authenticates against
- Showroom operations forms → SQL Server: direct reads and writes
- Database bootstrap schema → SQL Server: bootstraps