poffice-admin

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Poffice Admin Skill

Poffice Admin 技能

This skill provides the necessary tools and workflows to manage the Poffice infrastructure.

本技能提供管理Poffice基础设施所需的工具与工作流。

Core Capabilities

核心功能

User & Mail Management: Create mailboxes, manage domains, and send/receive emails.
Document Management: Sync files via Seafile and archive documents via Paperless-ngx.
Calendar Management: Full CRUD management of events (List, Add, Update, Delete) in SOGo (attached to Mailcow) and sending email invites with .ics attachments.
Document Creation: Generate and update Word (.docx), Excel (.xlsx), and PDF documents programmatically.

用户与邮件管理：创建邮箱、管理域名、收发邮件。
文档管理：通过Seafile同步文件，通过Paperless-ngx归档文档。
日历管理：对SOGo（绑定Mailcow）中的事件进行完整的CRUD管理（列出、添加、更新、删除），并发送带.ics附件的邮件邀请。
文档创建：以编程方式生成和更新Word（.docx）、Excel（.xlsx）及PDF文档。

Quick Reference Scripts

快速参考脚本

The following scripts are available in the

scripts/

directory:

```
poffice_mail.py
```
: Mailbox creation and email sending.
```
poffice_docs.py
```
: Seafile user and repo management.
```
poffice_paperless.py
```
: Document ingestion and listing.
```
poffice_gen.py
```
: Document creation and update (Word, Excel, PDF).
```
poffice_calendar.py
```
: Calendar event creation and email invites.

以下脚本位于

scripts/

目录中：

```
poffice_mail.py
```
：邮箱创建与邮件发送。
```
poffice_docs.py
```
：Seafile用户与仓库管理。
```
poffice_paperless.py
```
：文档导入与列出。
```
poffice_gen.py
```
：文档创建与更新（Word、Excel、PDF）。
```
poffice_calendar.py
```
：日历事件创建与邮件邀请。

Typical Workflows

典型工作流

Creating a New Office User

创建新办公用户

To create a fully provisioned user (Mail + Cloud storage):

Run

python3 scripts/poffice_mail.py create-mailbox domain.com user_name "Full Name" password

Run

python3 scripts/poffice_docs.py create-user user@domain.com password

要创建一个完整配置的用户（邮件+云存储）：

运行

python3 scripts/poffice_mail.py create-mailbox domain.com user_name "Full Name" password

运行

python3 scripts/poffice_docs.py create-user user@domain.com password

Creating and Archiving a Report

创建并归档报告

Use
```
poffice_gen.py
```
to create a PDF or Excel report.
Use
```
poffice_paperless.py
```
to upload the generated file for long-term archiving.
Use
```
poffice_mail.py
```
to email the report to the team.

使用
```
poffice_gen.py
```
创建PDF或Excel报告。
使用
```
poffice_paperless.py
```
上传生成的文件以进行长期归档。
使用
```
poffice_mail.py
```
将报告通过邮件发送给团队。

Scheduling a Meeting and Sending Invites

安排会议并发送邀请

Use
```
poffice_calendar.py add
```
to put the event on your own calendar.
Use
```
poffice_calendar.py invite
```
to send the official invitation to participants.
Optionally, use
```
poffice_gen.py
```
to create a meeting agenda PDF and attach it to an email using
```
poffice_mail.py
```
.

使用
```
poffice_calendar.py add
```
将事件添加到自己的日历中。
使用
```
poffice_calendar.py invite
```
向参会者发送正式邀请。
（可选）使用
```
poffice_gen.py
```
创建会议议程PDF，并通过
```
poffice_mail.py
```
将其作为邮件附件发送。

Managing Existing Events

管理现有事件

Use
```
poffice_calendar.py list
```
to see upcoming events.
Use
```
poffice_calendar.py delete [UID]
```
to remove an event.
Update events using the
```
update_event
```
method in
```
poffice_calendar.py
```
.

使用
```
poffice_calendar.py list
```
查看即将到来的事件。
使用
```
poffice_calendar.py delete [UID]
```
删除事件。
使用
```
poffice_calendar.py
```
中的
```
update_event
```
方法更新事件。

Sending a System Invite

发送系统邀请

Use

poffice_mail.py send-email

to notify users about account creation or meetings.

使用

poffice_mail.py send-email

通知用户账户创建或会议相关信息。

Service Access & Credentials

服务访问与凭证

See references/credentials.md for API keys and endpoint information.

查看references/credentials.md获取API密钥与端点信息。

Calendar (SOGo)

日历（SOGo）

Calendar management is handled through SOGo.

URL:
```
https://mail.poffice.online/SOGo
```
CalDAV:
```
https://mail.poffice.online/SOGo/dav/
```
To send invites programmatically, use standard
```
ics
```
generation and send via
```
poffice_mail.py
```
.

日历管理由SOGo处理。

URL：
```
https://mail.poffice.online/SOGo
```
CalDAV：
```
https://mail.poffice.online/SOGo/dav/
```
要以编程方式发送邀请，请使用标准
```
ics
```
生成并通过
```
poffice_mail.py
```
发送。

Documentation

文档

Mailcow API: references/mailcow_api.md
Seafile API: references/seafile_api.md
Paperless API: references/paperless_api.md

Mailcow API：references/mailcow_api.md
Seafile API：references/seafile_api.md
Paperless API：references/paperless_api.md