# dzungluong/lab-agile-planning architecture

> Architecture diagram of the GitHub repository dzungluong/lab-agile-planning, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dzungluong/lab-agile-planning
- Repository: https://github.com/dzungluong/lab-agile-planning

## Overview

##### Project type and purpose
- This repository is not a full-stack application or library but an educational “lab” for practicing agile planning.
- The README (“lab-agile-planning”) and presence of a single ISSUE_TEMPLATE (user-story.md) indicate that the repo’s sole purpose is to guide students through agile planning exercises using GitHub’s issue system.

##### File structure
- Top level:
- .github/ISSUE_TEMPLATE/user-story.md – a template for writing user stories.
- README.md – an introduction and instructions for the lab.
- There are no src/, frontend/, backend/, or test directories, confirming this is purely a documentation/workflow exercise.

##### README for additional insights
- It simply states: “This repository contains the lab for agile planning.”
- No code, no build or deploy scripts, no external dependencies—just process artifacts.

##### Elements
- Clear labels:
- Student
- GitHub Repo
- User-Story Template
- Instructor/TA
- Backlog / Issues
- Clone → Local editing → Commit → Push → Open Issue
- Instructor review → Comment/Label → Close
- Artifacts (templates, issues) in another
- Tools (GitHub platform) in a distinct style

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Student Workflow"
        Student["Student"]:::actor
        README["README.md"]:::artifact
        Clone["Clone Repository"]:::action
        Template["User-Story Template"]:::artifact
        Edit["Draft User Stories"]:::action
        Commit["Commit & Push Changes"]:::action
    end

    subgraph "GitHub Platform"
        Repo["lab-agile-planning Repository"]:::tool
        Issues["Backlog / Issues"]:::artifact
    end

    subgraph "Instructor Workflow"
        Instructor["Instructor/TA"]:::actor
        Review["Review Issues"]:::action
        Comment["Add Labels/Comments"]:::action
        Approve["Close/Approve Issue"]:::action
    end

    Student -->|"reads"| README
    Student -->|"clones"| Repo
    Repo -->|"contains"| Template
    Clone --> Student
    Student -->|"uses template"| Template
    Student -->|"drafts stories"| Edit
    Edit --> Commit
    Commit -->|"pushes to"| Repo
    Commit -->|"opens issue"| Issues
    Issues --> Review
    Instructor --> Review
    Review --> Comment
    Comment --> Approve
    Approve -->|"updates status in"| Issues

    click Repo "https://github.com/dzungluong/lab-agile-planning/tree/main//"
    click README "https://github.com/dzungluong/lab-agile-planning/blob/main/README.md"
    click Template "https://github.com/dzungluong/lab-agile-planning/blob/main/.github/ISSUE_TEMPLATE/user-story.md"

    classDef actor fill:#f9f,stroke:#333,stroke-width:1px
    classDef artifact fill:#ff9,stroke:#333,stroke-width:1px
    classDef tool fill:#9ff,stroke:#333,stroke-width:1px
    classDef action fill:#9f9,stroke:#333,stroke-width:1px
```
