# done-think/ketris architecture

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

- Interactive diagram: https://gitdiagram.com/done-think/ketris
- Repository: https://github.com/done-think/ketris

## Overview

Ketris is a multi-tenant real-estate SaaS. Its user-facing workflows span account access, property and CRM work, contracts, scheduling, verification, finance, and public marketplace profiles; platform administration and maintenance are additional product areas. The documented backend is a Next.js BFF backed by PostgreSQL through Prisma. The graph preserves the major product branches visible in the tree, but most server-domain internals were not sampled, so their connections are intentionally limited. CRM control-flow edges and face-analysis integration are supported by excerpts.

Main entry points: [`apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/SalesPipelineBoard.tsx) (Pipeline board), [`apps/web/src/app/[locale]`](https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D) (Web application), [`apps/web/src/app/api`](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api) (Next.js BFF), [`apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts`](https://github.com/done-think/ketris/blob/main/apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts) (Attachment storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Web application"]
  node_auth["Account access"]
end

subgraph group_realestate["Real estate operations"]
  node_crm["CRM pipeline"]
  node_properties["Property management"]
  node_agenda["Agenda scheduling"]
  node_contracts["Contracts"]
  node_marketplace["Public marketplace"]
  node_crmboard["Pipeline board"]
  node_crmcreate["Opportunity creation"]
  node_crmhooks["Opportunity actions"]
  node_kanban["Kanban view"]
  node_proposals["Proposal list"]
  node_toolbar["Pipeline controls"]
end

subgraph group_trust["Trust and services"]
  node_facecheck["Face verification"]
  node_faceengine["Face analysis engine<br/>[http_service.py]"]
  node_finance["Financial charges"]
  node_maintenance["Maintenance tickets"]
  node_facehttp["Face engine client"]
end

subgraph group_platform["Platform operations"]
  node_team["Team management"]
  node_platformadmin["Tenant administration"]
end

subgraph group_infrastructure["Backend infrastructure"]
  node_bff["Next.js BFF"]
  node_database[("PostgreSQL via Prisma")]
  node_s3maintenance["Attachment storage"]
  node_s3contracts["Document storage"]
  node_s3finance["Receipt storage"]
  node_s3[("Amazon S3")]
end

node_user(("People and organizations"))

node_user -->|"uses"| node_web
node_web -->|"submits requests"| node_bff
node_bff -->|"uses Prisma"| node_database
node_web -.->|"renders pipeline"| node_crmboard
node_crmboard -->|"renders controls"| node_toolbar
node_crmboard -->|"renders dialog"| node_crmcreate
node_crmboard -->|"creates opportunity"| node_crmhooks
node_crmboard -->|"renders kanban"| node_kanban
node_crmboard -->|"renders list"| node_proposals
node_facehttp -->|"posts analyses"| node_faceengine
node_maintenance -.->|"stores attachments"| node_s3maintenance
node_contracts -.->|"stores documents"| node_s3contracts
node_finance -.->|"stores receipts"| node_s3finance
node_s3maintenance -->|"reads and writes"| node_s3
node_s3contracts -->|"reads and writes"| node_s3
node_s3finance -->|"reads and writes"| node_s3

click node_web "https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D"
click node_auth "https://github.com/done-think/ketris/tree/main/apps/web/src/modules/auth"
click node_crm "https://github.com/done-think/ketris/tree/main/apps/web/src/modules/crm"
click node_properties "https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D/(dashboard)/dashboard/properties"
click node_agenda "https://github.com/done-think/ketris/tree/main/apps/web/src/modules/agenda"
click node_contracts "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/contracts"
click node_marketplace "https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D/(public)"
click node_facecheck "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/face_check"
click node_faceengine "https://github.com/done-think/ketris/blob/main/services/face_check_engine/http_service.py"
click node_finance "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/financial/charges"
click node_maintenance "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/maintenance/tickets"
click node_team "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/team"
click node_platformadmin "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/platform/tenants"
click node_bff "https://github.com/done-think/ketris/tree/main/apps/web/src/app/api"
click node_database "https://github.com/done-think/ketris/tree/main/apps/web/prisma"
click node_crmboard "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/SalesPipelineBoard.tsx"
click node_crmcreate "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/opportunity-detail/CreateOpportunityDialog.tsx"
click node_crmhooks "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/hooks/use-opportunities.ts"
click node_kanban "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/SalesPipelineKanbanView.tsx"
click node_proposals "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/CrmProposalsList.tsx"
click node_toolbar "https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/sales-pipeline-board/SalesPipelineToolbar.tsx"
click node_s3maintenance "https://github.com/done-think/ketris/blob/main/apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts"
click node_s3contracts "https://github.com/done-think/ketris/blob/main/apps/web/src/server/contracts/infrastructure/s3-contract-document-storage.ts"
click node_s3finance "https://github.com/done-think/ketris/blob/main/apps/web/src/server/financial/infrastructure/s3-charge-receipt-storage.ts"
click node_facehttp "https://github.com/done-think/ketris/blob/main/apps/web/src/server/face_check/face-match/http-face-engine.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_web,node_auth toneBlue
class node_crm,node_properties,node_agenda,node_contracts,node_marketplace,node_crmboard,node_crmcreate,node_crmhooks,node_kanban,node_proposals,node_toolbar toneAmber
class node_facecheck,node_faceengine,node_finance,node_maintenance,node_facehttp toneMint
class node_team,node_platformadmin toneRose
class node_bff,node_database,node_s3maintenance,node_s3contracts,node_s3finance,node_s3,node_user toneIndigo
```

## Components

### User experience

- [Web application](https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D): `apps/web/src/app/[locale]`
- [Account access](https://github.com/done-think/ketris/tree/main/apps/web/src/modules/auth): `apps/web/src/modules/auth`

### Real estate operations

- [CRM pipeline](https://github.com/done-think/ketris/tree/main/apps/web/src/modules/crm): `apps/web/src/modules/crm`
- [Property management](https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D/(dashboard)/dashboard/properties): `apps/web/src/app/[locale]/(dashboard)/dashboard/properties`
- [Agenda scheduling](https://github.com/done-think/ketris/tree/main/apps/web/src/modules/agenda): `apps/web/src/modules/agenda`
- [Contracts](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/contracts): `apps/web/src/app/api/contracts`
- [Public marketplace](https://github.com/done-think/ketris/tree/main/apps/web/src/app/%5Blocale%5D/(public)): `apps/web/src/app/[locale]/(public)`
- [Pipeline board](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/SalesPipelineBoard.tsx): `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`
- [Opportunity creation](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/opportunity-detail/CreateOpportunityDialog.tsx): `apps/web/src/modules/crm/components/opportunity-detail/CreateOpportunityDialog.tsx`
- [Opportunity actions](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/hooks/use-opportunities.ts): `apps/web/src/modules/crm/hooks/use-opportunities.ts`
- [Kanban view](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/SalesPipelineKanbanView.tsx): `apps/web/src/modules/crm/components/SalesPipelineKanbanView.tsx`
- [Proposal list](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/CrmProposalsList.tsx): `apps/web/src/modules/crm/components/CrmProposalsList.tsx`
- [Pipeline controls](https://github.com/done-think/ketris/blob/main/apps/web/src/modules/crm/components/sales-pipeline-board/SalesPipelineToolbar.tsx): `apps/web/src/modules/crm/components/sales-pipeline-board/SalesPipelineToolbar.tsx`

### Trust and services

- [Face verification](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/face_check): `apps/web/src/app/api/face_check`
- [Face analysis engine](https://github.com/done-think/ketris/blob/main/services/face_check_engine/http_service.py): `services/face_check_engine/http_service.py`
- [Financial charges](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/financial/charges): `apps/web/src/app/api/financial/charges`
- [Maintenance tickets](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/maintenance/tickets): `apps/web/src/app/api/maintenance/tickets`
- [Face engine client](https://github.com/done-think/ketris/blob/main/apps/web/src/server/face_check/face-match/http-face-engine.ts): `apps/web/src/server/face_check/face-match/http-face-engine.ts`

### Platform operations

- [Team management](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/team): `apps/web/src/app/api/team`
- [Tenant administration](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api/platform/tenants): `apps/web/src/app/api/platform/tenants`

### Backend infrastructure

- [Next.js BFF](https://github.com/done-think/ketris/tree/main/apps/web/src/app/api): `apps/web/src/app/api`
- [PostgreSQL via Prisma](https://github.com/done-think/ketris/tree/main/apps/web/prisma): `apps/web/prisma`
- [Attachment storage](https://github.com/done-think/ketris/blob/main/apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts): `apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts`
- [Document storage](https://github.com/done-think/ketris/blob/main/apps/web/src/server/contracts/infrastructure/s3-contract-document-storage.ts): `apps/web/src/server/contracts/infrastructure/s3-contract-document-storage.ts`
- [Receipt storage](https://github.com/done-think/ketris/blob/main/apps/web/src/server/financial/infrastructure/s3-charge-receipt-storage.ts): `apps/web/src/server/financial/infrastructure/s3-charge-receipt-storage.ts`
- **Amazon S3**

### Other components

- **People and organizations**

## Connections

- People and organizations → Web application: uses (evidence: `README.md`)
- Web application → Next.js BFF: submits requests (evidence: `README.md`)
- Next.js BFF → PostgreSQL via Prisma: uses Prisma (evidence: `README.md`)
- Web application → Pipeline board: renders pipeline
- Pipeline board → Pipeline controls: renders controls (evidence: `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`)
- Pipeline board → Opportunity creation: renders dialog (evidence: `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`)
- Pipeline board → Opportunity actions: creates opportunity (evidence: `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`)
- Pipeline board → Kanban view: renders kanban (evidence: `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`)
- Pipeline board → Proposal list: renders list (evidence: `apps/web/src/modules/crm/components/SalesPipelineBoard.tsx`)
- Face engine client → Face analysis engine: posts analyses (evidence: `apps/web/src/server/face_check/face-match/http-face-engine.ts`)
- Maintenance tickets → Attachment storage: stores attachments
- Contracts → Document storage: stores documents
- Financial charges → Receipt storage: stores receipts
- Attachment storage → Amazon S3: reads and writes (evidence: `apps/web/src/server/maintenance/infrastructure/s3-maintenance-attachment-storage.ts`)
- Document storage → Amazon S3: reads and writes (evidence: `apps/web/src/server/contracts/infrastructure/s3-contract-document-storage.ts`)
- Receipt storage → Amazon S3: reads and writes (evidence: `apps/web/src/server/financial/infrastructure/s3-charge-receipt-storage.ts`)
