{"id":28292042,"url":"https://github.com/pxkundu/ai-logbook-analysis","last_synced_at":"2026-02-18T06:31:43.975Z","repository":{"id":293513272,"uuid":"984286332","full_name":"pxkundu/ai-logbook-analysis","owner":"pxkundu","description":"The project involves developing an AI-powered system to extract and analyze data from handwritten logbooks and service records using AWS native services. The goal is to create a scalable, secure, and efficient solution with a robust project structure, modern tech stack, and DevSecOps best practices.","archived":false,"fork":false,"pushed_at":"2025-05-27T18:13:04.000Z","size":34,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-13T06:21:44.087Z","etag":null,"topics":["ai","aws-lambda","bedrock","sagemaker","text-to-sql","textract"],"latest_commit_sha":null,"homepage":"https://pxkundu.github.io/ai-logbook-analysis/","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pxkundu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-15T17:24:55.000Z","updated_at":"2025-05-27T18:15:45.000Z","dependencies_parsed_at":"2025-05-15T18:41:13.826Z","dependency_job_id":"3f81b159-0857-4285-b088-dde856feeaa4","html_url":"https://github.com/pxkundu/ai-logbook-analysis","commit_stats":null,"previous_names":["pxkundu/ai-logbook-analysis"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pxkundu/ai-logbook-analysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxkundu%2Fai-logbook-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxkundu%2Fai-logbook-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxkundu%2Fai-logbook-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxkundu%2Fai-logbook-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pxkundu","download_url":"https://codeload.github.com/pxkundu/ai-logbook-analysis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxkundu%2Fai-logbook-analysis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29570331,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T06:19:27.422Z","status":"ssl_error","status_checked_at":"2026-02-18T06:18:44.348Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","aws-lambda","bedrock","sagemaker","text-to-sql","textract"],"created_at":"2025-05-22T04:12:33.477Z","updated_at":"2026-02-18T06:31:43.958Z","avatar_url":"https://github.com/pxkundu.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Logbook Analysis\n\nAn AI-powered system designed to extract and analyze data from handwritten logbooks and service records. This system leverages AWS services and modern web technologies to provide an efficient solution for digitizing and processing handwritten documents.\n\n## Features\n\n- Handwritten text extraction using AWS Textract\n- Data validation and ETL processing\n- RESTful API for data access\n- Modern web interface for document management\n- Secure document storage and processing\n- Scalable microservices architecture\n\n## Project Structure\n\n```\nai-logbook-analysis/\n├── backend/\n│   ├── services/\n│   │   ├── ingestion/         # Document ingestion service\n│   │   ├── text-extraction/   # AWS Textract integration\n│   │   ├── validation/        # Data validation service\n│   │   ├── etl/              # ETL processing service\n│   │   └── integration/      # API integration service\n│   ├── config/               # Configuration files\n│   ├── docs/                 # Backend documentation\n│   └── scripts/              # Utility scripts\n├── frontend/\n│   ├── src/\n│   │   ├── components/       # Reusable React components\n│   │   ├── pages/           # Page components\n│   │   ├── services/        # API services\n│   │   ├── assets/          # Static assets\n│   │   └── tests/           # Frontend tests\n│   ├── public/              # Public assets\n│   └── Dockerfile           # Frontend container config\n├── infrastructure/\n│   ├── modules/             # Terraform modules\n│   │   ├── s3/             # S3 bucket configurations\n│   │   ├── lambda/         # Lambda function configs\n│   │   ├── rds/            # Database configurations\n│   │   └── security/       # Security group configs\n│   ├── environments/        # Environment-specific configs\n│   └── main.tf             # Main Terraform configuration\n├── cicd/\n│   ├── jenkins/            # Jenkins pipeline configs\n│   └── scripts/            # CI/CD utility scripts\n├── docs/\n│   ├── architecture/       # Architecture documentation\n│   ├── api/               # API documentation\n│   └── guides/            # User and developer guides\n└── scripts/               # Project-wide utility scripts\n```\n\n## System Architecture\n\n```\n[Client Browser] \u003c---\u003e [CloudFront] \u003c---\u003e [S3 Static Hosting]\n                              |\n                              v\n[Document Upload] --\u003e [API Gateway] --\u003e [Lambda Functions]\n                              |\n                              v\n[Document Processing Pipeline]\n    |\n    |--\u003e [S3 Raw Storage] --\u003e [Textract] --\u003e [S3 Processed]\n    |         |                    |              |\n    |         v                    v              v\n    |--\u003e [Validation Service] --\u003e [ETL Service] --\u003e [RDS Database]\n    |         |                    |              |\n    |         v                    v              v\n    |--\u003e [CloudWatch Logs] \u003c-- [CloudWatch Metrics] \u003c-- [CloudWatch Alarms]\n    |\n    v\n[Notification Service (SNS/SES)]\n```\n\n## CI/CD Pipeline Architecture\n\n```\n[GitHub Repository]\n       |\n       v\n[GitHub Webhook] --\u003e [Jenkins Server]\n       |                  |\n       v                  v\n[Code Changes] --\u003e [Pipeline Stages]\n                      |\n                      |--\u003e [Build Stage]\n                      |     |\n                      |     v\n                      |--\u003e [Test Stage]\n                      |     |\n                      |     v\n                      |--\u003e [Security Scan]\n                      |     |\n                      |     v\n                      |--\u003e [Infrastructure Stage]\n                      |     |\n                      |     |--\u003e [Terraform Plan]\n                      |     |\n                      |     v\n                      |--\u003e [Deployment Stage]\n                      |     |\n                      |     |--\u003e [Backend Deployment]\n                      |     |     |\n                      |     |     v\n                      |     |--\u003e [Frontend Deployment]\n                      |     |\n                      |     v\n                      |--\u003e [Integration Tests]\n                      |\n                      v\n[Deployment to Environment]\n    |\n    |--\u003e [Dev]\n    |--\u003e [Staging]\n    v--\u003e [Production]\n```\n\n## Architecture\n\nThe system is built using a microservices architecture with the following components:\n\n- **Backend Services** (`backend/`):\n  - Document ingestion service\n  - Text extraction service (AWS Textract integration)\n  - Data validation service\n  - ETL processing service\n  - API Gateway and Lambda functions\n  - RDS for data storage\n\n- **Frontend Application** (`frontend/`):\n  - ReactJS-based web interface\n  - Document upload and management\n  - Data visualization and reporting\n  - User authentication and authorization\n\n- **Infrastructure** (`infrastructure/`):\n  - AWS resources managed by Terraform\n  - S3 buckets for document storage\n  - Lambda functions for serverless processing\n  - RDS for data persistence\n  - Security groups and IAM roles\n  - CloudWatch for monitoring\n\n- **CI/CD** (`cicd/`):\n  - Jenkins pipelines for automated deployment\n  - Environment-specific configurations\n  - Automated testing and validation\n\n## Prerequisites\n\n- Python 3.9 or higher\n- Node.js 18 or higher\n- Terraform 1.5 or higher\n- AWS CLI configured with appropriate credentials\n- Docker (for local development)\n- Git\n\n## Setup Instructions\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/pxkundu/ai-logbook-analysis.git\n   cd ai-logbook-analysis\n   ```\n\n2. **Backend Setup**\n   ```bash\n   cd backend\n   python -m venv venv\n   source venv/bin/activate  # On Windows: .\\venv\\Scripts\\activate\n   pip install -r requirements.txt\n   ```\n\n3. **Frontend Setup**\n   ```bash\n   cd frontend\n   npm install\n   ```\n\n4. **Infrastructure Setup**\n   ```bash\n   cd infrastructure\n   terraform init\n   terraform plan -var-file=environments/dev/variables.tfvars\n   terraform apply -var-file=environments/dev/variables.tfvars\n   ```\n\n5. **Environment Configuration**\n   - Copy `.env.example` to `.env` in both backend and frontend directories\n   - Update the environment variables with your AWS credentials and other configurations\n\n6. **Start Development Servers**\n   - Backend: `python manage.py runserver`\n   - Frontend: `npm start`\n\n## Development\n\n- Follow the coding standards in `docs/development-guidelines.md`\n- Run tests before submitting PRs\n- Update documentation for new features\n- Use feature branches for development\n\n## Deployment\n\nThe system uses Jenkins pipelines for CI/CD. Deployment configurations are in the `cicd/` directory.\n\n## Documentation\n\nDetailed documentation is available in the `docs/` directory:\n- Architecture overview\n- API documentation\n- Security guidelines\n- User guides\n- Development guidelines\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nFor support, please open an issue in the GitHub repository or contact the development team.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxkundu%2Fai-logbook-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpxkundu%2Fai-logbook-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxkundu%2Fai-logbook-analysis/lists"}