Skip to content

Commit 1df8ae3

Browse files
Merge pull request #1336 from syucream/fix/product-name-in-docs
Fix product name in the doc
2 parents cc313fc + ded68ba commit 1df8ae3

File tree

3 files changed

+56
-56
lines changed

3 files changed

+56
-56
lines changed

docs/content/_index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Pagoda
44

55
<span class="badge-placeholder">[![Build core (Python / Django)](https://github.com/dmm-com/pagoda/actions/workflows/build-core.yml/badge.svg)](https://github.com/dmm-com/pagoda/actions/workflows/build-core.yml)</span>
66
<span class="badge-placeholder">[![Build frontend](https://github.com/dmm-com/pagoda/actions/workflows/build-frontend.yml/badge.svg)](https://github.com/dmm-com/pagoda/actions/workflows/build-frontend.yml)</span>
7-
<span class="badge-placeholder">[![License: MIT](https://img.shields.io/github/license/dmm-com/airone)](https://github.com/dmm-com/airone/blob/master/LICENSE)</span>
7+
<span class="badge-placeholder">[![License: MIT](https://img.shields.io/github/license/dmm-com/airone)](https://github.com/dmm-com/pagoda/blob/master/LICENSE)</span>
88

99
Pagoda is a Web Application which is developed by the infrastructure division of DMM.com LLC on the purpose of managing information which is associated with on-premise equipments. This aims to be versatile and flexible for doing it.
1010

docs/content/getting_started/development.md

+50-50
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Tutorial
2+
title: Development
33
weight: 30
44
---
55

@@ -23,17 +23,17 @@ user@hostname:~$ sudo apt-get install libldap2-dev libsasl2-dev libxmlsec1-dev
2323
user@hostname:~$ brew install libxmlsec1 mysql-client pkg-config mysql-connector-python
2424
```
2525

26-
Then, you can install libraries on which AieOne depends by following after cloning this repository. But we recommand you to setup airone on the separated environment using virtualenv not to pollute system-wide python environment.
26+
Then, you can install libraries on which Pagoda depends by following after cloning this repository. But we recommand you to setup pagoda on the separated environment using virtualenv not to pollute system-wide python environment.
2727
```
28-
user@hostname:~$ git clone https://github.com/dmm-com/airone.git
29-
user@hostname:~$ cd airone
30-
user@hostname:~/airone$ python3 -m venv virtualenv
31-
user@hostname:~/airone$ source virtualenv/bin/activate
32-
(virtualenv) user@hostname:~/airone$ pip install pip --upgrade
33-
(virtualenv) user@hostname:~/airone$ pip install poetry
34-
(virtualenv) user@hostname:~/airone$ poetry install --only main
28+
user@hostname:~$ git clone https://github.com/dmm-com/pagoda.git
29+
user@hostname:~$ cd pagoda
30+
user@hostname:~/pagoda$ python3 -m venv virtualenv
31+
user@hostname:~/pagoda$ source virtualenv/bin/activate
32+
(virtualenv) user@hostname:~/pagoda$ pip install pip --upgrade
33+
(virtualenv) user@hostname:~/pagoda$ pip install poetry
34+
(virtualenv) user@hostname:~/pagoda$ poetry install --only main
3535
# or, during development, install all
36-
(virtualenv) user@hostname:~/airone$ poetry install
36+
(virtualenv) user@hostname:~/pagoda$ poetry install
3737
```
3838

3939
## Setting-up Backend with docker-compose
@@ -42,7 +42,7 @@ Install docker-compose command.
4242
Run middlewares with docker-compose.
4343

4444
```
45-
user@hostname:~/airone$ docker-compose up
45+
user@hostname:~/pagoda$ docker-compose up
4646
```
4747

4848
## (Setting-up Backend with manual)
@@ -150,9 +150,9 @@ user@hostname:~$ sudo mkdir /etc/nginx/ssl
150150
user@hostname:~$ sudo mv server* /etc/nginx/ssl
151151
```
152152

153-
Write following configuration for Pagoda on Nginx at `/etc/nginx/conf.d/airone.conf`.
153+
Write following configuration for Pagoda on Nginx at `/etc/nginx/conf.d/pagoda.conf`.
154154
```
155-
upstream airone {
155+
upstream pagoda {
156156
server hostname:8080;
157157
}
158158
@@ -173,11 +173,11 @@ server {
173173
location / {
174174
rewrite ^/(.*) /$1 break;
175175
176-
proxy_pass http://airone/;
176+
proxy_pass http://pagoda/;
177177
}
178178
179-
access_log /var/log/nginx/airone.ssl.access.log combined;
180-
error_log /var/log/nginx/airone.ssl.error.log;
179+
access_log /var/log/nginx/pagoda.ssl.access.log combined;
180+
error_log /var/log/nginx/pagoda.ssl.error.log;
181181
182182
# set longer to wait background processing until 300s
183183
proxy_read_timeout 300;
@@ -194,7 +194,7 @@ bin/elasticsearch-users useradd airone
194194
bin/elasticsearch-users roles airone --add superuser
195195
```
196196

197-
You should cerate database and user for airone in MySQL.
197+
You should cerate database and user for pagoda in MySQL.
198198
```
199199
user@hostname:~$ mysql -u root -h 127.0.0.1
200200
@@ -207,9 +207,9 @@ mysql> GRANT ALL ON test_airone.* to airone@'%';
207207

208208
This command makes database schema using the [django Migrations](https://docs.djangoproject.com/en/1.11/topics/migrations/), and makes default user account.
209209
```
210-
user@hostname:~$ cd airone
211-
user@hostname:~/airone$ source virtualenv/bin/activate
212-
(virtualenv) user@hostname:~/airone$ tools/clear_and_initdb.sh
210+
user@hostname:~$ cd pagoda
211+
user@hostname:~/pagoda$ source virtualenv/bin/activate
212+
(virtualenv) user@hostname:~/pagoda$ tools/clear_and_initdb.sh
213213
```
214214

215215
(Optional) Please set the index as necessary.
@@ -219,7 +219,7 @@ mysql> CREATE INDEX permission_codename_idx ON auth_permission (codename);
219219

220220
Finally, you should create an initial user to login the system using `tools/register_user.sh`.
221221
```
222-
(virtualenv) user@hostname:~/airone$ tools/register_user.sh demo
222+
(virtualenv) user@hostname:~/pagoda$ tools/register_user.sh demo
223223
Password: ## input password of this user
224224
Succeed in register user (demo)
225225
```
@@ -232,7 +232,7 @@ This creates following user.
232232

233233
If you want to create an administrative user who can access all information regardless of ACL (Please refer the [User-Manual(TBD)](#)), you can do it with `-s, --superuser` option. This creates another user who takes privilege of this system.
234234
```
235-
(virtualenv) user@hostname:~/airone$ tools/register_user.sh -s admin
235+
(virtualenv) user@hostname:~/pagoda$ tools/register_user.sh -s admin
236236
Password: ## input password of this user
237237
Succeed in register user (admin)
238238
```
@@ -241,7 +241,7 @@ This regists all entries which has been created in the database to the Elasticse
241241
You can do it just by following command. The configurations about the database to read and Elasticsearch to register are referred from airone/settings.py.
242242

243243
```
244-
(virtualenv) user@hostname:~/airone$ python tools/initialize_es_document.py
244+
(virtualenv) user@hostname:~/pagoda$ python tools/initialize_es_document.py
245245
```
246246

247247
## Run Pagoda
@@ -250,18 +250,18 @@ You can start Pagoda as following and can browse from `http://hostname:8080/`
250250
e.g.
251251

252252
```
253-
user@hostname:~$ cd airone
254-
user@hostname:~/airone$ source virtualenv/bin/activate
255-
(virtualenv) user@hostname:~/airone$ python manage.py runserver 0:8080
253+
user@hostname:~$ cd pagoda
254+
user@hostname:~/pagoda$ source virtualenv/bin/activate
255+
(virtualenv) user@hostname:~/pagoda$ python manage.py runserver 0:8080
256256
```
257257

258258
## Run Celery
259259

260260
In addition, you have to run Celery worker to execute background task as following.
261261
```
262-
user@hostname:~$ cd airone
263-
user@hostname:~/airone$ source virtualenv/bin/activate
264-
(virtualenv) user@hostname:~/airone$ celery -A airone worker -l info
262+
user@hostname:~$ cd pagoda
263+
user@hostname:~/pagoda$ source virtualenv/bin/activate
264+
(virtualenv) user@hostname:~/pagoda$ celery -A airone worker -l info
265265
```
266266

267267
## [Experimental] Build the new UI with React
@@ -273,33 +273,33 @@ Install nvm command.
273273
Install npm packages.
274274
```
275275
user@hostname:~$ nvm install 18.12.0
276-
user@hostname:~$ cd airone
277-
user@hostname:~/airone$ npm install
276+
user@hostname:~$ cd pagoda
277+
user@hostname:~/pagoda$ npm install
278278
```
279279

280280
Build
281281
```
282-
user@hostname:~/airone$ npm run build
282+
user@hostname:~/pagoda$ npm run build
283283
284284
(In development)
285-
user@hostname:~/airone$ npm run watch
285+
user@hostname:~/pagoda$ npm run watch
286286
```
287287

288288
If you have any change on API V2, you need to run this command before you build:
289289

290290
```
291-
user@hostname:~/airone$ npm run generate:client
291+
user@hostname:~/pagoda$ npm run generate:client
292292
293293
(For Customview)
294-
user@hostname:~/airone$ npm run generate:custom_client
294+
user@hostname:~/pagoda$ npm run generate:custom_client
295295
```
296296

297297
To customize UI:
298298

299299
```
300-
user@hostname:~/airone$ cp -pi ./frontend/src/App.tsx ./frontend/src/customview/CustomApp.tsx
300+
user@hostname:~/pagoda$ cp -pi ./frontend/src/App.tsx ./frontend/src/customview/CustomApp.tsx
301301
(edit CustomApp.tsx)
302-
user@hostname:~/airone$ npm run build:custom
302+
user@hostname:~/pagoda$ npm run build:custom
303303
```
304304

305305
### API V2 client
@@ -328,41 +328,41 @@ If you modify something in API client code, you need to publish it with the pack
328328
## Auto-format
329329

330330
```
331-
user@hostname:~$ cd airone
332-
user@hostname:~/airone$ source virtualenv/bin/activate
333-
(virtualenv) user@hostname:~/airone$ ruff format .
334-
(virtualenv) user@hostname:~/airone$ ruff check --fix .
331+
user@hostname:~$ cd pagoda
332+
user@hostname:~/pagoda$ source virtualenv/bin/activate
333+
(virtualenv) user@hostname:~/pagoda$ ruff format .
334+
(virtualenv) user@hostname:~/pagoda$ ruff check --fix .
335335
336-
user@hostname:~/airone$ npm run fix
336+
user@hostname:~/pagoda$ npm run fix
337337
```
338338

339339
## Test for Django processing
340340
You can run tests for processing that is run by Django and Celery, which means backend processing, as below.
341341
```
342-
user@hostname:~$ cd airone
343-
user@hostname:~/airone$ source virtualenv/bin/activate
344-
(virtualenv) user@hostname:~/airone$ python manage.py test
342+
user@hostname:~$ cd pagoda
343+
user@hostname:~/pagoda$ source virtualenv/bin/activate
344+
(virtualenv) user@hostname:~/pagoda$ python manage.py test
345345
```
346346

347347
When you want to run a specific test (`ModelTest.test_is_belonged_to_parent_group` in the file of `role/tests/test_model.py`) , you can do it as below.
348348
```
349-
(virtualenv) user@hostname:~/airone$ python manage.py test role.tests.test_model.ModelTest.test_is_belonged_to_parent_group
349+
(virtualenv) user@hostname:~/pagoda$ python manage.py test role.tests.test_model.ModelTest.test_is_belonged_to_parent_group
350350
```
351351

352352
## Test for React processing
353353
You can run test for processing that is run by Browser, wihch means frontend processing as below.
354354
```
355-
user@hostname:~$ cd airone
356-
user@hostname:~/airone$ npm run test
355+
user@hostname:~$ cd pagoda
356+
user@hostname:~/pagoda$ npm run test
357357
```
358358

359359
If you have any change on a page component, please re-build snapshots along with current implementaion as below.
360360

361361
```
362-
user@hostname:~/airone$ npm run test:update
362+
user@hostname:~/pagoda$ npm run test:update
363363
```
364364

365365
When you want to run individual test (e.g. frontend/src/components/user/UserList.test.tsx), you can do it by following command.
366366
```
367-
user@hostname:~/airone$ npx jest -u frontend/src/components/user/UserList.test.tsx
367+
user@hostname:~/pagoda$ npx jest -u frontend/src/components/user/UserList.test.tsx
368368
```
+5-5
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: AirOne Overview
2+
title: Pagoda Overview
33
weight: 0
44
---
55

6-
AirOne is an information management system with high flexibility of access control and high extensibility of data. This enables to manage information in any type of use-cases. This document describes these features.
6+
Pagoda is an information management system with high flexibility of access control and high extensibility of data. This enables to manage information in any type of use-cases. This document describes these features.
77

88
### Data model that meets with extensibility
99

10-
AirOne manages informaiton by using following two type of data-structure.
10+
Pagoda manages informaiton by using following two type of data-structure.
1111

1212
* Entity - has meta data (what kind of data it has and how).
1313
* Entry - has actual data in conformity to an Entity which is associated with it.
@@ -16,12 +16,12 @@ This page shows an example how to manage information which has complex data-stru
1616

1717
<img src='/content/getting_started/airone_overview1.png' width='800'/>
1818

19-
You can easily manage those complex information by making Entities on Air One as below.
19+
You can easily manage those complex information by making Entities on Pagoda as below.
2020

2121
<img src='/content/getting_started/airone_overview2_entity.png' width='800'/>
2222

2323
And by making Entries, you can register and retrieve all kind of data instances which are mentioned above.
2424

2525
<img src='/content/getting_started/airone_overview3_entry.png' width='800'/>
2626

27-
In this way, user can handle any kind of information and information which is associated with other ones by using this simple data-structure (Entity and Entry) other than above use-case. For more information about this AirOne's datastructure, please see [Entity and Entry]() page.
27+
In this way, user can handle any kind of information and information which is associated with other ones by using this simple data-structure (Entity and Entry) other than above use-case. For more information about this Pagoda's datastructure, please see [Entity and Entry]() page.

0 commit comments

Comments
 (0)