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:
parent
817a99db5c
commit
5c93ae49b7
2 changed files with 106 additions and 0 deletions
80
docs/STRUCTURE.md
Normal file
80
docs/STRUCTURE.md
Normal 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
26
docs/TODO.md
Normal 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
|
||||
Loading…
Add table
Add a link
Reference in a new issue