# baotlake/office-website architecture

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

- Interactive diagram: https://gitdiagram.com/baotlake/office-website
- Repository: https://github.com/baotlake/office-website

## Overview

ZIZIYI Office is a local-first browser app for opening, creating, and editing Office documents. The main workflow selects a file or new-document type, opens it through the editor route, and adapts the editor API with a browser-side server, socket, and conversion layer. The graph also preserves template browsing, recent-file persistence, settings, and documented cloud selection. Source excerpts show the main handoffs; cloud-provider and IndexedDB details are documented in the README, while some implementation details remain unsampled.

Main entry points: [`components/main/open-view.tsx`](https://github.com/baotlake/office-website/blob/main/components/main/open-view.tsx) (Open view), [`utils/editor/server.ts`](https://github.com/baotlake/office-website/blob/main/utils/editor/server.ts) (Editor server), [`app/editor/page.tsx`](https://github.com/baotlake/office-website/blob/main/app/editor/page.tsx) (Editor route), [`store/index.ts`](https://github.com/baotlake/office-website/blob/main/store/index.ts) (App state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Document entry"]
  node_open["Open view<br/>[open-view.tsx]"]
  node_picker["File picker"]
  node_cloud["Cloud providers"]
  node_templates["Template catalog<br/>[templates.ts]"]
end

subgraph group_editing["Editor runtime"]
  node_editorpage["Editor route<br/>[page.tsx]"]
  node_officeapi["Office editor API<br/>[api.js]"]
  node_server["Editor server<br/>[server.ts]"]
  node_conversion["x2t conversion<br/>[x2t.ts]"]
  node_socket["Mock socket<br/>[socket.ts]"]
  node_emptydocs["New document seeds<br/>[empty.ts]"]
end

subgraph group_localdata["Local data"]
  node_store["App state<br/>[index.ts]"]
  node_recent["Recent files<br/>[recent-files.ts]"]
  node_indexeddb[("IndexedDB")]
end

subgraph group_product["Product features"]
  node_settings["Settings view<br/>[settings-view.tsx]"]
  node_templateview["Template view<br/>[template-view.tsx]"]
  node_i18n["Locale config<br/>[config.ts]"]
end

node_user(("User"))

node_user -->|"selects or creates"| node_open
node_open -->|"renders"| node_picker
node_open -->|"opens file"| node_server
node_open -->|"loads and updates"| node_recent
node_open -->|"navigates to"| node_editorpage
node_picker -.->|"selects from"| node_cloud
node_open -->|"lists templates"| node_templates
node_editorpage -->|"reads state"| node_store
node_store -->|"creates"| node_server
node_editorpage -->|"initializes and routes requests"| node_server
node_editorpage -->|"loads editor API"| node_officeapi
node_server -->|"uses"| node_socket
node_server -->|"converts documents"| node_conversion
node_server -->|"seeds new files"| node_emptydocs
node_settings -->|"updates preferences"| node_store
node_templateview -->|"reads catalog"| node_templates
node_recent -.->|"persists locally"| node_indexeddb
node_store -->|"resolves locale"| node_i18n

click node_open "https://github.com/baotlake/office-website/blob/main/components/main/open-view.tsx"
click node_picker "https://github.com/baotlake/office-website/blob/main/components/file-picker-card.tsx"
click node_templates "https://github.com/baotlake/office-website/blob/main/utils/templates.ts"
click node_editorpage "https://github.com/baotlake/office-website/blob/main/app/editor/page.tsx"
click node_officeapi "https://github.com/baotlake/office-website/blob/main/public/v9.3.0.24-1/web-apps/apps/api/documents/api.js"
click node_server "https://github.com/baotlake/office-website/blob/main/utils/editor/server.ts"
click node_conversion "https://github.com/baotlake/office-website/blob/main/utils/editor/x2t.ts"
click node_socket "https://github.com/baotlake/office-website/blob/main/utils/editor/socket.ts"
click node_emptydocs "https://github.com/baotlake/office-website/blob/main/utils/editor/empty.ts"
click node_store "https://github.com/baotlake/office-website/blob/main/store/index.ts"
click node_recent "https://github.com/baotlake/office-website/blob/main/utils/recent-files.ts"
click node_settings "https://github.com/baotlake/office-website/blob/main/components/main/settings-view.tsx"
click node_templateview "https://github.com/baotlake/office-website/blob/main/components/main/template-view.tsx"
click node_i18n "https://github.com/baotlake/office-website/blob/main/i18n/config.ts"

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_open,node_picker,node_cloud,node_templates,node_user toneBlue
class node_editorpage,node_officeapi,node_server,node_conversion,node_socket,node_emptydocs toneAmber
class node_store,node_recent,node_indexeddb toneMint
class node_settings,node_templateview,node_i18n toneRose
```

## Components

### Document entry

- [Open view](https://github.com/baotlake/office-website/blob/main/components/main/open-view.tsx): `components/main/open-view.tsx`
- [File picker](https://github.com/baotlake/office-website/blob/main/components/file-picker-card.tsx): `components/file-picker-card.tsx`
- **Cloud providers**
- [Template catalog](https://github.com/baotlake/office-website/blob/main/utils/templates.ts): `utils/templates.ts`

### Editor runtime

- [Editor route](https://github.com/baotlake/office-website/blob/main/app/editor/page.tsx): `app/editor/page.tsx`
- [Office editor API](https://github.com/baotlake/office-website/blob/main/public/v9.3.0.24-1/web-apps/apps/api/documents/api.js): `public/v9.3.0.24-1/web-apps/apps/api/documents/api.js`
- [Editor server](https://github.com/baotlake/office-website/blob/main/utils/editor/server.ts): `utils/editor/server.ts`
- [x2t conversion](https://github.com/baotlake/office-website/blob/main/utils/editor/x2t.ts): `utils/editor/x2t.ts`
- [Mock socket](https://github.com/baotlake/office-website/blob/main/utils/editor/socket.ts): `utils/editor/socket.ts`
- [New document seeds](https://github.com/baotlake/office-website/blob/main/utils/editor/empty.ts): `utils/editor/empty.ts`

### Local data

- [App state](https://github.com/baotlake/office-website/blob/main/store/index.ts): `store/index.ts`
- [Recent files](https://github.com/baotlake/office-website/blob/main/utils/recent-files.ts): `utils/recent-files.ts`
- **IndexedDB**

### Product features

- [Settings view](https://github.com/baotlake/office-website/blob/main/components/main/settings-view.tsx): `components/main/settings-view.tsx`
- [Template view](https://github.com/baotlake/office-website/blob/main/components/main/template-view.tsx): `components/main/template-view.tsx`
- [Locale config](https://github.com/baotlake/office-website/blob/main/i18n/config.ts): `i18n/config.ts`

### Other components

- **User**

## Connections

- User → Open view: selects or creates
- Open view → File picker: renders (evidence: `components/main/open-view.tsx`)
- Open view → Editor server: opens file (evidence: `components/main/open-view.tsx`)
- Open view → Recent files: loads and updates (evidence: `components/main/open-view.tsx`)
- Open view → Editor route: navigates to (evidence: `components/main/open-view.tsx`)
- File picker → Cloud providers: selects from
- Open view → Template catalog: lists templates (evidence: `components/main/open-view.tsx`)
- Editor route → App state: reads state (evidence: `app/editor/page.tsx`)
- App state → Editor server: creates (evidence: `store/index.ts`)
- Editor route → Editor server: initializes and routes requests (evidence: `app/editor/page.tsx`)
- Editor route → Office editor API: loads editor API (evidence: `app/editor/page.tsx`)
- Editor server → Mock socket: uses (evidence: `utils/editor/server.ts`)
- Editor server → x2t conversion: converts documents (evidence: `utils/editor/server.ts`)
- Editor server → New document seeds: seeds new files (evidence: `utils/editor/server.ts`)
- Settings view → App state: updates preferences (evidence: `components/main/settings-view.tsx`)
- Template view → Template catalog: reads catalog (evidence: `components/main/template-view.tsx`)
- Recent files → IndexedDB: persists locally
- App state → Locale config: resolves locale (evidence: `store/index.ts`)
