# wenyufennn/1117 architecture

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

- Interactive diagram: https://gitdiagram.com/wenyufennn/1117
- Repository: https://github.com/wenyufennn/1117

## Overview

This is a manuscript submission and editorial-review web application. Authors register or sign in, create and edit drafts, and submit them for review; editors inspect the review queue and approve or return manuscripts. FastAPI serves the web pages and exposes role-protected APIs, with SQLAlchemy models and a configured database underpinning user and manuscript records. The route, model, and authentication links below are supported by excerpts; the page-to-API interactions and database runtime behavior were not sampled.

Main entry points: [`backend/app/routes/manuscript.py`](https://github.com/wenyufennn/1117/blob/main/backend/app/routes/manuscript.py) (Author Manuscript API), [`backend/app/routes/auth.py`](https://github.com/wenyufennn/1117/blob/main/backend/app/routes/auth.py) (Auth Routes), [`backend/app/main.py`](https://github.com/wenyufennn/1117/blob/main/backend/app/main.py) (FastAPI App), [`backend/app/db.py`](https://github.com/wenyufennn/1117/blob/main/backend/app/db.py) (DB Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web Entry"]
  node_app["FastAPI App<br/>[main.py]"]
  node_web_pages["Web Pages"]
  node_login_page["Login Page<br/>[login.html]"]
  node_author_page["Author Pages<br/>[author.html]"]
  node_edit_page["Edit Manuscript Page"]
  node_editor_page["Editor Page<br/>[editor.html]"]
  node_view_page["Manuscript View Page"]
end

subgraph group_identity["Identity"]
  node_auth_routes["Auth Routes<br/>[auth.py]"]
  node_security["Token Security<br/>[security.py]"]
end

subgraph group_authoring["Author Workflow"]
  node_schemas["Manuscript Schemas<br/>[schemas.py]"]
  node_author_api["Author Manuscript API<br/>[manuscript.py]"]
end

subgraph group_editorial["Editorial Review"]
  node_editor_api["Editor Review API<br/>[manuscript.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_session["DB Sessions<br/>[deps.py]"]
  node_db_engine["DB Engine<br/>[db.py]"]
  node_settings["App Settings<br/>[config.py]"]
  node_orm_models["User &amp; Manuscript Models<br/>[models.py]"]
  node_database[("PostgreSQL Database")]
end

node_visitor(("Browser User"))

node_visitor -->|"requests"| node_app
node_app -->|"serves"| node_web_pages
node_app -->|"mounts"| node_auth_routes
node_app -->|"mounts"| node_author_api
node_app -->|"mounts"| node_editor_api
node_auth_routes -->|"uses"| node_security
node_auth_routes -->|"queries"| node_orm_models
node_auth_routes -->|"depends on"| node_db_session
node_author_api -->|"reads and writes"| node_orm_models
node_author_api -->|"validates with"| node_schemas
node_author_api -->|"depends on"| node_db_session
node_author_api -->|"checks roles"| node_auth_routes
node_editor_api -->|"reads and updates"| node_orm_models
node_editor_api -->|"depends on"| node_db_session
node_editor_api -->|"checks roles"| node_auth_routes
node_db_session -->|"opens sessions"| node_db_engine
node_db_engine -->|"reads connection settings"| node_settings
node_orm_models -->|"uses ORM base"| node_db_engine
node_db_engine -.->|"connects to"| node_database
node_login_page -.->|"uses API"| node_auth_routes
node_author_page -.->|"uses API"| node_author_api
node_edit_page -.->|"uses API"| node_author_api
node_editor_page -.->|"uses API"| node_editor_api
node_view_page -.->|"uses API"| node_author_api

click node_app "https://github.com/wenyufennn/1117/blob/main/backend/app/main.py"
click node_web_pages "https://github.com/wenyufennn/1117/tree/main/www"
click node_auth_routes "https://github.com/wenyufennn/1117/blob/main/backend/app/routes/auth.py"
click node_security "https://github.com/wenyufennn/1117/blob/main/backend/app/security.py"
click node_db_session "https://github.com/wenyufennn/1117/blob/main/backend/app/deps.py"
click node_db_engine "https://github.com/wenyufennn/1117/blob/main/backend/app/db.py"
click node_settings "https://github.com/wenyufennn/1117/blob/main/backend/app/config.py"
click node_orm_models "https://github.com/wenyufennn/1117/blob/main/backend/app/models.py"
click node_schemas "https://github.com/wenyufennn/1117/blob/main/backend/app/schemas.py"
click node_author_api "https://github.com/wenyufennn/1117/blob/main/backend/app/routes/manuscript.py"
click node_editor_api "https://github.com/wenyufennn/1117/blob/main/backend/app/routes/manuscript.py"
click node_login_page "https://github.com/wenyufennn/1117/blob/main/www/login.html"
click node_author_page "https://github.com/wenyufennn/1117/blob/main/www/author.html"
click node_edit_page "https://github.com/wenyufennn/1117/blob/main/www/edit_manuscript.html"
click node_editor_page "https://github.com/wenyufennn/1117/blob/main/www/editor.html"
click node_view_page "https://github.com/wenyufennn/1117/blob/main/www/view_manuscript.html"

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_web_pages,node_login_page,node_author_page,node_edit_page,node_editor_page,node_view_page,node_visitor toneBlue
class node_auth_routes,node_security toneAmber
class node_schemas,node_author_api toneMint
class node_editor_api toneRose
class node_db_session,node_db_engine,node_settings,node_orm_models,node_database toneIndigo
```

## Components

### Web Entry

- [FastAPI App](https://github.com/wenyufennn/1117/blob/main/backend/app/main.py): `backend/app/main.py`
- [Web Pages](https://github.com/wenyufennn/1117/tree/main/www): `www`
- [Login Page](https://github.com/wenyufennn/1117/blob/main/www/login.html): `www/login.html`
- [Author Pages](https://github.com/wenyufennn/1117/blob/main/www/author.html): `www/author.html`
- [Edit Manuscript Page](https://github.com/wenyufennn/1117/blob/main/www/edit_manuscript.html): `www/edit_manuscript.html`
- [Editor Page](https://github.com/wenyufennn/1117/blob/main/www/editor.html): `www/editor.html`
- [Manuscript View Page](https://github.com/wenyufennn/1117/blob/main/www/view_manuscript.html): `www/view_manuscript.html`

### Identity

- [Auth Routes](https://github.com/wenyufennn/1117/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Token Security](https://github.com/wenyufennn/1117/blob/main/backend/app/security.py): `backend/app/security.py`

### Author Workflow

- [Manuscript Schemas](https://github.com/wenyufennn/1117/blob/main/backend/app/schemas.py): `backend/app/schemas.py`
- [Author Manuscript API](https://github.com/wenyufennn/1117/blob/main/backend/app/routes/manuscript.py): `backend/app/routes/manuscript.py`

### Editorial Review

- [Editor Review API](https://github.com/wenyufennn/1117/blob/main/backend/app/routes/manuscript.py): `backend/app/routes/manuscript.py`

### Persistence

- [DB Sessions](https://github.com/wenyufennn/1117/blob/main/backend/app/deps.py): `backend/app/deps.py`
- [DB Engine](https://github.com/wenyufennn/1117/blob/main/backend/app/db.py): `backend/app/db.py`
- [App Settings](https://github.com/wenyufennn/1117/blob/main/backend/app/config.py): `backend/app/config.py`
- [User & Manuscript Models](https://github.com/wenyufennn/1117/blob/main/backend/app/models.py): `backend/app/models.py`
- **PostgreSQL Database**

### Other components

- **Browser User**

## Connections

- Browser User → FastAPI App: requests
- FastAPI App → Web Pages: serves (evidence: `backend/app/main.py`)
- FastAPI App → Auth Routes: mounts (evidence: `backend/app/main.py`)
- FastAPI App → Author Manuscript API: mounts (evidence: `backend/app/main.py`)
- FastAPI App → Editor Review API: mounts (evidence: `backend/app/main.py`)
- Auth Routes → Token Security: uses (evidence: `backend/app/routes/auth.py`)
- Auth Routes → User & Manuscript Models: queries (evidence: `backend/app/routes/auth.py`)
- Auth Routes → DB Sessions: depends on (evidence: `backend/app/routes/auth.py`)
- Author Manuscript API → User & Manuscript Models: reads and writes (evidence: `backend/app/routes/manuscript.py`)
- Author Manuscript API → Manuscript Schemas: validates with (evidence: `backend/app/routes/manuscript.py`)
- Author Manuscript API → DB Sessions: depends on (evidence: `backend/app/routes/manuscript.py`)
- Author Manuscript API → Auth Routes: checks roles (evidence: `backend/app/routes/manuscript.py`)
- Editor Review API → User & Manuscript Models: reads and updates (evidence: `backend/app/routes/manuscript.py`)
- Editor Review API → DB Sessions: depends on (evidence: `backend/app/routes/manuscript.py`)
- Editor Review API → Auth Routes: checks roles (evidence: `backend/app/routes/manuscript.py`)
- DB Sessions → DB Engine: opens sessions (evidence: `backend/app/deps.py`)
- DB Engine → App Settings: reads connection settings (evidence: `backend/app/db.py`)
- User & Manuscript Models → DB Engine: uses ORM base (evidence: `backend/app/models.py`)
- DB Engine → PostgreSQL Database: connects to
- Login Page → Auth Routes: uses API
- Author Pages → Author Manuscript API: uses API
- Edit Manuscript Page → Author Manuscript API: uses API
- Editor Page → Editor Review API: uses API
- Manuscript View Page → Author Manuscript API: uses API
