https://github.com/wibus-wee/clarityfile
一款专为学术团队和多项目、多比赛参与者设计的本地化智能文档版本与事务关联中心
https://github.com/wibus-wee/clarityfile
electron react
Last synced: 2 months ago
JSON representation
一款专为学术团队和多项目、多比赛参与者设计的本地化智能文档版本与事务关联中心
- Host: GitHub
- URL: https://github.com/wibus-wee/clarityfile
- Owner: wibus-wee
- License: agpl-3.0
- Created: 2025-05-21T16:15:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-22T16:06:02.000Z (10 months ago)
- Last Synced: 2025-08-22T18:52:06.048Z (10 months ago)
- Topics: electron, react
- Language: TypeScript
- Homepage: http://clarityfile.wibus.ren/
- Size: 21.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ClarityFile · 明档Míng Dàng
一款专为学术团队和多项目、多比赛参与者设计的本地化智能文档版本与事务关联中心。
🧪 Working in Progress
Download for
macOS ·
Windows ·
PWA (Comming Soon)
## Motivation 动机
1. **文档版本管理混乱：** 针对不同比赛、不同赛级、通用需求产生的多版本PPT、商业计划书、项目说明书等文件，难以清晰追踪、查找和管理。
2. **文件命名与存放无序：** 文件夹和文件命名混乱，导致查找困难，新文件不知如何归档。
3. **信息孤岛：** 比赛通知、项目核心成果（专利、红头文件）、成员信息、经费报销等相关信息与核心文档割裂，难以统一管理和关联查阅。
4. **多项目管理挑战：** 难以有效区分和管理多个核心项目及 Side-project 的各类资料。
5. **流程追踪困难：** 如经费报销流程难以有效追踪。
6. **效率低下与文件丢失风险：** 上述问题导致工作效率低下，并存在文件误删或找不到的风险。
## Design 设计
1. **以“项目”为组织核心：** 所有信息和文件都围绕项目进行组织和关联。
2. **“逻辑文档”与“物理版本”分离：** 清晰管理一个抽象文档概念下的多个具体文件版本。
3. **元数据驱动：** 通过丰富的元数据（项目、比赛、赛段、版本标签、类型等）精确描述和区分每一个文件和信息条目。
4. **强制智能命名与结构化存放：** 应用根据元数据自动生成规范的文件名和清晰的本地文件夹结构，用户无需手动组织。
5. **文件物理层与业务逻辑层分离：** 作为所有受管物理文件统一注册中心。
6. **信息强关联：** 打破信息孤岛，将文档、比赛、成果、资产、经费等信息相互关联。
7. **本地化优先：** 数据存储在本地，用户对自己的数据有完全控制权，兼容现有云同步备份方案。
## Packages
- `packages/desktop`: ClarityFile 的核心桌面应用代码。
- `packages/locales-web`: ClarityFile 的本地化编辑器，用于管理 ClarityFile 的本地化。 _(WIP)_
- `packages/www`: ClarityFile 的官方网站，用于展示项目、提供下载等。
- `packages/shadcn`: shadcn/ui 的本地化版本，用于统一 UI 组件库。同时为各类子项目提供统一的 UI 组件。
## Author
ClarityFile © Wibus, Released under AGPLv3. Created on Jun 18, 2025
> [Personal Website](http://wibus.ren/) · [Blog](https://blog.wibus.ren/) · GitHub [@wibus-wee](https://github.com/wibus-wee/) · Telegram [@wibus✪](https://t.me/wibus_wee)