# zikirullo/nestar architecture

> Architecture diagram of the GitHub repository zikirullo/nestar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zikirullo/nestar
- Repository: https://github.com/zikirullo/nestar

## Overview

Nestar is a NestJS property-marketplace API with a companion batch process. The apparent user workflow is GraphQL access to member, property, article, and social features, backed by MongoDB models; batch jobs recalculate property and agent rankings. The README is only a generic Nest starter and documents no product capabilities. Resolver-to-service wiring and the precise database setup are not evidenced in the sampled material, so those links are omitted or marked unverified.

Main entry points: [`apps/nestar-api/src/components/member/member.service.ts`](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/member/member.service.ts) (Member accounts), [`apps/nestar-api/src/app.resolver.ts`](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/app.resolver.ts) (GraphQL resolver), [`apps/nestar-api/src/components/property/property.service.ts`](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/property/property.service.ts) (Property listings), [`apps/nestar-api/src/components/board-article/board-article.service.ts`](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/board-article/board-article.service.ts) (Board articles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_graphql["GraphQL resolver<br/>[app.resolver.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_contracts["GraphQL data contracts"]
  node_batch_controller["Batch controller"]
end

subgraph group_market["Marketplace"]
  node_properties["Property listings"]
  node_views["View history<br/>[view.service.ts]"]
  node_batch_service["Ranking jobs<br/>[batch.service.ts]"]
end

subgraph group_community["Community"]
  node_members["Member accounts<br/>[member.service.ts]"]
  node_articles["Board articles"]
  node_comments["Comments<br/>[comment.service.ts]"]
  node_follows["Member follows<br/>[follow.service.ts]"]
  node_likes["Likes and favorites<br/>[likes.service.ts]"]
end

subgraph group_runtime["Runtime and persistence"]
  node_shared["Shared query helpers<br/>[config.ts]"]
  node_api_db[("API MongoDB models")]
  node_batch_db[("Batch MongoDB models<br/>[database.module.ts]")]
end

node_user(("Marketplace client"))

node_user -.->|"queries and mutations"| node_graphql
node_graphql -.->|"dispatches to"| node_auth
node_graphql -.->|"dispatches to"| node_members
node_graphql -.->|"dispatches to"| node_properties
node_graphql -.->|"dispatches to"| node_articles
node_graphql -.->|"dispatches to"| node_comments
node_graphql -.->|"dispatches to"| node_follows
node_auth -->|"authenticates"| node_members
node_members -->|"records profile views"| node_views
node_members -->|"toggles member likes"| node_likes
node_properties -->|"updates member stats"| node_members
node_properties -->|"gets visited properties"| node_views
node_properties -->|"gets favorites"| node_likes
node_articles -->|"updates member stats"| node_members
node_articles -->|"uses view service"| node_views
node_articles -->|"uses like service"| node_likes
node_comments -->|"uses member service"| node_members
node_comments -->|"uses property service"| node_properties
node_comments -->|"uses article service"| node_articles
node_members -->|"reads follow data"| node_follows
node_properties -->|"uses query helpers"| node_shared
node_articles -->|"uses query helpers"| node_shared
node_likes -->|"uses aggregation helper"| node_shared
node_views -->|"uses aggregation helper"| node_shared
node_properties -->|"reads and writes"| node_api_db
node_articles -->|"reads and writes"| node_api_db
node_members -->|"reads and writes"| node_api_db
node_likes -->|"reads and writes"| node_api_db
node_views -->|"reads and writes"| node_api_db
node_batch_controller -->|"invokes jobs"| node_batch_service
node_batch_service -->|"updates rankings"| node_batch_db

click node_graphql "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/app.resolver.ts"
click node_auth "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/auth/auth.service.ts"
click node_members "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/member/member.service.ts"
click node_properties "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/property/property.service.ts"
click node_articles "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/board-article/board-article.service.ts"
click node_comments "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/comment/comment.service.ts"
click node_follows "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/follow/follow.service.ts"
click node_likes "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/likes/likes.service.ts"
click node_views "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/views/view.service.ts"
click node_contracts "https://github.com/zikirullo/nestar/tree/develop/apps/nestar-api/src/libs/dto"
click node_shared "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/libs/config.ts"
click node_api_db "https://github.com/zikirullo/nestar/tree/develop/apps/nestar-api/src/schemas"
click node_batch_controller "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/batch.controller.ts"
click node_batch_service "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/batch.service.ts"
click node_batch_db "https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/database/database.module.ts"

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_graphql,node_auth,node_contracts,node_batch_controller,node_user toneBlue
class node_properties,node_views,node_batch_service toneAmber
class node_members,node_articles,node_comments,node_follows,node_likes toneMint
class node_shared,node_api_db,node_batch_db toneRose
```

## Components

### API surface

- [GraphQL resolver](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/app.resolver.ts): `apps/nestar-api/src/app.resolver.ts`
- [Authentication](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/auth/auth.service.ts): `apps/nestar-api/src/components/auth/auth.service.ts`
- [GraphQL data contracts](https://github.com/zikirullo/nestar/tree/develop/apps/nestar-api/src/libs/dto): `apps/nestar-api/src/libs/dto`
- [Batch controller](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/batch.controller.ts): `apps/nestar-batch/src/batch.controller.ts`

### Marketplace

- [Property listings](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/property/property.service.ts): `apps/nestar-api/src/components/property/property.service.ts`
- [View history](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/views/view.service.ts): `apps/nestar-api/src/components/views/view.service.ts`
- [Ranking jobs](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/batch.service.ts): `apps/nestar-batch/src/batch.service.ts`

### Community

- [Member accounts](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/member/member.service.ts): `apps/nestar-api/src/components/member/member.service.ts`
- [Board articles](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/board-article/board-article.service.ts): `apps/nestar-api/src/components/board-article/board-article.service.ts`
- [Comments](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/comment/comment.service.ts): `apps/nestar-api/src/components/comment/comment.service.ts`
- [Member follows](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/follow/follow.service.ts): `apps/nestar-api/src/components/follow/follow.service.ts`
- [Likes and favorites](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/components/likes/likes.service.ts): `apps/nestar-api/src/components/likes/likes.service.ts`

### Runtime and persistence

- [Shared query helpers](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-api/src/libs/config.ts): `apps/nestar-api/src/libs/config.ts`
- [API MongoDB models](https://github.com/zikirullo/nestar/tree/develop/apps/nestar-api/src/schemas): `apps/nestar-api/src/schemas`
- [Batch MongoDB models](https://github.com/zikirullo/nestar/blob/develop/apps/nestar-batch/src/database/database.module.ts): `apps/nestar-batch/src/database/database.module.ts`

### Other components

- **Marketplace client**

## Connections

- Marketplace client → GraphQL resolver: queries and mutations
- GraphQL resolver → Authentication: dispatches to
- GraphQL resolver → Member accounts: dispatches to
- GraphQL resolver → Property listings: dispatches to
- GraphQL resolver → Board articles: dispatches to
- GraphQL resolver → Comments: dispatches to
- GraphQL resolver → Member follows: dispatches to
- Authentication → Member accounts: authenticates (evidence: `apps/nestar-api/src/components/member/member.service.ts`)
- Member accounts → View history: records profile views (evidence: `apps/nestar-api/src/components/member/member.service.ts`)
- Member accounts → Likes and favorites: toggles member likes (evidence: `apps/nestar-api/src/components/member/member.service.ts`)
- Property listings → Member accounts: updates member stats (evidence: `apps/nestar-api/src/components/property/property.service.ts`)
- Property listings → View history: gets visited properties (evidence: `apps/nestar-api/src/components/property/property.service.ts`)
- Property listings → Likes and favorites: gets favorites (evidence: `apps/nestar-api/src/components/property/property.service.ts`)
- Board articles → Member accounts: updates member stats (evidence: `apps/nestar-api/src/components/board-article/board-article.service.ts`)
- Board articles → View history: uses view service (evidence: `apps/nestar-api/src/components/board-article/board-article.service.ts`)
- Board articles → Likes and favorites: uses like service (evidence: `apps/nestar-api/src/components/board-article/board-article.service.ts`)
- Comments → Member accounts: uses member service (evidence: `apps/nestar-api/src/components/comment/comment.service.ts`)
- Comments → Property listings: uses property service (evidence: `apps/nestar-api/src/components/comment/comment.service.ts`)
- Comments → Board articles: uses article service (evidence: `apps/nestar-api/src/components/comment/comment.service.ts`)
- Member accounts → Member follows: reads follow data (evidence: `apps/nestar-api/src/components/member/member.service.ts`)
- Property listings → Shared query helpers: uses query helpers (evidence: `apps/nestar-api/src/components/property/property.service.ts`)
- Board articles → Shared query helpers: uses query helpers (evidence: `apps/nestar-api/src/components/board-article/board-article.service.ts`)
- Likes and favorites → Shared query helpers: uses aggregation helper (evidence: `apps/nestar-api/src/components/likes/likes.service.ts`)
- View history → Shared query helpers: uses aggregation helper (evidence: `apps/nestar-api/src/components/views/view.service.ts`)
- Property listings → API MongoDB models: reads and writes (evidence: `apps/nestar-api/src/components/property/property.service.ts`)
- Board articles → API MongoDB models: reads and writes (evidence: `apps/nestar-api/src/components/board-article/board-article.service.ts`)
- Member accounts → API MongoDB models: reads and writes (evidence: `apps/nestar-api/src/components/member/member.service.ts`)
- Likes and favorites → API MongoDB models: reads and writes (evidence: `apps/nestar-api/src/components/likes/likes.service.ts`)
- View history → API MongoDB models: reads and writes (evidence: `apps/nestar-api/src/components/views/view.service.ts`)
- Batch controller → Ranking jobs: invokes jobs (evidence: `apps/nestar-batch/src/batch.controller.ts`)
- Ranking jobs → Batch MongoDB models: updates rankings (evidence: `apps/nestar-batch/src/batch.service.ts`)
