# wys9853/parking-lot-management-system-based-on-c-language architecture

> Architecture diagram of the GitHub repository wys9853/parking-lot-management-system-based-on-c-language, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wys9853/parking-lot-management-system-based-on-c-language
- Repository: https://github.com/wys9853/parking-lot-management-system-based-on-c-language

## Overview

##### Project type and purpose
- This is a console-based, C-language simulation of a parking-lot management system.
- Its primary purpose is educational: to implement and demonstrate linear data structures (queues, stacks or arrays) by simulating car entry, exit, waiting, and status-query operations.

##### File structure
- Top-level files:
- main.c – program entry point, user-interaction loop and menu.
- park.c / park.h – core parking lot logic: data structures, enqueue/dequeue operations, car lookup, “make way” algorithm.
- image/ – screenshot assets (UI preview), no runtime role.
- README.md – project overview, functional modules, usage examples.
- No external libraries or separate layers like “frontend/backend” – it’s a single-process console app.

##### README for additional insights
- Four major functional modules:
1) UI prompts & input handling
2) Car entry management
3) Car exit (including the “make way” logic)
4) Status inquiry (display parking and sidewalk)
- Data structures:
- Parking lot: fixed-size array or stack to model the narrow passage.
- Sidewalk queue: ordered array or queue for waiting cars.
- No persistence; all state in memory.

## Diagram (Mermaid)

```mermaid
flowchart TD
    UI["User Interface<br/>(main.c)"]:::module
    Entry["Entry Manager<br/>(park_car(), enqueue_to_sidewalk())"]:::module
    Exit["Exit Manager<br/>(remove_car(), make_way(), dequeue_from_sidewalk())"]:::module
    Parking["Parking-Lot Data Structure<br/>(stack/array)"]:::datastruct
    Sidewalk["Sidewalk Queue<br/>(queue)"]:::datastruct
    Docs["Project Documentation<br/>(README.md)"]:::external
    Images["Image Assets<br/>(image/)"]:::external

    UI -->|"invoke park_car()"| Entry
    UI -->|"invoke remove_car() / make_way()"| Exit
    UI -->|"status query"| Parking
    UI -->|"status query"| Sidewalk

    Entry -->|"push if space"| Parking
    Entry -->|"if full → enqueue"| Sidewalk

    Exit -->|"pop/move cars"| Parking
    Exit -->|"dequeue when space"| Sidewalk
    Exit -.->|"temporary pop during make_way"| Parking
    Exit -.->|"re-push cars"| Parking

    UI --> Docs
    UI --> Images

    click UI "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/main.c"
    click Entry "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.c"
    click Entry "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.h"
    click Exit "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.c"
    click Exit "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.h"
    click Parking "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.c"
    click Parking "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.h"
    click Sidewalk "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.c"
    click Sidewalk "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/park.h"
    click Docs "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/blob/master/README.md"
    click Images "https://github.com/wys9853/parking-lot-management-system-based-on-c-language/tree/master/image/"

    classDef module fill:#D6E9FF,stroke:#3399FF,color:#000;
    classDef datastruct fill:#DFFFE0,stroke:#33AA33,color:#000;
    classDef external fill:#F0F0F0,stroke:#888888,color:#444;
```
