# lenz0501/submission-review architecture

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

- Interactive diagram: https://gitdiagram.com/lenz0501/submission-review
- Repository: https://github.com/lenz0501/submission-review

## Overview

投稿審查是以 FastAPI 和伺服器渲染 HTML 建置的投稿工作流程：作者登入、建立及管理草稿並送審；編輯閱讀稿件、通過或退回，也可重新審查已通過稿件。路由與權限檢查集中在 main.py，透過非同步資料庫相依項操作 PostgreSQL，登入使用 Session 與密碼雜湊。模板負責登入、作者稿件表單與清單、編輯清單和內容頁。未取樣的模板與 schema 僅依 README 和檔案樹納入；關係只標示 excerpt 或 README 支持的部分。

Main entry points: [`main.py`](https://github.com/lenz0501/submission-review/blob/main/main.py) (路由與狀態流程), [`init_db.py`](https://github.com/lenz0501/submission-review/blob/main/init_db.py) (資料庫初始化), [`db.py`](https://github.com/lenz0501/submission-review/blob/main/db.py) (非同步連線池), [`security.py`](https://github.com/lenz0501/submission-review/blob/main/security.py) (密碼雜湊驗證)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web 與安全"]
  node_app["路由與狀態流程<br/>[main.py]"]
  node_auth["密碼雜湊驗證<br/>[security.py]"]
  node_loginui["登入頁<br/>[login.html]"]
  node_static["共用樣式<br/>[style.css]"]
end

subgraph group_author["作者投稿"]
  node_authorui["作者清單與表單"]
  node_drafts["草稿管理<br/>[main.py]"]
  node_submission["送交審查<br/>[main.py]"]
end

subgraph group_review["編輯審查"]
  node_editorlist["編輯稿件清單<br/>[editor_list.html]"]
  node_detailui["稿件內容頁<br/>[detail.html]"]
  node_reviewflow["審查與重新開啟<br/>[main.py]"]
end

subgraph group_storage["資料持久層"]
  node_dbaccess["非同步連線池<br/>[db.py]"]
  node_postgres[("PostgreSQL")]
  node_init["資料庫初始化<br/>[init_db.py]"]
  node_schema["資料表與索引<br/>[schema.sql]"]
end

node_browser(("瀏覽器使用者"))

node_browser -->|"提交請求"| node_app
node_app -->|"呈現登入"| node_loginui
node_app -->|"呈現作者頁"| node_authorui
node_app -->|"呈現清單"| node_editorlist
node_app -->|"呈現內容"| node_detailui
node_app -->|"驗證密碼"| node_auth
node_app -->|"取得連線"| node_dbaccess
node_drafts -->|"讀寫草稿"| node_postgres
node_submission -->|"更新狀態"| node_postgres
node_reviewflow -->|"更新審查狀態"| node_postgres
node_app -->|"處理作者操作"| node_drafts
node_app -->|"處理送審"| node_submission
node_app -->|"處理審查操作"| node_reviewflow
node_dbaccess -->|"提供連線"| node_postgres
node_init -->|"執行建表"| node_schema
node_init -->|"雜湊示範密碼"| node_auth
node_init -->|"初始化資料"| node_postgres
node_app -->|"提供靜態檔"| node_static

click node_app "https://github.com/lenz0501/submission-review/blob/main/main.py"
click node_auth "https://github.com/lenz0501/submission-review/blob/main/security.py"
click node_authorui "https://github.com/lenz0501/submission-review/tree/main/templates"
click node_drafts "https://github.com/lenz0501/submission-review/blob/main/main.py"
click node_submission "https://github.com/lenz0501/submission-review/blob/main/main.py"
click node_editorlist "https://github.com/lenz0501/submission-review/blob/main/templates/editor_list.html"
click node_detailui "https://github.com/lenz0501/submission-review/blob/main/templates/detail.html"
click node_reviewflow "https://github.com/lenz0501/submission-review/blob/main/main.py"
click node_loginui "https://github.com/lenz0501/submission-review/blob/main/templates/login.html"
click node_dbaccess "https://github.com/lenz0501/submission-review/blob/main/db.py"
click node_init "https://github.com/lenz0501/submission-review/blob/main/init_db.py"
click node_schema "https://github.com/lenz0501/submission-review/blob/main/schema.sql"
click node_static "https://github.com/lenz0501/submission-review/blob/main/www/style.css"

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_app,node_auth,node_loginui,node_static toneBlue
class node_authorui,node_drafts,node_submission toneAmber
class node_editorlist,node_detailui,node_reviewflow toneMint
class node_dbaccess,node_postgres,node_init,node_schema toneRose
class node_browser toneIndigo
```

## Components

### Web 與安全

- [路由與狀態流程](https://github.com/lenz0501/submission-review/blob/main/main.py): `main.py`
- [密碼雜湊驗證](https://github.com/lenz0501/submission-review/blob/main/security.py): `security.py`
- [登入頁](https://github.com/lenz0501/submission-review/blob/main/templates/login.html): `templates/login.html`
- [共用樣式](https://github.com/lenz0501/submission-review/blob/main/www/style.css): `www/style.css`

### 作者投稿

- [作者清單與表單](https://github.com/lenz0501/submission-review/tree/main/templates): `templates`
- [草稿管理](https://github.com/lenz0501/submission-review/blob/main/main.py): `main.py`
- [送交審查](https://github.com/lenz0501/submission-review/blob/main/main.py): `main.py`

### 編輯審查

- [編輯稿件清單](https://github.com/lenz0501/submission-review/blob/main/templates/editor_list.html): `templates/editor_list.html`
- [稿件內容頁](https://github.com/lenz0501/submission-review/blob/main/templates/detail.html): `templates/detail.html`
- [審查與重新開啟](https://github.com/lenz0501/submission-review/blob/main/main.py): `main.py`

### 資料持久層

- [非同步連線池](https://github.com/lenz0501/submission-review/blob/main/db.py): `db.py`
- **PostgreSQL**
- [資料庫初始化](https://github.com/lenz0501/submission-review/blob/main/init_db.py): `init_db.py`
- [資料表與索引](https://github.com/lenz0501/submission-review/blob/main/schema.sql): `schema.sql`

### Other components

- **瀏覽器使用者**

## Connections

- 瀏覽器使用者 → 路由與狀態流程: 提交請求 (evidence: `README.md`)
- 路由與狀態流程 → 登入頁: 呈現登入 (evidence: `main.py`)
- 路由與狀態流程 → 作者清單與表單: 呈現作者頁 (evidence: `README.md`)
- 路由與狀態流程 → 編輯稿件清單: 呈現清單 (evidence: `main.py`)
- 路由與狀態流程 → 稿件內容頁: 呈現內容 (evidence: `main.py`)
- 路由與狀態流程 → 密碼雜湊驗證: 驗證密碼 (evidence: `main.py`)
- 路由與狀態流程 → 非同步連線池: 取得連線 (evidence: `main.py`)
- 草稿管理 → PostgreSQL: 讀寫草稿 (evidence: `main.py`)
- 送交審查 → PostgreSQL: 更新狀態 (evidence: `main.py`)
- 審查與重新開啟 → PostgreSQL: 更新審查狀態 (evidence: `main.py`)
- 路由與狀態流程 → 草稿管理: 處理作者操作 (evidence: `main.py`)
- 路由與狀態流程 → 送交審查: 處理送審 (evidence: `main.py`)
- 路由與狀態流程 → 審查與重新開啟: 處理審查操作 (evidence: `main.py`)
- 非同步連線池 → PostgreSQL: 提供連線 (evidence: `db.py`)
- 資料庫初始化 → 資料表與索引: 執行建表 (evidence: `init_db.py`)
- 資料庫初始化 → 密碼雜湊驗證: 雜湊示範密碼 (evidence: `init_db.py`)
- 資料庫初始化 → PostgreSQL: 初始化資料 (evidence: `init_db.py`)
- 路由與狀態流程 → 共用樣式: 提供靜態檔 (evidence: `main.py`)
