AttachLink 🔗
The Digital Bridge for Seamless Internship Management
AttachLink is a comprehensive ecosystem designed to modernize the industrial attachment process. By replacing manual paper logbooks with an authenticated, real-time mobile and web platform, it creates a transparent workflow between Students, Supervisors, and Employers.
🚀 Core Features
🎓 For Students
Digital Logbook: Submit daily activities with photo/document evidence.
Progress Analytics: Visualize approval stages using interactive MPAndroidChart pie charts.
Automated Reports: Export official attachment reports as PDF documents directly from the app.
Live Updates: Receive instant Firebase (FCM) notifications when logs are reviewed.
🔍 For Supervisors & Employers
Supervisor Review Portal: A dedicated workflow for faculty supervisors to approve or reject logs with feedback.
Employer Evaluations: On-site managers can monitor daily progress and provide 5-star performance ratings.
Authenticated Submissions: Ensures all entries are verified and timestamped.
🛠 Technical Stack
Layer
Technology
Mobile Frontend
Android (Java), Retrofit 2, MPAndroidChart
Real-time Services
Firebase Cloud Messaging (FCM)
Backend API
Spring Boot (Java), JPA/Hibernate
Security
JWT (JSON Web Tokens), Network Security Configuration (HTTPS)
Database
MySQL / PostgreSQL
📦 Setup & Installation
- Mobile App Setup
Clone the repository:
git clone https://github.com/your-username/attachlink-android.git
Add your google-services.json to the app/ folder.
Update the BASE_URL in RetrofitClient.java to point to your hosted backend.
- Backend Setup
Ensure you have the AttachLink Spring Boot server running.
Configure your database credentials in application.properties.
Build and run using ./mvnw spring-boot:run.
📄 License
Copyright 2026 Nicholas Kariuki Wambui
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.