]>
Commit | Line | Data |
---|---|---|
00ffc03e C |
1 | # Server code documentation |
2 | ||
69f616ab | 3 | The server is a web server developed with [TypeScript](https://www.typescriptlang.org/)/[Express](http://expressjs.com). |
00ffc03e C |
4 | |
5 | ||
6 | ## Technologies | |
7 | ||
69f616ab | 8 | * [TypeScript](https://www.typescriptlang.org/) -> Language |
7e6afafd | 9 | * [PostgreSQL](https://www.postgresql.org/) -> Database |
00ffc03e | 10 | * [Express](http://expressjs.com) -> Web server framework |
7e6afafd | 11 | * [Sequelize](http://docs.sequelizejs.com/en/v3/) -> SQL ORM |
82e62423 | 12 | * [WebTorrent](https://webtorrent.io/) -> BitTorrent tracker and torrent creation |
00ffc03e C |
13 | * [Mocha](https://mochajs.org/) -> Test framework |
14 | ||
15 | ||
16 | ## Files | |
17 | ||
69f616ab | 18 | The server main file is [server.ts](https://github.com/Chocobozzz/PeerTube/blob/master/server.ts). |
00ffc03e C |
19 | The server modules description are in the [package.json](https://github.com/Chocobozzz/PeerTube/blob/master/package.json) at the project root. |
20 | All other server files are in the [server](https://github.com/Chocobozzz/PeerTube/tree/master/server) directory: | |
21 | ||
69f616ab | 22 | server.ts -> app initilization, main routes configuration (static routes...) |
00ffc03e C |
23 | config -> server YAML configurations (for tests, production...) |
24 | scripts -> Scripts files for npm run | |
25 | server | |
26 | |__ controllers -> API routes/controllers files | |
27 | |__ helpers -> functions used by different part of the project (logger, utils...) | |
28 | |__ initializers -> functions used at the server startup (installer, database, constants...) | |
29 | |__ lib -> library function (WebTorrent, OAuth2, friends logic...) | |
30 | |__ middlewares -> middlewares for controllers (requests validators, requests pagination...) | |
fcaf1e0a | 31 | |__ models -> Sequelize models for each SQL tables (videos, users, accounts...) |
00ffc03e C |
32 | |__ tests -> API tests and real world simulations (to test the decentralized feature...) |
33 | ||
34 | ||
35 | ## Conventions | |
36 | ||
37 | Uses [JavaScript Standard Style](http://standardjs.com/). | |
38 | ||
39 | ||
40 | ## Developing | |
41 | ||
42 | * Install [the dependencies](https://github.com/Chocobozzz/PeerTube#dependencies) | |
ed5f9163 | 43 | * Run `yarn install` at the root directory to install all the dependencies |
7e6afafd | 44 | * Run PostgreSQL and create the database `peertube_dev`. |
ed5f9163 | 45 | * Run `npm run dev:server` to run the server, watch server files modifications and restart it automatically. The server (API + client) listen on `localhost:9000`. |
00ffc03e | 46 | |
fcaf1e0a | 47 | The `NODE_ENV=test` is set to speed up communications between instances (see [constants.ts](https://github.com/Chocobozzz/PeerTube/blob/master/server/initializers/constants.ts)). |
00ffc03e | 48 | |
f24c4e44 | 49 | `npm run help` gives you all available commands. |
00ffc03e | 50 | |
fcaf1e0a | 51 | If you want to test the decentralization feature, you can easily run 3 instances by running `npm run play`. The instances password are `test1`, `test2` and `test3`. |
00ffc03e C |
52 | |
53 | ||
54 | ## Architecture | |
55 | ||
56 | The server is composed by: | |
57 | ||
82e62423 | 58 | * a REST API (throught Express framework) |
00ffc03e | 59 | * a WebTorrent Tracker |
00ffc03e | 60 | |
82e62423 | 61 | A video is seeded by the server throught the [WebSeed](http://www.bittorrent.org/beps/bep_0019.html) protocol (HTTP). |
00ffc03e C |
62 | |
63 | ![Architecture scheme](https://github.com/Chocobozzz/PeerTube/blob/master/support/doc/server/upload-video.png) | |
64 | ||
7e6afafd | 65 | When a user uploads a video, the rest API create the torrent file and then adds it to its database. |
00ffc03e | 66 | |
82e62423 | 67 | If a user wants to watch the video, the tracker will indicate all other users that are watching the video + the HTTP url for the WebSeed. |
00ffc03e C |
68 | |
69 | ## Newcomers | |
70 | ||
69f616ab | 71 | The server entrypoint is [server.ts](https://github.com/Chocobozzz/PeerTube/blob/master/server.ts). You can begin to look at this file. |
00ffc03e | 72 | Then you can try to understand the [controllers](https://github.com/Chocobozzz/PeerTube/tree/master/server/controllers): they are the entrypoint of each API request. |