# lunar-studio-dev/travelkar-holidays architecture

> Architecture diagram of the GitHub repository lunar-studio-dev/travelkar-holidays, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lunar-studio-dev/travelkar-holidays
- Repository: https://github.com/lunar-studio-dev/travelkar-holidays

## Overview

TRAVELKARS is a planning-document set for a travel-operations product, not a built application. Its principal workflow is to gather and lock requirements through grilling, record canonical terminology and rules, then describe real client/staff work in the user flow before producing a developer requirements document. The README also identifies planned capabilities such as tour planning, quotations, trip pieces, paper pooling, and money tracking; their details are not available in the supplied excerpts. No runtime components or calls can be established.

Main entry points: [`docs/product-spec.md`](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/product-spec.md) (Locked product rules), [`docs/grilling/convo2.md`](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo2.md) (Second grilling), [`docs/user-flow.md`](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/user-flow.md) (User flow), [`docs/grilling/convo1.md`](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo1.md) (First grilling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Planning inputs"]
  node_convo1["First grilling<br/>[convo1.md]"]
  node_convo2["Second grilling<br/>[convo2.md]"]
end

subgraph group_specification["Product definition"]
  node_context["Canonical glossary<br/>[CONTEXT.md]"]
  node_spec["Locked product rules<br/>[product-spec.md]"]
end

subgraph group_workflow["Workflows"]
  node_flow["User flow<br/>[user-flow.md]"]
  node_developer_requirements["Developer requirements"]
end

node_builders(("Builders and agents"))
node_client_staff(("Client and staff"))

node_convo1 -->|"continues grilling"| node_convo2
node_convo2 -->|"informs rules"| node_spec
node_builders -->|"uses glossary"| node_context
node_builders -->|"uses rules"| node_spec
node_client_staff -->|"uses workflow"| node_flow
node_spec -->|"feeds requirements"| node_developer_requirements
node_flow -->|"feeds requirements"| node_developer_requirements

click node_convo1 "https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo1.md"
click node_convo2 "https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo2.md"
click node_context "https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/CONTEXT.md"
click node_spec "https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/product-spec.md"
click node_flow "https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/user-flow.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_convo1,node_convo2,node_client_staff toneBlue
class node_context,node_spec toneAmber
class node_flow,node_developer_requirements toneMint
class node_builders toneIndigo
```

## Components

### Planning inputs

- [First grilling](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo1.md): `docs/grilling/convo1.md`
- [Second grilling](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/grilling/convo2.md): `docs/grilling/convo2.md`

### Product definition

- [Canonical glossary](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/CONTEXT.md): `CONTEXT.md`
- [Locked product rules](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/product-spec.md): `docs/product-spec.md`

### Workflows

- [User flow](https://github.com/lunar-studio-dev/travelkar-holidays/blob/main/docs/user-flow.md): `docs/user-flow.md`
- **Developer requirements**

### Other components

- **Builders and agents**
- **Client and staff**

## Connections

- First grilling → Second grilling: continues grilling
- Second grilling → Locked product rules: informs rules
- Builders and agents → Canonical glossary: uses glossary
- Builders and agents → Locked product rules: uses rules
- Client and staff → User flow: uses workflow
- Locked product rules → Developer requirements: feeds requirements
- User flow → Developer requirements: feeds requirements
