From 4cb9b911a81c8a49b642750ebbd3c2cc2d88eac2 Mon Sep 17 00:00:00 2001
From: Rafi Arrafif <rafiarrafif05@gmail.com>
Date: Thu, 5 Mar 2026 18:43:47 +0700
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20add=20architecture=20doc?=
 =?UTF-8?q?umentation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/README.md b/README.md
index e36ed86..78dbf73 100644
--- a/README.md
+++ b/README.md
@@ -16,3 +16,39 @@ Syzne TV was born from a simple frustration: watching anime online shouldn’t f
 - **Caching**: Redis (v8.4)
 - **Authentication**: JWT
 - **Monitoring**: Sentry
+
+## Architecture Overview
+
+Syzne TV uses a modular architecture to keep the codebase clean, scalable, and easy to maintain.
+Each feature is separated by domain (e.g., `auth`, `user`, `media`) and stored inside:
+
+```
+./src/modules
+```
+
+Every module follows the same internal structure:
+
+```
+module-name/
+├── controllers/
+├── services/
+├── repositories/
+├── validations/
+├── types.ts
+└── index.ts
+```
+
+#### Folder Responsibilities
+
+- **Controllers**: Handle incoming HTTP requests and responses. Every file must end with: `*.controller.ts`
+- **Services**: Contain the core business logic. Every file must end with: `*.service.ts`
+- **Repositories**: Interact with the database using Prisma. Every file must end with: `*.repository.ts`
+- **Validations**: Define request validation schemas using Zod. Every file must end with: `*.schema.ts`
+- **types.ts**: Contains module-specific TypeScript types.
+- **index.ts**: Defines the module routes and route prefix (e.g., `/auth`).
+
+> IMPORTANT: Whenever you create a new module and configure its routes, you must run:
+
+```bash
+bun run route:sync
+```