Documents project structure and TODOs

Adds initial documentation outlining the project's architecture and key features.

Includes a high-level overview of the project's purpose, features, development stack, security considerations, and directory structure.

Also introduces a TODO list outlining planned features and enhancements in subsequent development phases.

The structure emphasizes clarity and maintainability.
This commit is contained in:
Chenwei Jiang 2025-08-26 21:07:04 +08:00
parent 817a99db5c
commit 5c93ae49b7
Signed by: cheverjohn
GPG key ID: ADC4815BFE960182
2 changed files with 106 additions and 0 deletions

80
docs/STRUCTURE.md Normal file
View file

@ -0,0 +1,80 @@
# This file is only for editing file nodes, do not break the structure
## Project Description
MiniMax AI Infra/算法 团队 - 专业的AI领域职位信息展示网站具备完整的数据管理功能支持安全的数据导入导出隐藏式管理后台为职位信息管理提供实用主义的解决方案。
## Key Features
- 专业的AI科技公司职位展示平台优先级差异化设计紧急红边/高优橙边/正常招聘粉边)
- 高级搜索筛选:关键词搜索 + 部门筛选 + 优先级筛选,实时结果展示
- 安全数据管理:访问码保护(1408) + 防暴力破解 + 数据加密存储
- 隐藏管理入口连续快速点击5次免责声明文字激活无明显UI暴露降低安全风险
- 数据导入导出支持XLSX和JSON格式的双向转换保留历史版本
- CRUD职位管理完整的增删改查功能支持批量操作
- 隐藏式联系方式:可展开的联系卡片,包含邮箱(带复制按钮)、合并的微信联系方式和正确二维码
- 响应式设计,完美适配移动端和桌面端
## Devv SDK Integration
Built-in: 暂未使用静态展示网站数据管理基于localStorage
External: 暂未使用
## Implementation Notes
- 安全设计访问码1408使用SHA-256+salt加密从不在源码中明文出现
- 数据持久化使用XOR加密存储到localStorage自动保存历史版本(最多10个)
- Unicode编码修复使用base64url+encodeURIComponent处理中文字符避免btoa错误
- 优先级视觉系统:红色(urgent)/橙色(high)/粉色(normal)的色彩编码
- 品牌配色优化调整为粉色70%紫色30%的渐变配色更符合MiniMax品牌调性
- 联系信息优化:隐藏展开式设计,个人化描述("我"而非"我们"),邮箱微信各配专业说明文字
- 实用主义:隐藏管理功能,避免过度设计,专注核心需求
- 文件处理集成XLSX.js处理Excel文件导入导出
- 防护机制3次失败锁定30分钟有效防止暴力破解
- UI简化更新移除页头公司描述团队名称改为"AI Infra",完全移除页脚版权信息
- 交互体验提升:联系方式改为点击展开,添加个人免责声明,合并微信号和二维码到同一卡片
- 联系功能优化:邮箱地址增加一键复制按钮,微信二维码更新为正确的联系二维码
- 联系流程说明添加详细的4步内推流程说明包含沟通了解、推荐码投递、简历直呈老板、进度同步等步骤
- 公司介绍重构详细的MiniMax公司介绍包含技术理念、团队背景、融资情况等关键信息
- 公司与招聘信息整合:将"加入我们"(Join Us)部分合并到About MiniMax同一卡片中通过分隔线区分内容包含6大核心优势人才氛围、技术前沿、成长空间、文化环境、薪酬福利、期权激励使用极紧凑的space-y-0零间距设计最大化内容密度
- 联系框扁平化:联系区域高度压缩,更简洁的视觉呈现,保持信息可读性
- 免责声明移至页脚个人免责声明从联系卡片移至整个页面最底部独立footer区域展示
- 二维码尺寸优化微信二维码从24x24放大到36x36提升扫码用户体验
- 二维码布局优化:桌面端将微信二维码移至右侧,充分利用空白区域;移动端保持居中布局
- 微信联系布局重构:桌面端采用左右平分布局,左侧文本描述和微信号,右侧二维码,空间利用更均衡
- 申请确认对话框点击申请按钮弹出确认提示提醒用户先联系CheverJohn包含邮箱和微信一键复制功能复制后显示toast提示
- 外部监控集成添加GoatCounter网站访问统计服务轻量级无Cookie追踪提供实时访问数据和用户行为分析
- 统计数据过滤优化配置GoatCounter过滤Cloudflare验证请求自动清理包含__cf_chl_tk等参数的路径避免统计污染
- 完整推荐来源追踪系统集成referrer tracking包含UTM参数追踪、地理位置信息、管理员分析面板等功能
- 品牌标题更新:项目标题从"MiniMax AI Infra 团队"更新为"MiniMax AI Infra/算法 团队",涵盖基础设施和算法两个核心技术领域
- 管理员入口优化隐藏触发方式从三击logo改为连续快速点击5次页脚免责声明文字增强隐蔽性和安全性
- 部门标识统一:所有职位的部门标识从"组内直招"统一修改为"系统组直招"包括数据和表单placeholder
- 数据持久化修复修复管理面板添加岗位后刷新页面消失的问题改为优先加载localStorage中的数据只有当无保存数据时才使用默认jobData确保用户添加的岗位能正确持久化
- 一键删除所有岗位:管理面板职位管理区域新增危险操作功能,仅在有岗位时显示,需要输入"DELETE ALL"确认文本,包含详细警告说明和历史备份机制
- 品牌文本统一修复修复HomePage英雄区遗留的"加入 MiniMax AI Infra 团队"文本,确保全站统一使用"加入 MiniMax AI Infra/算法 团队"
- 品牌标题简化HomePage英雄区标题从"加入 MiniMax AI Infra/算法 团队"简化为"加入 MiniMax",更简洁直接的品牌表达
/src
├── assets/ # Static resources directory, storing static files like images and fonts
├── components/ # Components directory
│ ├── ui/ # Pre-installed shadcn/ui components, avoid modifying or rewriting unless necessary
├── hooks/ # Custom Hooks directory
│ ├── use-mobile.ts # Pre-installed mobile detection Hook from shadcn (import { useIsMobile } from '@/hooks/use-mobile')
│ └── use-toast.ts # Toast notification system hook for displaying toast messages (import { useToast } from '@/hooks/use-toast')
├── lib/ # Utility library directory
│ └── utils.ts # Utility functions, including the cn function for merging Tailwind class names
├── pages/ # Page components directory, based on React Router structure
│ ├── HomePage.tsx # Home page component, serving as the main entry point of the application
│ └── NotFoundPage.tsx # 404 error page component, displays when users access non-existent routes
├── App.tsx # Root component, with React Router routing system configured
│ # Add new route configurations in this file
│ # Includes catch-all route (*) for 404 page handling
├── main.tsx # Entry file, rendering the root component and mounting to the DOM
├── index.css # Global styles file, containing Tailwind configuration and custom styles
│ # Modify theme colors and design system variables in this file
└── tailwind.config.js # Tailwind CSS v3 configuration file
# Contains theme customization, plugins, and content paths
# Includes shadcn/ui theme configuration

26
docs/TODO.md Normal file
View file

@ -0,0 +1,26 @@
## Phase 1: Core UI Foundation and Design System
- [x] Create modern design system in index.css - professional tech recruitment theme
- [x] Update index.html with proper project metadata
- [x] Create HomePage.tsx with hero section and job listings layout
- [x] Implement basic job card components with MiniMax branding
## Phase 2: Data Management with Security
- [x] Create secure data management system with hidden access code (1408)
- [x] Implement XLSX/JSON data import functionality with validation
- [x] Create admin interface with authentication for CRUD operations
- [x] Build data storage using localStorage with XOR encryption
- [x] Add security features: hash validation, brute force protection, history versioning
- [x] Enhanced UI with priority-based design (red/orange/blue borders and badges)
- [x] Advanced search and filtering (keyword + department + priority filters)
## Phase 3: Interactive Features
- [ ] Add job search and filtering capabilities
- [ ] Implement job detail modal/page
- [ ] Add copy-to-share functionality for job links
- [ ] Create responsive mobile-friendly interface
## Phase 4: Polish and Enhancement
- [ ] Add smooth animations and micro-interactions
- [ ] Implement error handling and loading states
- [ ] Add SEO optimization and meta tags
- [ ] Final UI polish and performance optimization